Komma igång
Översikt overview
På den här sidan beskrivs hur du autentiserar och börjar använda Adobe Experience Platform Destination SDK. Det innehåller instruktioner om hur du får inloggningsuppgifter för Adobe I/O, ett sandlådenamn och åtkomstkontrollbehörighet för målredigering.
Terminologi terminology
I den här handboken används plattformsspecifika begrepp, som organisation och sandlådor. I Experience Platform-ordlistan finns definitioner av dessa termer. I Destinationens SDK ordlista finns termer som är direkt relaterade till den här funktionen.
Hämta nödvändiga autentiseringsuppgifter obtain-authentication-credentials
Destinationen SDK använder gatewayen Adobe I/O för autentisering. Om du vill göra API-anrop till Destinationens SDK slutpunkter måste du ange vissa rubriker i dina API-anrop. Arbeta med Adobe Exchange-teamet för att konfigurera autentisering för dig till Adobe Developer Console.
Följ självstudiekursen Experience Platform för autentisering för att anropa Destination SDK API-slutpunkter. Starta självstudiekursen från steget Skapa en API-nyckel, ett organisations-ID och en klienthemlighet. Adobe Exchange-teamet kommer att hantera de föregående stegen åt dig. När du är klar med självstudiekursen för autentisering visas värdena för var och en av de obligatoriska rubrikerna i Destination SDK-API-anrop, vilket visas nedan:
x-api-key: {API_KEY}, även kallat klient-IDx-gw-ims-org-id: {ORG_ID}, även kallat organisations-IDAuthorization: Bearer {ACCESS_TOKEN}. Åtkomsttoken har en förfallotid på 24 timmar, uttryckt i millisekunder, så du måste uppdatera den. Om du vill uppdatera åtkomsttoken upprepar du stegen som beskrivs i självstudiekursen för autentisering.
Ägarskap och sandlådor för mål destination-ownership
Alla resurser i Experience Platform är isolerade till specifika virtuella sandlådor. Begäranden till Destination SDK kräver rubriker som anger namnet på sandlådan som åtgärden utförs i:
x-sandbox-name: {SANDBOX_NAME}
Adobe Exchange-teamet ger dig ditt sandlådenamn, som du måste använda i anrop till Destination SDK API-slutpunkter.
Rollbaserad åtkomstkontroll (RBAC) rbac
Om du vill använda Destination SDK-API-slutpunkterna som beskrivs i referensdokumentationen måste du ha åtkomstkontrollsbehörigheten Destination Authoring . Arbeta med Adobe Exchange-teamet för att få den här behörigheten tilldelad dig i Adobe Admin Console.
Mer information finns i följande dokument för Experience Platform Access Control:
Ytterligare överväganden additional-considerations
- För produkterade/publika destinationer måste alla ändringar som du gör i destinationskonfigurationer, oavsett om du skapar eller redigerar en destinationskonfiguration, granskas och godkännas av Adobe. Ändringarna återspeglas i destinationerna först när granskningen är klar. Detta gäller inte privata destinationer som bara är tillgängliga för dig.
- Endast användare som tillhör samma organisation och har åtkomst till sandlådan kan redigera målkonfigurationen.
Nästa steg next-steps
Genom att följa stegen i den här artikeln fick du inloggningsuppgifter för Adobe I/O, ett sandlådenamn och åtkomstkontrollbehörighet för målredigering. Sedan kan du konfigurera ett mål med Destination SDK.
-
Läs följande konfigurationsguider, beroende på måltyp:
-
Mer information om alla åtgärder finns i API-dokumentationen för målredigering.
-
Använd API-samlingen för målredigering för att konfigurera ditt mål med Destination SDK-API-slutpunkterna. Om du vill komma igång med Postman går du till stegen för att importera miljöer och samlingar och en videoguide för att skapa Postman-miljön.