Gli script Google Ads ti consentono di gestire e generare report sulle tue campagne video basate su YouTube. Puoi utilizzare gli script per gestire le campagne video esistenti, creare e gestire gruppi di annunci e annunci, configurare il targeting per le campagne ed eseguire report. Tuttavia, non puoi utilizzare gli script per creare campagne video.
Recupera campagne video e gruppi di annunci
Le campagne video sono disponibili tramite la raccolta videoCampaigns di un oggetto AdsApp. Puoi recuperarle come faresti normalmente con le campagne negli script:
const campaignName = "My first video campaign";
const campaignIterator = AdsApp.videoCampaigns()
.withCondition(`campaign.name = "${campaignName}"`)
.get();
for (const campaign of campaignIterator) {
...
}
Una volta recuperata una campagna, puoi ottenere i relativi gruppi di annunci in modo simile:
const adGroupIterator = campaign.videoAdGroups()
.withCondition(`ad_group.name = "${adGroupName}"`)
.get();
for (const adGroup of adGroupIterator) {
...
}
In alternativa, puoi utilizzare il metodo AdsApp.videoAdGroups():
const adGroupIterator = AdsApp.videoAdGroups()
.withCondition(`campaign.name = "${campaignName}" AND ad_group.name = "${adGroupName}")
.get();
for (const adGroup of adGroupIterator) {
...
}
Crea annunci video
Gli script Google Ads ti consentono di recuperare i tuoi annunci video utilizzando il metodo videoAds() di VideoAdGroup. Puoi creare nuovi annunci video utilizzando il metodo newVideoAd() di VideoAdGroup.
Formati annunci video
I formati degli annunci video supportati variano in base al tipo di campagna video. Per assicurarti di selezionare il tipo di campagna video giusto, aggiungi una chiamata withCondition il giorno AdvertisingChannelSubType.
Alcune campagne video hanno sottotipi che limitano i tipi di annunci supportati all'interno della campagna. In particolare, le campagne VIDEO_ACTION supportano solo il tipo di annuncio VIDEO_RESPONSIVE, mentre le campagne VIDEO_NON_SKIPPABLE supportano solo il tipo di annuncio NON_SKIPPABLE_INSTREAM_VIDEO_AD.
Il modo migliore per operare su tipi specifici di campagne è utilizzare una clausola withCondition nel selettore. Puoi aggiornare
AdvertisingChannelSubType per il tipo di campagna di interesse:
const campaignIterator = AdsApp.videoCampaigns()
.withCondition("AdvertisingChannelSubType = VIDEO_ACTION")
.get();
Le campagne video senza sottotipo supportano i seguenti formati degli annunci video:
- TrueView in-stream
- Video discovery TrueView
- Bumper
Puoi selezionare queste campagne utilizzando un withCondition:
const campaignIterator = AdsApp.videoCampaigns()
.withCondition("AdvertisingChannelSubType = null")
.get();
Gli annunci video in-stream possono essere riprodotti prima, durante o dopo altri video, offrendo agli utenti la possibilità di ignorarli dopo un periodo di tempo specificato. Gli annunci video discovery vengono visualizzati sulla Rete Display e su varie pagine di YouTube e vengono riprodotti solo se un utente fa clic attivamente sulla miniatura dell'annuncio. Gli annunci bumper durano 6 secondi o meno e possono essere visualizzati sui video di YouTube o sui video di siti e app partner sulla Rete Display. Per informazioni dettagliate su ciascuno di questi tipi di annunci, consulta Informazioni sui formati degli annunci video.
Crea il gruppo di annunci
Puoi creare un gruppo di annunci video utilizzando il metodo newVideoAdGroupBuilder() di una campagna video. Quando crei il gruppo di annunci, devi specificare un tipo e un nome. Il tipo di gruppo di annunci deve essere uno dei seguenti e non può essere modificato dopo la creazione del gruppo di annunci:
VIDEO_BUMPERVIDEO_EFFICIENT_REACHVIDEO_NON_SKIPPABLE_IN_STREAM(solo per le campagneVIDEO_NON_SKIPPABLE)VIDEO_RESPONSIVE(solo per le campagneVIDEO_ACTION)VIDEO_TRUE_VIEW_IN_DISPLAYVIDEO_TRUE_VIEW_IN_STREAMYOUTUBE_AUDIO
Esempio:
const videoAdGroup =
videoCampaign.newVideoAdGroupBuilder()
.withAdGroupType("VIDEO_TRUE_VIEW_IN_STREAM")
.withName("Video Ad Group")
.build()
.getResult();
Crea l'asset video
In genere, gli annunci video devono fare riferimento a un asset video. In questo modo, viene determinato il video che verrà riprodotto per l'annuncio. Non puoi caricare un video utilizzando gli script, ma puoi collegare un video di YouTube esistente che hai caricato in precedenza per utilizzarlo nei tuoi annunci.
A questo scopo, crea un Asset con
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();
Crea l'annuncio
Per creare un nuovo annuncio, utilizza il metodo del builder corrispondente al tipo di gruppo di annunci (concatenato dopo newVideoAd()):
inStreamAdBuilder()videoDiscoveryAdBuilder()bumperAdBuilder()responsiveVideoAdBuilder()(solo per le campagneVIDEO_ACTION)nonSkippableAdBuilder()(solo per le campagneVIDEO_NON_SKIPPABLE)
Ad esempio:
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();
Targeting video
Esistono due diversi tipi di targeting pertinente per le campagne video. VideoCampaignTargeting rappresenta qualsiasi targeting eseguito a livello di account per le campagne video in generale ed è accessibile tramite AdsApp.videoCampaignTargeting(). Questo valore non può essere modificato tramite gli script, ma può essere visualizzato.
L'altro tipo di targeting ti consente di specificare i criteri per le campagne video e i gruppi di annunci video singolarmente. Puoi accedervi con il metodo videoTargeting() nella campagna o nel gruppo di annunci. Consente di accedere a selettori e builder per i criteri positivi e negativi per tutti i tipi applicabili a quel livello di targeting. Esiste anche il metodo AdsApp.videoTargeting() per visualizzare i criteri a livello di account e include un insieme di criteri diverso da AdsApp.videoCampaignTargeting(). Come
VideoCampaignTargeting, non puoi gestire questi criteri con gli script.
Ecco un esempio di esclusione di un posizionamento specifico in una campagna:
videoCampaign.videoTargeting().newPlacementBuilder()
.withUrl("http://www.example.com")
.exclude();
I criteri per i dati demografici (età, genere) funzionano in modo leggermente diverso rispetto agli altri tipi di criteri. Quando viene creato un nuovo gruppo di annunci, vengono creati automaticamente i criteri per ogni possibile valore di età e genere e il gruppo di annunci li sceglie tutti come target. Puoi escludere un gruppo demografico recuperando il targeting esistente e chiamando il metodo exclude(). Puoi includere nuovamente un gruppo demografico escluso trovando il targeting di esclusione esistente e chiamando include().
Ecco un esempio di esclusione di un genere specifico da un gruppo di annunci:
const videoGenderIterator = videoAdGroup.videoTargeting()
.genders()
.withCondition('GenderType = "GENDER_MALE"')
.get();
if (videoGenderIterator.hasNext()) {
const videoGender = videoGenderIterator.next();
videoGender.exclude();
}