Carica i dati di Campaign Manager in BigQuery
Puoi caricare i dati da Campaign Manager a BigQuery utilizzando il connettore BigQuery Data Transfer Service per Campaign Manager. Con BigQuery Data Transfer Service, puoi pianificare job di trasferimento ricorrenti che aggiungono i dati più recenti di Campaign Manager a BigQuery.
Panoramica del connettore
BigQuery Data Transfer Service per il connettore Campaign Manager supporta le seguenti opzioni per il trasferimento di dati.
Per informazioni su come i report di Campaign Manager vengono trasformati in tabelle e viste BigQuery, consulta Trasformazioni dei report di Campaign Manager.
| Opzioni di trasferimento dei dati | Assistenza |
|---|---|
| Report supportati | Il connettore Campaign Manager supporta il trasferimento dei dati dai seguenti report: |
| Frequenza di ripetizione | Il connettore Campaign Manager supporta il trasferimento di dati ogni 8 ore. Per impostazione predefinita, i trasferimenti di dati di Campaign Manager vengono pianificati al momento della creazione del trasferimento di dati. |
| Finestra di aggiornamento | Il connettore Campaign Manager recupera i dati di Campaign Manager fino a 2 giorni prima dell'esecuzione del trasferimento di dati. Non puoi configurare la finestra di aggiornamento per questo connettore.
Per maggiori informazioni, vedi Finestre di aggiornamento. |
| Disponibilità dei dati di backfill | Esegui un backfill dei dati per recuperare i dati al di fuori del trasferimento di dati pianificato. Puoi recuperare i dati fino al periodo consentito dalla policy sulla conservazione dei dati dell'origine dati. Per informazioni sulla policy sulla conservazione dei dati per Display & Video 360, consulta Controlli per l'eliminazione e la conservazione dei dati. |
Acquisizione dei dati dai trasferimenti di Campaign Manager
Quando trasferisci i dati da Campaign Manager a BigQuery, i dati vengono caricati in tabelle BigQuery partizionate per data. La partizione della tabella in cui vengono caricati i dati corrisponde alla data dell'origine dati. Se pianifichi più trasferimenti per la stessa data, BigQuery Data Transfer Service sovrascrive la partizione per quella data specifica con i dati più recenti. Più trasferimenti nello stesso giorno o l'esecuzione di backfill non comportano la duplicazione dei dati e le partizioni per altre date non sono interessate.Finestre di aggiornamento
Una finestra di aggiornamento è il numero di giorni per cui un trasferimento di dati recupera i dati quando si verifica un trasferimento di dati. Ad esempio, se la finestra di aggiornamento è di tre giorni e viene eseguito un trasferimento giornaliero, BigQuery Data Transfer Service recupera tutti i dati della tabella di origine degli ultimi tre giorni. In questo esempio, quando si verifica un trasferimento giornaliero, BigQuery Data Transfer Service crea una nuova partizione della tabella di destinazione BigQuery con una copia dei dati della tabella di origine del giorno corrente, quindi attiva automaticamente le esecuzioni di backfill per aggiornare le partizioni della tabella di destinazione BigQuery con i dati della tabella di origine dei due giorni precedenti. Le esecuzioni di backfill attivate automaticamente sovrascrivono o aggiornano in modo incrementale la tabella di destinazione BigQuery, a seconda che gli aggiornamenti incrementali siano supportati o meno nel connettore BigQuery Data Transfer Service.
Quando esegui un trasferimento di dati per la prima volta, il trasferimento recupera tutti i dati di origine disponibili nella finestra di aggiornamento. Ad esempio, se la finestra di aggiornamento è di tre giorni ed esegui il trasferimento dei dati per la prima volta, BigQuery Data Transfer Service recupera tutti i dati di origine entro tre giorni.
Per recuperare dati al di fuori della finestra di aggiornamento, ad esempio dati storici, o per recuperare dati da eventuali interruzioni o lacune del trasferimento, puoi avviare o pianificare un'esecuzione di backfill.
Prima di iniziare
Prima di creare un trasferimento di dati di Campaign Manager:
- Verifica di aver completato tutte le azioni richieste per abilitare BigQuery Data Transfer Service.
- Crea un set di dati BigQuery per archiviare i dati di Campaign Manager.
Assicurati che la tua organizzazione abbia accesso ai file di Data Transfer v2 di Campaign Manager (DTv2 di Campaign Manager). Questi file vengono inviati dal team di Campaign Manager a un bucket Cloud Storage. Per ottenere l'accesso ai file DTv2 di Campaign Manager, il passaggio successivo dipende dal fatto che tu abbia o meno un contratto diretto con Campaign Manager. In entrambi i casi, potrebbero essere applicati costi aggiuntivi.
- Se hai un contratto con Campaign Manager, contatta l'assistenza di Campaign Manager per configurare i file DTv2 di Campaign Manager.
- Se non hai un contratto con Campaign Manager, la tua agenzia o il tuo rivenditore Campaign Manager potrebbe avere accesso ai file DTv2 di Campaign Manager. Contatta la tua agenzia o il tuo rivenditore per accedere a questi file.
Dopo aver completato questo passaggio, riceverai un nome di bucket Cloud Storage simile al seguente:
dcdt_-dcm_account123456Se intendi configurare le notifici di esecuzione del trasferimento per Pub/Sub, devi disporre delle autorizzazioni
pubsub.topics.setIamPolicy. Per saperne di più, consulta Notifiche di esecuzione di BigQuery Data Transfer Service.
Autorizzazioni obbligatorie
Assicurati di aver concesso le seguenti autorizzazioni.
Ruoli BigQuery richiesti
Per ottenere le autorizzazioni necessarie per creare un trasferimento di dati di BigQuery Data Transfer Service, chiedi all'amministratore di concederti il ruolo IAM Amministratore BigQuery (roles/bigquery.admin) sul tuo progetto.
Per saperne di più sulla concessione dei ruoli, consulta Gestisci l'accesso a progetti, cartelle e organizzazioni.
Questo ruolo predefinito contiene le autorizzazioni necessarie per creare un trasferimento di dati di BigQuery Data Transfer Service. Per vedere quali sono esattamente le autorizzazioni richieste, espandi la sezione Autorizzazioni obbligatorie:
Autorizzazioni obbligatorie
Per creare un trasferimento di dati di BigQuery Data Transfer Service, sono necessarie le seguenti autorizzazioni:
-
Autorizzazioni di BigQuery Data Transfer Service:
-
bigquery.transfers.update -
bigquery.transfers.get
-
-
Autorizzazioni BigQuery:
-
bigquery.datasets.get -
bigquery.datasets.getIamPolicy -
bigquery.datasets.update -
bigquery.datasets.setIamPolicy -
bigquery.jobs.create
-
Potresti anche ottenere queste autorizzazioni con ruoli personalizzati o altri ruoli predefiniti.
Per saperne di più, consulta Concedi l'accesso a bigquery.admin.
Ruoli Campaign Manager richiesti
Concedi l'accesso in lettura ai file DTv2 di Campaign Manager archiviati in Cloud Storage. L'accesso è gestito dall'entità da cui hai ricevuto il bucket Cloud Storage.
Configurare un trasferimento Campaign Manager
Per configurare un trasferimento di dati di Campaign Manager, sono necessari:
Bucket Cloud Storage: l'URI del bucket Cloud Storage per i file DTv2 di Campaign Manager, come descritto in Prima di iniziare. Il nome del bucket dovrebbe essere simile al seguente:
dcdt_-dcm_account123456ID Campaign Manager: l'ID rete, inserzionista o Floodlight di Campaign Manager. L'ID rete è l'elemento principale della gerarchia.
Trova l'ID Campaign Manager
Per recuperare l'ID Campaign Manager, puoi utilizzare la console Cloud Storage per esaminare i file nel bucket Cloud Storage di Data Transfer di Campaign Manager. L'ID Campaign Manager viene utilizzato per trovare i file corrispondenti nel bucket Cloud Storage fornito. L'ID è incorporato nel nome file, non nel nome del bucket Cloud Storage.
Ad esempio:
- In un file denominato
dcm_account123456_activity_*, l'ID è 123456. - In un file denominato
dcm_floodlight7890_activity_*, l'ID è 7890. - In un file denominato
dcm_advertiser567_activity_*, l'ID è 567.
Trovare il prefisso del nome file
In rari casi, i file nel bucket Cloud Storage potrebbero avere nomi personalizzati non standard, configurati per te dal team dei servizi di Google Marketing Platform.
Ad esempio:
- In un file denominato
dcm_account123456custom_activity_*, il prefisso è dcm_account123456custom, ovvero tutto ciò che precede_activity.
Se hai bisogno di aiuto, contatta l'assistenza di Campaign Manager.
Crea un trasferimento di dati per Campaign Manager
Console
Vai alla pagina Trasferimenti di dati nella console Google Cloud .
Fai clic su Crea trasferimento.
Nella pagina Crea trasferimento:
Nella sezione Tipo di origine, per Origine, scegli Campaign Manager.
Nella sezione Nome configurazione di trasferimento, per Nome visualizzato, inserisci un nome per il trasferimento di dati, ad esempio
My Transfer. Il nome del trasferimento può essere qualsiasi valore che ti consenta di identificare il trasferimento se devi modificarlo in un secondo momento.
Nella sezione Opzioni di pianificazione, per Pianifica, lascia il valore predefinito (Inizia ora) o fai clic su Inizia a un'ora specifica.
- Per Si ripete, scegli un'opzione per la frequenza con cui eseguire il trasferimento. Se scegli un'opzione diversa da Giornaliera, sono disponibili altre opzioni. Ad esempio, se scegli Settimanale, viene visualizzata un'opzione per selezionare il giorno della settimana.
- Per Data di inizio e ora di esecuzione, inserisci la data e l'ora di inizio del trasferimento di dati. Se scegli Inizia ora, questa opzione è disabilitata.
Nella sezione Impostazioni destinazione, in Set di dati di destinazione, scegli il set di dati che hai creato per archiviare i dati.
Nella sezione Dettagli origine dati:
- Per Bucket Cloud Storage, inserisci o cerca il nome del bucket Cloud Storage in cui sono archiviati i file di Data Transfer V2.0. Quando inserisci il nome del bucket, non includere
gs://. - In ID DoubleClick, inserisci l'ID Campaign Manager appropriato.
- (Facoltativo) Se i file hanno nomi standard come questi esempi, lascia vuoto il campo Prefisso del nome del file. Specifica un prefisso del nome file se i file nel bucket Cloud Storage hanno nomi personalizzati.
- Per Bucket Cloud Storage, inserisci o cerca il nome del bucket Cloud Storage in cui sono archiviati i file di Data Transfer V2.0. Quando inserisci il nome del bucket, non includere
(Facoltativo) Nella sezione Opzioni di notifica:
- Fai clic sul pulsante di attivazione/disattivazione per abilitare le notifiche via email. Quando attivi questa opzione, l'amministratore del trasferimento riceve una notifica via email quando l'esecuzione di un trasferimento non riesce.
- In Seleziona un argomento Pub/Sub, scegli il nome dell'argomento o fai clic su Crea un argomento. Questa opzione configura l'esecuzione delle notifiche di Pub/Sub in relazione al trasferimento.
Fai clic su Salva.
bq
Inserisci il comando bq mk e fornisci il flag di creazione del trasferimento --transfer_config. Sono richiesti anche i seguenti flag:
--data_source--target_dataset--display_name--params
bq mk --transfer_config \ --project_id=project_id \ --target_dataset=dataset \ --display_name=name \ --params='parameters' \ --data_source=data_source
Dove:
- project_id è l'ID progetto.
- dataset è il set di dati di destinazione per la configurazione del trasferimento dei dati.
- name è il nome visualizzato della configurazione del trasferimento di dati. Il nome del trasferimento può essere qualsiasi valore che ti consenta di identificare il trasferimento se devi modificarlo in un secondo momento.
- parameters contiene i parametri per la configurazione del trasferimento di dati creata in formato JSON. Ad esempio:
--params='{"param":"param_value"}'. Per Campaign Manager, devi fornire i parametribucketenetwork_id.bucketè il bucket Cloud Storage che contiene i file DTv2 di Campaign Manager.network_idè l'ID della tua rete, di Floodlight o dell'inserzionista. - data_source è l'origine dati,
dcm_dt(Campaign Manager).
Puoi anche aggiungere il flag --project_id per specificare un progetto specifico. Se --project_id non è specificato, viene utilizzato il progetto predefinito.
Ad esempio, il seguente comando crea un trasferimento di dati di Campaign Manager denominato My Transfer utilizzando l'ID Campaign Manager 123456, il bucket Cloud Storage dcdt_-dcm_account123456 e il set di dati di destinazione mydataset. Il parametro file_name_prefix è facoltativo e viene utilizzato solo per nomi file personalizzati rari.
Il trasferimento dei dati viene creato nel progetto predefinito:
bq mk --transfer_config \
--target_dataset=mydataset \
--display_name='My Transfer' \
--params='{"bucket": "dcdt_-dcm_account123456","network_id": "123456","file_name_prefix":"YYY"}' \
--data_source=dcm_dt
Dopo aver eseguito il comando, ricevi un messaggio simile al seguente:
[URL omitted] Please copy and paste the above URL into your web browser and
follow the instructions to retrieve an authentication code.
Segui le istruzioni e incolla il codice di autenticazione nella riga di comando.
API
Utilizza il metodo projects.locations.transferConfigs.create e fornisci un'istanza della risorsa TransferConfig.
Java
Prima di provare questo esempio, segui le istruzioni di configurazione di Java nella guida rapida di BigQuery per l'utilizzo delle librerie client. Per saperne di più, consulta la documentazione di riferimento dell'API BigQuery Java.
Per eseguire l'autenticazione in BigQuery, configura le Credenziali predefinite dell'applicazione. Per saperne di più, vedi Configura l'autenticazione per le librerie client.
Risolvi i problemi di configurazione del trasferimento Campaign Manager
Se riscontri problemi durante la configurazione del trasferimento di dati, consulta Problemi di trasferimento di Campaign Manager in Risoluzione dei problemi relativi alle configurazioni di trasferimento.
Esegui query sui dati
Quando vengono trasferiti a BigQuery, i tuoi dati vengono scritti in tabelle partizionate per data di acquisizione. Per saperne di più, consulta Introduzione alle tabelle partizionate.
Se esegui query direttamente sulle tabelle anziché utilizzare le visualizzazioni generate automaticamente, devi utilizzare la pseudocolonna _PARTITIONTIME nella query. Per maggiori informazioni, consulta la pagina Esecuzione di query su tabelle partizionate.
Query di esempio di Campaign Manager
Puoi utilizzare le seguenti query di esempio di Campaign Manager per analizzare i dati trasferiti. Puoi anche utilizzare le query in uno strumento di visualizzazione come Data Studio. Queste query vengono fornite per aiutarti a iniziare a eseguire query sui dati di Campaign Manager con BigQuery. Per ulteriori domande su cosa puoi fare con questi report, contatta il tuo rappresentante tecnico di Campaign Manager.
In ciascuna delle seguenti query, sostituisci le variabili come dataset con i tuoi valori.
Campagne più recenti
La seguente query SQL di esempio recupera le campagne più recenti.
SELECT Campaign, Campaign_ID FROM `dataset.match_table_campaigns_campaign_manager_id` WHERE _DATA_DATE = _LATEST_DATE
Impressioni e utenti distinti per campagna
La seguente query SQL di esempio analizza il numero di impressioni e di utenti distinti per campagna negli ultimi 30 giorni.
# START_DATE = DATE_ADD(CURRENT_DATE(), INTERVAL -31 DAY) # END_DATE = DATE_ADD(CURRENT_DATE(), INTERVAL -1 DAY) SELECT Campaign_ID, _DATA_DATE AS Date, COUNT(*) AS count, COUNT(DISTINCT User_ID) AS du FROM `dataset.impression_campaign_manager_id` WHERE _DATA_DATE BETWEEN start_date AND end_date GROUP BY Campaign_ID, Date
Campagne più recenti ordinate per campagna e data
La seguente query SQL di esempio analizza le campagne più recenti degli ultimi 30 giorni, ordinate per campagna e data.
# START_DATE = DATE_ADD(CURRENT_DATE(), INTERVAL -31 DAY) # END_DATE = DATE_ADD(CURRENT_DATE(), INTERVAL -1 DAY) SELECT Campaign, Campaign_ID, Date FROM ( SELECT Campaign, Campaign_ID FROM `dataset.match_table_campaigns_campaign_manager_id` WHERE _DATA_DATE = _LATEST_DATE ), ( SELECT date AS Date FROM `bigquery-public-data.utility_us.date_greg` WHERE Date BETWEEN start_date AND end_date ) ORDER BY Campaign_ID, Date
Impressioni e utenti distinti per campagna in un intervallo di date
La seguente query SQL di esempio analizza il numero di impressioni e di utenti distinti per campagna tra il giorno start_date e il giorno end_date.
# START_DATE = DATE_ADD(CURRENT_DATE(), INTERVAL -31 DAY) # END_DATE = DATE_ADD(CURRENT_DATE(), INTERVAL -1 DAY) SELECT base.*, imp.count AS imp_count, imp.du AS imp_du FROM ( SELECT * FROM ( SELECT Campaign, Campaign_ID FROM `dataset.match_table_campaigns_campaign_manager_id` WHERE _DATA_DATE = _LATEST_DATE ), ( SELECT date AS Date FROM `bigquery-public-data.utility_us.date_greg` WHERE Date BETWEEN start_date AND end_date ) ) AS base LEFT JOIN ( SELECT Campaign_ID, _DATA_DATE AS Date, COUNT(*) AS count, COUNT(DISTINCT User_ID) AS du FROM `dataset.impression_campaign_manager_id` WHERE _DATA_DATE BETWEEN start_date AND end_date GROUP BY Campaign_ID, Date ) AS imp ON base.Campaign_ID = imp.Campaign_ID AND base.Date = imp.Date WHERE base.Campaign_ID = imp.Campaign_ID AND base.Date = imp.Date ORDER BY base.Campaign_ID, base.Date
Impressioni, clic, attività e utenti distinti per campagna
La seguente query SQL di esempio analizza il numero di impressioni, clic, attività e utenti distinti per campagna negli ultimi 30 giorni. In questa query, sostituisci le variabili come campaign_list con i tuoi valori. Ad esempio, sostituisci campaign_list con un elenco separato da virgole di tutte le campagne Campaign Manager di interesse nell'ambito della query.
# START_DATE = DATE_ADD(CURRENT_DATE(), INTERVAL -31 DAY) # END_DATE = DATE_ADD(CURRENT_DATE(), INTERVAL -1 DAY) SELECT base.*, imp.count AS imp_count, imp.du AS imp_du, click.count AS click_count, click.du AS click_du, activity.count AS activity_count, activity.du AS activity_du FROM ( SELECT * FROM ( SELECT Campaign, Campaign_ID FROM `dataset.match_table_campaigns_campaign_manager_id` WHERE _DATA_DATE = _LATEST_DATE ), ( SELECT date AS Date FROM `bigquery-public-data.utility_us.date_greg` WHERE Date BETWEEN DATE_ADD(CURRENT_DATE(), INTERVAL -31 DAY) AND DATE_ADD(CURRENT_DATE(), INTERVAL -1 DAY) ) ) AS base LEFT JOIN ( SELECT Campaign_ID, _DATA_DATE AS Date, COUNT(*) AS count, COUNT(DISTINCT User_ID) AS du FROM `dataset.impression_campaign_manager_id` WHERE _DATA_DATE BETWEEN DATE_ADD(CURRENT_DATE(), INTERVAL -31 DAY) AND DATE_ADD(CURRENT_DATE(), INTERVAL -1 DAY) GROUP BY Campaign_ID, Date ) AS imp ON base.Campaign_ID = imp.Campaign_ID AND base.Date = imp.Date LEFT JOIN ( SELECT Campaign_ID, _DATA_DATE AS Date, COUNT(*) AS count, COUNT(DISTINCT User_ID) AS du FROM `dataset.click_campaign_manager_id` WHERE _DATA_DATE BETWEEN DATE_ADD(CURRENT_DATE(), INTERVAL -31 DAY) AND DATE_ADD(CURRENT_DATE(), INTERVAL -1 DAY) GROUP BY Campaign_ID, Date ) AS click ON base.Campaign_ID = click.Campaign_ID AND base.Date = click.Date LEFT JOIN ( SELECT Campaign_ID, _DATA_DATE AS Date, COUNT(*) AS count, COUNT(DISTINCT User_ID) AS du FROM `dataset.activity_campaign_manager_id` WHERE _DATA_DATE BETWEEN DATE_ADD(CURRENT_DATE(), INTERVAL -31 DAY) AND DATE_ADD(CURRENT_DATE(), INTERVAL -1 DAY) GROUP BY Campaign_ID, Date ) AS activity ON base.Campaign_ID = activity.Campaign_ID AND base.Date = activity.Date WHERE base.Campaign_ID IN campaign_list AND (base.Date = imp.Date OR base.Date = click.Date OR base.Date = activity.Date) ORDER BY base.Campaign_ID, base.Date
Attività della campagna
La seguente query SQL di esempio analizza l'attività della campagna negli ultimi 30 giorni. In questa query, sostituisci le variabili come campaign_list con i tuoi valori. Ad esempio, sostituisci campaign_list con un elenco separato da virgole di tutte le campagne Campaign Manager di interesse nell'ambito della query.
# START_DATE = DATE_ADD(CURRENT_DATE(), INTERVAL -31 DAY) # END_DATE = DATE_ADD(CURRENT_DATE(), INTERVAL -1 DAY) SELECT base.*, activity.count AS activity_count, activity.du AS activity_du FROM ( SELECT * FROM ( SELECT Campaign, Campaign_ID FROM `dataset.match_table_campaigns_campaign_manager_id` WHERE _DATA_DATE = _LATEST_DATE ), ( SELECT mt_at.Activity_Group, mt_ac.Activity, mt_ac.Activity_Type, mt_ac.Activity_Sub_Type, mt_ac.Activity_ID, mt_ac.Activity_Group_ID FROM `dataset.match_table_activity_cats_campaign_manager_id` AS mt_ac JOIN ( SELECT Activity_Group, Activity_Group_ID FROM `dataset.match_table_activity_types_campaign_manager_id` WHERE _DATA_DATE = _LATEST_DATE ) AS mt_at ON mt_at.Activity_Group_ID = mt_ac.Activity_Group_ID WHERE _DATA_DATE = _LATEST_DATE ), ( SELECT date AS Date FROM `bigquery-public-data.utility_us.date_greg` WHERE Date BETWEEN start_date AND end_date ) ) AS base LEFT JOIN ( SELECT Campaign_ID, Activity_ID, _DATA_DATE AS Date, COUNT(*) AS count, COUNT(DISTINCT User_ID) AS du FROM `dataset.activity_campaign_manager_id` WHERE _DATA_DATE BETWEEN DATE_ADD(CURRENT_DATE(), INTERVAL -31 DAY) AND DATE_ADD(CURRENT_DATE(), INTERVAL -1 DAY) GROUP BY Campaign_ID, Activity_ID, Date ) AS activity ON base.Campaign_ID = activity.Campaign_ID AND base.Activity_ID = activity.Activity_ID AND base.Date = activity.Date WHERE base.Campaign_ID IN campaign_list AND base.Activity_ID = activity.Activity_ID ORDER BY base.Campaign_ID, base.Activity_Group_ID, base.Activity_ID, base.Date