Integratie met Adobe Target met IMS

Voor de integratie van AEM met Adobe Target via de Target Standard API is de configuratie van Adobe IMS (Identity Management System) met behulp van de Adobe Developer Console vereist.

OPMERKING

Ondersteuning voor de Adobe Target Standard API is nieuw in AEM 6.5. De doel-standaard-API gebruikt IMS-verificatie.

Het gebruik van de Classic API van Adobe Target in AEM wordt nog steeds ondersteund voor achterwaartse compatibiliteit. De De Klassieke API van het doel gebruikt gebruikersgeloofsauthentificatie.

De API-selectie wordt aangestuurd door de verificatiemethode die wordt gebruikt voor AEM/doelintegratie.
Zie ook de Aanbestedings-id en clientcode sectie.

Vereisten

Voordat u met deze procedure begint:

  • Adobe-ondersteuning moet je account opgeven voor:

    • Adobe-console
    • Adobe Developer Console
    • Adobe Target en
    • Adobe IMS (Identity Management-systeem)
  • De systeembeheerder van het Systeem van uw organisatie zou de Admin Console moeten gebruiken om de vereiste ontwikkelaars in uw organisatie aan de relevante productprofielen toe te voegen.

    • Hierdoor beschikken de specifieke ontwikkelaars over machtigingen om integratie in de Adobe Developer-console mogelijk te maken.
    • Zie voor meer informatie Ontwikkelaars beheren.

Een IMS-configuratie configureren - Een openbare sleutel genereren

De eerste fase van de configuratie is het creëren van een Configuratie IMS in AEM en het produceren van de Openbare Sleutel.

  1. In AEM opent u de Gereedschappen -menu.

  2. In de Beveiliging sectie selecteren Adobe IMS-configuraties.

  3. Selecteren Maken om de Configuratie technische account van Adobe IMS.

  4. De vervolgkeuzelijst onder gebruiken Cloud Configuration, selecteert u Adobe Target.

  5. Activeren Nieuw certificaat maken en voert u een nieuwe alias in.

  6. Bevestigen met Certificaat maken.

  7. Selecteren Downloaden (of Openbare sleutel downloaden) om het bestand naar uw lokale station te downloaden, zodat het klaar is voor gebruik wanneer IMS configureren voor Adobe Target-integratie met AEM.

    LET OP

    Zorg dat deze configuratie geopend blijft, dat deze opnieuw nodig is wanneer De IMS-configuratie voltooien in AEM.

IMS configureren voor Adobe Target-integratie met AEM

Met de Adobe Developer-console moet u een project (integratie) maken met Adobe Target dat AEM gebruiken en vervolgens de vereiste rechten toewijzen.

Het project maken

Open de Adobe Developer-console om een project te maken met Adobe Target dat AEM gebruiken:

  1. Open de Adobe Developer-console voor projecten:

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

  2. Alle projecten die u hebt, worden weergegeven. Selecteren Nieuw project maken - de locatie en het gebruik zijn afhankelijk van:

    • Als u nog geen project hebt, Nieuw project maken wordt midden onderaan weergegeven.

      Nieuw project maken - eerste project

    • Als u al bestaande projecten hebt, worden deze weergegeven en Nieuw project maken is helemaal rechts.

      Nieuw project maken - Meerdere projecten

  3. Selecteren Toevoegen aan project gevolgd door API:

  4. Selecteren Adobe Target vervolgens Volgende:

    OPMERKING

    Als je bent geabonneerd op Adobe Target, maar deze niet ziet, moet je de knop Vereisten.

  5. Uw openbare sleutel uploaden en, indien voltooid, doorgaan met Volgende:

  6. Controleer de referenties en ga verder met Volgende:

  7. Selecteer de vereiste productprofielen en ga verder met geconfigureerde API opslaan:

    OPMERKING

    De productprofielen die worden weergegeven met, zijn afhankelijk van het volgende:

    • Adobe Target Standard - alleen Standaardwerkruimte is beschikbaar
    • Adobe Target Premium - alle beschikbare werkruimten worden weergegeven, zoals hieronder wordt weergegeven

  8. De oprichting zal worden bevestigd.

Rechten toewijzen aan de integratie

U moet nu de vereiste rechten toewijzen aan de integratie:

  1. De Adobe openen Admin Console:

  2. Navigeren naar Producten (bovenste werkbalk) selecteert u vervolgens Adobe Target - <uw huurder> (in het linkerdeelvenster).

  3. Selecteren Productprofielen, dan uw vereiste werkruimte uit de gepresenteerde lijst. Bijvoorbeeld de standaardwerkruimte.

  4. Selecteren API-referenties, dan de vereiste integratieconfiguratie.

  5. Selecteren Editor als de Productrol; in plaats van Waarnemer.

Gegevens opgeslagen voor het Adobe Developer Console Integration Project

Vanuit de Adobe Developer Console - Projecten kunt u een lijst met al uw integratieprojecten zien:

Selecteren Weergave (rechts van een specifieke projectvermelding) om verdere details over de configuratie te tonen. Deze omvatten:

  • Overzicht van project
  • Inzichten
  • Credentials
    • Serviceaccount (JWT)
      • Referentiegegevens
      • JWT genereren
  • APIS
    • Bijvoorbeeld Adobe Target

Bij sommige hiervan moet u de integratie van Adobe Target in AEM op basis van IMS voltooien.

De IMS-configuratie voltooien in AEM

Als u terugkeert naar AEM kunt u de IMS-configuratie voltooien door de vereiste waarden van de integratie van de Adobe Developer-console voor Target toe te voegen:

  1. Terugkeren naar de IMS-configuratie geopend in AEM.

  2. Selecteren Volgende.

  3. Hier kunt u de details van de projectconfiguratie in de Adobe Developer Console:

    • Titel: Uw tekst.
    • Autorisatieserver: Kopieer/plak deze vanuit de aud lijn van de Payload hieronder, bijvoorbeeld https://ims-na1.adobelogin.com in het onderstaande voorbeeld
    • API-sleutel: Kopieer deze van de Overzicht sectie
    • Clientgeheim: Dit genereren in het dialoogvenster Overzicht en kopiëren
    • Payload: Kopieer deze van de JWT genereren sectie

  4. Bevestigen met Maken.

  5. Uw Adobe Target-configuratie wordt weergegeven in de AEM console.

De IMS-configuratie bevestigen

Om te bevestigen dat de configuratie zoals verwacht werkt:

  1. Open:

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

    Bijvoorbeeld:

    • https://localhost:4502/libs/cq/adobeims-configuration/content/configurations.html
  2. Selecteer uw configuratie.

  3. Selecteren Health controleren van de werkbalk, gevolgd door Controleren.

  4. Als dit lukt, wordt het bericht weergegeven:

De Adobe Target-Cloud Service configureren

Er kan nu naar de configuratie worden verwezen, zodat een Cloud Service de standaard-API van het doel kan gebruiken:

  1. Open de Gereedschappen -menu. Dan, binnen Cloud Services sectie, selecteert u Oudere Cloud Services.

  2. Omlaag schuiven naar Adobe Target en selecteert u Nu configureren.

    De Configuratie maken wordt geopend.

  3. Voer een Titel en, indien gewenst, een Naam (als deze optie leeg blijft, wordt deze gegenereerd op basis van de titel).

    U kunt ook de vereiste sjabloon selecteren (als er meerdere sjablonen beschikbaar zijn).

  4. Bevestigen met Maken.

    De Component bewerken wordt geopend.

  5. Voer de gegevens in het dialoogvenster Adobe Target-instellingen tab:

    • Verificatie: IMS

    • Tenant-id: de Adobe IMS Tenant ID. Zie ook de Aanbestedings-id en clientcode sectie.

      OPMERKING

      Voor IMS moet deze waarde van Target zelf worden genomen. U kunt zich aanmelden bij Target en de Tenant-id uit de URL extraheren.

      Als de URL bijvoorbeeld:

      https://experience.adobe.com/#/@yourtenantid/target/activities

      Vervolgens gebruikt u yourtenantid.

    • Clientcode: Zie de Aanbestedings-id en clientcode sectie.

    • IMS-configuratie: Selecteer de naam van de IMS-configuratie

    • API-type: REST

    • A4T Analytics Cloud-configuratie: Selecteer de de wolkenconfiguratie van de Analyse die voor de doelstellingen en metriek van de doelactiviteit wordt gebruikt. Dit is nodig als u Adobe Analytics als rapportagebron gebruikt wanneer u inhoud als doel instelt. Als u de cloudconfiguratie niet ziet, raadpleegt u de opmerking in A4T Analytics Cloud-configuratie configureren.

    • Nauwkeurige doelgerichtheid gebruiken: Dit selectievakje is standaard ingeschakeld. Als deze optie is geselecteerd, wacht de configuratie van de cloudservice tot de context is geladen voordat inhoud wordt geladen. Zie het volgende.

    • Segmenten synchroniseren vanuit Adobe Target: Selecteer deze optie om segmenten te downloaden die in Doel zijn gedefinieerd om deze in AEM te gebruiken. U moet deze optie selecteren wanneer het bezit van het Type API REST is, omdat de gealigneerde segmenten niet worden gesteund en u altijd segmenten van Doel moet gebruiken. (De AEM term 'segment' komt overeen met de doelterm 'publiek'.)

    • Clientbibliotheek: Selecteer of u de AT.js cliëntbibliotheek, of mbox.js (afgekeurd) wilt.

    • Tag Management System gebruiken om clientbibliotheek te leveren: Gebruik DTM (afgekeurd), Adobe Launch of een ander systeem voor tagbeheer.

    • Aangepaste AT.js: Laat leeg als u het vak Tag Management hebt ingeschakeld of als u de standaard-AT.js wilt gebruiken. U kunt ook uw aangepaste AT.js uploaden. Wordt alleen weergegeven als u AT.js hebt geselecteerd.

    OPMERKING

    Configuratie van een Cloud Service om de Klassieke API van het Doel te gebruiken is vervangen (gebruikt het tabblad Adobe Recommendations-instellingen).

  6. Klikken Verbinden met doel om de verbinding met Adobe Target te initialiseren.

    Als de verbinding tot stand is gebracht, wordt het bericht Verbinding gelukt wordt weergegeven.

  7. Selecteren OK op het bericht, gevolgd door OK in het dialoogvenster om de configuratie te bevestigen.

  8. U kunt nu doorgaan naar Een doelframework toevoegen om parameters te vormen ContextHub of ClientContext die naar Doel zullen worden verzonden. Dit is mogelijk niet vereist voor het exporteren AEM Experience Fragments naar Target.

Aanbestedings-id en clientcode

Met Adobe Experience Manager 6.5.8.0, was het gebied van de Code van de Cliënt toegevoegd aan het de configuratievenster van het Doel.

Houd rekening met het volgende wanneer u de velden Tenant ID en Client Code configureert:

  1. Voor de meeste klanten, zijn identiteitskaart van de Aannemer en de Code van de Cliënt het zelfde. Dit betekent dat beide velden dezelfde informatie bevatten en identiek zijn. Zorg ervoor dat u de id van de huurder in beide velden invoert.
  2. Voor oudere doeleinden kunt u ook verschillende waarden invoeren in de velden Tenant ID en Client Code.

Houd er in beide gevallen rekening mee dat:

  • Door gebrek, zal de Code van de Cliënt (als eerst toegevoegd) ook automatisch in het gebied van identiteitskaart van de Aannemer worden gekopieerd.
  • U kunt de standaard huurder-id wijzigen.
  • Dienovereenkomstig, zal de achterste vraag aan Doel op identiteitskaart van de Aannemer en de cliënt zijvraag aan Doel worden gebaseerd op de Code van de Cliënt.

Zoals eerder vermeld, is de eerste zaak de meest voorkomende voor AEM 6.5. Hoe dan ook, zorg ervoor beide de velden bevatten de juiste gegevens, afhankelijk van uw vereisten.

OPMERKING

Als u een bestaande Configuratie van het Doel wilt veranderen:

  1. Voer de huurder-id opnieuw in.
  2. Maak opnieuw verbinding met Doel.
  3. Sla de configuratie op.

Op deze pagina