Konfigurera en egenskap för vidarebefordring av händelser

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 i stä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:

• Webb-SDK för Adobe Experience Platform
• Adobe Experience Platform Mobile SDK

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 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 vidarebefordran 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örighetsobjekt förPlattformar > Edge och alla Egendomsrättigheter). När du fått det bör du se Vidarebefordran av händelser 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 slutfört följande lektioner i den här självstudiekursen:

  • Inledande konfiguration

    • Konfigurera behörigheter
    • Konfigurera ett XDM-schema
    • Konfigurera ett identitetsnamnutrymme
    • Konfigurera ett datastream

  • Tagginställningar

    • Installera Web SDK-tillägg
    • Skapa dataelement
    • Skapa en taggregel
    • Validera med Adobe Experience Platform debugger

Skapa en egenskap för vidarebefordran av händelser

Börja med att skapa en händelsevidarebefordringsegenskap:

1. Öppna Gränssnitt för datainsamling

2. Välj Vidarebefordran av händelser från vänster navigering

3. Välj Ny egenskap.
   

4. Namnge egenskapen. I detta fall Server-Side - Web SDK Course

5. Välj Spara.
   

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:

1. Gå till Datainsamling gränssnitt

2. Välj Datastreams

3. Markera tidigare skapade Luma Web SDK datastream

   

4. Välj Lägg till tjänst
   

5. Välj Vidarebefordran av händelser som Tjänst

6. Under Egenskaps-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. Under Miljö-ID väljer du den taggmiljö som du länkar händelsens vidarebefordringsmiljö till, i det här fallet Development

   TIPS

   Om du vill skicka data till en händelsevidarebefordringsmiljö utanför Adobe-organisationen väljer du Ange ID manuellt och klistra in ett ID. ID:t anges när du skapar en händelsevidarebefordringsegenskap.

8. Välj Spara.

   

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 lösning som inte är Adobe

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.

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.

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.

1. Gå till Vidarebefordran av händelser egenskap som du nyss skapade

2. Välj Dataelement

3. Välj till Skapa nytt dataelement

   

4. Namn dataelementet environment.browserDetails.viewportHeight

5. Under Tillägg, lämna CORE

6. Under Dataelementtyp, markera Path

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

8. Välj Spara

   

9. Skapa ett annat dataelement

10. Namn it ecid

11. Under Tillägg, lämna CORE

12. Under Dataelementtyp, markera Path

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

14. Välj Spara

    

    FÖRSIKTIGHET

    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.

    TIPS

    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.

1. Välj Tillägg till vänster

2. Välj Katalog tab

3. Sök efter Adobe Cloud Connector, markera Installera

   

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:

• Händelser & Villkor:

  • 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 Händelser 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. 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. 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 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.webbplats

2. Sök Din unika URL kommer du att använda detta som URL-begäran i regeln för vidarebefordran av händelser

3. Välj Kopiera till Urklipp

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

   

5. Gå tillbaka Datainsamling > Vidarebefordran av händelser > Regler från vänster navigering

6. Välj Skapa ny regel

   

7. Ge den ett namn all events - ad cloud connector - webhook

8. Lägg till en åtgärd

9. Under Tillägg, markera Adobe Cloud Connector

10. Under Åtgärdstyp, markera Ring för hämtning

11. Klistra in webkroks-URL:en i URL fält

    

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

13. På Nyckel kolumntyp i viewPortHeight. På Värde kolumn, ange {{environment.browserDetails.viewportHeight}} dataelement genom att antingen skriva in det eller välja det från väljarikonen för dataelement

14. Välj + Lägg till ytterligare för att lägga till ytterligare en frågeparameter

15. På Nyckel kolumntyp i ecid. I kolumnen Värde anger du {{ecid}} dataelement

16. Välj Behåll ändringar

    

17. Regeln ska se ut som nedan

18. Välj Spara

    

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:

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

2. Innan du läser in sidan igen öppnar du felsökaren i Experience Platform Loggar från vänster navigering

3. Välj Edge tabbtangenten och sedan Anslut för att visa förfrågningar om plattforms-Edge-nätverk

   

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ändigt konstruerade URL:en som skickas av Edge-nätverket

   

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

   

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

   

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

Resurser för Business.Adobe.com