HTTP-API-Verbindung

Übersicht

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.

Anwendungsbeispiele

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.

Exporttyp und -häufigkeit

Beziehen Sie sich auf die folgende Tabelle, um Informationen zu Typ und Häufigkeit des Zielexports zu erhalten.

Voraussetzungen

Um Daten aus Experience Platform mithilfe des HTTP-API-Ziels zu exportieren, müssen folgende Voraussetzungen erfüllt sein:

• Sie müssen über einen HTTP-Endpunkt verfügen, der die REST-API unterstützt.
• Ihr HTTP-Endpunkt muss das Experience Platform-Profilschema unterstützen. Im HTTP-API-Ziel wird keine Umwandlung in ein Drittanbieter-Payload-Schema unterstützt. Siehe Abschnitt exportierte Daten ein Beispiel für das Ausgabeschema der Experience Platform.
• Ihr HTTP-Endpunkt muss Kopfzeilen unterstützen.

IP-Adressen-Zulassungsliste

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.

Unterstützte Authentifizierungstypen

Das HTTP-API-Ziel unterstützt mehrere Authentifizierungstypen für Ihren HTTP-Endpunkt:

• HTTP-Endpunkt ohne Authentifizierung;
• Authentifizierung von Trägertoken;
• OAuth 2.0-Client-Anmeldeinformationen Authentifizierung mit dem Hauptteilformular, mit client ID, client secret und grant type im Hauptteil der HTTP-Anforderung, wie im folgenden Beispiel gezeigt.

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>'

• OAuth 2.0-Client-Anmeldeinformationen mit grundlegender Autorisierung, mit einem Autorisierungs-Header, der URL-kodiert enthält client ID und 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'

• OAuth 2.0-Passwortgewährung.

Herstellen einer Verbindung mit dem Ziel

Um eine Verbindung mit diesem Ziel herzustellen, gehen Sie wie im Tutorial zur Zielkonfiguration beschrieben vor. Beim Herstellen einer Verbindung zu diesem Ziel müssen Sie die folgenden Informationen angeben:

Authentifizierungsinformationen

Trägertoken-Authentifizierung

Wenn Sie die Trägertoken Authentifizierungstyp zum Herstellen einer Verbindung mit Ihrem HTTP-Endpunkt, Eingabe der folgenden Felder und Auswahl Mit Ziel verbinden:

• Trägertoken: Fügen Sie das Trägertoken ein, um sich bei Ihrem HTTP-Speicherort zu authentifizieren.

Keine Authentifizierung

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.

OAuth 2 Password Authentication

Wenn Sie die OAuth 2 Password Authentifizierungstyp zum Herstellen einer Verbindung mit Ihrem HTTP-Endpunkt, Eingabe der folgenden Felder und Auswahl Mit Ziel verbinden:

• Zugriffstoken-URL: Die URL auf Ihrer Seite, die Zugriffstoken und optional Token aktualisieren ausgibt.
• Client-ID: Die client ID , die Ihr System Adobe Experience Platform zuweist.
• Client Secret: Die client secret , die Ihr System Adobe Experience Platform zuweist.
• Benutzername: Der Benutzername für den Zugriff auf Ihren HTTP-Endpunkt.
• Passwort: Das Kennwort für den Zugriff auf Ihren HTTP-Endpunkt.

OAuth 2 Client Credentials authentication

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:

• Zugriffstoken-URL: Die URL auf Ihrer Seite, die Zugriffstoken und optional Token aktualisieren ausgibt.
• Client-ID: Die client ID , die Ihr System Adobe Experience Platform zuweist.
• Client Secret: Die client secret , die Ihr System Adobe Experience Platform zuweist.
• Client Credentials Type: Wählen Sie den Typ der von Ihrem Endpunkt unterstützten OAuth2-Client-Anmeldedaten aus:
  • Textkörperformular kodiert: In diesem Fall wird die client ID und client secret sind enthalten im Hauptteil des Antrags an Ihr Ziel gesendet. Ein Beispiel finden Sie unter Unterstützte Authentifizierungstypen Abschnitt.
  • Grundlegende Autorisierung: In diesem Fall wird die client ID und client secret sind enthalten in einer Authorization header nachdem base64-kodiert und an Ihr Ziel gesendet wurde. Ein Beispiel finden Sie unter Unterstützte Authentifizierungstypen Abschnitt.

Ausfüllen der Zieldetails

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.

• Name: Geben Sie einen Namen ein, mit dem Sie dieses Ziel in Zukunft erkennen werden.
• Beschreibung: Geben Sie eine Beschreibung ein, mit der Sie dieses Ziel in der Zukunft identifizieren können.
• Kopfzeilen: Geben Sie alle benutzerdefinierten Header ein, die in die Ziel-Aufrufe aufgenommen werden sollen. Verwenden Sie dazu folgendes Format: header1:value1,header2:value2,...headerN:valueN.
• HTTP-Endpunkt: Die URL des HTTP-Endpunkts, an den Sie die Profildaten senden möchten.
• Abfrageparameter: Optional können Sie Abfrageparameter zur HTTP-Endpunkt-URL hinzufügen. Formatieren Sie die verwendeten Abfrageparameter wie folgt: parameter1=value&parameter2=value.
• Segmentnamen einschließen: Schalten Sie ein, wenn der Datenexport die Namen der Segmente enthalten soll, die Sie exportieren. Ein Beispiel für einen Datenexport mit aktivierter Option finden Sie im Abschnitt Exportierte Daten weiter unten.
• Segmentzeitstempel einschließen: Schalten Sie ein, wenn der Datenexport zum Zeitpunkt der Erstellung und Aktualisierung der Segmente den UNIX-Zeitstempel sowie den UNIX-Zeitstempel enthalten soll, zu dem die Segmente zum Zeitpunkt der Aktivierung dem Ziel zugeordnet wurden. Ein Beispiel für einen Datenexport mit aktivierter Option finden Sie im Abschnitt Exportierte Daten weiter unten.

Aktivieren von Warnhinweisen

Sie können Warnhinweise aktivieren, um Benachrichtigungen zum Status des Datenflusses zu Ihrem 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 Warnhinweisen finden Sie im Handbuch zum Abonnieren von Zielwarnhinweisen über die Benutzeroberfläche.

Wenn Sie mit dem Eingeben der Details für Ihre Zielverbindung fertig sind, klicken Sie auf Weiter.

Aktivieren von Segmenten für dieses Ziel

Siehe Aktivieren von Zielgruppendaten für Streaming-Profil-Export-Ziele für Anweisungen zum Aktivieren von Zielgruppensegmenten für dieses Ziel.

Zielattribute

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.

Profil-Exportverhalten

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:

• Die Aktualisierung des Profils wurde durch eine Änderung der Segmentzugehörigkeit für mindestens eines der dem Ziel zugeordneten Segmente bestimmt. Beispielsweise hat sich das Profil für eines der Segmente qualifiziert, die dem Ziel zugeordnet sind, oder eines der dem Ziel zugeordneten Segmente verlassen.
• Die Aktualisierung des Profils wurde durch eine Änderung der Identitätszuordnung. Beispielsweise wurde einem Profil, das sich bereits für eines der dem Ziel zugeordneten Segmente qualifiziert hatte, eine neue Identität im Identitätszuordnungsattribut hinzugefügt.
• Die Aktualisierung des Profils wurde durch eine Änderung der Attribute für mindestens eines der dem Ziel zugeordneten Attribute bestimmt. Beispielsweise wird eines der Attribute, die dem Ziel im Zuordnungsschritt zugeordnet sind, einem Profil hinzugefügt.

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.

Was bestimmt einen Datenexport und was ist im Export enthalten?

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.

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.

Aufstockung historischer Daten

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.

Exportierte Daten

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": {
        "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": {
        "ups": {
          "5b998cb9-9488-4ec3-8d95-fa8338ced490": {
            "lastQualificationTime": "2019-04-15T02:41:50+0000",
            "status": "existing",
            "createdAt": 1648553325000,
            "updatedAt": 1648553330000,
            "mappingCreatedAt": 1649856570000,
            "mappingUpdatedAt": 1649856570000,
          }
        }
      }

Einschränkungen und Wiederholungsrichtlinien

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.

Ressourcen für Business.Adobe.com