Programma una visualizzazione e Trasferimento da Video 360
BigQuery Data Transfer Service per Display & Il connettore Video 360 ti consente di pianificare e gestire automaticamente i job di caricamento ricorrenti per Display & Video a 360° report e dati di configurazione.
Report supportati
BigQuery Data Transfer Service per Display & Video 360 supporta le seguenti opzione di reporting:
Per informazioni su come le campagne Display e I report di Video 360 vengono trasformati in Per le tabelle e le viste BigQuery, consulta Display e Trasformazione dei dati di Video 360.
Display & Video 360 conserva i file di trasferimento dati per un massimo di 60 giorni.
Opzione di segnalazione | Assistenza |
---|---|
Frequenza di ripetizione | Ogni giorno, nel momento in cui viene creato il trasferimento di dati per la prima volta (impostazione predefinita). Puoi configurare l'ora del giorno. |
Aggiorna finestra | Ultimi 2 giorni Non configurabile |
Durata massima del backfill | Ultimi 60 giorni |
Dati di configurazione supportati
Oltre ai dati dei report, BigQuery Data Transfer Service trasferisce anche i seguenti dati di configurazione da Display & Video 360. I dati di configurazione vengono recuperati dall'API Display & Video 360 v3.
- Partner
- Inserzionista
- LineItem
- LineItemTargeting
- Campagna
- CampaignTargeting
- InsertionOrder
- InsertionOrderTargeting
- Gruppo di annunci
- AdGroupTargeting
- AdGroupAd
- Creatività
Per ulteriori informazioni su ciascun tipo di dati di configurazione, consulta quanto segue Link:
- Informazioni sui partner
- Creare un inserzionista
- Creare un elemento pubblicitario
- Creare una campagna
- Creare un ordine di inserzione
- Informazioni su YouTube e elementi pubblicitari partner
- Gestire le creatività
Importazione dati da Display & Trasferimenti dei rapporti Video 360
Quando trasferisci i dati da Display & da Video 360 a BigQuery, 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 generano dati duplicati e le partizioni per altre date non sono interessate.Aggiorna finestre
Una finestra di aggiornamento è il numero di giorni per i quali 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 si verifica un trasferimento giornaliero, BigQuery Data Transfer Service recupera tutti i dati dalla 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 degli ultimi due giorni. 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 nel tempo, il trasferimento dei dati recupera tutti i dati di origine disponibili finestra. 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.
Le finestre di aggiornamento sono mappate al campo API TransferConfig.data_refresh_window_days
.
Per recuperare i dati al di fuori della finestra di aggiornamento, ad esempio i dati storici, o per recuperare i dati da eventuali interruzioni o lacune del trasferimento, puoi avviare o pianificare un'esecuzione di backfill.
Prima di iniziare
Consulta i seguenti prerequisiti e informazioni prima di creare un account display e Video a 360° trasferimento di dati.
Prerequisiti
- Verifica di aver completato tutte le azioni necessarie per abilitare BigQuery Data Transfer Service.
- Crea un set di dati BigQuery per archiviare Display e Dati di Video 360.
- Assicurati di avere a portata di mano: ID partner Video 360 o ID inserzionista. L'ID partner è l'elemento principale nella gerarchia.
- Assicurati di disporre delle autorizzazioni di lettura per accedere ai dati del partner o dell'inserzionista dall'API Display & Video.
Assicurati che la tua organizzazione abbia accesso a Display & Dati di Video 360 Trasferisci file v2 (Display &Video 360 DTv2). Questi file vengono caricati dal team di Display & Video 360 in un bucket Cloud Storage. La richiesta di accesso ai file DTv2 di Display & Video 360 dipende dal fatto che tu abbia o meno un contratto diretto con Display & Video 360. In entrambi i casi, potrebbero essere applicati costi aggiuntivi.
- Se hai un contratto con Display & Video a 360° contattare Display & Supporto di Video 360 per configurare Display & File DTv2 del video 360.
- Se non hai un contratto con Display & Video 360, contatta la tua agenzia per richiedere l'accesso ai file DTv2 di Display & Video 360.
- Dopo aver completato questo passaggio, riceverai uno dei seguenti messaggi
Nome del bucket Cloud Storage, a seconda se la configurazione è per un partner
o un inserzionista:
gs://dcdt_-dbm_partnerPARTNER_ID
gs://dcdt_-dbm_advertiserADVERTISER_ID
Per configurare le notifiche 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.
Trovare l'ID Display & Video 360
Per recuperare le tue metriche Display & ID Video 360, accedi a Cloud Storage pagina Bucket nella console Google Cloud ed esamina i file nel tuo Display e Bucket Cloud Storage per il trasferimento dei dati di Video 360. L'ID Display & Video 360 viene utilizzato per abbinare i file nel bucket Cloud Storage fornito. L'ID è incorporato nel nome file, non nella Nome del bucket Cloud Storage. Ad esempio:
- In un file denominato
dbm_partner123_activity_*
, l'ID è123
. - In un file denominato
dbm_advertiser567_activity_*
, l'ID è567
.
Individuazione del prefisso del nome file
In alcuni casi, i file nel bucket Cloud Storage potrebbero avere nomi di file non standard impostati da Google Marketing Platform Google Cloud. Ad esempio:
In un file denominato dbm_partner123456custom_activity_*
, il prefisso è
dbm_partner123456custom
.
Per assistenza in merito ai prefissi dei nomi file, contatta l'assistenza di Display & Video 360.
Configurare un trasferimento di dati di Display & Video 360
Seleziona una delle seguenti opzioni:
Console
Vai alla pagina Trasferimenti dati nella console Google Cloud.
Fai clic su
Crea trasferimento.Nella pagina Crea trasferimento, segui questi passaggi:
- Nella sezione Tipo di origine, per Origine, scegli Display e Video a 360°.
- Nella sezione Nome configurazione di trasferimento, in Nome visualizzato, inserisci un nome per il trasferimento dei dati. 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 programmazione:
- Seleziona Inizia ora o Inizia all'ora impostata. quindi fornisci una data di inizio e un'ora di esecuzione.
- Per Si ripete, scegli un'opzione per la frequenza di esecuzione del
trasferimento di dati. Se selezioni Giorni, fornisci un orario valido nel formato UTC.
- Ore
- Giorni
- On demand
Nella sezione Impostazioni destinazione, in Set di dati di destinazione seleziona il set di dati che hai creato per archiviare i tuoi dati.
Nella sezione Dettagli origine dati:
- Nel campo Bucket DV360 DTV2 Cloud Storage, inserisci Bucket Cloud Storage che contiene le proprietà File DTv2 del video 360. Se configurare questo bucket, contattare Display & Video a 360° assistenza.
- Nel campo ID partner/inserzionista DV360, inserisci l'ID partner o l'ID inserzionista.
- (Facoltativo) Nella sezione Opzioni di notifica:
- Fai clic sul pulsante di attivazione/disattivazione per attivare le notifiche via email. Se attivi questa opzione, l'amministratore dei trasferimenti riceve una notifica via email quando un'esecuzione del trasferimento non va a buon fine.
- Fai clic sul pulsante di attivazione/disattivazione per abilitare le notifiche Pub/Sub. Per Seleziona un argomento Cloud Pub/Sub, scegli il nome di un argomento o fai clic su Crea . Questa opzione configura le notifiche di esecuzione di Pub/Sub per il trasferimento.
Fai clic su Salva.
bq
Inserisci il comando bq mk
e fornisci il flag di creazione del trasferimento:
--transfer_config
. I seguenti flag sono obbligatori:
--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: il tuo ID progetto.
- DATASET: il set di dati di destinazione per la configurazione del trasferimento di dati.
- NAME: il nome visualizzato per la configurazione del trasferimento dei dati. La Transfer name può essere qualsiasi valore che ti consenta di identificare il trasferimento se in un secondo momento.
- PARAMETERS: i parametri per il trasferimento di dati creato
configurazione in formato JSON.
Ad esempio:
--params='{"param":"param_value"}'
. Per Display e Trasferimenti dei report di Video 360,bucket
edisplayvideo_id
sono obbligatori. Il parametrofile_name_prefix
è facoltativo e viene utilizzato solo per nomi di file personalizzati rari. - DATA_SOURCE: origine dati -
displayvideo
.
Ad esempio, il seguente comando crea un trasferimento di dati Display & Video 360
chiamato My Transfer
utilizzando l'ID Display & Video 360 123456
, il bucket Cloud Storage
dcdt_-dbm_partner123456
e il set di dati di destinazione mydataset
.
Il trasferimento dei dati viene creato nel progetto predefinito:
bq mk --transfer_config \ --target_dataset=mydataset \ --display_name='My Transfer' \ --params='{"bucket":"dcdt_-dbm_partner123456","displayvideo_id": "123456","file_name_prefix":"YYY"}' \ --data_source=displayvideo
Dopo aver eseguito il comando, viene visualizzato 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 nel messaggio 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
.
Esegui query sui dati
Quando vengono trasferiti a BigQuery, i tuoi dati vengono scritti in tabelle partizionate per data di importazione. Per ulteriori informazioni, consulta la pagina Introduzione alle tabelle partizionate.
Ti consigliamo di eseguire query sulle visualizzazioni generate automaticamente anziché direttamente sulle tabelle. Tuttavia, se vuoi eseguire query direttamente sulle tabelle, devi
utilizzare la pseudocolonna _PARTITIONTIME
nella query. Per ulteriori informazioni, consulta la pagina Esecuzione di query sulle tabelle partizionate.