[Ultimate]{class="badge positive"}
Azure Event Hubs-Verbindung
Übersicht overview
Azure Event Hubs ist eine Big-Data-Streaming-Plattform und ein Service zur Ereignisaufnahme. Es kann Millionen von Ereignissen pro Sekunde empfangen und verarbeiten. Daten, die an einen Ereignis-Hub gesendet werden, können mithilfe eines beliebigen Echtzeit-Analyseanbieters oder Batch-/Speicheradapters transformiert und gespeichert werden.
Sie können eine ausgehende Echtzeit-Verbindung zu Ihrem Azure Event Hubs-Speicher herstellen, um Daten von Adobe Experience Platform zu streamen.
- Weitere Informationen zu Azure Event Hubs finden Sie in der Dokumentation zu Microsoft.
- Informationen zum programmgesteuerten Herstellen einer Verbindung zu Azure Event Hubs finden Sie im Tutorial zur Streaming-Ziele-API.
- Informationen zum Verbinden von mit Azure Event Hubs über die Platform-Benutzeroberfläche finden Sie in den folgenden Abschnitten.
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 gewünschten Systeme einspeisen.
Ein potenzieller Kunde hat beispielsweise ein Whitepaper heruntergeladen, in dem er in ein Segment mit einer hohen Konversionsneigung eingestuft wird. Wenn Sie die Zielgruppe, zu der der Interessent gehört, dem Azure Event Hubs Ziel zuordnen, erhalten Sie dieses Ereignis in Azure Event Hubs. Dort können Sie einen Do-it-yourself-Ansatz verwenden und zusätzlich zur Veranstaltung die Geschäftslogik beschreiben, die Ihrer Meinung nach am besten mit Ihren Unternehmens-IT-Systemen funktionieren würde.
Unterstützte Zielgruppen supported-audiences
In diesem Abschnitt wird beschrieben, welche Arten von Zielgruppen Sie an dieses Ziel exportieren können.
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.
Zulassungsliste von IP-Adressen ip-address-allowlist
Um die Sicherheits- und Compliance-Anforderungen von Kundinnen und 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 werden können. 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
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
Wenn Sie den Typ Standardauthentifizierung für die Verbindung mit Ihrem HTTP-Endpunkt auswählen, füllen Sie die unten stehenden Felder aus und wählen Sie Mit Ziel verbinden:
- SAS-Schlüsselname: Der Name der Autorisierungsregel, auch als SAS-Schlüsselname bezeichnet.
- SAS-Schlüssel Der Primärschlüssel des Event Hubs-Namespace. Die
sasPolicy
, der diesasKey
entspricht, müssen Verwalten-Rechte konfiguriert haben, damit die Event Hubs-Liste ausgefüllt wird. Erfahren Sie mehr über die Authentifizierung bei Azure Event Hubs mit SAS-Schlüsseln in der Dokumentation zu Microsoft. - Namespace: Füllen Sie Ihren Azure Event Hubs-Namespace aus. Weitere Informationen zu Azure Event Hubs-Namespaces finden Sie in der Dokumentation zu Microsoft.
SAS-Authentifizierung (Shared Access Signature) sas-authentication
Wenn Sie den Typ Standardauthentifizierung für die Verbindung mit Ihrem HTTP-Endpunkt auswählen, füllen Sie die unten stehenden Felder aus und wählen Sie Mit Ziel verbinden:
- SAS-Schlüsselname: Der Name der Autorisierungsregel, auch als SAS-Schlüsselname bezeichnet.
- SAS-Schlüssel Der Primärschlüssel des Event Hubs-Namespace. Die
sasPolicy
, der diesasKey
entspricht, müssen Verwalten-Rechte konfiguriert haben, damit die Event Hubs-Liste ausgefüllt wird. Erfahren Sie mehr über die Authentifizierung bei Azure Event Hubs mit SAS-Schlüsseln in der Dokumentation zu Microsoft. - Namespace: Füllen Sie Ihren Azure Event Hubs-Namespace aus. Weitere Informationen zu Azure Event Hubs-Namespaces finden Sie in der Dokumentation zu Microsoft.
- Event Hub-Name: Geben Sie Ihren Azure Event Hub ein. Erfahren Sie mehr über Azure Event Hubs Namen in der Dokumentation zu Microsoft.
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.
- Name: Geben Sie einen Namen für die zu Azure Event Hubs Verbindung ein.
- Beschreibung: Geben Sie eine Beschreibung der Verbindung an. Beispiele: „Premium-Kunden“, „Kunden, die sich für Kitesurfen interessieren“.
- eventHubName: Geben Sie einen Namen für den Stream zu Ihrem Azure Event Hubs Ziel an.
- Segmentnamen einschließen: Schalten Sie diese Option ein, wenn der Datenexport die Namen der zu exportierenden Zielgruppen enthalten soll. Ein Beispiel für einen Datenexport, bei dem diese Option aktiviert ist, finden Sie im Abschnitt Exportierte Daten weiter unten.
- Segmentzeitstempel einschließen: Schalten Sie diese Option ein, wenn der Datenexport den UNIX-Zeitstempel enthalten soll, an dem die Zielgruppen erstellt und aktualisiert wurden, sowie den UNIX-Zeitstempel, an dem die Zielgruppen dem Ziel für die Aktivierung 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
- Zum Aktivieren von Daten benötigen Sie die Berechtigungen Ziele anzeigen, Ziele aktivieren, Profile anzeigen und Segmente anzeigen Zugriffssteuerung. Lesen Sie die Übersicht über die Zugriffssteuerung oder wenden Sie sich an Ihre Produktadmins, um die erforderlichen Berechtigungen zu erhalten.
- Bewertung der Einverständnisrichtlinie wird derzeit nicht in Exporten zum Azure Event Hubs-Ziel unterstützt. Weitere Informationen.
Anweisungen Aktivieren von Zielgruppen für dieses Ziel finden Sie„Aktivieren von Zielgruppendaten für Streaming Profilexportziele“.
Profilexportverhalten profile-export-behavior
Experience Platform optimiert das Verhalten beim Profilexport für Ihr Azure Event Hubs Ziel, sodass nur Daten an Ihr Ziel exportiert werden, wenn relevante Profilaktualisierungen nach der Zielgruppen-Qualifizierung 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 Zielgruppenzugehörigkeit für mindestens eine der dem Ziel zugeordneten 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
Was die Daten betrifft, die für ein bestimmtes Profil exportiert werden, ist es wichtig, die beiden verschiedenen Konzepte zu verstehen, nämlich was den Datenexport an Ihr Azure Event Hubs-Ziel bestimmt und welche Daten im Export enthalten sind.
- 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
aufrealized
oder vonrealized
aufexiting
) oder wenn zugeordnete Attribute aktualisiert werden. - Da Identitäten derzeit nicht Azure Event Hubs Zielen zugeordnet werden können, bestimmen Änderungen an der 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
identityMap
Objekt sind ebenfalls enthalten (Experience Platform unterstützt derzeit keine Identitätszuordnung im Azure Event Hubs). - Nur die zugeordneten Attribute werden in den Zielexport einbezogen.
Betrachten Sie beispielsweise diesen Datenfluss zu einem Azure Event Hubs Ziel, bei dem drei Zielgruppen im Datenfluss ausgewählt sind und dem Ziel vier Attribute zugeordnet sind.
Ein Profilexport an das Ziel kann durch ein Profil bestimmt werden, das sich für eines der drei zugeordneten Segmente qualifiziert. Im Datenexport jedoch können im segmentMembership
(siehe Exportierte Daten Abschnitt unten) weitere nicht zugeordnete Zielgruppen angezeigt werden, wenn dieses bestimmte Profil zu diesen Profil gehört und diese Zielgruppen dieselbe Zusammenführungsrichtlinie verwenden wie die Zielgruppe, die den Export ausgelöst hat. Wenn ein Profil sich für die Zielgruppe Kundin oder Kunde mit DeLorean-Autos qualifiziert hat, aber auch Mitglied der Segmente Hat „Zurück in die Zukunft“ und Science-Fiction-Fans ist, sind diese beiden anderen Zielgruppen ebenfalls im segmentMembership
des Datenexports vorhanden, obwohl diese nicht im Datenfluss zugeordnet sind, falls diese dieselbe Zusammenführungsrichtlinie wie das Segment Kundin oder Kunde mit DeLorean-Autos verwenden.
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 diesem Zielgruppen zuordnen, exportiert Experience Platform historische Zielgruppen-Qualifizierungsdaten an das Ziel. Profile, die sich für die Zielgruppe qualifiziert haben zuvor wurde die Zielgruppe zum Ziel hinzugefügt, 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.
segmentMembership
.code language-json |
---|
|
segmentMembership
.code language-json |
---|
|
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.