[Ultimate]{class="badge positive"}

Azure Event Hubs-Verbindung

Übersicht overview

IMPORTANT
Dieses Ziel ist nur für Kunden von Adobe Real-time Customer Data Platform Ultimate verfügbar.

Azure Event Hubs ist eine Big-Data-Streaming-Plattform und ein Ereignisaufnahmedienst. Es kann Millionen von Ereignissen pro Sekunde empfangen und verarbeiten. An einen Ereignis-Hub gesendete Daten können mithilfe eines beliebigen Echtzeit-Analytics-Anbieters oder von Batch-/Speicheradaptern umgewandelt und gespeichert werden.

Sie können eine ausgehende Echtzeitverbindung zu Ihrem Azure Event Hubs-Speicher erstellen, um Daten von Adobe Experience Platform zu streamen.

  • Weitere Informationen zu Azure Event Hubs finden Sie in der Microsoft-Dokumentation.
  • Informationen zum programmgesteuerten Herstellen einer Verbindung zu Azure Event Hubs finden Sie im Tutorial zur Streaming-Ziele-API 🔗.
  • Informationen zum Herstellen einer Verbindung mit Azure Event Hubs über die Benutzeroberfläche von Platform finden Sie in den folgenden Abschnitten.

AWS Kinesis in der Benutzeroberfläche

Anwendungsfälle use-cases

Durch die Verwendung von Streaming-Zielen wie Azure Event Hubs können Sie einfach hochwertige Segmentierungsereignisse und zugehörige Profilattribute in Ihre bevorzugten Systeme einspeisen.

Beispielsweise hat ein Interessent ein Whitepaper heruntergeladen, das ihn in ein Segment mit hoher Konversionsneigung qualifiziert. Wenn Sie die Zielgruppe zuordnen, in die der Interessent zum Ziel Azure Event Hubs gehört, erhalten Sie dieses Ereignis in Azure Event Hubs. Dort können Sie zusätzlich zu dem Ereignis einen "do-it-self"-Ansatz verwenden und die Geschäftslogik beschreiben, da Sie denken, dass dies am besten mit Ihren Enterprise-IT-Systemen funktionieren würde.

Unterstützte Zielgruppen supported-audiences

In diesem Abschnitt wird beschrieben, welche Zielgruppentypen Sie an dieses Ziel exportieren können.

Audience Origin
Unterstützt
Beschreibung
Segmentation Service
Zielgruppen, die durch den Experience Platform Segmentierungsdienst generiert wurden.
Benutzerdefinierte Uploads
Zielgruppen, die aus CSV-Dateien in Experience Platform importiert werden.

Exporttyp und -häufigkeit export-type-frequency

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

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 Bildschirm „Auswählen der Profilattribute“ im Zielaktivierungs-Workflow festgelegt.
Exporthäufigkeit
Streaming
Streaming-Ziele sind „immer verfügbare“ API-basierte Verbindungen. Sobald ein Profil in Experience Platform auf der Grundlage einer Zielgruppenauswertung aktualisiert wird, sendet der Connector das Update nachgelagert an die Zielplattform. Lesen Sie mehr über Streaming-Ziele.

Zulassungsliste von IP-Adressen ip-address-allowlist

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 Azure Event Hubs-Ziel auf die Zulassungsliste gesetzt haben. Siehe Zulassungsliste von IP-Adressen für Streaming-Ziele, um die vollständige Liste der IP-Adressen in der Zulassungsliste einzusehen.

Herstellen einer Verbindung mit dem Ziel connect

IMPORTANT
Um eine Verbindung zum Ziel herzustellen, benötigen Sie die Zugriffssteuerungsberechtigungen Ziele anzeigen und Ziele verwalten .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 Tutorial zur Zielkonfiguration beschrieben vor. Beim Herstellen einer Verbindung zu diesem Ziel müssen Sie die folgenden Informationen angeben:

Authentifizierungsinformationen authentication-information

Standardauthentifizierung standard-authentication

Bild des UI-Bildschirms mit ausgefüllten Feldern für die standardmäßigen Authentifizierungsdetails der Azure Event Hubs

Wenn Sie den Typ Standardauthentifizierung auswählen, um eine Verbindung zu Ihrem HTTP-Endpunkt herzustellen, geben Sie die folgenden Felder ein und wählen Sie Mit Ziel verbinden:

  • SAS-Schlüsselname: Der Name der Autorisierungsregel, der auch als SAS-Schlüsselname bezeichnet wird.
  • SAS-Schlüssel: Der Primärschlüssel des Ereignis-Hubs-Namespace. Die sasPolicy, denen der sasKey entspricht, müssen über die manage -Rechte verfügen, damit die Liste der Ereignis-Hubs ausgefüllt werden kann. Informationen zur Authentifizierung bei Azure Event Hubs mit SAS-Schlüsseln finden Sie in der Microsoft-Dokumentation.
  • Namespace: Füllen Sie den Namespace Azure Event Hubs aus. Weitere Informationen zu Azure Event Hubs Namespaces finden Sie in der Dokumentation zu Microsoft .

Shared Access Signature (SAS)-Authentifizierung sas-authentication

Bild des UI-Bildschirms mit ausgefüllten Feldern für die standardmäßigen Authentifizierungsdetails der Azure Event Hubs

Wenn Sie den Typ Standardauthentifizierung auswählen, um eine Verbindung zu Ihrem HTTP-Endpunkt herzustellen, geben Sie die folgenden Felder ein und wählen Sie Mit Ziel verbinden:

  • SAS-Schlüsselname: Der Name der Autorisierungsregel, der auch als SAS-Schlüsselname bezeichnet wird.
  • SAS-Schlüssel: Der Primärschlüssel des Ereignis-Hubs-Namespace. Die sasPolicy, denen der sasKey entspricht, müssen über die manage -Rechte verfügen, damit die Liste der Ereignis-Hubs ausgefüllt werden kann. Informationen zur Authentifizierung bei Azure Event Hubs mit SAS-Schlüsseln finden Sie in der Microsoft-Dokumentation.
  • Namespace: Füllen Sie den Namespace Azure Event Hubs aus. Weitere Informationen zu Azure Event Hubs Namespaces finden Sie in der Dokumentation zu Microsoft .
  • Ereignis-Hub-Name: Geben Sie Ihren Azure Event Hub -Namen ein. Weitere Informationen zu Azure Event Hubs -Namen finden Sie in der Microsoft-Dokumentation.

Ausfüllen der Zieldetails destination-details

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.

Bild des UI-Bildschirms mit ausgefüllten Feldern für die Zieldetails der Azure Event-Hub-Zieldetails

  • Name: Geben Sie einen Namen für die Verbindung zu Azure Event Hubs ein.
  • Beschreibung: Geben Sie eine Beschreibung der Verbindung ein. Beispiele: "Premium-Tier-Kunden", "Kunden, die an Kitesurfen interessiert sind".
  • eventHubName: Geben Sie einen Namen für den Stream an Ihr Azure Event Hubs-Ziel an.
  • Segmentnamen einschließen: Schalten Sie ein, wenn der Datenexport die Namen der Zielgruppen enthalten soll, die Sie exportieren. Ein Beispiel für einen Datenexport, bei dem diese Option aktiviert ist, finden Sie im Abschnitt Exportierte Daten weiter unten.
  • Segment-Zeitstempel einschließen: Schalten Sie ein, wenn der Datenexport den UNIX-Zeitstempel zum Zeitpunkt der Erstellung und Aktualisierung der Zielgruppen sowie den UNIX-Zeitstempel enthalten soll, zu dem die Zielgruppen zur Aktivierung dem Ziel zugeordnet wurden. Ein Beispiel für einen Datenexport, bei dem diese Option aktiviert ist, finden Sie im Abschnitt exportierte Daten weiter unten.

Aktivieren von Warnhinweisen enable-alerts

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 alle Details für Ihre Zielverbindung eingegeben haben, klicken Sie auf Weiter.

Aktivieren von Zielgruppen für dieses Ziel activate

IMPORTANT

Anweisungen zum Aktivieren von Zielgruppen für dieses Ziel finden Sie unter Aktivieren von Zielgruppendaten für Streaming-Profilexport-Ziele .

Profilexportverhalten profile-export-behavior

Experience Platform optimiert das Verhalten des Profilexports an Ihr Azure Event Hubs-Ziel, sodass nur Daten an Ihr Ziel exportiert werden, wenn relevante Aktualisierungen an einem Profil aufgrund einer Zielgruppenqualifikation oder anderer bedeutender Ereignisse erfolgt sind. Profile werden in den folgenden Situationen an Ihr Ziel exportiert:

  • Die Aktualisierung des Profils wurde durch eine Änderung der Zielgruppenzugehörigkeit für mindestens eine der Zielgruppen bestimmt. Beispielsweise hat sich das Profil für eine der Zielgruppen qualifiziert, die dem Ziel zugeordnet sind, oder es hat eine der dem Ziel zugeordneten Zielgruppen verlassen.
  • Die Aktualisierung des Profils wurde durch eine Änderung der Identitätszuordnung bestimmt. Beispielsweise wurde einem Profil, das sich bereits für eine der dem Ziel zugeordneten Zielgruppen 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 eine Zielgruppe, die dem Zielfluss zugeordnet ist, aus hundert Mitgliedern besteht und fünf neue Profile sich für das Segment qualifizieren, 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 obigen Beispiel 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? what-determines-export-what-is-included

In Bezug auf die Daten, die für ein bestimmtes Profil exportiert werden, ist es wichtig, die beiden Konzepte zu verstehen: Was bestimmt einen Datenexport an Ihr Azure Event Hubs Ziel und Welche Daten sind im Export enthalten.

Was einen Zielexport bestimmt
Im Zielexport enthaltene Informationen
  • Zugeordnete Attribute und Zielgruppen dienen als Hinweis für einen Zielexport. Das bedeutet, dass ein Zielexport ausgelöst wird, wenn sich der Status einer zugeordneten Zielgruppe ändert (von null auf realized oder von realized auf exiting) oder wenn zugeordnete Attribute aktualisiert werden.
  • Da Identitäten derzeit nicht Azure Event Hubs Zielen zugeordnet werden können, bestimmen Änderungen an einer Identität eines bestimmten Profils auch die Zielexporte.
  • Als Änderung für ein Attribut wird jede Aktualisierung des Attributs definiert, unabhängig davon, ob es sich um denselben Wert handelt oder nicht. Das bedeutet, dass das Überschreiben eines Attributs als Änderung gilt, selbst wenn sich der Wert selbst nicht geändert hat.
  • Das segmentMembership-Objekt enthält die Zielgruppe, die im Aktivierungsdatenfluss zugeordnet ist und für die sich der Status des Profils nach einem Qualifikations- oder Zielgruppenaustrittsereignis geändert hat. Beachten Sie, dass andere nicht zugeordnete Zielgruppen, für die sich das Profil qualifiziert hat, Teil des Zielexports sein können, wenn diese Zielgruppen zu derselben Zusammenführungsrichtlinie gehören wie die im Aktivierungsdatenfluss zugeordnete Zielgruppe.
  • Alle Identitäten im Objekt identityMap sind ebenfalls enthalten (Experience Platform unterstützt derzeit keine Identitätszuordnung im Ziel Azure Event Hubs).
  • Nur die zugeordneten Attribute werden in den Zielexport einbezogen.

Betrachten Sie diesen Datenfluss beispielsweise als ein Azure Event Hubs -Ziel, bei dem im Datenfluss drei Zielgruppen ausgewählt und dem Ziel vier Attribute zugeordnet sind.

Amazon Kinesis-Ziel-Datenfluss

Ein Profilexport an das Ziel kann durch ein Profil bestimmt werden, das sich für eines der drei zugeordneten Segmente qualifiziert. Im Datenexport werden jedoch im Objekt segmentMembership (siehe Abschnitt Exportierte Daten unten) möglicherweise weitere nicht zugeordnete Zielgruppen angezeigt, wenn das betreffende Profil Mitglied dieser Zielgruppe ist und diese dieselbe Zusammenführungsrichtlinie wie die Zielgruppe nutzen, die den Export ausgelöst hat. Wenn ein Profil für die Audience Kunde mit DeLorean Cars qualifiziert ist, aber auch Mitglied der Segmente Überwachter "Back to the Future" und Science Fiction Fans ist, sind diese beiden anderen Audiences auch im Objekt segmentMembership des Datenexports vorhanden, auch wenn sie nicht im Datenfluss zugeordnet sind, sofern sie dieselbe Zusammenführungsrichtlinie nutzen mit dem Segment Kunde mit DeLorean Cars .

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 historical-data-backfill

Wenn Sie eine neue Zielgruppe zu einem vorhandenen Ziel hinzufügen oder wenn Sie ein neues Ziel erstellen und ihm Zielgruppen zuordnen, exportiert Experience Platform historische Zielgruppenqualifizierungsdaten an das Ziel. Profile, die sich für die Zielgruppe vor qualifiziert haben, die zum Ziel hinzugefügt wurde, werden innerhalb von etwa einer Stunde an das Ziel exportiert.

Exportierte Daten exported-data

Ihre exportierten Experience Platform-Daten landen in Ihrem Azure Event Hubs-Ziel im JSON-Format. Beispielsweise enthält der folgende Export ein Profil, das sich für ein bestimmtes Segment qualifiziert hat, Mitglied zweier weiterer Segmente ist und ein weiteres Segment verlassen hat. Der Export umfasst außerdem Vorname, Nachname, Geburtsdatum und persönliche E-Mail-Adresse des Profilattributs. 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":"realized"
      },
      "947c1c46-008d-40b0-92ec-3af86eaf41c1":{
         "lastQualificationTime":"2021-08-25T23:37:33Z",
         "status":"realized"
      },
      "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 Fluss „Ziel verbinden“ für die Optionen Segmentnamen einschließen und Zeitstempel für Segmente einschließen auswählen.

Das folgende Beispiel für den Datenexport enthält Zielgruppennamen im Abschnitt segmentMembership
code language-json
"segmentMembership": {
        "ups": {
          "5b998cb9-9488-4ec3-8d95-fa8338ced490": {
            "lastQualificationTime": "2019-04-15T02:41:50+0000",
            "status": "realized",
            "createdAt": 1648553325000,
            "updatedAt": 1648553330000,
            "mappingCreatedAt": 1649856570000,
            "mappingUpdatedAt": 1649856570000,
            "name": "First name equals John"
          }
        }
      }
Das unten stehende Beispiel für den Datenexport enthält Zielgruppen-Zeitstempel im Abschnitt segmentMembership
code language-json
"segmentMembership": {
        "ups": {
          "5b998cb9-9488-4ec3-8d95-fa8338ced490": {
            "lastQualificationTime": "2019-04-15T02:41:50+0000",
            "status": "realized",
            "createdAt": 1648553325000,
            "updatedAt": 1648553330000,
            "mappingCreatedAt": 1649856570000,
            "mappingUpdatedAt": 1649856570000,
          }
        }
      }

Beschränkungen und Wiederholungsrichtlinien limits-retry-policy

Experience Platform versucht, in 95 Prozent der Fälle 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 zu bieten.

Bei fehlgeschlagenen Anfragen an Ihr HTTP-API-Ziel speichert Experience Platform die fehlgeschlagenen Anfragen und versucht es zweimal erneut, die Anfragen an Ihren Endpunkt zu senden.

recommendation-more-help
7f4d1967-bf93-4dba-9789-bb6b505339d6