Collecte et mappage des données Analytics
Découvrez comment mapper des données mobiles à Adobe Analytics.
La variable 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. Vous mappez les données aux 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.
- 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 du réseau Edge à Adobe Analytics, vous configurez le service Adobe Analytics vers la banque de données que vous configurez dans le cadre de la Création d’un flux de données.
-
Dans l’interface utilisateur de la collecte de données, sélectionnez Datastreams et votre flux de données.
-
Sélectionnez Ajouter un service.
-
Ajouter Adobe Analytics de la Service list,
-
Entrez le nom de la suite de rapports d’Adobe Analytics que vous souhaitez utiliser dans Identifiant de suite de rapports.
-
Activez le service en basculant Activé sur .
-
Sélectionnez Enregistrer.
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
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"
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 observez attentivement, tous les événements comportent deux champs. value
(obligatoire) et id
(facultatif). La variable value
sert à incrémenter le nombre d’événements. La variable 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"
Validation avec Assurance
En utilisant la variable 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 le simulateur ou l’appareil à Assurance.
-
Envoyer un productListAdds (ajoutez un produit à votre panier).
-
Affichez l’accès ExperienceEvent.
-
Examinez la partie XDM du fichier 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 } } // ...
-
Consultez la section analytics.mapping .
Notez ce qui suit dans le mappage Analytics :
- events sont renseignées par
scAdd
basé surcommerce.productListAdds
. - pl (variable products) sont renseignées par 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.appinformation.appstatedetails.screenname
_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 la variable Extension complète Adobe Analytics ExperienceEvent groupe de champs à 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 section Suivi des données d’événement leçon 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 . Voir pour plus d’informations Association de données aux événements du SDK ou Modification des 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 des produits, comme &&products = ...;evar1=red;event10=50,...;evar1=blue;event10=60
, vous devez étendre la charge utile XDM que vous avez définie dans Suivi des données d’événement pour capturer ces informations de marchandisage.
-
Dans 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 } } }
-
Dans le code :
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 ] ] ]
Utilisation des règles de traitement
Voici à quoi peut ressembler une règle de traitement utilisant ces données :
-
You Remplacer la valeur de (1) Nom de l’écran de l’application (eVar2) (2) avec la valeur de a.x._techmarketingdemo.appinformation.appstatedetails.screename (3) si a.x._techmarketingdemo.appinformation.appstatedetails.screename (4) est défini (5).
-
You Définir un événement (6) Ajouter à la liste blanche (événement 3) (7) à a.x.commerce.saveForLaters.value(Context) (8) si a.x.commerce.saveForLaters.value(Context) (9) est défini (10)
Vous trouverez des informations supplémentaires sur les règles de traitement et les données contextuelles. here.
screenName
dans le tutoriel, il est vivement recommandé de mapper le nom de l’écran à Nom de la page dans une règle de traitement.Merci d’investir votre temps à apprendre sur 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 futur, partagez-les à ce sujet. Article de discussion de la communauté Experience League.
Suivant : Envoi de données à l’Experience Platform