Planifier un transfert Display & Video 360

Le service de transfert de données 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 Support
Planification

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

Vous pouvez configurer l'heure de la journée.
Intervalle d'actualisation

Les deux derniers jours

Non configurable
Durée maximale du remplissage

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 :

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. Par 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. Par 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. Dans la console Google Cloud, accédez à la page BigQuery.

    Accéder à BigQuery

  2. Dans le menu de navigation de BigQuery, cliquez sur Transferts de données.

  3. Cliquez sur Créer un transfert.

  4. 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 – Preview.
    • Dans la section Nom de la configuration de transfert, sous Nom à afficher, saisissez le nom du transfert. Ce nom peut correspondre à toute valeur permettant d'identifier le transfert si vous devez le modifier ultérieurement.

  5. 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 l'une des options suivantes pour la fréquence d'exécution du transfert. Si vous sélectionnez Jours, indiquez une heure valide au format UTC.
      • Heures
      • Jours
      • À la demande

  6. 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.

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

    • Dans le champ d'ID Display & Video 360, saisissez l'ID du partenaire ou la référence 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.

  8. 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.
  • NAME : nom à afficher de la configuration de transfert. Ce nom peut correspondre à toute valeur permettant d'identifier le transfert si vous devez le modifier ultérieurement.
  • PARAMETERS correspond aux paramètres de la configuration de transfert 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 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 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.