Planifier un transfert Display & Video 360

Le connecteur du service de transfert BigQuery pour Display & Video 360 vous permet de programmer et de gérer automatiquement les jobs de chargement récurrents pour les données de rapport et de configuration Display & Video 360.

Rapports acceptés

Le service de transfert de données BigQuery pour Display & Video 360 accepte l'option de reporting suivante :

Pour en savoir plus sur la transformation des rapports Display & Video 360 en tables et vues BigQuery, consultez la page Transformation des données Display & Video 360.

Display & Video 360 conserve les fichiers de transfert de données pendant 60 jours au maximum.

Option de création de rapports Assistance
Fréquence de répétition

Tous les jours, à l'heure où le transfert a été créé (par défaut)

Vous pouvez configurer une heure spécifique.
Intervalle d'actualisation

Les deux derniers jours

Non configurable
Durée maximale du backfill

Les 60 derniers jours

Données de configuration acceptées

Outre les données de rapport, le service de transfert de données BigQuery transfère également les données de configuration suivantes à partir de Display & Video 360. Les données de configuration sont extraites de l'API Display & Video 360 v3.

Pour en savoir plus sur chaque type de données de configuration, consultez les liens suivants :

Ingestion de données à partir de transferts Display & Video 360

Lorsque vous transférez des données de Display & Video 360 vers BigQuery, elles sont chargées dans des tables BigQuery partitionnées par date. La partition de la table dans laquelle les données sont chargées correspond à la date de la source de données. Si vous planifiez plusieurs transferts pour la même date, le service de transfert de données BigQuery remplace la partition de cette date spécifique par les données les plus récentes. Plusieurs transferts le même jour ou l'exécution de remplissages n'entraînent pas de données en double, et les partitions des autres dates ne sont pas affectées.

Actualiser les fenêtres

Un intervalle d'actualisation correspond au nombre de jours pendant lesquels un transfert de données récupère des données lors d'un transfert de données. Par exemple, si la fenêtre d'actualisation est de trois jours et qu'un transfert quotidien a lieu, le service de transfert de données BigQuery récupère toutes les données de votre table source des trois derniers jours. Dans cet exemple, lorsqu'un transfert quotidien a lieu, le service de transfert de données BigQuery crée une partition de table de destination BigQuery avec une copie des données de votre table source du jour, puis déclenche automatiquement des exécutions de remplissage pour mettre à jour les partitions de table de destination BigQuery avec les données de votre table source des deux jours précédents. Les opérations de remplissage déclenchées automatiquement écrasent ou mettent à jour de manière incrémentielle votre table de destination BigQuery, selon que les mises à jour incrémentielles sont ou non compatibles avec le connecteur du service de transfert de données BigQuery.

Lorsque vous exécutez un transfert de données pour la première fois, celui-ci récupère toutes les données sources disponibles pendant l'intervalle d'actualisation. Par exemple, si la fenêtre d'actualisation est de trois jours et que vous exécutez le transfert de données pour la première fois, le service de transfert de données BigQuery récupère toutes les données sources dans un délai de trois jours.

Les fenêtres d'actualisation sont mappées sur le champ d'API TransferConfig.data_refresh_window_days.

Pour récupérer des données en dehors de la période d'actualisation, telles que des données historiques, ou pour récupérer des données en cas d'indisponibilité ou d'écarts de transfert, vous pouvez lancer ou planifier une exécution de remplissage.

Avant de commencer

Avant de créer un transfert Display & Video 360, consultez les conditions préalables et les informations suivantes.

Prérequis

  • Vérifiez que vous avez effectué toutes les actions requises pour activer le service de transfert de données BigQuery.
  • Créez un ensemble de données BigQuery pour stocker vos données Display & Video 360.
  • Assurez-vous de disposer de votre ID de partenaire ou de votre référence annonceur Display & Video 360. L'ID du partenaire est le parent dans la hiérarchie.
  • Vérifiez que vous disposez d'autorisations de lecture pour accéder aux données des partenaires ou des annonceurs à partir de l'API Display & Video.

  • Assurez-vous que votre organisation a accès aux fichiers de transfert de données v2 (Display & Video 360 DTv2) de Display & Video 360. Ces fichiers sont transmis par l'équipe Display & Video 360 dans un bucket Cloud Storage. L'accès aux fichiers Display & Video 360 DTv2 varie selon que vous disposez ou non d'un contrat direct avec Display & Video 360. Dans un cas comme dans l'autre, des frais supplémentaires peuvent s'appliquer.

    • Si vous avez un contrat avec Display & Video 360, contactez l'assistance Display & Video 360 pour configurer les fichiers Display & Video 360 DTv2.
    • Si vous n'avez pas de contrat avec Display & Video 360, contactez votre agence pour accéder aux fichiers Display & Video 360 DTv2.
    • Une fois cette étape terminée, vous recevrez l'un des noms de buckets Cloud Storage suivants, selon que votre configuration est destinée à un partenaire ou à un annonceur :
      • gs://dcdt_-dbm_partnerPARTNER_ID
      • gs://dcdt_-dbm_advertiserADVERTISER_ID

  • Pour configurer des notifications d'exécution de transfert pour Pub/Sub, vous devez disposer des autorisations pubsub.topics.setIamPolicy. Pour en savoir plus, consultez la page Notifications d'exécution du service de transfert de données BigQuery.

Trouver votre ID Display & Video 360

Pour récupérer votre ID Display & Video 360, accédez à la page Buckets Cloud Storage de la console Google Cloud et examinez les fichiers figurant dans votre bucket Cloud Storage de transfert de données Display & Video 360. L'ID Display & Video 360 permet de mettre en correspondance les fichiers dans le bucket Cloud Storage fourni. L'ID est intégré au nom du fichier, et non au nom du bucket Cloud Storage. Exemple :

  • Dans un fichier nommé dbm_partner123_activity_*, l'ID est 123.
  • Dans un fichier nommé dbm_advertiser567_activity_*, l'ID est 567.

Trouver le préfixe du nom de fichier

Dans certains cas, les fichiers figurant dans votre bucket Cloud Storage peuvent avoir des noms personnalisés non standards, que l'équipe des services Google Marketing Platform a configurés à votre place. Exemple :

Dans un fichier nommé dbm_partner123456custom_activity_*, le préfixe est dbm_partner123456custom.

Pour obtenir de l'aide concernant les préfixes de noms de fichiers, contactez l'assistance Display & Video 360.

Configurer un transfert de données Display & Video 360

Sélectionnez l'une des options suivantes :

Console

  1. Accédez à la page "Transferts de données" dans la console Google Cloud.

    Accéder à la page Transferts de données

  2. Cliquez sur Créer un transfert.

  3. Sur la page Créer un transfert, procédez comme suit :

    • Dans le champ Source de la section Type de source, choisissez Display & Video 360.
    • Dans la section Nom de la configuration de transfert, sous Nom à afficher, saisissez le nom du transfert de données. Ce nom peut correspondre à toute valeur permettant d'identifier le transfert si vous devez le modifier ultérieurement.

  4. Dans la section Schedule options (Options de programmation) :

    • Sélectionnez Commencer ou Commencer à l'heure définie, puis indiquez une date de début et une heure d'exécution.
    • Pour le champ Repeats (Périodicité), choisissez une option pour la fréquence d'exécution du transfert de données. Si vous sélectionnez Jours, indiquez une heure valide au format UTC.
      • Heures
      • Jours
      • À la demande

  5. Dans le menu Ensemble de données de destination de la section Paramètres de destination, sélectionnez l'ensemble de données que vous avez créé pour stocker vos données.

  6. Dans la section Data source details (Détails de la source de données) :

    • Dans le champ Bucket Cloud Storage DV360 DTV2, saisissez le bucket Cloud Storage qui contient les fichiers DTv2 Display & Video 360. Si vous devez configurer ce bucket, contactez l'assistance Display & Video 360.
    • Dans le champ ID du partenaire/annonceur DV360, saisissez l'ID du partenaire ou l'ID de l'annonceur.
    • (Facultatif) Dans la section Options de notification :
      • Cliquez sur le bouton pour activer les notifications par e-mail. Lorsque vous activez cette option, l'administrateur de transfert reçoit une notification par e-mail en cas d'échec de l'exécution du transfert.
      • Cliquez sur le bouton pour activer les notifications Pub/Sub. Dans le champ Sélectionner un sujet Cloud Pub/Sub, choisissez le nom de votre sujet ou cliquez sur Créer un sujet. Cette option configure les notifications d'exécution Pub/Sub pour votre transfert.

  7. Cliquez sur Enregistrer.

bq

Saisissez la commande bq mk, puis spécifiez l'indicateur de création de transfert --transfer_config. Les options suivantes sont obligatoires :

  • --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

Où :

  • PROJECT_ID : ID de votre projet.
  • DATASET : ensemble de données cible de la configuration de transfert de données.
  • NAME : nom à afficher de la configuration de transfert de données. Ce nom peut correspondre à toute valeur permettant d'identifier le transfert si vous devez le modifier ultérieurement.
  • PARAMETERS : paramètres de la configuration de transfert de données créée au format JSON. Par exemple, --params='{"param":"param_value"}'. Pour les transferts Display & Video 360, les paramètres bucket et displayvideo_id sont obligatoires. Le paramètre file_name_prefix, qui est facultatif, n'est utilisé que pour les noms de fichiers rares et personnalisés.
  • DATA_SOURCE. La source de données – displayvideo.

Par exemple, la commande suivante crée un transfert de données Display & Video 360 nommé My Transfer avec l'ID Display & Video 360 123456, le bucket Cloud Storage dcdt_-dbm_partner123456 et l'ensemble de données cible mydataset.

Le transfert de données est créé dans le projet par défaut :

  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

Après avoir exécuté la commande, vous recevez un message de ce type :

[URL omitted] Please copy and paste the above URL into your web browser and follow the instructions to retrieve an authentication code.

Suivez les instructions du message et collez le code d'authentification sur la ligne de commande.

API

Utilisez la méthode projects.locations.transferConfigs.create et fournissez une instance de la ressource TransferConfig.

Interroger les données

Lorsque les données sont transférées vers BigQuery, elles sont écrites dans des tables partitionnées par date d'ingestion. Pour plus d'informations, consultez la page Présentation des tables partitionnées.

Nous vous recommandons d'interroger les vues générées automatiquement plutôt que d'interroger directement les tables. Toutefois, si vous souhaitez interroger directement vos tables, vous devez utiliser la pseudo-colonne _PARTITIONTIME dans votre requête. Pour en savoir plus, consultez la section Interroger des tables partitionnées.