Infoga strömmande data

I den här lektionen direktuppspelar du data med Adobe Experience Platform Web SDK.

Det finns två huvudsakliga uppgifter vi måste utföra i gränssnittet för datainsamling:

• Vi måste implementera Web SDK på Lumas webbplats för att skicka data om besöksaktivitet från webbplatsen till Adobe Edge-nätverket. Vi ska göra en enkel implementering med hjälp av taggar (tidigare Launch)

• Vi måste konfigurera en datastream, som meddelar Edge-nätverket var data ska vidarebefordras. Vi kommer att konfigurera den så att den skickar data till Luma Web Events datauppsättning i vår plattformssandlåda.

Datatekniker måste kunna importera strömmande data utanför den här självstudiekursen. När du implementerar Adobe Experience Platform SDK för webb eller mobiler är det oftast en webb- eller mobilutvecklare som arbetar med att skapa datalager och taggegenskapskonfigurationen.

Innan du börjar övningarna ska du titta på dessa två korta videoklipp för att lära dig mer om strömmande data och Web SDK:

Behörigheter krävs

I Konfigurera behörigheter lektionen anger du alla åtkomstkontroller som krävs för att slutföra lektionen.

Konfigurera datastream

Först konfigurerar vi datastream. En dataström talar om för Adobe Edge nätverk var data ska skickas när de har tagits emot från Web SDK-anropet. Vill du till exempel skicka data till Experience Platform, Adobe Analytics eller Adobe Target? Datastreams hanteras i användargränssnittet för datainsamling (tidigare Launch) och är viktiga för datainsamling med Web SDK.

Skapa datastream:

1. Logga in på Experience Platform datainsamlingsgränssnitt

2. Välj Datastreams i den vänstra navigeringen

3. Välj Ny datastream i det övre högra hörnet

   

4. För Eget namn, ange Luma Platform Tutorial (lägg till ditt namn i slutet om flera personer från ditt företag använder den här självstudiekursen)

5. Välj Spara knapp

   

På nästa skärm anger du var du vill skicka data. Så här skickar du data till Experience Platform:

1. Växla på Adobe Experience Platform för att visa ytterligare fält

2. För Sandbox, markera Luma Tutorial

3. För Händelsedatauppsättning, markera Luma Web Events Dataset

4. Om du använder andra Adobe-program kan du utforska de andra avsnitten och se vilken information som krävs i Edge Configuration för dessa andra lösningar. Kom ihåg att Web SDK utvecklades inte bara för att strömma data till Experience Platform, utan även för att ersätta alla tidigare JavaScript-bibliotek som används av andra Adobe-program. Edge Configuration används för att ange kontoinformationen för varje program som du vill skicka data till.

5. Välj Spara

   

När Edge Configuration har sparats visas tre miljöer för utveckling, mellanlagring och produktion. Ytterligare utvecklingsmiljöer kan läggas till:

Alla tre miljöerna innehåller den plattformsinformation du just angav. Dessa uppgifter kan dock konfigureras på olika sätt i olika miljöer. Du kan till exempel låta varje miljö skicka data till en annan plattformssandlåda. I den här självstudiekursen kommer vi inte att göra någon ytterligare anpassning av vår datastream.

Installera Web SDK-tillägget

Lägg till en egenskap

Först måste vi skapa en taggegenskap (tidigare en taggegenskap). En egenskap är en behållare för alla JavaScript-skript, regler och andra funktioner som krävs för att samla in information från en webbsida och skicka den till olika platser.

Så här skapar du en egenskap:

1. Gå till Egenskaper i den vänstra navigeringen

2. Välj Ny egenskap knapp
   

3. Som Namn, ange Luma Platform Tutorial (lägg till ditt namn i slutet om flera personer från ditt företag använder den här självstudiekursen)

4. Som Domäner, ange enablementadobe.com (förklaras senare)

5. Välj Spara

   

Lägg till Web SDK-tillägget

Nu när du har en egenskap kan du lägga till Web SDK med ett tillägg. Ett tillägg är ett kodpaket som utökar gränssnittet och funktionerna i datainsamlingen. Så här lägger du till tillägget:

1. Öppna taggegenskapen
2. Gå till Tillägg i den vänstra navigeringen
3. Gå till Katalog tab
4. Det finns många tillägg för taggar. Filtrera katalogen med termen Web SDK
5. I Adobe Experience Platform Web SDK väljer du Installera knapp
   
6. Det finns flera konfigurationer tillgängliga för Web SDK-tillägget, men det finns bara två som vi kommer att konfigurera för den här självstudiekursen. Uppdatera Edge Domain till data.enablementadobe.com. Med den här inställningen kan du ange cookies från första part med Web SDK-implementeringen, vilket rekommenderas. Senare i den här lektionen kommer du att kartlägga en webbplats på enablementadobe.com till din taggegenskap. CNAME för enablementadobe.com domänen har redan konfigurerats så att data.enablementadobe.com kommer att vidarebefordra till Adobe-servrar. När du implementerar Web SDK på din egen webbplats måste du skapa en CNAME för dina egna datainsamlingssyften, till exempel data.YOUR_DOMAIN.com
7. Från Datastream listruta, välj Luma Platform Tutorial datastream.
8. Du kan gärna titta på andra konfigurationsalternativ (men ändra dem inte!) och sedan markera Spara

Skapa en regel för att skicka data

Nu ska vi skapa en regel för att skicka data till plattformen. En regel är en kombination av händelser, villkor och åtgärder som talar om för taggarna att göra något. Så här skapar du en regel:

1. Gå till Regler i den vänstra navigeringen
2. Välj Skapa ny regel knapp
   
3. Namnge regeln All Pages - Library Loaded
4. Under Händelser väljer du Lägg till knapp
   
5. Använd Core Tillägg och markera Bibliotek inläst (sidan ovanpå) som Händelsetyp. Den här inställningen innebär att vår regel aktiveras när startbiblioteket läses in på en sida.
6. Välj Behåll ändringar för att återgå till huvudlinjeraster
   
7. Lämna Villkor tom, eftersom vi vill att den här regeln ska köras på alla sidor, enligt det namn vi gav den
8. Under Åtgärder väljer du Lägg till knapp
9. Använd Adobe Experience Platform Web SDK Tillägg och markera Skicka händelse som Åtgärdstyp
10. Till höger väljer du web.webpagedetails.pageViews från Typ listruta. Detta är ett av XDM-fälten i Luma Web Events Schema
11. Välj Behåll ändringar för att återgå till huvudlinjeraster
    
12. Välj Spara för att spara regeln
    

Publicera regeln i ett bibliotek

Därefter ska vi publicera regeln i vår utvecklingsmiljö så att vi kan verifiera att den fungerar.

Så här skapar du ett bibliotek:

1. Gå till Publiceringsflöde i den vänstra navigeringen
2. Välj Lägg till bibliotek
   
3. För Namn, ange Luma Platform Tutorial
4. För Miljö, markera Development
5. Välj Lägg till alla ändrade resurser -knappen. (Förutom Adobe Experience Platform Web SDK och All Pages - Library Loaded -regeln visas också Core tillägget har lagts till som innehåller det grundläggande JavaScript som krävs för alla Launch-webbegenskaper.)
6. Välj Spara och bygg för utveckling knapp
   

Det kan ta några minuter att skapa biblioteket och när det är klart visas en grön punkt till vänster om biblioteksnamnet:

Som du kan se på Publiceringsflöde på skärmen finns det mycket mer i publiceringsprocessen som ligger utanför kursen. Vi kommer bara att använda ett enda bibliotek i vår utvecklingsmiljö.

Validera data i begäran

Lägg till Adobe Experience Platform Debugger

Felsökaren Experience Platform är ett tillägg för webbläsarna Chrome och Firefox som gör att du kan se Adobe-tekniken som används på dina webbsidor. Ladda ned den version du föredrar:

• Firefox-tillägg
• Kromtillägg

Om du aldrig har använt Felsökning tidigare - och den här är en annan än den tidigare Adobe Experience Cloud Debugger - kan du titta på den här översiktsvideon med fem minuter:

Öppna Lumas webbplats

I den här självstudiekursen använder vi en öppen version av demonstrationswebbplatsen för Luma. Vi öppnar den och bokmärker den:

1. Öppna Lumas webbplats.
2. Bokmärk sidan så att den kan användas i resten av självstudiekursen

Den här värdbaserade webbplatsen är anledningen till att vi använde enablementadobe.com i Domäner fält för den ursprungliga taggegenskapskonfigurationen och varför vi använde data.enablementadobe.com som vår förstahandsdomän i Adobe Experience Platform Web SDK tillägg. Jag hade en plan!

Använd Experience Platform Debugger för att mappa till taggegenskapen

Felsökaren i Experience Platform har en cool funktion som gör att du kan ersätta en befintlig taggegenskap med en annan. Detta är användbart för validering och gör att vi kan hoppa över många implementeringssteg i den här självstudiekursen.

1. Kontrollera att Luma-webbplatsen är öppen och välj ikonen för Experience Platform-felsökningstillägget

2. Felsökaren öppnar och visar information om den hårdkodade implementeringen, som inte har med den här självstudiekursen att göra (du kan behöva läsa in Luma-webbplatsen igen när du har öppnat Felsökning)

3. Bekräfta att felsökaren är Ansluten till Luma" enligt bilden nedan och välj sedan "lock" om du vill låsa felsökaren till Luma-webbplatsen.

4. Välj Logga in till höger om du vill autentisera.

5. Gå till Starta i den vänstra navigeringen

6. Välj fliken Konfiguration

7. Till höger om där den visar dig Sidinbäddningskoder​öppnar du Åtgärder och markera Ersätt

   

8. Eftersom du är autentiserad kommer felsökaren att hämta in de tillgängliga egenskaperna och miljöerna för Launch. Välj Luma Platform Tutorial property

9. Välj Development miljö

10. Välj Använd knapp
    

11. Lumas webbplats kommer nu att läsas in igen med taggegenskapen. Hjälp, jag har blivit hackad! Skämtar bara.
    

12. Gå till Sammanfattning i den vänstra navigeringen för att se information om Starta property
    

13. Gå till AEP Web SDK i den vänstra navigeringen för att se Nätverksförfrågningar

14. Öppna händelser rad

    

15. Se hur vi kan se web.webpagedetails.pageView händelsetyp som anges i Skicka händelse och andra färdiga variabler som följer AEP Web SDK ExperienceEvent Mixin format
    

16. Den här typen av förfrågningsinformation visas också i webbläsarens webbutvecklingsverktyg Nätverk -fliken. Öppna den och läs in sidan igen. Filter för samtal med interact för att hitta samtalet markerar du det och tittar sedan på Sidhuvuden tab, Begär nyttolast område.
    

17. Gå till Svar och notera hur ECID-värdet ingår i svaret. Kopiera det här värdet så som du kommer att använda det för att validera profilinformationen i nästa övning.
    

Validera data i Experience Platform

Du kan validera att data landar i Platform genom att titta på de batchar med data som kommer in i Luma Web Events Dataset. (Jag vet, det kallas dataöverföring men nu säger jag att det kommer i grupper! Den direktuppspelas i realtid till en profil, så att den kan användas för segmentering och aktivering i realtid, men skickas gruppvis var 15:e minut till datasjön.)

Så här validerar du data:

1. Gå till Datauppsättningar i den vänstra navigeringen
2. Öppna Luma Web Events Dataset och bekräfta att en batch har kommit fram. Kom ihåg att de skickas var 15:e minut, så du kanske måste vänta på att gruppen ska visas.
3. Välj Förhandsgranska datauppsättning knapp
   
4. Observera hur du kan markera olika fält i schemat till vänster i förhandsgranskningen för att förhandsgranska dessa specifika datapunkter:
   

Du kan också bekräfta att den nya profilen visas:

1. Gå till Profiler i den vänstra navigeringen
2. Välj ECID och söka efter ditt ECID-värde (kopiera det från svaret). Profilen kommer att ha ett eget id, som är skilt från ECID.
3. Välj Profil-ID för att öppna profilen
   
4. Välj Händelser för att se de sidor du visade
   

Lägg till anpassade data till händelsen

Skapa ett dataelement för sidnamn

1. I tagggränssnittet för datainsamling, i det övre högra hörnet av ditt Luma Platform Tutorial -egenskap, öppna Välj ett arbetsbibliotek listruta och välj Luma Platform Tutorial bibliotek. Den här inställningen gör det enklare att publicera ytterligare uppdateringar till vårt bibliotek.

2. Gå till Dataelement i den vänstra navigeringen

3. Välj Skapa nytt dataelement knapp

   

4. Som Namn, ange Page Name

5. Som Dataelementtyp, markera JavaScript Variable

6. Som JavaScript-variabelnamn, ange digitalData.page.pageInfo.pageName

7. Om du vill standardisera värdeformatet markerar du kryssrutorna för Använd gemener och Rensa text

8. Se till att Luma Platform Tutorial är markerat som arbetsbibliotek

9. Välj Spara i bibliotek
   

Mappa sidnamnet till XDM-objektets dataelement

Nu ska vi mappa vårt sidnamn till Web SDK.

På Dataelement sida:

1. Skapa ett nytt dataelement

2. Som Namn, ange XDM Object

3. Som Tillägg, markera Adobe Experience Platform Web SDK

4. Som Dataelementtyp, markera XDM object

5. Som Sandbox väljer du Luma Tutorial sandlåda

6. Som Schema väljer du Luma Web Events Schema

7. Välj web.webPageDetails.name fält

8. Som Värde, markerar du ikonen för att öppna ett modalt val av dataelement och väljer Page Name dataelement

9. Välj Spara i bibliotek

   

Samma process används för att mappa ytterligare anpassade data på webbplatsen till XDM-fält.

Lägg till XDM-data till åtgärden Skicka händelse

Nu när du har data mappade till XDM-fält kan du inkludera dem i åtgärden Skicka händelse:

1. Gå till Regler screen
2. Öppna All Pages - Library Loaded regel
3. Öppna Adobe Experience Platform Web SDK - Send Event åtgärd
4. Som XDM-data, markerar du ikonen för att öppna ett modalt val av dataelement och väljer XDM Object dataelement
5. Välj Behåll ändringar knapp
   
6. Nu när du har Luma Platform Tutorial har valts som ditt arbetsbibliotek för de senaste övningarna och dina senaste ändringar har sparats direkt i biblioteket. Istället för att behöva publicera ändringarna via skärmen Publiceringsflöde kan du bara öppna listrutan med den blå knappen och välja Spara i bibliotek och bygge
   

Detta börjar bygga upp ett nytt taggbibliotek med de tre ändringar du just gjorde.

Validera XDM-data

Nu bör du kunna läsa in Lumas hemsida igen, när den mappas till taggegenskapen med hjälp av felsökaren som du lärde dig tidigare, och se att sidnamnsfältet fylls i i i begäran!

Du kan också validera de sidnamnsdata som togs emot i Platform genom att förhandsgranska datauppsättningen och profilen.

Skicka ytterligare identiteter

Din Web SDK-implementering skickar nu händelser med Experience Cloud ID (ECID) som primär identifierare. ECID genereras automatiskt av Web SDK och är unikt per enhet och webbläsare. En enskild kund kan ha flera ECID:n beroende på vilken enhet och webbläsare de använder. Så hur får vi en enhetlig bild av den här kunden och kan länka deras onlineaktivitet till våra CRM-, Loyalty- och Offline Purchase-data? Det gör vi genom att samla in ytterligare identiteter under deras session och på ett avgörande sätt länka deras profil via identitetssammanfogning.

Om du kommer ihåg det, nämnde jag att vi skulle använda ECID och CRM ID som identiteter för våra webbdata i Mappa identiteter lektion. Låt oss samla in CRM-ID:t med Web SDK!

Lägg till dataelement för CRM-ID

Först lagrar vi CRM-ID i ett dataelement:

1. Lägg till ett dataelement med namnet i tagggränssnittet CRM Id
2. Som Dataelementtyp, markera JavaScript-variabel
3. Som JavaScript-variabelnamn, ange digitalData.user.0.profile.0.attributes.username
4. Välj Spara i bibliotek knapp (Luma Platform Tutorial bör fortfarande vara ditt arbetsbibliotek)
   

Lägg till CRM-ID i dataelementet för identitetskartan

Nu när vi har hämtat CRM-ID-värdet måste vi associera det med en särskild dataelementtyp som kallas för Identitetskarta dataelement:

1. Lägg till ett dataelement med namnet Identities

2. Som Tillägg, markera Adobe Experience Platform Web SDK

3. Som Dataelementtyp, markera Identitetskarta

4. Som Namnutrymme, ange Luma CRM Id, vilket är namespace som vi skapat tidigare

   VARNING

   Med Adobe Experience Platform Web SDK-tillägget version 2.2 kan du välja namnutrymme från en ifylld listruta med de faktiska värdena i ditt plattformskonto. Tyvärr är den här funktionen ännu inte"sandlådemedveten", vilket innebär att Luma CRM Id i listrutan. Detta kan hindra dig från att slutföra den här övningen. Vi skickar en lösning när vi har bekräftat.

5. Som ID, markerar du ikonen för att öppna ett modalt val av dataelement och väljer CRM Id dataelement

6. Som Autentiserat läge, markera Autentiserad

7. Lämna Primär avmarkerad. Eftersom CRM-ID inte finns för de flesta besökare på Luma-webbplatsen är det definitivt du vill inte åsidosätta ECID som primär identifierare. Det skulle vara sällsynt att använda något annat än ECID som primär identifierare. Vanligtvis anger jag inte standardinställningarna i dessa instruktioner, men jag ringer upp den här för att hjälpa dig att undvika problem senare i din egen implementering.

8. Välj Spara i bibliotek knapp (Luma Platform Tutorial bör fortfarande vara ditt arbetsbibliotek)
   

Lägg till datamappningsdataelementet för identitet i XDM-objektet

Det finns ytterligare ett dataelement som måste uppdateras - XDM-objektets dataelement. Det kan verka konstigt att behöva uppdatera tre separata dataelement för att skicka den här identiteten, men den här processen är utformad för att skalas för flera identiteter. Oroa dig inte, vi är nästan klara med den här lektionen!

1. Öppna XDM-objektdataelementet
2. Öppna fältet IdentityMap XDM
3. Som Dataelement, markerar du ikonen för att öppna ett modalt val av dataelement och väljer Identities dataelement
4. Nu när du har Luma Platform Tutorial har valts som ditt arbetsbibliotek för de senaste övningarna och dina senaste ändringar har sparats direkt i biblioteket. Istället för att behöva publicera ändringarna via skärmen Publiceringsflöde kan du öppna listrutan med den blå knappen och välja Spara i bibliotek och bygge
   

Validera identiteten

Så här verifierar du att CRM-ID:t nu skickas av Web SDK:

1. Öppna Lumas webbplats
2. Mappa den till taggegenskapen med Felsökning, enligt tidigare instruktioner
3. Välj Inloggning länk längst upp till höger på Lumas webbplats
4. Logga in med inloggningsuppgifterna test@adobe.com/test
5. Kontrollera Experience Platform Web SDK-anropet i Felsökning (Adobe Experience Platform Web SDK > Nätverksförfrågningar > händelser av den senaste begäran) och du bör se lumaCrmId:
   
6. Slå upp användarprofilen med ECID-namnutrymmet och ange ett nytt värde. I profilen visas CRM-ID:t och även lojalitets-ID:t samt profilinformation som namn och telefonnummer. Alla identiteter och data har sammanfogats till en enda kundprofil i realtid!
   

Ytterligare resurser

• Implementera Adobe Experience Cloud med Web SDK
• Direktuppspelningsdokumentation
• API-referens för direktuppspelning

Bra jobbat! Det var mycket information om Web SDK och Launch. Det är mycket mer involverat i en fullfjädrad implementering, men det är grunderna som hjälper dig att komma igång och se resultaten i Platform.

Datatekniker, om du vill kan du hoppa fram till lektion för att köra frågor.

Dataarkitekter kan du gå vidare till sammanfogningsprinciper!

Resurser för Business.Adobe.com