Översikt över datainsamling från början till slut

Adobe Experience Platform samlar in och överför data till andra Adobe-produkter och tredjepartsdestinationer. För att kunna skicka händelsedata från ditt program till Experience Platform är det viktigt att förstå dessa kärntekniker och hur de konfigureras för att leverera data till de destinationer du behöver, när du behöver det.

Den här guiden innehåller en självstudiekurs på hög nivå om hur du skickar en händelse via Edge Network med hjälp av plattformens datainsamlingsfunktioner. Självstudiekursen går igenom stegen för att installera och konfigurera taggtillägget Adobe Experience Platform Web SDK i användargränssnittet för datainsamling (tidigare Adobe Experience Platform Launch).

NOTE
Du kan också välja att installera och konfigurera SDK manuellt om du inte vill använda taggar, men de omgivande stegen måste ändå slutföras enligt nedan.
Alla steg som omfattar användargränssnittet för datainsamling kan också utföras i användargränssnittet för Experience Platform.

Förhandskrav

I den här självstudien används användargränssnittet för datainsamling för att skapa ett schema, konfigurera ett datastream och installera Web SDK. För att kunna utföra de här åtgärderna i användargränssnittet måste du ha tillgång till minst en webbegenskap tillsammans med följande egenskapsrättigheter:

  • Utveckla
  • Hantera tillägg

Se guiden Hantera behörigheter för datainsamling för att lära dig hur du beviljar åtkomst till egenskaper och egenskapsrättigheter.

Om du vill använda de olika datainsamlingsprodukterna som nämns i den här guiden måste du även ha tillgång till datastreams och möjlighet att skapa och hantera scheman. Om du behöver tillgång till någon av dessa funktioner kontaktar du ditt Adobe-kontoteam för att få den åtkomst du behöver. Observera att om du inte har köpt Adobe Experience Platform ger Adobe dig tillgång till SDK utan extra kostnad.

Om du redan har åtkomst till Platform måste du se till att du har aktiverat alla behörigheter under följande kategorier:

  • Datamodellering
  • Identiteter

Mer information om hur du tilldelar behörigheter för plattformsfunktioner till användare finns i användargränssnittsöversikten för åtkomstkontroll.

Processsammanfattning

Processen med att konfigurera datainsamling för webbplatsen kan sammanfattas på följande sätt:

  1. Skapa ett schema för att bestämma hur dina data ska struktureras när de skickas till Edge Network.
  2. Skapa en datastream för att konfigurera vilka mål du vill att dina data ska skickas till.
  3. Installera och konfigurera Web SDK för att skicka data till dataströmmen när vissa händelser inträffar på webbplatsen.

När du kan skicka data till Edge Network kan du även konfigurera vidarebefordran av händelser om din organisation har en licens för det.

Skapa ett schema schema

Experience Data Model (XDM) är en öppen källkodsspecifikation som innehåller gemensamma strukturer och definitioner för data i form av scheman. Med andra ord är XDM ett sätt att strukturera och formatera data på ett sätt som kan användas av Edge Network och andra Adobe Experience Cloud-program.

Det första steget i att konfigurera datainsamlingsåtgärderna är att skapa ett XDM-schema som representerar dina data. I ett senare steg i den här självstudiekursen mappas de data som du vill skicka till strukturen för det här schemat.

NOTE
XDM-scheman är mycket anpassningsbara. I stället för att vara alltför prediktiv fokuserar stegen nedan specifikt på schemakraven för Web SDK. Utanför dessa parametrar kan du definiera den återstående strukturen för dina data.

Välj Schemas i den vänstra navigeringen i användargränssnittet. Här visas en lista med tidigare skapade scheman som tillhör din organisation. Om du vill fortsätta väljer du Create schema och sedan XDM ExperienceEvent i listrutan.

Arbetsytan Scheman

En dialogruta visas där du uppmanas att börja lägga till fältgrupper i schemat. Om du vill skicka händelser med Web SDK måste du lägga till fältgruppen AEP Web SDK ExperienceEvent Mixin. Den här fältgruppen innehåller definitioner för dataattribut som samlas in automatiskt av Web SDK-biblioteket.

Använd sökfältet för att begränsa listan så att det blir enklare att hitta fältgruppen. När du har hittat den markerar du den i listan innan du väljer Add field groups.

Arbetsytan Scheman

Schemaarbetsytan visas med en trädstruktur i XDM-schemat som innehåller fälten från Web SDK-fältgruppen.

Schemastruktur

Markera rotfältet i trädet för att öppna Schema properties i den högra listen, där du kan ange ett namn och en valfri beskrivning för schemat.

Namnge schemat

Om du vill lägga till fler fält i schemat kan du göra det genom att välja Add under avsnittet Field groups i den vänstra listen.

Lägg till fältgrupper

NOTE
I guiden om att lägga till fältgrupper i XDM-dokumentationen finns mer information om hur du söker efter olika fältgrupper så att de passar dina användningsexempel.
Det bästa sättet är att bara lägga till fält för data som du planerar att skicka via Edge Network. När du har lagt till fält i ett schema och sparat det, kan endast additiva ändringar göras i schemat därefter. Mer information finns i avsnittet regler för schemautveckling.

När du har lagt till de fält du behöver väljer du Save för att spara schemat.

Spara schemat

Skapa ett datastream datastream

En datastream är en konfiguration som talar om för Edge Network var du vill att dina data ska skickas. En datastream anger vilka Experience Cloud-produkter du vill skicka data till och hur du vill att data ska hanteras och lagras i respektive produkt.

NOTE
Om du vill använda händelsevidarebefordran (förutsatt att din organisation har licens för funktionen) måste du aktivera den för ett datastream på samma sätt som du aktiverar Adobe-produkter. Information om den här processen beskrivs i ett senare avsnitt.

Välj Datastreams i den vänstra navigeringen. Härifrån kan du välja ett befintligt datastam från listan som ska redigeras, eller så kan du skapa en ny konfiguration genom att välja New Datastream.

Datastreams

Konfigurationskraven för en datastream beror på vilka produkter och funktioner du skickar data till. Mer information om konfigurationsalternativen för varje produkt finns i datastreams-översikten.

Installera och konfigurera Web SDK install

När du har skapat ett schema och ett datastream är nästa steg att installera och konfigurera Platform Web SDK för att börja skicka data till Edge Network.

NOTE
I det här avsnittet används användargränssnittet för datainsamling för att konfigurera Web SDK-taggtillägget, men du kan även installera och konfigurera det med Raw-kod i stället. Mer information finns i följande handböcker:
Observera också att även om du bara vill använda händelsevidarebefordran måste du fortfarande installera och konfigurera SDK enligt beskrivningen innan du konfigurerar händelsevidarebefordran i ett senare steg.

Processen kan sammanfattas enligt följande:

  1. Installera Adobe Experience Platform Web SDK på en taggegenskap för att få tillgång till dess funktioner.
  2. Skapa ett XDM-objektdataelement om du vill mappa variabler på webbplatsen till strukturen i XDM-schemat som du skapade tidigare.
  3. Skapa en regel som talar om för SDK när data ska skickas till Edge Network.
  4. Skapa och installera ett bibliotek för att implementera regeln på din webbplats.

Installera SDK på en taggegenskap install-sdk

Välj Tags i den vänstra navigeringen om du vill visa en lista med taggegenskaper. Du kan välja en befintlig egenskap som ska redigeras om du vill, eller så kan du markera New Property i stället.

Egenskaper

Om du skapar en ny egenskap anger du ett beskrivande namn och anger Platform till Web. Ange den fullständiga domänen för webbegenskapen och välj sedan Save.

Skapa egenskap

Översiktssidan för egenskapen visas. Här väljer du Extensions i den vänstra navigeringen och sedan Catalog. Sök efter listan för Platform Web SDK (eventuellt med sökfältet för att begränsa resultaten) och välj Install.

Installera Web SDK

Konfigurationssidan för SDK visas. De flesta obligatoriska värden fylls i automatiskt med standardvärden som du kan ändra om du vill.

Konfigurera Web SDK

Innan du kan installera SDK måste du dock välja en datastream så att den vet var data ska skickas till. Under Datastreams använder du listrutemenyn för att välja den datastream som du konfigurerade i ett tidigare steg. När du har angett datastream väljer du Save för att slutföra installationen av SDK till egenskapen.

Ange dataström och spara

Skapa ett XDM-dataelement data-element

För att SDK ska kunna skicka data till Edge Network måste dessa data mappas till XDM-schemat som du skapade i ett föregående steg. Mappningen görs med hjälp av ett dataelement.

I användargränssnittet väljer du Data Elements och sedan Create New Data Element.

Skapa nytt dataelement

På nästa skärm väljer du Adobe Experience Platform Web SDK under listrutan Extension och sedan XDM object som dataelementtyp.

XDM-objekttyp

Konfigurationsdialogrutan visas för XDM-objekttypen. Dialogrutan väljer automatiskt din plattformssandlåda, och härifrån kan du se alla scheman som har skapats i den sandlådan. Välj XDM-schemat som du skapade tidigare från listan.

XDM-objekttyp

Schemats struktur visas. Alla fält med en asterisk (*) anger fält som fylls i automatiskt när händelser utlöses. För alla andra fält kan du utforska schemats struktur och fylla i resten av data.

Mappa data till XDM-fält

NOTE
Skärmbilden ovan visar hur du mappar en globalt tillgänglig variabel från klientsidan på webbplatsen (cartAbandonsTotal) till ett XDM-fält genom att referera till dess namn i fältet Value, omgivet av procenttecken (%).
Du kan också använda andra dataelement som du redan har skapat för att fylla i dessa fält. Mer information finns i referensen för dataelement i taggdokumentationen.

När du har mappat dina data till schemat anger du ett namn för dataelementet innan du väljer Save.

Namnge och spara dataelement

Skapa en regel

När du har sparat dataelementet är nästa steg att skapa en regel som skickar den till Edge Network när en viss händelse inträffar på webbplatsen (till exempel när en kund lägger till en produkt i en kundvagn).

Du kan ange regler för praktiskt taget alla händelser som kan inträffa på webbplatsen. I det här avsnittet visas hur du skapar en regel som utlöses när en kund skickar in ett formulär. Följande HTML representerar en enkel webbsida med formuläret"Lägg till i kundvagnen", som kommer att vara regelns ämne:

<!DOCTYPE html>
<html>
<body>

  <form id="add-to-cart-form">
    <label for="item">Product:</label><br>
    <input type="text" id="item" name="item"><br>
    <label for="amount">Amount:</label><br>
    <input type="number" id="amount" name="amount" value="1"><br><br>
    <input type="submit" value="Add to Cart">
  </form>

</body>
</html>

I användargränssnittet för datainsamling väljer du Rules i den vänstra navigeringen och sedan Create New Rule.

Regler

Ange ett namn för regeln på nästa skärm. Härifrån är nästa steg att bestämma händelsen för regeln (med andra ord när regeln ska aktiveras). Välj Add under Events.

Namnregel

Händelsekonfigurationssidan visas. Om du vill konfigurera en händelse måste du först välja händelsetyp. Händelsetyper tillhandahålls av tillägg. Om du vill ställa in en händelse av typen"skicka formulär", till exempel, väljer du tillägget Core och sedan händelsetypen Submit under kategorin Form.

NOTE
Mer information om de olika händelsetyperna i webbtilläggen för Adobe, inklusive hur du konfigurerar dem, finns i Adobe-tilläggsreferensen i taggdokumentationen.

Med formulärsändningshändelsen kan du använda en CSS-väljare för att referera till ett specifikt element som regeln ska starta på. I exemplet nedan används ID:t add-to-cart-form så att den här regeln bara aktiveras för formuläret"Lägg till i kundvagnen". Välj Keep Changes om du vill lägga till händelsen i regeln.

Händelsekonfiguration

Regelkonfigurationssidan visas igen och visar att händelsen har lagts till. Du kan begränsa If genom att lägga till ytterligare villkor till regeln.

I annat fall är nästa steg att lägga till en åtgärd som regeln ska utföra när den aktiveras. Välj Add under Actions för att fortsätta.

Lägg till åtgärd

Sidan för åtgärdskonfiguration visas. Om du vill hämta regeln för att skicka data till Edge Network väljer du Adobe Experience Platform Web SDK som tillägg och Send event som åtgärdstyp.

Åtgärdstyp

Skärmen uppdateras och visar ytterligare alternativ för att konfigurera åtgärden skicka händelse. Under Type kan du ange ett anpassat typvärde för att fylla i eventType XDM-fältet. Under XDM data anger du namnet på XDM-datatypen som du skapade tidigare (omges av procenttecken), eller väljer databasikonen ( Databasikonen ) för att välja den från en lista. Detta är de data som slutligen kommer att skickas till Edge Network.

Välj Keep Changes när du är klar.

Åtgärdskonfiguration

När du har konfigurerat regeln väljer du Save för att slutföra processen.

Spara regel

Skapa och installera ett bibliotek library

När regeln har konfigurerats kan du lägga till den i ett taggbibliotek, skapa biblioteket i en miljö och installera det bygget på webbplatsen.

NOTE
Om du inte har konfigurerat någon miljö i användargränssnittet för datainsamling än måste du göra det innan du kan skapa en version. Mer information finns i avsnittet Konfigurera en miljö för en webbegenskap i taggdokumentationen.

Mer information om hur du skapar ett bibliotek, lägger till tillägg och regler i biblioteket och skapar biblioteket i en miljö finns i guiden om hantering av bibliotek i taggdokumentationen. När du skapar biblioteket måste du ta med tillägget Platform Web SDK och de datainsamlingsregler som du skapade tidigare.

När du har skapat biblioteket och dess bygge har tilldelats en miljö kan du installera den miljön på klientsidan av webbplatsen. Mer information finns i avsnittet Installera miljöer.

När du har installerat miljön på webbplatsen kan du testa implementeringen med Adobe Experience Platform Debugger.

Konfigurera händelsevidarebefordran (valfritt) event-forwarding

NOTE
Vidarebefordran av händelser är bara tillgängligt för organisationer som har licensierats för det.

När du har konfigurerat SDK för att skicka data till Edge Network kan du konfigurera vidarebefordran av händelser för att tala om för Edge Network var du vill att dessa data ska levereras.

Om du vill använda händelsevidarebefordran måste du först skapa en egenskap för händelsevidarebefordran. Välj Event Forwarding i den vänstra navigeringen och välj sedan New Property. Ange ett namn för egenskapen innan du väljer Save.

När du har skapat en egenskap för vidarebefordring av händelser är nästa steg att skapa en regel som bestämmer var data ska skickas. Regler för egenskaper för vidarebefordran av händelser skapas på ungefär samma sätt som taggegenskaper, med undantag för att inga händelser kan anges (eftersom vidarebefordran endast hanterar händelser som tas emot direkt från datastream). För regelns åtgärd kan du använda ett av de tillgängliga tilläggen för vidarebefordran av händelser eller använda anpassad kod för att leverera händelsen i stället.

Regel för vidarebefordran av händelse

På liknande sätt som tidigare måste du, när du har konfigurerat regeln, lägga till den i ett bibliotek och skapa biblioteket i en miljö.

När bygget är klart är det sista steget att uppdatera datastream som du tidigare konfigurerat och aktivera händelsevidarebefordran. Börja med att navigera till Datastreams och välj det aktuella dataflödet i listan. Härifrån aktiverar du växlingen för att vidarebefordra händelser och anger namnen på den egenskap och miljö som du just konfigurerade.

Dataström för vidarebefordran av händelser

Nästa steg

Den här guiden ger en heltäckande översikt över hur du skickar data till Edge Network med hjälp av Platform Web SDK. Mer information om de olika komponenterna och tjänsterna finns i dokumentationen som är länkad till i den här handboken.

recommendation-more-help
1ae86b30-e55e-49c1-ab11-9d0356a5f3e1