[Ultimate]{class="badge positive"}

HTTP API-anslutning

Översikt overview

IMPORTANT
Det här målet är bara tillgängligt för Adobe Real-time Customer Data Platform Ultimate-kunder.

HTTP API-målet är ett Adobe Experience Platform-mål för direktuppspelning 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 i Adobe Experience Platform.

Användningsfall use-cases

Med HTTP API-målet kan du exportera XDM-profildata och målgrupper 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.

Målgrupper supported-audiences

I det här avsnittet beskrivs vilka typer av målgrupper du kan exportera till det här målet.

Målgruppsursprung
Stöds
Beskrivning
Segmentation Service
Publiker som genererats via Experience Platform segmenteringstjänsten.
Anpassade överföringar
Publikerna importerade till Experience Platform från CSV-filer.

Exportera typ och frekvens export-type-frequency

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 (t.ex. e-postadress, telefonnummer, efternamn), som du har valt på mappningsskärmen i målaktiveringsarbetsflödet.
Exportfrekvens
Streaming
Direktuppspelningsmål är alltid på API-baserade anslutningar. Så snart en profil uppdateras i Experience Platform baserat på målgruppsutvärdering skickar anslutningsprogrammet uppdateringen nedströms till målplattformen. Läs mer om direktuppspelningsmål.

Förhandskrav prerequisites

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 måste ha en HTTP-slutpunkt som stöder REST API.
  • HTTP-slutpunkten måste ha stöd för Experience Platform-profilschemat. Ingen omvandling till ett nyttolastschema från tredje part stöds i HTTP API-målet. Se avsnittet exporterade data för ett exempel på Experience Platform-utdataschemat.
  • HTTP-slutpunkten måste ha stöd för rubriker.
TIP
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.

Stöd och certifikat för mTLS-protokoll mtls-protocol-support

Du kan använda Mutual Transport Layer Security (mTLS) för att förbättra säkerheten i utgående anslutningar till HTTP API-målanslutningar.

mTLS är en heltäckande säkerhetsmetod för ömsesidig autentisering som ser till att båda parter delar information är de som gör anspråk på att vara innan data delas. mTLS innehåller ytterligare ett steg jämfört med TLS, där servern också frågar efter klientens certifikat och verifierar det i slutet.

Om du vill använda mTLS med HTTP API mål måste TLS-protokoll vara inaktiverade för den serveradress som du angav på sidan målinformation och bara mTLS aktiverade. Om protokollet TLS 1.2 fortfarande är aktiverat på slutpunkten skickas inget certifikat för klientautentiseringen. Det innebär att om du vill använda mTLS med ditt HTTP API-mål måste den "mottagande" serverslutpunkten vara en mTLS-aktiverad anslutningsslutpunkt.

Hämta certifikat certificate

Om du vill kontrollera att Common Name (CN) och Subject Alternative Names (SAN) utför ytterligare tredjepartsvalidering kan du hämta certifikatet nedan:

IP-adress tillåtelselista 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 HTTP API-destinationen. Se IP-adressen tillåtelselista för direktuppspelningsmål för en fullständig lista över IP-adresser som ska tillåtslista.

Autentiseringstyper som stöds supported-authentication-types

HTTP API-målet stöder flera autentiseringstyper för HTTP-slutpunkten:

  • HTTP-slutpunkt utan autentisering;
  • Autentisering av innehavartoken;
  • OAuth 2.0-klientautentiseringsuppgifter autentiseras med brödtextformuläret, med client ID, client secret och grant type i HTTP-begärans brödtext, vilket visas i exemplet nedan.
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'

Anslut till målet connect-destination

IMPORTANT
Om du vill ansluta till målet behöver du behörigheterna View Destinations och Manage Destinations åtkomstkontroll. Läs åtkomstkontrollsöversikten eller kontakta produktadministratören för att få den behörighet som krävs.

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 authentication-information

Autentisering av innehavartoken bearer-token-authentication

Om du väljer autentiseringstypen Bearer token för att ansluta till HTTP-slutpunkten anger du fälten nedan och väljer Connect to destination:

Bild av gränssnittsskärmen där du kan ansluta till HTTP API-målet med autentisering av innehavartoken.

  • Bearer token: infoga bearer-token för att autentisera på din HTTP-plats.

Ingen autentisering no-authentication

Om du väljer autentiseringstypen None för att ansluta till HTTP-slutpunkten:

Bild av gränssnittsskärmen där du kan ansluta till HTTP API-målet utan autentisering.

När du väljer den här autentiseringen öppen behöver du bara välja Connect to destination och anslutningen till slutpunkten är upprättad.

Lösenordsautentisering för OAuth 2 oauth-2-password-authentication

Om du väljer autentiseringstypen OAuth 2 Password för att ansluta till HTTP-slutpunkten anger du fälten nedan och väljer Connect to destination:

Bild av gränssnittsskärmen där du kan ansluta till HTTP API-målet med OAuth 2 med lösenordsautentisering.

  • Access Token URL: Den URL på din sida som utfärdar åtkomsttoken och, om du vill, uppdatera tokens.
  • Client ID: Den client ID som ditt system tilldelar Adobe Experience Platform.
  • Client Secret: Den client secret som ditt system tilldelar Adobe Experience Platform.
  • Username: Användarnamnet för att komma åt HTTP-slutpunkten.
  • Password: Lösenordet för att komma åt HTTP-slutpunkten.

Autentisering med OAuth 2-klientautentiseringsuppgifter oauth-2-client-credentials-authentication

Om du väljer autentiseringstypen OAuth 2 Client Credentials för att ansluta till HTTP-slutpunkten anger du fälten nedan och väljer Connect to destination:

Bild av gränssnittsskärmen där du kan ansluta till HTTP API-målet med hjälp av OAuth 2 med autentisering av klientautentiseringsuppgifter.

  • Access Token URL: Den URL på din sida som utfärdar åtkomsttoken och, om du vill, uppdatera tokens.

  • Client ID: Den client ID som ditt system tilldelar Adobe Experience Platform.

  • Client Secret: Den client secret som ditt system tilldelar Adobe Experience Platform.

  • Client Credentials Type: Välj den typ av OAuth2-klientautentiseringsuppgifter som stöds av din slutpunkt:

    • Body Form Encoded: I det här fallet inkluderas client ID och client secret i texten för den begäran som skickas till ditt mål. Se till exempel avsnittet Autentiseringstyper som stöds.
    • Basic Authorization: I det här fallet inkluderas client ID och client secret i en Authorization header efter att base64-kodats och skickats till målet. Se till exempel avsnittet Autentiseringstyper som stöds.

Fyll i målinformation 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.

Bild av gränssnittsskärmen som visar slutförda fält för HTTP-målinformationen.

  • Name: Ange ett namn som du känner igen det här målet med i framtiden.
  • Description: Ange en beskrivning som hjälper dig att identifiera det här målet i framtiden.
  • Headers: Ange eventuella anpassade rubriker som du vill ska inkluderas i målanropen, enligt följande format: header1:value1,header2:value2,...headerN:valueN.
  • HTTP Endpoint: URL:en för HTTP-slutpunkten dit du vill skicka profildata.
  • Query parameters: Om du vill kan du lägga till frågeparametrar till HTTP-slutpunkts-URL:en. Formatera de frågeparametrar som du använder så här: parameter1=value&parameter2=value.
  • 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 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 activate

IMPORTANT

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.

Målattribut attributes

I steget Select attributes rekommenderar Adobe att du väljer en unik identifierare från ditt union-schema. Välj den unika identifieraren och eventuella andra XDM-fält som du vill exportera till målet.

Beteende vid export av profiler profile-export-behavior

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 målgruppskvalifikation 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 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 HTTP API-målet och vilka data som inkluderas i exporten.

Vad avgör en målexport
Vad som ingår i målexporten
  • 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 till realized eller från realized till exiting) eller om några mappade attribut uppdateras, kommer en målexport att startas.
  • Eftersom identiteter för närvarande inte kan mappas till HTTP API-mål, bestämmer ändringar i en viss profil även målexporter.
  • 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 HTTP API-målet).
  • Endast de mappade attributen inkluderas i målexporten.

Tänk dig till exempel det här dataflödet till ett HTTP-mål där tre målgrupper har valts i dataflödet och fyra attribut mappas till målet.

Ett exempel på ett måldataflöde för HTTP API.

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-segmentet men även är medlem i Bevakade"Tillbaka till framtiden"- och Science fiction-fans -segmenten, kommer dessa två målgrupper också att finnas i segmentMembership-objektet för dataexporten, även om de inte mappas i dataflödet, om dessa delar samma sammanslagning 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 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 exported-data

Dina exporterade Experience Platform-data får plats i ditt 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":"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:

Exemplet på dataexport nedan innehåller publiknamn i avsnittet 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"
          }
        }
      }
Exemplet på dataexport nedan innehåller målgruppstidsstämplar i avsnittet 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,
          }
        }
      }

Begränsningar och återförsöksprincip 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.

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