DokumentationAEM 6.5Användarhandbok

Integrering med Adobe Target med IMS integration-with-adobe-target-using-ims

Last update: Fri Apr 12 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

Skapat för:

  • Admin

Integreringen av AEM med Adobe Target via Target Standard API kräver att Adobe IMS (Identity Management System) konfigureras med Adobe Developer Console.

NOTE
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.

Förutsättningar prerequisites

Innan du börjar med den här proceduren:

  • Stöd för Adobe måste tillhandahålla ditt konto för:

    • Adobe Console
    • Adobe Developer Console
    • Adobe Target och
    • Adobe IMS (Identity Management System)

  • 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.

    • Detta ger specifika utvecklare behörighet att aktivera integreringar i Adobe Developer Console.
    • Se Hantera utvecklare.

Konfigurera en IMS-konfiguration - Generera en offentlig nyckel configuring-an-ims-configuration-generating-a-public-key

Det första steget i konfigurationen är att skapa en IMS-konfiguration i AEM och generera den offentliga nyckeln.

  1. Öppna AEM verktyg -menyn.

  2. I Säkerhet avsnitt, markera Adobe IMS-konfigurationer.

  3. Välj Skapa för att öppna Adobe IMS Technical Account Configuration.

  4. Använda listrutan under Molnkonfiguration, markera Adobe Target.

  5. Aktivera Skapa nytt certifikat och ange ett nytt alias.

  6. Bekräfta med Skapa certifikat.

    Guiden Konfigurera Adobe IMS Technical Account

  7. 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.

    note caution
    CAUTION
    Låt konfigurationen vara öppen. Den behövs igen när Slutför IMS-konfigurationen i AEM.

    Informationsmeddelande om att lägga till certifikat på Adobe I/O

Konfigurera IMS för Adobe Target-integrering med AEM configuring-ims-for-adobe-target-integration-with-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.

Skapa projektet creating-the-project

Öppna Adobe Developer Console för att skapa ett projekt med Adobe Target som AEM kan använda:

CAUTION
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.

  1. Öppna Adobe Developer Console for Projects:

    https://developer.adobe.com/console/projects

  2. 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.

      Skapa nytt projekt - första projektet

    • Om du redan har befintliga projekt visas dessa och Skapa nytt projekt är uppe till höger.

      Skapa nytt projekt - flera projekt

  3. Välj Lägg till i projekt följt av API:

    Adobe Developer Console

  4. Välj Adobe Target sedan Nästa:

    note note
    NOTE
    Om du prenumererar på Adobe Target, men inte ser det i listan, bör du kontrollera Förutsättningar.

    Klicka på nästa

  5. Överför din offentliga nyckel och när det är klart fortsätter du med Nästa:

    Lägga till integreringar med Developer Console

  6. Granska inloggningsuppgifterna och fortsätt med Nästa:

    Skapa ett projekt

  7. Välj önskade produktprofiler och fortsätt med Spara konfigurerat API:

    note note
    NOTE
    Vilka produktprofiler som visas beror på om du har:
    • Adobe Target Standard - endast Standardarbetsyta är tillgänglig
    • Adobe Target Premium - alla tillgängliga arbetsytor visas i listan enligt nedan

    Välja ett API att lägga till

  8. Skapandet bekräftas.

Tilldela behörigheter till integreringen assigning-privileges-to-the-integration

Tilldela nu de nödvändiga behörigheterna till integreringen:

  1. Öppna Adobe Admin Console:

  2. Navigera till Produkter (övre verktygsfältet) och sedan välja ADOBE TARGET - <din-tenant-id> (från vänster panel).

  3. Välj Produktprofiler och sedan den arbetsyta du behöver i den lista som visas. Exempel: Standardarbetsyta.

  4. Välj API-autentiseringsuppgifter och sedan den integreringskonfiguration som krävs.

  5. Välj Redigerare som Produktroll; i stället för Observer.

Information lagrad för Adobe Developer Console Integration Project details-stored-for-the-ims-integration-project

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:

  • Projektöversikt

  • Insikter

  • Referenser

    • Tjänstkonto (JWT)

      • Information om autentiseringsuppgifter
      • Generera JWT

  • APIS

    • Exempel: Adobe Target

Vissa av dessa måste integreras i AEM baserat på IMS.

Slutför IMS-konfigurationen i AEM completing-the-ims-configuration-in-aem

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:

  1. Återgå till IMS-konfiguration öppnas i AEM.

  2. Välj Nästa.

  3. Här kan du använda information från projektkonfigurationen i Adobe Developer Console:

    • Titel: Din text.
    • Auktoriseringsserver: Kopiera/klistra in detta från aud rad i Nyttolast avsnitt nedan, till exempel https://ims-na1.adobelogin.com i exemplet nedan
    • API-nyckel: Kopiera detta från Ökning section
    • Klienthemlighet: Generera detta i Ökning och kopiera
    • Nyttolast: Kopiera detta från Generera JWT section

    Konfiguration av tekniskt konto

  4. Bekräfta med Skapa.

  5. Din Adobe Target-konfiguration visas i AEM.

    Adobe IMS Technical Account Configuration

Bekräfta IMS-konfigurationen confirming-the-ims-configuration

Så här bekräftar du att konfigurationen fungerar som förväntat:

  1. Öppna:

    • https://localhost<port>/libs/cq/adobeims-configuration/content/configurations.html

    Till exempel:

    • https://localhost:4502/libs/cq/adobeims-configuration/content/configurations.html

  2. Välj din konfiguration.

  3. Välj Kontrollera hälsa i verktygsfältet, följt av Kontrollera.

    Adobe IMS-konfigurationer

  4. Om det lyckas visas meddelandet:

    Kontrollera en konfiguration

Konfigurera Adobe Target-Cloud Servicen configuring-the-adobe-target-cloud-service

Det går nu att referera till konfigurationen för en Cloud Service som använder Target Standard API:

  1. Öppna verktyg -menyn. Sedan, i Cloud Service avsnitt, markera Äldre Cloud Service.

  2. Bläddra nedåt till Adobe Target och markera Konfigurera nu.

    The Skapa konfiguration öppnas.

  3. 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).

  4. Bekräfta med Skapa.

    The Redigera komponent öppnas.

  5. Ange informationen i dialogrutan Adobe Target-inställningar tab:

    • Autentisering: IMS

    • Klient-ID: Adobe IMS-klientens ID. Se även Klient-ID och klientkod -avsnitt.

      note note
      NOTE
      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.

    note note
    NOTE
    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).

  6. Klicka Anslut till mål för att initiera anslutningen till Adobe Target.

    Om anslutningen lyckas visas meddelandet Anslutningen lyckades visas.

  7. Välj OK i meddelandet, följt av OK i dialogrutan så att du kan bekräfta konfigurationen.

  8. 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.

Klient-ID och klientkod tenant-client

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:

  1. För de flesta kunder är innehavar-ID och klientkod samma. Det innebär att båda fälten innehåller samma information och är identiska. Se till att du anger klient-ID i båda fälten.
  2. För äldre syften kan du även ange olika värden i fälten Klient-ID och Klientkod.

I båda fallen bör du tänka på följande:

  • Som standard kopieras även klientkoden (om den läggs till först) automatiskt till fältet Klient-ID.
  • Du kan ändra standardinställningen för klient-ID.
  • Därför baseras backend-anropen till Target på klientens ID och klientsidans anrop till Target baseras på klientkoden.

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.

NOTE
Om du vill ändra en befintlig målkonfiguration:
  1. Ange klientorganisations-ID:t igen.
  2. Återanslut till mål.
  3. Spara konfigurationen.
recommendation-more-help
19ffd973-7af2-44d0-84b5-d547b0dffee2