De Adobe Experience Platform Identity Service toevoegen

Deze les zal uw door de stappen begeleiden die worden vereist om de uitbreiding van de Dienst van de Identiteit van Adobe Experience Platformuit te voeren en klantenids te verzenden.

De Dienst van de Identiteit van Adobe Experience Platformplaatst gemeenschappelijke bezoekersidentiteitskaart over alle oplossingen van de Adobe om de mogelijkheden van het Experience Cloud zoals publiek-deel tussen oplossingen te aandrijven. U kunt ook uw eigen klanten-id's naar de service sturen, zodat u toepassingen op verschillende apparaten kunt zoeken en kunt integreren met uw CRM-systeem (Customer Relationship Management).

NOTE
Adobe Experience Platform Launch wordt in Adobe Experience Platform geïntegreerd als een reeks technologieën voor gegevensverzameling. Verschillende terminologiewijzigingen zijn geïmplementeerd in de interface die u tijdens het gebruik van deze inhoud moet onthouden:
  • Platform launch (de Kant van de Cliënt) is nu tags
  • De Server zijde van de platform launch is nu event forwarding
  • De configuraties van Edge zijn nu datastreams

Leerdoelen

Aan het eind van deze les, zult u kunnen:

  • De extensie Identiteitsservice toevoegen
  • Een gegevenselement maken om uw klantgegevens te verzamelen
  • Maak een regel die de actie "Customer ID's instellen" gebruikt om de id's van de klant naar de Adobe te sturen
  • Gebruik de functie voor regelvolgorde om regels uit te voeren die op dezelfde gebeurtenis worden geactiveerd

Vereisten

U zou de lessen in reeds moeten voltooid hebben vormt markeringensectie.

De extensie Identiteitsservice toevoegen

Aangezien dit de eerste extensie is die u toevoegt, volgt hier een kort overzicht van extensies. Extensies zijn een van de kernkenmerken van tags. Een extensie is een integratie die is opgebouwd door Adobe, een partner van een Adobe of een klant van een Adobe die nieuwe en eindeloze opties toevoegt voor de tags die u kunt implementeren op uw website. Als u tags als besturingssysteem beschouwt, zijn extensies de toepassingen die u installeert, zodat tags de taken kunnen uitvoeren die u nodig hebt.

om de Uitbreiding van de Dienst van de Identiteit toe te voegen

  1. Klik in de linkernavigatie op Extensions

  2. Klik op Catalog om naar de pagina van de catalogus Extensies te gaan

  3. Let op de verschillende extensies die beschikbaar zijn in de catalogus

  4. Typ in het filter bovenaan "id" om de catalogus te filteren

  5. Klik op de kaart voor de Adobe Experience Platform Identity Service op Install

    installeer de Uitbreiding van de Dienst van de Identiteit

  6. De organisatie-id van het Experience Cloud is automatisch voor u gedetecteerd.

  7. Alle standaardinstellingen behouden en klikken Save to Library and Build

    sparen de uitbreiding

NOTE
Elke versie van de uitbreiding van de Dienst van de Identiteit komt met een specifieke versie van VisitorAPI.js die in de uitbreidingsbeschrijving wordt genoteerd. U werkt de versie VisitorAPI.js bij door de uitbreiding van de Dienst van de Identiteit bij te werken.

De extensie valideren

De uitbreiding van de Dienst van de Identiteit is één van de weinige marktextensies die een verzoek indient zonder het moeten een regelactie gebruiken. De extensie zal automatisch een aanvraag indienen bij de Identity Service wanneer de eerste pagina van het eerste bezoek aan een website wordt geladen. Zodra de id is aangevraagd, wordt deze opgeslagen in een cookie van de eerste partij die begint met "AMCV_".

om de uitbreiding van de Dienst van de Identiteit te bevestigen

  1. Open de plaats van de Luma

  2. Zorg ervoor debugger het markeringsbezit aan in kaart brengt uw milieu van de Ontwikkeling, zoals die in de vroegere leswordt beschreven.

  3. Op het tabblad Overzicht van Foutopsporing geeft de sectie Tags aan dat de extensie Adobe Experience Platform Identity Service is geïmplementeerd.

  4. Ook, op het Summiere lusje, zou de sectie van de Dienst van de Identiteit met zelfde identiteitskaart moeten bevolken van Org die op uw scherm van de uitbreidingsconfiguratie in de interface van de Inzameling van Gegevens was:

    Controle dat de uitbreiding van de Dienst van de Identiteit van Adobe Experience Platform wordt uitgevoerd

  5. Het aanvankelijke verzoek om identiteitskaart van de Bezoeker terug te winnen zou op het lusje van de Dienst van de Identiteit van Debugger kunnen verschijnen. Misschien is het al gevraagd, dus maak je geen zorgen als je het niet ziet:
    Controle om te zien of is er een verzoek aan de Dienst van de Identiteit met uw Id van Org

  6. Na de eerste aanvraag om de bezoeker-id op te halen, wordt de id opgeslagen in een cookie waarvan de naam begint met AMCV_ . U kunt als volgt bevestigen dat de cookie is ingesteld:

    1. De ontwikkelaarsgereedschappen van uw browser openen

    2. Ga naar de tab Application

    3. Cookies aan de linkerkant uitvouwen

    4. Klik op het domein https://luma.enablementadobe.com

    5. Zoek naar het AMCV_ cookie aan de rechterkant. U ziet mogelijk verschillende keren dat de Luma-site is geladen met zowel de eigenschap hardcoded tag als de eigen eigenschap.

      verifieer AMCV_cookie

Dat is het! U hebt de eerste extensie toegevoegd! Voor meer details over de configuratieopties van de Dienst van de Identiteit, zie de documentatie.

Klant-id's verzenden

Daarna, zult u identiteitskaart van de a Klantnaar de Dienst van de Identiteit verzenden. Dit zal u toestaan om uw CRMmet het Experience Cloud evenals spoorbezoekers over apparaten te integreren.

In de vroegere les, voegt de Elementen van Gegevens, Regels, en Bibliothekentoe u een gegevenselement creeerde en het in een regel gebruikte. Nu gebruikt u dezelfde technieken om een klant-id te verzenden wanneer de bezoeker is geverifieerd.

Gegevenselementen maken voor de id's van de klant

Begin door twee gegevenselementen te creëren:

  1. Authentication State—om vast te leggen of de bezoeker is aangemeld
  2. Email (Hashed)—om de gehashte versie van het e-mailadres (gebruikt als de klant-id) van de gegevenslaag vast te leggen

om het gegevenselement voor de Staat van de Authentificatie te creëren

  1. Klik op Data Elements in de linkernavigatie

  2. Klik op de knop Add Data Element

    klik voeg het Element van Gegevens toe

  3. Naam van het gegevenselement Authentication State

  4. Selecteer Custom Code voor Data Element Type

  5. Klik op de knop Open Editor

    open de Redacteur om de Code van de Douane voor het Element van Gegevens toe te voegen

  6. In het Edit Code venster, gebruik de volgende code om waarden van "het programma geopend"of "het programma geopend"terug te keren die op een attribuut in de de gegevenslaag van de plaats van de Luma worden gebaseerd:

    code language-javascript
    if (digitalData.user[0].profile[0].attributes.loggedIn)
        return "logged in"
    else
        return "logged out"
    
  7. Klik op Save om de aangepaste code op te slaan

    sparen de douanecode

  8. Alle andere instellingen op de standaardwaarden laten staan

  9. Klik op Save to Library om het gegevenselement op te slaan en terug te keren naar de pagina met gegevenselementen. We hoeven geen 'Build' te doen voordat we al onze wijzigingen hebben aangebracht en klaar zijn om te valideren.

    sparen het gegevenselement

Door de authentificatiestatus van de gebruiker te kennen, weet u wanneer klantenidentiteitskaart op de pagina zou moeten bestaan om naar de Dienst van de Identiteit te verzenden. De volgende stap is een gegevenselement voor klantenidentiteitskaart zelf te creëren. Op de demo-site Luma gebruikt u de gehashte versie van het e-mailadres van de bezoeker.

om het gegevenselement voor hashed e-mail toe te voegen

  1. Klik op de knop Add Data Element

    voeg een gegevenselement toe

  2. Naam van het gegevenselement Email (Hashed)

  3. Selecteer JavaScript Variable voor Data Element Type

  4. Als de JavaScript variable name gebruikt u de volgende aanwijzer naar een variabele in de gegevenslaag van de Luminantiesite: digitalData.user.0.profile.0.attributes.username

  5. Alle andere instellingen op de standaardwaarden laten staan

  6. Klik op Save to Library om het gegevenselement op te slaan

    sparen het gegevenselement

Een regel toevoegen om de klant-id's te verzenden

De Adobe Experience Platform Identity Service geeft de id's van de Klant door in regels met de actie "Customer ID's instellen". U maakt nu een regel om deze handeling te activeren wanneer de bezoeker wordt geverifieerd.

om een regel tot stand te brengen om Klant IDs te verzenden

  1. Klik in de linkernavigatie op Rules

  2. Klik op Add Rule om de Rule Builder te openen

    voeg een regel toe

  3. Naam van de regel All Pages - Library Loaded - Authenticated - 10

    note tip
    TIP
    Deze naamgevingsconventie geeft aan dat u deze regel boven aan alle pagina's afvuurt wanneer de gebruiker wordt geverifieerd en de regel de volgorde "10" heeft. Het gebruiken van een noemende overeenkomst als dit-in plaats van het voor de oplossingen te noemen die in actie-wordt teweeggebracht zal u toestaan om het algemene aantal regels te minimaliseren nodig door uw implementatie.
  4. Onder Events klikken Add

    voeg een gebeurtenis toe

    1. Voor Event Type select Library Loaded (Page Top)
    2. Vouw de sectie Advanced Options uit en selecteer Order enter 10 . De orde controleert de opeenvolging van regels die door de zelfde gebeurtenis worden teweeggebracht. Regels met een lagere volgorde worden vervangen door regels met een hogere volgorde. In dit geval, wilt u klantenidentiteitskaart plaatsen alvorens u het verzoek van het Doel in werking stelt, dat u in de volgende les met een regel met een orde van 50 zult doen.
    3. Klik op de knop Keep Changes om terug te keren naar de Rule Builder

    sparen de gebeurtenis

  5. Onder Conditions klikken Add

    voeg een voorwaarde aan de regel toe

    1. Voor Condition Type select Value Comparison

    2. Klik het pictogram van het gegevenselement pictogram om het modale element van Gegevens te openen

      open het gegevenselement modaal

    3. Klik op Authentication State in het gegevenselement Modal en klik vervolgens op Select

      plaats de authentificatiestatus

  6. Controleer of Equals de operator is

  7. Typ "aangemeld" in het tekstveld, waardoor de regel wordt geactiveerd wanneer de waarde "Aangemeld" is voor het gegevenselement "Aanmeldingsstatus"

  8. Klikken Keep Changes

    sparen de Voorwaarde

  9. Onder Actions klikken Add

    voeg een nieuwe Actie toe

    1. Voor Extension select Experience Cloud ID Service

    2. Voor Action Type select Set Customer IDs

    3. Voor Integration Code voert u crm_id in

    4. Voor Value open de selecteurswijze van het Element van Gegevens en selecteer Email (Hashed)

    5. Voor Auth State select Authenticated

    6. Klik op de knop Keep Changes om de handeling op te slaan en terug te keren naar de Rule Builder

      vorm de actie en bewaar de veranderingen

  10. Klik op de knop Save to Library and Build om de regel op te slaan

    sparen de Regel

U hebt nu een regel gemaakt die de Klant-id als een variabele crm_id zal verzenden wanneer de bezoeker voor authentiek wordt verklaard. Aangezien u de Orde als 10 specificeerde zal deze regel vuren vóór uw All Pages - Library Loaded regel die in wordt gecreeerd voegt Elementen, Regels en Bibliotheken van Gegevensles toe die de waarde van de StandaardOrde van 50 gebruikt.

De klant-id's valideren

Als u uw werk wilt valideren, meldt u zich aan bij de Lumasite om het gedrag van de nieuwe regel te bevestigen.

aan login de plaats van de Luma

  1. Open de plaats van de Luma

  2. Zorg ervoor debugger het markeringsbezit aan in kaart brengt uw milieu van de Ontwikkeling, zoals die in de vroegere leswordt beschreven

    Uw milieu van de tagontwikkeling dat in Debugger wordt getoond

  3. Klik op de koppeling LOGIN in de rechterbovenhoek van de Luminatiesite

    klik Login binnen de hoogste navigatie

  4. Voer test@adobe.com in als gebruikersnaam

  5. Voer test in als wachtwoord

  6. Klik op de knop LOGIN

    ga geloofsbrieven in en klik login

  7. Terug naar de startpagina

Bevestig nu dat de klant-id naar de service wordt verzonden met de extensie Foutopsporing.

om te bevestigen dat de Dienst van de Identiteit klantenidentiteitskaart overgaat

  1. Zorg ervoor dat de tab met de Luminasite de focus heeft

  2. Ga in Foutopsporing naar het tabblad Adobe Experience Platform Identity Service

  3. Uw organisatie-id uitbreiden

  4. Klik op de cel met de waarde Customer ID - crm_id

  5. Let in het modaal op de waarde van de klant-id en op het feit dat de status AUTHENTICATED wordt weerspiegeld:

    Bevestig identiteitskaart van de Klant in Debugger

  6. U kunt de gehashte e-mailwaarde bevestigen door de broncode van de pagina Luma weer te geven en de eigenschap username te bekijken. Deze moet overeenkomen met de waarde die u in Foutopsporing ziet:

    gehakt e-mail in de broncode

Aanvullende tips voor validatie

Tags hebben ook uitgebreide functies voor consoleregistratie. Als u deze wilt inschakelen, gaat u naar het tabblad Tools in Foutopsporing en schakelt u de schakeloptie tags Console Logging in.

Wissel op het Loggen van de Console van markeringen

Hierdoor wordt het aanmelden van de console ingeschakeld in uw browserconsole en op het tabblad Logs van Foutopsporing. U zou het registreren van alle regels moeten zien u tot nu toe hebt gecreeerd! Merk op dat de nieuwe logboekingangen aan de bovenkant van de lijst worden toegevoegd, zodat zou uw regel "Alle Pagina's - Bibliotheek Geladen - voor authentiek verklaard - 10"vóór de "Alle Pagina's - Bibliotheek Geladen"regel moeten in brand steken en onder het in het Logboek van de Console van Foutopsporing verschijnen:

Logs lusje van Debugger

Volgende "Adobe Target toevoegen" >

recommendation-more-help
45774420-d03e-4a6b-94b5-cd639ae825b2