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 paraVIDEO_ACTION
campanhas)NON_SKIPPABLE_INSTREAM_VIDEO_AD
(somente paraVIDEO_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()
):
inStreamAdBuilder()
videoDiscoveryAdBuilder()
bumperAdBuilder()
responsiveVideoAdBuilder()
(somente paraVIDEO_ACTION
campanhas)nonSkippableAdBuilder()
(somente paraVIDEO_NON_SKIPPABLE
campanhas)
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();
}