O componente YouTube

Esse componente não é compatível com o Google Ads, a Google AdMob, os anúncios HTML para AMP, os anúncios em vídeo nem com os anúncios gráficos.

O componente YouTube permite que você coloque um vídeo do YouTube no seu anúncio.

Vídeos do YouTube com telas finais não são compatíveis com os anúncios de masthead do YouTube.

Para adicionar o componente YouTube ao seu projeto:

Abra o painel Componentes e depois a pasta Mídia.
Arraste o componente YouTube para o cenário.
Na seção de propriedades do componente YouTube no painel Propriedades, insira o URL da página do vídeo do YouTube no campo URL.

Uso de vídeos do YouTube em navegadores de dispositivos móveis

Os navegadores de dispositivos móveis podem desativar a reprodução automática do YouTube para evitar que os usuários recebam cobranças de dados de conteúdo não solicitado. A prática recomendada para navegadores de dispositivos móveis é desativar a reprodução automática e ativar os controles de vídeo. Isso garante que seu vídeo funcione da maneira desejada.

No painel "Propriedades", faça estas mudanças:

Defina Reprodução automática como none.
Defina Controles como autohide.

Propriedades

Propriedade	Descrição
Nome	É o nome do componente.
URL	É o URL do vídeo do YouTube que você quer mostrar. O ID exclusivo encontrado no URL também é válido. Pode ser vinculado a dados dinâmicos.
Reprodução automática	Define se o vídeo será reproduzido automaticamente. A reprodução automática não é compatível com todos os navegadores de dispositivos móveis. none (padrão): o vídeo não toca automaticamente. standard: o vídeo toca automaticamente e não é contabilizado como uma visualização do YouTube. preview: o vídeo é reproduzido sem som abaixo de uma sobreposição do botão "Reproduzir". intro: o vídeo é reproduzido sem som, sem a sobreposição do botão "Reproduzir" e sem controles e não é contabilizado como uma visualização do YouTube.
Duração da visualização	É a duração da visualização (usada somente quando a Reprodução automática estiver definida como preview ou introdução). Por padrão, esse valor é de 30 segundos.
Controles	Indica se os controles serão exibidos. autohide: a barra de progresso do vídeo e os controles do player são ocultados alguns segundos após o início da reprodução. Os controles reaparecem quando o usuário interage com o player de vídeo. none: oculta a barra de progresso e os controles do player.
Cor da barra de progresso	Indica se a barra de progresso do player de vídeo é vermelha ou branca.
Desativar som	Quando selecionado, o vídeo do YouTube é iniciado sem som.
Relacionados	Quando selecionado, mostra vídeos relacionados do YouTube que talvez sejam de outros canais após a conclusão do vídeo original. Desmarque essa opção para exibir somente vídeos relacionados do YouTube do mesmo canal do vídeo original.
Loop	Quando selecionado, o vídeo do YouTube é repetido continuamente.
Pausar ao final do vídeo	Quando selecionado, pausa o vídeo do YouTube um segundo antes do fim da reprodução.
Posição inicial	Especifica a posição inicial do vídeo do YouTube em segundos. Pode ser vinculado a dados dinâmicos.

Propriedades avançadas

Clique no ícone de expandir ao lado de Propriedades avançadas no painel correspondente ao componente para editar as seguintes definições avançadas:

Propriedade	Descrição
Permitir tela cheia no computador desktop	Possibilita a visualização em tela cheia para usuários no computador.
Parâmetros extras de player	São os parâmetros do player do YouTube que serão incluídos. Separe vários parâmetros com "e comercial" (`&`).

Eventos e ações

Eventos enviados pelo componente YouTube

Você pode acionar outras ações com base nos seguintes eventos do componente YouTube:

Evento	Descrição
Armazenando em buffer	Enviado enquanto o vídeo do YouTube está sendo armazenado em buffer.
Finalizado	Enviado quando o vídeo do YouTube chega ao fim.
Pausado	Enviado quando o vídeo do YouTube é pausado.
Em exibição	Enviado quando o vídeo do YouTube começa a ser reproduzido.
Repetido	Enviado quando o vídeo do YouTube é repetido.
Iniciado	Enviado quando 0% do vídeo do YouTube é assistido.
Primeiro quartil	Enviado quando 25% do vídeo do YouTube é assistido.
Ponto médio	Enviado quando 50% do vídeo do YouTube é assistido.
Terceiro quartil	Enviado quando 75% do vídeo do YouTube é assistido.
Concluído	Enviado quando 100% do vídeo do YouTube é assistido.
Visualização iniciada	Enviado quando 0% da visualização é assistida.
Primeiro quartil de visualização	Enviado quando 25% da visualização é assistida.
Ponto médio de visualização	Enviado quando 50% da visualização é assistida.
Terceiro quartil de visualização	Enviado quando 75% da visualização é assistida.
Visualização concluída	Enviado quando 100% da visualização é assistida.

Para selecionar um desses eventos na caixa de diálogo Evento, defina o componente YouTube como o destino.

Saiba como rastrear esses eventos no Studio.

Ações realizadas pelo componente YouTube

As seguintes ações do componente YouTube podem ser iniciadas em resposta a outros eventos:

Ação	Opções de configuração
Ativar/desativar som	nenhuma
Pausar	nenhuma
Reproduzir após pausa	nenhuma
Repetir	nenhuma
Procurar	Tempo: é o tempo em segundos para onde o vídeo será pulado.
Definir ID do vídeo do YouTube	ID: é o ID do vídeo do YouTube. Essa é a parte exclusiva do URL da página do vídeo do YouTube. Somente indicação: quando essa opção é selecionada, o vídeo é carregado, mas não é reproduzido.

Ao selecionar uma dessas ações na caixa de diálogo Evento, defina o componente YouTube como o receptor.

Saiba como configurar eventos.

Visualização

Não é possível visualizar esse componente na interface do Google Web Designer. Para ver como ele fica em ação, clique no botão Visualizar no canto superior direito e visualize o documento no navegador que você preferir.

Isso foi útil?

Como podemos melhorá-lo?