DocumentazioneExperience PlatformGuida ai connettori di origini

[beta]{class="badge informative"}

Google Ads

Ultimo aggiornamento: 29 luglio 2026

Creato per:

  • {"id":"ff6a42d2-313e-452e-93a6-792e4fad9ff8"}

Google Ads è la piattaforma di pubblicità online di Google che consente di raggiungere i potenziali clienti attraverso Search, YouTube, Maps e siti Web dei partner. Puoi indirizzare il pubblico giusto, controllare il budget e tenere traccia dei risultati per aumentare la consapevolezza, i lead e le vendite.

Utilizza l’origine Google Ads per eseguire l’autenticazione in base all’API Google Ads, connettere account inserzionisti o gerarchie account manager e acquisire i dati di reporting in Experience Platform per i flussi di lavoro di attivazione e analisi a valle.

IMPORTANT
L'origine Google Ads nell'interfaccia utente di Experience Platform è attualmente in versione beta e supporta solo l'acquisizione una tantum. Per l’acquisizione incrementale, utilizza la connessione basata su API e il flusso di dati.

Prerequisiti

Prima di connettere l’account Google Ads ad Experience Platform, verificare che siano soddisfatti i seguenti requisiti.

Indirizzo IP inserito nell’elenco Consentiti

Prima di collegare le origini a Experience Platform, è necessario aggiungere al inserisco nell’elenco Consentiti di indirizzi IP specifici per l’area geografica. Per ulteriori informazioni, leggere la guida in inserire nell’elenco Consentiti gli indirizzi IP per la connessione ad Experience Platform.

Configurare le autorizzazioni su Experience Platform

Per connettere l’account Google Ads ad Experience Platform, è necessario che per l’account siano abilitate le autorizzazioni Visualizza origini e Gestisci origini. Contatta l’amministratore del prodotto per ottenere le autorizzazioni necessarie. Per ulteriori informazioni, leggere la guida all’interfaccia utente per il controllo degli accessi.

È necessario disporre di credenziali API Google Ads valide e accedere all’account Google Ads da cui si desidera leggere. Se l’account dell’inserzionista di destinazione è gestito tramite un account di gestione Google Ads (MCC), la connessione deve includere anche l’ID cliente di accesso corretto in modo che le richieste possano essere instradate attraverso la gerarchia di gestione corretta.

In pratica:

  • Se l’account dell’inserzionista di destinazione è accessibile direttamente dall’utente autorizzato OAuth, loginCustomerId potrebbe non essere richiesto.
  • Se l’account dell’inserzionista è accessibile solo tramite una gerarchia MCC, loginCustomerId deve identificare l’account manager utilizzato per accedere all’account figlio.
  • Un loginCustomerId errato o mancante può causare errori di autorizzazione durante il tentativo di eseguire query su account figlio gestiti.

Raccogli le credenziali richieste

Per connettere Google Ads ad Experience Platform, è necessario fornire i valori per le seguenti proprietà di connessione.

Credenziali
Descrizione
clientCustomerId
Numero di account dell’account client Google Ads che si desidera gestire con l’API Google Ads. Questo ID segue in genere il formato 123-456-7890.
loginCustomerId
Numero di account del manager Google Ads utilizzato per recuperare i dati del report per un cliente operativo specifico. Questa opzione è necessaria quando l’accesso all’account di destinazione viene mediato tramite una gerarchia MCC.
developerToken
Token sviluppatore utilizzato per accedere all’API Google Ads. È possibile utilizzare un singolo token sviluppatore tra gli account Google Ads a cui l’applicazione è autorizzata ad accedere.
refreshToken
Il token di aggiornamento OAuth 2.0 utilizzato per ottenere nuovi token di accesso dopo la scadenza.
clientId
L’ID client OAuth 2.0 associato all’applicazione Google.
clientSecret
Il segreto client OAuth 2.0 associato all’applicazione Google.
googleAdsApiVersion
Versione API Google Ads utilizzata dal connettore. Experience Platform supporta attualmente la versione v19 e successive.
connectionSpec.id
L’ID della specifica di connessione Google Ads richiesto per le richieste API del servizio Flusso: d771e9c1-4f26-40dc-8617-ce58c4b53702.

Informazioni su loginCustomerId

Il valore loginCustomerId è uno dei campi di configurazione più importanti nell’origine Google Ads.

Utilizza loginCustomerId quando:

  • L’utente autorizzato OAuth ha accesso tramite un account manager,
  • L’account dell’inserzionista di destinazione è un account secondario in un MCC,
  • L’account non viene restituito direttamente come account accessibile di livello superiore.

Non impostare loginCustomerId in modo non necessario per gli account pubblicitari direttamente accessibili. Quando possibile, verifica prima se l’account è direttamente accessibile e fornisci un ID manager solo quando l’accesso dipende veramente da tale gerarchia.

Autenticazione e comportamento di connessione

L’origine Google Ads utilizza OAuth 2.0 per autenticare le richieste all’API Google Ads. Experience Platform archivia i dettagli della connessione in una connessione di base e utilizza le credenziali fornite per autorizzare Google Ads chiamate API per conto del cliente.

Per gli scenari di account manager, il connettore potrebbe dover risolvere la gerarchia di manager appropriata per accedere correttamente all’account dell’inserzionista di destinazione. Internamente, ciò comporta in genere:

  1. Enumerazione di account accessibili,
  2. Determinare se un account è un account manager,
  3. identificazione dei conti foglia non del gestore,
  4. Risoluzione del loginCustomerId corretto quando l’account di destinazione è raggiungibile solo tramite una gerarchia MCC.

Questo comportamento è particolarmente importante per i clienti che gestiscono più account inserzionisti da una singola struttura di account manager.

Selezione dei dati e comportamento nel reporting

La selezione dei dati di Google Ads si basa su Google AdsGAQL (Query Language). Durante la configurazione, puoi specificare gli attributi, i segmenti e le metriche da recuperare per l’acquisizione.

Per gli estrazioni di report di grandi dimensioni, Google Ads supporta sia i pattern di ricerca standard che quelli di recupero in streaming. Internamente, il recupero in streaming è preferito per set di risultati più grandi perché consente di utilizzare le righe del rapporto in modo incrementale anziché nel buffer pagina per pagina.

Durante la configurazione della selezione dei dati nell’interfaccia utente di Experience Platform, utilizza il Generatore di query Google Ads per scegliere il tipo di risorsa e i campi da acquisire, convalidare la query e quindi copiare gli attributi richiesti nel flusso di lavoro di origine.

Percorsi di connessione supportati

È possibile connettere Google Ads ad Experience Platform utilizzando le API o l’interfaccia utente.

Utilizzo delle API

Utilizza l’API Flow Service API quando hai bisogno di configurazione programmatica, configurazione ripetibile o supporto per l’acquisizione incrementale. Ad alto livello, il flusso di lavoro API include:

  1. Creazione di una connessione di base
  2. Esplorazione della configurazione di origine,
  3. Creazione della connessione di origine e di destinazione
  4. Creazione di un flusso di dati per l’acquisizione

Utilizzo dell’interfaccia utente

Utilizza l’area di lavoro origini di Experience Platform per la configurazione guidata quando desideri connettere Google Ads tramite l’interfaccia utente. Il flusso dell’interfaccia utente supporta la creazione di credenziali, la selezione degli attributi, l’anteprima e il flusso di dati. Al momento, il percorso dell’interfaccia utente rimane beta e supporta solo l’acquisizione una tantum.

Limitazioni note e note

  • L’origine Google Ads nell’interfaccia utente è attualmente beta.
  • L’interfaccia attualmente supporta solo l’acquisizione una tantum.
  • Utilizza il percorso basato su API per l’acquisizione incrementale.
  • Experience Platform supporta attualmente l’API Google Ads versione v19 e successive.
  • Le gerarchie Manager-account richiedono un’attenta gestione di loginCustomerId. Valori non corretti possono impedire l’accesso agli account degli inserzionisti figlio.

Passaggi successivi

Dopo aver raccolto le credenziali e confermato il modello di accesso all’account, continua con uno dei seguenti percorsi di configurazione:

recommendation-more-help
experience-platform-help-sources