De Adobe Experience Platform Identity Service toevoegen
Deze les zal uw door de stappen begeleiden die worden vereist om uit te voeren Adobe Experience Platform Identity Service-extensie en sturen Customer ids.
De Adobe Experience Platform Identity Service Hiermee wordt een gemeenschappelijke bezoeker-id ingesteld voor alle Adobe-oplossingen, zodat de Experience Cloud-mogelijkheden, zoals het delen van het publiek tussen de oplossingen, worden ingeschakeld. 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 (clientzijde) is nu tags
- platform launch Server-zijde is nu event forwarding
- Edge-configuraties 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 Adobe te sturen
- Gebruik de functie voor regelvolgorde om regels uit te voeren die op dezelfde gebeurtenis worden geactiveerd
Vereisten
U had de lessen in het Tags configureren sectie.
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 gebouwd door Adobe, een Adobe-partner 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.
De extensie Identiteitsservice toevoegen
-
Klik in de linkernavigatie op Extensies
-
Klikken Catalogus naar de pagina Extensiecatalogus 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 Installeren
-
De organisatie-id van de Experience Cloud is automatisch voor u gedetecteerd.
-
Alle standaardinstellingen behouden en klikken Opslaan in bibliotheek en samenstellen
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_".
De extensie Identiteitsservice valideren
-
Open de Luminantiesite
-
Controleer of Foutopsporing de eigenschap tag toewijst aan uw Ontwikkelomgeving, zoals beschreven in de eerdere les.
-
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
Application
tab -
Uitbreiden
Cookies
links -
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 informatie over de configuratieopties van de Identiteitsdienst, zie de documentatie.
Klant-id's verzenden
Vervolgens stuurt u een Klant-id aan de identiteitsdienst. Hierdoor kunt u uw CRM integreren met de Experience Cloud en de bezoekers van het spoor over apparaten.
In de vorige les: Gegevenselementen, regels en bibliotheken toevoegen u creeerde een gegevenselement en gebruikte het in een regel. 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 al dan niet is aangemeldEmail (Hashed)
—om de gehashte versie van het e-mailadres (gebruikt als klant ID) van de gegevenslaag te vangen
Het gegevenselement voor de verificatiestatus maken
-
Klikken Gegevenselementen in de linkernavigatie
-
Klik op de knop Gegevenselement toevoegen knop
-
Geef het gegevenselement een naam
Authentication State
-
Voor de Type gegevenselement, selecteert u Aangepaste code
-
Klik op de knop Editor openen knop
-
In de Code bewerken venster, gebruik de volgende code om waarden van "het programma geopend"of "het programma geopend"gebaseerd op een attribuut in de de gegevenslaag van de plaats van de Luma terug te keren:
code language-javascript if (digitalData.user[0].profile[0].attributes.loggedIn) return "logged in" else return "logged out"
-
Klikken Opslaan om de aangepaste code op te slaan
-
Alle andere instellingen op de standaardwaarden laten staan
-
Klikken Opslaan in bibliotheek 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 tot stand te brengen. Op de demo-site Luma gebruikt u de gehashte versie van het e-mailadres van de bezoeker.
Het gegevenselement voor de gehashte-e-mail toevoegen
-
Klik op de knop Gegevenselement toevoegen knop
-
Geef het gegevenselement een naam
Email (Hashed)
-
Voor de Type gegevenselement, selecteert u JavaScript-variabele
-
Als de JavaScript variabelenaam gebruikt u de volgende aanwijzer naar een variabele in de gegevenslaag van de Luministensite:
digitalData.user.0.profile.0.attributes.username
-
Alle andere instellingen op de standaardwaarden laten staan
-
Klikken Opslaan in bibliotheek 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.
Een regel maken om de klant-id's te verzenden
-
Klik in de linkernavigatie op Regels
-
Klikken Regel toevoegen om de Bouwer van de Regel te openen
-
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 Gebeurtenissen klikken Toevoegen
- Voor de Type gebeurtenis selecteren Bibliotheek geladen (pagina boven)
- Breid uit Geavanceerde opties en voor de Volgorde 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
. - Klik op de knop Wijzigingen behouden knoop om aan de Bouwer van de Regel terug te keren
-
Onder Voorwaarden klikken Toevoegen
-
Voor de Type voorwaarde selecteren Waardevergelijking
-
Klik op de knop pictogram om het gegevenselement modaal te openen
-
Klik op de module Gegevenselement op Verificatiestatus en klik vervolgens op Selecteren
-
-
Controleer of
Equals
is de operator -
Typ "aangemeld" in het tekstveld, waardoor de regel wordt geactiveerd wanneer de waarde "Aangemeld" is voor het gegevenselement "Aanmeldingsstatus"
-
Klikken Wijzigingen behouden
-
Onder Handelingen klikken Toevoegen
-
Voor de Extensie selecteren Experience Cloud ID-service
-
Voor de Type handeling selecteren Klant-id's instellen
-
Voor de Integratiecode enter
crm_id
-
Voor de Waarde open de selecteur van het Element van Gegevens modaal en selecteer
Email (Hashed)
-
Voor de Deelstaat Auth selecteren Geverifieerd
-
Klik op de knop Wijzigingen behouden knoop om de actie te bewaren en aan de Bouwer van de Regel terug te keren
-
-
Klik op de knop Opslaan in bibliotheek en samenstellen knop om de regel op te slaan
U hebt nu een regel gecreeerd die identiteitskaart van de Klant als variabele zal verzenden crm_id
wanneer de bezoeker voor authentiek wordt verklaard. Aangezien u de volgorde hebt opgegeven als 10
deze regel wordt geactiveerd voordat u All Pages - Library Loaded
regel die is gemaakt in het dialoogvenster Gegevenselementen, regels en bibliotheken toevoegen les die de standaardwaarde van de Orde van gebruikt 50
.
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.
Aanmelden bij de Luministsite
-
Open de Luminantiesite
-
Controleer of Foutopsporing de eigenschap tag toewijst aan uw Ontwikkelomgeving, zoals beschreven in de eerdere les
-
Klik op de knop AANMELDEN koppeling in de rechterbovenhoek van de Luma-site
-
Enter
test@adobe.com
als de gebruikersnaam -
Enter
test
als wachtwoord -
Klik op de knop AANMELDEN knop
-
Terug naar de startpagina
Bevestig nu dat de klant-id naar de service wordt verzonden met de extensie Foutopsporing.
Om te controleren of de Identiteitsdienst 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 met de
Customer ID - crm_id
value -
Let in het modaal op de waarde van de klant-id en op het feit dat
AUTHENTICATED
toestand 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. Ga naar de Gereedschappen in Foutopsporing en schakel de optie Logboekregistratie voor tagconsole schakelen.
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" >