Campagne video

Gli script Google Ads consentono di gestire le campagne video basate su YouTube e di generare report su di esse. 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.

Recuperare campagne video e gruppi di annunci

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

Creare annunci video

Gli script Google Ads consentono di recuperare gli annunci video utilizzando il videoAds() metodo di VideoAdGroup. Puoi creare nuovi annunci video utilizzando il newVideoAd() metodo 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 corretto, aggiungi una chiamata withCondition a 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 di annunci video:

  • TrueView in-stream
  • Video discovery TrueView
  • Bumper

Puoi selezionare queste campagne utilizzando withCondition:

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

Gli annunci video in-stream possono essere riprodotti prima, durante o dopo altri video, dando agli utenti la possibilità di saltarli 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 hanno una durata massima di 6 secondi e possono essere visualizzati sui video di YouTube o sui video di siti e app partner della Rete Display. Per informazioni complete su ciascuno di questi tipi di annunci, consulta l'articolo Informazioni sui formati degli annunci video.

Creare il gruppo di annunci

Puoi creare un gruppo di annunci video tramite il newVideoAdGroupBuilder() metodo di una campagna video. Quando crei il gruppo di annunci, devi specificare un tipo e un nome per il gruppo di annunci. Il tipo di gruppo di annunci deve essere uno dei seguenti e non può essere modificato dopo la creazione del gruppo di annunci:

  • VIDEO_BUMPER
  • VIDEO_EFFICIENT_REACH
  • VIDEO_NON_SKIPPABLE_IN_STREAM (solo per le campagne VIDEO_NON_SKIPPABLE)
  • VIDEO_RESPONSIVE (solo per le campagne VIDEO_ACTION)
  • VIDEO_TRUE_VIEW_IN_DISPLAY
  • VIDEO_TRUE_VIEW_IN_STREAM
  • YOUTUBE_AUDIO

Esempio:

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

Creare l'asset video

In genere, gli annunci video devono fare riferimento a un asset video. Questo determina quale video 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. Per farlo, crea un Asset con il 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();

Creare l'annuncio

Per creare un nuovo annuncio, utilizza il metodo di creazione corrispondente al tipo di gruppo di annunci (concatenato dopo newVideoAd()):

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 tipi diversi di targeting pertinenti per le campagne video. The VideoCampaignTargeting rappresenta qualsiasi targeting eseguito a livello di account per le campagne video in generale e a cui si accede utilizzando AdsApp.videoCampaignTargeting(). 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. È possibile accedervi con il metodo videoTargeting() nella campagna o nel gruppo di annunci e fornisce l'accesso a selettori e builder per i criteri positivi e negativi per tutti i tipi applicabili a quel livello di targeting. Il AdsApp.videoTargeting() metodo esiste anche 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.

Di seguito è riportato 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 seleziona come target. Puoi escludere un dato demografico recuperando il targeting esistente e chiamando il metodo exclude(), mentre puoi includere di nuovo un dato demografico escluso trovando il targeting di esclusione esistente e chiamando include().

Di seguito è riportato 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();
}