Campagne video

Gli script Google Ads ti consentono di gestire e generare report sulle campagne video basate su YouTube. Puoi utilizzare gli script per gestire le campagne video esistenti, creare e gestire annunci e gruppi di annunci, impostare il targeting per le campagne ed eseguire report. Tuttavia, non puoi utilizzare gli script per creare campagne video.

Recupero di campagne e gruppi di annunci video

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

Creazione di annunci video

Gli script Google Ads ti consentono di recuperare gli 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 corretto, aggiungi una chiamata withCondition su AdvertisingChannelSubType.

Alcune campagne video hanno sottotipi che limitano i tipi di annunci supportati al loro interno. Nello specifico, le campagne VIDEO_ACTION supportano solo il tipo di annuncio VIDEO_RESPONSIVE e 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 il valore AdvertisingChannelSubType per il tipo di campagna di tuo 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 un 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 determinato periodo di tempo. Gli annunci video discovery vengono visualizzati sulla Rete Display e su varie pagine di YouTube e vengono riprodotti solo se un utente fa prima clic attivamente sulla miniatura dell'annuncio. Gli annunci bumper durano massimo 6 secondi e possono essere pubblicati sui video di YouTube o sui video di siti partner e app sulla Rete Display. Per informazioni dettagliate su ciascuno di questi tipi di annunci, consulta la sezione Informazioni sui formati degli annunci video.

Crea il gruppo di annunci

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

  • TRUE_VIEW_IN_STREAM
  • TRUE_VIEW_IN_DISPLAY
  • BUMPER
  • VIDEO_RESPONSIVE (solo per le campagne VIDEO_ACTION)
  • NON_SKIPPABLE_INSTREAM_VIDEO_AD (solo per le campagne VIDEO_NON_SKIPPABLE)

Esempio:

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

Crea l'asset video

In genere, gli annunci video devono fare riferimento a una risorsa 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. A tale scopo, 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 del generatore corrispondente al tipo di gruppo di annunci (in catena 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 tipi diversi di targeting pertinente per le campagne video. VideoCampaignTargeting rappresenta qualsiasi targeting impostato a livello di account per le campagne video in generale e si accede utilizzando AdsApp.videoCampaignTargeting(). Questo valore non può essere modificato tramite 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() della campagna o del gruppo di annunci e fornisce accesso a selettori e generatori per i criteri positivi e negativi per tutti i tipi applicabili a quel livello di targeting. Il metodo AdsApp.videoTargeting() esiste anche per visualizzare i criteri a livello di account e include un insieme di criteri diverso da AdsApp.videoCampaignTargeting(). Come per 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 ha come target tutti questi valori. Puoi escludere un gruppo demografico recuperando il targeting esistente e chiamando il metodo exclude(). Puoi includere nuovamente un gruppo demografico escluso individuando il targeting per 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();
}