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 atuais, criar e gerenciar grupos de anúncios e anúncios, configurar a segmentação de campanhas e gerar relatórios. Porém, 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 pelo conjunto videoCampaigns de um objeto AdsApp. É possível recuperá-los como você normalmente recupera as 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

Com os scripts do Google Ads, você pode recuperar 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 de vídeo. Para garantir que você está 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úncios que são compatíveis com a campanha. Especificamente, as campanhas VIDEO_ACTION aceitam apenas o tipo de anúncio VIDEO_RESPONSIVE, e as campanhas do VIDEO_NON_SKIPPABLE aceitam apenas o tipo de anúncio 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 AdvertisingChannelSubType para o tipo de campanha que você quer:

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 essas campanhas usando um withCondition:

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

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

Criar o grupo de anúncios

Crie 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 para o grupo de anúncios ao criá-lo. O tipo do grupo de anúncios precisa ser um dos seguintes e não pode ser alterado após a criação do grupo:

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

Exemplos

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

Criar o recurso de vídeo

Geralmente, os anúncios em vídeo precisam fazer referência a um recurso de vídeo. Isso determina qual vídeo será reproduzido para o anúncio. Não é possível fazer o upload de um vídeo usando scripts, mas você pode vincular um vídeo do YouTube enviado anteriormente para uso nos seus anúncios. Para fazer isso, crie um Asset com o 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 builder correspondente ao tipo de grupo de anúncios (encadeado após 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

Há 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 scripts, mas pode ser visualizado.

Com o outro tipo de segmentação, você pode especificar critérios para campanhas de vídeo e grupos de anúncios em vídeo individualmente. Ela pode ser acessada 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 para todos os tipos aplicáveis a esse nível de segmentação. O método AdsApp.videoTargeting() também existe para visualizar os critérios no nível da conta e inclui um conjunto diferente de critérios de AdsApp.videoCampaignTargeting(). Como no VideoCampaignTargeting, não é possível gerenciar esses critérios com scripts.

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

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

Os critérios de informações demográficas (idade, gênero) 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 gênero possíveis são criados automaticamente, e esse grupo segmenta todos eles. É possível excluir um grupo demográfico buscando a segmentação atual e chamando o método exclude() nela. Além disso, é possível incluir novamente um grupo demográfico excluído encontrando a segmentação por exclusão existente e chamando include().

Veja a seguir um exemplo de como excluir um gênero 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();
}