Campanhas de vídeo

Os scripts do Google Ads permitem gerenciar e gerar relatórios sobre suas campanhas de vídeo no YouTube. Você pode 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. 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 na coleção videoCampaigns de um AdsApp objeto. É possível recuperá-las da mesma forma que 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, você pode usar o método AdsApp.videoAdGroups():

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

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

Criar anúncios em vídeo

Os scripts do Google Ads permitem recuperar seus anúncios em vídeo usando o videoAds() método de VideoAdGroup. É possível criar novos anúncios em vídeo usando o newVideoAd() método de VideoAdGroup.

Formatos de anúncios em vídeo

Os formatos de anúncios em vídeo aceitos 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 aceitos nessa campanha. Especificamente, as campanhas VIDEO_ACTION só aceitam o tipo de anúncio VIDEO_RESPONSIVE, e as campanhas VIDEO_NON_SKIPPABLE só aceitam 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 seletor. É possível atualizar o AdvertisingChannelSubType para o tipo de campanha de interesse:

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

As campanhas de vídeo sem subtipo aceitam os seguintes formatos de anúncios 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 reproduzidos antes, durante ou após outros vídeos, aos usuários a opção de pular após um tempo 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. Os anúncios bumper têm 6 segundos ou menos e podem aparecer em vídeos do YouTube ou em vídeos em sites parceiros e apps na Rede de Display. Para detalhes completos sobre cada um desses tipos de anúncio, consulte Sobre os formatos de anúncios em vídeo.

Criar o grupo de anúncios

Você cria um grupo de anúncios em vídeo usando o newVideoAdGroupBuilder() método de uma campanha de vídeo. É necessário especificar um tipo e um nome de grupo de anúncios ao criar o grupo. O tipo de grupo de anúncios precisa ser um dos seguintes e não pode ser alterado depois que o grupo de anúncios é criado:

  • VIDEO_BUMPER
  • VIDEO_EFFICIENT_REACH
  • VIDEO_NON_SKIPPABLE_IN_STREAM (somente para campanhas VIDEO_NON_SKIPPABLE)
  • VIDEO_RESPONSIVE (somente para campanhas VIDEO_ACTION)
  • VIDEO_TRUE_VIEW_IN_DISPLAY
  • VIDEO_TRUE_VIEW_IN_STREAM
  • YOUTUBE_AUDIO

Exemplo:

const videoAdGroup =
    videoCampaign.newVideoAdGroupBuilder()
    .withAdGroupType("VIDEO_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 fazer upload de um vídeo usando scripts, mas você pode vincular um vídeo do YouTube que já fez upload 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 criador que corresponde ao tipo de grupo de anúncios (encadeado após newVideoAd()):

Por exemplo:

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 é acessado usando AdsApp.videoCampaignTargeting(). Isso não pode ser modificado por scripts, mas pode ser visualizado.

O outro tipo de segmentação permite especificar critérios para campanhas de vídeo e grupos de anúncios em vídeo individualmente. Isso 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 para todos os tipos aplicáveis a esse nível de segmentação. O AdsApp.videoTargeting() método 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.

Confira um exemplo de como excluir um posicionamento específico em uma campanha:

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

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

Confira 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();
}