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).

NOTE
Adobe Experience Platform Launch håller på att integreras i Adobe Experience Platform som en serie datainsamlingstekniker. Flera terminologiska förändringar har introducerats i gränssnittet som du bör vara medveten om när du använder det här innehållet:

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

  1. Klicka på Extensions i den vänstra navigeringen

  2. Klicka på Catalog för att gå till sidan för tilläggskatalogen

  3. Observera de olika tillägg som är tillgängliga i katalogen

  4. I filtret längst upp skriver du"id" för att filtrera katalogen

  5. På kortet för Adobe Experience Platform identitetstjänst klickar du på Install

    Installera identitetstjänsttillägget

  6. Observera att ditt organisations-ID för Experience Cloud har identifierats automatiskt.

  7. Lämna alla standardinställningar och klicka på Save to Library and Build

    Spara tillägget

NOTE
Varje version av identitetstjänsttillägget innehåller en specifik version av VisitorAPI.js som beskrivs i tilläggsbeskrivningen. Du uppdaterar versionen av VisitorAPI.js genom att uppdatera identitetstjänsttillägget.

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

  1. Öppna Luma-webbplatsen

  2. Kontrollera att felsökaren mappar taggegenskapen till din-utvecklingsmiljö, enligt beskrivningen i tidigare lektionen.

  3. På fliken Sammanfattning i felsökaren bör taggavsnittet ange att tillägget för Adobe Experience Platform Identity Service är implementerat.

  4. På fliken Sammanfattning ska identitetstjänstens avsnitt även innehålla samma Org ID som fanns på din tilläggskonfigurationsskärm i datainsamlingsgränssnittet:

    Kontrollera att Adobe Experience Platform Identity Service-tillägget har implementerats

  5. 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:
    Kontrollera om det finns en begäran till identitetstjänsten med ditt organisations-ID

  6. 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:

    1. Öppna Utvecklarverktyg i webbläsaren

    2. Gå till fliken Application

    3. Expandera Cookies till vänster

    4. Klicka på domänen https://luma.enablementadobe.com

    5. 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.

      Verifiera AMCV_cookie

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:

  1. Authentication State - för att ta reda på om besökaren är inloggad eller inte
  2. Email (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

  1. Klicka på Data Elements i den vänstra navigeringen

  2. Klicka på knappen Add Data Element

    Klicka på Lägg till dataelement

  3. Namnge dataelementet Authentication State

  4. För Data Element Type väljer du Custom Code

  5. Klicka på knappen Open Editor

    Öppna redigeraren och lägg till anpassad kod för dataelementet

  6. 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"
    
  7. Klicka på Save för att spara den anpassade koden

    Spara den anpassade koden

  8. Låt alla andra inställningar behålla sina standardvärden

  9. 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.

    Spara dataelementet

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

  1. Klicka på knappen Add Data Element

    Lägg till ett dataelement

  2. Namnge dataelementet Email (Hashed)

  3. För Data Element Type väljer du JavaScript Variable

  4. Använd följande pekare som JavaScript variable name för en variabel i Luma-platsens datalager: digitalData.user.0.profile.0.attributes.username

  5. Låt alla andra inställningar behålla sina standardvärden

  6. Klicka på Save to Library för att spara dataelementet

    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

  1. Klicka på Rules i den vänstra navigeringen

  2. Klicka på Add Rule för att öppna regelverktyget

    Lägg till en regel

  3. 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.
  4. Klicka Add under Events

    Lägg till en händelse

    1. För Event Type väljer du Library Loaded (Page Top)
    2. 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 ordningen 50.
    3. Klicka på knappen Keep Changes för att återgå till regelbyggaren

    Spara händelsen

  5. Klicka Add under Conditions

    Lägg till ett villkor i regeln

    1. För Condition Type väljer du Value Comparison

    2. Klicka på ikonen för dataelement för att öppna det modala dataelementet

      öppna dataelementet modal

    3. Klicka på Authentication State i dataelementmodulen och klicka sedan på Select

      ange autentiseringsstatus

  6. Kontrollera att Equals är operatorn

  7. Skriv "loggad in" i textfältet, vilket gör att regeln utlöses när dataelementet "Autentiseringsstatus" har värdet "inloggad"

  8. Klicka på Keep Changes

    Spara villkoret

  9. Klicka Add under Actions

    Lägg till en ny åtgärd

    1. För Extension väljer du Experience Cloud ID Service

    2. För Action Type väljer du Set Customer IDs

    3. Ange crm_id för Integration Code

    4. För Value anger du att du vill öppna väljaren för dataelement och välja Email (Hashed)

    5. För Auth State väljer du Authenticated

    6. Klicka på knappen Keep Changes för att spara åtgärden och återgå till regelbyggaren

      Konfigurera åtgärden och spara ändringarna

  10. Klicka på knappen Save to Library and Build för att spara regeln

    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

  1. Öppna Luma-webbplatsen

  2. Kontrollera att felsökaren mappar taggegenskapen till din-utvecklingsmiljö, vilket beskrivs i tidigare lektion

    Din taggutvecklingsmiljö visas i Felsökning

  3. Klicka på länken LOGIN i det övre högra hörnet på Luma-webbplatsen

    Klicka på Logga in i den översta navigeringen

  4. Ange test@adobe.com som användarnamn

  5. Ange test som lösenord

  6. Klicka på knappen LOGIN

    Ange autentiseringsuppgifter och klicka på Logga in

  7. Å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

  1. Kontrollera att fliken med Luma-webbplatsen är i fokus

  2. Gå till fliken Adobe Experience Platform Identity Service i Felsökning

  3. Expandera ditt Org ID

  4. Klicka på cellen med värdet Customer ID - crm_id

  5. Observera kundens ID-värde och att tillståndet AUTHENTICATED återspeglas i modal-filen:

    Bekräfta kund-ID:t i felsökaren

  6. 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:

    hashas email in the source code

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.

Växla mellan taggkonsolloggning

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:

Fliken Loggar i Felsökning

Nästa"Lägg till Adobe Target" >

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