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 | Support |
---|---|
Planification | 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 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.
- LineItem
- LineItemTargeting
- Campaign
- CampaignTargeting
- InsertionOrder
- InsertionOrderTargeting
- AdGroup
- AdGroupTargeting
- AdGroupAd
Pour en savoir plus sur chaque type de données de configuration, consultez les liens suivants :
- Créer un élément de campagne
- Créez une campagne.
- Créer un ordre d'insertion
- À propos des éléments de campagne YouTube et partenaires
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 est123
. - Dans un fichier nommé
dbm_advertiser567_activity_*
, l'ID est567
.
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
Accédez à la page "Transferts de données" dans la console Google Cloud.
Cliquez sur
Créer un transfert.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 un nom pour le transfert de données. Ce nom peut correspondre à toute valeur permettant d'identifier le transfert si vous devez le modifier ultérieurement.
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
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.
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.
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ètresbucket
etdisplayvideo_id
sont obligatoires. Le paramètrefile_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.