Konfiguration von Identity-Namespaces

Experience Platform verwendet Identity-Namespaces, um den Typ bestimmter Identitäten zu beschreiben. Beispiel: ein Identity-Namespace namens Email identifiziert einen Wert wie name@email.com als E-Mail-Adresse.

Beachten Sie je nach dem von Ihnen erstellten Zieltyp (Streaming oder dateibasiert) die folgenden Anforderungen an Identity-Namespaces:

Weitere Informationen zu Identity-Namespaces in Experience Platform finden Sie in der Dokumentation zu Identity-Namespaces.

Beim Konfigurieren von Identity-Namespaces für Ihr Ziel können Sie die von Ihrem Ziel unterstützte Zielidentitätszuordnung anpassen, z. B.:

Informationen dazu, wo diese Komponente in eine mit Destination SDK erstellte Integration passt, finden Sie im Diagramm in der Dokumentation Konfigurationsoptionen oder im Handbuch Verwenden von Destination SDK zum Konfigurieren eines dateibasierten Ziels.

Sie können Ihre unterstützten Identity-Namespaces über den /authoring/destinations-Endpunkt konfigurieren. Detaillierte Beispiele für API-Aufrufe, in denen Sie die auf dieser Seite angezeigten Komponenten konfigurieren können, finden Sie auf den folgenden API-Referenzseiten.

In diesem Artikel werden alle unterstützten Konfigurationsoptionen für Identity-Namespaces beschrieben, die Sie für Ihr Ziel verwenden können, und es wird gezeigt, was Sie in der Experience Platform Benutzeroberfläche sehen.

Unterstützte Integrationstypen supported-integration-types

Die nachstehende Tabelle beschreibt ausführlich, welche Integrationstypen die auf dieser Seite beschriebenen Funktionen unterstützen.

Unterstützte Parameter supported-parameters

Bei der Definition der Zielidentitäten, die Ihr Ziel unterstützt, können Sie die in der folgenden Tabelle beschriebenen Parameter verwenden, um ihr Verhalten zu konfigurieren.

"identityNamespaces":{
      "external_id":{
         "acceptsAttributes":true,
         "acceptsCustomNamespaces":true,
         "acceptedGlobalNamespaces":{
            "Email":{
            }
         }
      },
      "another_id":{
         "acceptsAttributes":true,
         "acceptsCustomNamespaces":true
      }
   }

Sie müssen angeben, welche Experience Platform Identitäten Sie an Ihr Ziel exportieren können. Einige Beispiele: Experience Cloud ID, gehashte E-Mail, Geräte-ID (IDFA, GAID). Diese Werte sind Experience Platform Identity-Namespaces, die Sie von Ihrem Ziel aus Identity-Namespaces zuordnen können.

Identity-Namespaces erfordern keine 1:1-Korrespondenz zwischen Experience Platform und Ihrem Ziel. Sie können beispielsweise einen Experience Platform IDFA-Namespace einem IDFA-Namespace Ihres Ziels zuordnen oder Sie können denselben Experience Platform IDFA-Namespace einem Customer ID-Namespace in Ihrem Ziel zuordnen.

Mehr zu Identitäten erfahren Sie in der Übersicht über Identity-Namespaces.

Zuordnungsüberlegungen mapping-considerations

Wenn Sie einen Quell-Identity-Namespace auswählen und keine Zielzuordnung auswählen, füllt Experience Platform die Zielzuordnung automatisch mit einem Attribut mit demselben Namen.

Konfigurieren des optionalen Hashing für Quellfelder configure-optional-hashing

In Experience Platform können Sie Daten im Hash-Format oder im Nur-Text-Format aufnehmen. Wenn Ihre Zielplattform sowohl gehashte als auch ungehashte Daten akzeptiert, können Sie festlegen, ob Experience Platform die Quellfeldwerte beim Export in Ihr Ziel hasst.

Die folgende Konfiguration aktiviert die optionale Option Umwandlung anwenden in der Experience Platform-Benutzeroberfläche im Schritt „Zuordnung“.

"identityNamespaces":{
      "Customer_contact":{
         "acceptsAttributes":true,
         "acceptsCustomNamespaces":true,
         "transformation": "sha256(lower($))",
         "acceptedGlobalNamespaces":{
            "Email":{
            },
            "Phone":{
            }
         }
      }
   }

Aktivieren Sie diese Option, wenn Sie nicht gehashte Quellfelder verwenden, damit diese automatisch von Adobe Experience Platform bei der Aktivierung gehasht werden.

Wenn Sie ungehashte Quellattribute Zielattributen zuordnen, von denen das Ziel erwartet, dass sie gehasht werden (z. B.: email_lc_sha256 oder phone_sha256), aktivieren Sie die Option Umwandlung anwenden, damit Adobe Experience Platform die Quellattribute bei Aktivierung automatisch hasht.

Konfigurieren von obligatorischem Hashing für Quellfelder configure-mandatory-hashing

Wenn Ihr Ziel nur Hash-Daten akzeptiert, können Sie die exportierten Attribute so konfigurieren, dass sie automatisch von Experience Platform gehasht werden. Die folgende Konfiguration aktiviert automatisch die Option Umwandlung anwenden, wenn die Email- und Phone-Identitäten zugeordnet werden.

"identityNamespaces":{
      "Customer_contact":{
         "acceptsAttributes":true,
         "acceptsCustomNamespaces":true,
         "transformation": "sha256(lower($))",
         "acceptedGlobalNamespaces":{
            "Email":{
               "requiredTransformation": "sha256(lower($))"
            },
            "Phone":{
               "requiredTransformation": "sha256(lower($))"
            }
         }
      }
   }

Nächste Schritte next-steps

Sie wissen jetzt, wie Sie Identity-Namespaces für Ziele konfigurieren, die mit Destination SDK erstellt wurden, einschließlich der Zulassung von Attribut- und Namespace-Zuordnungen und der Anwendung optionalen oder obligatorischen Hashings beim Export.

Weitere Informationen zu den anderen Zielkomponenten finden Sie in den folgenden Artikeln: