Dokumentation Experience Platform Självstudiekurs om webb-SDK

Konfigurera en egenskap för vidarebefordring av händelser

Last update: Thu Apr 18 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

Ämnen:
Web SDK,Tags,Event Forwarding

Skapat för:

Beginner
Intermediate
Developer

CAUTION

Vi räknar med att kunna publicera viktiga ändringar av den här självstudiekursen tisdagen den 23 april 2024. Därefter kommer många övningar att ändras och du kan behöva starta om självstudiekursen från början för att kunna slutföra alla lektioner.

Lär dig hur du använder händelsevidarebefordringsegenskap med 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:

NOTE

Platform Web SDK och Platform Mobile SDK kräver inte distribution via taggar, men du bör använda taggar för att distribuera dessa SDK:er.

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örutsättningar

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. (tum Admin Console, under Adobe Experience Platform Launch-produkten, behörigheter förPlatforms > Edge och alla Property Rights). När du fått det bör 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:
- Inledande konfiguration
- Märkordskonfiguration

Skapa en egenskap för vidarebefordring av händelser

Börja med att skapa en händelsevidarebefordringsegenskap:

Öppna Gränssnitt för datainsamling
Välj Event Forwarding från vänster navigering
Välj New Property.
Namnge egenskapen. I detta fall Server-Side - Web SDK Course
Välj Save.

Konfigurera datastream

För att händelsevidarebefordran ska kunna använda data som du skickar till Edge-nätverket 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 Datainsamling gränssnitt
Välj Datastreams
Markera tidigare skapade Luma Web SDK datastream
Välj Add Service
Välj Event Forwarding som Service
Under 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

Under Environment ID väljer du den taggmiljö som du länkar händelsens vidarebefordringsmiljö till, i det här fallet Development

note tip
TIP
Om du vill skicka data till en händelsevidarebefordringsmiljö utanför Adobe-organisationen väljer du Manually enter IDs och klistra 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 ställer in ett dataelement för vidarebefordran av händelser, konfigurerar en regel för vidarebefordring av händelser och validerar med ett tredjedelsverktyg som kallas Webkrok.webbplats.

NOTE

En webkrok är ett sätt att integrera olika system i halvrealtid. Webkrok.webbplats är ett verktyg från tredje part som gör att du enkelt kan inspektera, testa och automatisera (med den visuella funktionen Custom Actions Builder, eller WebScript) inkommande HTTP-begäran eller e-post.

IMPORTANT

Du måste redan ha skapat och mappat dataelement till ett XDM-objekt, samt konfigurerade taggregler och byggt dessa ändringar i ett bibliotek till en taggmiljö för att kunna fortsätta. Om du inte har det, se Märkordskonfiguration steg i krav -avsnitt. Dessa steg säkerställer att data skickas till Platform Edge Network, och därifrån kan du konfigurera en händelsevidarebefordringsegenskap för att vidarebefordra data till en icke-Adobe-lösning.

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.

IMPORTANT

Det finns en viktig syntaxskillnad när XDM-fält refereras i händelsevidarebefordran jämfört med andra kontexter. Om du vill referera till data i en händelsevidarebefordringsegenskap måste dataelementets sökväg innehålla arc.event prefix:

arc står för Adobe Response Context.
Till exempel: arc.event.xdm.web.webPageDetails.URL

Om den här sökvägen anges felaktigt samlas inga data in.

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 skapas under Konfigurera ett XDM-schema lektion.

TIP

Du kan också hitta sökvägen till XDM-objektet med hjälp av webbläsarens nätverksverktyg, filtrera efter /ee förfrågningar, öppna fyren Nyttolast och går ned till den variabel du letar 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 Event Forwarding egenskap som du nyss skapade
Välj Data Elements
Välj till Create New Data Element
Name dataelementet environment.browserDetails.viewportHeight
Under Extension, lämna CORE
Under Data Element Type, markera Path
Ange den XDM-objektsökväg som innehåller höjden för webbläsarvisningsrutan arc.event.xdm.environment.browserDetails.viewportHeight
Välj Save
Skapa ett annat dataelement
Name it ecid
Under Extension, lämna CORE
Under Data Element Type, markera Path
Ange sökvägen till XDM-objektet som innehåller Experience Cloud-ID:t arc.event.xdm.identityMap.ECID.0.id

Välj Save

ECID-sökväg för händelsevidarebefordran

note caution
CAUTION
Se till att inkludera `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 `/ee` förfrågningar, öppna fyren Nyttolast och går ned till den variabel du letar efter. 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 Adobe Cloud Connector tillägg.

Välj Extensions till vänster navigering
Välj Catalog tab
Sök efter Adobe Cloud Connector, markera 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 varje händelse som skickas till Platform Edge Network utlöser vidarebefordran av data. Det finns därför inga Events som måste väljas i regler 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.
Tokenisering av dataelement:
- Taggar: Dataelementnamn tokeniseras med en % i början och slutet av dataelementnamnet när det används i en regel. Till exempel: %viewportHeight%.
- Vidarebefordran av händelser: Dataelementnamn tokeniseras med {{ i början och }} i slutet av dataelementnamnet när det används i en regel. Till 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.webbplats
Sök Din unika URL kommer du att använda detta som URL-begäran i regeln 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 ett namn all events - ad cloud connector - webhook
Lägg till en åtgärd
Under Extension, markera Adobe Cloud Connector
Under Action Type, markera Make Fetch Call
Klistra in webkroks-URL:en i URL fält
Under [Frågeparametrar] lägger du till båda dataelementen som du skapade tidigare.
På Key kolumntyp i viewPortHeight. På Value kolumn, ange {{environment.browserDetails.viewportHeight}} dataelement genom att antingen skriva in det eller välja det från väljarikonen för dataelement
Välj + Lägg till ytterligare för att lägga till ytterligare en frågeparameter
På Key kolumntyp i ecid. I kolumnen Värde anger du {{ecid}} dataelement
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.

NOTE

Om du inte har länkat egenskaperna för vidarebefordran av mellanlagrings- och produktionshändelser till ditt datastam, kommer du att se Utvecklingsmiljö som det enda alternativet att skapa ett bibliotek till.

Spara regel för vidarebefordran av händelse

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 taggbibliotek på Luma Demo-webbplats till Web SDK-taggegenskapen som du mappade till för händelsevidarebefordran i datastream.
Innan du läser in sidan igen öppnar du felsökaren i Experience Platform Logs från vänster navigering
Välj Edge tabbtangenten och sedan välja 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ändigt konstruerade URL:en 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
Slutligen, validera datamatchningarna i Webkrok.webbplats även genom att visa det öppna Webkrok-fönstret

Grattis! Du har konfigurerat vidarebefordran av händelser!

Nästa:

NOTE

Tack för att du lade ned din tid på att lära dig om Adobe Experience Platform Web SDK. Om du har frågor, vill dela allmän feedback eller har förslag på framtida innehåll kan du dela dem om detta Experience League diskussionsinlägg

recommendation-more-help

8cbc0fd8-ca1d-433b-9c3d-bc3f113347d4