Documentation Experience Platform Tutoriel sur les applications mobiles

Collecte et mappage des données Analytics

Last update: Thu Nov 14 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

Rubriques :

Créé pour :

Débutant
Intermédiaire
Développeur

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

Les données event que vous avez collectées et envoyées à l’Edge Network Platform dans des leçons précédentes sont transférées aux services configurés dans votre flux de données, y compris Adobe Analytics. Vous mappez les données aux variables correctes de votre suite de rapports.

Architecture

Conditions préalables

Présentation du suivi ExperienceEvent.
Envoi réussi des données XDM dans votre exemple d’application.
Suite de rapports Adobe Analytics que vous pouvez utiliser pour cette leçon.

Objectifs d'apprentissage

Dans cette leçon, vous allez :

Configurez votre flux de données avec le service Adobe Analytics.
Comprendre le mappage automatique des variables Analytics.
Configurez les règles de traitement pour mapper les données XDM aux variables Analytics.

Ajout du service Adobe Analytics datastream

Pour envoyer vos données XDM de l’Edge Network vers Adobe Analytics, vous configurez le service Adobe Analytics vers la banque de données que vous avez configurée dans le cadre de la fonction Créer une banque de données.

Dans l’interface utilisateur de la collecte de données, sélectionnez Datastreams et votre flux de données.
Sélectionnez ensuite Ajouter un service.
Ajoutez Adobe Analytics à partir de la liste Service,
Saisissez le nom de la suite de rapports d’Adobe Analytics que vous souhaitez utiliser dans Identifiant de suite de rapports.
Activez le service en activant Enabled.
Sélectionnez Enregistrer.

Mappage 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 la variable products qui ne peut pas être renseignée à 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 sont automatiquement renseignées 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
    ]
]

a pour résultat :

s.products = ";5829;1;49.99,9841;3;30.00"

NOTE

Si productListItems[].SKU et productListItems[].name contiennent tous deux des données, la valeur de productListItems[].SKU est utilisée. Voir Mappage des variables Analytics dans Adobe Experience Edge pour plus d’informations.

Exemple #2 - scAdd

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

Cet objet :

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

a pour résultat :

s.events = "scAdd"

Cet objet :

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

a pour résultat :

s.events = "scAdd:321435"

Valider avec Assurance

À l’aide de Assurance, vous pouvez confirmer que vous envoyez un événement d’expérience, que les données XDM sont correctes et que le mappage Analytics se produit comme prévu.

Consultez la section instructions de configuration pour connecter votre simulateur ou périphérique à Assurance.
Envoyez un événement productListAdds (ajoutez un produit à votre panier).
Affichez l’accès ExperienceEvent.

Examinez la partie XDM du fichier JSON.

code language-json

code language-json
`"xdm" : { "productListItems" : [ { "SKU" : "LLWS05.1-XS", "name" : "Desiree Fitness Tee", "priceTotal" : 24 } ], "timestamp" : "2023-08-04T12:53:37.662Z", "eventType" : "commerce.productListAdds", "commerce" : { "productListAdds" : { "value" : 1 } } // ...`

"xdm" : {
  "productListItems" : [ {
    "SKU" : "LLWS05.1-XS",
    "name" : "Desiree Fitness Tee",
    "priceTotal" : 24
  } ],
"timestamp" : "2023-08-04T12:53:37.662Z",
"eventType" : "commerce.productListAdds",
"commerce" : {
  "productListAdds" : {
    "value" : 1
  }
}
// ...

Examinez l’événement analytics.mapping .

Notez ce qui suit dans le mappage Analytics :

events sont renseignés avec scAdd sur la base de commerce.productListAdds.
pl (variable products) est 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, y compris les 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.appinformation.appstatedetails.screenname

NOTE

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.

Pour mapper ces données contextuelles XDM à vos données Analytics dans votre suite de rapports, vous pouvez :

Utilisation d’un groupe de champs

Ajoutez le groupe de champs Extension complète Adobe Analytics ExperienceEvent à votre schéma.
Créez des payloads XDM dans votre application, conformes au groupe de champs Extension complète Adobe Analytics ExperienceEvent , comme vous l’avez fait dans la leçon Track Event Data ou
Créez des règles dans la propriété Balises qui utilisent des actions de règle pour joindre ou modifier des données au groupe de champs Extension complète Adobe Analytics ExperienceEvent . Pour plus d’informations, reportez-vous à la section Association de données aux événements du SDK ou Modification de données dans les événements du SDK.

eVars de marchandisage

Si vous utilisez eVars de marchandisage dans votre configuration Analytics, par exemple pour capturer la couleur de produits, comme &&products = ...;evar1=red;event10=50,...;evar1=blue;event10=60, vous devez étendre la payload XDM que vous avez définie dans données d’événement de suivi pour capturer ces informations de marchandisage.

Dans JSON :

code language-json

code language-json
`{ "productListItems": [ { "SKU": "LLWS05.1-XS", "name": "Desiree Fitness Tee", "priceTotal": 24, "_experience": { "analytics": { "events1to100": { "event10": { "value": 50 } }, "customDimensions": { "eVars": { "eVar1": "red", } } } } } ], "eventType": "commerce.productListAdds", "commerce": { "productListAdds": { "value": 1 } } }`

{
  "productListItems": [
      {
          "SKU": "LLWS05.1-XS",
          "name": "Desiree Fitness Tee",
          "priceTotal": 24,
          "_experience": {
              "analytics": {
                  "events1to100": {
                      "event10": {
                          "value": 50
                      }
                  },
                  "customDimensions": {
                      "eVars": {
                          "eVar1": "red",
                      }
                  }
              }
          }
      }
  ],
  "eventType": "commerce.productListAdds",
  "commerce": {
      "productListAdds": {
          "value": 1
      }
  }
}

Dans le code :

code language-swift

code language-swift
`var xdmData: [String: Any] = [ "productListItems": [ [ "name": productName, "SKU": sku, "priceTotal": priceString, "_experience" : [ "analytics": [ "events1to100": [ "event10": [ "value:": value ] ], "customDimensions": [ "eVars": [ "eVar1": color ] ] ] ] ] ], "eventType": "commerce.productViews", "commerce": [ "productViews": [ "value": 1 ] ] ]`

var xdmData: [String: Any] = [
  "productListItems": [
    [
      "name":  productName,
      "SKU": sku,
      "priceTotal": priceString,
      "_experience" : [
        "analytics": [
          "events1to100": [
            "event10": [
              "value:": value
            ]
          ],
          "customDimensions": [
            "eVars": [
              "eVar1": color
            ]
          ]
        ]
      ]
    ]
  ],
  "eventType": "commerce.productViews",
  "commerce": [
    "productViews": [
      "value": 1
    ]
  ]
]

Utilisation des règles de traitement

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

Vous Remplacez la valeur de (1) Nom de l’écran de l’application (eVar2) (2) par la valeur de a.x._techmarketingdemo.appstatedetails.screename (3) si a.x._techmarketingdemo.appstatedetails.screename (4) est défini (5).
Vous Définissez event (6) Ajouter à la liste blanche (événement 3) (7) sur a.x.commerce.saveForLaters.value(Context) (8) si a.x.commerce.saveForLaters.value(Context) (9) est défini (10)))

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 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 ici.

TIP

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

Migration depuis l’extension mobile Analytics

Si vous avez développé votre application mobile à l'aide de l'extension mobile Adobe Analytics , vous avez probablement utilisé les appels d'API MobileCore.trackAction et MobileCore.trackState.

Si vous décidez de migrer pour utiliser l’Edge Network recommandé, vous disposez d’options :

Mettez en oeuvre l’ extension Edge Network et utilisez les API Edge.sendEvent, comme illustré dans la leçon sur la suivi des données d’événement. Ce tutoriel se concentre sur cette implémentation.
Mettez en oeuvre l’ extension Edge Bridge et continuez à utiliser vos appels d’API MobileCore.trackAction et MobileCore.trackState. Voir Mise en oeuvre de l’extension Edge Bridge pour plus de détails et pour consulter un tutoriel distinct.

SUCCESS

Vous avez configuré votre application pour mapper vos objets XDM Experience Edge aux variables Adobe Analytics en activant le service Adobe Analytics dans votre flux de données et en utilisant des règles de traitement le cas échéant.
Merci d’avoir consacré votre temps à découvrir le SDK Adobe Experience Platform Mobile. Si vous avez des questions, souhaitez partager des commentaires généraux ou avez des suggestions sur le contenu à venir, partagez-les sur cet post de discussion de la communauté Experience League.

Suivant : Envoyer des données à l’Experience Platform

recommendation-more-help

9fed61f5-c338-47ad-8005-0b89a5f4af8b