Campagne video

Gli script Google Ads ti consentono di gestire le campagne video basate su YouTube e generare i relativi report. Puoi utilizzare gli script per gestire le campagne video esistenti, creare e gestire i gruppi di annunci e gli annunci, impostare 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 raccolta videoCampaigns di un oggetto AdsApp. Puoi recuperarle come faresti normalmente per 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 giusto, aggiungi una chiamata withCondition al numero AdvertisingChannelSubType.

Alcune campagne video contengono 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 che ti interessa:

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 saltare l'annuncio dopo un determinato periodo di tempo. Gli annunci video discovery vengono pubblicati sulla Rete Display e su varie pagine di YouTube e vengono riprodotti solo se un utente fa clic attivamente per prima sulla miniatura dell'annuncio. Gli annunci bumper hanno una durata massima di 6 secondi e possono essere pubblicati sui video di YouTube o su app e siti partner sulla Rete Display. Per informazioni dettagliate su ciascuno di questi tipi di annunci, consulta Informazioni sui formati degli annunci video.

Creare il gruppo di annunci

Puoi creare un gruppo di annunci video con il metodo newVideoAdGroupBuilder() di una campagna video. Devi specificare un tipo di gruppo di annunci e un nome del gruppo di annunci quando crei 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:

  • 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)

Esempio:

const videoAdGroup =
    videoCampaign.newVideoAdGroupBuilder()
    .withAdGroupType("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 l'utilizzo nei tuoi annunci. Per farlo, crea una 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 per la creazione che corrisponde 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 diversi tipi di targeting pertinente per le campagne video. L'elemento VideoCampaignTargeting rappresenta qualsiasi targeting effettuato a livello di account per le campagne video in generale e accessibile tramite AdsApp.videoCampaignTargeting(). Non può essere modificato tramite gli script, ma può essere visualizzato.

L'altro tipo di targeting consente di specificare singoli criteri per campagne video e gruppi di annunci video. Puoi accedere a questa funzionalità con il metodo videoTargeting() nella campagna o nel gruppo di annunci e che consente di accedere a selettori e generatori per 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 diverso di criteri 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 criteri per ogni possibile valore di età e genere e il gruppo di annunci sceglie come target tutti questi valori. Puoi escludere un gruppo demografico recuperando il targeting esistente e chiamando il metodo exclude() su di esso, e puoi includere di nuovo un gruppo demografico escluso individuando il targeting per esclusione esistente e chiamando include().

Di seguito è riportato un esempio per escludere un determinato genere da un gruppo di annunci:

const videoGenderIterator = videoAdGroup.videoTargeting()
    .genders()
    .withCondition('GenderType = "GENDER_MALE"')
    .get();
if (videoGenderIterator.hasNext()) {
  const videoGender = videoGenderIterator.next();
  videoGender.exclude();
}