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 dati dei report e di configurazione 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 tabelle e viste BigQuery, consulta l'articolo sulla 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, alla prima creazione del 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 saperne di più su ciascun tipo di dati di configurazione, consulta i seguenti link:

Prima di iniziare

Esamina i prerequisiti e le informazioni seguenti prima di creare un trasferimento in 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 avere il tuo ID partner o ID inserzionista Display & Video 360. L'ID partner è l'ID principale nella gerarchia.
  • Assicurati di disporre delle autorizzazioni di lettura per accedere ai dati dei partner o degli inserzionisti dall'API Display & Video 360.

  • 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 ottenere l'accesso ai file DTv2 di Display & Video 360.
    • Dopo aver completato questo passaggio, riceverai uno dei seguenti nomi per il bucket Cloud Storage, a seconda che la tua configurazione sia per un partner o un inserzionista:
      • gs://dcdt_-dbm_partnerPARTNER_ID
      • gs://dcdt_-dbm_advertiserADVERTISER_ID

  • Per configurare le notifiche di esecuzione dei trasferimenti per Pub/Sub, devi disporre delle autorizzazioni pubsub.topics.setIamPolicy. Per ulteriori informazioni, consulta Notifiche di esecuzione di BigQuery Data Transfer Service.

Trovare l'ID Display & Video 360

Per recuperare l'ID Display & Video 360, vai alla pagina Bucket di Cloud Storage nella console Google Cloud ed esamina i file nel bucket Cloud Storage di Data Transfer di Display & Video 360. L'ID Display & Video 360 viene utilizzato per creare corrispondenze tra 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 di file personalizzati e non standard che sono stati impostati dal team dei servizi 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 dati 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, procedi nel seguente modo:

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

  5. Nella sezione Opzioni di pianificazione:

    • Seleziona Inizia ora o Inizia all'ora impostata, quindi inserisci una data di inizio e un'ora di esecuzione.
    • Per Ripetizioni, scegli un'opzione per stabilire la frequenza di esecuzione del trasferimento. Se selezioni Giorni, fornisci un orario valido nel fuso orario UTC.
      • Orari
      • 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 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 l'esecuzione di un trasferimento non va a buon fine.
      • Fai clic sul pulsante di attivazione/disattivazione per abilitare 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 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 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: l'ID progetto.
  • DATASET: il set di dati di destinazione per la configurazione di trasferimento.
  • NAME: il nome visualizzato per la 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 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 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.

Esegui query sui dati

Quando i dati vengono trasferiti in BigQuery, vengono scritti in tabelle partizionate al momento dell'importazione. Per saperne di più, vedi Introduzione alle tabelle partizionate.

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