DokumentationExperience PlatformTutorial für Mobile Apps

Identitätsdaten erfassen

Last update: Tue Dec 05 2023 00:00:00 GMT+0000 (Coordinated Universal Time)

Erstellt für:

  • Beginner
  • Intermediate
  • Developer

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, indem Sie Identitäten zwischen Geräten und Systemen überbrücken und so effektive persönliche digitale Erlebnisse in Echtzeit bereitstellen. Identitätsfelder und Namespaces sind der Kleber, der verschiedene Datenquellen verbindet, um das 360-Grad-Echtzeit-Kundenprofil zu erstellen.

Weitere Informationen zum Identitätserweiterung und Identitätsdienst in der Dokumentation.

Voraussetzungen

  • App erfolgreich erstellt und ausgeführt, wobei SDKs installiert und konfiguriert sind.

Lernziele

In dieser Lektion werden Sie:

  • Richten Sie einen benutzerdefinierten Identitäts-Namespace ein.
  • Identitäten aktualisieren.
  • Überprüfen Sie das Identitätsdiagramm.
  • Abrufen von ECID und anderen Identitäten.

Einrichten eines benutzerdefinierten Identitäts-Namespace

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

NOTE
Das Mobile SDK generiert eine eindeutige Identität in seinem eigenen Namespace namens Experience Cloud ID (ECID), wenn die App installiert wird. Diese ECID wird im persistenten Speicher auf dem Mobilgerät gespeichert und bei jedem Treffer gesendet. Die ECID wird entfernt, wenn der Benutzer die App deinstalliert oder den globalen Datenschutzstatus des Mobile SDK auf "Opt-out"setzt. In der Beispielanwendung "Luma"sollten Sie die App entfernen und neu installieren, um ein neues Profil mit einer eigenen eindeutigen ECID zu erstellen.

So erstellen Sie einen neuen Identitäts-Namespace:

  1. Wählen Sie in der Datenerfassungsoberfläche die Option Identitäten über die Navigationsleiste auf der linken Schiene aus.

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

  3. Stellen Sie eine Anzeigename von Luma CRM ID und Identitätssymbol Wert von lumaCRMId.

  4. Auswählen Geräteübergreifende ID.

  5. Wählen Sie Erstellen aus.

    Identitäts-Namespace erstellen

Identitäten aktualisieren

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 zu Luma > Luma > Utils > MobileSDK im Xcode-Projektnavigator und suchen Sie die func updateIdentities(emailAddress: String, crmId: String) -Funktionsimplementierung. 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 eine leere IdentityMap -Objekt.

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

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

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

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

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

    4. Sendet die IdentityItem -Objekt als Teil der Identity.updateIdentities API-Aufruf an das Edge-Netzwerk.

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

  2. Navigieren Sie zu Luma > Luma > Views > General > LoginSheet im Xcode Project-Navigator und suchen Sie den Code, der beim Auswählen der Anmelden Schaltfläche. 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 einer updateIdentities aufrufen. Sie können auch zuvor gesendete Identitäten ändern.

Identität entfernen

Sie können die Identity.removeIdentity API zum Entfernen der Identität aus der gespeicherten clientseitigen Identitätszuordnung. Die ID-Erweiterung sendet die Kennung nicht mehr an das Edge-Netzwerk. Die Verwendung dieser API entfernt die Kennung nicht aus dem serverseitigen Identitätsdiagramm. Siehe Identitätsdiagramme anzeigen für weitere Informationen zu Identitätsdiagrammen.

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

    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 zu Luma > Luma > Views > General > LoginSheet im Xcode Project-Navigator und suchen Sie den Code, der beim Auswählen der Abmelden Schaltfläche. Fügen Sie den folgenden Code hinzu:

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

Validierung mit Versicherung

  1. Überprüfen Sie die Einrichtungsanweisungen -Abschnitt, 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 Symbol Versicherung nach links.

    2. Wählen Sie die {width="15"} rechts oben.

      {width="300"}

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

    4. Auswählen {width="15"} zufällig generieren Sie eine Email und CRM-ID.

    5. Auswählen Anmelden.

      {width="300"}

  3. Suchen Sie in der Assurance-Webschnittstelle nach dem Identitäten für Edge-Identitätsaktualisierungen -Ereignis aus com.adobe.griffon.mobile -Anbieter.

  4. Wählen Sie das Ereignis aus und überprüfen Sie die Daten im ACPExtensionEventData -Objekt. Sie sollten die von Ihnen aktualisierten Identitäten sehen.
    Aktualisierung von Identitäten überprüfen

Validieren mit Identitätsdiagramm

Nachdem Sie die Schritte im Abschnitt Experience Platform-Lektionkönnen Sie die Identitätserfassung im Platform-Identitätsdiagramm-Viewer bestätigen:

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

  2. Auswählen Identitätsdiagramm aus der oberen Leiste.

  3. Eingabe Luma CRM ID als Identitäts-Namespace und Ihrer CRM-ID (z. B. 24e620e255734d8489820e74f357b5c8) als Identitätswert.

  4. Sie sehen die Identitäten aufgelistet.

    Identitätsdiagramm überprüfen

INFO
In der App gibt es keinen Code zum Zurücksetzen der ECID. Das bedeutet, dass Sie die ECID nur zurücksetzen (und effektiv ein neues Profil mit einer neuen ECID erstellen) können, indem Sie die Anwendung deinstallieren und neu installieren. Informationen zum Implementieren des Zurücksetzens von Kennungen finden Sie unter Identity.resetIdentities und MobileCore.resetIdentities API-Aufrufe. Beachten Sie jedoch bei Verwendung einer Push-Benachrichtigungs-ID (siehe Push-Benachrichtigungen senden), wird diese Kennung zu einer weiteren "Sticky"-Profilkennung auf dem Gerät.
SUCCESS
Sie haben Ihre App jetzt so eingerichtet, dass Identitäten im Edge-Netzwerk und (falls eingerichtet) mit Adobe Experience Platform aktualisiert werden.
Vielen Dank, dass Sie Ihre Zeit investiert haben, um mehr über das Adobe Experience Platform Mobile SDK zu erfahren. Wenn Sie Fragen haben, ein allgemeines Feedback oder Vorschläge zu künftigen Inhalten teilen möchten, teilen Sie diese hier mit. Experience League Community-Diskussionsbeitrag

Weiter: Profildaten erfassen

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