Dokumentation Experience Platform Självstudiekurs om mobila appar

Samla in och mappa analysdata

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

Ämnen:

Skapat för:

Nybörjare
Mellanliggande
Utvecklare

Lär dig hur du mappar mobildata till Adobe Analytics.

Händelsens-data som du har samlat in och skickat till Platform Edge Network i tidigare lektioner vidarebefordras till de tjänster som konfigurerats i ditt datastam, inklusive Adobe Analytics. Du mappar data till rätt variabler i rapportsviten.

Arkitektur

Förhandskrav

Understanding of ExperienceEvent tracking.
XDM-data har skickats i exempelappen.
En Adobe Analytics rapportserie som du kan använda för den här lektionen.

Utbildningsmål

I den här lektionen kommer du att:

Konfigurera dataströmmen med Adobe Analytics-tjänsten.
Förstå automatisk mappning av analysvariabler.
Ställ in bearbetningsregler för att mappa XDM-data till analysvariabler.

Lägg till Adobe Analytics datastream-tjänst

Om du vill skicka XDM-data från Edge Network till Adobe Analytics konfigurerar du Adobe Analytics-tjänsten till den datastream som du konfigurerade som en del av Skapa en datastream.

I användargränssnittet för datainsamling väljer du Datastreams och ditt datastream.
Välj sedan Add Service.
Lägg till Adobe Analytics från listan Service,
Ange namnet på rapportsviten från Adobe Analytics som du vill använda i Report Suite ID.
Aktivera tjänsten genom att aktivera Enabled.
Välj Save.

Automatisk mappning

Många av XDM-standardfälten mappas automatiskt till analysvariabler. Se den fullständiga listan här.

Exempel 1 - s.products

Ett bra exempel är variabeln products som inte kan fyllas med bearbetningsregler. Med en XDM-implementering skickas alla nödvändiga data i productListItems och s.products fylls i automatiskt via Analytics-mappning.

Det här objektet:

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

resulterar i

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

NOTE

Om både productListItems[].SKU och productListItems[].name innehåller data används värdet i productListItems[].SKU. Mer information finns i Variabelmappning för analys i Adobe Experience Edge.

Exempel 2 - scAdd

Om du tittar närmare på alla händelser har två fält value (obligatoriskt) och id (valfritt). Fältet value används för att öka antalet händelser. Fältet id används för serialisering.

Det här objektet:

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

resulterar i

s.events = "scAdd"

Det här objektet:

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

resulterar i

s.events = "scAdd:321435"

Validera med Assurance

Med Assurance kan du bekräfta att du skickar en upplevelsehändelse, att XDM-data är korrekta och att analysmappningen sker som förväntat.

Granska avsnittet installationsanvisningar för att ansluta simulatorn eller enheten till Assurance.
Skicka en productListAdds-händelse (lägg till en produkt i korgen).
Visa ExperienceEvent-träffen.

Granska XDM-delen av 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
  }
}
// ...

Granska analytics.mapping-händelsen.

Observera följande i Analytics-mappningen:

events fylls i med scAdd baserat på commerce.productListAdds.
pl (produktvariabel) har ett sammanfogat värde som baseras på productListItems.
Det finns annan intressant information i den här händelsen, inklusive alla kontextdata.

Mappa med kontextdata

XDM-data som vidarebefordras till Analytics konverteras till kontextdata, inklusive både standardfält och anpassade fält.

Kontextens datanyckel konstrueras enligt den här syntaxen:

a.x.[xdm path]

Exempel:

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

// Custom Field
a.x._techmarketingdemos.appinformation.appstatedetails.screenname

NOTE

Anpassade fält placeras under din Experience Cloud-organisationsidentifierare.

_techmarketingdemos ersätts med din organisations unika värde.

Om du vill mappa dessa XDM-kontextdata till analysdata i rapportsviten kan du:

Använd en fältgrupp

Lägg till fältgruppen Adobe Analytics ExperienceEvent Full Extension i ditt schema.
Bygg XDM-nyttolaster i appen, i enlighet med fältgruppen Adobe Analytics ExperienceEvent Full Extension, i likhet med vad du har gjort i lektionen Spåra händelsedata , eller
Skapa regler i taggegenskapen som använder regelåtgärder för att bifoga eller ändra data till fältgruppen Adobe Analytics ExperienceEvent Full Extension. Mer information finns i Koppla data till SDK-händelser eller Ändra data i SDK-händelser.

Merchandising eVars

Om du använder Varor för marknadsföring i Analytics-konfigurationen, till exempel för att hämta färgen för produkter, som &&products = ...;evar1=red;event10=50,...;evar1=blue;event10=60, måste du utöka din XDM-nyttolast som du definierade i Spåra händelsedata för att kunna hämta försäljningsinformationen.

I 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
      }
  }
}

I kod:

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
    ]
  ]
]

Använd bearbetningsregler

Så här ser en bearbetningsregel ut när den här informationen används:

Du Overwrite value of (1) App Screen Name (eVar2) (2) med värdet a.x._techmarketingdemo.appinformation.appstatedetails.screenname (3) if a.x._techmarketingdemo.appinformation.appstatedetails.screenname (4) is set (5).
Du Set event (6) Add to Wishlist (Event 3) (7) till a.x.commerce.saveForLaters.value(Context) (8) om a.x.commerce.saveForLaters.value(Context) (9) is set (10).

regler för analysbearbetning

IMPORTANT

Vissa av de automatiskt mappade variablerna kanske inte är tillgängliga för användning i bearbetningsregler.

Första gången du mappar till en bearbetningsregel visas inte kontextdatavariablerna från XDM-objektet. Om du vill åtgärda det väljer du ett värde, Spara och återgå till att redigera. Alla XDM-variabler ska nu visas.

Ytterligare information om bearbetning av regler och kontextdata finns här.

TIP

Till skillnad från tidigare mobilappsimplementeringar finns det ingen skillnad mellan en sida-/skärmvy och andra händelser. I stället kan du öka måttet Page View genom att ställa in dimensionen Page Name i en bearbetningsregel. Eftersom du samlar in det anpassade fältet screenName i självstudiekursen rekommenderar vi att du mappar skärmnamnet till Page Name i en bearbetningsregel.

Migrera från mobiltillägget Analytics

Om du har utvecklat ditt mobilprogram med Adobe Analytics-mobiltillägget har du troligen använt MobileCore.trackAction - och MobileCore.trackState API-anrop.

Om du väljer att migrera för att använda den rekommenderade Edge Network finns det alternativ:

Implementera Edge Network-tillägget och använd Edge.sendEvent-API:erna, som i lektionen om hur du spårar händelsedata. Den här självstudiekursen fokuserar på den här implementeringen.
Implementera Edge Bridge-tillägget och fortsätt använda dina MobileCore.trackAction - och MobileCore.trackState API-anrop. Se Implementera Edge Bridge-tillägget om du vill ha mer information och en separat självstudiekurs.

SUCCESS

Du har konfigurerat din app för att mappa dina Experience Edge XDM-objekt till Adobe Analytics-variabler som aktiverar Adobe Analytics-tjänsten i ditt datastam och som använder bearbetningsregler där det är tillämpligt.
Tack för att du har lagt ned din tid på att lära dig om Adobe Experience Platform Mobile SDK. Om du har frågor, vill dela allmän feedback eller har förslag på framtida innehåll kan du dela dem i det här Experience League-diskussionsinlägget.

Nästa: Skicka data till Experience Platform

recommendation-more-help

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