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 dell'API

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

• Modificabilità di VideoResponsiveAdInfo: a partire da v24, gli oggetti VideoResponsiveAdInfo sono modificabili (nelle versioni precedenti sono immutabili). Quando crei o modifichi VideoResponsiveAdInfo, i campi videos, business_name e logo_images sono obbligatori.
• Idoneità alla sicurezza del brand: a partire da v24, il 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 sulle campagne video: a partire dal giorno v24, experiment.video_experiment è disponibile per la configurazione YOUTUBE_CUSTOM di esperimenti costituiti da campagne video.

Alternative per la gestione delle campagne

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

• Script Google Ads: puoi gestire le campagne video utilizzando gli script Google Ads. Ciò consente la gestione automatica all'interno dell'interfaccia Google Ads.
• Campagne Demand Gen: se il tuo obiettivo è pubblicare annunci video nelle proprietà di Google, tra cui YouTube, le campagne Demand Gen sono completamente supportate nell'API Google Ads per la creazione e la gestione.

Ottenere i dati sul rendimento

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

Nota :utilizza metrics.video_trueview_views, metrics.video_trueview_view_rate e metrics.trueview_average_cpv (rinominati dai campi legacy metrics.video_views, metrics.video_view_rate e metrics.average_cpv in v22). A partire dal v25, puoi anche selezionare segments.ad_sub_format_type (insieme a segments.ad_format_type) per analizzare gli annunci in-stream non ignorabili in base alla durata, nonché le metriche sul coinvolgimento sociale dei video (metrics.youtube_comments, metrics.youtube_likes e metrics.youtube_shares).

Rendimento dei gruppi di annunci

La seguente query recupera le metriche di campagne video e gruppi di annunci, tra cui visualizzazioni video TrueView e tassi 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 sul posizionamento e sui criteri 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 video di YouTube, canali YouTube o altri posizionamenti gestiti di destinazione:

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