Integrazione con YouTube (DV360)

Questa pagina descrive le configurazioni necessarie per importare i dati da YouTube con Display & Video 360 (DV360) come origine dati del carico di lavoro di marketing di Cortex Framework Data Foundation.

DV360 è una piattaforma pubblicitaria di Google per la gestione della pubblicità su YouTube insieme ad altri canali digitali, che offre agli inserzionisti maggiore controllo ed efficienza nelle loro attività di marketing.

Il seguente diagramma descrive come i dati DV360 sono disponibili tramite il carico di lavoro di marketing di Cortex Framework Data Foundation:

Figura 1. Origine dati DV360.

Nota: per accedere ai file di configurazione, alle visualizzazioni e ai modelli di analisi per l'origine dati DV360, consulta la directory dell'origine dati.

File di configurazione

Il file config.json configura le impostazioni necessarie per connettersi alle origini dati per il trasferimento di dati da vari workload. Questo file contiene i seguenti parametri per DV360:

   "marketing": {
        "deployDV360": true,
        "DV360": {
            "deployCDC": true,
            "datasets": {
                "cdc": "",
                "raw": "",
                "reporting": "REPORTING_DV360"
            }
        }
   }

La tabella seguente descrive il valore di ciascun parametro di marketing:

Parametro	Significato	Valore predefinito	Descrizione
marketing.deployDV360	Esegui il deployment di DV360	true	Esegui il deployment per l'origine dati DV360.
marketing.DV360.deployCDC	Esegui il deployment degli script CDC per DV360	true	Genera script di elaborazione CDC di DV360 da eseguire come DAG in Cloud Composer.
marketing.DV360.datasets.cdc	Set di dati CDC per DV360	-	Set di dati CDC per DV360.
marketing.DV360.datasets.raw	Set di dati non elaborato per DV360	-	Set di dati non elaborato per DV360.
marketing.DV360.datasets.reporting	Set di dati dei report per DV360	REPORTING_DV360	Set di dati dei report per DV360.

Modello dati

Questa sezione descrive il modello di dati di YouTube (con DV360) utilizzando il diagramma di relazione tra entità (ERD).

Figura 2. YouTube (con DV360): diagramma delle relazioni tra entità.

Viste report

Gli oggetti blu nell'ERD rappresentano le viste report che contengono metriche aggregate. Visualizza gli script in src/marketing/src/DV360/src/reporting/ddls.

Configurare l'estrazione dei dati non elaborati di DV360

Cortex Framework si integra con DV360 utilizzando la funzionalità Report istantanei. Report istantanei è una funzionalità pronta all'uso affidabile e a basso costo di DV360 che consente di salvare, pianificare e scaricare report più grandi e complessi in file e posizioni diverse. Ogni report crea periodicamente tabelle di dati di esportazione in BigQuery con lo stesso prefisso del nome della tabella configurato, che contiene i dati per l'intervallo di date selezionato, con la frequenza selezionata.

Nota: Google eseguirà la migrazione di tutti i report dei report offline ai report istantanei a partire da luglio 2024. La funzionalità Esporta in BigQuery funziona allo stesso modo per entrambi i tipi di report. Sei responsabile della gestione di tutti i report di Report istantanei. Cortex Framework non ne configura né controlla il comportamento.

Autorizzazioni

Per esportare correttamente i dati non elaborati da DV360 utilizzando i report istantanei, sono necessarie persone con le seguenti autorizzazioni:

• DV360:
  • Accesso standard per i partner o gli inserzionisti selezionati.
• Google Cloud:
  • Il ruolo BigQuery User assegnato all'account di servizio DV360.
  • Il ruolo BigQuery Data Editor assegnato all'account di servizio DV360.

Configura

Per configurare l'esportazione delle tabelle non elaborate da DV360:

1. Identifica l'account di servizio richiesto da DV360 BigQuery Exporter consultando la sezione Dettagli delle autorizzazioni dell'account di esportazione BigQuery collegato. Per ulteriori informazioni, consulta la Figura 2.
   Figura 2. Identifica l'account di servizio nell'account Collega BigQuery Exporter
2. Ottieni Google Cloud le autorizzazioni. Una persona con il ruolo BigQuery Administrator deve concedere i ruoli BigQuery User e BigQuery Data Editor all'account di servizio DV360 identificato nel passaggio precedente.
3. Collega BigQuery a DV360, specificando il set di dati non elaborato che intendi utilizzare durante la procedura. Segui le istruzioni nella sezione Report offline > Attiva BigQuery.

4. Vai a Report istantanei e crea un report per ogni riga della tabella seguente, con le colonne esattamente come mostrato. Per ulteriori informazioni sui file di definizioni dettagliate dello schema delle colonne in src/DV360/config/table_schema, consulta la sezione Schema della tabella da dati non elaborati a CDC.

   1. Aggiungi almeno un filtro Partner o Inserzionista. Assicurati che sia in linea con le autorizzazioni del link BigQuery nel passaggio 3.
   Nota: potrebbe essere necessario configurare più report o esportazioni se esporti più partner o inserzionisti.
   1. Seleziona Fuso orario dell'inserzionista come impostazione del fuso orario del report. Per ulteriori informazioni, consulta la sezione Considerazioni aggiuntive di seguito.
   Nota: se il tuo account o il collegamento a BigQuery ha solo accesso come inserzionista, non puoi includere un filtro Partner, altrimenti l'opzione Esporta in BigQuery verrà disattivata finché il filtro Partner non verrà rimosso.

   Prefisso tabella	Campi da includere
   lineitem_details	Data ID elemento pubblicitario Elemento pubblicitario ID campagna Campagna Tipo di elemento pubblicitario Data di inizio dell'elemento pubblicitario Data di fine dell'elemento pubblicitario	Impressioni
   lineitem_insights	Data ID elemento pubblicitario Tipo di dispositivo Browser Ambiente Paese ID partner Partner Valuta del partner ID inserzionista Inserzionista Valuta dell'inserzionista ID campagna Campagna ID ordine di inserzione Ordine di inserzione Elemento pubblicitario Tipo di elemento pubblicitario Data di inizio dell'elemento pubblicitario Data di fine dell'elemento pubblicitario	Impressioni Clic Entrate (USD) Interazioni Entrate (valuta del partner) Entrate (valuta dell'inserzionista) TrueView: visualizzazioni
   adgroup_insights_by_age_gender	Data ID gruppo di annunci di YouTube Età (YouTube) Genere ID elemento pubblicitario ID partner Partner Valuta del partner AdvertiserID Inserzionista Valuta dell'inserzionista ID ordine di inserzione Ordine di inserzione Elemento pubblicitario Gruppo di annunci di YouTube	Entrate (USD) Impressioni Clic Coinvolgimenti (YouTube) Entrate (valuta del partner) Entrate (valuta dell'inserzionista) TrueView: visualizzazioni
   adgroup_insights_by_audience	Data ID gruppo di annunci di YouTube Segmento di pubblico Tipo di segmento di pubblico ID elemento pubblicitario ID partner Partner PartnerCurrency ID inserzionista Inserzionista Valuta dell'inserzionista ID ordine di inserzione Ordine di inserzione Elemento pubblicitario	Impressioni Clic Gruppo di annunci di YouTube Entrate (USD) Coinvolgimenti (YouTube) Entrate (valuta del partner) Entrate (valuta dell'inserzionista) TrueView: visualizzazioni
   adgroup_insights_by_adformat	Data ID gruppo di annunci di YouTube Formato dell'annuncio di YouTube ID elemento pubblicitario ID partner Partner Valuta del partner ID inserzionista Inserzionista Valuta dell'inserzionista ID ordine di inserzione Ordine di inserzione Elemento pubblicitario	Impressioni Clic Gruppo di annunci di YouTube Entrate (USD) Coinvolgimenti (YouTube) Entrate (valuta del partner) Entrate (valuta dell'inserzionista) TrueView: visualizzazioni
   adgroup_insights_by_placement	Data ID gruppo di annunci di YouTube Posizionamento (tutti i canali di YouTube) Nome posizionamento (tutti i canali YouTube) ID elemento pubblicitario PartnerID Partner Valuta del partner ID inserzionista Inserzionista Valuta dell'inserzionista ID ordine di inserzione Ordine di inserzione Elemento pubblicitario	Impressioni Gruppo di annunci di YouTube Entrate (USD) Coinvolgimenti (YouTube) Entrate (valuta del partner) Entrate (valuta dell'inserzionista) TrueView: visualizzazioni
   adgroup_insights_by_adtype	Data ID gruppo di annunci di YouTube Tipo di annuncio di YouTube ID elemento pubblicitario ID partner Partner Valuta del partner ID inserzionista Inserzionista Valuta dell'inserzionista ID ordine di inserzione Ordine di inserzione Elemento pubblicitario	Impressioni Clic Gruppo di annunci di YouTube Entrate (USD) Coinvolgimenti (YouTube) Entrate (valuta del partner) Entrate (valuta dell'inserzionista) TrueView: visualizzazioni
   ad_insights	Data ID annuncio di YouTube ID elemento pubblicitario ID partner Partner Valuta del partner ID inserzionista Inserzionista AdvertiserCurrency ID ordine di inserzione Ordine di inserzione Elemento pubblicitario ID gruppo di annunci di YouTube Gruppo di annunci di YouTube Annuncio di YouTube	Impressioni Clic Entrate (USD) Coinvolgimenti (YouTube) Entrate (valuta del partner) Entrate (AdvCurrency) TrueView: visualizzazioni

5. Configura la pianificazione e compila i dati storici. Assicurati di utilizzare lo stesso link BigQuery configurato nel passaggio 1, nonché il prefisso tabella esattamente come mostrato nella tabella precedente. Per ulteriori informazioni, consulta la sezione Considerazioni aggiuntive di seguito.

6. • Attiva manualmente un'esecuzione di backfill o attendi l'inizio dell'esportazione pianificata. In entrambi i casi, i dati vengono inseriti automaticamente nel set di dati non elaborato configurato per il link BigQuery.

Ulteriori considerazioni

Informazioni sulla selezione del fuso orario:

• Per alcuni tipi di report, puoi scegliere il fuso orario dell'inserzionista o il fuso orario UTC per le date al momento della configurazione dell'esportazione. Tuttavia, i report relativi a YouTube supportano solo il fuso orario dell'inserzionista. Pertanto, assicurati di selezionare l'impostazione del fuso orario Inserzionista quando configuri le esportazioni.

• Poiché l'esportazione dei report è preaggregato a livello giornaliero, Cortex Framework utilizza la data fornita direttamente senza conversioni dei fusi orari. Sei responsabile dell'interpretazione delle informazioni sul fuso orario registrate.

In merito alla pianificazione e al backfill dei dati storici:

• Ti consigliamo di selezionare Ultimi 7 giorni come intervallo di date di esportazione e Giornaliera come frequenza di esportazione. La selezione di un intervallo di date di esportazione e di una frequenza di esportazione è necessaria per trovare un equilibrio tra l'accuratezza dei dati e il costo dello spazio di archiviazione, anche se qualsiasi impostazione funzionerà con il nostro processo CDC.

• I report istantanei supportano l'esportazione di un massimo di 14 giorni di dati quando si esporta in BigQuery, anche se a volte DV360 potrebbe apportare aggiornamenti minori ai dati, fino a 31 giorni dopo la data del report. Se configuri l'esportazione per più inserzionisti, la data di ciascun inserzionista sarà nel relativo fuso orario.

• Se sono necessari dati storici, come una tantum non pianificate, i report istantanei consentono di esportare direttamente fino a 2 anni di dati nelle tabelle BigQuery. Assicurati di eseguire questa operazione almeno una volta manualmente dall'interfaccia utente di DV360.

Aggiornamento e ritardo dei dati

Come regola generale, l'aggiornamento dei dati per le origini dati di Cortex Framework è limitato da ciò che consente la connessione a monte, nonché dalla frequenza di esecuzione del DAG. Modifica la frequenza di esecuzione del DAG in modo che sia in linea con la frequenza a monte, le limitazioni delle risorse e le esigenze della tua attività.

Con Report istantanei DV360, l'aggiornamento dei dati dipende dall'impostazione della frequenza di esportazione quando viene configurata l'esportazione di BigQuery, che può essere giornaliera, settimanale o mensile.

Configurazioni

Questa sezione descrive le configurazioni per l'elaborazione dei dati.

Connessioni Cloud Composer

Crea le seguenti connessioni in Cloud Composer. Per ulteriori dettagli, consulta la documentazione di Cloud Composer.

Nome connessione	Purpose
dv360_cdc_bq	Per il trasferimento del set di dati non elaborato > set di dati CDC.
dv360_reporting_bq	Per il trasferimento del set di dati CDC > set di dati report.

Schema della tabella da dati non elaborati a CDC

La directory src/DV360/config/table_schema contiene un file schema per ogni insieme di tabelle (identificato dallo stesso prefisso) esportato da DV360. Ogni file dello schema contiene due colonne: ColumnName e ColumnDataType.

Nota: se il tuo caso d'uso includeva colonne aggiuntive nell'esportazione dei report istantanei, assicurati di includerle anche nei file dello schema corrispondenti.

Impostazioni di importazione

Il file src/DV360/config/ingestion_settings.yaml contiene ulteriori impostazioni che controllano le pipeline di dati dall'origine al CDC.

Origine alle tabelle CDC

Questa sezione contiene voci che controllano l'importazione delle tabelle esportate da DV360 e il comportamento del processo CDC pertinente. Ogni voce corrisponde a un report di Report istantanei, identificato dal prefisso di esportazione.

I seguenti parametri controllano le impostazioni di Source to CDC per ogni voce:

Parametro	Descrizione
base_table	Tabella nel set di dati CDC in cui vengono archiviati i dati non elaborati dopo la trasformazione CDC (ad es. customer).
load_frequency	La frequenza con cui viene eseguito un DAG per questa entità per compilare la tabella CDC. Per ulteriori informazioni sui possibili valori, consulta la documentazione di Airflow.
raw_table_prefix	Prefisso utilizzato dal report Report istantanei corrispondente per configurare questa esportazione BigQuery.
row_identifiers	Colonne (separate da virgole) che formano un record univoco per questa tabella.
partition_details	Facoltativo:se vuoi che questa tabella sia suddivisa per motivi di rendimento. Per ulteriori informazioni, consulta Partizione della tabella.
cluster_details	(Facoltativo) Se vuoi che questa tabella sia raggruppata per motivi di rendimento, consulta ulteriori informazioni in Impostazioni cluster.

Impostazioni report

Puoi configurare e controllare in che modo Cortex Framework genera i dati per il livello di reporting finale di DV360 utilizzando il file di impostazioni di reporting src/DV360/config/reporting_settings.yaml. Questo file controlla la modalità di generazione degli oggetti BigQuery del livello di generazione di report (tabelle, visualizzazioni,funzioni o stored procedure).

Per ulteriori informazioni, vedi Personalizzare il file delle impostazioni dei report.

Passaggi successivi

• Per ulteriori informazioni su altre origini dati e carichi di lavoro, consulta Origini dati e carichi di lavoro.
• Per ulteriori informazioni sulla procedura di implementazione negli ambienti di produzione, consulta Prerequisiti per l'implementazione di Data Foundation di Cortex Framework.