DokumentationExperience PlatformTutorial für Mobile Apps

Identitätsdaten erfassen

Last update: Tue Jul 16 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.

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 zur Identitätserweiterung und zum Identitätsdienst finden Sie 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

Identitäts-Namespaces sind Komponenten von Identitätsdienst , die als Indikatoren für den Kontext dienen, auf den sich eine Identität bezieht. Sie unterscheiden beispielsweise den Wert 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 Datenerfassungs-Oberfläche im Navigationsbereich auf der linken Schiene die Option Identitäten aus.

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

  3. Geben Sie den 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.

    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 im Xcode Project-Navigator zu Luma > Luma > Utils > MobileSDK und suchen Sie nach der Implementierung der Funktion 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 -Objekt.

      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 diese IdentityItem -Objekte zum Objekt IdentityMap hinzu.

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

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

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

  2. Navigieren Sie im Xcode Project-Navigator zu Luma > Luma > Views > General > LoginSheet und suchen Sie nach dem Code, der ausgeführt werden soll, wenn Sie die Schaltfläche Anmelden 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 einzelnen updateIdentities -Aufruf senden. Sie können auch zuvor gesendete Identitäten ändern.

Identität entfernen

Sie können die API Identity.removeIdentity verwenden, um die Identität aus der gespeicherten clientseitigen Identitätszuordnung zu entfernen. Die ID-Erweiterung stoppt das Senden der Kennung an das Edge Network. Die Verwendung dieser API entfernt die Kennung nicht aus dem serverseitigen Identitätsdiagramm. Weitere Informationen zu Identitätsdiagrammen finden Sie unter Identitätsdiagramme anzeigen .

  1. Navigieren Sie im Xcode Project-Navigator zu Luma > Luma > Utils > MobileSDK und fügen Sie den folgenden Code zur Funktion 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 Project-Navigator zu Luma > Luma > Views > General > LoginSheet und suchen Sie nach dem Code, der ausgeführt werden soll, wenn Sie die Schaltfläche Logout 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 instructions , um Ihren Simulator oder Ihr Gerät mit Assurance zu verbinden.

  2. In der Luma-App

    1. Wählen Sie die Registerkarte Home aus und verschieben Sie das Symbol "Versicherung"nach links.

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

      {width="300"}

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

    4. Auswählen {width="15"} , um nach dem Zufallsprinzip eine E-Mail und eine 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 Objekt ACPExtensionEventData . Sie sollten die von Ihnen aktualisierten Identitäten sehen.
    validate identities update

Validieren mit Identitätsdiagramm

Nachdem Sie die Schritte in der Experience Platform-Lektion 🔗 ausgeführt haben, können Sie die Identitätserfassung im Viewer für Identitätsdiagramme für Plattformen bestätigen:

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

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

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

  4. Sie sehen die Identitäten aufgelistet.

    Identitätsdiagramm validieren

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 in den API-Aufrufen Identity.resetIdentities und MobileCore.resetIdentities . Beachten Sie jedoch bei Verwendung einer Push-Benachrichtigungs-ID (siehe Push-Benachrichtigungen senden), dass diese Kennung zu einer weiteren "Sticky"-Profilkennung auf dem Gerät wird.
SUCCESS
Sie haben Ihre App jetzt so eingerichtet, dass Identitäten im Edge Network 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, allgemeine Rückmeldungen oder Anregungen zu künftigen Inhalten teilen möchten, teilen Sie diese auf diesem Experience League Community-Diskussionbeitrag mit.

Weiter: Profildaten erfassen

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