Campanhas de vídeo

Os scripts do Google Ads permitem que você gerencie e gere relatórios sobre seus vídeos baseados no YouTube do Shopping. É possível usar scripts para gerenciar campanhas de vídeo, criar e gerenciar anúncios e grupos de anúncios, 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 no videoCampaigns uma coleção de objeto AdsApp. Você poderá recuperá-las como você 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, 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) {
  ...
}

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

Os scripts do Google Ads permitem que você recupere seus anúncios em vídeo usando a videoAds() método de VideoAdGroup Você pode criar novos anúncios em vídeo usando o 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 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 compatíveis com ela. Especificamente, apenas VIDEO_ACTION campanhas têm suporte para o tipo de anúncio VIDEO_RESPONSIVE e VIDEO_NON_SKIPPABLE campanhas são compatíveis apenas com 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 AdvertisingChannelSubType para o tipo de campanha de interesse:

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

Você pode 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 depois de outros vídeos, oferecendo aos usuários a opção de pular após um período especificado. Os anúncios video discovery aparecem em a Rede de Display e várias páginas do YouTube e só serão reproduzidos se um usuário clica ativamente na miniatura do anúncio primeiro. Os anúncios bumper duram até seis segundos e podem aparecer em vídeos do YouTube ou em vídeos de sites e aplicativos parceiros na Rede de Display do Google. Para obter 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 na newVideoAdGroupBuilder() de uma campanha de vídeo. É necessário especificar um tipo de grupo de anúncios e um anúncio ao criar o grupo de anúncios. O tipo de grupo de anúncios precisa ser um dos a seguir e não pode ser alterado depois que o grupo de anúncios é criado:

  • 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)
.

Exemplo:

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 fazer referência a um recurso de vídeo. Isso determina para 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 você enviou anteriormente para uso em seus anúncios. Para isso, crie uma 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 de criação que corresponde ao tipo de grupo de anúncios (encadeado após newVideoAd()):

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

Existem dois tipos diferentes de segmentação relevantes para campanhas de vídeo. A 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 podem ser modificados por scripts, mas podem ser visualizados.

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

Veja um exemplo de como excluir 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 outros tipos de critérios. Quando um novo grupo de anúncios é criado, os critérios de cada os possíveis valores de idade e sexo são criados automaticamente, e esse grupo de anúncios segmenta todos eles. É possível excluir um grupo demográfico buscando a segmentação e chamar o método exclude() nele, e é possível incluir novamente uma um grupo demográfico excluído encontrando a segmentação por exclusão existente e ligando include().

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