Dieses Ziel ist nur für Real-time Customer Data Platform Ultimate -Kunden.
Das HTTP-API-Ziel ist ein Adobe Experience Platform Streaming-Ziel, mit dem Sie Profildaten an HTTP-Endpunkte von Drittanbietern senden können.
Um Profildaten an HTTP-Endpunkte zu senden, müssen Sie zunächst Verbindung zum Ziel herstellen in Adobe Experience Platform.
Mit dem HTTP-API-Ziel können Sie XDM-Profildaten und Zielgruppensegmente in allgemeine HTTP-Endpunkte exportieren. Dort können Sie Ihre eigenen Analysen durchführen oder beliebige andere Vorgänge ausführen, die Sie für aus der Experience Platform exportierte Profildaten benötigen.
HTTP-Endpunkte können entweder eigene Systeme von Kunden oder Lösungen von Drittanbietern sein.
Informationen zum Zielexporttyp und zur Häufigkeit finden Sie in der unten stehenden Tabelle.
Element | Typ | Anmerkungen |
---|---|---|
Exporttyp | Profilbasiert | Sie exportieren alle Mitglieder eines Segments zusammen mit den gewünschten Schemafeldern (z. B.: E-Mail-Adresse, Telefonnummer, Nachname), wie im Mapping-Bildschirm des Zielaktivierungs-Workflow. |
Exporthäufigkeit | Streaming | Streaming-Ziele sind "immer auf"-API-basierte Verbindungen. Sobald ein Profil in Experience Platform auf der Grundlage einer Segmentbewertung aktualisiert wird, sendet der Connector das Update nachgelagert an die Zielplattform. Mehr dazu Streaming-Ziele. |
Um Daten aus Experience Platform mithilfe des HTTP-API-Ziels zu exportieren, müssen folgende Voraussetzungen erfüllt sein:
Sie können auch Adobe Experience Platform Destination SDK , um eine Experience Platform einzurichten und Profildaten an einen HTTP-Endpunkt zu senden.
Um die Sicherheits- und Compliance-Anforderungen von Kunden zu erfüllen, stellt Experience Platform eine Liste mit statischen IPs bereit, die Sie für das HTTP-API-Ziel auf die Zulassungsliste gesetzt haben. Siehe IP-Adressen-Zulassungsliste für Streaming-Ziele für die vollständige Liste der IP-Adressen in Zulassungsliste.
Das HTTP-API-Ziel unterstützt mehrere Authentifizierungstypen für Ihren HTTP-Endpunkt:
curl --location --request POST '<YOUR_API_ENDPOINT>' \
--header 'Content-Type: application/x-www-form-urlencoded' \
--data-urlencode 'grant_type=client_credentials' \
--data-urlencode 'client_id=<CLIENT_ID>' \
--data-urlencode 'client_secret=<CLIENT_SECRET>'
curl --location --request POST 'https://some-api.com/token' \
--header 'Authorization: Basic base64(clientId:clientSecret)' \
--header 'Content-type: application/x-www-form-urlencoded; charset=UTF-8' \
--data-urlencode 'grant_type=client_credentials'
Um eine Verbindung zum Ziel herzustellen, benötigen Sie die Ziele verwalten Zugriffsberechtigung. Lesen Sie die Zugriffskontrolle - Übersicht oder wenden Sie sich an Ihren Produktadministrator, um die erforderlichen Berechtigungen zu erhalten.
Um eine Verbindung mit diesem Ziel herzustellen, gehen Sie wie im Abschnitt Tutorial zur Zielkonfiguration beschrieben vor. Beim Herstellen einer Verbindung zu diesem Ziel müssen Sie die folgenden Informationen angeben:
Wenn Sie die Trägertoken Authentifizierungstyp zum Herstellen einer Verbindung mit Ihrem HTTP-Endpunkt, Eingabe der folgenden Felder und Auswahl Mit Ziel verbinden:
Wenn Sie die Keines Authentifizierungstyp zum Herstellen einer Verbindung mit Ihrem HTTP-Endpunkt:
Wenn Sie diese Authentifizierung öffnen, müssen Sie nur Mit Ziel verbinden und die Verbindung zu Ihrem Endpunkt hergestellt wird.
Wenn Sie die OAuth 2 Password Authentifizierungstyp zum Herstellen einer Verbindung mit Ihrem HTTP-Endpunkt, Eingabe der folgenden Felder und Auswahl Mit Ziel verbinden:
Wenn Sie die OAuth 2 Client-Anmeldedaten Authentifizierungstyp zum Herstellen einer Verbindung mit Ihrem HTTP-Endpunkt, Eingabe der folgenden Felder und Auswahl Mit Ziel verbinden:
Authorization
header nachdem base64-kodiert und an Ihr Ziel gesendet wurde. Ein Beispiel finden Sie unter Unterstützte Authentifizierungstypen Abschnitt.Füllen Sie die folgenden erforderlichen und optionalen Felder aus, um Details für das Ziel zu konfigurieren. Ein Sternchen neben einem Feld in der Benutzeroberfläche zeigt an, dass das Feld erforderlich ist.
header1:value1,header2:value2,...headerN:valueN
.parameter1=value¶meter2=value
.Sie können Warnhinweise aktivieren, um Benachrichtigungen über den Status des Datenflusses an Ihr Ziel zu erhalten. Wählen Sie einen Warnhinweis aus der zu abonnierenden Liste aus, um Benachrichtigungen über den Status Ihres Datenflusses zu erhalten. Weitere Informationen zu Warnungen finden Sie im Handbuch zu Abonnieren von Zielwarnhinweisen über die Benutzeroberfläche.
Wenn Sie alle Details für Ihre Zielverbindung angegeben haben, wählen Sie Nächste.
Um Daten zu aktivieren, benötigen Sie die Ziele verwalten, Ziele aktivieren, Profile anzeigen und Segmente anzeigen Zugriffssteuerungsberechtigungen. Lesen Sie die Zugriffskontrolle - Übersicht oder wenden Sie sich an Ihren Produktadministrator, um die erforderlichen Berechtigungen zu erhalten.
Siehe Aktivieren von Zielgruppendaten für Streaming-Profil-Export-Ziele für Anweisungen zum Aktivieren von Zielgruppensegmenten für dieses Ziel.
Im Attribute auswählen in Adobe empfiehlt, eine eindeutige Kennung aus der Vereinigungsschema. Wählen Sie die eindeutige Kennung und alle anderen XDM-Felder aus, die Sie an das Ziel exportieren möchten.
Experience Platform optimiert das Profil-Exportverhalten für Ihr HTTP-API-Ziel, sodass nur Daten an Ihren API-Endpunkt exportiert werden, wenn relevante Profilaktualisierungen nach der Segmentqualifizierung oder anderen wichtigen Ereignissen durchgeführt wurden. Profile werden in den folgenden Situationen an Ihr Ziel exportiert:
In allen oben beschriebenen Fällen werden nur die Profile exportiert, in denen relevante Aktualisierungen vorgenommen wurden. Wenn beispielsweise ein Segment, das dem Zielfluss zugeordnet ist, aus hundert Mitgliedern besteht und fünf neue Profile für das Segment qualifiziert sind, ist der Export in Ihr Ziel inkrementell und umfasst nur die fünf neuen Profile.
Beachten Sie, dass alle zugeordneten Attribute unabhängig vom Speicherort der Änderungen für ein Profil exportiert werden. Daher werden im Beispiel vor allem alle zugeordneten Attribute für diese fünf neuen Profile exportiert, selbst wenn sich die Attribute selbst nicht geändert haben.
Für die Daten, die für ein bestimmtes Profil exportiert werden, ist es wichtig, die beiden verschiedenen Konzepte von was den Datenexport an Ihr HTTP-API-Ziel bestimmt und welche Daten im Export enthalten sind.
Was bestimmt den Zielexport? | Im Zielexport enthaltene Informationen |
---|---|
|
|
Betrachten Sie beispielsweise diesen Datenfluss an ein HTTP-Ziel, bei dem drei Segmente im Datenfluss ausgewählt und dem Ziel vier Attribute zugeordnet sind.
Ein Profilexport an das Ziel kann durch ein Profil bestimmt werden, das für eines der drei zugeordnete Segmente. Im Datenexport jedoch wird im segmentMembership
-Objekt (siehe Exportierte Daten unten), können weitere nicht zugeordnete Segmente angezeigt werden, wenn dieses bestimmte Profil Mitglied ist. Wenn ein Profil für den Kunden mit dem Segment "DeLorean Cars"qualifiziert ist, aber auch Mitglied der Segmente "Zurück zur Zukunft"für Film- und Science Fiction-Fans ist, sind diese beiden anderen Segmente auch in den Segmenten segmentMembership
-Objekt des Datenexports, auch wenn diese nicht im Datenfluss zugeordnet sind.
Aus Sicht der Profilattribute bestimmen alle Änderungen an den vier oben zugeordneten Attributen einen Zielexport und eines der vier im Profil vorhandenen zugeordneten Attribute wird im Datenexport vorhanden sein.
Wenn Sie ein neues Segment zu einem vorhandenen Ziel hinzufügen oder wenn Sie ein neues Ziel erstellen und ihm Segmente zuordnen, exportiert Experience Platform historische Segmentqualifikationsdaten an das Ziel. Profile, die sich für das Segment qualifiziert haben before das Segment, das zum Ziel hinzugefügt wurde, innerhalb von etwa einer Stunde an das Ziel exportiert wird.
Ihr exportiert Experience Platform Daten landen in Ihrer HTTP Ziel im JSON-Format. Beispielsweise enthält der unten stehende Export ein Profil, das sich für ein bestimmtes Segment qualifiziert hat, Mitglied weiterer zwei Segmente ist und ein weiteres Segment verlassen hat. Der Export umfasst auch das Profilattribut mit Vorname, Nachname, Geburtsdatum und persönlicher E-Mail-Adresse. Die Identitäten für dieses Profil sind ECID und E-Mail.
{
"person": {
"birthDate": "YYYY-MM-DD",
"name": {
"firstName": "John",
"lastName": "Doe"
}
},
"personalEmail": {
"address": "john.doe@acme.com"
},
"segmentMembership": {
"ups":{
"7841ba61-23c1-4bb3-a495-00d3g5fe1e93":{
"lastQualificationTime":"2022-01-11T21:24:39Z",
"status":"exited"
},
"59bd2fkd-3c48-4b18-bf56-4f5c5e6967ae":{
"lastQualificationTime":"2022-01-02T23:37:33Z",
"status":"existing"
},
"947c1c46-008d-40b0-92ec-3af86eaf41c1":{
"lastQualificationTime":"2021-08-25T23:37:33Z",
"status":"existing"
},
"5114d758-ce71-43ba-b53e-e2a91d67b67f":{
"lastQualificationTime":"2022-01-11T23:37:33Z",
"status":"realized"
}
}
},
"identityMap": {
"ecid": [
{
"id": "14575006536349286404619648085736425115"
},
{
"id": "66478888669296734530114754794777368480"
}
],
"email_lc_sha256": [
{
"id": "655332b5fa2aea4498bf7a290cff017cb4"
},
{
"id": "66baf76ef9de8b42df8903f00e0e3dc0b7"
}
]
}
}
Im Folgenden finden Sie weitere Beispiele für exportierte Daten, abhängig von den Benutzeroberflächeneinstellungen, die Sie im Zielfluss "Verbindung"für die Segmentnamen einschließen und Segmentzeitstempel einschließen options:
segmentMembership
Abschnitt"segmentMembership": {
"ups": {
"5b998cb9-9488-4ec3-8d95-fa8338ced490": {
"lastQualificationTime": "2019-04-15T02:41:50+0000",
"status": "existing",
"createdAt": 1648553325000,
"updatedAt": 1648553330000,
"mappingCreatedAt": 1649856570000,
"mappingUpdatedAt": 1649856570000,
"name": "First name equals John"
}
}
}
segmentMembership
Abschnitt"segmentMembership": {
"ups": {
"5b998cb9-9488-4ec3-8d95-fa8338ced490": {
"lastQualificationTime": "2019-04-15T02:41:50+0000",
"status": "existing",
"createdAt": 1648553325000,
"updatedAt": 1648553330000,
"mappingCreatedAt": 1649856570000,
"mappingUpdatedAt": 1649856570000,
}
}
}
In 95 % der Fälle versucht Experience Platform, eine Durchsatzlatenz von weniger als 10 Minuten für erfolgreich gesendete Nachrichten mit einer Rate von weniger als 10.000 Anfragen pro Sekunde für jeden Datenfluss an ein HTTP-Ziel anzubieten.
Bei fehlgeschlagenen Anfragen an Ihr HTTP-API-Ziel speichert Experience Platform die fehlgeschlagenen Anfragen und versucht es zweimal, die Anfragen an Ihren -Endpunkt zu senden.