Campagne video

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 e generare report. Tuttavia, non puoi utilizzare script per creare campagne video.

Recupero di campagne video e gruppi di annunci

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 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 withConditionchiamata su AdvertisingChannelSubType.

Alcune campagne video hanno sottotipi che limitano i tipi di annunci supportati all'interno della campagna. 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 withConditionnel selettore. Puoi aggiornare il 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, 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 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 della Rete Display. Per informazioni dettagliate su ciascuno di questi tipi di annuncio, consulta la sezione Informazioni sui formati degli annunci video.

Creare il gruppo di annunci

Crea un gruppo di annunci video tramite 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_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 una risorsa video. Determina quale video verrà riprodotto per l'annuncio. Non puoi caricare un video utilizzando 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 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()):

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 eseguito a livello di account per le campagne video in generale e a cui si accede utilizzando AdsApp.videoCampaignTargeting(). Questo 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() nella campagna o nel gruppo di annunci e fornisce l'accesso a selettori e generatori per 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, che 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 prende tutti di mira. Puoi escludere un gruppo demografico recuperando il targeting esistente e chiamando il metodo exclude(), mentre puoi includere di nuovo 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();
}