DokumentationExperience PlatformInfoga strömmande data

Infoga strömmande data

Last update: Mon Sep 25 2023 00:00:00 GMT+0000 (Coordinated Universal Time)

Skapat för:

  • Beginner
  • Intermediate
  • Developer

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:

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

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

NOTE
Den här självstudiekursen fokuserar på direktuppspelning från webbplatser med Web SDK, men du kan även direktuppspela data med Adobe Mobile SDK, Apache Kafka Connectoch andra mekanismer.

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 till vänster navigering

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

    Välj datastölar i den vänstra navigeringen

  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

    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 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
    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-skript, 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 Egenskaper till vänster navigering
  2. Välj Ny egenskap knapp
    Lägg till en ny egenskap
  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
    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 Tillägg till vänster navigering
  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 tillägg väljer du Installera knapp
    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 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 dataström.
  8. Du kan gärna titta på andra konfigurationsalternativ (men ändra dem inte!) och sedan 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 till vänster navigering
  2. Välj Skapa ny regel knapp
    Skapa en regel
  3. Namnge regeln All Pages - Library Loaded
  4. Under Händelser väljer du Lägg till knapp
    Namnge regeln och lägg till en händelse
  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
    Lägg till händelsen Biblioteksinläsning
  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. Välj till höger web.webpagedetails.pageViews från Typ nedrullningsbar meny. Detta är ett av XDM-fälten i Luma Web Events Schema
  11. Välj Behåll ändringar för att återgå till huvudlinjeraster
    Lägg till åtgärden Skicka händelse
  12. Välj Spara för att spara regeln
    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 till vänster navigering
  2. Välj Lägg till bibliotek
    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 tillägg 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
    Skapa och bygg 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:
Bygget är klart

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:

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 Lumas webbplats.
  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 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!

Lumas hemsida

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 till vänster navigering

  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
    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 Luma Platform Tutorial property

  9. Välj Development miljö

  10. Välj Använd knapp
    Välj den alternativa taggegenskapen

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

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

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

  14. Öppna händelser rad

    Adobe Experience Platform Web SDK-begäran

  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
    Händelseinformation

  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. Filtrera samtal med interact för att hitta samtalet markerar du det och tittar sedan på Sidhuvuden tab, Begär nyttolast område.
    Fliken Nätverk

  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.
    Fliken Nätverk

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 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 Datauppsättningar till vänster navigering
  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
    Ö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 Profiler till vänster navigering
  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
    Hitta och öppna profilen
  4. Välj Händelser för att se 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, längst upp till höger i 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 till vänster navigering

  3. Välj Skapa nytt dataelement knapp

    Skapa ett nytt dataelement

  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
    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 tillgång till Prod-sandlådan från en annan produktprofil kan du snabbt öppna din Luma Tutorial Platform profil och lägga till behörighetsobjektet Sandlådor > 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å 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
    Mappa sidnamnet till XDM-objektets dataelement

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
    Lägg till XDM-data till åtgärden Skicka händelse
  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
    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!
Validera 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 Mappa identiteter lektion. 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 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 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 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

    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 ännu inte"sandlådemedveten", vilket innebär att Luma CRM Id värdet kanske inte 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 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 CRM-ID i dataelementet för identitetskartan

NOTE
Du kan skicka flera identifierare med Identitetskarta datatyp.

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
    Lägg till dataelementet IdentityMap i XDM-objektet

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 hjälp av 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:
    Validera identiteten i Felsökning
  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!
    Validera 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 inmatningslektionen för strömning kan du ta bort Prod sandlåda från Luma Tutorial Platform produktprofil

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

Dataarkitekter kan du gå vidare till sammanfogningsprinciper!

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