Fichiers de données de classification

L’importateur vous permet de télécharger en vrac des données de classification dans des rapports d’analyse sous la forme d’un fichier. Pour que les chargements de données s’effectuent correctement, un format de fichier spécifique est requis pour l’importation.

Pour vous aider à créer des fichiers de données valides, vous pouvez télécharger un fichier de modèle qui fournit une structure de fichier dans laquelle vous pouvez coller les données de classification. Pour plus d’informations, reportez-vous à la section Télécharger le modèle de classifications.

Reportez-vous à la section Structure générale d’un fichier pour en savoir plus sur les limites de caractères dans les classifications.

Structure générale d’un fichier

La figure suivante illustre un exemple de fichier de données :

Un fichier de données doit respecter les règles de structure suivantes :

  • Les classifications ne peuvent pas contenir une valeur nulle (zéro).

  • Adobe recommande que vous limitiez à 30 le nombre de colonnes d’importation et d’exportation.

  • Les fichiers téléchargés doivent utiliser UTF-8 sans codage des caractères de nomenclature.

  • Des caractères spéciaux, tels que des tabulations, des sauts de lignes et des guillemets, peuvent être incorporés dans une cellule à condition que le format de fichier v2.1 soit spécifié et que la cellule soit correctement escaped. Les caractères spéciaux incluent :

    code language-text
    \t     tab character
    \r     form feed character
    \n    newline character
    "       double quote
    

    La virgule n’est pas un caractère spécial.

  • Les classifications ne peuvent pas contenir de caret (^) puisque ce caractère est utilisé pour indiquer une sous-classification.

  • Faites attention lorsque vous utilisez un trait d’union. Par exemple, si vous utilisez un trait d’union (-) dans un terme de réseau social, Social le considère comme un opérateur Not (signe moins). Si, par exemple, vous spécifiez le terme fragrance-free à l’aide de l’importation, Social reconnaît le terme comme étant fragrance minus free et rassemble les messages qui mentionnent fragrance, mais pas free.

  • Des limites de caractères sont appliquées afin de classer les données de rapport. Par exemple, si vous téléchargez un fichier texte de classification pour des produits ( s.products) dont les noms comportent plus de 100 caractères (octets), les produits en question ne sont pas affichés dans les rapports. Les codes de suivi et toutes les variables de conversions (eVars) autorisent 255 octets.

  • Il doit s’agir d’un fichier délimité par des tabulations (créez le fichier de modèle dans tout tableur ou éditeur de texte).

  • Il doit être doté de l’extension de fichier .tab ou .txt.

  • Le signe dièse (#) identifie la ligne comme commentaire utilisateur. Adobe ignore toutes les lignes commençant par #.

  • Deux signes dièse suivis des caractères SC (## SC) identifient la ligne comme commentaire d’en-tête de prétraitement utilisé par la création de rapports. Ne supprimez pas ces lignes.

  • Les exportations de classification peuvent comporter des clés en double en raison des caractères de saut de page de la clé. Dans une exportation FTP ou de navigateur, ce problème peut être résolu en activant la création de guillemets pour le compte FTP. Cette activation place des guillemets entourant chaque clé comportant des caractères de saut de page.

  • La cellule C1 de la première ligne du fichier d’importation comporte un identifiant de version qui détermine la façon dont les classifications traitent l’utilisation des guillemets dans le reste du fichier.

    • Le format v2.0 ignore les guillemets et présume qu’ils font tous partie des clés et valeurs indiquées. Étudions par exemple cette valeur : "C’est ""une valeur""". Le format v2.0 interprète cette valeur littéralement : "C’est ""une valeur""".
    • Le format v2.1 indique aux classifications de présumer que les guillemets font partie du formatage des fichiers utilisé dans les fichiers Excel. De ce fait, le format v2.1 formate l’exemple ci-dessus ainsi : C’est "une valeur".
    • Des problèmes peuvent survenir lorsque le format v2.1 est indiqué dans le fichier alors que c’est le format v2.0 qui est voulu - à savoir lorsque des guillemets sont utilisés de façon non autorisée au format Excel. Par exemple, si vous avez la valeur : "VP NO REPS" S/l Dress w/ Overlay. Avec le format v2.1, ce formatage est incorrect (la valeur devrait être entourée de guillemets ouvrant et fermant et les guillemets qui font partie de la valeur réelle devraient être codés par échappement par des guillemets) et les classifications ne fonctionneront pas au-delà de ce point.
    • Assurez-vous de procéder à l’une des opérations suivantes : modifiez le format du fichier sur v2.0 en modifiant l’en-tête (cellule C1) dans les fichiers que vous téléchargez OU implémentez correctement les guillemets Excel dans l’ensemble des fichiers.
  • La première ligne (qui ne soit pas un commentaire) du fichier de données contient les en-têtes de colonne utilisés pour identifier les données de classification contenues dans cette colonne. L’importateur nécessite un format spécifique pour les en-têtes de colonne. Pour en savoir plus, reportez-vous à la section Format d’en-tête de colonne.

  • Immédiatement sous la ligne d’en-tête d’un fichier de données se trouvent les lignes de données. Chacune d’elles doit contenir un champ de données pour chaque en-tête de colonne.

  • Le fichier de données prend en charge les codes de contrôle ci-dessous. Adobe les utilise pour fournir la structure au fichier et importer correctement les données de classification :

CODE DE CONTRÔLE
DESCRIPTION
<Nouvelle ligne>
Un caractère de nouvelle ligne est le seul délimiteur pris en charge entre les lignes de données/enregistrements dans le fichier de données. En règle générale, il suffit d’insérer spécifiquement ces caractères lors de l’écriture d’un programme pour générer automatiquement des fichiers de données.
~autogen~

Ce code demande à Adobe de générer automatiquement un ID unique pour cet élément.

Dans le cadre d’une campagne, cette valeur de contrôle demande à Adobe d’attribuer un identificateur à chaque élément créatif. Voir Clé.

~period~
Ce code indique que la colonne de données représente la période associée à l’élément. Voir Date.
Champ vide
Ce code représente une valeur NULL pour le champ actif. Utilisez-le si une colonne de données spécifique ne s’applique pas à l’enregistrement actif.
Modificateurs PER
Ce code indique que la colonne de données représente des champs de modificateur PER. Reportez-vous à la section En-têtes de modificateur PER.

Format d’un en-tête de colonne

NOTE
Adobe recommande que vous limitiez à 30 le nombre de colonnes d’importation et d’exportation.

Les fichiers de classification prennent en charge les en-têtes de colonne suivants :

Clé

Chaque valeur doit être unique dans l’ensemble du système. La valeur de ce champ correspond à une valeur attribuée à la variable Analytics dans la balise JavaScript du site web. Les données de cette colonne peuvent inclure autogen ou tout autre code de suivi unique.

En-tête de colonne de classification

NOTE
Les valeurs de l’en-tête de colonne de classification doivent respecter la convention d’affectation des noms de la classification, sinon l’importation échoue. Par exemple, si l’administrateur change Campagnes to Noms de campagne internes dans le Gestionnaire de configuration de campagne, l’en-tête de colonne du fichier doit être modifié pour correspondre. "Clé" est une valeur de classification réservée (en-tête). Les nouvelles classifications nommées "Clé" ne sont pas prises en charge.

De plus, le fichier de données prend en charge des conventions d’en-tête supplémentaires pour identifier les sous-classifications et d’autres colonnes de données spécialisées :

En-tête de sous-classification

Par exemple, Campaigns^Owner est l’en-tête de la colonne contenant les valeurs du propriétaire des campagnes. De même, Creative Elements^Size est l’en-tête de la colonne contenant la sous-classification de taille de la classification des éléments créatifs.

En-têtes de mesure de classification

Par exemple, Campaigns^~Cost fait référence à la mesure de coût de la classification des campagnes.

En-tête de modificateur PER

Les en-têtes Per Modifier sont signalés en ajoutant ~per à l’en-tête de mesure de classification. Par exemple, si l’en-tête de Metric est Campaigns^~Cost, l’en-tête de modificateur PER est Campaigns^~Cost~per. Adobe prend en charge les mots-clés PER Modifier suivants :

Ces caractères ont une signification spéciale dans un fichier de données. Lorsque cela est possible, évitez d’utiliser ces termes dans des données et des noms d’attributs.

FIXED : valeur fixe. N’effectuez aucune mise à l’échelle.

DAY : multiplier la valeur par le nombre de jours dans le rapport.

ORDER : multiplier la valeur par le nombre de commandes de l’article dans le rapport.

CHECKOUT : multiplier la valeur par le nombre de passages en caisse pour l’article dans le rapport.

UNIT : multiplier la valeur par le nombre d’unités de l’article dans le rapport.

REVENUE : multiplier la valeur par le montant des recettes de l’article dans le rapport.

SCADD : multiplier la valeur par le nombre de fois que l’événement d’ajout au panier d’achat a été appelé par article dans le rapport.

SCREMOVE : multiplier la valeur par le nombre de fois que l’événement de retrait du panier a été appelé par article dans le rapport.

INSTANCE : multiplier la valeur par le nombre d’instances de l’article dans le rapport.

CLICK : multiplier la valeur par le nombre de clics sur l’article dans le rapport.

EVENT : multiplier la valeur par le nombre de fois que l’événement personnalisé spécifié s’est produit par article dans le rapport.

Exemple  : si Campagne A a un coût de 10 000 euros, la colonne Campaigns^~Cost contient une valeur de 10 000 et la colonne Campaigns^Costper comporte le mot-clé FIXED. Lors de l’affichage du coût de la Campagne A dans les rapports, la somme de 10 000 euros est indiquée comme coût fixe de la Campagne A pour la période.

Exemple  : si Campagne B a un coût d’environ 2 euros par clic, la colonne Campaigns^~Cost contient 2 et la colonne Campaigns^Costper comporte le mot-clé CLICK. Lors de l’affichage du coût de la Campagne B dans les rapports, Adobe calcule (2 * [nombre de clics]) à la volée pour la période du rapport. Vous obtenez alors le coût total en fonction du nombre de clics enregistrés pendant la Campagne B.

Date

Les dates de campagne sont généralement des périodes (dates de début et de fin) associées à chaque campagne. Elles doivent apparaître au format AAAA/MM/JJ. Par exemple, 2013/06/15-2013/06/30.

Pour plus d’informations, reportez-vous à la section Classifications des conversions.

NOTE
Dans la version de maintenance du 10 mai 2018 d’Analytics, Adobe a commencé à limiter les fonctionnalités des classifications activées par date et numériques. Ces types de classifications ont été supprimés des interfaces Administration et Importateur de classifications. Il n’est plus possible d’ajouter de nouvelles classifications numériques et activées par date. Il sera possible de continuer à gérer les classifications actuelles (les charger, les supprimer) par l’intermédiaire des processus de classification standard et elles resteront disponibles dans le reporting.

Utilisation de dates en association avec des classifications ​ section_966A07B228CD4643B258E73FB8BA150A

Vous pouvez utiliser les classifications pour affecter des périodes à vos campagnes ou autres classifications de conversion ce qui permet une mesure plus précise des campagnes. Une fois la période d’une valeur indiquée, toute valeur correspondante qui se produit en dehors de la période ne sera pas classée. Cela est utile pour la mesure de campagne qui souhaite utiliser les dates exactes auxquelles une campagne était active et non tous les accès correspondant à la campagne elle-même. Afin de classer avec succès une valeur dans une période, les critères suivants doivent être respectés :

  • La classification doit être basée sur une variable de conversion.
  • La classification utilisée doit être définie en tant que Date d’activation Numérique 2.
  • La période impliquée doit contenir une date de début et (facultativement) une date de fin.

Pour classer les campagnes selon une période :

IMPORTANT
Cette option n’est pas disponible pour les suites de rapports activées pour la nouvelle architecture de classification.
  1. Connectez-vous à Analytics et accédez à Admin > Classifications.

  2. Cliquez sur l’onglet Exportation navigateur, assurez-vous que les paramètres de votre classification Date d’activation sont corrects, puis cliquez sur Exporter un fichier.

  3. Ouvrez ce fichier dans Microsoft Excel ou un autre éditeur de feuilles de calcul familier.

  4. Une des colonnes se termine par

    ^period, qui est la colonne dans laquelle il convient d’entrer la plage de dates.

  5. Sous cette colonne, saisissez la période de chaque valeur au format suivant :

    YYYY/MM/DD - YYYY/MM/DD. Veillez à ce qui suit :

    • laissez des espaces sur les deux côtés du tiret ;
    • utilisez un trait d’union (-) pour séparer les périodes et non un tiret demi-cadratin (–) ou cadratin (—) ;
    • si le mois ou le jour ne comporte qu’un seul chiffre, un zéro est ajouté devant ce chiffre ;
    • une date de début est présente ; la date de fin est facultative.
  6. Enregistrez le fichier et téléchargez-le dans Analytics en accédant à Admin | Classifications | Importer un fichier.

NOTE
Une valeur de clé spécifique ne peut pas comporter plusieurs périodes.

Résolution des problèmes affectant les classifications

recommendation-more-help
46b8682c-fda6-4669-9355-1a44923e549e