Adobe Experience Platform unterstützt die Möglichkeit, externe Zielgruppen zu importieren, die anschließend als Komponenten für eine neue Segmentdefinition verwendet werden können. Dieses Dokument enthält ein Tutorial zum Einrichten der Experience Platform zum Importieren und Verwenden externer Zielgruppen.
Dieses Tutorial setzt ein Verständnis der verschiedenen Adobe Experience Platform Dienste, die an der Erstellung von Zielgruppensegmenten beteiligt sind. Bevor Sie mit diesem Tutorial beginnen, lesen Sie bitte die Dokumentation für die folgenden Services:
Bevor Sie mit dem Importieren und Verwenden externer Zielgruppen beginnen, müssen Sie den Unterschied zwischen Segmentdaten und Segmentmetadaten verstehen.
Segmentdaten beziehen sich auf die Profile, die die Segmentqualifikationskriterien erfüllen und daher Teil der Zielgruppe sind.
Segmentmetadaten sind Informationen zum Segment selbst, einschließlich Name, Beschreibung, Ausdruck (falls zutreffend), Erstellungsdatum, Datum der letzten Änderung und Kennung. Die ID verknüpft die Segmentmetadaten mit den einzelnen Profilen, die die Segmentqualifikation erfüllen und Teil der resultierenden Zielgruppe sind.
Segmentieren von Daten | Segmentmetadaten |
---|---|
Profile, die die Segmentqualifikation erfüllen | Informationen zum Segment selbst |
Der erste Schritt zur Verwendung externer Zielgruppen besteht in der Erstellung eines Identitäts-Namespace. Identitäts-Namespaces ermöglichen es Platform, zu verknüpfen, woher ein Segment stammt.
Um einen Identitäts-Namespace zu erstellen, befolgen Sie die Anweisungen im Abschnitt Identitäts-Namespace-Handbuch. Fügen Sie beim Erstellen Ihres Identitäts-Namespace die Quelldetails zum Identitäts-Namespace hinzu und markieren Sie dessen Typ as a Personenidentifizierung.
Nachdem Sie einen Identitäts-Namespace erstellt haben, müssen Sie ein neues Schema für das Segment erstellen, das Sie erstellen werden.
Um mit der Erstellung eines Schemas zu beginnen, wählen Sie zunächst Schemas in der linken Navigationsleiste, gefolgt von der Schema erstellen in der oberen rechten Ecke des Arbeitsbereichs "Schemas". Wählen Sie von hier aus Durchsuchen um eine vollständige Auswahl der verfügbaren Schematypen anzuzeigen.
Da Sie eine Segmentdefinition erstellen, bei der es sich um eine vordefinierte Klasse handelt, wählen Sie Vorhandene Klasse verwenden. Wählen Sie nun die Segmentdefinition -Klasse, gefolgt von Klasse zuweisen.
Nachdem Ihr Schema erstellt wurde, müssen Sie angeben, welches Feld die Segment-ID enthalten soll. Dieses Feld sollte als primäre Identität markiert und den zuvor von Ihnen erstellten Namespaces zugewiesen werden.
Nachdem Sie die _id
als primäre Identität festlegen, wählen Sie den Titel des Schemas aus, gefolgt von dem Umschalter mit der Bezeichnung Profil. Auswählen Aktivieren , um das Schema für Real-Time Customer Profile.
Jetzt ist dieses Schema für Profil aktiviert, wobei die primäre Identifizierung dem von Ihnen erstellten Identitäts-Namespace ohne Person zugewiesen ist. Das bedeutet, dass Segmentmetadaten, die mithilfe dieses Schemas in Platform importiert wurden, in das Profil aufgenommen werden, ohne mit anderen personenbezogenen Profildaten zusammengeführt zu werden.
Nach dem Konfigurieren des Schemas müssen Sie einen Datensatz für die Segmentmetadaten erstellen.
Um einen Datensatz zu erstellen, befolgen Sie die Anweisungen im Abschnitt Benutzerhandbuch zu Datensätzen. Sie sollten die Datensatz aus Schema erstellen -Option unter Verwendung des zuvor erstellten Schemas.
Nachdem Sie den Datensatz erstellt haben, folgen Sie den Anweisungen im Abschnitt Benutzerhandbuch zu Datensätzen , um diesen Datensatz für das Echtzeit-Kundenprofil zu aktivieren.
Wenn der Datensatz aktiviert ist, können Daten jetzt entweder über die Benutzeroberfläche oder über die Experience Platform-APIs an Platform gesendet werden. Sie können diese Daten entweder über eine Batch- oder Streaming-Verbindung erfassen.
Um eine Batch-Verbindung zu erstellen, folgen Sie den Anweisungen im Abschnitt Handbuch zur Benutzeroberfläche für den lokalen Datei-Upload. Eine vollständige Liste der verfügbaren Quellen, mit denen Sie Daten erfassen können, finden Sie in der Quellen - Übersicht.
Um eine Streaming-Verbindung zu erstellen, folgen Sie den Anweisungen in API-Tutorial oder UI-Tutorial.
Nachdem Sie Ihre Streaming-Verbindung erstellt haben, haben Sie Zugriff auf Ihren eindeutigen Streaming-Endpunkt, an den Sie Ihre Daten senden können. Informationen zum Senden von Daten an diese Endpunkte finden Sie in der Tutorial zum Streaming von Datensatzdaten.
Nach dem Erstellen einer Verbindung können Sie Ihre Daten jetzt in Platform erfassen.
Nachfolgend finden Sie ein Beispiel der Metadaten der externen Zielgruppen-Payload:
{
"header": {
"schemaRef": {
"id": "https://ns.adobe.com/{TENANT_ID}/schemas/{SCHEMA_ID}",
"contentType": "application/vnd.adobe.xed-full+json;version=1"
},
"imsOrgId": "{ORG_ID}",
"datasetId": "{DATASET_ID}",
"source": {
"name": "Sample External Audience"
}
},
"body": {
"xdmMeta": {
"schemaRef": {
"id": "https://ns.adobe.com/{TENANT_ID}/schemas/{SCHEMA_ID}",
"contentType": "application/vnd.adobe.xed-full+json;version=1"
}
},
"xdmEntity": {
"_id": "{SEGMENT_ID}",
"description": "Sample description",
"identityMap": {
"{IDENTITY_NAMESPACE}": [{
"id": "{}"
}]
},
"segmentName" : "{SEGMENT_NAME}",
"segmentStatus": "ACTIVE",
"version": "1.0"
}
}
}
Eigenschaft | Beschreibung |
---|---|
schemaRef |
Das Schema must beziehen sich auf das zuvor erstellte Schema für die Segmentmetadaten. |
datasetId |
Die Datensatz-ID must bezieht sich auf den zuvor erstellten Datensatz für das soeben erstellte Schema. |
xdmEntity._id |
Die ID must bezieht sich auf dieselbe Segment-ID, die Sie als externe Zielgruppe verwenden. |
xdmEntity.identityMap |
Dieser Abschnitt must enthalten die Identitätsbezeichnung, die beim Erstellen des zuvor erstellten Namespace verwendet wird. |
{IDENTITY_NAMESPACE} |
Dies ist die Bezeichnung des zuvor erstellten Identitäts-Namespace. Wenn Sie beispielsweise Ihren Identitäts-Namespace "externalAudience"nennen, würden Sie ihn als Schlüssel des Arrays verwenden. |
segmentName |
Der Name des Segments, nach dem die externe Zielgruppe segmentiert werden soll. |
Nachdem die importierten Zielgruppen eingerichtet wurden, können sie im Rahmen des Segmentierungsprozesses verwendet werden. Um externe Zielgruppen zu finden, navigieren Sie zum Segment Builder und wählen Sie Zielgruppen im Felder Abschnitt.
Nachdem Sie jetzt externe Zielgruppen in Ihren Segmenten verwenden können, können Sie mit Segment Builder Segmente erstellen. Informationen zum Erstellen von Segmenten finden Sie im Abschnitt Tutorial zum Erstellen von Segmenten.
Zusätzlich zur Verwendung importierter Metadaten aus externen Zielgruppen und deren Verwendung zum Erstellen von Segmenten können Sie auch externe Segmentmitgliedschaften in Platform importieren.
Um mit der Erstellung eines Schemas zu beginnen, wählen Sie zunächst Schemas in der linken Navigationsleiste, gefolgt von der Schema erstellen in der oberen rechten Ecke des Arbeitsbereichs "Schemas". Wählen Sie von hier aus XDM Individual Profile.
Nachdem das Schema erstellt wurde, müssen Sie die Feldergruppe Segmentmitgliedschaft als Teil des Schemas hinzufügen. Wählen Sie dazu Details zur Segmentzugehörigkeit, gefolgt von Feldergruppen hinzufügen.
Stellen Sie außerdem sicher, dass das Schema für Profil. Dazu müssen Sie ein Feld als primäre Identität markieren.
Nachdem Sie Ihr Schema erstellt haben, müssen Sie einen Datensatz erstellen.
Um einen Datensatz zu erstellen, befolgen Sie die Anweisungen im Abschnitt Benutzerhandbuch zu Datensätzen. Sie sollten die Datensatz aus Schema erstellen -Option unter Verwendung des zuvor erstellten Schemas.
Nachdem Sie den Datensatz erstellt haben, folgen Sie den Anweisungen im Abschnitt Benutzerhandbuch zu Datensätzen , um diesen Datensatz für das Echtzeit-Kundenprofil zu aktivieren.
Wenn der Datensatz aktiviert ist, können Daten jetzt entweder über die Benutzeroberfläche oder über die Experience Platform-APIs an Platform gesendet werden. Sie können diese Daten entweder über eine Batch- oder Streaming-Verbindung erfassen.
Um eine Batch-Verbindung zu erstellen, folgen Sie den Anweisungen im Abschnitt Handbuch zur Benutzeroberfläche für den lokalen Datei-Upload. Eine vollständige Liste der verfügbaren Quellen, mit denen Sie Daten erfassen können, finden Sie in der Quellen - Übersicht.
Um eine Streaming-Verbindung zu erstellen, folgen Sie den Anweisungen in API-Tutorial oder UI-Tutorial.
Nachdem Sie Ihre Streaming-Verbindung erstellt haben, haben Sie Zugriff auf Ihren eindeutigen Streaming-Endpunkt, an den Sie Ihre Daten senden können. Informationen zum Senden von Daten an diese Endpunkte finden Sie in der Tutorial zum Streaming von Datensatzdaten.
Nach dem Erstellen einer Verbindung können Sie Ihre Daten jetzt in Platform erfassen.
Nachfolgend finden Sie ein Beispiel der Payload der externen Zielgruppenmitgliedschaft:
{
"header": {
"schemaRef": {
"id": "https://ns.adobe.com/{TENANT_ID}/schemas/{SCHEMA_ID}",
"contentType": "application/vnd.adobe.xed-full+json;version=1"
},
"imsOrgId": "{ORG_ID}",
"datasetId": "{DATASET_ID}",
"source": {
"name": "Sample External Audience Membership"
}
},
"body": {
"xdmMeta": {
"schemaRef": {
"id": "https://ns.adobe.com/{TENANT_ID}/schemas/{SCHEMA_ID}",
"contentType": "application/vnd.adobe.xed-full+json;version=1"
}
},
"xdmEntity": {
"_id": "{UNIQUE_ID}",
"description": "Sample description",
"{TENANT_NAME}": {
"identities": {
"{SCHEMA_IDENTITY}": "sample-id"
}
},
"personId" : "sample-name",
"segmentMembership": {
"{IDENTITY_NAMESPACE}": {
"{EXTERNAL_IDENTITY}": {
"status": "realized",
"lastQualificationTime": "2022-03-14T:00:00:00Z"
}
}
}
}
}
}
Eigenschaft | Beschreibung |
---|---|
schemaRef |
Das Schema must bezieht sich auf das zuvor erstellte Schema für die Daten zur Segmentmitgliedschaft. |
datasetId |
Die Datensatz-ID must bezieht sich auf den zuvor erstellten Datensatz für das soeben erstellte Mitgliedschaftsschema. |
xdmEntity._id |
Eine geeignete ID, die verwendet wird, um den Datensatz im Datensatz eindeutig zu identifizieren. |
{TENANT_NAME}.identities |
Dieser Abschnitt wird verwendet, um die Feldergruppe der benutzerdefinierten Identitäten mit den zuvor importierten Benutzern zu verbinden. |
segmentMembership.{IDENTITY_NAMESPACE} |
Dies ist die Bezeichnung des zuvor erstellten benutzerdefinierten Identitäts-Namespace. Wenn Sie beispielsweise Ihren Identitäts-Namespace "externalAudience"nennen, würden Sie ihn als Schlüssel des Arrays verwenden. |
Standardmäßig werden externe Zielgruppenmitgliedschaften nur 30 Tage lang aufbewahrt. Um sie länger als 30 Tage aufzubewahren, verwenden Sie bitte die validUntil
beim Erfassen Ihrer Zielgruppendaten. Weitere Informationen zu diesem Feld finden Sie im Handbuch unter Feldgruppen des Schemas Segmentzugehörigkeitsdetails.