DokumentationExperience PlatformInfoga strömmande data

Infoga strömmande data

Last update: Tue Jul 16 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

Skapat för:

  • Nybörjare
  • Mellanliggande
  • Utvecklare

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ätverk var data ska vidarebefordras. Vi kommer att konfigurera den så att den skickar data till vår Luma Web Events-datauppsättning i vår plattformssandlåda.

Datatekniker måste importera strömmande data utanför den här självstudien. 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:

https://video.tv.adobe.com/v/28425?learn=on

https://video.tv.adobe.com/v/34141?learn=on

NOTE
Den här självstudien fokuserar på direktuppspelad inmatning från webbplatser med Web SDK, men du kan även direktuppspela data med Adobe Mobile SDK, Apache Kafka Connect och andra mekanismer.

Behörigheter krävs

I lektionen Konfigurera behörigheter ställer du in 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.

Så här skapar du din datastream:

  1. Logga in i användargränssnittet för Experience Platform datainsamling

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

  3. Markera knappen New Datastream i det övre högra hörnet

    Välj datastreams i den vänstra navigeringen

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

  5. Markera knappen Save

    Namnge datastrammet och spara

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 om du vill visa ytterligare fält
  2. För Sandbox väljer du Luma Tutorial
  3. För Event Dataset väljer du 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 program från Adobe. Edge Configuration används för att ange kontoinformationen för varje program som du vill skicka data till.
  5. Välj Save
    Konfigurera dataströmmen och spara

När Edge Configuration har sparats visas tre miljöer för utveckling, mellanlagring och produktion. Ytterligare utvecklingsmiljöer kan läggas till:
Varje Edge-konfiguration kan ha flera miljöer
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, regler och andra funktioner som krävs för att samla in information från en webbsida och skicka den till olika platser.

Skapa en egenskap:

  1. Gå till Properties i den vänstra navigeringen
  2. Markera knappen New Property
    Lägg till en ny egenskap
  3. Som Name anger du 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. Ange enablementadobe.com som Domains (förklaras senare)
  5. Välj Save
    Egenskapsinformation

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 Extensions i den vänstra navigeringen
  3. Gå till fliken Catalog
  4. Det finns många tillägg för taggar. Filtrera katalogen med termen Web SDK
  5. Välj knappen Install i tillägget Adobe Experience Platform Web SDK
    Installera Adobe Experience Platform Web SDK-tillägget
  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älvstudien. 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 mappar du en webbplats på domänen enablementadobe.com till din taggegenskap. CNAME för domänen enablementadobe.com har redan konfigurerats så att data.enablementadobe.com kan 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. I listrutan Datastream väljer du Luma Platform Tutorial-datastream.
  8. Du kan gärna titta på andra konfigurationsalternativ (men ändra dem inte!) och välj sedan Save

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 Rules i den vänstra navigeringen
  2. Markera knappen Create New Rule
    Skapa en regel
  3. Namnge regeln All Pages - Library Loaded
  4. Under Events väljer du knappen Add
    Namnge regeln och lägg till en händelse
  5. Använd Core Extension och välj Library Loaded (Page Top) som Event Type. Den här inställningen innebär att vår regel aktiveras när startbiblioteket läses in på en sida.
  6. Välj Keep Changes för att återgå till huvudregelskärmen
    Lägg till händelsen Biblioteksinläsning
  7. Lämna Conditions tomt eftersom vi vill att den här regeln ska utlösas på alla sidor, enligt det namn vi gav den
  8. Under Actions väljer du knappen Add
  9. Använd Adobe Experience Platform Web SDK Extension och välj Send Event som Action Type
  10. Till höger väljer du web.webpagedetails.pageViews i listrutan Type. Detta är ett av XDM-fälten i Luma Web Events Schema
  11. Välj Keep Changes för att återgå till huvudregelskärmen
    Lägg till åtgärden Skicka händelse
  12. Välj Save om du vill spara regeln
    Spara regeln

Publish 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 Publishing Flow i den vänstra navigeringen
  2. Välj Add Library
    Välj Lägg till bibliotek
  3. Ange Luma Platform Tutorial för Name
  4. För Environment väljer du Development
  5. Välj knappen Add All Changed Resources. (Förutom tillägget Adobe Experience Platform Web SDK och regeln All Pages - Library Loaded visas även tillägget Core som innehåller den bas-JavaScript som krävs för alla webbegenskaper för Launch.)
  6. Markera knappen Save & Build for Development
    Skapa och skapa biblioteket

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:
Skapandet är klart

Som du ser på skärmen Publishing Flow finns det mycket mer i publiceringsprocessen som ligger utanför den här självstudiekursen. 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 Chrome- och Firefox-webbläsare som gör det enklare att se hur Adobe-tekniken används på dina webbsidor. Ladda ned den version du föredrar:

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:

https://video.tv.adobe.com/v/32156?learn=on

Ö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 Luma-webbplatsen på en ny flik i webbläsaren.
  2. Bokmärk sidan så att den kan användas i resten av kursen

Den här värdbaserade webbplatsen är anledningen till att vi använde enablementadobe.com i fältet Domains i vår ursprungliga taggegenskapskonfiguration och varför vi använde data.enablementadobe.com som vår förstapartsdomän i tillägget Adobe Experience Platform Web SDK. Jag hade en plan!

Luma-startsida

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 Connected to Luma enligt bilden nedan och välj sedan ikonen lock för att låsa felsökaren till Luma-webbplatsen.

  4. Välj knappen Sign In längst upp till höger för att autentisera.

  5. Gå nu till Launch i den vänstra navigeringen

  6. Välj fliken Konfiguration

  7. Öppna listrutan Actions till höger om den plats där Page Embed Codes visas och välj Replace
    Välj Åtgärder > 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 din Luma Platform Tutorial-egenskap

  9. Välj din Development-miljö

  10. Markera knappen Apply
    Välj den alternativa taggegenskapen

  11. Luma-webbplatsen kommer nu att läsa in igen med din taggegenskap. Hjälp, jag har blivit hackad! Skämtar bara.
    taggegenskap ersatt

  12. Gå till Summary i den vänstra navigeringen för att se information om din Launch-egenskap
    Fliken Sammanfattning

  13. Gå nu till AEP Web SDK i den vänstra navigeringen för att se Network Requests

  14. Öppna raden events

    Adobe Experience Platform Web SDK-begäran

  15. Observera hur vi kan se händelsetypen web.webpagedetails.pageView som vi angav i vår Send Event -åtgärd och andra variabler som är klara att användas enligt formatet AEP Web SDK ExperienceEvent Mixin
    Händelseinformation

  16. Den här typen av begärandeinformation visas också på fliken Nätverk i webbläsaren. Öppna den och läs in sidan igen. Filtrera efter samtal med interact för att hitta samtalet, markera det och titta sedan på fliken Huvuden i området Begär nyttolast.
    Fliken Nätverk

  17. Gå till fliken Svar och notera hur ECID-värdet inkluderas 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.
    Fliken Nätverk

Validera data i Experience Platform

Du kan validera att data landar i Platform genom att titta på de datagrupper 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 Profile, så 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 Datasets i den vänstra navigeringen i användargränssnittet för plattformen
  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. Markera knappen Preview dataset
    Öppna datauppsättningen
  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:
    Förhandsgranska fälten

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

  1. Gå till Profiles i den vänstra navigeringen i användargränssnittet för plattformen
  2. Markera namnområdet ECID och sök 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 Profile ID för att öppna profilen
    Hitta och öppna profilen
  4. Välj fliken Events för att visa de sidor du visade
    Profilhändelser \

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 egenskapen Luma Platform Tutorial, öppnar du listrutan Select a Working Library och väljer ditt Luma Platform Tutorial-bibliotek. Den här inställningen gör det enklare att publicera ytterligare uppdateringar till vårt bibliotek.

  2. Gå nu till Data Elements i den vänstra navigeringen

  3. Markera knappen Create New Data Element

    Skapa ett nytt dataelement

  4. Ange Page Name som Name

  5. Som Data Element Type väljer du JavaScript Variable

  6. Ange digitalData.page.pageInfo.pageName som JavaScript variable name

  7. Markera rutorna för Force lowercase value och Clean text om du vill standardisera värdeformatet.

  8. Kontrollera att Luma Platform Tutorial är markerat som arbetsbibliotek

  9. Välj Save to Library
    Skapa ett dataelement för sidnamn

Mappa sidnamnet till XDM-objektets dataelement

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

IMPORTANT
För att kunna utföra den här uppgiften måste vi se till att din användare först har tillgång till sandlådan Prod. Om du inte redan har åtkomst till Prod-sandlådan från en annan produktprofil öppnar du snabbt din Luma Tutorial Platform-profil och lägger till behörighetsobjektet Sandboxes > Prod. När du har gjort det kan du göra en SKIFT-omläsning på dataelementsidan för att rensa cachen
Lägg till Prod-sandlådan

På sidan Data Elements:

  1. Skapa ett nytt dataelement
  2. Ange XDM Object som Name
  3. Som Extension väljer du Adobe Experience Platform Web SDK
  4. Som Data Element Type väljer du XDM object
  5. Som Sandbox väljer du din Luma Tutorial-sandlåda
  6. Som Schema väljer du Luma Web Events Schema
  7. Markera fältet web.webPageDetails.name
  8. Som Value markerar du ikonen för att öppna det modala dataelementet och väljer Page Name -dataelementet
  9. Välj Save to Library
    Mappa sidnamnet till XDM-objektdataelementet

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 skärmen Rules
  2. Öppna din All Pages - Library Loaded-regel
  3. Öppna åtgärden Adobe Experience Platform Web SDK - Send Event
  4. Som XDM data markerar du ikonen för att öppna det modala dataelementet och väljer XDM Object -dataelementet
  5. Markera knappen Keep Changes
    Lägg till XDM-data i åtgärden Skicka händelse
  6. Eftersom Luma Platform Tutorial har valts som ditt arbetsbibliotek för de senaste övningarna har dina senaste ändringar sparats direkt i biblioteket. I stä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 Save to Library and Build
    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!
Verifiera XDM-data

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 lektionen Kartidentitet. Låt oss då samla in CRM-ID:t med Web SDK!

Lägg till dataelement för CRM-ID

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

  1. Lägg till ett dataelement med namnet CRM Id i tagggränssnittet
  2. Som Data Element Type väljer du JavaScript Variable
  3. Ange digitalData.user.0.profile.0.attributes.username som JavaScript variable name
  4. Välj knappen Save to Library (Luma Platform Tutorial bör fortfarande vara ditt arbetsbibliotek)
    Lägg till dataelement för CRM-ID

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 ett särskilt dataelement som kallas Identity Map-dataelement:

  1. Lägg till ett dataelement med namnet Identities

  2. Som Extension väljer du Adobe Experience Platform Web SDK

  3. Som Data Element Type väljer du Identity map

  4. Som Namespace anger du Luma CRM Id, det namespace vi skapade i en tidigare lektion

    note warning
    WARNING
    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 inte "sandlådemedveten" än och därför kanske inte värdet Luma CRM Id visas 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 det modala dataelementet och väljer CRM Id -dataelementet

  6. Som Authenticated State väljer du Authenticated

  7. Lämna Primary omarkerad. Eftersom CRM-ID:t inte finns för de flesta besökare på Luma-webbplatsen vill du definitivt inte åsidosätta ECID:t 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 knappen Save to Library (Luma Platform Tutorial bör fortfarande vara ditt arbetsbibliotek)
    Lägg till CRM-ID i identitetskartelementet

NOTE
Du kan skicka flera identifierare med datatypen Identity map.

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 Data element markerar du ikonen för att öppna det modala dataelementet och väljer Identities -dataelementet
  4. Eftersom Luma Platform Tutorial har valts som ditt arbetsbibliotek för de senaste övningarna har dina senaste ändringar sparats direkt i biblioteket. I stället för att behöva publicera ändringarna via skärmen Publiceringsflöde kan du öppna listrutan med den blå knappen och välja Save to Library and Build
    Lägg till Data-elementet IdentityMap i XDM-objektet

Validera identiteten

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

  1. Öppna Luma-webbplatsen
  2. Mappa den till taggegenskapen med hjälp av Felsökning, enligt tidigare instruktioner
  3. Välj länken Inloggning längst upp till höger på Luma-webbplatsen
  4. Logga in med inloggningsuppgifterna test@adobe.com/test
  5. Kontrollera Experience Platform Web SDK-anropet i felsökaren (Adobe Experience Platform Web SDK > Network Requests > events för den senaste begäran) när du har autentiserats och se lumaCrmId:
    Verifiera identiteten i felsökaren
  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!
    Verifiera identiteten i plattformen

Ytterligare resurser

Snyggt jobb! 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.

NOTE
Nu när du är klar med lektionen Direktuppspelningsinmatning kan du ta bort sandlådan Prod från din Luma Tutorial Platform-produktprofil

Datatekniker, om du vill kan du hoppa över lektionen kör frågor.

Dataarkitekturer, du kan gå vidare till sammanfogningsprinciper!

recommendation-more-help
513160b6-bf42-4c58-abdd-4f817b1cccad