Campagne video

Gli script Google Ads ti consentono di gestire e generare report sui video di YouTube campagne. Puoi usare gli script per gestire campagne video esistenti, creare e gestire gruppi di annunci e annunci, configurare targeting per campagne ed eseguire report. Tuttavia, non puoi utilizzare gli script per creare campagne video.

Recupero di campagne video e gruppi di annunci

Le campagne video sono disponibili tramite videoCampaigns raccolta di AdsApp. Tu 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) {
  ...
}

Dopo aver recuperato una campagna, puoi visualizzare 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) {
  ...
}

Creazione di annunci video

Gli script Google Ads ti consentono di recuperare gli annunci video utilizzando il videoAds() metodo di VideoAdGroup. Puoi creare nuovi annunci video utilizzando il newVideoAd() di VideoAdGroup.

Formati annunci video

I formati degli annunci video supportati variano in base al tipo di campagna video. Per garantire stai selezionando il tipo giusto di campagna video, aggiungi una chiamata withCondition il giorno AdvertisingChannelSubType.

Alcune campagne video hanno sottotipi che limitano i tipi di annunci supportati nella campagna. Nello specifico, solo VIDEO_ACTION campagne supporta il tipo di annuncio VIDEO_RESPONSIVE e VIDEO_NON_SKIPPABLE campagne supportano solo il tipo di annuncio NON_SKIPPABLE_INSTREAM_VIDEO_AD.

Il modo migliore per operare su tipi specifici di campagne è utilizzare una withCondition nel selettore. Puoi aggiornare AdvertisingChannelSubType per il tipo di campagna che ti interessa:

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

Le campagne video senza sottotipo supportano i seguenti formati di 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 saltare l'annuncio dopo un determinato periodo di tempo. Gli annunci video discovery vengono pubblicati su sulla Rete Display e su varie pagine di YouTube e viene riprodotta solo se un utente fa prima attivamente clic sulla miniatura dell'annuncio. Gli annunci bumper hanno una durata massima di 6 secondi e possono apparire nei video di YouTube o nei video di app e siti partner Rete Display di Google. Per informazioni dettagliate su ciascuno di questi tipi di annunci, consulta le Informazioni formati degli annunci video.

Crea il gruppo di annunci

Puoi creare un gruppo di annunci video tramite la newVideoAdGroupBuilder() di una campagna video. Devi specificare un tipo di gruppo di annunci e un annuncio nome del gruppo quando lo crei. Il tipo di gruppo di annunci deve essere uno dei e non può essere modificato dopo la creazione del gruppo di annunci:

  • TRUE_VIEW_IN_STREAM
  • TRUE_VIEW_IN_DISPLAY
  • BUMPER
  • VIDEO_RESPONSIVE (solo per VIDEO_ACTION campagne)
  • NON_SKIPPABLE_INSTREAM_VIDEO_AD (solo per VIDEO_NON_SKIPPABLE campagne)
di Gemini Advanced.

Esempio:

const videoAdGroup =
    videoCampaign.newVideoAdGroupBuilder()
    .withAdGroupType("TRUE_VIEW_IN_STREAM")
    .withName("Video Ad Group")
    .build()
    .getResult();

Creare l'asset video

Gli annunci video in genere devono fare riferimento a un asset video. Questo determina quale video verrà riprodotta 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. Per farlo, devi creare 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 dello strumento di creazione corrispondente al tipo di gruppo di annunci (collegato dopo newVideoAd()):

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. La VideoCampaignTargeting rappresenta qualsiasi targeting applicato a livello di account per le campagne video. in generale e si accede utilizzando AdsApp.videoCampaignTargeting(). Questo non possono essere modificati tramite script, ma possono essere visualizzati.

L'altro tipo di targeting consente di specificare i criteri per le campagne video. e gruppi di annunci video singolarmente. È possibile accedervi con videoTargeting() nella campagna o nel gruppo di annunci e fornisce l'accesso a selettori e builder per criteri sia positivi che negativi per tutti i tipi applicabili a quel livello di targeting. La AdsApp.videoTargeting() esiste anche per visualizzare i criteri a livello di account e include una insieme di criteri diverso da AdsApp.videoCampaignTargeting(). Mi piace VideoCampaignTargeting, non puoi gestire questi criteri con gli script.

Di seguito è riportato un esempio di come escludere un determinato posizionamento 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 ai altri tipi di criteri. Quando viene creato un nuovo gruppo di annunci, i criteri per i possibili valori di età e genere vengono creati automaticamente e quel gruppo di annunci sceglie come target tutti questi elementi. Puoi escludere un gruppo demografico recuperando il gruppo demografico esistente targeting e chiamando il metodo exclude(); puoi includere nuovamente i dati demografici esclusi individuando il targeting per esclusione esistente e include().

Di seguito è riportato un esempio di come escludere 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();
}