DokumentationExperience PlatformTutorial für Mobile Apps

Erfassen von Identitätsdaten

Last update: Fri Sep 12 2025 00:00:00 GMT+0000 (Coordinated Universal Time)
  • Themen:

Erstellt für:

  • Einsteiger
  • Fortgeschrittener
  • Entwickler

Erfahren Sie, wie Sie Identitätsdaten in einer Mobile App erfassen.

Mit Adobe Experience Platform Identity Service erhalten Sie einen besseren Überblick über Ihre Kunden und deren Verhalten. Der Service führt Identitäten geräte- und systemübergreifend zusammen und ermöglicht es Ihnen, in Echtzeit für eindrucksvolle persönliche digitale Erlebnisse zu sorgen. Identitätsfelder und Namespaces verbinden verschiedene Datenquellen miteinander, um das 360-Grad-Echtzeit-Kundenprofil zu erstellen.

Weitere Informationen zur Identity-Erweiterung und zum Identity Service finden Sie in der Dokumentation.

Voraussetzungen

  • App mit installierten und konfigurierten SDKs erfolgreich erstellt und ausgeführt.

Lernziele

In dieser Lektion erfahren Sie Folgendes:

  • Richten Sie einen benutzerdefinierten Identity-Namespace ein.
  • Aktualisieren von Identitäten.
  • Validieren des Identitätsdiagramms.
  • Abrufen von ECID und anderen Identitäten.

Einrichten eines benutzerdefinierten Identity-Namespace

Identity-Namespaces sind Komponenten von Identity Service die als Indikatoren für den Kontext dienen, auf den sich eine Identität bezieht. Sie identifizieren beispielsweise den Wert name@email.com als E-Mail-Adresse oder 443522 als numerische CRM-ID.

NOTE
Die Mobile SDK generiert eine eindeutige Identität in einem eigenen Namespace, der als Experience Cloud ID (ECID) bezeichnet wird, wenn die App installiert wird. Diese ECID wird im permanenten Speicher auf dem Mobilgerät gespeichert und bei jedem Treffer gesendet. Die ECID wird entfernt, wenn Benutzende die App deinstallieren oder den globalen Datenschutzstatus von Mobile SDK auf „Opt-out“ setzen. In der Beispiel-Luma-App sollten Sie die App entfernen und erneut installieren, um ein neues Profil mit einer eigenen eindeutigen ECID zu erstellen.

So erstellen Sie einen neuen Identity-Namespace:

  1. Wählen Sie in der Datenerfassungs-Benutzeroberfläche Identitäten in der linken Navigationsleiste aus.

  2. Wählen Sie Identity-Namespace erstellen aus.

  3. Geben Sie einen Anzeigenamen von Luma CRM ID und den Wert Identitätssymbol von lumaCRMId an.

  4. Wählen Sie Geräteübergreifende ID aus.

  5. Wählen Sie Erstellen aus.

    Identity-Namespace erstellen {modal="regular"}

Aktualisieren von Identitäten

Sie möchten sowohl die Standardidentität (E-Mail) als auch die benutzerdefinierte Identität (Luma CRM ID) aktualisieren, wenn sich der Benutzer bei der App anmeldet.

iOS

  1. Navigieren Sie im Xcode-Projekt-Luma zu Luma > Utils > > MobileSDK) und suchen Sie nach der Implementierung der func updateIdentities(emailAddress: String, crmId: String). Fügen Sie der Funktion den folgenden Code hinzu.

    code language-swift 
    // Set up identity map, add identities to map and update identities
let identityMap: IdentityMap = IdentityMap()

let emailIdentity = IdentityItem(id: emailAddress, authenticatedState: AuthenticatedState.authenticated)
let crmIdentity = IdentityItem(id: crmId, authenticatedState: AuthenticatedState.authenticated)
identityMap.add(item:emailIdentity, withNamespace: "Email")
identityMap.add(item: crmIdentity, withNamespace: "lumaCRMId")

Identity.updateIdentities(with: identityMap)

    Dieser Code:

    1. Erstellt ein leeres IdentityMap.

      code language-swift 
      let identityMap: IdentityMap = IdentityMap()

    2. Richtet IdentityItem Objekte für E-Mail und CRM-ID ein.

      code language-swift 
      let emailIdentity = IdentityItem(id: emailAddress, authenticatedState: AuthenticatedState.authenticated)
let crmIdentity = IdentityItem(id: crmId, authenticatedState: AuthenticatedState.authenticated)

    3. Fügt dem IdentityItem-Objekt diese IdentityMap-Objekte hinzu.

      code language-swift 
      identityMap.add(item:emailIdentity, withNamespace: "Email")
identityMap.add(item: crmIdentity, withNamespace: "lumaCRMId")

    4. Sendet das IdentityItem als Teil des Identity.updateIdentities-API-Aufrufs an die Edge Network.

      code language-swift 
      Identity.updateIdentities(with: identityMap)

  2. Navigieren Sie im Xcode-Projekt-Navigator zu Luma > Luma > Views > General > LoginSheet und suchen Sie den Code, der ausgeführt werden soll, wenn Sie die Schaltfläche Login auswählen. Fügen Sie den folgenden Code hinzu:

    code language-swift 
    // Update identities
MobileSDK.shared.updateIdentities(emailAddress: currentEmailId, crmId: currentCRMId)
Android

  1. Android Navigieren Sie im Android Studio-Navigator zu ​ ChevronDown > app > kotlin+java > com.adobe.luma.tutorial.android > models > MobileSDK und suchen Sie nach der Implementierung der fun updateIdentities(emailAddress: String, crmId: String) . Fügen Sie der Funktion den folgenden Code hinzu.

    code language-kotlin 
    // Set up identity map, add identities to map and update identities
val identityMap = IdentityMap()

val emailIdentity = IdentityItem(emailAddress, AuthenticatedState.AUTHENTICATED, true)
val crmIdentity = IdentityItem(crmId, AuthenticatedState.AUTHENTICATED, true)
identityMap.addItem(emailIdentity, "Email")
identityMap.addItem(crmIdentity, "lumaCRMId")

Identity.updateIdentities(identityMap)

    Dieser Code:

    1. Erstellt ein leeres IdentityMap.

      code language-kotlin 
      val identityMap = IdentityMap()

    2. Richtet IdentityItem Objekte für E-Mail und CRM-ID ein.

      code language-kotlin 
      val emailIdentity = IdentityItem(emailAddress, AuthenticatedState.AUTHENTICATED, true)
val crmIdentity = IdentityItem(crmId, AuthenticatedState.AUTHENTICATED, true)

    3. Fügt dem IdentityItem-Objekt diese IdentityMap-Objekte hinzu.

      code language-kotlin 
      identityMap.addItem(emailIdentity, "Email")
identityMap.addItem(crmIdentity, "lumaCRMId")

    4. Sendet das IdentityItem als Teil des Identity.updateIdentities-API-Aufrufs an die Edge Network.

      code language-kotlin 
      Identity.updateIdentities(identityMap)

  2. Navigieren Sie im Android Studio-Navigator zu Android ChevronDown > app > kotlin+java > com.adobe.luma.tutorial.android > views > LoginSheet.kt und suchen Sie den Code, der bei Auswahl der Schaltfläche Login ausgeführt werden soll. Fügen Sie den folgenden Code hinzu:

    code language-kotlin 
    // Update identities
MobileSDK.shared.updateIdentities(
   MobileSDK.shared.currentEmailId.value,
   MobileSDK.shared.currentCRMId.value
)
NOTE
Sie können mehrere Identitäten in einem einzigen updateIdentities-Aufruf senden. Sie können auch zuvor gesendete Identitäten ändern.

Entfernen einer Identität

Sie können die Identity.removeIdentity-API verwenden, um die Identität aus der gespeicherten Client-seitigen Identitätszuordnung zu entfernen. Die Identity-Erweiterung sendet die Kennung nicht mehr an die Edge Network. Bei Verwendung dieser API wird die Kennung nicht aus dem serverseitigen Identitätsdiagramm entfernt. Weitere zu Identitätsdiagrammen finden Sie„Anzeigen von Identitätsdiagrammen“.

iOS

  1. Navigieren Sie im Xcode-Projekt-Luma zu Luma > Utils > > MobileSDK) und fügen Sie den folgenden Code zur func removeIdentities(emailAddress: String, crmId: String) hinzu:

    code language-swift 
    // Remove identities and reset email and CRM Id to their defaults
Identity.removeIdentity(item: IdentityItem(id: emailAddress), withNamespace: "Email")
Identity.removeIdentity(item: IdentityItem(id: crmId), withNamespace: "lumaCRMId")
currentEmailId = "testUser@gmail.com"
currentCRMId = "b642b4217b34b1e8d3bd915fc65c4452"

  2. Navigieren Sie im Xcode-Projekt-Navigator zu Luma > Luma > Views > General > LoginSheet und suchen Sie den Code, der ausgeführt werden soll, wenn Sie die Schaltfläche Abmelden auswählen. Fügen Sie den folgenden Code hinzu:

    code language-swift 
    // Remove identities
MobileSDK.shared.removeIdentities(emailAddress: currentEmailId, crmId: currentCRMId)
Android

  1. Android Navigieren Sie im Android Studio-Navigator zu ​ ChevronDown > app > kotlin+java > com.adobe.luma.tutorial.android > models > MobileSDK und fügen Sie den folgenden Code zur fun removeIdentities(emailAddress: String, crmId: String) hinzu:

    code language-kotlin 
    // Remove identities and reset email and CRM Id to their defaults
Identity.removeIdentity(IdentityItem(emailAddress), "Email")
Identity.removeIdentity(IdentityItem(crmId), "lumaCRMId")
currentEmailId.value = "testUser@gmail.com"
currentCRMId.value = "112ca06ed53d3db37e4cea49cc45b71e"

​1. Navigieren Sie im Android Studio-Navigator zu app > kotlin+java > com.adobe.luma.tutorial.android > views > LoginSheet.kt und suchen Sie den Code, der ausgeführt werden soll, wenn Sie die Schaltfläche Logout auswählen. Fügen Sie den folgenden Code hinzu:

code language-kotlin 
// Remove identities
MobileSDK.shared.removeIdentities(
   MobileSDK.shared.currentEmailId.value,
   MobileSDK.shared.currentCRMId.value
)

Mit Assurance validieren

  1. Lesen Sie den Abschnitt Setup-Anweisungen, um Ihren Simulator oder Ihr Gerät mit Assurance zu verbinden.

  2. In der Luma-App

    1. Wählen Sie die Startseite und verschieben Sie das Assurance-Symbol nach links.
    2. Wählen Sie oben das Symbol Benutzer“ aus.
iOS
{width="300"}
Android
{width="300"}

Im Bildschirm Identitäten:

  1. Geben Sie eine E-Mail-Adresse und eine CRM-ID an oder
  2. Select a | (iOS) oder Zufällige E-Mail generieren (Android), um nach dem Zufallsprinzip eine E-Mail- und CRM-ID generieren.
  3. Wählen Sie Anmelden aus.
iOS
{width="300"}
Android
{width="300"}

Zurück in Assurance:

  1. Überprüfen Sie die Assurance-Web-Oberfläche auf das Ereignis Edge Identity Update Identities' vom Anbieter com.adobe.griffon.mobile.

  2. Wählen Sie das Ereignis aus und überprüfen Sie die Daten im ACPExextensionEventData-Objekt. Die aktualisierten Identitäten sollten angezeigt werden.

    Aktualisierung von Identitäten validieren {modal="regular"}

Mit Identitätsdiagramm validieren

Nachdem Sie die Schritte in der Experience Platform-Lektion abgeschlossen haben, können Sie die Identitätserfassung im Experience Platform-Identitätsdiagramm-Viewer bestätigen:

  1. Wählen Identitäten in der Datenerfassungs-Benutzeroberfläche aus.

  2. Wählen Sie Identitätsdiagramm in der oberen Leiste aus.

  3. Geben Sie Luma CRM ID als Identity-Namespace und Ihre CRM-ID (z. B. 24e620e255734d8489820e74f357b5c8) als Identitätswert ein.

  4. Sie sehen die Identitäten aufgelistet.

    Identitätsdiagramm validieren {modal="regular"}

INFO
In der App ist kein Code zum Zurücksetzen der ECID vorhanden. Sie können die ECID nur durch eine Deinstallation und eine Neuinstallation der Anwendung zurücksetzen (und tatsächlich ein neues Profil mit einer neuen ECID erstellen). Informationen zum Implementieren des Zurücksetzens von Kennungen finden Sie in den Identity.resetIdentities und MobileCore.resetIdentities API-Aufrufen. Beachten Sie, dass bei Verwendung einer Push-Benachrichtigungs-ID (siehe Senden von Push-Benachrichtigungen) diese Kennung zu einer weiteren „Sticky“-Profilkennung auf dem Gerät wird.
SUCCESS
Sie haben jetzt Ihre App so eingerichtet, dass Identitäten in der Edge Network und (wenn eingerichtet) in Adobe Experience Platform aktualisiert werden.
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: Erfassen von Profildaten

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