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.

Web SDK och händelsevidarebefordringsdiagram

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örhandskrav

Skapa en egenskap för vidarebefordring av händelser

Börja med att skapa en händelsevidarebefordringsegenskap:

  1. Öppna gränssnittet för datainsamling

  2. Välj Event Forwarding i den vänstra navigeringen

  3. Välj New Property.
    Egenskaper för vidarebefordran av händelser

  4. Namnge egenskapen. I det här fallet Server-Side - Web SDK Course

  5. Välj Save.
    spara egenskap för vidarebefordran av händelser

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:

  1. Gå till gränssnittet Datainsamling

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

  3. Markera den tidigare skapade Luma Web SDK: Development Environment-datastream

    Välj Luma Web SDK-datastream

  4. Välj Add Service
    Lägg till en tjänst i datastream

  5. Välj Event Forwarding som Service

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

  7. I listrutan 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 markerar du Manually enter IDs och klistrar in ett ID. ID:t anges när du skapar en händelsevidarebefordringsegenskap.
  8. Välj Save.

    Aktivering av dataström för vidarebefordran av händelse

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.

NOTE
En webkrok är ett sätt att integrera olika system i halvrealtid. Webkrok.site är ett tredjepartsverktyg som gör att du enkelt kan inspektera, testa och automatisera (med den visuella anpassade åtgärdshanteraren eller WebkrockScript) 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 läser du stegen Tagskonfiguration i avsnittet Krav . 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 prefixet arc.event:
  • 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 skapades under lektionen Konfigurera ett XDM-schema.

TIP
Du kan också hitta XDM-objektsökvägen med hjälp av webbläsarens nätverksverktyg, filtrering efter /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:
XDM-sökväg för händelsevidarebefordran
  1. Gå till egenskapen Event Forwarding som du nyss skapade

  2. Välj Data Elements i den vänstra navigeringen

  3. Välj till Create New Data Element

    Händelsevidarebefordran av nytt dataelement

  4. Name dataelementet environment.browserDetails.viewportHeight

  5. Lämna CORE under Extension

  6. Under Data Element Type väljer du Path

  7. Ange XDM-objektsökvägen som innehåller höjden för webbläsarvisningsrutan arc.event.xdm.environment.browserDetails.viewportHeight

  8. Välj Save

    ECID-sökväg för vidarebefordran av händelse

  9. Skapa ett annat dataelement

  10. Name den ecid

  11. Lämna CORE under Extension

  12. Under Data Element Type väljer du Path

  13. Ange sökvägen till XDM-objektet som innehåller Experience Cloud-ID arc.event.xdm.identityMap.ECID.0.id

  14. Välj Save

    ECID-sökväg för vidarebefordran av händelse

    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 /ee begä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:
    XDM-sökväg för händelsevidarebefordran

Installera tillägget Adobe Cloud Connector

Om du vill skicka data till tredjepartsplatser måste du först installera tillägget Adobe Cloud Connector.

  1. Välj Extensions i den vänstra navigeringen

  2. Välj fliken Catalog

  3. Sök efter Adobe Cloud Connector, välj Install

    ECID-sökväg för vidarebefordran av händelse

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.
  • 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:

  1. Gå till Webkrok.site

  2. Sök efter din unika URL, du använder den som URL-begäran i din regel för vidarebefordran av händelser

  3. Välj Copy to clipboard

  4. Lämna det här fönstret öppet så att du kan validera händelsevidarebefordringsdata i realtid som hämtas av Webkroks

    Kopiera webkroks-URL

  5. Gå tillbaka Data Collection > Event Forwarding > Rules från vänster navigering

  6. Välj Create New Rule

    Ny regel för vidarebefordran av händelse

  7. Ge den namnet all events - ad cloud connector - webhook

  8. Lägg till en åtgärd

  9. Under Extension väljer du Adobe Cloud Connector

  10. Under Action Type väljer du Make Fetch Call

  11. Klistra in webkroks-URL i fältet URL

    Kopiera webkroks-URL

  12. Under [Frågeparametrar] lägger du till båda dataelementen som du skapade tidigare.

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

  14. Välj + Lägg till ytterligare en om du vill lägga till ytterligare en frågeparameter

  15. På kolumntypen Key i ecid. Ange dataelementet {{ecid}} i kolumnen Värde

  16. Välj Keep Changes

    Lägg till frågeparameter

  17. Regeln ska se ut så här nedan

  18. Välj Save

    Spara regel för vidarebefordran av händelse

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:

  1. Följ stegen för att växla taggbiblioteketLuma Demo-webbplatsen till taggegenskapen Web SDK som du mappade din händelsevidarebefordringsegenskap till i datastream.

  2. Innan du läser in sidan igen öppnar du Logs från den vänstra navigeringen i felsökaren i Experience Platform

  3. Markera fliken Edge och välj sedan Connect för att visa begäran från Platform Edge Network

    Nätverkssession för klientvidarebefordrare

  4. Läs in sidan igen

  5. Du kommer att se ytterligare begäranden som ger dig synlighet i de serverförfrågningar som skickas av Platform Edge Network till WebHook

  6. Begäran om fokusvalidering är den som visar den fullständiga URL som skickas av Edge-nätverket

    Felsökning för vidarebefordran av händelser

  7. Anteckna parametrarna för frågesträngarna viewPortHeight och ecid

    Verifiera frågesträngar för vidarebefordran av händelse

  8. De matchar de data som visas i XDM-objektet

    Vidarebefordrar matchande data

  9. Validera datasammanfogningarna i Webkrok.site genom att visa det öppna Webkrocksfönstret

    Webbplatsdata för händelsevidarebefordran

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 i det här Experience League-diskussionsinlägget
recommendation-more-help
8cbc0fd8-ca1d-433b-9c3d-bc3f113347d4