Ö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).

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:

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:

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:

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.

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.

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.

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

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.

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.

När du har lagt till de fält du behöver väljer du Save för att 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.

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.

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.

Processen kan sammanfattas enligt följande:

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.

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.

Ö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.

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

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.

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.

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

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.

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.

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

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.

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.

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.

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.

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.

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.

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 ( ) 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.

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

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.

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

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.

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.

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.