Mappage Analytics

Découvrez comment mapper des données mobiles à Adobe Analytics.

Le event les données que vous avez collectées et envoyées à Platform Edge Network dans les leçons précédentes sont transférées aux services configurés dans votre flux de données, y compris Adobe Analytics. Il vous suffit de mettre en correspondance les données avec les variables correctes de votre suite de rapports.

Conditions préalables

  • Présentation du suivi ExperienceEvent.
  • Envoi réussi des données XDM dans votre exemple d’application.
  • Flux de données configuré sur Adobe Analytics

Objectifs d'apprentissage

Dans cette leçon, vous allez :

  • Comprendre le mappage automatique des variables Analytics.
  • Configurez les règles de traitement pour mapper les données XDM aux variables Analytics.

Mise en correspondance automatique

La plupart des champs XDM standard sont automatiquement mappés aux variables Analytics. Voir la liste complète ici.

Exemple #1 - s.products

Un bon exemple est le suivant : variable products qui ne peuvent pas être renseignées à l’aide de règles de traitement. Avec une implémentation XDM, vous transmettez toutes les données nécessaires dans productListItems et s.products est automatiquement renseigné via le mappage Analytics.

Cet objet :

"productListItems": [
    [
      "name":  "Yoga Mat",
      "SKU": "5829",
      "priceTotal": "49.99",
      "quantity": 1
    ],
    [
      "name":  "Water Bottle",
      "SKU": "9841",
      "priceTotal": "30.00",
      "quantity": 3
    ]
]

Cela se traduirait par ce qui suit :

s.products = ";Yoga Mat;1;49.99,;Water Bottle,3,30.00"
REMARQUE

Actuellement productListItems[N].SKU est ignorée par le mappage automatique.

Exemple #2 - scAdd

Si vous observez attentivement, tous les événements comportent deux champs. value (obligatoire) et id (facultatif). Le value sert à incrémenter le nombre d’événements. Le id est utilisé pour la sérialisation.

Cet objet :

"commerce" : {
  "productListAdds" : {
    "value" : 1
  }
}

Cela se traduirait par ce qui suit :

s.events = "scAdd"

Cet objet :

"commerce" : {
  "productListAdds" : {
    "value" : 1,
    "id": "321435"
  }
}

Cela se traduirait par ce qui suit :

s.events = "scAdd:321435"

Validation avec Assurance

En utilisant la variable Outil Assurance qualité vous pouvez confirmer que vous envoyez un événement ExperienceEvent, que les données XDM sont correctes et que le mappage Analytics se produit comme prévu. Par exemple :

  1. Envoyez un événement productListAdds .

    var xdmData: [String: Any] = [
      "eventType": "commerce.productListAdds",
      "commerce": [
        "productListAdds": [
          "value": 1
        ]
      ],
      "productListItems": [
        [
          "name": "neve studio dance jacket - (blue)",
          "SKU": "test-sku",
          "priceTotal": 69
        ]
      ]
    ]
    let addToCartEvent = ExperienceEvent(xdm: xdmData)
    Edge.sendEvent(experienceEvent: addToCartEvent)
    
  2. Affichez l’accès ExperienceEvent.

    accès xdm analytics

  3. Examinez la partie XDM du fichier JSON.

      "xdm" : {
        "productListItems" : [ {
          "priceTotal" : 69,
          "SKU" : "test-sku",
          "name" : "neve studio dance jacket - (blue)"
        } ],
        "timestamp" : "2021-10-22T22:03:37Z",
        "commerce" : {
          "productListAdds" : {
            "value" : 1
          }
        },
        "eventType" : "commerce.productListAdds",
        //...
      }
    
  4. Consultez la section analytics.mapping .

    accès xdm analytics

Notez ce qui suit dans le mappage Analytics :

  • "events" a été renseigné avec "scAdd" sur la base de commerce.productListAdds.
  • "pl" (variable products) a été renseigné avec une valeur concaténée basée sur productListItems.
  • Il y a d’autres informations intéressantes dans cet événement, y compris toutes les données contextuelles.

Mappage avec les données contextuelles

Les données XDM transférées à Analytics sont converties en données contextuelles comprenant des champs standard et personnalisés.

La clé de données contextuelles est construite selon la syntaxe suivante :

a.x.[xdm path]

Par exemple :

//Standard Field
a.x.commerce.saveforlaters.value

//Custom Field
a.x._techmarketingdemos.appinformationa.appstatedetails.screenname
REMARQUE

Les champs personnalisés sont placés sous l’identifiant de votre organisation Experience Cloud.

"_techmarketingdemos" est remplacé par la valeur unique de votre organisation.

Voici à quoi peut ressembler une règle de traitement utilisant ces données :

règles de traitement analytics

IMPORTANT

Certaines des variables mappées automatiquement ne peuvent pas être utilisées dans les règles de traitement.

La première fois que vous mappez à une règle de traitement, l’interface utilisateur ne vous affiche pas les variables de données contextuelles de l’objet XDM. Pour corriger les éléments qui sélectionnent une valeur, cliquez sur Enregistrer pour revenir à la modification. Toutes les variables XDM doivent maintenant apparaître.

Vous trouverez des informations supplémentaires sur les règles de traitement et les données contextuelles. here.

CONSEIL

Contrairement aux mises en oeuvre précédentes d’applications mobiles, il n’existe aucune distinction entre les pages vues/écrans et les autres événements. Vous pouvez à la place incrémenter la variable Page vue en définissant la mesure Nom de la page dans une règle de traitement. Puisque vous collectez le screenName dans le tutoriel, il est vivement recommandé de mapper ceci à Nom de la page dans une règle de traitement.

Suivant : Experience Platform

REMARQUE

Merci d’avoir consacré votre temps à l’apprentissage du SDK Adobe Experience Platform Mobile. Si vous avez des questions, souhaitez partager des commentaires généraux ou avez des suggestions sur le contenu futur, partagez-les à ce sujet. Article de discussion de la communauté Experience League

Sur cette page