Show Menu
SUJETS×

Fichiers de données pour les rapports d’optimisation d’audience et les fichiers journaux utilisables

Un fichier de données contient des données d’impression, de clic ou de conversion. Une fois formatées correctement, vous pouvez importer ces données dans Audience Manager pour les afficher dans les rapports Optimisation de l’ audience et créer des caractéristiques à l’aide des données via des fichiers journaux exploitables. Formatez vos fichiers de données en fonction de ces spécifications dans cette section.

Aperçu

Un fichier de données correctement nommé et formaté vous permet d’importer des données d’impression, de clic ou de conversion dans les rapports Optimisation de l’ audience. Cela s’avère utile lorsque vous travaillez avec un partenaire qui n’est pas intégré Audience Manager et que vous souhaitez utiliser les données qu’il contient dans cette suite de rapports. Ce processus nécessite des fichiers distincts pour les données d’impression, de clic et de conversion. Ne mélangez pas ces événements dans un seul fichier.
Un fichier de données doit être accompagné d’un fichier de métadonnées. Le contenu du fichier de métadonnées correspond aux informations du fichier de données et aux libellés connexes, lisibles par des personnes, des menus de rapport. Pour plus d’informations, voir Aperçu et mappages pour les fichiers de métadonnées.

Conventions de dénomination des fichiers de données

La syntaxe suivante définit la structure d’un nom de fichier de données bien formé. Remarque : l’italique indique un espace réservé de variable qui change en fonction du contenu du fichier.
Syntaxe :
typed’événement_

yyyymmdd

Dans un nom de fichier :
  • Le type d’événement indique que le fichier contient des impressions, des clics ou des conversions. Créez un fichier distinct pour chaque type d’événement.
  • Un trait de soulignement sépare le type d’événement d’un horodatage annuel.
  • Avant de télécharger, compressez vos fichiers à l’aide de gzip et enregistrez-les avec l’extension de .gz fichier.
Compte tenu de ces exigences, nommez vos fichiers de données en fonction de leur contenu comme suit :
  • Données d’impression :
    impressions_
    
    yyyyymmd.gz
    
    
  • Données de clic :
    clicks_
    
    yyyyyymmd.gz
    
    
  • Données de conversion :
    conversions_
    
    yyyyymmd.gz
    
    

Format de contenu pour les fichiers de données

La syntaxe suivante définit la structure du contenu dans un fichier de données bien formé. Remarque : l’italique indique un espace réservé de variable et est remplacé par un libellé dans un fichier de données réel.
Syntaxe :
libellé d’en-tête 1 | 

étiquette d'en-tête 2 ... Libellé d’ 

en-tête n | 

version

Dans le contenu du fichier :
  • Les libellés d’en-tête doivent apparaître dans l’ordre indiqué dans le tableau ci-dessous. Les impressions et les clics utilisent les mêmes libellés. Les fichiers de conversion contiennent des en-têtes supplémentaires.
  • Si vous n’avez pas de données pour une colonne particulière, renseignez ce champ avec une -1 .
  • Les fichiers doivent se terminer par un numéro de version. La version actuelle est 1.1.
  • Séparez les en-têtes de fichier et le contenu avec le caractère ASCII 001 non imprimable. Si vous ne pouvez pas utiliser ASCII 001, séparez les en-têtes et les données par un délimiteur de tabulation. Comme il s’agit de caractères non imprimables, l’exemple de syntaxe ci-dessus montre une barre verticale "|" à des fins d’affichage uniquement.
Libellés de champ
Le tableau ci-dessous répertorie et décrit les en-têtes de colonne de votre fichier de données. Les en-têtes sont sensibles à la casse et doivent s’afficher comme indiqué dans le tableau. Tous les types de données sont des entiers (INT), sauf indication contraire.
Étiquette Description
Horodatage
Date et heure UTC pour l’événement d’impression, de clic ou de conversion. Utilisez le yyyy-MM-dd HH:mm:ss format.
User-ID
Votre identifiant pour un visiteur du site, également appelé ID utilisateur unique du fournisseur de données ou DPUUID.
Advertiser-ID
ID de source de données ou code d’intégration pour votre annonceur.
BU-ID
ID de l'unité opérationnelle.
Campaign-ID
ID de campagne.
Creative-ID
ID d’élément créatif.
Site-ID
ID du site.
Placement-ID
Identifiant de placement numérique du serveur d’annonces.
Insertion-Ordre-ID
ID de l’ordre d’insertion.
Tactique-ID
ID tactique.
Vertical-ID
ID d’un secteur industriel vertical ou d’une catégorie.
Quantité
Nombre d’éléments vendus dans un événement de conversion.
Pour les fichiers de données de conversion uniquement.
Recettes
Achat ou autre montant de conversion. Type de données : Flottant.
Pour les fichiers de données de conversion uniquement.
Autres données
URL de la page d’entrée de conversion. Type de données : chaîne.
Pour les fichiers de données de conversion uniquement.
Event-Type
Type de conversion. Indique si une conversion correspond ou non. Les options incluent :
  • 0 : Impression
  • 1 : Cliquez sur
  • -1 : Non attribué ou inconnu
Pour les fichiers de données de conversion uniquement.
Version
Numéro de version requis qui apparaît à la fin de chaque ligne dans un fichier de données d’impression, de clic ou de conversion. La version actuelle est 1.1.

Méthodes de remise des fichiers de données

Téléchargez vos fichiers de données d’impression, de clic ou de conversion vers un répertoire Amazon S3 pour votre Audience Manager compte. Reportez-vous à cette section pour plus d’informations sur les chemins de remise/répertoire, les délais de traitement des fichiers et les mises à jour.
Contactez votre conseiller Audience Manager ou le service à la clientèle pour commencer à configurer un Amazon S3 répertoire pour vos fichiers de données.
Syntaxe du chemin de remise et exemples
Les données sont stockées dans un espace de noms distinct pour chaque client dans un Amazon S3 répertoire. Le chemin d’accès au fichier suit la syntaxe illustrée ci-dessous. Note, italics indicates a variable placeholder. Les autres éléments sont des constantes ou des clés et ne changent pas.
Syntaxe :
.../log_ingestion/pid= ID 

AAM/dpid= 

d_src/logs/ type 

defichier_

yyyymmdd

Le tableau suivant définit chacun de ces éléments dans un chemin de remise de fichier.
Paramètre de fichier Description
.../log_ingestion/
Il s’agit du début du chemin de stockage du répertoire. Vous recevrez le chemin complet lorsque tout sera configuré.
pid= AAM ID
Cette paire clé-valeur contient votre ID de client Audience Manager .
dpid= d_src
Cette paire clé-valeur contient l’ID de source de données transmis lors d’un appel d’événement. Il identifie l’agence dont proviennent les données et les associe à un fichier de métadonnées.
logs
Répertoire de niveau supérieur pour les fichiers de données.
file type _ yyyymmdd
Nom de type de fichier qui indique le type de données qu’il contient et un horodatage de remise.
Exemple de chemin de téléchargement et nom de fichier
Lorsque vous téléchargez un fichier, le chemin d’accès se présente comme suit :
.../log_ingestion/pid=1234/dpid=567/logs/impressions_20150902
Heures et mises à jour de traitement des fichiers
Les fichiers de données sont traités quatre fois par jour, à intervalles réguliers.
Pour mettre à jour vos données, envoyez un fichier contenant toutes les impressions, les clics ou les conversions pour un jour donné. Dans ce cas, un jour correspond à la période de 24 heures qui s’étend d’un minuit à l’autre. En règle générale, vous pouvez utiliser l’heure UTC pour définir l’intervalle de jour.

Étapes suivantes

Vérifiez les conditions requises pour nommer et créer des fichiers de métadonnées. Pour commencer, voir Aperçu et mappages pour les fichiers de métadonnées.