Aan de slag
Overzicht overview
Op deze pagina wordt beschreven hoe u Adobe Experience Platform Destination SDK kunt verifiëren en gebruiken. Het omvat instructies op hoe te om de authentificatiegeloofsbrieven van de Adobe I/O, een zandbaknaam, en de toestemming van de bestemmings auteurstoegang te verkrijgen.
Terminologie terminology
Deze gids gebruikt Platform-specifieke concepten, zoals organisatie en zandbakken. Raadpleeg de Woordenlijst Experience Platform voor de definities van deze en andere termen.
Verkrijg vereiste authentificatiegeloofsbrieven obtain-authentication-credentials
Destination SDK gebruikt de Adobe I/O gateway voor authentificatie. Om API vraag aan Destination SDK eindpunten te maken, moet u bepaalde kopballen in uw API vraag verstrekken. Werk met het team van de Uitwisseling van de Adobe aan opstellingsauthentificatie voor u aan Adobe Developer Console.
Als u aanroepen naar de eindpunten van de Destination SDK API wilt uitvoeren, volgt u de Zelfstudie over verificatie van Experience Platforms. De zelfstudie starten via het menu "Een API-sleutel, organisatie-id en clientgeheim genereren" stap. Het team van de Uitwisseling van de Adobe zal de vorige stappen voor u behandelen. Het voltooien van de autorisatiezelfstudie biedt de waarden voor elk van de vereiste headers in Destination SDK API-aanroepen, zoals hieronder wordt getoond:
x-api-key: {API_KEY}, ook wel client-id genoemdx-gw-ims-org-id: {ORG_ID}, ook bekend als organisatie-idAuthorization: Bearer {ACCESS_TOKEN}. Het toegangstoken heeft een vervaltijd van 24 uren, die in milliseconden wordt uitgedrukt, zodat zult u het moeten verfrissen. Om het toegangstoken te verfrissen, herhaal de stappen die in het authentificatieleerprogramma worden geschetst.
Eigendom van bestemming en sandboxen destination-ownership
Alle bronnen in Experience Platform zijn geïsoleerd naar specifieke virtuele sandboxen. Verzoeken om Destination SDK vereisen kopballen die de naam van de zandbak specificeren de verrichting in plaatsvindt:
x-sandbox-name: {SANDBOX_NAME}
Het team van de Uitwisseling van de Adobe voorziet u van uw zandbaknaam, die u in vraag aan de Destination SDK API eindpunten moet gebruiken.
Rolgebaseerde toegangscontrole (RBAC) rbac
Om de Destination SDK API eindpunten te gebruiken die in referentiedocumentatie, hebt u de Destination Authoring toegangsbeheermachtiging. Werk met het team van de Uitwisseling van de Adobe om deze toestemming te krijgen die aan u binnen wordt toegewezen Adobe Admin Console.
Lees voor meer informatie de volgende documenten van het Toegangsbeheer van het Experience Platform:
Aanvullende overwegingen additional-considerations
- Voor geproduceerde/openbare bestemmingen, om het even welke veranderingen die u aan bestemmingsconfiguraties aanbrengt, of u creeert of een bestemmingsconfiguratie uitgeeft, moet door Adobe worden herzien en worden goedgekeurd. Uw veranderingen worden weerspiegeld in uw bestemmingen slechts nadat het overzicht wordt gedaan. Dit geldt niet voor particuliere bestemmingen die alleen voor u beschikbaar zijn.
- Alleen de gebruikers die tot dezelfde organisatie behoren en toegang hebben tot de sandbox, kunnen de doelconfiguratie bewerken.
Volgende stappen next-steps
Door de stappen in dit artikel te volgen, hebt u authentificatiegeloofsbrieven aan Adobe I/O, een zandbaknaam, en de toestemming van de bestemmings authoring toegangscontrole verkregen. Vervolgens kunt u een bestemming instellen met behulp van Destination SDK.
-
Lees de volgende configuratiegidsen, afhankelijk van uw bestemmingstype:
-
Raadpleeg voor alle bewerkingen de API-documentatie voor doelontwerp.
-
Gebruik de Postman-collectie van bestemmingsAuthoring API om uw bestemming te vormen gebruikend de Destination SDK API eindpunten. Ga voor informatie over stappen voor het importeren van omgevingen en verzamelingen en videohandleiding voor het maken van de Postman-omgeving.