Amazon Kinesis-Verbindung
Übersicht overview
Die Kinesis Data Streams Dienst von Amazon Web Services ermöglicht die Erfassung und Verarbeitung großer Datenströme in Echtzeit.
Sie können eine ausgehende Echtzeitverbindung zu Ihrem Amazon Kinesis Speicher zum Streamen von Daten aus Adobe Experience Platform.
- Weitere Informationen finden Sie unter Amazon Kinesis, siehe Amazon-Dokumentation.
- So stellen Sie eine Verbindung her Amazon Kinesis sehen Sie programmatisch die Tutorial zur Streaming-Ziele-API.
- So stellen Sie eine Verbindung her Amazon Kinesis Informationen zur Verwendung der Benutzeroberfläche von Platform finden Sie in den folgenden Abschnitten.
Anwendungsfälle use-cases
Durch Verwendung von Streaming-Zielen wie Amazon Kinesiskö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. Durch Zuordnung der Zielgruppe, in die der Interessent fällt, zum Amazon Kinesis Ziel, erhalten Sie dieses Ereignis in Amazon Kinesis. 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.
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 Kunden zu erfüllen, stellt Experience Platform eine Liste statischer IPs bereit, die Sie für die Amazon Kinesis Ziel. Siehe Zulassungsliste von IP-Adressen für Streaming-Ziele, um die vollständige Liste der IP-Adressen in der Zulassungsliste einzusehen.
Erforderliche Amazon Kinesis-Berechtigungen required-kinesis-permission
So verbinden Sie Daten erfolgreich mit Ihren Amazon Kinesis -Streams, Experience Platform benötigt Berechtigungen für die folgenden Aktionen:
kinesis:ListStreams
kinesis:PutRecord
kinesis:PutRecords
Diese Berechtigungen werden über die Kinesis und werden von Platform überprüft, sobald Sie Ihr Kinesis-Ziel in der Benutzeroberfläche von Platform konfigurieren.
Im folgenden Beispiel werden die Mindestzugriffsrechte angezeigt, die erforderlich sind, um Daten erfolgreich in eine Kinesis Ziel.
{
"Version": "2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Action": [
"kinesis:ListStreams",
"kinesis:PutRecord",
"kinesis:PutRecords"
],
"Resource": [
"arn:aws:kinesis:us-east-2:901341027596:stream/*"
]
}
]
}
kinesis:ListStreams
kinesis:PutRecord
kinesis:PutRecords
Weitere Informationen zur Zugriffskontrolle für Kinesis Datenströme, lesen Sie Folgendes Kinesis Dokument.
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
Füllen Sie die Felder unten aus und wählen Sie Mit Ziel verbinden:
- Amazon Web ServicesZugriffsschlüssel und geheimer Schlüssel: In Amazon Web Services, generieren Sie eine
access key - secret access key
, um Platform Zugriff auf Ihre Amazon Kinesis -Konto. Weitere Informationen finden Sie in der Amazon Web Services-Dokumentation. - Region: Geben Sie an, welche Amazon Web Services region zum Streamen von Daten an.
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 Ihre Verbindung zu Amazon Kinesis
- Beschreibung: Geben Sie eine Beschreibung für Ihre Verbindung zu Amazon Kinesis.
- Stream: Geben Sie den Namen eines vorhandenen Datenstreams in Ihrer Amazon Kinesis -Konto. Platform exportiert Daten in diesen Stream.
- Segmentnamen einschließen: Schalten Sie ein, wenn der Datenexport die Namen der Zielgruppen enthalten soll, die exportiert werden sollen. 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 ein, wenn der Datenexport zum Zeitpunkt der Erstellung und Aktualisierung der Zielgruppen den UNIX-Zeitstempel 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
- Um Daten zu aktivieren, benötigen Sie die Ziele anzeigen, Ziele aktivieren, Anzeigen von Profilen, und Segmente anzeigen Zugriffssteuerungsberechtigungen. Lesen Sie die Übersicht über die Zugriffssteuerung oder wenden Sie sich an Ihre Produktadmins, um die erforderlichen Berechtigungen zu erhalten.
- Beurteilung der Einwilligungsrichtlinie wird derzeit beim Export in das Amazon Kinesis-Ziel nicht unterstützt. Weitere Informationen.
Siehe Aktivieren von Zielgruppendaten für Streaming-Profil-Export-Ziele für Anweisungen zum Aktivieren von Zielgruppen für dieses Ziel.
Profilexportverhalten profile-export-behavior
Experience Platform optimiert das Profil-Exportverhalten für Ihre Amazon Kinesis Ziel, um Daten nur dann an Ihr Ziel zu exportieren, wenn nach der Zielgruppenqualifizierung oder anderen wichtigen Ereignissen relevante Aktualisierungen an einem Profil stattgefunden haben. 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
Für die Daten, die für ein bestimmtes Profil exportiert werden, ist es wichtig, die beiden verschiedenen Konzepte von was den Datenexport für Ihre Amazon Kinesis Ziel 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 zugeordnet werden können Amazon Kinesis Ziele, Änderungen an einer Identität in einem bestimmten Profil bestimmen 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 in der
identityMap
-Objekt wird ebenfalls einbezogen (Experience Platform unterstützt derzeit keine Identitätszuordnung in der Amazon Kinesis Ziel). - Nur die zugeordneten Attribute werden in den Zielexport einbezogen.
Betrachten Sie diesen Datenfluss beispielsweise als Amazon Kinesis Ziel, bei dem im Datenfluss drei Zielgruppen ausgewählt 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 wird im segmentMembership
-Objekt (siehe Exportierte Daten unten), können weitere nicht zugeordnete Zielgruppen angezeigt werden, wenn dieses bestimmte 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 Kunde mit DeLorean Cars Zielgruppe, aber auch Mitglied der "Zurück in die Zukunft" Film und Fans von Science-Fiction Zielgruppen verwenden, sind diese beiden anderen Zielgruppen auch in der segmentMembership
-Objekt des Datenexports, auch wenn diese nicht im Datenfluss zugeordnet sind, wenn diese dieselbe Zusammenführungsrichtlinie mit der Kunde mit DeLorean Cars Segment.
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 qualifiziert haben before die Zielgruppe, die zum Ziel hinzugefügt wurde, innerhalb von etwa einer Stunde an das Ziel exportiert werden.
Exportierte Daten exported-data
Ihre exportierten Experience Platform-Daten landen in Ihrem Amazon Kinesis-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
Abschnittcode language-json |
---|
|
segmentMembership
Abschnittcode 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.