Integreringen av AEM med Adobe Target via Target Standard API kräver att Adobe IMS (Identity Management System) konfigureras med Adobe Developer Console.
Stöd för Adobe Target Standard API är nytt i AEM 6.5. Målstandard-API:t använder IMS-autentisering.
Det finns fortfarande stöd för att använda Adobe Target Classic API i AEM för bakåtkompatibilitet. The Target Classic API använder inloggningsuppgifter.
API-valet styrs av den autentiseringsmetod som används för AEM/Target-integrering.
Se även Klient-ID och klientkod -avsnitt.
Innan du börjar med den här proceduren:
Stöd för Adobe måste tillhandahålla ditt konto för:
Din organisations systemadministratör bör använda Admin Console för att lägga till de utvecklare som behövs i organisationen till de relevanta produktprofilerna.
Det första steget i konfigurationen är att skapa en IMS-konfiguration i AEM och generera den offentliga nyckeln.
Öppna AEM verktyg -menyn.
I Säkerhet avsnitt, markera Adobe IMS-konfigurationer.
Välj Skapa för att öppna Adobe IMS Technical Account Configuration.
Använda listrutan under Molnkonfiguration, markera Adobe Target.
Aktivera Skapa nytt certifikat och ange ett nytt alias.
Bekräfta med Skapa certifikat.
Välj Ladda ned (eller Hämta offentlig nyckel) för att hämta filen till den lokala hårddisken, så att den är klar att användas när konfigurera IMS för Adobe Target-integrering med AEM.
Låt konfigurationen vara öppen. Den behövs igen när Slutför IMS-konfigurationen i AEM.
Med Adobe Developer Console skapar du ett projekt (integration) med Adobe Target som AEM kan använda och tilldelar sedan de behörigheter som krävs.
Öppna Adobe Developer Console för att skapa ett projekt med Adobe Target som AEM kan använda:
För närvarande stöder Adobe endast Adobe Developer Console Tjänstkonto (JWT) autentiseringsuppgiftstyp.
Använd inte OAuth Server-till-server autentiseringsuppgiftstyp, som kommer att stödjas i framtiden.
Öppna Adobe Developer Console for Projects:
Alla projekt du har visas. Välj Skapa nytt projekt - plats och användning beror på följande:
Om du inte har något projekt än, Skapa nytt projekt är centrerad, nederst.
Om du redan har befintliga projekt visas dessa och Skapa nytt projekt är uppe till höger.
Välj Lägg till i projekt följt av API:
Välj Adobe Target sedan Nästa:
Om du prenumererar på Adobe Target, men inte ser det i listan, bör du kontrollera Förutsättningar.
Överför din offentliga nyckel och när det är klart fortsätter du med Nästa:
Granska inloggningsuppgifterna och fortsätt med Nästa:
Välj önskade produktprofiler och fortsätt med Spara konfigurerat API:
Vilka produktprofiler som visas beror på om du har:
Skapandet bekräftas.
Tilldela nu de nödvändiga behörigheterna till integreringen:
Öppna Adobe Admin Console:
Navigera till Produkter (övre verktygsfältet) och sedan välja ADOBE TARGET - <din-tenant-id> (från vänster panel).
Välj Produktprofiler och sedan den arbetsyta du behöver i den lista som visas. Exempel: Standardarbetsyta.
Välj API-autentiseringsuppgifter och sedan den integreringskonfiguration som krävs.
Välj Redigerare som Produktroll; i stället för Observer.
I Adobe Developer Console - Projekt kan du se en lista över alla dina integreringsprojekt:
Om du vill visa mer information om konfigurationen väljer du Visa (till höger om ett visst projektbidrag). Bland dessa finns:
Vissa av dessa måste integreras i AEM baserat på IMS.
Om du går tillbaka till AEM kan du slutföra IMS-konfigurationen genom att lägga till de värden som krävs från Adobe Developer Console-integreringen för Target:
Återgå till IMS-konfiguration öppnas i AEM.
Välj Nästa.
Här kan du använda information från projektkonfigurationen i Adobe Developer Console:
aud
rad i Nyttolast avsnitt nedan, till exempel https://ims-na1.adobelogin.com
i exemplet nedanBekräfta med Skapa.
Din Adobe Target-konfiguration visas i AEM.
Så här bekräftar du att konfigurationen fungerar som förväntat:
Öppna:
https://localhost<port>/libs/cq/adobeims-configuration/content/configurations.html
Till exempel:
https://localhost:4502/libs/cq/adobeims-configuration/content/configurations.html
Välj din konfiguration.
Välj Kontrollera hälsa i verktygsfältet, följt av Kontrollera.
Om det lyckas visas meddelandet:
Det går nu att referera till konfigurationen för en Cloud Service som använder Target Standard API:
Öppna verktyg -menyn. Sedan, i Cloud Service avsnitt, markera Äldre Cloud Service.
Bläddra nedåt till Adobe Target och markera Konfigurera nu.
The Skapa konfiguration öppnas.
Ange en Titel och, om du vill, en Namn (om det lämnas tomt genereras det från titeln).
Du kan också välja önskad mall (om fler än en är tillgänglig).
Bekräfta med Skapa.
The Redigera komponent öppnas.
Ange informationen i dialogrutan Adobe Target-inställningar tab:
Autentisering: IMS
Klient-ID: Adobe IMS-klientens ID. Se även Klient-ID och klientkod -avsnitt.
För IMS måste det här värdet hämtas från själva Target. Du kan logga in på Target och extrahera klient-ID:t från URL:en.
Om URL:en till exempel är:
https://experience.adobe.com/#/@yourtenantid/target/activities
Då använder du yourtenantid
.
Klientkod: Se Klient-ID och klientkod -avsnitt.
IMS-konfiguration: välj namnet på IMS-konfigurationen
API-typ: REST
A4T Analytics Cloud-konfiguration: Välj den Analytics Cloud-konfiguration som används för mål och mått för aktivitet. Du behöver detta om du använder Adobe Analytics som rapportkälla när du skapar innehåll för målgruppsanpassning. Om du inte ser din molnkonfiguration kan du läsa anteckningen i Konfigurera A4T Analytics Cloud-konfiguration.
Använd exakt målinriktning: Som standard är den här kryssrutan markerad. Om du väljer det här alternativet väntar molntjänstkonfigurationen på att kontexten ska läsas in innan innehållet läses in. Se följande.
Synkronisera segment från Adobe Target: Välj det här alternativet så att du kan hämta segment som har definierats i Target och använda dem i AEM. Välj det här alternativet när API-typegenskapen är REST, eftersom textbundna segment inte stöds och du alltid måste använda segment från Target. (Den AEM termen segment motsvarar målgruppen.)
Klientbibliotek: Välj om du vill ha klientbiblioteket AT.js eller mbox.js (utgått).
Använd Tag Management System för att leverera klientbibliotek: Använd DTM (utgått), Adobe Launch eller något annat tagghanteringssystem.
Anpassad AT.js: Lämna tomt om du har markerat rutan Tag Management eller om du vill använda AT.js som standard. Du kan även överföra dina anpassade AT.js. Visas bara om du har valt AT.js.
Konfiguration av en Cloud Service som ska använda API:t för klassiska mål har tagits bort (använder fliken Adobe Recommendations-inställningar).
Klicka Anslut till mål för att initiera anslutningen till Adobe Target.
Om anslutningen lyckas visas meddelandet Anslutningen lyckades visas.
Välj OK i meddelandet, följt av OK i dialogrutan så att du kan bekräfta konfigurationen.
Du kan nu fortsätta till Lägga till ett målramverk för att konfigurera ContextHub- eller ClientContext-parametrar som skickas till Target. Observera att detta kanske inte behövs för att exportera AEM Experience Fragments till Target.
Med Adobe Experience Manager 6.5.8.0, hade fältet Klientkod lagts till i fönstret för målkonfigurationen.
Tänk på följande när du konfigurerar fälten för klient-ID och klientkod:
I båda fallen bör du tänka på följande:
Som tidigare nämnts är det första fallet det vanligaste för AEM 6.5. Oavsett vilket, se till att båda fälten innehåller rätt information beroende på dina behov.
Om du vill ändra en befintlig målkonfiguration: