Samla in och mappa analysdata

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 har konfigurerats i ditt datalager, inklusive Adobe Analytics. Du mappar data till rätt variabler i rapportsviten.

Arkitektur {modal="regular"}

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.

  1. I användargränssnittet för datainsamling väljer du Datastreams och ditt datastream.

  2. Välj sedan Lägg till Add Service.

  3. Lägg till Adobe Analytics från listan Service,

  4. Ange namnet på rapportsviten från Adobe Analytics som du vill använda i Report Suite ID.

  5. Aktivera tjänsten genom att aktivera Enabled.

  6. Välj Save.

    Lägg till Adobe Analytics som datastream-tjänst {modal="regular"}

Automatisk mappning

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

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 finns det 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.

  1. Granska avsnittet installationsanvisningar för att ansluta simulatorn eller enheten till Assurance.

  2. Skicka en productListAdds-händelse (lägg till en produkt i korgen).

  3. Visa ExperienceEvent-träffen.

    xdm-träff för analys {modal="regular"}

  4. Granska XDM-delen av 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
      }
    }
    // ...
    
  5. Granska analytics.mapping-händelsen.

    xdm-träff för analys {modal="regular"}

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 Org-identifierare.
Klientorganisationens namn _techmarketingdemos har ersatts 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.

    Fältgruppen FullExtension för Analytics ExperienceEvent {modal="regular"}

  • 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 Bifoga data till SDK-händelser eller Ändra data i SDK-händelser.

Merchandising eVars

Om du använder marknadsföringsvariabler i Analytics-konfigurationen 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. Exempel på en försäljningsvariabel är evar1 där du vill fånga färgerna för produkter, som &&products = ...;evar1=red;event10=50,...;evar1=blue;event10=60

  • I 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
          }
      }
    }
    
  • I kod:

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

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 {modal="regular"}

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.

Se Mappa contextData-variabler till utkast och eVars med bearbetningsregler.

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 API-anropen MobileCore.trackAction och MobileCore.trackState .

Om du bestämmer dig för att migrera för att använda den rekommenderade Edge Network finns det alternativ:

SUCCESS
Du har konfigurerat din app för att mappa dina Experience Edge XDM-objekt till Adobe Analytics-variabler genom att aktivera Adobe Analytics-tjänsten i din datastam. Och med 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 Community-diskussionsinlägget.

Nästa: Skicka data till Experience Platform

recommendation-more-help
9fed61f5-c338-47ad-8005-0b89a5f4af8b