[Ultimate]{class="badge positive"}
Amazon Kinesis-anslutning
Översikt :headding-anchor:overview
Med tjänsten Kinesis Data Streams från Amazon Web Services kan du samla in och bearbeta stora dataströmmar i realtid.
Du kan skapa en utgående anslutning i realtid till ditt Amazon Kinesis-lagringsutrymme för att strömma data från Adobe Experience Platform.
- Mer information om Amazon Kinesis finns i Amazon-dokumentationen.
- Om du vill ansluta till Amazon Kinesis programmatiskt läser du API-självstudiekursen för direktuppspelningsmål.
- Om du vill ansluta till Amazon Kinesis med hjälp av användargränssnittet för plattformen kan du läsa avsnitten nedan.
Användningsfall :headding-anchor:use-cases
Genom att använda direktuppspelningsmål som Amazon Kinesis kan du enkelt mata in segmenteringshändelser med högt värde och associerade profilattribut i dina valfria system.
En potentiell kund har till exempel laddat ned ett vitt papper som kvalificerar dem till ett segment med"hög benägenhet att konvertera". Genom att mappa målgruppen som den potentiella kunden hamnar i till målet Amazon Kinesis får du den här händelsen i Amazon Kinesis. Där kan ni använda en"do-it-self"-strategi och beskriva affärslogiken utöver evenemanget, som ni tror fungerar bäst med företagets IT-system.
Målgrupper :headding-anchor:supported-audiences
I det här avsnittet beskrivs vilka typer av målgrupper du kan exportera till det här målet.
Exportera typ och frekvens :headding-anchor:export-type-frequency
Se tabellen nedan för information om exporttyp och frekvens för destinationen.
IP-adress tillåtelselista :headding-anchor:ip-address-allowlist
För att uppfylla kundernas säkerhets- och kompatibilitetskrav tillhandahåller Experience Platform en lista över statiska IP-adresser som du kan tillåtslista för målet Amazon Kinesis. Se IP-adressen tillåtelselista för direktuppspelningsmål för en fullständig lista över IP-adresser som ska tillåtslista.
Amazon Kinesis behörigheter som krävs :headding-anchor:required-kinesis-permission
För att kunna ansluta och exportera data till dina Amazon Kinesis-strömmar behöver Experience Platform behörighet för följande åtgärder:
kinesis:ListStreams
kinesis:PutRecord
kinesis:PutRecords
Dessa behörigheter ordnas via Kinesis-konsolen och kontrolleras av plattformen när du har konfigurerat Kinesis-målet i användargränssnittet för plattformen.
I exemplet nedan visas den lägsta åtkomstbehörighet som krävs för att exportera data till ett Kinesis-mål.
{
"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
Mer information om hur du styr åtkomst för Kinesis dataströmmar finns i följande Kinesis dokument.
Anslut till målet :headding-anchor:connect
Om du vill ansluta till det här målet följer du stegen som beskrivs i självstudiekursen för destinationskonfiguration. När du ansluter till det här målet måste du ange följande information:
Autentiseringsinformation :headding-anchor:authentication-information
Ange fälten nedan och välj Connect to destination:
- Amazon Web Services-åtkomstnyckel och hemlig nyckel: Generera ett
access key - secret access key
-par i Amazon Web Services för att ge plattformsåtkomst till ditt Amazon Kinesis-konto. Läs mer i Amazon Web Services-dokumentationen. - Region: Ange vilken Amazon Web Services-region som data ska strömmas till.
Fyll i målinformation :headding-anchor:destination-details
Om du vill konfigurera information för målet fyller du i de obligatoriska och valfria fälten nedan. En asterisk bredvid ett fält i användargränssnittet anger att fältet är obligatoriskt.
- Name: Ange ett namn för din anslutning till Amazon Kinesis
- Description: Ange en beskrivning för din anslutning till Amazon Kinesis.
- Stream: Ange namnet på en befintlig dataström i ditt Amazon Kinesis-konto. Plattformen exporterar data till den här strömmen.
- Include Segment Names: Växla om du vill att dataexporten ska inkludera namnen på de målgrupper som du exporterar. Ett exempel på en dataexport med det här alternativet markerat finns i avsnittet Exporterade data längre fram.
- Include Segment Timestamps: Växla om du vill att dataexporten ska inkludera UNIX-tidsstämpeln när målgrupperna skapades och uppdaterades, samt UNIX-tidsstämpeln när målgrupperna mappades till målet för aktiveringen. Ett exempel på en dataexport med det här alternativet markerat finns i avsnittet Exporterade data längre fram.
Aktivera aviseringar :headding-anchor:enable-alerts
Du kan aktivera varningar för att få meddelanden om dataflödets status till ditt mål. Välj en avisering i listan om du vill prenumerera och få meddelanden om statusen för ditt dataflöde. Mer information om varningar finns i guiden prenumerera på destinationsvarningar med användargränssnittet.
Välj Next när du är klar med att ange information för målanslutningen.
Aktivera målgrupper till det här målet :headding-anchor:activate
- För att aktivera data behöver du behörigheterna View Destinations, Activate Destinations, View Profiles och View Segments åtkomstkontroll. Läs åtkomstkontrollsöversikten eller kontakta produktadministratören för att få den behörighet som krävs.
- Principutvärdering av samtycke stöds för närvarande inte vid export till Amazon Kinesis-målet. Läs mer.
Se Aktivera målgruppsdata för att direktuppspela profilexportmål för instruktioner om hur du aktiverar målgrupper till det här målet.
Beteende vid export av profiler :headding-anchor:profile-export-behavior
Experience Platform optimerar beteendet för profilexport till ditt Amazon Kinesis-mål, så att endast data exporteras till ditt mål när relevanta uppdateringar av en profil har gjorts efter målgruppsklassificering eller andra viktiga händelser. Profiler exporteras till ditt mål i följande situationer:
- Profiluppdateringen bestäms av en ändring av målgruppsmedlemskap för minst en av målgrupperna som är mappad till målet. Profilen har till exempel kvalificerats för en av de målgrupper som är mappade till målet eller har avslutat en av de målgrupper som är mappade till målet.
- Profiluppdateringen bestäms av en ändring i identitetskartan. En profil som redan är kvalificerad för en av de målgrupper som är mappade till målet har till exempel lagts till som en ny identitet i attributet för identitetskarta.
- Profiluppdateringen bestäms av en attributändring för minst ett av attributen som är mappade till målet. Ett av attributen som är mappade till målet i mappningssteget läggs till i en profil.
I alla de fall som beskrivs ovan exporteras endast de profiler där relevanta uppdateringar har gjorts till ditt mål. Om en målgrupp som mappats till målflödet till exempel har hundra medlemmar och fem nya profiler kvalificerar sig för segmentet, kommer exporten till målplatsen att vara inkrementell och endast innehålla de fem nya profilerna.
Observera att alla mappade attribut exporteras för en profil, oavsett var ändringarna finns. I exemplet ovan exporteras alltså alla mappade attribut för de fem nya profilerna även om attributen inte har ändrats.
Vad avgör en dataexport och vad som ingår i exporten :headding-anchor:what-determines-export-what-is-included
När det gäller data som exporteras för en viss profil är det viktigt att förstå de två olika begreppen vad som avgör en dataexport till ditt Amazon Kinesis mål och vilka data som inkluderas i exporten.
- Kopplade attribut och målgrupper fungerar som referens för en målexport. Det innebär att om någon mappad publik ändrar tillstånd (från
null
tillrealized
eller frånrealized
tillexiting
) eller om några mappade attribut uppdateras, kommer en målexport att startas. - Eftersom identiteter för närvarande inte kan mappas till Amazon Kinesis mål, bestämmer ändringar i en viss profil även destinationsexporter.
- En ändring för ett attribut definieras som en uppdatering för attributet, oavsett om det är samma värde eller inte. Det innebär att en överskrivning av ett attribut betraktas som en ändring även om värdet i sig inte har ändrats.
- Objektet
segmentMembership
innehåller målgruppen som är mappad i aktiveringsdataflödet, för vilket profilens status har ändrats efter en kvalificerings- eller målgruppsavslutningshändelse. Observera att andra omappade målgrupper för vilka profilen är kvalificerad kan ingå i målexporten, om dessa målgrupper tillhör samma sammanfogningsprincip som målgruppen som är mappad i aktiveringsdataflödet. - Alla identiteter i objektet
identityMap
ingår också (Experience Platform stöder för närvarande inte identitetsmappning i målet Amazon Kinesis). - Endast de mappade attributen inkluderas i målexporten.
Ta till exempel det här dataflödet som ett Amazon Kinesis-mål där tre målgrupper har valts i dataflödet och fyra attribut har mappats till målet.
En profilexport till målet kan bestämmas av en profil som kvalificerar för eller avslutar ett av de tre mappade segmenten. I dataexporten, i objektet segmentMembership
(se avsnittet Exporterade datanedan), kan andra omappade målgrupper visas om den aktuella profilen är medlem av dem och om dessa delar samma sammanfogningsprincip som målgruppen som utlöste exporten. Om en profil kvalificerar sig för kunden med DeLorean Cars-målgruppen men även är medlem av Bevakade"Tillbaka till framtiden"- och Science fiction-fans-målgrupperna, kommer dessa två andra målgrupper också att finnas i segmentMembership
-objektet för dataexporten, även om de inte mappas i dataflödet, om de här gemensamma sammanslagningarna Få en policy med segmentet Customer with DeLorean Cars .
När det gäller profilattribut kommer alla ändringar av de fyra attribut som mappas ovan att avgöra målexporten och alla de fyra mappade attributen som finns i profilen kommer att finnas i dataexporten.
Bakgrundsfyllning av historiska data :headding-anchor:historical-data-backfill
När du lägger till en ny målgrupp till ett befintligt mål, eller när du skapar ett nytt mål och mappar målgrupper till det, exporterar Experience Platform historiska data om målgruppskvalificering till målet. Profiler som är kvalificerade för målgruppen innan målgruppen lades till i målet exporteras till målet inom ungefär en timme.
Exporterade data :headding-anchor:exported-data
Dina exporterade Experience Platform-data får plats i ditt Amazon Kinesis-mål i JSON-format. Exporten nedan innehåller till exempel en profil som har kvalificerats för ett visst segment, är medlem i ett annat segment och har avslutat ett annat segment. Exporten innehåller också profilattributets förnamn, efternamn, födelsedatum och personlig e-postadress. Identiteterna för den här profilen är ECID och e-post.
{
"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"
}
]
}
}
Nedan visas ytterligare exempel på exporterade data, beroende på vilka UI-inställningar du har valt i anslutningsmålflödet för alternativen Include Segment Names och Include Segment Timestamps:
segmentMembership
code language-json |
---|
|
segmentMembership
code language-json |
---|
|
Begränsningar och återförsöksprincip :headding-anchor:limits-retry-policy
På 95 % av tiden försöker Experience Platform att erbjuda en genomströmningslatens på mindre än 10 minuter för meddelanden som skickats utan fel med en hastighet på mindre än 10 000 begäranden per sekund för varje dataflöde till en HTTP-destination.
Om det uppstår misslyckade begäranden till HTTP API-målet, lagrar Experience Platform de misslyckade förfrågningarna och försöker skicka dem till slutpunkten två gånger.