Lägg till Adobe Experience Platform identitetstjänst
I den här lektionen får du hjälp att följa de steg som krävs för att implementera Adobe Experience Platform Identity Service-tillägget och skicka kund-ID:n.
Adobe Experience Platform Identity Service ställer in ett gemensamt besökar-ID för alla Adobe-lösningar för att driva Experience Cloud-funktioner som målgruppsdelning mellan olika lösningar. Du kan också skicka dina egna kund-ID:n till tjänsten för att möjliggöra målinriktning och integrering mellan olika enheter med CRM-systemet (Customer Relationship Management).
- Platforma launchen (klientsidan) är nu tags
- Platforma launchens serversida är nu event forwarding
- Edge-konfigurationer är nu datastreams
Utbildningsmål
När lektionen är klar kan du:
- Lägg till identitetstjänsttillägget
- Skapa ett dataelement för att samla in dina kund-ID:n
- Skapa en regel som använder åtgärden Ange kund-ID för att skicka kund-ID:n till Adobe
- Använd funktionen för regelordning för att sekvensera regler som utlöses för samma händelse
Förhandskrav
Du bör redan ha slutfört lektionerna i avsnittet Konfigurera taggar.
Lägg till identitetstjänsttillägget
Eftersom det här är det första tillägget som du lägger till finns det en snabb översikt över tilläggen. Tillägg är en av de viktigaste funktionerna i taggar. Ett tillägg är en integrering som byggts av Adobe, en partner i Adobe eller en Adobe-kund som lägger till nya och oändliga alternativ för de taggar som du kan distribuera på din webbplats. Om du tänker på taggar som ett operativsystem är tillägg de program du installerar så att taggarna kan göra det du behöver för att göra det.
Lägga till identitetstjänsttillägget
-
Klicka på Extensions i den vänstra navigeringen
-
Klicka på Catalog för att gå till sidan för tilläggskatalogen
-
Observera de olika tillägg som är tillgängliga i katalogen
-
I filtret längst upp skriver du"id" för att filtrera katalogen
-
På kortet för Adobe Experience Platform identitetstjänst klickar du på Install
-
Observera att ditt organisations-ID för Experience Cloud har identifierats automatiskt.
-
Lämna alla standardinställningar och klicka på Save to Library and Build
Validera tillägget
Identitetstjänsttillägget är ett av de få taggtillägg som gör en begäran utan att behöva använda en regelåtgärd. Tillägget skickar automatiskt en begäran till identitetstjänsten på första sidan som laddas vid det första besöket på en webbplats. När ID:t har begärts lagras det i en cookie från första part som börjar med AMCV_.
Så här verifierar du identitetstjänsttillägget
-
Öppna Luma-webbplatsen
-
Kontrollera att felsökaren mappar taggegenskapen till din-utvecklingsmiljö, enligt beskrivningen i tidigare lektionen.
-
På fliken Sammanfattning i felsökaren bör taggavsnittet ange att tillägget för Adobe Experience Platform Identity Service är implementerat.
-
På fliken Sammanfattning ska identitetstjänstens avsnitt även innehålla samma Org ID som fanns på din tilläggskonfigurationsskärm i datainsamlingsgränssnittet:
-
Den första begäran om att hämta besökar-ID:t kan visas på fliken Identitetstjänst i Felsökning. Det kanske redan har begärts, så oroa dig inte om du inte ser det:
-
Efter den första begäran om att hämta besökar-ID:t lagras ID:t i en cookie vars namn börjar med
AMCV_
. Du kan bekräfta att cookien har angetts genom att göra följande:-
Öppna Utvecklarverktyg i webbläsaren
-
Gå till fliken
Application
-
Expandera
Cookies
till vänster -
Klicka på domänen
https://luma.enablementadobe.com
-
Leta efter AMCV_-cookien på höger sida. Du kan se flera saker eftersom du har läst in Luma-webbplatsen med både den hårdkodade taggegenskapen och den har mappats till din egen.
-
Så ja! Du har lagt till ditt första tillägg! Mer information om konfigurationsalternativen för identitetstjänsten finns i dokumentationen.
Skicka kund-ID:n
Därefter skickar du ett kund-ID till identitetstjänsten. På så sätt kan du integrera CRM med Experience Cloud och spåra besökare på olika enheter.
I den tidigare lektionen Lägg till dataelement, regler och bibliotek skapade du ett dataelement och använde det i en regel. Nu ska du använda samma tekniker för att skicka ett kund-ID när besökaren autentiseras.
Skapa dataelement för kund-ID:n
Börja med att skapa två dataelement:
Authentication State
- för att ta reda på om besökaren är inloggad eller inteEmail (Hashed)
- om du vill hämta den streckade versionen av e-postadressen (används som kund-ID) från datalagret
Skapa dataelementet för autentiseringsstatus
-
Klicka på Data Elements i den vänstra navigeringen
-
Klicka på knappen Add Data Element
-
Namnge dataelementet
Authentication State
-
För Data Element Type väljer du Custom Code
-
Klicka på knappen Open Editor
-
I fönstret Edit Code använder du följande kod för att returnera värden för "loggad in" eller "utloggad" baserat på ett attribut i Luma-platsens datalager:
code language-javascript if (digitalData.user[0].profile[0].attributes.loggedIn) return "logged in" else return "logged out"
-
Klicka på Save för att spara den anpassade koden
-
Låt alla andra inställningar behålla sina standardvärden
-
Klicka på Save to Library för att spara dataelementet och återgå till dataelementsidan. Vi behöver inte göra något"Build" förrän vi har gjort alla ändringar och är klara att validera.
Genom att känna till användarens autentiseringsstatus vet du när ett kund-ID ska finnas på sidan som ska skickas till identitetstjänsten. Nästa steg är att skapa ett dataelement för kundens ID. På Lumas demowebbplats använder du den hashade versionen av besökarens e-postadress.
Så här lägger du till dataelementet för det hash-kodade e-postmeddelandet
-
Klicka på knappen Add Data Element
-
Namnge dataelementet
Email (Hashed)
-
För Data Element Type väljer du JavaScript Variable
-
Använd följande pekare som JavaScript variable name för en variabel i Luma-platsens datalager:
digitalData.user.0.profile.0.attributes.username
-
Låt alla andra inställningar behålla sina standardvärden
-
Klicka på Save to Library för att spara dataelementet
Lägg till en regel för att skicka kund-ID:n
Adobe Experience Platform identitetstjänst skickar kund-ID:n i regler med en åtgärd som kallas"Ange kund-ID:n". Du kommer nu att skapa en regel som utlöser den här åtgärden när besökaren autentiseras.
Så här skapar du en regel som skickar kund-ID:n
-
Klicka på Rules i den vänstra navigeringen
-
Klicka på Add Rule för att öppna regelverktyget
-
Namnge regeln
All Pages - Library Loaded - Authenticated - 10
note tip TIP Den här namnkonventionen anger att du skjuter upp den här regeln högst upp på alla sidor när användaren autentiseras och den får ordningen "10". Om du använder en namngivningskonvention som den här, i stället för att namnge den för de lösningar som utlöses i åtgärderna, kan du minimera det totala antalet regler som krävs för implementeringen. -
Klicka Add under Events
- För Event Type väljer du Library Loaded (Page Top)
- Expandera avsnittet Advanced Options och för Order enter
10
. Ordningen styr den sekvens med regler som aktiveras av samma händelse. Regler med lägre ordning aktiveras före regler med högre ordning. I det här fallet vill du ange kund-ID:t innan du startar Target-begäran, som du gör i nästa lektion med en regel i ordningen50
. - Klicka på knappen Keep Changes för att återgå till regelbyggaren
-
Klicka Add under Conditions
-
För Condition Type väljer du Value Comparison
-
Klicka på ikonen för att öppna det modala dataelementet
-
Klicka på Authentication State i dataelementmodulen och klicka sedan på Select
-
-
Kontrollera att
Equals
är operatorn -
Skriv "loggad in" i textfältet, vilket gör att regeln utlöses när dataelementet "Autentiseringsstatus" har värdet "inloggad"
-
Klicka på Keep Changes
-
Klicka Add under Actions
-
För Extension väljer du Experience Cloud ID Service
-
För Action Type väljer du Set Customer IDs
-
Ange
crm_id
för Integration Code -
För Value anger du att du vill öppna väljaren för dataelement och välja
Email (Hashed)
-
För Auth State väljer du Authenticated
-
Klicka på knappen Keep Changes för att spara åtgärden och återgå till regelbyggaren
-
-
Klicka på knappen Save to Library and Build för att spara regeln
Du har nu skapat en regel som skickar kund-ID:t som en variabel crm_id
när besökaren autentiseras. Eftersom du har angett ordningen som 10
kommer den här regeln att starta före regeln All Pages - Library Loaded
som skapades i lektionen Lägg till dataelement, regler och bibliotek som använder standardordningsvärdet 50
.
Validera kund-ID:n
För att validera ditt arbete loggar du in på Luma-webbplatsen för att bekräfta beteendet för den nya regeln.
Logga in på Luma-webbplatsen
-
Öppna Luma-webbplatsen
-
Kontrollera att felsökaren mappar taggegenskapen till din-utvecklingsmiljö, vilket beskrivs i tidigare lektion
-
Klicka på länken LOGIN i det övre högra hörnet på Luma-webbplatsen
-
Ange
test@adobe.com
som användarnamn -
Ange
test
som lösenord -
Klicka på knappen LOGIN
-
Återgå till startsidan
Bekräfta att kund-ID:t skickas till tjänsten med felsökningstillägget.
Verifiera att identitetstjänsten skickar kund-ID:t
-
Kontrollera att fliken med Luma-webbplatsen är i fokus
-
Gå till fliken Adobe Experience Platform Identity Service i Felsökning
-
Expandera ditt Org ID
-
Klicka på cellen med värdet
Customer ID - crm_id
-
Observera kundens ID-värde och att tillståndet
AUTHENTICATED
återspeglas i modal-filen: -
Observera att du kan bekräfta det hash-kodade e-postvärdet genom att visa Luma-sidans källkod och titta på egenskapen username. Den ska matcha det värde du ser i Felsökning:
Ytterligare valideringstips
Taggar har också omfattande loggningsfunktioner för konsoler. Aktivera dem genom att gå till fliken Tools i Felsökning och aktivera växeln tags Console Logging.
Detta aktiverar konsolloggning både i webbläsarkonsolen och på fliken Loggar i felsökaren. Du bör se loggningen av alla regler du har skapat hittills! Observera att nya loggposter läggs till högst upp i listan. Därför bör regeln "Alla sidor - Bibliotek inläst - autentiserad - 10" utlösas före regeln "Alla sidor - Bibliotek inläst" och visas nedanför den i Felsökarens konsolloggning:
Nästa"Lägg till Adobe Target" >