Dokumentation Experience Platform Tutorial für Mobile Apps

Erfassen und Zuordnen von Analytics-Daten

Last update: Wed Sep 10 2025 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 Ereignis-Daten, die Sie in früheren Lektionen erfasst und an Platform Edge Network gesendet haben, werden an die in Ihrem Datenstrom konfigurierten Services weitergeleitet, einschließlich Adobe Analytics. Sie ordnen die Daten den richtigen Variablen in Ihrer Report Suite zu.

Architektur {modal="regular"}

Voraussetzungen

Grundlagen zum ExperienceEvent-Tracking.
XDM-Daten in der Beispielanwendung wurden erfolgreich gesendet.
Eine Adobe Analytics Report Suite , die Sie für diese Lektion verwenden können.

Lernziele

In dieser Lektion erfahren Sie Folgendes:

Konfigurieren Ihres Datenstroms mit dem Adobe Analytics-Service.
Verstehen der automatischen Zuordnung von Analytics-Variablen.
Richten Sie Verarbeitungsregeln ein, um XDM-Daten Analytics-Variablen zuzuordnen.

Adobe Analytics-Datenstrom-Service hinzufügen

Um Ihre XDM-Daten von der Edge Network an Adobe Analytics zu senden, konfigurieren Sie den Adobe Analytics-Service für den Datenstrom, den Sie im Rahmen von Erstellen eines Datenstroms eingerichtet haben.

Wählen Sie in der Datenerfassungs-Benutzeroberfläche Datenströme und Ihren Datenstrom aus.
Wählen Sie dann Service hinzufügen aus.
Adobe Analytics aus der Liste Service hinzufügen,
Geben Sie den Namen der Report Suite aus Adobe Analytics ein, die Sie in verwenden möchten Report Suite-ID.
Aktivieren Sie den Service, indem Sie Aktiviert einschalten.
Wählen Sie Speichern aus.

{modal="regular"}

Automatische Zuordnung

Viele der XDM-Standardfelder werden automatisch Analytics-Variablen zugeordnet. Siehe die vollständige Liste.

#1 - s.products

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

Dieses Objekt:

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

Ergebnisse in:

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 unter „AnalyticsVariablenzuordnung in Adobe Experience Edge"

#2 - scAdd

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

Dieses Objekt:

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

Ergebnisse in:

s.events = "scAdd"

Dieses Objekt:

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

Ergebnisse in:

s.events = "scAdd:321435"

Mit Assurance validieren

Mit der AssuranceSie bestätigen, dass Sie ein Erlebnisereignis senden, die XDM-Daten korrekt sind und die Analytics-Zuordnung erwartungsgemäß erfolgt.

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

{modal="regular"}

Überprüfen Sie den XDM-Teil der JSON-Datei.

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 analytics.mapping Ereignis.

{modal="regular"}

Beachten Sie Folgendes in der Analytics-Zuordnung:

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

Zuordnung mit Kontextdaten

An Analytics weitergeleitete XDM-Daten werden in Kontextdaten einschließlich standardmäßiger und benutzerdefinierter Felder, konvertiert.

Der Kontextdatenschlüssel wird mit dieser Syntax erstellt:

a.x.[xdm path]

Beispiel:

// 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.

Der Mandantenname _techmarketingdemos wird durch den eindeutigen Wert Ihrer Organisation ersetzt.

Um diese XDM-Kontextdaten Ihren Analytics-Daten in Ihrer Report Suite zuzuordnen, haben Sie folgende Möglichkeiten:

Verwenden einer Feldergruppe

Fügen Sie die Feldergruppe Adobe Analytics ExperienceEvent Full Extension zu Ihrem Schema hinzu.

{modal="regular"}
Erstellen Sie XDM-Payloads in Ihrer App entsprechend der Adobe Analytics ExperienceEvent Full Extension-Feldergruppe, ähnlich dem, was Sie in der Lektion Nachverfolgen von) oder
Erstellen Sie Regeln in Ihrer Tags-Eigenschaft, die Regelaktionen verwenden, um Daten an die Feldergruppe Adobe Analytics ExperienceEvent Full Extension anzuhängen oder zu ändern. Weitere Informationen finden Sie unter Anhängen von Daten an SDK- oder Ändern von Daten in SDK-Ereignissen.

Merchandising-eVars

Wenn Sie Merchandising-eVars in Ihrer Analytics-Einrichtung verwenden, müssen Sie Ihre XDM-Payload, die Sie unter " von Ereignisdaten“ definiert haben, erweitern um diese Merchandising-Informationen zu erfassen. Ein Beispiel für eine Merchandising-Var ist evar1, wo Sie die Farbe von Produkten erfassen möchten, z. B. &&products = ...;evar1=red;event10=50,...;evar1=blue;event10=60

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

Verwenden von Verarbeitungsregeln

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

Sie den Wert von (1) App Screen Name (eVar2) (2) mit dem Wert von a.x._techmarketingdemo.appinformation.appstatedetails.screenName (3) überschreiben, wenn a.x._techmarketingdemo.appinformation.appstatedetails.screenName (4) festgelegt (5).
Sie Ereignis festlegen (6) Zur Wunschliste hinzufügen (Ereignis 3) (7) auf a.x.commerce.saveForLaters.value(Context) (8), wenn a.x.commerce.saveForLaters.value(Context) (9) festgelegt ist (10).

Analytics-Verarbeitungsregeln {modal="regular"}

IMPORTANT

Einige der automatisch zugeordneten Variablen sind möglicherweise nicht für die Verwendung in Verarbeitungsregeln verfügbar.

Wenn Sie eine Verarbeitungsregel zum ersten Mal zuordnen, zeigt die Benutzeroberfläche die Kontextdatenvariablen aus dem XDM-Objekt nicht an. Um dies zu beheben, wählen Sie einen beliebigen Wert aus, speichern Sie und kehren Sie zur Bearbeitung zurück. Alle XDM-Variablen sollten jetzt angezeigt werden.

Siehe Zuordnen von contextData-Variablen zu Props und eVars mit Verarbeitungsregeln.

TIP

Im Gegensatz zu vorherigen Mobile-App-Implementierungen gibt es keinen Unterschied zwischen einer Seiten-/Bildschirmansicht und anderen Ereignissen. Stattdessen können Sie die Metrik Seitenansicht erhöhen, indem Sie die Dimension Seitenname in einer Verarbeitungsregel festlegen. Da Sie das benutzerdefinierte screenName im Tutorial erfassen, wird dringend empfohlen, den Bildschirmnamen in einer Verarbeitungsregel Seitenname zuzuordnen.

Migration von der Analytics Mobile-Erweiterung

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

Wenn Sie sich für die Migration zur Verwendung der empfohlenen Edge Network entscheiden, haben Sie keine Optionen:

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

SUCCESS

Sie haben Ihre App so eingerichtet, dass Ihre XDM-Objekte von Experience Edge Adobe Analytics-Variablen zugeordnet werden, indem Sie den Adobe Analytics-Service in Ihrem Datenstrom aktivieren. und gegebenenfalls unter Verwendung von Verarbeitungsregeln.
Vielen Dank, dass Sie sich Zeit genommen haben, um mehr über Adobe Experience Platform Mobile SDK zu erfahren. Wenn Sie Fragen haben, allgemeines Feedback geben möchten oder Vorschläge für zukünftige Inhalte haben, teilen Sie diese auf diesem Experience League Community-Diskussionsbeitrag.

Weiter: Daten an Experience Platform senden

recommendation-more-help

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