Pianificare un trasferimento da Display & Video 360

Il connettore BigQuery Data Transfer Service per Display & Video 360 consente di pianificare e gestire automaticamente i job di caricamento ricorrenti per i dati di configurazione e dei report di Display & Video 360.

Report supportati

BigQuery Data Transfer Service per Display & Video 360 supporta la seguente opzione di generazione di report:

Per informazioni su come i report di Display & Video 360 vengono trasformati in tavole e visualizzazioni BigQuery, consulta Trasformazione dei dati di Display & Video 360.

Display & Video 360 conserva i file di trasferimento dati per un massimo di 60 giorni.

Opzione di segnalazione Assistenza
Frequenza di ripetizione

Giornalmente, al momento della prima creazione del trasferimento dei dati (valore predefinito)

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.

Per ulteriori informazioni su ogni tipo di dati di configurazione, consulta i seguenti link:

Importazione dei dati dai trasferimenti di Display & Video 360

Quando trasferisci i dati da Display & Video 360 a BigQuery, vengono caricati nelle 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.

Aggiornare le 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 dati per la prima volta, vengono recuperati tutti i dati di origine disponibili all'interno della 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.

Le finestre di aggiornamento sono mappate al campo dell'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 una esecuzione di backfill.

Prima di iniziare

Esamina i prerequisiti e le informazioni riportati di seguito prima di creare un trasferimento di dati di Display & Video 360.

Prerequisiti

  • Verifica di aver completato tutte le azioni necessarie per abilitare BigQuery Data Transfer Service.
  • Crea un set di dati BigQuery per archiviare i dati di Display & Video 360.
  • Assicurati di disporre dell'ID partner o dell'ID inserzionista Display & Video 360. 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 ai file di trasferimento dati di Display & Video 360 v2 (DTv2 di Display & Video 360). 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 360, contatta l'assistenza di Display & Video 360 per configurare i file DTv2 di Display & 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 nomi di bucket Cloud Storage, a seconda che la configurazione sia 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 il tuo ID Display & Video 360, vai alla pagina Bucket di Cloud Storage nella console Google Cloud ed esamina i file nel bucket Cloud Storage per il trasferimento dei dati di Display & 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 nel 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.

Trovare il prefisso del nome file

In alcuni casi, i file nel bucket Cloud Storage potrebbero avere nomi personalizzati e non standard che sono stati configurati per te dal team di servizi di Google Marketing Platform. 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

  1. Vai alla pagina Trasferimenti dati nella console Google Cloud.

    Vai a Trasferimenti dati

  2. Fai clic su Crea trasferimento.

  3. Nella pagina Crea trasferimento:

    • Nella sezione Tipo di origine, per Origine, scegli Display & Video 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.

  4. Nella sezione Opzioni di programmazione:

    • Seleziona Inizia ora o Inizia all'ora impostata, quindi fornisci una data di inizio e un tempo di esecuzione.
    • Per Si ripete, scegli un'opzione per la frequenza con cui eseguire il trasferimento dei dati. Se selezioni Giorni, specifica un'ora valida in UTC.
      • Ore
      • Giorni
      • On demand

  5. Nella sezione Impostazioni di destinazione, nel menu Set di dati di destinazione, seleziona il set di dati che hai creato per archiviare i dati.

  6. Nella sezione Dettagli dell'origine dati:

    • Nel campo Bucket Cloud Storage DV360 DTV2, inserisci il bucket Cloud Storage che contiene i file DTv2 di Display &Video 360. Se devi configurare questo bucket, contatta l'assistenza di Display & Video 360.
    • 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 attivare le notifiche Pub/Sub. In Seleziona un argomento Cloud Pub/Sub, scegli il nome dell'argomento o fai clic su Crea un argomento. Questa opzione configura le notifiche di esecuzione di Pub/Sub per il trasferimento.

  7. 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 dei dati.
  • NAME: il nome visualizzato per la configurazione del 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.
  • PARAMETERS: i parametri per la configurazione del trasferimento di dati creata in formato JSON. Ad esempio,--params='{"param":"param_value"}'. Per i trasferimenti di Display & Video 360, i parametri bucket e displayvideo_id sono obbligatori. Il parametro file_name_prefix è facoltativo e viene utilizzato solo per nomi di file personalizzati rari.
  • DATA_SOURCE: l'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.