Det här målet är bara tillgängligt för Adobe Real-time Customer Data Platform Ultimate kunder.
HTTP API-målet är en Adobe Experience Platform direktuppspelningsmål som hjälper dig att skicka profildata till HTTP-slutpunkter från tredje part.
Om du vill skicka profildata till HTTP-slutpunkter måste du först ansluta till målet in Adobe Experience Platform.
Med HTTP API-målet kan du exportera XDM-profildata och målgruppssegment till generiska HTTP-slutpunkter. Där kan du köra dina egna analyser eller utföra andra åtgärder du kan behöva för profildata som exporterats från Experience Platform.
HTTP-slutpunkter kan antingen vara kundernas egna system eller tredjepartslösningar.
Se tabellen nedan för information om exporttyp och frekvens för destinationen.
Objekt | Typ | Anteckningar |
---|---|---|
Exporttyp | Profile-based | Du exporterar alla medlemmar i ett segment tillsammans med önskade schemafält (till exempel: e-postadress, telefonnummer, efternamn), som du har valt på mappningsskärmen på arbetsflöde för målaktivering. |
Exportfrekvens | Streaming | Direktuppspelningsmål är alltid på API-baserade anslutningar. Så snart en profil uppdateras i Experience Platform baserat på segmentutvärdering skickar kopplingen uppdateringen nedåt till målplattformen. Läs mer om mål för direktuppspelning. |
Om du vill använda HTTP API-målet för att exportera data från Experience Platform måste du uppfylla följande krav:
Du kan också använda Adobe Experience Platform Destination SDK för att konfigurera en integrering och skicka Experience Platform-profildata till en HTTP-slutpunkt.
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 HTTP API-destinationen. Se IP-adress tillåtelselista för direktuppspelningsmål för den fullständiga listan över IP-adresser som ska tillåtslista.
HTTP API-målet stöder flera autentiseringstyper för HTTP-slutpunkten:
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>'
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'
Om du vill ansluta till målet behöver du Manage Destinations åtkomstkontrollbehörighet. Läs åtkomstkontroll - översikt eller kontakta produktadministratören för att få de behörigheter som krävs.
Om du vill ansluta till det här målet följer du stegen som beskrivs i självstudiekurs om destinationskonfiguration. När du ansluter till det här målet måste du ange följande information:
Om du väljer Bearer token autentiseringstyp för att ansluta till HTTP-slutpunkten, ange fälten nedan och markera Connect to destination:
Om du väljer None autentiseringstyp för att ansluta till HTTP-slutpunkten:
När du har valt den här autentiseringen öppen behöver du bara välja Connect to destination och anslutningen till slutpunkten har upprättats.
Om du väljer OAuth 2 Password autentiseringstyp för att ansluta till HTTP-slutpunkten, ange fälten nedan och markera Connect to destination:
Om du väljer OAuth 2 Client Credentials autentiseringstyp för att ansluta till HTTP-slutpunkten, ange fälten nedan och markera Connect to destination:
Authorization
header efter att base64-kodats och skickats till ditt mål. Se till exempel Autentiseringstyper som stöds -avsnitt.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.
header1:value1,header2:value2,...headerN:valueN
.parameter1=value¶meter2=value
.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 status för ditt dataflöde. Mer information om varningar finns i guiden prenumerera på destinationsvarningar med hjälp av användargränssnittet.
När du är klar med informationen för målanslutningen väljer du Next.
Om du vill aktivera data måste du ha Manage Destinations, Activate Destinations, View Profiles och View Segments behörigheter för åtkomstkontroll. Läs åtkomstkontroll - översikt eller kontakta produktadministratören för att få de behörigheter som krävs.
Se Aktivera målgruppsdata till exportmål för direktuppspelningsprofiler om du vill ha instruktioner om hur du aktiverar målgruppssegment till det här målet.
I Select attributes Adobe rekommenderar att du väljer en unik identifierare från union. Välj den unika identifieraren och eventuella andra XDM-fält som du vill exportera till målet.
Experience Platform optimerar beteendet för profilexport till HTTP API-målet, så att endast data exporteras till API-slutpunkten när relevanta uppdateringar av en profil har gjorts efter segmentkvalificering eller andra viktiga händelser. Profiler exporteras till ditt mål i följande situationer:
I alla de fall som beskrivs ovan exporteras endast de profiler där relevanta uppdateringar har gjorts till ditt mål. Om ett segment som är mappat till målflödet till exempel har hundra medlemmar och fem nya profiler är kvalificerade för segmentet, kommer exporten till målet 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.
När det gäller data som exporteras för en viss profil är det viktigt att förstå de två olika begreppen i vad som avgör en dataexport till HTTP API-målet och vilka data som inkluderas i exporten.
Vad avgör en målexport | Vad som ingår i målexporten |
---|---|
|
|
Tänk dig till exempel det här dataflödet till ett HTTP-mål där tre segment är markerade i dataflödet och fyra attribut är mappade till målet.
En profilexport till målet kan bestämmas av en profil som kvalificerar för eller avslutar en av tre mappade segment. I dataexporten kan du dock segmentMembership
objekt (se Exporterade data nedan) kan andra omappade segment visas om den aktuella profilen är medlem av dem och om dessa delar samma sammanfogningsprincip som det segment som utlöste exporten. Om en profil kvalificerar sig för Kund med DeLorean Cars men är även medlem i Tittat på "Tillbaka till framtiden" film och Science fiction fans segment, kommer dessa två andra segment också att finnas i segmentMembership
dataexportens objekt, även om dessa inte är mappade i dataflödet, om dessa delar samma sammanfogningsprincip med Kund med DeLorean Cars segment.
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.
När du lägger till ett nytt segment till ett befintligt mål, eller när du skapar ett nytt mål och mappningssegment till det, exporterar Experience Platform data för historiska segmentkvalificeringar till målet. Profiler som är kvalificerade för segmentet före segmentet lades till i målet och exporteras till målet inom ungefär en timme.
Dina exporterade Experience Platform data får plats i HTTP 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":"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"
}
]
}
}
Nedan visas ytterligare exempel på exporterade data, beroende på vilka användargränssnittsinställningar du har valt i anslutningsmålflödet för Include Segment Names och Include Segment Timestamps alternativ:
segmentMembership
section"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
section"segmentMembership": {
"ups": {
"5b998cb9-9488-4ec3-8d95-fa8338ced490": {
"lastQualificationTime": "2019-04-15T02:41:50+0000",
"status": "existing",
"createdAt": 1648553325000,
"updatedAt": 1648553330000,
"mappingCreatedAt": 1649856570000,
"mappingUpdatedAt": 1649856570000,
}
}
}
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.