Dokumentation Experience Platform Tutorial für Mobile Apps

Verfolgen von Ereignisdaten

Letzte Aktualisierung: 5. Mai 2025

Themen:

Erstellt für:

Einsteiger
Fortgeschrittener
Entwickler

Erfahren Sie, wie Sie Ereignisse in einer Mobile App verfolgen.

Die Edge Network-Erweiterung stellt eine API zum Senden von Erlebnisereignissen an Platform Edge Network bereit. Ein Erlebnisereignis ist ein Objekt, das Daten enthält, die der Schemadefinition von XDM ExperienceEvent entsprechen. Einfacher gesagt erfassen sie, was Menschen in Ihrer mobilen App tun. Sobald Daten vom Platform-Edge Network empfangen wurden, können sie an Programme und Services weitergeleitet werden, die in Ihrem Datenstrom konfiguriert sind, z. B. Adobe Analytics und Experience Platform. Weitere Informationen zu Erlebnisereignissen finden Sie in der Produktdokumentation.

Voraussetzungen

Alle Paketabhängigkeiten sind in Ihrem Xcode-Projekt vorhanden.
Registrierte Erweiterungen in AppDelegate.
MobileCore-Erweiterung zur Verwendung Ihrer appId konfiguriert.
SDKs importiert.
Die App mit den oben genannten Änderungen wurde erfolgreich erstellt und ausgeführt.

Lernziele

In dieser Lektion werden Sie

Erfahren Sie, wie Sie XDM-Daten basierend auf einem Schema strukturieren.
Senden Sie ein XDM-Ereignis basierend auf einer Standardfeldgruppe.
Senden Sie ein XDM-Ereignis basierend auf einer benutzerdefinierten Feldergruppe.
Senden Sie ein XDM-Kaufereignis.
Validieren mit Assurance.

Erstellen eines Erlebnisereignisses

Die Adobe Experience Platform Edge-Erweiterung kann Ereignisse, die einem zuvor definierten XDM-Schema folgen, an das Adobe Experience Platform-Edge Network senden.

Der Prozess läuft so ab…

Identifizieren Sie die Mobile-App-Interaktion, die Sie verfolgen möchten.
Prüfen Sie Ihr Schema und ermitteln Sie das entsprechende Ereignis.
Prüfen Sie Ihr Schema und identifizieren Sie alle zusätzlichen Felder, die zur Beschreibung des Ereignisses verwendet werden sollten.
Erstellen und Auffüllen des Datenobjekts.
Ereignis erstellen und senden.
Validieren.

Standardfeldgruppen

Für die Standardfeldgruppen sieht der Prozess wie folgt aus:

Identifizieren Sie in Ihrem Schema die Ereignisse, die Sie erfassen möchten. In diesem Beispiel verfolgen Sie Commerce-Erlebnisereignisse, z. B. ein Produktansichtsereignis productViews.
Um ein -Objekt zu erstellen, das die Erlebnisereignisdaten in Ihrer App enthält, verwenden Sie Code wie den folgenden:
var xdmData: [String: Any] = [ "eventType": "commerce.productViews", "commerce": [ "productViews": [ "value": 1 ] ] ]
- eventType: Beschreibt das aufgetretene Ereignis. Verwenden Sie nach Möglichkeit einen bekannten".
- commerce.productViews.value: Der numerische oder boolesche Wert des Ereignisses. Wenn es sich um einen booleschen Wert (oder „Zähler“ in Adobe Analytics) handelt, wird der Wert immer auf 1 festgelegt. Wenn es sich um ein numerisches oder ein Währungsereignis handelt, kann der Wert > 1 sein.
Identifizieren Sie in Ihrem Schema alle zusätzlichen Daten, die mit dem Commerce-Produktansichtsereignis verknüpft sind. In diesem Beispiel schließen Sie productListItems ein. Dies ist ein Standardsatz von Feldern, die mit jedem Commerce-bezogenen Ereignis verwendet werden:
- Beachten Sie dass „productListItems ein Array ist, sodass mehrere Produkte bereitgestellt werden können.

Um diese Daten hinzuzufügen, erweitern Sie Ihr xdmData-Objekt, um zusätzliche Daten einzuschließen:

var xdmData: [String: Any] = [
    "eventType": "commerce.productViews",
        "commerce": [
        "productViews": [
            "value": 1
        ]
    ],
    "productListItems": [
        [
            "name":  productName,
            "SKU": sku,
            "priceTotal": priceString,
            "quantity": 1
        ]
    ]
]

Sie können jetzt diese Datenstruktur verwenden, um eine ExperienceEvent zu erstellen:
let productViewEvent = ExperienceEvent(xdm: xdmData)
und senden Sie das -Ereignis und die Daten mithilfe der sendEvent-API an Platform Edge Network:
Edge.sendEvent(experienceEvent: productViewEvent)

Die Edge.sendEvent-API entspricht der AEP Mobile SDK den MobileCore.trackAction- und MobileCore.trackState-API-Aufrufen. Weitere finden Sie unter „Migrieren von der Analytics Mobile-Erweiterungdas Adobe Experience Platform-Edge Network".

Sie werden diesen Code jetzt tatsächlich in Ihr Xcode-Projekt implementieren.
Sie haben verschiedene Commerce-produktbezogene Aktionen in Ihrer App und möchten Ereignisse senden, die auf diesen Aktionen basieren und vom Benutzer ausgeführt werden:

Ansicht: Tritt auf, wenn ein Benutzer ein bestimmtes Produkt anzeigt,
Zum Warenkorb hinzufügen: Wenn ein Benutzer tippt

in einem Produktdetailbildschirm,
Für später speichern: Wenn ein Benutzer tippt

in einem Produktdetailbildschirm,
Kauf: Wenn ein Benutzer auf tippt In einem Produktdetailbildschirm

.

Um den wiederverwendbaren Versand von Commerce-bezogenen Erlebnisereignissen zu implementieren, verwenden Sie eine dedizierte Funktion:

Navigieren Sie im Xcode-Projekt-zu  Luma > Luma > Utils > MobileSDK) und fügen Sie Folgendes zur func sendCommerceExperienceEvent(commerceEventType: String, product: Product) hinzu.

// Set up a data dictionary, create an experience event and send the event.
let xdmData: [String: Any] = [
    "eventType": "commerce." + commerceEventType,
    "commerce": [
        commerceEventType: [
            "value": 1
        ]
    ],
    "productListItems": [
        [
            "name": product.name,
            "priceTotal": product.price,
            "SKU": product.sku
        ]
    ]
]

let commerceExperienceEvent = ExperienceEvent(xdm: xdmData)
Edge.sendEvent(experienceEvent: commerceExperienceEvent)

Diese Funktion akzeptiert den Ereignistyp und das Produkt des Commerce-Erlebnisses als Parameter und

richtet die XDM-Payload mithilfe der Parameter aus der -Funktion als Wörterbuch ein,
ein Erlebnisereignis mithilfe des Wörterbuchs einrichtet,
sendet das Erlebnisereignis über die Edge.sendEvent-API.

Navigieren Sie im Xcode-Projekt-Navigator zu Luma > Luma > Views > Products > ProductView und fügen Sie verschiedene Aufrufe an die sendCommerceExperienceEvent Funktion hinzu:

Am Modifikator .task innerhalb des ATTrackingManager.trackingAuthorizationStatus. Dieser .task wird aufgerufen, wenn die Produktansicht initialisiert und angezeigt wird. Daher möchten Sie zu diesem Zeitpunkt ein Produktansichtsereignis senden.
// Send productViews commerce experience event MobileSDK.shared.sendCommerceExperienceEvent(commerceEventType: "productViews", product: product)

Für jede Schaltfläche ( , und ) Fügen Sie in der Symbolleiste den entsprechenden Aufruf innerhalb des ATTrackingManager.trackingAuthorizationStatus == .authorized hinzu:

für

// Send saveForLater commerce experience event
MobileSDK.shared.sendCommerceExperienceEvent(commerceEventType: "saveForLaters", product: product)

für

// Send productListAdds commerce experience event
MobileSDK.shared.sendCommerceExperienceEvent(commerceEventType: "productListAdds", product: product)

für

// Send purchase commerce experience event
MobileSDK.shared.sendCommerceExperienceEvent(commerceEventType: "purchases", product: product)

TIP

Wenn Sie eine Entwicklung für Android™ durchführen, verwenden Sie Map (java.util.Map) als grundlegende Schnittstelle zum Erstellen Ihrer XDM-Payload.

Benutzerdefinierte Feldergruppen

Angenommen, Sie möchten Bildschirmansichten und Interaktionen in der App selbst verfolgen. Denken Sie daran, dass Sie eine benutzerdefinierte Feldergruppe für diesen Ereignistyp definiert haben.

Identifizieren Sie in Ihrem Schema die Ereignisse, die Sie erfassen möchten.

Beginnen Sie mit dem Aufbau Ihres -Objekts.

NOTE

Standardfeldgruppen beginnen immer im Objektstamm.
Benutzerdefinierte Feldergruppen beginnen immer unter einem Objekt, das für Ihre Experience Cloud-Organisation eindeutig ist, _techmarketingdemos in diesem Beispiel.

Für das Ereignis „App Interaction“ würden Sie ein -Objekt wie das folgende erstellen:

let xdmData: [String: Any] = [
  "eventType": "application.interaction",
  "_techmarketingdemos": [
    "appInformation": [
        "appInteraction": [
            "name": "login",
            "appAction": [
                "value": 1
                ]
            ]
        ]
    ]
]

Für das Bildschirm-Tracking-Ereignis würden Sie ein Objekt wie das folgende erstellen:

var xdmData: [String: Any] = [
  "eventType": "application.scene",
  "_techmarketingdemos": [
      "appInformation": [
          "appStateDetails": [
              "screenType": "App",
                  "screenName": "luma: content: ios: us: en: login",
                  "screenView": [
                      "value": 1
                  ]
              ]
          ]
      ]
]

Sie können diese Datenstruktur jetzt verwenden, um eine ExperienceEvent zu erstellen.
let event = ExperienceEvent(xdm: xdmData)
Senden Sie das Ereignis und die Daten an das Platform-Edge Network.
Edge.sendEvent(experienceEvent: event)

Erneut implementieren wir diesen Code in Ihrem Xcode-Projekt.

Zur Vereinfachung definieren Sie zwei Funktionen in MobileSDK. Navigieren Sie in Ihrem Xcode-Projekt Navigator zu  Luma > Luma > Utils > MobileSDK.

Eines für App-Interaktionen. Fügen Sie den folgenden Code zur func sendAppInteractionEvent(actionName: String) hinzu:

// Set up a data dictionary, create an experience event and send the event.
let xdmData: [String: Any] = [
    "eventType": "application.interaction",
    tenant : [
        "appInformation": [
            "appInteraction": [
                "name": actionName,
                "appAction": [
                    "value": 1
                ]
            ]
        ]
    ]
]
let appInteractionEvent = ExperienceEvent(xdm: xdmData)
Edge.sendEvent(experienceEvent: appInteractionEvent)

Diese Funktion verwendet den Aktionsnamen als Parameter und

richtet die XDM-Payload mithilfe des Parameters aus der -Funktion als Wörterbuch ein,
ein Erlebnisereignis mithilfe des Wörterbuchs einrichtet,
sendet das Erlebnisereignis über die Edge.sendEvent-API.

Und einen für Bildschirmverfolgung. Fügen Sie den folgenden Code zur func sendTrackScreenEvent(stateName: String) hinzu:

// Set up a data dictionary, create an experience event and send the event.
let xdmData: [String: Any] = [
    "eventType": "application.scene",
    tenant : [
        "appInformation": [
            "appStateDetails": [
                "screenType": "App",
                "screenName": stateName,
                "screenView": [
                    "value": 1
                ]
            ]
        ]
    ]
]
let trackScreenEvent = ExperienceEvent(xdm: xdmData)
Edge.sendEvent(experienceEvent: trackScreenEvent)

Diese Funktion verwendet den Statusnamen als Parameter und

richtet die XDM-Payload mithilfe des Parameters aus der -Funktion als Wörterbuch ein,
ein Erlebnisereignis mithilfe des Wörterbuchs einrichtet,
sendet das Erlebnisereignis über die Edge.sendEvent-API.

Navigieren Sie zu Luma > Luma > Views > General > LoginSheet.
1. Fügen Sie den folgenden hervorgehobenen Code zum Schließen der Schaltfläche „Anmelden“ hinzu:
  // Send app interaction event MobileSDK.shared.sendAppInteractionEvent(actionName: "login")
2. Fügen Sie den folgenden hervorgehobenen Code zu onAppear Modifikator hinzu:
  // Send track screen event MobileSDK.shared.sendTrackScreenEvent(stateName: "luma: content: ios: us: en: login")

Validierung

Lesen Sie den Abschnitt Setup-Anweisungen, um Ihren Simulator oder Ihr Gerät mit Assurance zu verbinden.
1. Verschieben Sie das Assurance-Symbol nach links.
2. Wählen Sie Startseite in der Registerkartenleiste aus und vergewissern Sie sich, dass ECID, E-Mail und CRM ID auf dem Startbildschirm angezeigt werden.
3. Wählen Sie Products in der Registerkartenleiste aus.
4. Produkt auswählen.
5. Auswählen .
6. Auswählen .
7. Auswählen .
Suchen Sie in der Assurance-Benutzeroberfläche nach den hitReceived-Ereignissen des Anbieters com.adobe.edge..
Wählen Sie das Ereignis aus und überprüfen Sie die XDM-Daten im messages-Objekt. Alternativ können Sie Rohereignis kopieren verwenden und einen Text- oder Code-Editor Ihrer Wahl verwenden, um das Ereignis einzufügen und zu überprüfen.

Nächste Schritte

Sie sollten jetzt über alle Tools verfügen, um mit dem Hinzufügen der Datenerfassung zu Ihrer App zu beginnen. Sie können die Interaktion der Benutzenden mit Ihren Produkten in der App intelligenter gestalten und der App weitere Interaktionen und Bildschirm-Tracking-Aufrufe hinzufügen:

Implementieren Sie die Bestellung, den Checkout, den leeren Warenkorb und andere Funktionen in der App und fügen Sie dieser Funktion relevante Commerce-Erlebnisereignisse hinzu.
Wiederholen Sie den Aufruf von sendAppInteractionEvent mit dem entsprechenden Parameter, um andere App-Interaktionen des Benutzers zu verfolgen.
Wiederholen Sie den Aufruf von sendTrackScreenEvent mit dem entsprechenden Parameter, um die vom Benutzer in der App angezeigten Bildschirme zu verfolgen.

TIP

Sehen Sie sich die fertige App an, um weitere Beispiele zu erhalten.

Senden von Ereignissen an Analytics und Platform

Nachdem Sie die Ereignisse erfasst und an das Platform-Edge Network gesendet haben, werden sie an die Programme und Services gesendet, die in Ihrem Datenstrom“ konfiguriert. In späteren Lektionen ordnen Sie diese Daten Adobe Analytics, Adobe Experience Platform und anderen Adobe Experience Cloud-Lösungen wie Adobe Target und Adobe Journey Optimizer zu.

SUCCESS

Sie haben jetzt Ihre App so eingerichtet, dass sie Commerce-, App-Interaktions- und Bildschirm-Tracking-Ereignisse bis zum Adobe Experience Platform-Edge Network und allen Services verfolgt, die Sie in Ihrem Datenstrom definiert haben.

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: WebViews behandeln

recommendation-more-help