Panoramica della configurazione dell'account Ads Data Hub
Questa panoramica fornisce un riepilogo generale dei passaggi necessari per configurare un account Ads Data Hub:
- Determina la struttura del tuo account: scegli tra un account a un livello (consigliato per la maggior parte delle organizzazioni) o un account a due livelli per strutture complesse con più inserzionisti.
- Configura i tuoi progetti Google Cloud:
designa un progetto Google Cloud come progetto amministratore, abilita l'API Ads Data Hub (
adsdatahub.googleapis.com) e l'API BigQuery (bigquery.googleapis.com), crea un set di dati BigQuery e concedi all'account di servizio Ads Data Hub (un agente di servizio per prodotto e per progetto Google Cloud o P4SA) l'autorizzazione di lettura e scrittura per i tuoi set di dati. - Esegui il provisioning dell'accesso utente: assegna ruoli di accesso utente agli utenti nel tuo account Ads Data Hub e configura le autorizzazioni IAM di BigQuery.
- Collega i dati al tuo account Ads Data Hub: collega i tuoi account della piattaforma pubblicitaria di Google collegando gli account in Ads Data Hub.
Strutturare l'account Ads Data Hub
Esamina i due tipi di strutture di account nelle sezioni seguenti. Una volta stabilita la struttura necessaria per le esigenze della tua organizzazione, comunicala al tuo rappresentante di Google. Contatta il tuo rappresentante anche nel caso in cui nessuna delle due strutture soddisfi le esigenze dell'organizzazione.
Account a un livello
Un account a un livello è un account Ads Data Hub senza account secondari. È la struttura consigliata e più comune per la maggior parte dei clienti. In questo tipo di struttura di account, i dati pubblicitari sono collegati direttamente al tuo account Ads Data Hub e sono accessibili esclusivamente in base ai ruoli di accesso dell'utente.
Account a due livelli
Se vuoi che il tuo account Ads Data Hub rispecchi una struttura organizzativa complessa, puoi richiedere un account a due livelli. In questo tipo di struttura, l'account Ads Data Hub (definito account principale) contiene più account secondari. I dati pubblicitari sono collegati agli account secondari e l'accesso utente può essere limitato assegnando gli utenti agli account secondari specifici. La relazione tra account principale e account secondari è immutabile, ovvero gli account secondari non possono essere trasferiti a un altro account principale. Ogni account Ads Data Hub (e ogni account secondario) richiede un progetto Google Cloud distinto designato come unico progetto amministratore per l'account Ads Data Hub. Questa relazione deve essere 1:1: un singolo progetto Google Cloud non può fungere da progetto amministratore per più account Ads Data Hub.
I set di dati BigQuery devono trovarsi nella stessa regione del tuo account Ads Data Hub (US, EU, asia-northeast1 o australia-southeast1). Tutti gli account secondari ereditano la regione dall'account principale Ads Data Hub.
Questo grafico mette a confronto i due tipi di struttura di account:
| A un livello | A due livelli | |
|---|---|---|
| Casi d'uso tipici | Inserzionisti | Agenzie Inserzionisti con una struttura organizzativa complessa |
| Diagramma di esempio |
 |
 |
| Collegamento dati | ||
| Presuppone che il proprietario dell'account Ads Data Hub sia anche il proprietario dell'account della piattaforma pubblicitaria. | ||
| Gli account della piattaforma pubblicitaria di Google sono collegati direttamente al tuo account Ads Data Hub. | ||
| Gli account secondari, che rappresentano determinati inserzionisti, vengono creati al di sotto dell'account Ads Data Hub. | ||
| Gli account della piattaforma pubblicitaria di Google vengono associati ai tuoi account secondari Ads Data Hub utilizzando i dati pubblicitari provenienti da ID. È possibile associare un ID piattaforma pubblicitaria a ciascun dato pubblicitario dall'ID. | ||
| Gestione utenti | ||
| Gestione utenti semplice. Il provisioning degli utenti viene eseguito direttamente nel tuo account Ads Data Hub. Gli utenti con accesso a questo account potrebbero accedere a tutti i dati pubblicitari collegati dell'account. |
||
| Gestione utenti granulare. Gli utenti di cui è stato eseguito il provisioning direttamente nel tuo account Ads Data Hub potrebbero accedere a tutti i dati pubblicitari collegati a tutti gli account secondari. Gli utenti di cui è stato eseguito il provisioning in un determinato account secondario potrebbero accedere a tutti i dati pubblicitari collegati a quell'account secondario. Non possono accedere ai dati di altri account secondari. |
||
| Requisiti per Cloud | ||
| Richiede un progetto Google Cloud amministrativo per il tuo account Ads Data Hub (relazione 1:1). | ||
| Richiede un progetto Google Cloud amministrativo per il tuo account Ads Data Hub, più un progetto Google Cloud distinto per ogni account secondario (ciascuno in una relazione 1:1). | ||
| I dati possono essere importati da più regioni Cloud nello stesso account Ads Data Hub. | ||
| Unione dei dati | ||
| I dati di account di piattaforme pubblicitarie diverse collegati allo stesso account (o allo stesso account secondario) possono essere uniti nella stessa query. I dati di account secondari diversi non possono essere uniti nella stessa query. | ||
Configura i progetti Google Cloud (configurazione manuale)
Il tuo progetto Google Cloud contiene i risultati di Ads Data Hub ed eventuali dati proprietari che utilizzi per scrivere i join proprietari. Inoltre, i progetti Google Cloud sono la base sottostante su cui si basano la fatturazione e l'utilizzo dei servizi Google Cloud.
Scopri di più su come funziona Ads Data Hub con BigQuery
Scopri come creare un progetto Google Cloud
Specificare un progetto amministratore
A fini amministrativi, il tuo account Ads Data Hub viene inizialmente creato con un progetto Google Cloud designato, noto come progetto amministratore. Una volta impostata, questa designazione del progetto amministratore non può essere modificata. Questa relazione è rigorosamente 1:1: un singolo progetto Google Cloud non può essere designato come progetto amministratore per più account Ads Data Hub (o account secondari).
Oltre al progetto amministratore designato, il tuo account Ads Data Hub può leggere i dati di input e scrivere i risultati di output nei set di dati BigQuery in un numero qualsiasi di progetti Google Cloud. L'accesso a questi set di dati è controllato concedendo all'account di servizio Ads Data Hub (un agente di servizio per prodotto e per progetto Google Cloud o P4SA) le autorizzazioni BigQuery appropriate per i set di dati o i progetti Google Cloud necessari, che possono essere aggiornati in qualsiasi momento.
Non potrai designare un progetto amministratore diverso dopo aver effettuato la selezione iniziale. Se cambi il progetto amministratore, puoi interrompere il tuo account Ads Data Hub. Di conseguenza, è fondamentale designare un progetto Google Cloud permanente come progetto amministratore durante la configurazione dell'account. La disattivazione dell'API Ads Data Hub dal progetto amministratore o l'eliminazione del progetto amministratore può causare la perdita di dati e creare problemi di accesso al tuo account Ads Data Hub. Inoltre, prevedi eventuali modifiche imminenti alla tua organizzazione, ad esempio le convenzioni di denominazione, che potrebbero richiedere la modifica del tuo progetto amministratore.
Se il progetto amministratore viene eliminato accidentalmente o se hai bisogno di aiuto per ripristinare l'accesso al tuo account, contatta l'assistenza Ads Data Hub.
Esempi di configurazioni di progetti Google Cloud
La maggior parte degli utenti può utilizzare un solo progetto (la configurazione predefinita) che gestisce tutte le funzionalità. Sono inclusi i dati di input e di output. Questa è la configurazione consigliata, dato che l'introduzione di più progetti crea complessità e costi aggiuntivi. Tuttavia, se la configurazione del singolo progetto non soddisfa le tue esigenze, collabora con il tuo rappresentante di Google per determinare la struttura più adatta.
La configurazione predefinita, un singolo progetto utilizzato per tutte le funzionalità:
Progetto di input separato, progetto amministratore per l'amministrazione e l'output:
Abilitare l'API sul progetto amministratore
Prima di creare un account Ads Data Hub, devi attivare l'API Ads Data Hub (nome del servizio: adsdatahub.googleapis.com, "API per l'esecuzione di query Ads Data Hub") e l'API BigQuery (nome del servizio: bigquery.googleapis.com, "Una piattaforma di dati per consentire ai clienti di creare, gestire, condividere ed eseguire query sui dati") nel tuo progetto amministratore.
L'utente che abilita le API deve avere l'autorizzazione serviceusage.services.enable
all'interno del progetto amministratore. Potrebbe essere una persona esterna alla tua organizzazione.
Scopri come attivare l'API Ads Data Hub
Creare un set di dati BigQuery
I set di dati BigQuery sono i punti in cui vengono scritti i risultati di Ads Data Hub e uno dei punti in cui è possibile analizzare ulteriormente i dati.
Durante la creazione dell'account, nelle impostazioni dell'account Ads Data Hub viene inserito un set di dati predefinito. È qui che vengono scritti i risultati se non specifichi un set di dati durante l'esecuzione della query.
L'ID del set di dati è composto dal nome del progetto di output predefinito e dal nome del set di dati, ad esempio: projectName.datasetName.
Scopri come creare set di dati in BigQuery
Sia i set di dati BigQuery di input che quelli di output devono trovarsi nella località corrispondente alla regione del tuo account Ads Data Hub:
- Account degli Stati Uniti: specifica la località multiregionale
US. - Account UE: specifica la località multiregionale
EU. - Account Asia Pacifico: specifica
asia-northeast1(Tokyo) oaustralia-southeast1(Sydney), in base al tuo account.
I job non vanno a buon fine se la località di un set di dati non corrisponde alla regione del tuo account (ad esempio, se specifichi us-east1 per un account nella località multiregionale degli Stati Uniti o se specifichi US per un account in asia-northeast1).
La posizione geografica della pubblicazione di annunci e del targeting per pubblico è completamente separata dalla posizione dei dati di BigQuery utilizzata durante l'esecuzione delle query di Ads Data Hub. Indipendentemente da dove vengono pubblicati i tuoi annunci o da dove risiedono i segmenti di pubblico di destinazione a livello globale, i set di dati BigQuery di input e output devono comunque risiedere nella località corrispondente alla regione del tuo account Ads Data Hub.
Autorizzare l'account di servizio Ads Data Hub
Per consentire ad Ads Data Hub di leggere i dati e scrivere i risultati, devi concedere all'account di servizio Ads Data Hub (P4SA) l'accesso ai set di dati BigQuery pertinenti:
- Set di dati di output: concedi il ruolo Editor dati BigQuery (
roles/bigquery.dataEditor) per consentire ad Ads Data Hub di scrivere i risultati delle query nel set di dati. - Set di dati di input (dati proprietari): concedi il ruolo Visualizzatore dati BigQuery (
roles/bigquery.dataViewer) per consentire ad Ads Data Hub di leggere i tuoi dati proprietari per i join.
Le autorizzazioni possono essere concesse a livello di set di dati o di progetto:
- Livello di set di dati (consigliato): nella console BigQuery, seleziona il set di dati, fai clic su Condividi > Gestisci autorizzazioni e aggiungi l'entità del service account.
- A livello di progetto: aggiungi l'entità di servizio nella pagina Identity and Access Management (IAM) nella console Google Cloud.
Puoi trovare l'indirizzo email (entità) dell'account di servizio Ads Data Hub (P4SA) in Impostazioni > Dettagli > Account di servizio nel tuo account Ads Data Hub.
Eseguire il provisioning dell'accesso utente
Gli utenti dovranno accedere sia ad Ads Data Hub sia a BigQuery. All'interno di Ads Data Hub scriveranno ed eseguiranno query, mentre all'interno di BigQuery lavoreranno con i risultati ottenuti da Ads Data Hub.
Gli utenti vengono aggiunti al tuo account Ads Data Hub in Impostazioni >
Utenti e viene assegnato loro
l'accesso basato sui ruoli
(ad esempio Super utente, Analista o Sola lettura) per scrivere ed eseguire query.
In Google Cloud, i ruoli IAM di BigQuery (come roles/bigquery.dataViewer e roles/bigquery.user) controllano chi può visualizzare ed eseguire query sulle tabelle di output risultanti in BigQuery.
Scopri di più sull'accesso basato sui ruoli in Ads Data Hub Scopri di più sul controllo dell'accesso in BigQuery
Collegare i dati all'account Ads Data Hub
Per poter disporre di dati pubblicitari per le query in Ads Data Hub, devi eseguire il collegamento dall'account associato al prodotto pubblicitario di Google utilizzato dal tuo team.
Il collegamento dell'account è una procedura in due passaggi:
- Avvia la richiesta di collegamento: una richiesta di collegamento viene avviata dalla piattaforma pubblicitaria Google utilizzata dal tuo team (ad esempio Google Ads, Display & Video 360, Campaign Manager 360 o YouTube Reserve).
- Approva la richiesta di collegamento: la richiesta di collegamento viene approvata nel tuo account Ads Data Hub, nell'interfaccia utente di Ads Data Hub in Impostazioni > Account collegati o in modo programmatico utilizzando l'API
CustomerService.BatchApproveAdsDataLinks.