DokumentationExperience PlatformTutorial für Mobile Apps

Erfassen von Identitätsdaten

Last update: Tue Dec 31 2024 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.

Adobe Experience Platform Identity Service hilft Ihnen, sich einen besseren Überblick über Ihre Kunden und deren Verhalten zu verschaffen, indem Identitäten geräte- und systemübergreifend zusammengeführt werden. So können Sie in Echtzeit für eindrucksvolle persönliche digitale Erlebnisse 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

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.

  1. Navigieren Sie im Xcode-Projekt-zu ​ Luma​ > ​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 IdentityMap-Objekt diese IdentityItem-Objekte hinzu.

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

    4. Sendet das IdentityItem-Objekt als Teil des Identity.updateIdentities-API-Aufrufs an das -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)
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 Identitätserweiterung stoppt das Senden der Kennung an das 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“.

  1. Navigieren Sie im Xcode-Projekt-zu ​ Luma​ > ​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 = "112ca06ed53d3db37e4cea49cc45b71e"

  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)

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 die {width="15"} oben rechts.

      {width="300"}

    3. Geben Sie eine E-Mail-Adresse und eine CRM-ID an oder

    4. Auswählen {width="15"} nach dem Zufallsprinzip eine E-Mail und CRM ID zu generieren.

    5. Wählen Sie Anmelden aus.

      {width="300"}

  3. Suchen Sie in der Assurance-Web-Oberfläche nach dem Ereignis Edge Identity Update Identities vom Anbieter com.adobe.griffon.mobile.

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

Mit Identitätsdiagramm validieren

Nachdem Sie die Schritte in der Experience Platform-Lektion abgeschlossen haben können Sie die Identitätserfassung in der Identitätsdiagramm-Anzeige von Platform 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

INFO
Es gibt keinen Code in der App, um die ECID zurückzusetzen. Das bedeutet, dass Sie die ECID nur durch eine Deinstallation und eine Neuinstallation der Anwendung zurücksetzen (und effektiv ein neues Profil mit einer neuen ECID erstellen) können. Informationen zum Implementieren des Zurücksetzens von Kennungen finden Sie in den Identity.resetIdentities und MobileCore.resetIdentities API-Aufrufen. Beachten Sie jedoch, 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 im 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