Konfigurera händelsevidarebefordran med plattformsdata för Web SDK
Lär dig hur du använder händelsevidarebefordran med Adobe Experience Platform Web SDK-data.
Vidarebefordran av händelser är en ny typ av egenskap som är tillgänglig i datainsamling. Med händelsevidarebefordran kan du skicka data till andra leverantörer än Adobe direkt från Adobe Experience Platform Edge Network istället för till den traditionella webbläsaren på klientsidan. Läs mer om fördelarna med vidarebefordran av händelser i Översikt över vidarebefordran av händelser.
Om du vill använda händelsevidarebefordran i Adobe Experience Platform måste data skickas till Adobe Experience Platform Edge Network först med ett eller flera av följande tre alternativ:
När du är klar med de tidigare lektionerna i den här självstudiekursen bör du skicka data till Platform Edge Network med hjälp av Web SDK. När data finns i Platform Edge Network kan du aktivera vidarebefordran av händelser och använda en händelsevidarebefordringsegenskap för att skicka data till lösningar utanför Adobe.
Utbildningsmål
I slutet av lektionen kan du:
- Skapa en egenskap för vidarebefordring av händelser
- Länka en händelsevidarebefordringsegenskap till ett Platform Web SDK-datalager
- Förstå skillnaderna mellan taggegenskapens dataelement och regler och händelsevidarebefordringens egenskapselement och regler
- Skapa ett dataelement för vidarebefordran av händelser
- Konfigurera en regel för vidarebefordran av händelser
- Verifiera att en händelsevidarebefordringsegenskap har skickat data
Förhandskrav
-
En programlicens som innehåller vidarebefordran av händelser. Vidarebefordran av händelser är en betalfunktion i datainsamling. Kontakta kontoteamet på Adobe för mer information.
-
Vidarebefordran av händelser är aktiverat i din Experience Cloud-organisation.
-
Användarbehörighet för vidarebefordran av händelser. (I Admin Console, under Adobe Experience Platform Launch-produkten, behörighetsobjekt för Platforms > Edge och alla Property Rights). När du har fått det ska du se Event Forwarding i den vänstra navigeringen i gränssnittet för datainsamling:
-
Adobe Experience Platform Web eller Mobile SDK har konfigurerats för att skicka data till Edge Network. Du måste ha gjort följande i den här självstudiekursen:
Skapa en egenskap för vidarebefordring av händelser
Börja med att skapa en händelsevidarebefordringsegenskap:
-
Välj Event Forwarding i den vänstra navigeringen
-
Välj New Property.
-
Namnge egenskapen. I det här fallet
Server-Side - Web SDK Course -
Välj Save.
Konfigurera datastream
För att händelsevidarebefordran ska kunna använda data som du skickar till Platform Edge Network måste du länka den nyligen skapade händelsevidarebefordringsegenskapen till samma dataström som används för att skicka data till Adobe-lösningar.
Så här konfigurerar du Target i datastream:
-
Gå till gränssnittet Datainsamling
-
Välj Datastreams i den vänstra navigeringen
-
Markera den tidigare skapade
Luma Web SDK: Development Environment-datastream
-
Välj Add Service
-
Välj Event Forwarding som Service
-
I listrutan Property ID väljer du namnet som du gav till egenskapen för vidarebefordran av händelser, i det här fallet
Server-Side - Web SDK Course -
I listrutan Environment ID väljer du den taggmiljö som du länkar händelsens vidarebefordringsmiljö till, i det här fallet
Developmentnote tip TIP Om du vill skicka data till en händelsevidarebefordringsmiljö utanför Adobe-organisationen markerar du Manually enter IDs och klistrar in ett ID. ID:t anges när du skapar en händelsevidarebefordringsegenskap. -
Välj Save.
Upprepa dessa steg för staging- och produktionsdatastreams när du är redo att marknadsföra dina ändringar via publiceringsflödet.
Vidarebefordra data från Platform Edge Network till en icke-Adobe-lösning
I den här övningen får du lära dig hur du konfigurerar ett dataelement för vidarebefordran av händelser, konfigurerar en regel för vidarebefordran av händelser och validerar med hjälp av ett tredjedelsverktyg som kallas Webkrok.site.
Skapa ett dataelement för vidarebefordran av händelser
XDM-objektet som du tidigare konfigurerade med plattformens SDK-taggtillägg blir datakällan för dataelement i en händelsevidarebefordringsegenskap. Du använder samma data som du redan har konfigurerat i taggegenskapen som en datakälla för händelsevidarebefordran.
arc.event:arcstår för Adobe Response Context.- Till exempel:
arc.event.xdm.web.webPageDetails.URL
I den här övningen vidarebefordrar du höjden på webbläsarens visningsruta och Experience Cloud-ID från XDM-objektet till en webkrok. Sökvägen till XDM-fältet bestäms av XDM-schemat som skapades under lektionen Konfigurera ett XDM-schema.
/ee-begäranden, öppning av nyttolasten och fördjupning av variabeln du söker efter. Högerklicka sedan med musen och välj Kopiera egenskapssökväg. Här är ett exempel på webbläsarvisningsportens höjd:
-
Gå till egenskapen Event Forwarding som du nyss skapade
-
Välj Data Elements i den vänstra navigeringen
-
Välj till Create New Data Element
-
Name dataelementet
environment.browserDetails.viewportHeight -
Lämna
COREunder Extension -
Under Data Element Type väljer du
Path -
Ange XDM-objektsökvägen som innehåller höjden för webbläsarvisningsrutan
arc.event.xdm.environment.browserDetails.viewportHeight -
Välj Save
-
Skapa ett annat dataelement
-
Name den
ecid -
Lämna
COREunder Extension -
Under Data Element Type väljer du
Path -
Ange sökvägen till XDM-objektet som innehåller Experience Cloud-ID
arc.event.xdm.identityMap.ECID.0.id -
Välj Save
note caution CAUTION Se till att du tar med prefixet arc.event.i sökvägen. Se även till att följa det exakta skiftläget som fältnamnet för XDM-objektet. ECID-namnutrymmet måste vara i versaler.note tip TIP När du arbetar med din egen webbplats kan du hitta XDM-objektsökvägen med webbläsarens nätverksverktyg, filtrera efter /eebegäranden, öppna nyttolasten och gå ned till den variabel du söker. Högerklicka sedan med musen och välj Kopiera egenskapssökväg. Här är ett exempel på webbläsarvisningsportens höjd:
Installera tillägget Adobe Cloud Connector
Om du vill skicka data till tredjepartsplatser måste du först installera tillägget Adobe Cloud Connector.
-
Välj Extensions i den vänstra navigeringen
-
Välj fliken Catalog
-
Sök efter Adobe Cloud Connector, välj Install
Ingen tilläggskonfiguration behövs. Med det här tillägget kan du nu vidarebefordra data till en icke-Adobe-lösning!
Skapa en regel för vidarebefordran av händelser
Det finns några huvudsakliga skillnader mellan att konfigurera regler i en taggegenskap och en regel i en händelsevidarebefordringsegenskap:
-
Events&Conditions:
- Taggar: Alla regler aktiveras av en händelse som måste anges i regeln, till exempel
Library Loaded - Page Top. Villkoren är valfria. - Vidarebefordran av händelser: Det antas att alla händelser som skickas till Platform Edge Network utlöser vidarebefordran av data. Det finns därför inga Events som måste väljas i reglerna för vidarebefordran av händelser. Om du vill hantera vilka händelser som utlöser en regel för vidarebefordran av händelser måste du konfigurera villkoren.
- Taggar: Alla regler aktiveras av en händelse som måste anges i regeln, till exempel
-
Tokenisering av dataelement:
-
Taggar: Dataelementnamn tokeniseras med
%i början och slutet av dataelementnamnet när de används i en regel. Exempel:%viewportHeight%. -
Vidarebefordran av händelser: Dataelementnamn tokeniseras med
{{i början och}}i slutet av dataelementnamnet när de används i en regel. Exempel:{{viewportHeight}}.
-
-
Regelåtgärdssekvens:
- Avsnittet Åtgärder i en regel för vidarebefordran av händelser körs alltid sekventiellt. Kontrollera att åtgärdsordningen är korrekt när du sparar en regel. Den här körningssekvensen kan inte köras asynkront på samma sätt som den kan med taggar.
Om du vill konfigurera en regel för att vidarebefordra data till din webkrok måste du först skaffa din personliga webkrok:
-
Gå till Webkrok.site
-
Sök efter din unika URL, du använder den som URL-begäran i din regel för vidarebefordran av händelser
-
Välj Copy to clipboard
-
Lämna det här fönstret öppet så att du kan validera händelsevidarebefordringsdata i realtid som hämtas av Webkroks
-
Gå tillbaka Data Collection > Event Forwarding > Rules från vänster navigering
-
Välj Create New Rule
-
Ge den namnet
all events - ad cloud connector - webhook -
Lägg till en åtgärd
-
Under Extension väljer du Adobe Cloud Connector
-
Under Action Type väljer du Make Fetch Call
-
Klistra in webkroks-URL i fältet URL
-
Under [Frågeparametrar] lägger du till båda dataelementen som du skapade tidigare.
-
På kolumntypen Key i
viewPortHeight. I kolumnen Value anger du dataelementet{{environment.browserDetails.viewportHeight}}genom att antingen skriva in det eller välja det från dataelementets väljarikon -
Välj + Lägg till ytterligare en om du vill lägga till ytterligare en frågeparameter
-
På kolumntypen Key i
ecid. Ange dataelementet{{ecid}}i kolumnen Värde -
Välj Keep Changes
-
Regeln ska se ut så här nedan
-
Välj Save
Skapa och bygg biblioteket
Skapa ett bibliotek och bygg alla ändringar i utvecklingsmiljön för vidarebefordring av händelser på samma sätt som i en taggegenskap.
Validera regel för vidarebefordran av händelse
Nu kan du validera din egenskap för vidarebefordran av händelser med hjälp av Platform Debugger och Webhook.site:
-
Följ stegen för att växla taggbiblioteket på Luma Demo-webbplatsen till taggegenskapen Web SDK som du mappade din händelsevidarebefordringsegenskap till i datastream.
-
Innan du läser in sidan igen öppnar du Logs från den vänstra navigeringen i felsökaren i Experience Platform
-
Markera fliken Edge och välj sedan Connect för att visa begäran från Platform Edge Network
-
Läs in sidan igen
-
Du kommer att se ytterligare begäranden som ger dig synlighet i de serverförfrågningar som skickas av Platform Edge Network till WebHook
-
Begäran om fokusvalidering är den som visar den fullständiga URL som skickas av Edge-nätverket
-
Anteckna parametrarna för frågesträngarna viewPortHeight och ecid
-
De matchar de data som visas i XDM-objektet
-
Validera datasammanfogningarna i Webkrok.site genom att visa det öppna Webkrocksfönstret
Grattis! Du har konfigurerat vidarebefordran av händelser!