Com os scripts do Google Ads, você pode gerenciar e gerar relatórios sobre suas campanhas de vídeo no YouTube. Você pode usar scripts para gerenciar campanhas de vídeo existentes, criar e gerenciar grupos de anúncios e anúncios, configurar segmentação para campanhas e gerar relatórios. No entanto, não é possível usar scripts para criar campanhas de vídeo.
Como 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 objeto
AdsApp
. Você pode extrair as campanhas da mesma forma que faria normalmente 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
.
É possível 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ê selecionou 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
com suporte a essa 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 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 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, proporcionando 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ó sã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 e apps de parceiros na Rede de Display. Para saber mais sobre cada um desses tipos de anúncio, consulte Sobre os 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. É 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 é criado:
TRUE_VIEW_IN_STREAM
TRUE_VIEW_IN_DISPLAY
BUMPER
VIDEO_RESPONSIVE
(somente para campanhasVIDEO_ACTION
)NON_SKIPPABLE_INSTREAM_VIDEO_AD
(somente para campanhasVIDEO_NON_SKIPPABLE
)
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 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 você já enviou para uso nos seus anúncios.
Para 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 editor correspondente ao tipo de grupo de anúncios
(vinculado após newVideoAd()
):
inStreamAdBuilder()
videoDiscoveryAdBuilder()
bumperAdBuilder()
responsiveVideoAdBuilder()
(somente para campanhasVIDEO_ACTION
)nonSkippableAdBuilder()
(somente para campanhasVIDEO_NON_SKIPPABLE
)
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 em vídeo
em geral e é acessado usando AdsApp.videoCampaignTargeting()
. Ele
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. É possível acessar essa segmentação com o método videoTargeting()
na campanha ou no grupo de anúncios, e ela oferece acesso a seletores e construtores de 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 conferir 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
é segmentado para 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();
}