Campagne video

Le campagne video ti consentono di pubblicare annunci video su YouTube e su siti web e app in esecuzione sui partner video Google.

Limitazioni delle API

L'API Google Ads supporta principalmente il recupero e la generazione di report su campagne video, gruppi di annunci, annunci e criteri esistenti. Le campagne video non possono essere create o mutate utilizzando l'API Google Ads, con le seguenti eccezioni e comportamenti specifici della versione:

• Mutabilità di VideoResponsiveAdInfo: a partire dalla versione 24, gli oggetti VideoResponsiveAdInfo sono mutabili (nelle versioni precedenti sono immutabili). Quando crei o muti VideoResponsiveAdInfo, i campi videos, business_name e logo_images sono obbligatori.
• Idoneità alla sicurezza del brand: a partire dalla versione 24, il campo campaign.video_brand_safety_suitability a livello di campagna viene rimosso. Esegui query sull'idoneità della sicurezza del brand a livello di account utilizzando customer.video_brand_safety_suitability.
• Esperimenti con campagne video: a partire dalla versione 24, experiment.video_experiment è disponibile per la configurazione di esperimenti YOUTUBE_CUSTOM costituiti da campagne video.

Alternative per la gestione delle campagne

Se devi creare o gestire le campagne video in modo programmatico, prendi in considerazione le seguenti opzioni:

• Script Google Ads: puoi gestire le campagne video utilizzando gli script Google Ads. In questo modo, è possibile gestire automaticamente le campagne nell'interfaccia di Google Ads.
• Campagne Demand Gen: se il tuo obiettivo è pubblicare annunci video nelle proprietà di Google, incluso YouTube, le campagne Demand Gen sono completamente supportate nell'API Google Ads sia per la creazione che per la gestione.

Ottenere dati sul rendimento

Puoi recuperare i dati sul rendimento delle campagne video, dei gruppi di annunci e dei criteri utilizzando GoogleAdsService.SearchStream e filtrando per campaign.advertising_channel_type = 'VIDEO'.

Rendimento dei gruppi di annunci

La seguente query recupera le metriche delle campagne video e dei gruppi di annunci, tra cui le visualizzazioni di video TrueView e le percentuali di completamento dei quartili, dalla risorsa ad_group:

SELECT
  campaign.id,
  campaign.name,
  campaign.advertising_channel_type,
  ad_group.id,
  ad_group.name,
  metrics.impressions,
  metrics.clicks,
  metrics.ctr,
  metrics.video_trueview_views,
  metrics.video_quartile_p100_rate
FROM ad_group
WHERE campaign.advertising_channel_type = 'VIDEO'

Report sui criteri e sul posizionamento dei video

Poiché ad_group_criterion non supporta direttamente metriche o segmenti, utilizza risorse di visualizzazione dei criteri come managed_placement_view per recuperare le metriche sul rendimento per i video di YouTube, i canali YouTube o altri posizionamenti gestiti scelti come target:

SELECT
  campaign.id,
  ad_group.id,
  ad_group_criterion.criterion_id,
  ad_group_criterion.type,
  ad_group_criterion.youtube_video.video_id,
  ad_group_criterion.youtube_channel.channel_id,
  metrics.impressions,
  metrics.video_trueview_views
FROM managed_placement_view
WHERE campaign.advertising_channel_type = 'VIDEO'
  AND ad_group_criterion.type IN ('YOUTUBE_VIDEO', 'YOUTUBE_CHANNEL')
  AND segments.date DURING LAST_30_DAYS

Report su copertura e frequenza

Per le campagne video, puoi eseguire query sulle metriche di copertura Unique Reach nelle risorse campaign e customer (a partire dalla versione 26) per misurare il numero di singoli utenti a cui sono stati mostrati i tuoi annunci con frequenze di impressioni specifiche.

Le seguenti metriche relative agli utenti unici misurano la copertura di pubblico in base ai bucket di frequenza:

• metrics.unique_users: il numero di persone uniche che hanno visto il tuo annuncio almeno una volta nell'intervallo di date selezionato (fino a 92 giorni). Non può essere aggregata tra le righe.
• Da metrics.unique_users_two_plus a metrics.unique_users_ten_plus: il numero di utenti unici che hanno visto il tuo annuncio almeno da 2 a 10 volte, rispettivamente, per intervalli di date fino a 31 giorni (con metrics.unique_users_six_plus fino a metrics.unique_users_nine_plus che completano l'insieme da 2+ a 10+ nella versione 26 e successive).
• metrics.average_impression_frequency_per_user: il numero medio di volte in cui un utente unico ha visualizzato il tuo annuncio durante il periodo richiesto (fino a 92 giorni). Questa metrica è disponibile solo nella risorsa campaign, non può essere aggregata tra le righe e non ha un campo _info associato.

Nella versione 26 e successive, ogni metrica di copertura degli utenti unici ha un campo di metadati associato di tipo ReachMetricInfo: metrics.unique_users_info e metrics.unique_users_two_plus_info fino a metrics.unique_users_ten_plus_info.

In Google Ads Query Language (GAQL), i campi companion metrics.unique_users*_info sono metriche MESSAGE con filterable: false e sortable: false, quindi non puoi utilizzarli nelle clausole WHERE o ORDER BY. Seleziona questi campi direttamente nella clausola SELECT (ad esempio metrics.unique_users_info). Non aggiungere .reach_metric_states nella clausola SELECT, perché la selezione dei campi dei messaggi nidificati in GAQL non va a buon fine con UNRECOGNIZED_FIELD. Selezionando metrics.unique_users_info, viene restituito un messaggio ReachMetricInfo contenente il campo enum ripetuto reach_metric_states di tipo ReachMetricState, che indica se la metrica è stata soppressa o è completa.

Ogni volta che una metrica di copertura viene soppressa o non rientra nella finestra di conservazione (PRIVACY_SUPPRESSION, QUALITY_SUPPRESSION o DATE_RANGE_BEYOND_RETENTION), il campo optional int64 su Metrics non è impostato (il che restituisce 0 se la presenza del campo non viene controllata), mentre LOW_QUALITY compila comunque la metrica numerica.

I valori enum ReachMetricState indicano lo stato dei dati sulla copertura:

• COMPLETE: la metrica di copertura è completa e non è stata applicata alcuna soppressione per motivi di privacy, qualità o altri limiti.
• PRIVACY_SUPPRESSION: i dati sulla copertura sono stati eliminati per proteggere la privacy degli utenti (ad esempio, quando il volume del segmento di pubblico non soddisfa le soglie di k-anonimato).
• QUALITY_SUPPRESSION: i dati sulla copertura sono stati soppressi a causa dei requisiti di qualità dei dati.
• LOW_QUALITY: la metrica di copertura è stata calcolata, ma è contrassegnata come di bassa qualità.
• DATE_RANGE_BEYOND_RETENTION: le metriche di copertura non sono disponibili perché l'intervallo di date selezionato supera il periodo di conservazione dei dati di copertura di 3 anni.

La seguente query recupera le metriche di copertura con deduplicazione di 30 giorni e i relativi stati di soppressione per le campagne video, segmentate per dispositivo e formato dell'annuncio. Ometti il segmento segments.date dalla clausola SELECT in modo che le metriche di copertura e frequenza N+ vengano deduplicate nell'intera finestra di date anziché per giorno:

SELECT
  campaign.id,
  campaign.name,
  segments.device,
  segments.ad_format_type,
  segments.ad_sub_format_type,
  metrics.unique_users,
  metrics.unique_users_info,
  metrics.unique_users_two_plus,
  metrics.unique_users_two_plus_info,
  metrics.unique_users_six_plus,
  metrics.unique_users_six_plus_info,
  metrics.unique_users_ten_plus,
  metrics.unique_users_ten_plus_info
FROM campaign
WHERE campaign.advertising_channel_type = 'VIDEO'
  AND segments.date DURING LAST_30_DAYS

Risorse, finestre di date e segmenti supportati

Le query su copertura e frequenza richiedono un filtro segments.date finito all'interno della finestra di date massima della metrica. Le query senza un filtro per data o che superano la finestra restituiscono campi di copertura non impostati:

Quando segmenti le query di copertura, applica i seguenti vincoli di segmentazione congiunta:

• Segmenti Formato dell'annuncio e Rete pubblicitaria: puoi segmentare per formato dell'annuncio (segments.ad_format_type, facoltativamente con segments.ad_sub_format_type) o per rete pubblicitaria (segments.ad_network_type, facoltativamente con segments.ad_sub_network_type), ma non puoi combinare i segmenti Formato dell'annuncio e Rete pubblicitaria nella stessa query. Seleziona sempre il segmento principale (segments.ad_format_type o segments.ad_network_type) quando selezioni il relativo sottosegmento. Il segmento segments.ad_sub_format_type suddivide gli annunci in-stream non ignorabili in base alla durata e restituisce UNSEGMENTED per altri formati degli annunci, mentre il segmento segments.ad_sub_network_type suddivide le piattaforme di YouTube (YOUTUBE_INSTREAM, YOUTUBE_INFEED e YOUTUBE_SHORTS) solo per le campagne Demand Gen e restituisce UNSEGMENTED per le campagne video.
• Segmenti demografici modificati: i segmenti segments.adjusted_age_range e segments.adjusted_gender sono disponibili solo per gli account inclusi nella lista consentita, devono essere selezionati insieme e non possono essere combinati con metriche metrics.unique_users_*_plus, campi metrics.unique_users*_info o segmenti di reti pubblicitarie.