Pianificare un trasferimento Display & Video 360

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

Report supportati

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

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

Display & Video 360 conserva i file Data Transfer per un massimo di 60 giorni.

Opzione di segnalazione Assistenza
Pianificazione

Ogni giorno, nel momento in cui viene creato per la prima volta il trasferimento (impostazione predefinita)

Puoi configurare l'ora del giorno.
Finestra di aggiornamento

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 ciascun tipo di dati di configurazione, consulta i seguenti link:

Prima di iniziare

Esamina i prerequisiti e le informazioni riportati di seguito prima di creare un trasferimento 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 di 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 Data Transfer v2 (Display & Video 360 DTv2) di Display & Video 360. Questi file vengono inviati 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 accedere 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 riguardi 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 maggiori informazioni, 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 tuo bucket Cloud Storage per il trasferimento dei dati di Display & Video 360. L'ID Display & Video 360 viene utilizzato per trovare corrispondenze con 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.

Individuazione del prefisso del nome file

In alcuni casi, i file nel bucket Cloud Storage potrebbero avere nomi personalizzati e non standard impostati dal team dei servizi Google Marketing Platform. Ad esempio:

In un file denominato dbm_partner123456custom_activity_*, il prefisso è dbm_partner123456custom.

Per assistenza relativa ai prefissi dei nomi file, contatta l'assistenza di Display & Video 360.

Configurare un trasferimento di dati in Display & Video 360

Seleziona una delle seguenti opzioni:

Console

  1. Nella console Google Cloud, vai alla pagina BigQuery.

    Vai a BigQuery

  2. Nel menu di navigazione di BigQuery, fai clic su Trasferimenti di dati.

  3. Fai clic su Crea trasferimento.

  4. Nella pagina Crea trasferimento, segui questi passaggi:

    • Nella sezione Tipo di origine, per Origine, scegli Display & Video 360 - Anteprima.
    • Nella sezione Nome configurazione di trasferimento, in Nome visualizzato, inserisci un nome per il trasferimento. Il nome del trasferimento può essere qualsiasi valore che ti consenta di identificare il trasferimento, qualora dovessi modificarlo in un secondo momento.

  5. Nella sezione Opzioni di pianificazione:

    • Seleziona Inizia ora o Inizia all'ora impostata, poi fornisci una data di inizio e un'ora di esecuzione.
    • Per Si ripete, scegli un'opzione per la frequenza di esecuzione del trasferimento. Se selezioni Giorni, fornisci un orario valido nel formato UTC.
      • Ore
      • Giorni
      • On demand

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

  7. Nella sezione Dettagli origine dati:

    • Nel campo ID Display & Video 360, inserisci l'ID partner o l'ID inserzionista.
    • (Facoltativo) Nella sezione Opzioni di notifica:
      • Fai clic sul pulsante di attivazione/disattivazione per abilitare le notifiche via email. Quando abiliti questa opzione, l'amministratore dei trasferimenti riceve una notifica via email quando un 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 dell'argomento o fai clic su Crea un argomento. Questa opzione configura le notifiche di Pub/Sub per il trasferimento.

  8. Fai clic su Salva.

bq

Inserisci il comando bq mk e fornisci il flag di creazione del trasferimento --transfer_config. I flag seguenti 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.
  • NAME: il nome visualizzato della configurazione di trasferimento. 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 di trasferimento creata in formato JSON. Ad esempio: --params='{"param":"param_value"}'. Per i trasferimenti Display & Video 360, sono obbligatori i parametri bucket e displayvideo_id. Il parametro file_name_prefix è facoltativo e viene utilizzato solo per nomi di file rari e personalizzati.
  • DATA_SOURCE: origine dati - displayvideo.

Ad esempio, il seguente comando crea un trasferimento Display & Video 360 denominato 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 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.

Eseguire query sui dati

Quando vengono trasferiti in BigQuery, i dati vengono scritti in tabelle partizionate in base al tempo di importazione. Per saperne di più, consulta Introduzione alle tabelle partizionate.

Ti consigliamo di eseguire query sulle viste generate automaticamente anziché direttamente sulle tabelle. Tuttavia, se vuoi eseguire query direttamente sulle tabelle, devi utilizzare la pseudo-colonna _PARTITIONTIME nella query. Per maggiori informazioni, consulta Esecuzione di query su tabelle partizionate.