Documentazione Experience Platform Guida ai connettori di origini

Google Ads (V2)

Ultimo aggiornamento: 2 ottobre 2026

Argomenti:
Sources

Creato per:

Developer

IMPORTANT

L'origine Google Ads è disponibile come parte dello SKU Customer Journey Analytics.

Google Ads (V2) è un connettore di origine di contenuti multimediali a pagamento Adobe Experience Platform che acquisisce i dati di account pubblicitari, campagne, gruppi di annunci, annunci, risorse, esperienze e prestazioni dall’API Google Ads in Experience Platform.

Il connettore mappa i dati Google Ads su strutture standardizzate a pagamento Experience Data Model (XDM), consentendo di analizzare Google Ads dati insieme a dati provenienti da altre reti pubblicitarie, proprietà web, sistemi commerce e applicazioni cliente.

Google Ads (V2) utilizza l’accesso in sola lettura per recuperare i dati di reporting e i metadati pubblicitari. Non crea, modifica o elimina le risorse Google Ads.

Casi d’uso di esempio

Caso d’uso

Obiettivo

Come Google Ads (V2) aiuta

Analisi della pubblicità cross-channel

Confrontare le prestazioni di Google Ads con Meta Ads e altri canali a pagamento.

Acquisisce i dati Google Ads in strutture XDM per elementi multimediali a pagamento comuni con identificatori standardizzati a livello di entità.

Modellazione e attribuzione Media Mix

Valutare il contributo dei mezzi di comunicazione a pagamento ai risultati aziendali.

Fornisce dati sulle prestazioni di campagne e annunci pubblicitari, tra cui impression, clic, spesa, conversioni e valore di conversione per l’analisi a valle.

Ottimizzazione di campagne e budget

Scopri quali campagne, strategie di offerta e configurazioni di targeting producono i risultati migliori.

Acquisisce metadati della campagna, budget, strategie di offerta, tipi di canale, stati, date e criteri di targeting selezionati.

Creative e prestazioni delle risorse

Identifica le risorse creative, i formati di annunci e le esperienze con le prestazioni migliori.

Acquisisce metadati creativi a livello di annuncio, tra cui associazioni di risorse, tipi ed etichette di prestazioni.

Analisi delle prestazioni massime

Analizza i gruppi di risorse con prestazione massima e le risorse associate.

Utilizza i dati del gruppo di risorse con prestazione massima per rappresentare le prestazioni del gruppo di risorse e le relazioni di esperienza in cui Google Ads non espone una struttura tradizionale a livello di annuncio.

Analisi del percorso di clienti

Associa il coinvolgimento pubblicitario a eventi Web, commerce, CRM e altri eventi cliente.

Rende disponibili i dati di Google Ads in Experience Platform per l’utilizzo con i flussi di lavoro di attivazione e analisi a valle.

Prerequisiti

Prima di connettere Google Ads (V2) ad Experience Platform, assicurati di disporre dei seguenti elementi:

Configurare le autorizzazioni su Experience Platform

Per il tuo account Experience Platform, devi avere entrambe le autorizzazioni Visualizza origini e Gestisci origini abilitate.

Se non disponi delle autorizzazioni necessarie, contatta l’amministratore del prodotto. Per ulteriori informazioni, leggere la guida all’interfaccia utente per il controllo degli accessi.

Configura accesso API Google Ads

Experience Platform gestisce il flusso di autorizzazione OAuth 2.0 per Google Ads (V2). Non crei un progetto Google Cloud, un client OAuth o un token di aggiornamento.

Devi avere:

Un token sviluppatore Google Ads valido.
Accedi all’account dell’inserzionista Google Ads che desideri acquisire.
Autorizzazione per accedere agli account pubblicitari pertinenti tramite Google Ads o un account manager Google Ads.

Accesso Manager-account

Se si accede all’account dell’inserzionista tramite un account manager Google Ads, specificare anche l’ID cliente manager appropriato come loginCustomerId.

loginCustomerId non è necessario quando l’utente autorizzato OAuth può accedere direttamente all’account dell’inserzionista di destinazione e non è necessaria alcuna gerarchia di gestione.

Google Ads (V2) enumera gli account accessibili, identifica gli account manager, attraversa la gerarchia degli account manager e risolve gli account inserzionisti disponibili per l’acquisizione.

Raccogli le credenziali richieste

Per connettere Google Ads (V2) ad Experience Platform, fornisci i seguenti valori.

Credenziali

Descrizione

developerToken

Token sviluppatore Google Ads utilizzato per autorizzare le richieste API.

loginCustomerId

ID cliente numerico dell’account manager utilizzato per accedere all’account inserzionista. Questa credenziale è necessaria per l’accesso dell’account manager.

Autenticazione e individuazione account

Google Ads (V2) utilizza OAuth 2.0 per autorizzare l’accesso all’API Google Ads. Experience Platform gestisce il flusso di autorizzazione, pertanto non è possibile configurare ambiti o autorizzazioni OAuth sul lato Google Ads.

Dopo aver autorizzato l’account, Experience Platform utilizza il token sviluppatore per accedere alle risorse di reporting di Google Ads. Per le configurazioni manager-account, il connettore risolve la gerarchia degli account e identifica gli account inserzionisti disponibili per l’acquisizione.

Il flusso di lavoro di individuazione account include le operazioni seguenti:

Enumera account accessibili all’utente autorizzato.
Determina se un account accessibile è un account manager.
Attraversare la gerarchia manager-account.
Identifica gli account degli inserzionisti non manager.
Utilizza loginCustomerId appropriato quando le richieste vengono instradate attraverso la gerarchia manager-account.
Recupera i metadati dell’account come ID account, nome account, valuta e fuso orario.

Google Ads (V2) esegue operazioni API di sola lettura. Non emette richieste di mutazione, creazione, aggiornamento o eliminazione per Google Ads risorse.

Selezione e acquisizione dei dati

Google Ads (V2) utilizza Google Ads Query Language (GAQL) per recuperare i metadati dell’account, i metadati della campagna e i dati di reporting.

Il connettore utilizza query specifiche per le risorse per recuperare gli attributi, i segmenti e le metriche necessari per ogni entità. Il connettore utilizza SearchStream per risorse di reporting e set di risultati di grandi dimensioni in cui è utile l’elaborazione incrementale delle righe.

L’inventario delle query supportato include risorse quali:

customer
customer_client
campaign
campaign_budget
campaign_criterion
geo_target_constant
ad_group
ad_group_criterion
ad_group_ad
ad_group_ad_asset_view
ad_group_ad_asset_combination_view
asset
asset_group
asset_group_asset
change_status

Le metriche delle prestazioni vengono recuperate utilizzando segmenti basati su date come segments.date.

Configurazione dello schema

Google Ads (V2) mappa i dati di origine su strutture XDM per supporti a pagamento standardizzate. Il connettore organizza i dati per livello di entità in modo che i metadati e le metriche delle prestazioni possano essere uniti tra record di account, campagne, gruppi di annunci, annunci, risorse ed esperienze.

Entità

Risorse Google Ads primarie

Dati rappresentati

Account

customer, customer_client

ID account, nome account, valuta, fuso orario, stato manager e metadati account.

Campaign

campaign, campaign_budget, campaign_criterion

Nome della campagna, stato, canale pubblicitario, sottotipo, obiettivo, budget, strategia di offerta, date, tracciamento URL e configurazione del targeting.

Gruppo di annunci

ad_group, ad_group_criterion

ID gruppo di annunci, nome, stato, offerte, targeting, parole chiave, posizionamenti e relazione con la campagna.

Annuncio

ad_group_ad

ID dell’annuncio, tipo di annuncio, contenuto creativo, URL di destinazione, stato della consegna, informazioni su criteri e revisioni e relazioni tra campagne e gruppi di annunci.

Risorsa

asset, ad_group_ad_asset_view, asset_group_asset

ID risorsa, tipo di risorsa, metadati di testo, immagini o video, dimensioni, utilizzo, etichetta delle prestazioni e annunci o campagne associati.

Esperienza

ad_group_ad_asset_combination_view, asset_group, asset_group_asset

Composizione creativa derivata, risorse gestite, titoli, descrizioni, chiamate all’azione, URL di pagine di destinazione e relazioni tra esperienze.

Metriche di riepilogo

metrics.* campi specifici della risorsa e segments.date

Impression a livello di data, clic, spesa, conversioni, valore di conversione, CTR, CPC, CPM, metriche video e altre misure delle prestazioni supportate.

Convenzioni relative agli identificatori

La mappatura V2 definisce identificatori qualificati per la piattaforma per le entità paid media. Ad esempio:

Il connettore deriva gli identificatori dell’account dall’ID cliente Google Ads.
Gli identificatori della campagna combinano l’ID cliente Google Ads e l’ID campagna.
Gli identificatori del gruppo di annunci e degli annunci includono la gerarchia principale.
Gli identificatori delle risorse combinano l’ID cliente Google Ads e l’ID risorsa.
Il connettore deriva gli identificatori di esperienza dal contesto di combinazione creativa o gruppo di risorse.
I percorsi gerarchici rappresentano la relazione tra le entità account, campagna, gruppo di annunci, annuncio, esperienza e risorsa.

Dati max prestazioni

Le campagne Performance Max non espongono sempre le stesse relazioni di entità dei tipi di campagna tradizionali.

Per dati con prestazioni massime:

asset_group rappresenta il raggruppamento primario di risorse.
asset_group_asset rappresenta le relazioni tra risorse e gruppi.
Le metriche per gruppi di risorse forniscono il contesto necessario per analizzare le prestazioni delle risorse.
I gruppi di risorse fungono da proxy dell’esperienza quando un’entità esperienza nativa non è disponibile.

Limitazioni dei dati e considerazioni

Quando pianifichi l’implementazione di Google Ads (V2), considera le seguenti limitazioni.

Supporto di metriche specifiche per le risorse

Google Ads non espone ogni metrica per ogni risorsa. Ad esempio, alcune risorse non supportano metriche o segmenti, mentre altre supportano solo un set limitato di metriche.

La disponibilità delle metriche varia anche tra le query di annunci, risorse, esperienza, campagna e Prestazioni massime.

Record esperienza derivati

Google Ads non fornisce una singola entità esperienza universale equivalente al modello di esperienza utilizzato dagli schemi XDM per contenuti multimediali a pagamento.

Il connettore deriva i record di esperienza dai dati disponibili relativi agli annunci, alla combinazione di risorse e al gruppo di risorse.

Metadati video

L’API Google Ads fornisce identificatori video e riferimenti alle risorse correlati. Tuttavia, alcune proprietà multimediali, quali durata video, codec, bitrate, frequenza fotogrammi e presenza audio, non sono direttamente disponibili tramite l’API Google Ads.

Questi campi sono nulli a meno che non venga aggiunto un servizio di arricchimento approvato.

Disponibilità delle risorse

I metadati delle risorse e il supporto delle prestazioni variano a seconda del tipo di risorsa. Ad esempio, i metadati di immagine e testo sono disponibili direttamente, mentre alcune proprietà video richiedono un ulteriore arricchimento.

Campi specifici di Google

Google Ads concetti senza un equivalente XDM per direct paid media sono rappresentati utilizzando additionalDetails o impostati su null, in base al mapping approvato.

Mappature enum

Il connettore mappa i valori enum dell’API Google Ads ai valori XDM utilizzando corrispondenze esatte, corrispondenze semantiche chiuse o valori di fallback approvati. I valori non supportati, sconosciuti, obsoleti o non specificati vengono ignorati o impostati su null.

Passaggi successivi

Dopo aver confermato le credenziali di Google Ads e il modello di accesso all’account, continuare creando una connessione a Google Ads utilizzando l’interfaccia utente di Experience Platform.

recommendation-more-help

experience-platform-help-sources