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).
- 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
-
Klik in de linkernavigatie op Extensions
-
Klik op Catalog om naar de pagina van de catalogus Extensies te gaan
-
Let op de verschillende extensies die beschikbaar zijn in de catalogus
-
Typ in het filter bovenaan "id" om de catalogus te filteren
-
Klik op de kaart voor de Adobe Experience Platform Identity Service op Install
-
De organisatie-id van het Experience Cloud is automatisch voor u gedetecteerd.
-
Alle standaardinstellingen behouden en klikken Save to Library and Build
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
-
Open de plaats van de Luma
-
Zorg ervoor debugger het markeringsbezit aan in kaart brengt uw milieu van de Ontwikkeling, zoals die in de vroegere leswordt beschreven.
-
Op het tabblad Overzicht van Foutopsporing geeft de sectie Tags aan dat de extensie Adobe Experience Platform Identity Service is geïmplementeerd.
-
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:
-
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:
-
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:-
De ontwikkelaarsgereedschappen van uw browser openen
-
Ga naar de tab
Application
-
Cookies
aan de linkerkant uitvouwen -
Klik op het domein
https://luma.enablementadobe.com
-
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.
-
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:
Authentication State
—om vast te leggen of de bezoeker is aangemeldEmail (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
-
Klik op Data Elements in de linkernavigatie
-
Klik op de knop Add Data Element
-
Naam van het gegevenselement
Authentication State
-
Selecteer Custom Code voor Data Element Type
-
Klik op de knop Open Editor
-
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"
-
Klik op Save om de aangepaste code op te slaan
-
Alle andere instellingen op de standaardwaarden laten staan
-
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.
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
-
Klik op de knop Add Data Element
toe
-
Naam van het gegevenselement
Email (Hashed)
-
Selecteer JavaScript Variable voor Data Element Type
-
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
-
Alle andere instellingen op de standaardwaarden laten staan
-
Klik op Save to Library om het gegevenselement op te slaan
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
-
Klik in de linkernavigatie op Rules
-
Klik op Add Rule om de Rule Builder te openen
toe
-
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. -
Onder Events klikken Add
toe
- Voor Event Type select Library Loaded (Page Top)
- 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 van50
zult doen. - Klik op de knop Keep Changes om terug te keren naar de Rule Builder
-
Onder Conditions klikken Add
-
Voor Condition Type select Value Comparison
-
Klik het pictogram om het modale element van Gegevens te openen
-
Klik op Authentication State in het gegevenselement Modal en klik vervolgens op Select
-
-
Controleer of
Equals
de operator is -
Typ "aangemeld" in het tekstveld, waardoor de regel wordt geactiveerd wanneer de waarde "Aangemeld" is voor het gegevenselement "Aanmeldingsstatus"
-
Klikken Keep Changes
-
Onder Actions klikken Add
toe
-
Voor Extension select Experience Cloud ID Service
-
Voor Action Type select Set Customer IDs
-
Voor Integration Code voert u
crm_id
in -
Voor Value open de selecteurswijze van het Element van Gegevens en selecteer
Email (Hashed)
-
Voor Auth State select Authenticated
-
Klik op de knop Keep Changes om de handeling op te slaan en terug te keren naar de Rule Builder
-
-
Klik op de knop Save to Library and Build om de regel op te slaan
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
-
Open de plaats van de Luma
-
Zorg ervoor debugger het markeringsbezit aan in kaart brengt uw milieu van de Ontwikkeling, zoals die in de vroegere leswordt beschreven
-
Klik op de koppeling LOGIN in de rechterbovenhoek van de Luminatiesite
-
Voer
test@adobe.com
in als gebruikersnaam -
Voer
test
in als wachtwoord -
Klik op de knop LOGIN
-
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
-
Zorg ervoor dat de tab met de Luminasite de focus heeft
-
Ga in Foutopsporing naar het tabblad Adobe Experience Platform Identity Service
-
Uw organisatie-id uitbreiden
-
Klik op de cel met de waarde
Customer ID - crm_id
-
Let in het modaal op de waarde van de klant-id en op het feit dat de status
AUTHENTICATED
wordt weerspiegeld: -
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:
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.
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:
Volgende "Adobe Target toevoegen" >