Konfigurera autentisering för Adobe Target API:er

I Adobe Admin Console kontrollerar du att ditt Adobe-användarkonto har beviljats åtkomst på både produktadministratörsnivå och utvecklarnivå till Target.

I Adobe Developer Console väljer du den Experience Cloud Organization som du vill skapa den här integreringen för. (Observera att du förmodligen bara har åtkomst till en enda Experience Cloud Organization.)

Klicka på Create new project.

Klicka på Add API om du vill lägga till ett REST API i projektet för att få tillgång till Adobe-tjänster och -produkter.

Välj Adobe Target som den Adobe-tjänst du vill integrera med. Klicka på knappen Next som visas.

Välj ett alternativ för att associera offentliga och privata nycklar med tjänstkontointegreringen som du skapar för Target. I det här exemplet väljer du Option 1: Generate a key pair och klickar på Generate keypair.

Anteckna den automatiskt hämtade konfigurationsfilen (config) som innehåller din privata nyckel. Klicka på Next.

Kontrollera platsen för config, som är den komprimerade konfigurationsfilen som skapades i föregående steg, i filsystemet. Återigen innehåller den här config-filen din privata nyckel, som du behöver senare. Den exakta platsen i filsystemet kan skilja sig från den som visas här.

Gå tillbaka till Adobe Developer Console och välj den produktprofil(er) som motsvarar de egenskaper som du använder Adobe Recommendations i. (Om du inte använder egenskaper väljer du standardalternativet för Workspace.) Klicka på Save configured API.

Klicka på Create Integration. Du bör få ett tillfälligt meddelande om att ditt API har konfigurerats.

Som ett sista steg byter du namn på projektet till ett mer meningsfullt namn än det ursprungliga Project 1. Det gör du genom att navigera till projektet med navigeringssökvägen som visas, klicka på Edit project för att komma åt den spärrade Edit Project och byta namn på projektet.

Navigera fortfarande i Adobe Developer Console för att visa det nya projektets Service Account (JWT) inloggningsuppgifter. Använd antingen den vänstra navigeringen eller Credentials-avsnittet så som visas.

I Credential details kan du visa din Public key(s), Client ID och annan information som rör ditt tjänstkonto.

Klicka för att navigera till information om API:t Adobe Target. Använd antingen den vänstra navigeringen eller Anslutna produkter och tjänster så som visas.

Klicka på Download for Postman > Service Account (JWT) för att skapa en JSON-fil som hämtar din autentiseringsinformation för en Postman-miljö.

Observera JSON-filen i filsystemet.

I Postman klickar du på kugghjulsikonen för att hantera dina miljöer och sedan på Import för att importera JSON-filen (miljö).

Välj filen och klicka på Open.

I Postman Hantera miljöer modal klickar du på namnet på den nyligen importerade miljön för att inspektera den. (Ditt miljönamn kan skilja sig från det som visas här. Redigera namnet efter behov. Det behöver inte nödvändigtvis matcha namnet på projektet Adobe.)

Obs! CLIENT_SECRET och API_KEY (tillsammans med andra variabler) har sina värden förifyllda, tagna från din integrering enligt definitionen i Adobe Developer Console. (Postman-variabeln CLIENT_SECRET ska matcha de CLIENT SECRET Adobe-autentiseringsuppgifter som visas i Developer Console, och API_KEY i Postman ska likaså matcha CLIENT ID i Developer Console.) Obs! PRIVATE_KEY, JWT_TOKEN och ACCESS_TOKEN är däremot tomma. Vi börjar med att ange värdet PRIVATE_KEY.

Öppna config-filen från filsystemet och öppna private-nyckelfilen.

Markera och kopiera hela innehållet i nyckelfilen private.

Klistra in värdet för din privata nyckel i fälten INITIAL VALUE och CURRENT VALUE i Postman.

Klicka på Update och stäng modala miljöer.

Navigera till Adobe Identity Management Service API-exempelanrop.

Klicka på Adobe I/O Access Token Generation Postman collection.

Hämta rå-JSON för den här samlingen genom att klicka på Raw och sedan kopiera den resulterande JSON-filen till Urklipp. (Du kan också spara raw-JSON som en .json-fil.)

I Postman importerar du samlingen genom att klistra in och skicka rå JSON från Urklipp. (Du kan också överföra den .json-fil som du sparade.) Klicka på Continue.

Markera IMS: JWT Generate + Auth via User Token-begäran i Postman-samlingen för generering av Adobe I/O Access-token, kontrollera att din miljö är markerad och klicka på Send för att generera token.

Öppna Hantera miljöer modal igen och välj din miljö.

Observera att värdena ACCESS_TOKEN och JWT_TOKEN nu är ifyllda.

Importera Adobe Target Admin-API:erna för Postman Collection. Följ alla instruktioner tills samlingen har importerats till Postman.

Expandera samlingen och notera List activities-begäran.

Observera att variabler som {{access_token}} från början inte har matchats. Du kan lösa detta på flera olika sätt - du kan till exempel definiera en ny samlingsvariabel som heter {{access_token}} - men i den här guiden ändrar du API-begäran så att den utnyttjar den Postman-miljö som du använde tidigare. På så sätt kan miljön fortsätta att fungera som en enda, konsekvent konsolidering av alla variabler som är gemensamma för olika API:er i Adobe.

Skriv som ska ersätta {{access_token}} med {{ACCESS_TOKEN}}.

Skriv som ska ersätta {{api_key}} med {{API_KEY}}.

Skriv som ska ersätta {{tenant}} med {{TENANT_ID}}. Anteckningen {{TENANT_ID}} känns inte igen än.

Öppna modal Hantera miljöer och välj din miljö.

Skriv för att lägga till en ny {{TENANT_ID}}-miljövariabel. Kopiera och klistra in ditt klient-ID-värde i fälten INITIAL VALUE och CURRENT VALUE för den nya TENANT_ID -miljövariabeln.

Skicka din begäran efter att du har valt rätt miljö. Du bör få ett svar med din lista över aktiviteter.