Campanhas de vídeo

Com os scripts do Google Ads, você pode gerenciar e gerar relatórios sobre suas campanhas de vídeo com base no YouTube. É possível usar scripts para gerenciar campanhas de vídeo existentes, criar e gerenciar grupos de anúncios e anúncios, configurar a segmentação para campanhas e gerar relatórios. No entanto, não é possível usar scripts para criar campanhas de vídeo.

Recuperar campanhas de vídeo e grupos de anúncios

As campanhas de vídeo estão disponíveis por meio da coleção videoCampaigns de um objeto AdsApp. Você pode recuperá-las como normalmente recuperaria campanhas em scripts:

const campaignName = "My first video campaign";

const campaignIterator = AdsApp.videoCampaigns()
    .withCondition(`campaign.name = "${campaignName}"`)
    .get();

for (const campaign of campaignIterator) {
  ...
}

Depois de recuperar uma campanha, é possível obter os grupos de anúncios dela de modo semelhante:

const adGroupIterator = campaign.videoAdGroups()
    .withCondition(`ad_group.name = "${adGroupName}"`)
    .get();

for (const adGroup of adGroupIterator) {
  ...
}

Como alternativa, use o método AdsApp.videoAdGroups():

const adGroupIterator = AdsApp.videoAdGroups()
    .withCondition(`campaign.name = "${campaignName}" AND ad_group.name = "${adGroupName}")
    .get();

for (const adGroup of adGroupIterator) {
  ...
}

Criação de anúncios em vídeo

Os scripts do Google Ads permitem que você recupere seus anúncios em vídeo usando o método videoAds() de VideoAdGroup. Você pode criar novos anúncios em vídeo usando o método newVideoAd() de VideoAdGroup.

Formatos de anúncios em vídeo

Os formatos de anúncio em vídeo compatíveis variam de acordo com o tipo de campanha. Para garantir que você esteja selecionando o tipo certo de campanha de vídeo, adicione uma chamada withCondition em AdvertisingChannelSubType.

Algumas campanhas de vídeo têm subtipos que restringem os tipos de anúncio compatíveis com a campanha. Especificamente, as campanhas VIDEO_ACTION são compatíveis somente com o tipo de anúncio VIDEO_RESPONSIVE, e as campanhas VIDEO_NON_SKIPPABLE só são compatíveis com o tipo NON_SKIPPABLE_INSTREAM_VIDEO_AD.

A melhor maneira de operar em tipos específicos de campanhas é usar uma cláusula withCondition no seu seletor. Você pode atualizar o AdvertisingChannelSubType para o tipo de interesse da campanha:

const campaignIterator = AdsApp.videoCampaigns()
  .withCondition("AdvertisingChannelSubType = VIDEO_ACTION")
  .get();

As campanhas de vídeo sem subtipo são compatíveis com os seguintes formatos de anúncio em vídeo:

  • TrueView in-stream
  • TrueView video discovery
  • Bumper

É possível selecionar estas campanhas usando um withCondition:

const campaignIterator = AdsApp.videoCampaigns()
  .withCondition("AdvertisingChannelSubType = null")
  .get();

Os anúncios em vídeo in-stream podem ser reproduzidos antes, durante ou depois de outros vídeos, oferecendo aos usuários a opção de ignorar o anúncio após um período especificado. Os anúncios video discovery aparecem na Rede de Display e em várias páginas do YouTube e só serão reproduzidos se um usuário clicar ativamente na miniatura do anúncio primeiro. Os anúncios bumper têm seis segundos ou menos e podem ser exibidos em vídeos do YouTube ou em sites e aplicativos de parceiros na Rede de Display. Para ver detalhes completos sobre cada um desses tipos de anúncio, consulte Sobre formatos de anúncio em vídeo.

Criar o grupo de anúncios

Você cria um grupo de anúncios em vídeo usando o método newVideoAdGroupBuilder() de uma campanha de vídeo. Você precisa especificar um tipo e um nome de grupo de anúncios ao criar o grupo de anúncios. O tipo de grupo de anúncios precisa ser um dos seguintes e não pode ser alterado após a criação dele:

  • TRUE_VIEW_IN_STREAM
  • TRUE_VIEW_IN_DISPLAY
  • BUMPER
  • VIDEO_RESPONSIVE (somente para campanhas de VIDEO_ACTION)
  • NON_SKIPPABLE_INSTREAM_VIDEO_AD (somente para campanhas de VIDEO_NON_SKIPPABLE)

Exemplos

const videoAdGroup =
    videoCampaign.newVideoAdGroupBuilder()
    .withAdGroupType("TRUE_VIEW_IN_STREAM")
    .withName("Video Ad Group")
    .build()
    .getResult();

Criar o recurso de vídeo

Os anúncios em vídeo geralmente precisam referenciar um recurso de vídeo. Isso determina qual vídeo será reproduzido para o anúncio. Não é possível enviar um vídeo usando scripts, mas você pode vincular um vídeo existente do YouTube que já foi enviado para uso em seus anúncios. Para isso, crie uma Asset com YouTubeVideoAssetBuilder.

const assetOperation = AdsApp.adAsset().newYouTubeVideoAssetBuilder()
   .withName("name")
   // This is the ID in the URL for the YouTube video.
   .withYouTubeVideoId(youTubeVideoId)
   .build();
const videoAsset = assetOperation.getResult();

Criar o anúncio

Para criar um novo anúncio, use o método do criador correspondente ao tipo de grupo de anúncios (encadeado depois de newVideoAd()):

Exemplos

const videoAd = videoAdGroup.newVideoAd()
    .inStreamAdBuilder()
    .withAdName("Video Ad")
    .withFinalUrl(
        "http://www.example.com/video-ad")
    // Specify the video asset created in the last step.
    .withVideo(video)
    .build()
    .getResult();

Segmentação de vídeo

Existem dois tipos diferentes de segmentação relevante para campanhas de vídeo. O VideoCampaignTargeting representa qualquer segmentação feita no nível da conta para campanhas de vídeo em geral e é acessada usando AdsApp.videoCampaignTargeting(). Ele não pode ser modificado por meio de scripts, mas pode ser visualizado.

O outro tipo de segmentação permite especificar os critérios para campanhas e grupos de anúncios em vídeo individualmente. Ele pode ser acessado com o método videoTargeting() na campanha ou no grupo de anúncios e fornece acesso a seletores e criadores para critérios positivos e negativos de todos os tipos aplicáveis a esse nível de segmentação. O método AdsApp.videoTargeting() também existe para visualizar critérios no nível da conta e inclui um conjunto diferente de critérios de AdsApp.videoCampaignTargeting(). Assim como VideoCampaignTargeting, não é possível gerenciar esses critérios com scripts.

Veja um exemplo de exclusão de um canal específico em uma campanha:

videoCampaign.videoTargeting().newPlacementBuilder()
    .withUrl("http://www.example.com")
    .exclude();

Os critérios de informações demográficas (idade, sexo) funcionam de maneira um pouco diferente dos outros tipos de critérios. Quando um novo grupo de anúncios é criado, os critérios para cada valor de idade e sexo são gerados automaticamente, e esse grupo de anúncios segmenta todos eles. Você pode excluir um grupo demográfico buscando a segmentação existente e chamando o método exclude() nele. Também é possível incluir novamente uma demografia excluída encontrando a segmentação existente e chamando include().

Veja a seguir um exemplo de como excluir um sexo específico de um grupo de anúncios:

const videoGenderIterator = videoAdGroup.videoTargeting()
    .genders()
    .withCondition('GenderType = "GENDER_MALE"')
    .get();
if (videoGenderIterator.hasNext()) {
  const videoGender = videoGenderIterator.next();
  videoGender.exclude();
}