Les fichiers de rapport sur le transfert de données fournissent des données non cumulées, au niveau de l'événement, qui proviennent de vos campagnes publicitaires. Ces données correspondent essentiellement à des contenus bruts issus des journaux des ad servers Ad Manager, avec un fichier distinct généré pour chaque type d'événement. Les fichiers de transfert de données contiennent des données sur l'événement exactes à la seconde près. Vous pouvez choisir d'y inclure d'autres informations à propos de l'événement, y compris le type d'appareil et la zone géographique. Les partenaires doivent approuver les blocs d'annonces dans Ad Manager pour qu'ils s'affichent dans leurs fichiers de transfert de données.
Commencer
Les fichiers de rapport sur le transfert de données entraînent des frais supplémentaires. Pour commencer, vous devez d'abord activer le transfert de données sous Fonctionnalités avancées. Vous pouvez également consulter les détails des prix sur cette page. Notez que l'activation du transfert de données via les fonctionnalités avancées nécessite des autorisations d'administrateur.
Avez-vous déjà activé le transfert de données ? Pour les réseaux qui ont déjà activé le transfert de données en dehors des fonctionnalités avancées via un avenant hors connexion, veuillez noter les informations suivantes :
- Vous devrez accepter à nouveau les conditions d'utilisation des fonctionnalités avancées, comme indiqué dans les étapes suivantes. Si vous activez le transfert de données via les fonctionnalités avancées, l'avenant hors connexion sera annulé. Si vous avez des questions, contactez votre responsable de compte.
- Tous les réseaux 360 gérés précédemment activés devront contacter leur responsable de compte pour obtenir de l'aide afin d'activer le transfert de données via les fonctionnalités avancées.
Pour en savoir plus, contactez votre responsable de compte.
Activer les rapports sur les transferts de données
Si votre organisation n'est pas en mesure de gérer le traitement ETL (extraire, transformer, charger) ni les fichiers volumineux, de manipuler des fichiers texte, de concevoir et de gérer un magasin de données de taille moyenne ni de créer et d'insérer des scripts, il peut être préférable de faire appel à un partenaire Google Marketing Platform approuvé.
- Connectez-vous à Google Ad Manager.
- Accédez à Administrateur, puis à Fonctionnalités avancées.
- Sous "Fonctionnalité", recherchez "Rapports sur les transferts de données".
- Sous "Tarif", consultez les informations tarifaires concernant les rapports sur les transferts de données.
- Pour activer les rapports sur les transferts de données, sous "État", activez
, puis lisez et acceptez les conditions d'utilisation.
, puis lisez et acceptez les conditions d'utilisation. Une fois la fonctionnalité activée, vous pouvez configurer les transferts de données. Google Ad Manager propose deux types de fichiers de sortie pour le transfert de données : CSV et Parquet.
Fichiers de rapport disponibles sur le transfert de données
Chaque fichier de transfert de données contient des informations sur des événements spécifiques. Vous pouvez ajouter des champs dans chaque type de fichier afin d'obtenir des informations contextuelles à propos de ces événements.
Backfill correspondant existe, le fichier Network n'inclut pas les impressions générées dans Ad Exchange ou AdSense via l'allocation dynamique. Pour obtenir des informations sur ces impressions, consultez le fichier Backfill.À propos des informations incluses dans les fichiers de transfert de données
- Données consignées tardivement
Un délai de quinze heures est normal, mais il arrive que le traitement des fichiers de transfert de données soit plus long que d'habitude. Les données consignées tardivement seront incluses dans le fichier groupé horaire suivant, et porteront les informations d'horodatage correctes. Ainsi, en cas de retard dans le traitement des données, un fichier d'une heure donnée pourra comporter quelques horodatages antérieurs. -
Heures au cours desquelles aucune activité n'est enregistrée
Si aucune activité n'est enregistrée pendant une heure spécifique, un fichier de transfert de données qui ne contient que des données d'en-tête est publié. - Délimitation d'une date et d'une journée
En règle générale, le premier fichier horaire pour un jour donné contient les événements survenus entre minuit et 1h (heure du Pacifique). Cependant, les événements sont horodatés en fonction du fuseau horaire du réseau de l'éditeur. Imaginons que le fuseau horaire du réseau de l'éditeur soit défini sur l'heure de la côte Est des États-Unis. Le premier fichier horaire contiendra des événements ayant eu lieu entre 3h et 4h du matin, les trois heures précédentes étant consignées dans le fichier de la veille. En conséquence, certains horodatages peuvent présenter une date différente de celle indiquée dans le nom de fichier. Reportez-vous toujours à l'horodatage des événements contenus dans le fichier, et non à l'heure de publication ni au nom du fichier. - Rapports sur les créations maître/associées dans le transfert de données
Les fichiers de transfert de données contiennent les impressions de créations maîtres et associées, mais l'éditeur de requêtes ne comptabilise qu'une impression pour l'ensemble de créations maître/associées (et non une impression pour chaque création), à moins que les informations ne soient ventilées par créations maître/associées.
IsCompanionest défini sur "TRUE" pour les impressions de créations associées. Le champCreativeIdcontient les différents ID des créations maîtres et associées, et non l'ID de l'ensemble de créations. Aucun champ supplémentaire permettant de mettre en correspondance des impressions associées avec des impressions maîtres n'est disponible pour l'ID de l'ensemble de créations dans le transfert de données. - Écarts avec les rapports Ad Manager
Les données sur le trafic de mauvaise qualité ou le spam sont régulièrement supprimées des rapports Ad Manager ou de ceux générés par l'API. En raison du calendrier de publication des fichiers de transfert de données, certaines de ces données peuvent ne pas être supprimées. Par conséquent, il se peut que les fichiers de transfert de données indiquent des chiffres légèrement plus élevés pour ce qui concerne les impressions, les clics ou d'autres événements. Lorsque des écarts se produisent, ils se situent généralement autour de 1 %.Il peut arriver que les fichiers de transfert de données
CodeServesindiquent une valeur supérieure par rapport au nombre de diffusions du code dans les rapports Ad Manager. En effet, une diffusion de code est comptabilisée pour chaque impression générée avec le transfert de données, contre une diffusion de code par demande avec les rapports. Or, certains formats de création, tels que les annonces textuelles Google Ads, peuvent enregistrer plusieurs impressions pour une même demande. Pour comparer les impressions uniques, vous devez donc regrouper les fichiers de transfert de données en fonction des valeurs des champsKeyPart.Notez que les fichiers de transfert de données "Demandes" et "Impressions" peuvent indiquer une valeur inférieure à celle de la métrique "Impressions inachevées" dans les rapports Ad Manager. En effet, le transfert de données ne comptabilise que les demandes d'annonces sans correspondance, tandis que les rapports comptabilisent à la fois les demandes d'annonces sans correspondance et les demandes de médiation sans correspondance. Le nombre d'impressions inachevées dans le transfert de données correspondra plus précisément à la métrique "Nombre total de demandes d'annonces sans correspondance" dans les rapports.
Les fichiersNetworkBackfillBidsJoinablecontiennent les enchères des annonces avec tag géré par le réseau. Ces enchères ont une valeur BidSourceType de 4 et ne figurent pas dans les rapports Google Ad Manager. ExcluezBidSourceType = 4lorsque vous comparez les totaux d'enchères entre le transfert de données et les rapports Google Ad Manager.
Avantages et inconvénients des formats de sortie CSV et Parquet
| CSV (valeurs séparées par une virgule) | Parquet (stockage en colonnes) | |
|---|---|---|
| Lisibilité et accessibilité | Très lisible par l'humain. Peut être facilement ouvert et modifié avec des éditeurs de texte ou des tableurs de base. | Nécessite des outils spécialisés pour l'affichage et la modification. Pas aussi facilement accessible pour les utilisateurs non initiés. |
| Universalité et compatibilité | Compatible avec pratiquement tous les outils d'analyse et de traitement des données. | Des bibliothèques ou des logiciels supplémentaires peuvent être nécessaires pour assurer une compatibilité totale, en particulier sur les anciens systèmes. |
| Simplicité et facilité d'utilisation | Structure simple, facile à comprendre et à utiliser, en particulier pour les plus petits ensembles de données ou les analyses ponctuelles rapides. | Peut être plus complexe à implémenter au départ, en particulier pour les utilisateurs non habitués au stockage en colonnes. |
| Performances et efficacité | Peut être plus lent pour les grands ensembles de données en raison du stockage basé sur des lignes et de l'absence de compression. | Offre des performances supérieures pour le traitement et l'analyse des données à grande échelle grâce au stockage en colonnes et à des techniques de compression efficaces. |
| Efficacité du stockage | Moins efficace en termes de stockage en raison de l'absence de compression intégrée et du risque de redondances dans le stockage de données. | Très efficace en termes de stockage grâce au stockage en colonnes et aux algorithmes de compression avancés, ce qui réduit les coûts de stockage. Les fichiers Parquet peuvent être 50 à 75 % plus petits que les fichiers CSV, en particulier pour les ensembles de données volumineux. |
Si le transfert de données au format CSV est déjà activé pour votre compte, contactez votre responsable de compte pour accéder au format Parquet.
Télécharger un exemple de fichier
Vous pouvez télécharger ces exemples de fichiers au format CSV ou Parquet pour prévisualiser les données et les champs de chacun de vos fichiers de rapport sur le transfert de données.
| Type d'événement | Nom et type de fichier | Informations incluses | Exemple de fichier |
|---|---|---|---|
| Enchère à joindre | NetworkBackfillBidsJoinable |
Informations sur les enchères. Possibilité de les joindre à d'autres fichiers de transfert de données. Une fois par heure |
|
| Diffusion de code | NetworkCodeServes |
Enregistre chaque réponse, téléchargée ou non, provenant d'Ad Manager. Deux fois par heure. Remarque : Les fichiers Request et CodeServe sont inclus dans le fichier Impression sans frais supplémentaires. |
|
| Impression | NetworkImpressions |
Informations sur les impressions téléchargées. Deux fois par heure. |
|
| Requête | NetworkRequests |
Enregistre chaque demande d'annonce, satisfaite ou non, reçue par Ad Manager. Deux fois par heure. Remarque : Les fichiers Request et CodeServe sont inclus dans le fichier Impression sans frais supplémentaires. |
|
| Active View | NetworkActiveViews |
Informations sur les impressions éligibles Active View basées sur Ad Manager. Deux fois par heure. |
|
| Enchère | NetworkBackfillBids (Bêta) |
Informations sur les enchères Authorized Buyers et Open Bidding. Une fois par heure |
|
| Clic | NetworkClicks |
Informations sur les clics, y compris les clics après affichage pour TrueView Deux fois par heure. |
|
| Enchère gagnante minimale | NetworkMinimumBidToWin (Bêta) |
Indique l'enchère minimale nécessaire aux acheteurs pour remporter l'enchère lorsqu'au moins un élément de campagne invendu est en concurrence. Une fois par heure |
|
| Conversion rich media | NetworkRichMediaConversions |
Informations sur les événements Studio, y compris les actions standards et personnalisées ("j'aime", lecture, pause, etc.), la durée des actions, etc. Deux fois par heure. |
|
| Conversion vidéo | NetworkVideoConversions |
Informations sur les événements spécifiques aux vidéos, y compris les actions ("j'aime", lecture, pause, etc.), les Content ID, le positionnement des séries d'annonces, etc. Consultez tous les événements vidéo. Deux fois par heure. |
Mise à disposition des fichiers
Les fichiers de transfert de données sont transmis toutes les heures dans des ensembles de données Ad Manager stockées dans le cloud. Nous vous recommandons de vérifier régulièrement la disponibilité des mises à jour. En règle générale, les données sont disponibles entre 5 et 15 heures après l'heure enregistrée. Ce délai peut néanmoins être allongé jusqu'à 8 jours pour certains événements différés. Ad Manager ne communique pas d'informations sur le transfert de données aux serveurs tiers.
Les noms de fichier mentionnent l'heure de début des événements, selon le fuseau horaire de la côte Pacifique des États-Unis (qui tient compte des changements d'heure saisonniers). Or, les informations d'horodatage présentes dans ce fichier sont toujours exprimées en fonction du fuseau horaire du réseau Ad Manager (lequel n'applique pas nécessairement les changements d'heure saisonniers). Résultat : certains fichiers peuvent être vides ou ignorés, ou peuvent contenir des données couvrant plusieurs heures, selon l'interaction entre ces paramètres de fuseau horaire.
Par contre, l'ensemble des données sur les impressions sont envoyées lors d'un changement d'heure saisonnier.
Noms des fichiers
Les noms des fichiers de transfert de données respectent une convention établie :
- CSV :
[Type]_[Network ID]_[YYYYMMDD]_[HH].gz - Parquet : les données sont fournies dans un dossier nommé
[Type]_[Network ID]_[YYYYMMDD]_[HH]/contenant des fichiers partitionnés nommés[Type]_[Network ID]_[YYYYMMDD]_[HH]-[Partition Index]-of-[Total Number of Partitions].parquet
YYYYMMDDcorrespond à l'année, au mois et au jour.HHcorrespond à l'heure de début, au format 24 heures.Le nombre correspondant aux heures (par exemple, 01, 02, 03) qui est spécifié dans chaque nom de fichier dépend du fuseau horaire "Pacifique". Toutefois, les éditeurs extraient leurs données réseau propres à un fuseau horaire à partir des horodatages contenus dans les fichiers de transfert de données. Tenez compte de cette différence lorsque vous calculez le délai de diffusion des fichiers.
[Partition Index]partition du fichier par rapport au nombre total de fichiers (partitions) créés, à partir de zéro[Total Number of Partitions]nombre de fichiers (partitions) utilisés pour créer le fichier
Pour le format Parquet, nous créons un dossier "_corrected" et plaçons les fichiers "_corrected" dans ce dossier.
Fichiers de transfert de données dans le processus de demande d'annonce
Consultez le graphique suivant pour comprendre les types de fichiers de transfert de données associés aux différentes étapes du processus de demande d'annonce.
Utiliser les fichiers de rapport sur le transfert de données
Une fois le transfert de données configuré, les fichiers sont conservés dans des ensembles de données Ad Manager stockées dans le cloud. Vous pouvez y accéder sur le Web, ou via un outil de ligne de commande ou une API. En savoir plus sur l'accès aux ensembles de données Ad Manager stockées dans le cloud
Si vous tenez compte de l'heure de début mentionnée dans le nom des fichiers de transfert de données pour limiter l'ingestion et l'analyse des données à un ensemble de fichiers spécifique, vous risquez de manquer des données fournies dans un fichier ultérieur (à cause des changements d'heure saisonniers, d'un retard dans la collecte des données ou pour d'autres motifs similaires). La meilleure approche consiste à lire tous les fichiers de transfert de données dans un système distinct (un entrepôt de données ou un moteur de requêtes, par exemple) et à limiter ensuite votre analyse en fonction de l'horodatage des événements.
Les fichiers de transfert de données sont disponibles en deux formats : CSV ou Parquet.
Les utilisateurs peuvent choisir des sorties au format CSV, Parquet ou les deux pour chaque fichier. Parquet est le format optimal pour l'ingestion et les cas d'utilisation liés aux entrepôts de données, tandis que les fichiers CSV peuvent être utilisés dans un tableur en fonction de la taille du fichier. Voici quelques exemples classiques d'utilisation des informations de transfert de données :
- Regroupement par dimension des événements et des activités des utilisateurs (par exemple, regroupement par création)
- Mise en correspondance des utilisateurs avec une base de données de clients
- Création de rapports sur les données géographiques et démographiques des utilisateurs
Vous pouvez utiliser des tableaux de correspondance pour relier les noms et les ID des valeurs contenues dans les fichiers de transfert de données. Cela vous permet d'établir des correspondances entre les informations relatives à la diffusion des annonces (telles que les blocs d'annonces ou les éléments de campagne) et les valeurs préattribuées stockées dans la base de données.
Stocker les fichiers en local
En règle générale, considérez que chaque événement utilisera entre 25 et 35 octets dans un fichier compressé. Ainsi, 10 millions d'impressions nécessiteront environ 300 Mo d'espace disque dans un fichier CSV compressé. Les tailles de fichiers devraient être plus petites avec le format de sortie Parquet. N'oubliez pas qu'il s'agit là d'estimations et que la taille de votre fichier peut être plus importante. De même, puisque nous parlons ici de données compressées, vous aurez besoin d'espace supplémentaire pour décompresser et utiliser les fichiers.
Les fichiers de transfert de données générés il y a plus de 60 jours sont définitivement supprimés de Ad Manager. Si vous souhaitez conserver vos fichiers pour une durée supérieure, nous vous recommandons de les stocker en local ou via une solution de stockage permanent dans le cloud, par exemple en créant un compte Google Cloud Storage indépendant sur lequel vous disposez d'un contrôle total.
Découvrir le Service de transfert de données BigQuery
Faciliter le traitement des fichiers de transfert de données volumineux
Le kit Open Source CRUSH (Custom Reporting Utilities for Shell) publié par Google Code permet de traiter des données au format texte délimité à partir de la ligne de commande ou dans des scripts shell. Les outils CRUSH ont été développés et testés avec soin, et leurs performances s'avèrent optimales sur les systèmes d'exploitation Linux et Unix. Pour obtenir de l'aide sur l'utilisation de CRUSH, contactez la communauté Open Source.
Il existe une autre solution non Open Source, développée par Syncsort : le logiciel d'intégration de données DMX.