Intégration à YouTube (DV360)

Cette page décrit les configurations requises pour importer des données YouTube avec Display & Video 360 (DV360) en tant que source de données de la charge de travail marketing de Cortex Framework Data Foundation.

DV360 est une plate-forme publicitaire de Google qui permet de gérer la publicité YouTube ainsi que d'autres canaux numériques. Elle offre aux annonceurs plus de contrôle et d'efficacité dans leurs efforts marketing.

Le schéma suivant décrit comment les données DV360 sont disponibles via la charge de travail marketing de Cortex Framework Data Foundation:

Figure 1 Source de données DV360

Remarque :Pour accéder aux fichiers de configuration, aux vues analytiques et aux modèles de la source de données DV360, consultez le répertoire des sources de données.

Fichier de configuration

Le fichier config.json configure les paramètres requis pour se connecter aux sources de données afin de transférer des données à partir de différentes charges de travail. Ce fichier contient les paramètres suivants pour DV360:

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

Le tableau suivant décrit la valeur de chaque paramètre marketing:

Paramètre	Signification	Valeur par défaut	Description
marketing.deployDV360	Déployer DV360	true	Exécutez le déploiement pour la source de données DV360.
marketing.DV360.deployCDC	Déployer des scripts CDC pour DV360	true	Générez des scripts de traitement CDC DV360 à exécuter en tant que DAG dans Cloud Composer.
marketing.DV360.datasets.cdc	Ensemble de données CDC pour DV360	-	Ensemble de données CDC pour DV360.
marketing.DV360.datasets.raw	Ensemble de données brut pour DV360	-	Ensemble de données brut pour DV360.
marketing.DV360.datasets.reporting	Ensemble de données de reporting pour DV360	REPORTING_DV360	Ensemble de données de reporting pour DV360.

Modèle de données

Cette section décrit le modèle de données YouTube (avec DV360) à l'aide du diagramme des relations entre entités (ERD).

Figure 2 YouTube (avec DV360): diagramme des relations entre les entités.

Vues de rapports

Les objets bleus de l'ERD représentent les vues de rapports contenant des métriques agrégées. Consultez les scripts dans src/marketing/src/DV360/src/reporting/ddls.

Configurer l'extraction de données brutes DV360

Cortex Framework s'intègre à DV360 à l'aide de sa fonctionnalité de rapports instantanés. La fonctionnalité Instant Reporting de DV360 est une fonctionnalité prête à l'emploi, fiable et peu coûteuse qui permet d'enregistrer, de planifier et de télécharger des rapports plus volumineux et plus complexes dans des fichiers et à différents emplacements. Chaque rapport crée régulièrement des tables de données d'exportation dans BigQuery avec le même préfixe de nom de table configuré, qui contient les données de la période sélectionnée, à la fréquence sélectionnée.

Remarque :Google migre tous les rapports hors connexion vers les rapports instantanés à partir de juillet 2024. La fonctionnalité Exporter vers BigQuery fonctionne de la même manière pour les deux types de rapports. Vous êtes responsable de la gestion de tous les rapports Instant Reporting. Cortex Framework ne configure ni ne contrôle son comportement.

Autorisations

Pour exporter des données brutes à partir de DV360 à l'aide des rapports instantanés, les utilisateurs doivent disposer des autorisations suivantes:

• DV360 :
  • Accès standard pour les partenaires ou annonceurs sélectionnés.
• Google Cloud :
  • Rôle BigQuery User attribué au compte de service DV360.
  • Rôle BigQuery Data Editor attribué au compte de service DV360.

Configurer

Pour configurer l'exportation de tableaux bruts à partir de DV360, procédez comme suit :

1. Identifiez le compte de service requis par l'exportateur BigQuery DV360 en consultant la section "Détails des autorisations" de la page "Associer un compte d'exportateur BigQuery". Pour en savoir plus, consultez la figure 2.
   Figure 2. Identifier le compte de service dans "Associer le compte BigQuery Exporter"
2. Obtenez les autorisations Google Cloud . Une personne disposant du rôle BigQuery Administrator doit attribuer les rôles BigQuery User et BigQuery Data Editor au compte de service DV360 identifié à l'étape précédente.
3. Associez BigQuery à DV360, en spécifiant l'ensemble de données brut que vous prévoyez d'utiliser dans le processus. Suivez les instructions de la section Rapports hors connexion > Activer BigQuery.

4. Accédez à Instant Reporting (Rapports instantanés) et créez un rapport pour chaque ligne du tableau suivant, en respectant exactement les colonnes. Pour en savoir plus sur les fichiers de définitions détaillées des schémas de colonnes sous src/DV360/config/table_schema, consultez la section Schéma de table brut vers CDC.

   1. Ajoutez au moins un filtre Partenaire ou Annonceur. Assurez-vous que cela correspond aux autorisations de votre lien BigQuery à l'étape 3.
   Remarque :Vous devrez peut-être configurer plusieurs rapports ou exportations si vous exportez plusieurs partenaires ou annonceurs.
   1. Sélectionnez Fuseau horaire de l'annonceur comme paramètre de fuseau horaire du rapport. Pour en savoir plus, consultez la section Remarques supplémentaires suivante.
   Remarque :Si votre compte ou votre association BigQuery ne dispose que d'un accès Annonceur, vous ne pouvez pas inclure de filtre Partenaire. Sinon, l'option Exporter vers BigQuery sera désactivée jusqu'à ce que le filtre Partenaire soit supprimé.

   Préfixe de table	Champs à inclure
   lineitem_details	Date ID de l'élément de campagne Élément de campagne ID de campagne Campagne Type d'élément de campagne Date de début de l'élément de campagne Date de fin de l'élément de campagne	Impressions
   lineitem_insights	Date ID de l'élément de campagne Type d'appareil Navigateur Environnement Pays ID du partenaire Partenaire Devise du partenaire Référence annonceur Annonceur Devise de l'annonceur ID de campagne Campagne ID de l'ordre d'insertion Ordre d'insertion Élément de campagne Type d'élément de campagne Date de début de l'élément de campagne Date de fin de l'élément de campagne	Impressions Clics Revenus (USD) Interactions Revenus (devise du partenaire) Revenus (devise de l'annonceur) TrueView: vues
   adgroup_insights_by_age_gender	Date ID du groupe d'annonces YouTube Âge (YouTube) Sexe ID de l'élément de campagne ID du partenaire Partenaire Devise du partenaire AdvertiserID Annonceur Devise de l'annonceur ID de l'ordre d'insertion Ordre d'insertion Élément de campagne Groupe d'annonces YouTube	Revenus (USD) Impressions Clics Engagements (YouTube) Revenus (devise du partenaire) Revenus (devise de l'annonceur) TrueView: vues
   adgroup_insights_by_audience	Date ID du groupe d'annonces YouTube Segment d'audience Type de segment d'audience ID de l'élément de campagne ID du partenaire Partenaire PartnerCurrency Référence annonceur Annonceur Devise de l'annonceur ID de l'ordre d'insertion Ordre d'insertion Élément de campagne	Impressions Clics Groupe d'annonces YouTube Revenus (USD) Engagements (YouTube) Revenus (devise du partenaire) Revenus (devise de l'annonceur) TrueView: vues
   adgroup_insights_by_adformat	Date ID du groupe d'annonces YouTube Format d'annonce YouTube ID de l'élément de campagne ID du partenaire Partenaire Devise du partenaire Référence annonceur Annonceur Devise de l'annonceur ID de l'ordre d'insertion Ordre d'insertion Élément de campagne	Impressions Clics Groupe d'annonces YouTube Revenus (USD) Engagements (YouTube) Revenus (devise du partenaire) Revenus (devise de l'annonceur) TrueView: vues
   adgroup_insights_by_placement	Date ID du groupe d'annonces YouTube Emplacement (toutes les chaînes YouTube) Nom de l'emplacement (toutes les chaînes YouTube) ID de l'élément de campagne PartnerID Partenaire Devise du partenaire Référence annonceur Annonceur Devise de l'annonceur ID de l'ordre d'insertion Ordre d'insertion Élément de campagne	Impressions Groupe d'annonces YouTube Revenus (USD) Engagements (YouTube) Revenus (devise du partenaire) Revenus (devise de l'annonceur) TrueView: vues
   adgroup_insights_by_adtype	Date ID du groupe d'annonces YouTube Type d'annonce YouTube ID de l'élément de campagne ID du partenaire Partenaire Devise du partenaire Référence annonceur Annonceur Devise de l'annonceur ID de l'ordre d'insertion Ordre d'insertion Élément de campagne	Impressions Clics Groupe d'annonces YouTube Revenus (USD) Engagements (YouTube) Revenus (devise du partenaire) Revenus (devise de l'annonceur) TrueView: vues
   ad_insights	Date Identifiant de l'annonce YouTube ID de l'élément de campagne ID du partenaire Partenaire Devise du partenaire Référence annonceur Annonceur AdvertiserCurrency ID de l'ordre d'insertion Ordre d'insertion Élément de campagne ID du groupe d'annonces YouTube Groupe d'annonces YouTube Annonce YouTube	Impressions Clics Revenus (USD) Engagements (YouTube) Revenus (devise du partenaire) Revenus (AdvCurrency) TrueView: vues

5. Configurez le calendrier et renseignez les données historiques. Veillez à utiliser le même lien BigQuery que celui configuré à l'étape 1, ainsi que le préfixe de table exactement comme indiqué dans le tableau précédent. Pour en savoir plus, consultez la section Remarques supplémentaires.

6. • Déclenchez manuellement une exécution de remplissage ou attendez le début de l'exportation planifiée. Dans les deux cas, vos données sont automatiquement placées dans l'ensemble de données brut configuré pour votre association à BigQuery.

Informations complémentaires

Concernant la sélection du fuseau horaire:

• Pour certains types de rapports, vous pouvez choisir le fuseau horaire de l'annonceur ou le fuseau horaire UTC pour les dates au moment de configurer l'exportation. Toutefois, les rapports liés à YouTube ne sont compatibles qu'avec le fuseau horaire de l'annonceur. Veillez donc à sélectionner le fuseau horaire Advertiser (Annonceur) lorsque vous configurez les exportations.

• Comme l'exportation du rapport est pré-agrégée au niveau quotidien, Cortex Framework utilise directement la date fournie, sans conversion de fuseau horaire. Vous êtes responsable de l'interprétation des informations sur le fuseau horaire.

À propos de la planification et du remplissage des données de l'historique:

• Nous vous recommandons de sélectionner la plage de dates 7 derniers jours et la fréquence d'exportation Quotidienne. Vous devez sélectionner une plage de dates d'exportation et une fréquence d'exportation pour trouver le juste équilibre entre la précision des données et les coûts de stockage, même si n'importe quel paramètre fonctionne avec notre processus CDC.

• Les rapports instantanés permettent d'exporter jusqu'à 14 jours de données lorsque vous exportez vers BigQuery. Toutefois, DV360 peut parfois apporter des mises à jour mineures aux données, jusqu'à 31 jours après la date du rapport. Si vous configurez l'exportation pour plusieurs annonceurs, la date de chaque annonceur sera indiquée dans son propre fuseau horaire.

• Si des données historiques sont requises, en tant qu'opérations ponctuelles non planifiées, Instant Reporting permet d'exporter jusqu'à deux ans de données directement dans des tables BigQuery. Veillez à le faire au moins une fois, manuellement depuis l'interface utilisateur de DV360.

Fraîcheur des données et délai

En règle générale, la fraîcheur des données pour les sources de données Cortex Framework est limitée par ce que la connexion en amont permet, ainsi que par la fréquence d'exécution de votre DAG. Ajustez la fréquence d'exécution de votre DAG pour l'aligner sur la fréquence en amont, les contraintes de ressources et vos besoins métier.

Avec les rapports instantanés DV360, la fraîcheur des données dépend de la fréquence d'exportation définie lors de la configuration de l'exportation BigQuery, qui peut être quotidienne, hebdomadaire ou mensuelle.

Configurations

Cette section décrit les configurations du traitement des données.

Connexions Cloud Composer

Créez les connexions suivantes dans Cloud Composer. Pour en savoir plus, consultez la documentation Cloud Composer.

Nom de la connexion	Purpose
dv360_cdc_bq	Pour "Ensemble de données brut" > "Transfert d'ensemble de données CDC".
dv360_reporting_bq	Pour le transfert d'un ensemble de données CDC vers un ensemble de données de reporting.

Schéma de table brut vers CDC

Le répertoire src/DV360/config/table_schema contient un fichier de schéma par ensemble de tables (identifié par le même préfixe), qui est exporté depuis DV360. Chaque fichier de schéma contient deux colonnes: ColumnName et ColumnDataType.

Remarque :Si votre cas d'utilisation incluait des colonnes supplémentaires dans l'exportation Instant Reporting, veillez également à les inclure dans les fichiers de schéma correspondants.

Paramètres d'ingestion

Le fichier src/DV360/config/ingestion_settings.yaml contient d'autres paramètres qui contrôlent les pipelines de données Source vers CDC.

Source des tables CDC

Cette section contient des entrées qui contrôlent la façon dont les tables exportées DV360 sont ingérées et le comportement du processus CDC pertinent. Chaque entrée correspond à un rapport Instant Reporting, identifié par un préfixe d'exportation.

Les paramètres suivants contrôlent les paramètres de Source to CDC pour chaque entrée:

Paramètre	Description
base_table	Table de l'ensemble de données CDC dans laquelle les données brutes après la transformation CDC sont stockées (par exemple, customer).
load_frequency	Fréquence d'exécution d'un DAG pour cette entité afin de renseigner la table CDC. Pour en savoir plus sur les valeurs possibles, consultez la documentation Airflow.
raw_table_prefix	Préfixe utilisé par le rapport Instant Reporting correspondant pour configurer cette exportation BigQuery.
row_identifiers	Colonnes (séparées par une virgule) qui forment un enregistrement unique pour cette table.
partition_details	Facultatif:indiquez si vous souhaitez que ce tableau soit partitionné pour des raisons de performances. Pour en savoir plus, consultez la section Partitionnement de table.
cluster_details	Facultatif:Si vous souhaitez que cette table soit regroupée pour des raisons de performances, consultez la section Paramètres de cluster.

Paramètres de création de rapports

Vous pouvez configurer et contrôler la manière dont Cortex Framework génère des données pour la couche de reporting finale DV360 à l'aide du fichier de paramètres de reporting src/DV360/config/reporting_settings.yaml. Ce fichier contrôle la génération des objets BigQuery de la couche de reporting (tables, vues,fonctions ou procédures stockées).

Pour en savoir plus, consultez Personnaliser le fichier de paramètres de création de rapports.

Étape suivante

• Pour en savoir plus sur les autres sources de données et charges de travail, consultez la page Sources de données et charges de travail.
• Pour en savoir plus sur les étapes de déploiement dans les environnements de production, consultez la section Conditions préalables au déploiement de Cortex Framework Data Foundation.