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

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ö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

  1. Klicka på Tillägg

  2. Klicka Katalog 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å Installera

    Installera tillägget för identitetstjänsten

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

  7. Lämna alla standardinställningar och klicka på Spara i bibliotek och bygge

    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 validerar du identitetstjänsttillägget

  1. Öppna Luma site

  2. Kontrollera att felsökaren mappar taggegenskapen till din Utvecklingsmiljö, enligt beskrivningen i tidigare lektion.

  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 Org 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 Application tab

    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_-cookien

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:

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

  1. Klicka Dataelement i den vänstra navigeringen

  2. Klicka på Lägg till dataelement knapp

    Klicka på Lägg till dataelement

  3. Namnge dataelementet Authentication State

  4. För Dataelementtyp, markera Egen kod

  5. Klicka på Öppna redigeraren knapp

    Öppna redigeraren för att lägga till anpassad kod för dataelementet

  6. 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"
    
  7. Klicka Spara 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 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.

    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.

Lägga till dataelementet för det hash-kodade e-postmeddelandet

  1. Klicka på Lägg till dataelement knapp

    Lägga till ett dataelement

  2. Namnge dataelementet Email (Hashed)

  3. För Dataelementtyp, markera JavaScript-variabel

  4. Som JavaScript-variabelnamn använder du följande pekare 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 Spara i bibliotek 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å Regler

  2. Klicka Lägg till regel 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. Under Händelser klicka Lägg till

    Lägg till en händelse

    1. För Händelsetyp välj Bibliotek inläst (sidan ovanpå)
    2. 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 ordningen 50 .
    3. Klicka på Behåll ändringar för att återgå till regelbyggaren

    Spara händelsen

  5. Under Villkor klicka Lägg till

    Lägg till ett villkor i regeln

    1. För Villkorstyp välj Värdejämförelse

    2. Klicka på dataelementikon -ikon för att öppna det modala dataelementet

      öppna dataelementet modal

    3. Klicka på Autentiseringstillstånd och sedan klicka Välj

      ange autentiseringsstatus

  6. Se till 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 Behåll ändringar

    Spara villkoret

  9. Under Åtgärder klicka Lägg till

    Lägg till en ny åtgärd

    1. För Tillägg välj Experience Cloud ID-tjänst

    2. För Åtgärdstyp välj Ange kund-ID

    3. För Integrationskod enter crm_id

    4. För Värde ange att väljaren för dataelement ska vara modal och markera Email (Hashed)

    5. För Autentiseringsläge välj Autentiserad

    6. Klicka på Behåll ändringar för att spara åtgärden och återgå till regelbyggaren

      Konfigurera åtgärden och spara ändringarna

  10. Klicka på Spara i bibliotek och bygge för att spara regeln

    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

  1. Öppna Luma site

  2. Kontrollera att felsökaren mappar taggegenskapen till din Utvecklingsmiljö, enligt beskrivningen i tidigare lektion

    Taggens utvecklingsmiljö visas i Felsökning

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

    Klicka på Logga in i den övre navigeringen

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

  5. Retur test som lösenord

  6. Klicka på INLOGGNING knapp

    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 Customer ID - crm_id value

  5. Observera kundens ID-värde i modalkoden och att AUTHENTICATED visas:

    Bekräfta användar-ID 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:

    hashade e-post i källkoden

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.

Växla vid 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