Lägg till Adobe Experience Platform identitetstjänst
I den här lektionen får du hjälp att implementera Adobe Experience Platform Identity Service-tillägg och skicka kundens ID:n.
The Adobe Experience Platform Identity Service anger ett gemensamt besökar-ID för alla Adobe-lösningar för att stärka Experience Cloud:s möjligheter, 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
- platform launch Server Side is now 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örutsättningar
Du borde ha slutfört lektionerna i Konfigurera taggar -avsnitt.
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å Tillägg
-
Klicka Katalog 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å Installera
-
Observera att ditt organisations-ID för Experience Cloud har identifierats automatiskt.
-
Lämna alla standardinställningar och klicka på Spara i bibliotek och bygge
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 validerar du identitetstjänsttillägget
-
Öppna Luma site
-
Kontrollera att felsökaren mappar taggegenskapen till din Utvecklingsmiljö, enligt beskrivningen i tidigare lektion.
-
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
Application
tab -
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
Sedan skickar du en Kund-ID till identitetstjänsten. Då 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 du skapade 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)
—för att hämta den hashade versionen av e-postadressen (används som kund-ID) från datalagret
Skapa dataelementet för autentiseringsläge
-
Klicka Dataelement i den vänstra navigeringen
-
Klicka på Lägg till dataelement knapp
-
Namnge dataelementet
Authentication State
-
För Dataelementtyp, markera Egen kod
-
Klicka på Öppna redigeraren knapp
-
I Redigera kod 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 Spara för att spara den anpassade koden
-
Låt alla andra inställningar behålla sina standardvärden
-
Klicka Spara i bibliotek 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.
Lägga till dataelementet för det hash-kodade e-postmeddelandet
-
Klicka på Lägg till dataelement knapp
-
Namnge dataelementet
Email (Hashed)
-
För Dataelementtyp, markera JavaScript-variabel
-
Som JavaScript-variabelnamn använder du följande pekare 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 Spara i bibliotek 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å Regler
-
Klicka Lägg till regel 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. -
Under Händelser klicka Lägg till
- För Händelsetyp välj Bibliotek inläst (sidan ovanpå)
- Expandera Avancerade alternativ -avsnittet 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å Behåll ändringar för att återgå till regelbyggaren
-
Under Villkor klicka Lägg till
-
För Villkorstyp välj Värdejämförelse
-
Klicka på -ikon för att öppna det modala dataelementet
-
Klicka på Autentiseringstillstånd och sedan klicka Välj
-
-
Se till 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 Behåll ändringar
-
Under Åtgärder klicka Lägg till
-
För Tillägg välj Experience Cloud ID-tjänst
-
För Åtgärdstyp välj Ange kund-ID
-
För Integrationskod enter
crm_id
-
För Värde ange att väljaren för dataelement ska vara modal och markera
Email (Hashed)
-
För Autentiseringsläge välj Autentiserad
-
Klicka på Behåll ändringar för att spara åtgärden och återgå till regelbyggaren
-
-
Klicka på Spara i bibliotek och bygge för att spara regeln
Du har nu skapat en regel som skickar kundens ID som en variabel crm_id
när besökaren är autentiserad. Sedan du angett beställningen som 10
den här regeln startar innan All Pages - Library Loaded
regel som skapas i Lägg till dataelement, regler och bibliotek lektion som använder standardvärdet för Ordning för 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 site
-
Kontrollera att felsökaren mappar taggegenskapen till din Utvecklingsmiljö, enligt beskrivningen i tidigare lektion
-
Klicka på INLOGGNING länk i det övre högra hörnet på Luma-webbplatsen
-
Retur
test@adobe.com
som användarnamn -
Retur
test
som lösenord -
Klicka på INLOGGNING knapp
-
Å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
Customer ID - crm_id
value -
Observera kundens ID-värde i modalkoden och att
AUTHENTICATED
visas: -
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. Om du vill aktivera dem går du till verktyg i Felsökning och aktivera taggkonsolloggning växla.
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" >