Collecter et mapper des données Analytics
Découvrez comment mapper les données mobiles à Adobe Analytics.
Les données événement que vous avez collectées et envoyées à Platform Edge Network 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 dans votre suite de rapports.
Conditions préalables
- Compréhension du suivi des événements d’expérience.
- Envoi réussi de données XDM dans votre exemple d’application.
- Une 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.
Ajouter un service de flux de données Adobe Analytics
Pour envoyer vos données XDM d’Edge Network vers Adobe Analytics, vous devez configurer le service Adobe Analytics sur le flux de données que vous avez configuré dans le cadre de l’Création d’un flux de données.
-
Dans l’interface utilisateur de collecte de données, sélectionnez Flux de données et votre flux de données.
-
Sélectionnez ensuite
-
Ajouter Adobe Analytics à partir de la liste Service,
-
Saisissez le nom de la suite de rapports d’Adobe Analytics à utiliser dans Identifiant de suite de rapports.
-
Activez le service en activant Activé.
-
Sélectionnez Enregistrer.
Mappage automatique
La plupart des champs XDM standard sont automatiquement mappés à des variables Analytics. Voir la liste complète.
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
]
]
permet d’obtenir :
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. Pour plus d’informations, voir Mappage des variables Analytics dans Adobe Experience Edge.Exemple de #2 - scAdd
Si vous y regardez de plus près, tous les événements comportent 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
}
}
permet d’obtenir :
s.events = "scAdd"
Cet objet :
"commerce" : {
"productListAdds" : {
"value" : 1,
"id": "321435"
}
}
permet d’obtenir :
s.events = "scAdd:321435"
Valider avec Assurance
À l’aide de l’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 votre appareil à Assurance.
-
Envoyer un événement productListAdds (ajouter 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 } } // ...
-
Examinez l’événement analytics.mapping.
Notez ce qui suit dans le mappage Analytics :
- Les événements sont renseignés avec des
scAdd
basées surcommerce.productListAdds
. - pl (variable products) est renseignée 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 des données contextuelles
Les données XDM transférées vers Analytics sont converties en données contextuelles y compris les champs standard et personnalisés.
La clé des données contextuelles est construite selon cette syntaxe :
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 :
Utiliser 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, en respectant le groupe de champs Extension complète Adobe Analytics ExperienceEvent, comme vous l’avez fait dans la leçon Suivi des données d’événement ou
-
Créez dans votre propriété Balises des règles qui utilisent des actions de règle pour joindre ou modifier des données au groupe de champs de l’extension complète Adobe Analytics ExperienceEvent . Voir pour plus d’informations Joindre des données aux événements SDK ou Modifier des données dans les événements SDK.
eVars de marchandisage
Si vous utilisez des eVars de marchandisage dans votre configuration Analytics, vous devez étendre la payload XDM que vous avez définie dans Suivi des données d’événement pour capturer ces informations de marchandisage. Un exemple de var de marchandisage est evar1
lorsque vous souhaitez capturer la couleur de produits, comme &&products = ...;evar1=red;event10=50,...;evar1=blue;event10=60
-
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 pourrait ressembler une règle de traitement utilisant ces données :
-
Vous Remplacez la valeur de (1) Nom d’écran de l’application (eVar2) (2) par la valeur de a.x._techmarketingdemo.appinformation.appstatedetails.screenname (3) si a.x._techmarketingdemo.appinformation.appstatedetails (4) est défini (5).
-
Vous Définir l’événement (6) Ajouter à la liste de souhaits (Événement 3) (7) à a.x.commerce.saveForLaters.value(Context) (8) si a.x.commerce.saveForLaters.value(Context) (9) est défini (10).
Voir Mappage des variables contextData en props et eVars avec des règles de traitement.
screenName
personnalisé dans le tutoriel, il est vivement recommandé de mapper le nom d’écran au 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é des appels d’API MobileCore.trackAction
et MobileCore.trackState
.
Si vous décidez de migrer pour utiliser Edge Network recommandé, vous disposez des options suivantes :
- Mettez en œuvre l’extension Edge Network et utilisezAPI
Edge.sendEvent
, comme illustré dans la leçon sur la façon de suivre les données d’événement. Ce tutoriel se concentre sur cette implémentation. - Mettez en œuvre l’extension Edge Bridge 🔗 et continuez à utiliser vos appels d’API
MobileCore.trackAction
etMobileCore.trackState
. Voir Implémentation de l’extension Edge Bridge pour plus d’informations et pour un tutoriel séparé.
Merci d’avoir investi votre temps pour en savoir plus sur Adobe Experience Platform Mobile SDK. Si vous avez des questions, souhaitez partager des commentaires généraux ou des suggestions sur le contenu futur, partagez-les dans ce article de discussion de la communauté Experience League.
Suivant : Envoi de données à Experience Platform