Dokumentation Experience Platform Tutorial für Mobile Apps

Erfassen und Zuordnen von Analytics-Daten

Letzte Aktualisierung: 10. Mai 2025

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

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 aus dem Edge Network an Adobe Analytics zu senden, konfigurieren Sie den Adobe Analytics-Service für den Datenstrom, den Sie im Rahmen von " erstellen“.

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.

Automatische Zuordnung

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

#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 „Analytics-Variablenzuordnung in Adobe Edge Experience".

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

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

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

Beachten Sie Folgendes in der Analytics-Zuordnung:

Ereignisse werden basierend auf commerce.productListAdds mit scAdd 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]

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, haben Sie folgende Möglichkeiten:

Verwenden einer Feldergruppe

Fügen Sie die Feldergruppe Adobe Analytics ExperienceEvent Full Extension zu Ihrem Schema hinzu.
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, um z. B. die Farbe von Produkten wie &&products = ...;evar1=red;event10=50,...;evar1=blue;event10=60 zu erfassen, müssen Sie Ihre XDM-Payload, die Sie unter " von Ereignisdaten“ definiert haben erweitern, um diese Merchandising-Informationen zu erfassen.

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

Im Code:

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

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.

Weitere Informationen zu Verarbeitungsregeln und Kontextdaten finden Sie hier.

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 Sie höchstwahrscheinlich MobileCore.trackAction- und MobileCore.trackState-API-Aufrufe verwendet.

Wenn Sie sich für die Migration entscheiden, um das empfohlene Edge Network zu verwenden, haben Sie Optionen:

Implementieren Sie die Erweiterung Edge Networkund verwenden Sie die Edge.sendEvent APIs, wie in der Lektion Nachverfolgen 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, sodass der Adobe Analytics-Service in Ihrem Datenstrom aktiviert ist und gegebenenfalls Verarbeitungsregeln verwendet werden können.
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