Dokumentation Experience Platform Tutorial für Mobile Apps

Analytics-Daten erfassen und zuordnen

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

Themen:

Erstellt für:

Einsteiger
Fortgeschrittener
Entwickler

Erfahren Sie, wie Sie mobile Daten Adobe Analytics zuordnen.

Die event -Daten, die Sie in früheren Lektionen erfasst und an Platform Edge Network gesendet haben, werden an die in Ihrem Datastream konfigurierten Dienste weitergeleitet, einschließlich Adobe Analytics. Sie ordnen die Daten den korrekten Variablen in Ihrer Report Suite zu.

Architektur

Voraussetzungen

Grundlegendes zum ExperienceEvent-Tracking.
Erfolgreiches Senden von XDM-Daten in Ihrer Beispielanwendung.
Eine Adobe Analytics Report Suite, die Sie für diese Lektion verwenden können.

Lernziele

In dieser Lektion werden Sie:

Konfigurieren Sie Ihren Datenspeicher mit dem Adobe Analytics-Dienst.
Verstehen Sie die automatische Zuordnung von Analytics-Variablen.
Richten Sie Verarbeitungsregeln ein, um XDM-Daten Analytics-Variablen zuzuordnen.

Hinzufügen des Adobe Analytics-Datenspeicherdiensts

Um Ihre XDM-Daten vom Edge Network an Adobe Analytics zu senden, konfigurieren Sie den Adobe Analytics-Dienst für den Datastream, den Sie im Rahmen von Erstellen eines Datenspeichers eingerichtet haben.

Wählen Sie in der Datenerfassungs-Benutzeroberfläche Datastreams und Ihren Datenspeicher aus.
Wählen Sie dann Add Service aus.
Fügen Sie Adobe Analytics aus der Liste Service hinzu,
Geben Sie den Namen der Report Suite aus Adobe Analytics ein, die Sie in Report Suite-ID verwenden möchten.
Aktivieren Sie den Dienst, indem Sie Aktiviert aktivieren.
Wählen Sie Speichern aus.

Automatische Zuordnung

Viele der Standard-XDM-Felder werden automatisch Analytics-Variablen zugeordnet. Die vollständige Liste finden Sie hier.

Beispiel 1: s.products

Ein gutes Beispiel ist die Variable products , die nicht mit Verarbeitungsregeln aufgefüllt werden kann. Bei einer XDM-Implementierung werden alle erforderlichen Daten in productListItems und s.products automatisch über die Analytics-Zuordnung ausgefüllt.

Dieses Objekt:

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

führt zu:

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

NOTE

Wenn productListItems[].SKU und productListItems[].name beide Daten enthalten, wird der Wert in productListItems[].SKU verwendet. Weitere Informationen finden Sie unter Analytics-Variablenzuordnung in Adobe Experience Edge .

Beispiel 2 - scAdd

Wenn Sie genau hinsehen, haben alle Ereignisse zwei Felder: value (erforderlich) und id (optional). Das Feld value wird verwendet, um die Ereignisanzahl zu erhöhen. Das Feld id wird für die Serialisierung verwendet.

Dieses Objekt:

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

führt zu:

s.events = "scAdd"

Dieses Objekt:

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

führt zu:

s.events = "scAdd:321435"

Mit Assurance validieren

Mit dem Assurance können Sie bestätigen, dass Sie ein Erlebnisereignis senden, die XDM-Daten korrekt sind und die Analytics-Zuordnung erwartungsgemäß erfolgt.

Lesen Sie den Abschnitt Einrichtungsanweisungen , um Ihren Simulator oder Ihr Gerät mit Assurance zu verbinden.
Senden Sie ein productListAdds -Ereignis (fügen Sie Ihrem Warenkorb ein Produkt hinzu).
Anzeigen des ExperienceEvent-Treffers.

Überprüfen Sie den XDM-Teil der 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
  }
}
// ...

Überprüfen Sie das Ereignis analytics.mapping .

Beachten Sie Folgendes in der Analytics-Zuordnung:

events werden mit scAdd basierend auf commerce.productListAdds aufgefüllt.
pl (Variable "products") wird mit einem verketteten Wert gefüllt, der auf productListItems basiert.
Es gibt weitere interessante Informationen in diesem Ereignis, einschließlich aller Kontextdaten.

Zuordnung mit Kontextdaten

An Analytics weitergeleitete XDM-Daten werden in Kontextdaten konvertiert, die sowohl standardmäßige als auch benutzerdefinierte Felder enthalten.

Der Kontextdatenschlüssel wird nach dieser Syntax konstruiert:

a.x.[xdm path]

z. B.:

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

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

NOTE

Benutzerdefinierte Felder werden unter Ihrer Experience Cloud-Organisationskennung platziert.

_techmarketingdemos wird durch den eindeutigen Wert Ihrer Organisation ersetzt.

Um diese XDM-Kontextdaten Ihren Analytics-Daten in Ihrer Report Suite zuzuordnen, können Sie:

Feldgruppe verwenden

Fügen Sie Ihrem Schema die Feldergruppe Adobe Analytics ExperienceEvent Full Extension hinzu.
Erstellen Sie XDM-Payloads in Ihrer App entsprechend der Feldergruppe "Adobe Analytics ExperienceEvent Full Extension", ähnlich wie in der Lektion Ereignisdaten verfolgen beschrieben, oder
Erstellen Sie Regeln in Ihrer Tags-Eigenschaft, die Regelaktionen zum Anhängen oder Ändern von Daten an die Feldergruppe "Adobe Analytics ExperienceEvent Full Extension"verwenden. Weitere Informationen finden Sie unter Daten an SDK-Ereignisse anhängen oder Daten in SDK-Ereignissen ändern.

Merchandising-eVars

Wenn Sie Merchandising-eVars in Ihrem Analytics-Setup verwenden, z. B. um die Farbe von Produkten zu erfassen, z. B. &&products = ...;evar1=red;event10=50,...;evar1=blue;event10=60, müssen Sie Ihre XDM-Payload erweitern, die Sie in Tracking von Ereignisdaten definiert haben, um diese Merchandising-Informationen zu erfassen.

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

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

Verarbeitungsregeln verwenden

So könnte eine Verarbeitungsregel, die diese Daten verwendet, aussehen:

Sie überschreiben den Wert (1) App Screen Name (eVar 2) (2) mit dem Wert a.x._techmarketingdemo.appinformation.appstatedetails.screenname (3), wenn a.x_techmarketingdemo.appinformation.appstatedetails.screenname} (4) ist festgelegt (5).
Sie Legen Sie event (6) Add to Wishlist (Event 3) (7) auf a.x.commerce.saveForLaters.value(Context) (8) fest, wenn a.x.commerce.saveForLaters.value(Context) (9) auf (10) gesetzt ist.

Analytics-Verarbeitungsregeln

IMPORTANT

Einige der automatisch zugeordneten Variablen stehen möglicherweise nicht zur Verwendung in Verarbeitungsregeln zur Verfügung.

Wenn Sie eine Verarbeitungsregel zum ersten Mal zuordnen, zeigt die Schnittstelle die Kontextdatenvariablen aus dem XDM-Objekt nicht an. Um das Problem zu beheben, bei dem ein beliebiger Wert ausgewählt wurde, speichern Sie und kehren Sie zur Bearbeitung zurück. Alle XDM-Variablen sollten jetzt angezeigt werden.

Weitere Informationen zu Verarbeitungsregeln und Kontextdaten finden Sie hier.

TIP

Im Gegensatz zu früheren Implementierungen mobiler Apps gibt es keine Unterscheidung zwischen Seiten-/Bildschirmansichten und anderen Ereignissen. Stattdessen können Sie die Metrik Seitenansicht erhöhen, indem Sie in einer Verarbeitungsregel die Dimension Seitenname festlegen. Da Sie das benutzerdefinierte Feld screenName im Tutorial erfassen, wird dringend empfohlen, den Bildschirmnamen in einer Verarbeitungsregel Seitennamen zuzuordnen.

Migration von der mobilen Analytics-Erweiterung

Wenn Sie Ihre Mobile App mit der mobilen Erweiterung Adobe Analyticsentwickelt haben, haben Sie höchstwahrscheinlich MobileCore.trackAction und MobileCore.trackState API-Aufrufe verwendet.

Wenn Sie sich für eine Migration zur Verwendung des empfohlenen Edge Networks entscheiden, haben Sie folgende Optionen:

Implementieren Sie die Edge Network-Erweiterung und verwenden Sie die Edge.sendEvent-APIs, wie in der Lektion zum Tracking von Ereignisdaten dargestellt. Dieses Tutorial konzentriert sich auf diese Implementierung.
Implementieren Sie die Erweiterung Edge Bridge und verwenden Sie weiterhin Ihre API-Aufrufe MobileCore.trackAction und MobileCore.trackState. Weitere Informationen und ein separates Tutorial finden Sie unter Implementieren der Edge Bridge-Erweiterung .

SUCCESS

Sie haben Ihre App eingerichtet, um Ihre Experience Edge-XDM-Objekte Adobe Analytics-Variablen zuzuordnen, die den Adobe Analytics-Dienst in Ihrem Datenspeicher ermöglichen, und gegebenenfalls Verarbeitungsregeln verwenden.
Vielen Dank, dass Sie Ihre Zeit investiert haben, um mehr über das Adobe Experience Platform Mobile SDK zu erfahren. Wenn Sie Fragen haben, allgemeine Rückmeldungen oder Anregungen zu zukünftigen Inhalten haben möchten, teilen Sie diese in diesem Experience League Community-Diskussionbeitrag mit.

Weiter: Daten an Experience Platform senden

recommendation-more-help

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