Ö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 programmet till Experience Platform Edge Network är det viktigt att förstå dessa kärntekniker och hur de konfigureras för att leverera data till de mål 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 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örutsättningar

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 om du vill lära dig hur du ger åtkomst till egendomar och egendomsrä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 tillgång till Platform måste du se till att du har alla behörigheter under följande kategorier aktiverade:

• Datamodellering
• Identiteter

Se översikt över användargränssnittet för åtkomstkontroll om du vill lära dig hur du tilldelar behörigheter för plattformsfunktioner till användare.

Processsammanfattning

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

1. Skapa ett schema för att avgöra hur data kommer att struktureras när de skickas till Edge Network.
2. Skapa ett 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 också välja att konfigurera vidarebefordran av händelser om organisationen har en licens för det.

Skapa ett 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 hanteras 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. Här visas en lista med tidigare skapade scheman som tillhör din organisation. Välj Create schema väljer 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 som ska öppnas Schema properties till höger, där du kan ange ett namn och en valfri beskrivning av schemat.

Om du vill lägga till fler fält i schemat kan du göra det genom att markera Add under Field groups till vänster.

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

Skapa ett datastream

En datastream är en konfiguration som anger 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är kan du välja ett befintligt datastam från listan som du vill redigera eller 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 respektive produkt finns i datastreams - översikt.

Installera och konfigurera Web SDK

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:

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

Installera SDK på en taggegenskap

Välj Tags i den vänstra navigeringen för att visa en lista med taggegenskaper. Du kan välja att redigera en befintlig egenskap 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 väljer du Catalog. Sök efter listan för Platform Web SDK (eventuellt med sökfältet för att begränsa resultatet) 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 på en 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

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

Välj Data Elements väljer Create New Data Element.

På nästa skärm väljer du Adobe Experience Platform Web SDK under Extension listruta och välj XDM object för elementtypen data.

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 automatiskt fylls i 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 är klar med mappningen av 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 det 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 väljer du 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 "form submit"-händelse väljer du Core och välj sedan Submit händelsetyp under Form kategori.

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

Regelkonfigurationssidan visas igen och visar att händelsen har lagts till. Du kan begränsaIf" 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 för tillägget, och Send event för åtgärdstypen.

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ält. Under XDM data anger du namnet på XDM-datatypen som du skapade tidigare (omgivet av procenttecken), eller väljer databasikonen () för att markera den i en lista. Det här är de data som kommer att skickas till Edge Network.

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

När du är klar med konfigurationen av regeln väljer du Save för att slutföra processen.

Bygga och installera ett bibliotek

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.

Om du vill veta mer om hur du skapar ett bibliotek, lägger till tillägg och regler i biblioteket och bygger biblioteket i en miljö läser du i handboken hantera 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. Se avsnittet om installera miljöer för mer information.

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

Konfigurera händelsevidarebefordran (valfritt)

När du har konfigurerat SDK för att skicka data till Edge Network kan du konfigurera händelsevidarebefordran 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 väljer du 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 den dataström du har tidigare konfigurerad och aktivera vidarebefordran av händelser. Navigera till Datastreams och välj den aktuella datastream 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 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.

Resurser för Business.Adobe.com