Importera data via Adobe Experience Platform Web SDK

Den här snabbstartsguiden förklarar hur du kan importera data för webbplatsspårning direkt till Adobe Experience Platform med Adobe Experience Platform Web SDK och Edge Network och sedan använda dessa data i Customer Journey Analytics.

För att uppnå detta måste du:

  • Konfigurera ett schema och en datauppsättning i Adobe Experience Platform för att definiera modellen (schemat) för de data som du vill samla in och var data (datauppsättningen) ska samlas in.

  • Konfigurera en datastream för att konfigurera Adobe Experience Platform Edge Network så att insamlade data dirigeras till datauppsättningen som du konfigurerade i Adobe Experience Platform.

  • Använd taggar för att enkelt konfigurera regler och dataelement mot data i ditt datalager på din webbplats. Kontrollera sedan att data skickas till den dataström som är konfigurerad på Adobe Experience Platform Edge Network.

  • Distribuera och validera. Ha en miljö där du kan iterera på taggutvecklingen och när allt har validerats publicerar du det direkt i produktionsmiljön.

  • Konfigurera en anslutning i Customer Journey Analytics. Den här anslutningen bör (åtminstone) innehålla din Adobe Experience Platform-datauppsättning.

  • Konfigurera en datavy i Customer Journey Analytics för att definiera mått och dimensioner som du vill använda i Analysis Workspace.

  • Konfigurera ett projekt i Customer Journey Analytics för att skapa rapporter och visualiseringar.

NOTE
Den här snabbstartsguiden är en förenklad guide om hur du importerar data som samlats in från din webbplats till Adobe Experience Platform och använder dem i Customer Journey Analytics. Vi rekommenderar starkt att man studerar den ytterligare informationen när det hänvisas till.

Konfigurera ett schema och en datauppsättning

Om du vill importera data till Adobe Experience Platform måste du först definiera vilka data du vill samla in. Alla data som hämtas in till Adobe Experience Platform måste överensstämma med en standardiserad, normaliserad struktur för att de ska kunna identifieras och hanteras av funktioner och funktioner längre fram i kedjan. Experience Data Model (XDM) är standardramverket som tillhandahåller den här strukturen i form av scheman.

När du har definierat ett schema använder du en eller flera datauppsättningar för att lagra och hantera datainsamlingen. En datauppsättning är en lagrings- och hanteringskonstruktion för en datamängd (vanligtvis en tabell) som innehåller ett schema (kolumner) och fält (rader).

Alla data som importeras till Adobe Experience Platform måste överensstämma med ett fördefinierat schema innan de kan sparas som en datauppsättning.

Konfigurera ett schema

Du vill spåra minimala data från profiler som besöker webbplatsen, till exempel sidnamn och identifiering.
Du måste först definiera ett schema som modellerar dessa data.

Så här konfigurerar du ditt schema:

  1. I Adobe Experience Platform-gränssnittet väljer du Schemas inom DATA MANAGEMENT.

  2. Välj Create schema. .

  3. I steget Välj en klass i guiden Skapa schema:

    1. Välj Experience Event.

      Skapa en schemarubriking för Experience Event

      note info
      INFO
      Ett Experience Event-schema används för att modellera beteende för en profil (som scennamn, tryck på knappen för att lägga till i kundvagnen). Ett enskilt profilschema används för att modellera profilen attributes (som namn, e-post, kön).
    2. Välj Next.

  4. I Name and review step i Create schema guide:

    1. Ange en Schema display name för ditt schema och (valfritt) en Description.

      Skapa schemafönster med namnet på schemafälten

    2. Välj Finish.

  5. På fliken Struktur i exempelschemat:

    1. Välj + Add in Field groups.

      Lägg till fältgrupp

      Fältgrupper är återanvändbara samlingar av objekt och attribut som gör att du enkelt kan utöka ditt schema.

    2. I Add fields groups väljer du AEP Web SDK ExperienceEvent fältgrupp från listan.

      AEP Web SDK ExperienceEvent, fältgrupp

      Du kan välja knappen Förhandsgranska om du vill se en förhandsgranskning av fälten som är en del av den här fältgruppen, som web > webPageDetails > name.

      AEP Web SDK ExperienceEvent, fältgruppförhandsgranskning

      Välj Back för att stänga förhandsgranskningen.

    3. Välj Add field groups.

  6. Välj + bredvid schemanamnet i Structure -panelen.

    Knappen Lägg till fält i exempelschema

  7. I Field Properties panel, ange Identification som namn, Identification som Display name, markera Object som Type och markera ExperienceEvent Core v2.1 som Field Group.

    note note
    NOTE
    Om fältgruppen inte är tillgänglig söker du efter en annan fältgrupp som innehåller identitetsfält. eller skapa en ny fältgrupp och lägg till nya identitetsfält (som ecid, crmIdoch andra som du behöver) till fältgruppen och markera den nya fältgruppen.

    Identifieringsobjekt

    Identifieringsobjektet lägger till identifieringsfunktioner i ditt schema. I ditt fall vill du identifiera profiler som besöker din webbplats med hjälp av Experience Cloud-ID och e-postadress. Det finns många andra attribut som du kan använda för att spåra din persons ID (till exempel kundens ID, lojalitets-ID).

    Välj Apply om du vill lägga till det här objektet i ditt schema.

  8. Välj ecid fält i det identifieringsobjekt som du just lade till, och markera Identity och Primary Identity och ECID från Identity namespace i den högra panelen.

    Ange ECID som identitet

    Du anger Experience Cloud Identity som den primära identitet som Adobe Experience Platform Identity-tjänsten kan använda för att kombinera (sy ihop) beteendet hos profiler med samma ECID.

    Välj Apply. En fingeravtrycksikon visas i attributet ecid.

  9. Välj email fält i det identifieringsobjekt som du just lade till, och markera Identity och Email från Identity namespace listan i Field Properties -panelen.

    Ange e-postadress som identitet

    Du anger e-postadressen som en annan identitet som kan användas av tjänsten Adobe Experience Platform Identity för att kombinera (sammanfoga) beteendet för profiler.

    Välj Apply. En fingeravtrycksikon visas i e-postattributet.

    Välj Save.

  10. Markera rotelementet i schemat som visar schemats namn och välj sedan Profile byt.

    Du uppmanas att aktivera schemat för profilen. När data har aktiverats, när data har importerats till datauppsättningar som baseras på detta schema, sammanfogas dessa data i kundprofilen i realtid.

    Se Aktivera schemat för användning i kundprofilen i realtid för mer information.

    note important
    IMPORTANT
    När du har sparat ett schema som är aktiverat för profilen kan det inte längre inaktiveras för profilen.

    Aktivera schema för profil

  11. Välj Save för att spara ditt schema.

Du har skapat ett minimalt schema som modellerar de data som du kan hämta från webbplatsen. Schemat gör det möjligt att identifiera profiler med hjälp av Experience Cloud-identitet och e-postadress. Genom att aktivera schemat för profil ser du till att data som hämtas från din webbplats läggs till i kundprofilen i realtid.

Bredvid beteendedata kan du även hämta profilattributdata från din webbplats (till exempel information om profiler som prenumererar på ett nyhetsbrev).

Så här hämtar du profildata:

  • Skapa ett schema baserat på klassen XDM Individual Profile.

  • Lägg till fältgruppen Profilkärna v2 i schemat.

  • Lägg till ett identifieringsobjekt baserat på fältgruppen Profile Core v2.

  • Definiera Experience Cloud-ID som primär identifierare och e-post som identifierare.

  • Aktivera schemat för profilen

Se Skapa och redigera scheman i användargränssnittet om du vill ha mer information om hur du lägger till och tar bort fältgrupper och enskilda fält i ett schema.

Konfigurera en datauppsättning

Med ditt schema har du definierat din datamodell. Nu måste du definiera konstruktionen för att lagra och hantera data, vilket sker via datauppsättningar.

Så här konfigurerar du datauppsättningen:

  1. I Adobe Experience Platform-gränssnittet väljer du Datasets inom DATA MANAGEMENT.

  2. Välj Create dataset.

    Skapa datauppsättning

  3. Välj Create dataset from schema.

    Skapa datauppsättning från schema

  4. Markera schemat som du skapade tidigare och välj Next.

  5. Ge datauppsättningen ett namn och (valfritt) ge en beskrivning.

    Namndatauppsättning

  6. Välj Finish.

  7. Välj Profile byt.

    Du uppmanas att aktivera datauppsättningen för profilen. När datauppsättningen är aktiverad berikas kundprofiler i realtid med inkapslade data.

    note important
    IMPORTANT
    Du kan bara aktivera en datauppsättning för profilen när schemat, som datauppsättningen följer, också är aktiverat för profilen.

    Aktivera schema för profil

Se Användargränssnittshandbok för datauppsättningar om du vill ha mer information om hur du visar, förhandsgranskar, skapar, tar bort en datauppsättning. Och hur man aktiverar en datauppsättning för kundprofil i realtid.

Konfigurera en datastream

En datastream representerar konfigurationen på serversidan när Adobe Experience Platform Web och Mobile SDK implementeras. När du samlar in data med Adobe Experience Platform SDK:er skickas data till Adobe Experience Platform Edge Network. Det är datastream som avgör vilka tjänster som data vidarebefordras till.

I din konfiguration vill du att de data du samlar in från webbplatsen ska skickas till din datauppsättning i Adobe Experience Platform.

Så här konfigurerar du datastream:

  1. I användargränssnittet för Adobe Experience Platform väljer du Datastreams från DATA COLLECTION till vänster.

  2. Välj New Datastream.

  3. Namnge och beskriv ditt datastream. Välj ditt schema från Event Schema lista.

    Ny datastream

  4. Välj Save.

  5. Välj Add Service.

  6. I Add Service screen:

    1. Välj Adobe Experience Platform från Service lista.

    2. Säkerställ Enabled är markerat.

    3. Välj din datauppsättning på Event Dataset lista.

      Tjänsten Datastream AEP

    4. Lämna de andra inställningarna och välj Save för att spara datastream.

Din datastream är nu konfigurerad för att vidarebefordra data som samlats in från din webbplats till din datauppsättning i Adobe Experience Platform.

Se Översikt över datastreams om du vill ha mer information om hur du konfigurerar ett datastam och hur du hanterar känsliga data.

Använd taggar

Om du vill implementera kod på din webbplats för att samla in data använder du taggfunktionen i Adobe Experience Platform . Med tagghanteringslösningen kan ni driftsätta kod tillsammans med andra taggningskrav. Taggar är sömlösa och integrerade med Adobe Experience Platform med tillägget Adobe Experience Platform Web SDK.

Skapa en tagg

  1. I Adobe Experience Platform-gränssnittet väljer du Tags inom DATA COLLECTION.

  2. Välj New Property.

    Namnge taggen och markera Web och ange ett domännamn. Välj Save för att fortsätta.

    Skapa en egenskap

Konfigurera taggen

När du har skapat taggen måste du konfigurera den med rätt tillägg och konfigurera dataelement och regler efter hur du vill spåra webbplatsen och skicka data till Adobe Experience Platform.

Välj den nyligen skapade taggen i listan över Tag Properties för att öppna den.

Tillägg

För att vara säker på att du kan skicka data till Adobe Experience Platform (via din datastream) lägger du till Adobe Platform Web SDK-tillägget i taggen.

Så här skapar och konfigurerar du Adobe Experience Platform Web SDK-tillägget:

  1. Välj Extensions till vänster.

  2. Välj Catalog i det övre fältet.

  3. Sök efter eller bläddra till Adobe Experience Platform Web SDK-tillägget och välj Install för att installera den.

  4. Välj din sandlåda och din tidigare skapade datastream för din Production Environment och (valfritt) Staging Environment och Development Environment.

    Konfiguration av AEP Web SDK-tillägg

    Välj Save.

Se Konfigurera Adobe Experience Platform Web SDK-tillägget för mer information.

Du vill också konfigurera Experience Cloud ID-tjänsttillägget så att du enkelt kan använda Experience Cloud ID. Experience Cloud ID-tjänsten identifierar personer i alla Adobe Experience Cloud-lösningar.

Så här skapar och konfigurerar du tjänsttillägget Experience Cloud ID:

  1. Välj Extensions till vänster.

  2. Välj Catalog i det övre fältet.

  3. Sök efter eller bläddra till Experience Cloud ID-tjänsttillägget och välj Install för att installera den.

  4. Använd standardinställningarna för alla konfigurationer.

  5. Välj Save.

Dataelement

Dataelement är byggstenarna för dataordlistan (eller datamappningen). Använd dataelement för att samla in, ordna och leverera data över marknadsförings- och annonseringsteknologier. Du ställer in dataelement i taggen som läser från datalagret och kan användas för att leverera data till Adobe Experience Platform.

Det finns olika typer av dataelement. Du ställer först in ett dataelement för att fånga det sidnamn som personer tittar på på din webbplats.

Så här definierar du ett dataelement för sidnamn:

  1. Välj Data Elements till vänster.

  2. Välj Add Data Element.

  3. I Create Data Element dialog:

    • Ge dataelementet ett namn, till exempel Page Name.

    • Välj Core från Extension lista.

    • Välj Page Info från Data Element Type lista.

    • Välj Title från Attribute lista.

      Skapa datumelement med sidinformation

      Du kan till exempel ha använt värdet från en variabel i datalagret pageName och JavaScript Variable dataelementtyp för att definiera dataelementet.

      Skapa dataelement med JavaScript-variabel

    • Välj Save.

Nu vill du ställa in ett dataelement som refererar till det Experience Cloud-ID som automatiskt tillhandahålls av Adobe Experience Platform Web SDK och som är tillgängligt via tillägget Experience Cloud ID-tjänst.

Så här definierar du ett ECID-dataelement:

  1. Välj Data Elements till vänster.

  2. Välj Add Data Element.

  3. I Create Data Element dialog:

    • Ge dataelementet ett namn, till exempel ECID.

    • Välj Experience Cloud ID Service från Extension lista.

    • Välj ECID från Data Element Type lista.

      ECID-dataelement

    • Välj Save.

Slutligen vill du nu mappa något av dina specifika dataelement till det schema du definierade tidigare. Du definierar ett annat dataelement som tillhandahåller en representation av XDM-schemat.

Så här definierar du ett XDM-objektdataelement:

  1. Välj Data Elements till vänster.

  2. Välj Add Data Element.

  3. I Create Data Element dialog:

    • Ge dataelementet ett namn, till exempel XDM - Page View.

    • Välj Adobe Experience Platform Web SDK från Extension lista.

    • Välj XDM Object från Data Element Type lista.

    • Välj din sandlåda i Sandbox lista.

    • Välj ditt schema från Schema lista.

    • Mappa identification > core > ecid -attribut, som definieras i ditt schema, till ECID-dataelementet. Välj cylinderikonen för att enkelt välja ECID-dataelementet från listan med dataelement.

      Välj ECID-dataelement

      Mappa ECID-dataelement

    • Mappa web > webPageDetails > name -attribut, som definieras i ditt schema, till dataelementet Sidnamn.

      Mappa dataelement för sidnamn

    • Välj Save.

Regler

Taggar i Adobe Experience Platform följer ett regelbaserat system. De letar efter användarinteraktion och tillhörande data. När villkoren som beskrivs i reglerna är uppfyllda utlöser regeln det tillägg, skript eller den klientkod som du identifierade. Du kan använda regler för att skicka data (som ett XDM-objekt) till Adobe Experience Platform med tillägget Adobe Experience Platform Web SDK.

Så här definierar du en regel:

  1. Välj Rules till vänster.

  2. Välj Create New Rule.

  3. I Create Rule dialog:

    • Namnge regeln, till exempel Page View.

    • Välj + Add under Events.

    • I Event Configuration dialog:

      • Välj Core från Extension lista.

      • Välj Window Loaded från Event Type lista.

        Regel - händelsekonfiguration

      • Välj Keep Changes.

    • Välj + Add under Actions.

    • I Action Configuration dialog:

      • Välj Adobe Experience Platform Web SDK från Extension lista.

      • Välj Send Event från Action Type lista.

      • Välj web.webpagedetails.pageViews från Type lista.

      • Markera cylinderikonen bredvid XDM data och välj XDM - Page View från listan med dataelement.

      Regel - åtgärdskonfiguration

      • Välj Keep Changes.
    • Regeln ska se ut så här:

      Skapa regel

    • Välj Save.

Ovanstående är bara ett exempel på en regel som skickar XDM-data, som innehåller värden från andra dataelement, till Adobe Experience Platform.

Du kan använda regler på olika sätt i taggen för att hantera variabler (med dataelementen).

Se Regler för mer information.

Skapa och publicera taggen

När du har definierat dataelement och regler måste du skapa och publicera taggen. När du skapar en biblioteksversion måste du tilldela den till en miljö. Byggnadens tillägg, regler och dataelement kompileras sedan och placeras i den tilldelade miljön. Varje miljö har en unik inbäddningskod som gör att du kan integrera den tilldelade inbäddningen på din plats.

Så här skapar och publicerar du en tagg:

  1. Välj Publishing Flow från den vänstra listen.

  2. Välj Select a working library, följt av Add Library….

  3. I Create Library dialog:

    • Namnge biblioteket.

    • Välj Development (development) från Environment lista.

    • Välj + Add All Changed Resources.

      Publicera - Skapa bibliotek

    • Välj Save & Build to Development.

    Taggen sparas och byggs för din utvecklingsmiljö. En grön punkt visar att taggen har skapats på utvecklingsmiljön.

  4. Du kan välja för att återskapa biblioteket eller flytta biblioteket till en staging- eller produktionsmiljö.

    Publicera - Bygg bibliotek

Adobe Experience Platform Tags stöder enkla till komplexa publiceringsarbetsflöden som passar din användning av Adobe Experience Platform Web SDK.

Se Översikt över publicering för mer information.

Hämta din taggkod

Slutligen måste du installera taggen på den webbplats som du vill spåra, vilket innebär att du måste placera koden i rubriktaggen för webbplatsens mall.

Så här hämtar du koden som refererar till din tagg:

  1. Välj Environments till vänster.

  2. Välj rätt installationsknapp i listan över miljöer.

    I Web Install Instructions markerar du kopieringsknappen bredvid skriptkoden som ska se ut så här:

    code language-none
    <script src="https://assets.adobedtm.com/2a518741ab24/.../launch-...-development.min.js" async></script>>
    

    Miljö

  3. Välj Close.

I stället för koden för utvecklingsmiljön kan du ha valt en annan miljö (staging, production) baserat på var du håller på att distribuera Adobe Experience Platform Web SDK.

Se Miljö för mer information.

Distribuera och validera

Nu kan du distribuera koden till utvecklingsversionen av webbplatsen inifrån <head> -tagg. När webbplatsen distribueras börjar den samla in data till Adobe Experience Platform.

Validera implementeringen, korrigera den där det behövs och installera den sedan korrekt i din staging- och produktionsmiljö med publiceringsarbetsflödesfunktionen i Tags.

Konfigurera en anslutning

Om du vill använda Adobe Experience Platform-data i Customer Journey Analytics skapar du en anslutning som innehåller de data som är resultatet av konfigurationen av ditt schema, din datauppsättning och ditt arbetsflöde.

Med en anslutning kan du integrera datauppsättningar från Adobe Experience Platform i Workspace. För att kunna rapportera om dessa datauppsättningar måste du först skapa en anslutning mellan datauppsättningar i Adobe Experience Platform och Workspace.

Så här skapar du en anslutning:

  1. I användargränssnittet för Customer Journey Analytics väljer du Connections i den övre navigeringen.

  2. Välj Create new connection.

  3. I Untitled connection skärm:

    Namnge och beskriva anslutningen i Connection Settings.

    Välj rätt sandlåda i dialogrutan Sandbox lista i Data settings och välj antalet dagliga händelser i dialogrutan Average number of daily events lista.

    Anslutningsinställningar

    Välj Add datasets.

    I Select datasets stega in Add datasets:

    • Välj den datauppsättning som du skapade tidigare (Example dataset) och andra datauppsättningar som du vill inkludera i anslutningen.

      Lägg till datauppsättningar

    • Välj Next.

    I Datasets settings stega in Add datasets:

    • För varje datauppsättning:

      • Välj en Person ID från de tillgängliga identiteter som definieras i datauppsättningsscheman i Adobe Experience Platform.

      • Välj rätt datakälla på menyn Data source type lista. Om du anger Other lägger du sedan till en beskrivning av datakällan.

      • Ange Import all new data och Dataset backfill existing data enligt dina önskemål.

      Konfigurera datauppsättningar

    • Välj Add datasets.

    Välj Save.

Se Anslutningar - översikt för mer information om hur du skapar och hanterar en anslutning och hur du väljer och kombinerar datauppsättningar.

Konfigurera en datavy

En datavy är en behållare som är specifik för Customer Journey Analytics och som gör att du kan avgöra hur data från en anslutning ska tolkas. Här anges alla mått och mätvärden som är tillgängliga i Analysis Workspace och vilka kolumner som måtten och mätvärdena hämtar data från. Datavyer definieras som förberedelser för rapportering i Analysis Workspace.

Så här skapar du en datavy:

  1. I användargränssnittet för Customer Journey Analytics väljer du Data views i den övre navigeringen.

  2. Välj Create new data view.

  3. I Configure steg:

    Välj din anslutning på menyn Connection lista.

    Namn och (eventuellt) beskrivning av anslutningen.

    Konfigurera datavy

    Välj Save and continue.

  4. I Components steg:

    Lägg till alla schemafält och/eller standardkomponenter som du vill inkludera i METRICS eller DIMENSIONS komponentrutor.

    Datavy-komponenter

    Välj Save and continue.

  5. I Settings steg:

    Inställningar för datavy

    Låt inställningarna vara som de är och välj Save and finish.

Se Översikt över datavyer för mer information om hur du skapar och redigerar en datavy, vilka komponenter som är tillgängliga för dig och hur du använder filter- och sessionsinställningar.

Konfigurera ett projekt

Analysis Workspace är ett flexibelt webbläsarverktyg som gör att du snabbt kan skapa analyser och dela insikter baserat på dina data. Du använder Workspace-projekt för att kombinera datakomponenter, tabeller och visualiseringar för att skapa analyser och dela dem med vem som helst i organisationen.

Så här skapar du ditt projekt:

  1. I användargränssnittet för Customer Journey Analytics väljer du Projects i den övre navigeringen.

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

  3. Välj Create project.

    Arbetsyteprojekt

    Välj Blank project.

    Arbetsyta - Tomt projekt

  4. Välj datavyn i listan.

    Vyn Välj data på arbetsytan .

  5. Om du vill skapa din första rapport börjar du dra och släppa dimensioner och mätvärden på Freeform table i Panel. Dra som ett exempel Program Points Balance och Page View som mått och email som en dimension för att få en snabb översikt över profiler som har besökt er webbplats och som ingår i lojalitetsprogrammet som samlar in förmånspoäng.

    Arbetsyta - första rapporten

Se Analysis Workspace - översikt om du vill ha mer information om hur du skapar projekt och bygger din analys med hjälp av komponenter, visualiseringar och paneler.

SUCCESS
Du har slutfört alla steg. Börja med att definiera vilka data du vill samla in (schema) och var de ska lagras (datauppsättning) i Adobe Experience Platform. Sedan konfigurerade du en datastream på Edge Network för att säkerställa att data kan vidarebefordras till den datauppsättningen. Sedan definierade och distribuerade du taggen som innehåller tilläggen (Adobe Experience Platform Web SDK, Experience Cloud ID Service), dataelement och regler för att hämta data från webbplatsen och skicka dessa data till din datastam. Du har definierat en anslutning i Customer Journey Analytics för att använda data för webbplatsspårning och andra data. Med datavyns definition kan ni ange vilken dimension och vilka mätvärden som ska användas och slutligen skapa ert första projekt som visualiserar och analyserar era data.
recommendation-more-help
080e5213-7aa2-40d6-9dba-18945e892f79