Komma igång med Real-Time Customer Profile-API:t getting-started
Med API-slutpunkter för kundprofil i realtid kan du utföra grundläggande CRUD-åtgärder mot profildata, som att konfigurera beräknade attribut, komma åt enheter, exportera profildata och ta bort onödiga datauppsättningar eller batchar.
Om du vill använda utvecklarhandboken måste du ha en fungerande förståelse för de olika Adobe Experience Platform-tjänster som används för att arbeta med Profile-data. Innan du börjar arbeta med API:t Real-Time Customer Profile bör du läsa dokumentationen för följande tjänster:
- Real-Time Customer Profile: Tillhandahåller en enhetlig kundprofil i realtid baserad på aggregerade data från flera källor.
- Adobe Experience Platform Identity Service: Få en bättre bild av kunden och deras beteende genom att skapa en bro mellan identiteter på olika enheter och system.
- Adobe Experience Platform Segmentation Service: Gör att du kan skapa målgrupper från kundprofildata i realtid.
- Experience Data Model (XDM): Det standardiserade ramverk som Platform använder för att organisera kundupplevelsedata.
- Sandboxes: Experience Platform innehåller virtuella sandlådor som partitionerar en enskild Platform-instans till separata virtuella miljöer för att hjälpa till att utveckla och utveckla program för digitala upplevelser.
I följande avsnitt finns ytterligare information som du behöver känna till för att kunna anropa API-slutpunkter för Profile.
Läser exempel-API-anrop
API-dokumentationen för Real-Time Customer Profile innehåller exempel på API-anrop som visar hur begäranden formateras korrekt. Det kan vara sökvägar, obligatoriska rubriker och korrekt formaterade begärandenyttolaster. Ett exempel på JSON som returneras i API-svar finns också. Information om de konventioner som används i dokumentationen för exempel-API-anrop finns i avsnittet Så här läser du exempel-API-anrop i felsökningsguiden för Experience Platform.
Obligatoriska rubriker
API-dokumentationen kräver också att du har slutfört autentiseringssjälvstudiekursen för att kunna anropa Platform-slutpunkter. När du slutför självstudiekursen för autentisering visas värdena för var och en av de obligatoriska rubrikerna i Experience Platform API-anrop, vilket visas nedan:
Authorization: Bearer {ACCESS_TOKEN}x-api-key: {API_KEY}x-gw-ims-org-id: {ORG_ID}
Alla resurser i Experience Platform är isolerade till specifika virtuella sandlådor. Begäranden till Platform API:er kräver ett huvud som anger namnet på sandlådan som åtgärden ska utföras i:
x-sandbox-name: {SANDBOX_NAME}
Mer information om sandlådor i Platform finns i översiktsdokumentationen för sandlådan.
Alla begäranden med en nyttolast i begärandetexten (till exempel anropen POST, PUT och PATCH) måste innehålla en Content-Type-rubrik. Godkända värden som är specifika för varje anrop finns i anropsparametrarna.
Nästa steg
Om du vill börja ringa anrop med API:t Real-Time Customer Profile väljer du en av de tillgängliga slutpunktsguiderna.