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.
Percorsi di configurazione: configurazione guidata dell'account e configurazione manuale
Per Ads Data Hub for Marketers, la configurazione iniziale prevede quattro fasi, con due percorsi per la configurazione delle risorse Google Cloud (la configurazione guidata obbligatoria o la configurazione manuale):
- Prima della creazione (passaggio 1 - Struttura dell'account): collabora con il tuo rappresentante di Google per determinare la struttura dell'account (per la maggior parte delle organizzazioni è consigliata una struttura a un livello) e firma il contratto.
- Configurazione guidata dell'account (obbligatoria, ti guida nel passaggio 2): per completare la creazione dell'account Ads Data Hub, è obbligatorio completare la configurazione guidata dell'account dall'email di benvenuto (la procedura guidata non può essere ignorata). Ti guida in sequenza nella scelta del nome del tuo account, nella designazione del progetto Google Cloud amministratore, nell'abilitazione delle API, nella scelta del set di dati BigQuery predefinito e, facoltativamente, nell'abilitazione della corrispondenza dei dati forniti dagli utenti (UPDM). (Nota: gli account secondari in una creazione dell'account a due livelli non possono essere creati con la procedura guidata.)
- Percorso di configurazione manuale di Google Cloud (riferimento al passaggio 2/configurazione manuale): se l'utente che esegue la procedura guidata non dispone delle autorizzazioni Google Cloud per configurare automaticamente il progetto o i set di dati BigQuery all'interno della procedura guidata, un amministratore Cloud può configurare manualmente il progetto Google Cloud, le API, i set di dati BigQuery e le autorizzazioni dell'account di servizio Ads Data Hub (P4SA) in anticipo utilizzando Configura i progetti Google Cloud, per poi selezionare le risorse preconfigurate nella procedura guidata. La configurazione manuale viene utilizzata anche per gli account secondari in una configurazione a due livelli o quando si aggiungono set di dati in un secondo momento.
- Configurazione post-procedura guidata (passaggi 3 e 4): dopo aver completato la procedura guidata e aver eseguito il provisioning dell'account, completa il provisioning dell'accesso utente e collega i dati al tuo account Ads Data Hub nell'interfaccia utente di 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. | ||
Crea il tuo account Ads Data Hub
Per ricevere assistenza per l'accesso ad Ads Data Hub, puoi contattare il tuo rappresentante di Google. Il rappresentante di Google verifica e conferma se soddisfi i criteri standard e poi avvia un contratto. Dopo la firma del contratto, riceverai una notifica via email per seguire la configurazione guidata dell'account e completare il processo di creazione dell'account.
Configurazione guidata dell'account
Per completare la creazione dell'account Ads Data Hub, è necessario completare la procedura di configurazione guidata dell'account dall'email di benvenuto (la procedura guidata non può essere ignorata). La procedura guidata ti guida attraverso le attività di configurazione iniziali.
Avvia la configurazione guidata dell'account
La configurazione guidata ti guida in sequenza attraverso i passaggi principali della configurazione:
- Assegnare un nome all'account Ads Data Hub
- Specifica del progetto Google Cloud amministratore
- Scegliere il set di dati BigQuery predefinito
- (Facoltativo) Attiva la corrispondenza dei dati forniti dagli utenti (UPDM)
In qualsiasi fase della procedura guidata, puoi aggiungere un utente che ti aiuti con la configurazione (in particolare se hai bisogno dell'assistenza di un collega con autorizzazioni Google Cloud IAM) o utilizzare l'icona Guida per accedere alle seguenti risorse:
- Panoramica della creazione dell'account
- Informazioni sul progetto Google Cloud
- Informazioni sul set di dati BigQuery
- Norme sulla privacy
- Contatta l'assistenza
Aggiungi un utente per ricevere assistenza per la configurazione
Se hai bisogno di assistenza da parte di un'altra persona della tua organizzazione per completare la configurazione, ad esempio un amministratore Google Cloud con autorizzazioni IAM per abilitare le API o configurare i set di dati BigQuery, puoi aggiungere utenti in qualsiasi fase della procedura guidata facendo clic sull'icona Aggiungi utente.
Quando aggiungi un utente, ti verrà chiesto di inserire il suo indirizzo email e una nota. Se fai clic su Salva, l'utente riceve un invito via email con la tua nota e un link per partecipare alla procedura di configurazione. L'utente viene aggiunto automaticamente come super utente nel tuo account Ads Data Hub.
Note:
- Deve essere una persona dell'organizzazione che, al termine della configurazione, può accedere al tuo account Ads Data Hub.
- Gli indirizzi email devono essere associati a un Account Google valido.
- Agli utenti aggiunti in questa fase viene concesso il ruolo di super user. Scopri di più sui ruoli utente.
- Gli utenti possono essere rimossi al completamento della procedura guidata.
Passaggio 1: assegna un nome all'account Ads Data Hub
Assegna un nome all'account Ads Data Hub. Tutti gli account avranno un ID unico di 9 cifre, ma questo nome può aiutarti a identificare l'account. Il nome deve essere unico e descrittivo per consentire ai nuovi utenti di identificare l'account.
Per assistenza con questa procedura o nel caso in cui si verifichi un errore, consulta la Panoramica della creazione dell'account o aggiungi un utente che ti aiuti.
Passaggio 2: specifica il progetto amministratore
A fini amministrativi, il tuo account Ads Data Hub è configurato con un singolo progetto Google Cloud designato come progetto amministratore. Questa relazione è rigorosamente 1:1: un singolo progetto Google Cloud non può essere il progetto amministratore per più account Ads Data Hub (o account secondari) e la designazione non può essere modificata una volta inviata.
Se l'amministratore di Google Cloud ha già abilitato manualmente le API richieste e configurato le autorizzazioni in precedenza in base a Configura i progetti Google Cloud, puoi selezionare il progetto preconfigurato durante questo passaggio.
Note:
- Contatta il tuo rappresentante di Google se hai bisogno di assistenza per configurare il tuo progetto cloud Google Cloud.
- Non potrai specificare un progetto amministratore diverso o aggiornare la regione Cloud dopo aver effettuato questa selezione iniziale. Per questo motivo, è importante indicare un progetto Google Cloud permanente come progetto amministratore. Ulteriori informazioni.
- I set di dati BigQuery di input e di output devono trovarsi nella località BigQuery (
US,EU,asia-northeast1oaustralia-southeast1) corrispondente alla regione del tuo account Ads Data Hub. La posizione geografica della pubblicazione di annunci e del targeting per pubblico è separata dalla posizione del set di dati BigQuery. Scopri di più. - Scegli un progetto disponibile. Questo progetto deve essere permanente perché non può essere modificato dopo il completamento di questo passaggio. Tieni presente che devi disporre dell'autorizzazione Editor per il progetto Google Cloud selezionato.
- L'abilitazione dell'API e le autorizzazioni del service account Ads Data Hub (P4SA) concesse durante questo passaggio vengono applicate direttamente al progetto Google Cloud selezionato.
- Se fai clic su Avanti, accetti di attivare l'API Ads Data Hub. Una volta completato questo passaggio, non sarà più possibile modificare le impostazioni.
Per assistenza con questo passaggio o nel caso in cui si verifichi un errore, aggiungi un utente che ti aiuti o consulta i seguenti articoli:
- Panoramica della creazione dell'account
- Panoramica del progetto amministratore
- Regione cloud BigQuery
- Abilitare l'API sul progetto amministratore
Passaggio 3: scegli un set di dati BigQuery predefinito
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. In questo passaggio devi:
Specificare il set di dati di output: devi disporre di autorizzazioni di modifica sufficienti per selezionare correttamente un set di dati di output o puoi aggiungere un utente che sia un utente amministratore BigQuery che ti aiuti.
(Facoltativo) Specifica il set di dati di assistenza: per consentire la risoluzione avanzata dei problemi da parte del team di assistenza Ads Data Hub, puoi impostare un set di dati di assistenza. Scopri di più.
Note:
- Per consentire al team di assistenza Ads Data Hub di risolvere i problemi della tua query, devi scriverne l'output in un nuovo set di dati per la risoluzione dei problemi e concedere al team di assistenza l'accesso come Visualizzatore dati BigQuery (roles/bigquery.dataViewer) al set di dati. In questo modo, il team può visualizzare l'output della query senza concedere l'accesso ad altri dati nel tuo progetto Google Cloud. Puoi revocare l'accesso in qualsiasi momento. Scopri di più.
- La creazione del set di dati e le autorizzazioni a livello di set di dati concesse durante questo passaggio vengono applicate direttamente al tuo progetto BigQuery.
Per assistenza con questo passaggio o nel caso in cui si verifichi un errore, aggiungi un utente che ti aiuti o consulta i seguenti articoli:
- Panoramica del set di dati BigQuery
- Autorizzazioni BigQuery
- Cambiare l'accesso a BigQuery per visualizzare le modifiche
(Facoltativo) Passaggio 4: attiva la corrispondenza dei dati forniti dagli utenti
Affinché la corrispondenza dei dati forniti dagli utenti (UPDM) legga e colleghi i dati proprietari e scriva i risultati del tuo progetto Google Cloud, dovrai fornire all'account di servizio Ads Data Hub (P4SA) l'accesso al progetto Google Cloud. Per assistenza con questo passaggio o nel caso in cui si verifichi un errore, consulta i seguenti articoli:
Dopo aver completato la procedura guidata
Una volta completata la procedura guidata, riceverai un messaggio in cui ti verrà comunicato il completamento della configurazione. Aspetta da uno a tre giorni per il completamento della configurazione. Poi riceverai un messaggio di follow-up in cui ti verrà comunicato quando il tuo account sarà disponibile. Se la configurazione è in attesa di completamento da più di cinque giorni lavorativi o se ricevi un messaggio in cui ti viene indicata la presenza di problemi relativi alla configurazione dell'account, puoi contattare l'assistenza. Una volta che il tuo account è disponibile, procedi con il provisioning dell'accesso utente e il collegamento dei dati al tuo account Ads Data Hub.
Configura i progetti Google Cloud (configurazione manuale)
Nota: se hai già completato la procedura guidata di configurazione dell'account, la procedura guidata ha designato automaticamente il progetto amministratore, abilitato le API richieste e configurato il set di dati BigQuery predefinito e le autorizzazioni dell'account di servizio. Devi seguire i passaggi manuali descritti nelle sezioni seguenti solo se l'amministratore di Google Cloud preconfigura le risorse prima di eseguire la procedura guidata, se crei account secondari in una configurazione a due livelli o se devi aggiungere altri set di dati o modificare le autorizzazioni in un secondo momento.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
Nota: completa questo passaggio dopo aver completato la procedura guidata di creazione dell'account e aver ricevuto la conferma che il tuo account Ads Data Hub è disponibile.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
Nota: completa questo passaggio dopo che il tuo account Ads Data Hub è stato eseguito il provisioning e reso disponibile dopo il completamento della configurazione guidata dell'account.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.