DokumentationExperience PlatformSjälvstudiekurs om webb-SDK

Strömma data till Experience Platform med Web SDK

Senast uppdaterad: 23 juni 2025
  • Ämnen:

Skapat för:

  • Nybörjare
  • Mellanliggande
  • Utvecklare

Lär dig att strömma webbdata till Adobe Experience Platform med Platform Web SDK.

Experience Platform är ryggraden i alla nya Experience Cloud-program, som Adobe Real-Time Customer Data Platform, Adobe Customer Journey Analytics och Adobe Journey Optimizer. Programmen är utformade för att använda Platform Web SDK som den optimala metoden för insamling av webbdata.

Webb-SDK och Adobe Experience Platform

Experience Platform använder samma XDM-schema som du skapade tidigare för att hämta händelsedata från Lumas webbplats. När dessa data skickas till Platform Edge Network kan dataströmkonfigurationen vidarebefordra dem till Experience Platform.

Utbildningsmål

När lektionen är klar kan du:

  • Skapa en datauppsättning i Adobe Experience Platform
  • Konfigurera dataströmmen för att skicka SDK-data till Adobe Experience Platform
  • Aktivera direktuppspelande webbdata för kundprofil i realtid
  • Validera att data har landats både i plattformsdatauppsättningen och i kundprofilen i realtid
  • Infoga exempeldata om lojalitetsprogram i plattformen
  • Bygg en publik på en enkel plattform

Förhandskrav

För att slutföra lektionen måste du först:

  • Har tillgång till ett Adobe Experience Platform-program som Real-Time Customer Data Platform, Journey Optimizer eller Customer Journey Analytics
  • Slutför de tidigare lektionerna i avsnitten Inledande konfiguration och Tagginställningar i den här självstudien.
NOTE
Om du inte har något plattformsprogram kan du hoppa över den här lektionen eller läsa vidare.

Skapa en datauppsättning

Alla data som har inhämtats till Adobe Experience Platform lagras i datasjön som datauppsättningar. En datamängd är en lagrings- och hanteringskonstruktion för en datamängd, vanligtvis en tabell som innehåller ett schema (kolumner) och fält (rader). Datauppsättningar innehåller också metadata som beskriver olika aspekter av de data som lagras.

Låt oss skapa en datauppsättning för dina webbhändelsedata för Luma:

  1. Gå till gränssnittet Experience Platform eller Journey Optimizer

  2. Bekräfta att du befinner dig i den utvecklingssandlåda som du använder för den här självstudien

  3. Öppna Data Management > Datasets från den vänstra navigeringen

  4. Välj Create dataset

    Skapa schema

  5. Välj alternativet Create dataset from schema

    Skapa datauppsättning från schema

  6. Välj det Luma Web Event Data-schema som skapades i tidigare lektionen och välj sedan Next

    Datauppsättning, välj schema

  7. Ange ett Name och valfritt Description för datauppsättningen. Använd Luma Web Event Data för den här övningen och välj sedan Finish

    Datauppsättningsnamn

En datauppsättning har nu konfigurerats för att börja samla in data från din Platform Web SDK-implementering.

Konfigurera datastream

Nu kan du konfigurera datastream för att skicka data till Adobe Experience Platform. Datastream är länken mellan taggegenskap, Platform Edge Network och Experience Platform datamängd.

  1. Öppna gränssnittet Datainsamling

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

  3. Öppna datastream som du skapade i Konfigurera en datastream-lektion, Luma Web SDK

    Markera dataströmmen för Luma Web SDK

  4. Välj Add Service
    Lägg till en tjänst i datastream

  5. Välj Adobe Experience Platform som Service

  6. Välj Luma Web Event Data som Event Dataset

  7. Välj Save.

    Datastream-konfiguration

När du genererar trafik på Luma Demo Site som är mappad till din taggegenskap fylls datauppsättningen i i Experience Platform!

Validera datauppsättningen

Det här steget är viktigt för att se till att data har landats i datauppsättningen. Det finns två aspekter av att validera data som skickas till datauppsättningen.

  • Validera med Experience Platform Debugger
  • Validera med Preview Dataset
  • Validera med Query Service

Experience Platform Debugger

De här stegen är mer eller mindre desamma som du gjorde i felsökningslektionen. Eftersom data bara skickas till plattformen när du har aktiverat den i datastream måste du generera fler exempeldata:

  1. Öppna demowebbplatsen för luma och välj tilläggsikonen Experience Platform Debugger

  2. Konfigurera felsökaren för att mappa taggegenskapen till din utvecklingsmiljö, enligt beskrivningen i lektionen Validera med felsökning

    Din startutvecklingsmiljö visas i Felsökning

  3. Logga in på Luma-webbplatsen med inloggningsuppgifterna test@test.com/test

  4. Återgå till Lumas hemsida

  5. I de nätverksfyrar för Platform Web SDK som visas av felsökaren väljer du "events"-raden för att visa information i ett popup-fönster

    SDK för webben i felsökning

  6. Sök efter "identityMap" i popup-fönstret. Här visas lumaCrmId med tre nycklar för authenticatedState, id och primär
    SDK för webben i felsökning

Data ska nu fyllas i i datamängden Luma Web Event Data och vara klara för validering av datauppsättningen Preview.

Förhandsgranska datauppsättningen

För att bekräfta att data har landat i plattformens datalinje är ett snabbt alternativ att använda funktionen Preview dataset. SDK-data på webben mikrobatchas in i datasjön och uppdateras regelbundet i plattformsgränssnittet. Det kan ta 10-15 minuter att se data som du har skapat.

  1. I Experience Platform-gränssnittet väljer du Data Management > Datasets i den vänstra navigeringen för att öppna kontrollpanelen Datasets.

    Kontrollpanelen visar alla tillgängliga datauppsättningar för din organisation. Information visas för varje datamängd som anges, inklusive namn, schema som datauppsättningen följer och status för den senaste importen.

  2. Markera Luma Web Event Data-datauppsättningen för att öppna dess Dataset activity-skärm.

    Webbhändelse för datauppsättnings-Luma

    Aktivitetsskärmen innehåller ett diagram som visar hur många meddelanden som har förbrukats samt en lista över lyckade och misslyckade batchar.

  3. På skärmen Dataset activity väljer du Preview dataset i skärmens övre högra hörn om du vill förhandsgranska upp till 100 rader med data. Om datauppsättningen är tom inaktiveras förhandsgranskningslänken.

    Förhandsgranska datauppsättning

    I förhandsgranskningsfönstret visas den hierarkiska vyn av datasetens schema till höger.

    Förhandsgranska datauppsättning 1

Fråga data

  1. I Experience Platform-gränssnittet väljer du Data Management > Queroes i den vänstra navigeringen för att öppna skärmen Queries.
  2. Välj Create query
  3. Kör först en fråga för att se alla tabellnamn i datasjön. Ange SHOW TABLES i frågeredigeraren och klicka på uppspelningsikonen för att köra frågan.
  4. Lägg märke till att namnet på tabellen liknar luma_web_event_data i resultatet
  5. Fråga nu tabellen med en enkel fråga som refererar till tabellen (observera att frågan som standard är begränsad till 100 resultat): SELECT * FROM "luma_web_event_data"
  6. Efter en stund bör du se exempelposter av dina webbdata.
ERROR
Om du får ett felmeddelande om att tabellen inte har etablerats dubbelkontrollerar du namnet på tabellen. Det kan också vara så att mikrobatchen med data ännu inte landat i sjön med data. Försök igen om 10-15 minuter.
INFO
Mer information om Adobe Experience Platform frågetjänst finns i Utforska data i självstudiekurserna för plattformen.

Aktivera datauppsättningen och schemat för kundprofil i realtid

För kunder som har Real-Time Customer Data Platform och Journey Optimizer är nästa steg att aktivera datauppsättningen och schemat för kundprofilen i realtid. Dataströmning från Web SDK kommer att vara en av många datakällor som flödar in i Platform och du vill koppla webbdata till andra datakällor för att skapa 360-graders kundprofiler. Titta på den här korta videon om du vill veta mer om kundprofilen i realtid:

https://video.tv.adobe.com/v/27251?learn=on&captions=eng
CAUTION
När vi arbetar med din egen webbplats och data rekommenderar vi en mer robust validering av data innan vi aktiverar den för kundprofil i realtid.

Så här aktiverar du datauppsättningen:

  1. Öppna datauppsättningen som du skapade, Luma Web Event Data

  2. Markera Profile Toggle för att aktivera den

    Växla profil

  3. Bekräfta att du vill Enable datauppsättningen

    Aktivera profil/växla

Så här aktiverar du schemat:

  1. Öppna schemat som du skapade, Luma Web Event Data

  2. Markera Profile Toggle för att aktivera den

    Växla profil

  3. Välj Data for this schema will contain a primary identity in the identityMap field.

    IMPORTANT
    Primära identiteter krävs i alla poster som skickas till kundprofilen i realtid. Vanligtvis är identitetsfält märkta i schemat. När du använder identitetskartor visas emellertid inte identitetsfälten i schemat. I den här dialogrutan bekräftar du att du har en primär identitet i åtanke och att du anger den i en identitetskarta när du skickar data. Som du vet använder Web SDK en identitetskarta med Experience Cloud-id (ECID) som primär standardidentitet och ett autentiserat ID som primär identitet när det är tillgängligt.

  4. Välj Enable

    Aktivera profil/växla

  5. Välj Save om du vill spara det uppdaterade schemat

Nu är schemat även aktiverat för profilen.

IMPORTANT
När ett schema har aktiverats för profilen kan det inte inaktiveras eller tas bort utan att du behöver återställa eller ta bort hela sandlådan. Det går inte heller att ta bort fält från schemat efter den här punkten.
När du arbetar med egna data rekommenderar vi att du gör saker i följande ordning:
  • För det första kan du importera vissa data i dina datauppsättningar.
  • Åtgärda eventuella problem som uppstår under dataöverföringsprocessen (till exempel datavalidering eller mappningsproblem).
  • Aktivera datauppsättningar och scheman för profil
  • Importera data igen, om det behövs

Validera en profil

Du kan slå upp en kundprofil i plattformsgränssnittet (eller Journey Optimizer-gränssnittet) för att bekräfta att data har landats i kundprofilen i realtid. Som namnet antyder fyller profilerna i realtid, så det är ingen fördröjning som när data i datauppsättningen validerades.

Först måste du generera fler exempeldata. Upprepa stegen tidigare i den här lektionen för att logga in på Luma-webbplatsen när den mappas till taggegenskapen. Kontrollera att SDK-begäran för plattformen skickar data med lumaCRMId.

  1. I Experience Platform-gränssnittet väljer du Customer > Profiles i den vänstra navigeringen

  2. Som Identity namespace använder du lumaCRMId

  3. Kopiera och klistra in värdet för lumaCRMId som skickades i anropet som du inspekterade i Experience Platform Debugger, i det här fallet b642b4217b34b1e8d3bd915fc65c4452.

    Profil

  4. Om det finns ett giltigt värde i profilen för lumaCRMId fylls ett profil-ID i konsolen:

    Profil

  5. Om du vill visa hela Customer Profile för varje ID väljer du Profile ID i huvudfönstret.

    NOTE
    Observera att du kan välja hyperlänken för profil-ID:t, eller om du markerar raden öppnas en högermeny där du kan välja hyperlänken för profil-ID
    Kundprofil

    Här kan du se alla identiteter som är länkade till lumaCRMId, till exempel ECID.

    Kundprofil

Du har nu aktiverat Platform Web SDK för Experience Platform (och Real-Time CDP)! Och Journey Optimizer! Och Customer Journey Analytics!).

Skapa en Edge-utvärderad publik

Vi rekommenderar att du slutför den här övningen för kunder som har Real-Time Customer Data Platform och Journey Optimizer.

När Web SDK-data hämtas in till Adobe Experience Platform kan de berikas av andra datakällor som du har inkapslat i Platform. När en användare till exempel loggar in på Luma-webbplatsen skapas ett identitetsdiagram i Experience Platform och alla andra profilaktiverade datauppsättningar kan sammanfogas för att skapa kundprofiler i realtid. För att se hur detta fungerar kommer du snabbt att skapa ytterligare en datauppsättning i Adobe Experience Platform med några exempel på lojalitetsdata så att du kan använda kundprofiler i realtid med Real-Time Customer Data Platform och Journey Optimizer. Sedan kommer ni att bygga upp en målgrupp baserat på dessa data.

Skapa ett bonusschema och importera exempeldata

Eftersom du redan har gjort liknande övningar kommer instruktionerna att vara korta.

Skapa bonusschemat:

  1. Skapa ett nytt schema

  2. Välj Individual Profile som base class

  3. Namnge schemat Luma Loyalty Schema

  4. Lägg till fältgruppen Loyalty Details

  5. Lägg till fältgruppen Demographic Details

  6. Markera fältet Person ID och markera det som en Identity och Primary identity med Luma CRM Id Identity namespace.

  7. Aktivera schemat för Profile. Om du inte kan hitta växlingsknappen Profil kan du prova att klicka på schemanamnet högst upp till vänster.

  8. Spara schemat

    Bonusschema

Så här skapar du datauppsättningen och importerar exempeldata:

  1. Skapa en ny datauppsättning från Luma Loyalty Schema

  2. Namnge datauppsättningen Luma Loyalty Dataset

  3. Aktivera datauppsättningen för Profile

  4. Hämta exempelfilen luma-loyalty-forWeb.json

  5. Dra och släpp filen i datauppsättningen

  6. Bekräfta att data har importerats

    Bonusschema

Ange en sammanfogningspolicy som är aktiv på Edge

Alla målgrupper skapas med en sammanfogningspolicy. Sammanslagningsprinciper skapar olika"vyer" av en profil, kan innehålla en delmängd av datauppsättningar och anger en prioritetsordning när olika datauppsättningar bidrar med samma profilattribut. För att kunna utvärderas vid kanten måste en målgrupp använda en sammanfogningsprincip med inställningen Active-On-Edge Merge Policy.

IMPORTANT
Endast en sammanfogningsprincip per sandlåda kan ha inställningen Active-On-Edge Merge Policy

  1. Öppna Experience Platform- eller Journey Optimizer-gränssnittet och kontrollera att du är i den utvecklingsmiljö du använder för självstudiekursen.

  2. Navigera till sidan Customer > Profiles > Merge Policies

  3. Öppna Default Merge Policy (förmodligen Default Timebased)
    Skapa en målgrupp

  4. Aktivera inställningen Active-On-Edge Merge Policy

  5. Välj Next

    Skapa en målgrupp

  6. Fortsätt välja Next för att fortsätta genom de andra stegen i arbetsflödet och välj Finish för att spara inställningarna
    Skapa en målgrupp

Nu kan ni skapa målgrupper som utvärderas på Edge.

Skapa en målgrupp

Målgruppsprofiler samlas kring gemensamma egenskaper. Skapa en enkel målgrupp som du kan använda i Real-Time CDP eller Journey Optimizer:

  1. I Experience Platform- eller Journey Optimizer-gränssnittet går du till Customer > Audiences i den vänstra navigeringen

  2. Välj Create audience

  3. Välj Build rule

  4. Välj Create

    Skapa en målgrupp

  5. Välj Attributes

  6. Hitta fältet Loyalty > Tier och dra det till avsnittet Attributes

  7. Definiera målgruppen som användare vars tier är gold

  8. Namnge målgruppen Luma Loyalty Rewards – Gold Status

  9. Välj Edge som Evaluation method

  10. Välj Save

    Definiera målgruppen

NOTE
Eftersom vi har angett standardsammanslagningsprincipen som Active-On-Edge Merge Policy kopplas målgruppen som du skapade automatiskt till den här sammanfogningsprincipen.

Eftersom detta är en mycket enkel publik kan vi använda Edge utvärderingsmetod. Edge målgrupper utvärderas i det närmaste, så i samma begäran som Web SDK gör till Platform Edge Network kan vi utvärdera målgruppsdefinitionen och omedelbart bekräfta om användaren är berättigad.

Nästa:

NOTE
Tack för att du har lagt ned din tid på att lära dig om Adobe Experience Platform Web SDK. Om du har frågor, vill dela allmän feedback eller har förslag på framtida innehåll kan du dela dem i det här Experience League diskussionsgruppsinlägget
recommendation-more-help
8cbc0fd8-ca1d-433b-9c3d-bc3f113347d4