Dokumentation Experience Platform Taggar

Åtgärdstyper

Last update: Mon May 05 2025 00:00:00 GMT+0000 (Coordinated Universal Time)

Ämnen:

Skapat för:

Utvecklare

När du har konfigurerat taggtillägget Adobe Experience Platform Web SDK måste du konfigurera åtgärdstyperna.

Den här sidan beskriver de åtgärdstyper som stöds av Adobe Experience Platform Web SDK-taggtillägget.

Använd förslag apply-propositions

Åtgärdstypen Apply propositions gör att du kan återge utkast i enkelsidiga program utan att öka måtten.

Den här åtgärdstypen är användbar när du arbetar med ensidiga program där delar av sidan återges på nytt, vilket kan innebära att personaliseringar som redan används på sidan skrivs över.

Du kan använda den här åtgärdstypen för olika användningsområden, till exempel:

Återgivningsruta för HTML erbjuder. Förslag som uttryckligen begärts via ett omfång eller en yta från en Send event-åtgärd återges inte automatiskt. Du kan använda åtgärdstypen Apply propositions för att ange för Web SDK var de ska återges genom att ange förslagets metadata.
Återge erbjudandena för en vy i ett ensidigt program. När du återger en vyändringshändelse kan du, om analysdata inte är klara än, använda åtgärden Apply propositions för att återge vyförslagen överst på sidan. Mer information finns i övre och nedre delen av sidhändelser (andra sidvyn - alternativ 2). Ange View name i formuläret om du vill använda det.
Återge förslag. När webbplatsen använder ett ramverk som React för att återge innehåll kan du behöva tillämpa personaliseringen på nytt. I sådana fall kan du använda åtgärdstypen Apply propositions för att göra detta.

Den här åtgärdstypen skickar ingen visningshändelse för återgivna inlägg. Den håller reda på återgivna förslag så att de kan inkluderas i efterföljande Send event anrop.

Gränssnittet för Experience Platform-taggar visar åtgärdstypen Använd förslag.

Den här åtgärdstypen stöder följande fält:

Propositions: En array med objekt som du vill återge igen.
View name: Namnet på den vy som ska återges.
Proposition metadata: Ett objekt som avgör hur HTML kan användas. Du kan ange den här informationen antingen via formuläret eller via ett dataelement. Den innehåller följande egenskaper:
- Scope
- Selector
- Action type

Använd svar apply-response

Använd åtgärdstypen Apply response när du vill utföra olika åtgärder baserat på ett svar från Edge Network. Den här åtgärdstypen används vanligtvis i hybriddistributioner där servern gör ett första anrop till Edge Network. Den här åtgärdstypen tar svaret från det anropet och initierar Web SDK i webbläsaren.

Om du använder den här åtgärdstypen kan klientbelastningstiden för hybridpersonalisering minska.

Bild av Experience Platform användargränssnitt som visar typen Använd svarsåtgärd.

Den här åtgärdstypen stöder följande konfigurationsalternativ:

Instance: Markera den Web SDK-instans som du använder.
Response headers: Markera det dataelement som returnerar ett objekt som innehåller huvudnycklar och värden som returneras från Edge Network-serveranropet.
Response body: Välj det dataelement som returnerar objektet som innehåller JSON-nyttolasten som tillhandahålls av Edge Network-svaret.
Render visual personalization decisions: Aktivera det här alternativet för att automatiskt återge det personaliseringsinnehåll som tillhandahålls av Edge Network och dölja innehållet i förväg för att förhindra flimmer.

Utvärdera regeluppsättningar evaluate-rulesets

Den här åtgärdstypen utlöser utvärdering av regeluppsättning manuellt. Regler returneras av Adobe Journey Optimizer för funktioner som webbläsarmeddelanden.

Bild av Experience Platform användargränssnitt som visar åtgärdsmakrotypen Utvärdera regeluppsättningar för svar.

Den här åtgärdstypen stöder följande alternativ:

Render visual personalization decisions: Aktivera det här alternativet för att återge visuella personaliseringsbeslut för de regeluppsättningsobjekt som matchar.
Decision context: Det här är ett nyckelvärdesschema som används vid utvärdering av Adobe Journey Optimizer-regler för enhetsbeslut. Du kan ange beslutskontexten manuellt eller via ett dataelement.

Hämta Media Analytics Tracker get-media-analytics-tracker

Den här åtgärden används för att hämta det gamla API:t för Media Analytics. När åtgärden konfigureras och ett objektnamn anges, exporteras det gamla Media Analytics-API:t till det fönsterobjektet. Om inget anges exporteras den till window.Media som det aktuella mediets JS-biblioteket gör.

Experience Platform-gränssnittsbild som visar åtgärdstypen Get Media Analytics Tracker.

Omdirigera med identitet redirect-with-identity

Använd den här åtgärdstypen om du vill dela identiteter från den aktuella sidan till andra domäner. Den här åtgärden är utformad för att användas med en click-händelsetyp och ett värdejämförelsevillkor. Mer information om hur du använder den här åtgärdstypen finns i Lägg till identitet i URL med tillägget Web SDK.

Skicka händelse send-event

Skickar en händelse till Experience Platform så att Experience Platform kan samla in de data du skickar och agera på dessa uppgifter. Alla data som du vill skicka kan skickas i fältet XDM Data. Använd ett JSON-objekt som följer strukturen i ditt XDM-schema. Det här objektet kan antingen skapas på sidan eller via en Custom Code Data Element.

Åtgärdstypen Send Event stöder de fält och inställningar som beskrivs nedan. Dessa fält är alla valfria.

Instansinställningar instance

Använd väljaren Instance för att välja den Web SDK-instans som du vill konfigurera. Om du bara har en instans är den förvald.

Användargränssnittsbild för Experience Platform-taggar visar instansinställningarna för åtgärdstypen Skicka händelse.

Instance: Välj den Web SDK-instans som du vill konfigurera. Om du bara har en instans är den förmarkerad.

Use guided events: Aktivera det här alternativet för att automatiskt fylla i eller dölja vissa fält för att aktivera ett visst användningsfall. Om du aktiverar det här alternativet visas följande inställningar.

Request personalization: Den här händelsen ska anropas överst på sidan. När den här händelsen är markerad anges följande fält:
- Type: Decisioning Proposition Fetch
- Automatically send a display event: false
- Aktivera alternativet Render visual personalization decisions om du vill att personaliseringen ska återges automatiskt i det här fallet.
Collect analytics: Den här händelsen ska anropas längst ned på sidan. När den här händelsen är markerad anges följande fält:
- Include rendered propositions: true
- Inställningarna för Personalization är dolda

note note
NOTE
De guidade händelserna är relaterade till övre och nedre delen av sidhändelser.

Data data

Användargränssnittsbild för Experience Platform-taggar visar dataelementinställningarna för åtgärdstypen Skicka händelse.

Type: I det här fältet kan du ange en händelsetyp som ska registreras i XDM-schemat. Mer information finns i type i kommandot sendEvent.
XDM:
Data: Använd det här fältet för att skicka data som inte matchar ett XDM-schema. Det här fältet är användbart om du försöker uppdatera en Adobe Target-profil eller skicka attribut för målrekommendationer. Mer information finns i data i kommandot sendEvent.
Include rendered propositions: Aktivera det här alternativet om du vill inkludera alla förslag som har återgetts, men ingen visningshändelse har skickats. Använd detta tillsammans med Automatically send a display event inaktiverat. Den här inställningen uppdaterar XDM-fältet _experience.decisioning med information om de renderade förslagen.
Document will unload: Aktivera det här alternativet för att se till att händelserna når servern även om användaren navigerar bort från sidan. Detta gör att händelser kan nå servern, men svaren ignoreras.
Merge ID: Det här fältet är inaktuellt. Detta fyller i XDM-fältet eventMergeId.

Personalisering personalization

Användargränssnittsbild för Experience Platform-taggar visar Personalization-inställningarna för åtgärdstypen Skicka händelse.

Scopes: Välj de omfattningar (Adobe Target mboxes) som du vill begära explicit från personalisering. Du kan ange omfattningarna manuellt eller genom att ange ett dataelement.
Surfaces: Ange de webbytor som är tillgängliga på sidan för personalisering. Mer information finns i Adobe Journey Optimizer-dokumentationen.
Återge beslut om visuell anpassning: Om du vill återge anpassat innehåll på sidan markerar du kryssrutan Render visual personalization decisions . Du kan också ange beslutsomfattningar och/eller ytor om det behövs. Mer information om återgivning av anpassat innehåll finns i anpassningsdokumentationen.
Request default personalization: Använd det här avsnittet för att kontrollera om det sidomfattande omfånget (global mbox) och standardytan (web surface based on current URL) efterfrågas. Som standard begärs detta automatiskt under det första sendEvent anropet av sidinläsningen. Du kan välja mellan följande alternativ:
- Automatic: Detta är standardbeteendet. Begär endast standardanpassning när den ännu inte har begärts. Detta motsvarar requestDefaultPersonalization som inte har angetts i Web SDK-kommandot.
- Enabled: Begär sidomfånget och standardytan explicit. Detta uppdaterar SPA-vycachen. Detta motsvarar requestDefaultPersonalization inställt på true.
- Disabled: Undertrycker explicit begäran för sidomfånget och standardytan. Detta motsvarar requestDefaultPersonalization inställt på false.
Decision context: Det här är ett nyckelvärdesschema som används vid utvärdering av Adobe Journey Optimizer-regler för enhetsbeslut. Du kan ange beslutskontexten manuellt eller via ett dataelement.

Åsidosättningar av dataströmskonfiguration datastream-overrides

Med åsidosättningar av dataströmmar kan du definiera ytterligare konfigurationer för dina dataströmmar, som skickas till Edge Network via Web SDK.

Detta hjälper dig att utlösa andra datastream-beteenden än standardbeteendena, utan att du behöver skapa ett nytt datastream eller ändra dina befintliga inställningar. Mer information finns i dokumentationen om hur du konfigurerar datastream-åsidosättningar.

Skicka mediahändelse send-media-event

Skickar en mediehändelse till Adobe Experience Platform och/eller Adobe Analytics. Den här åtgärden är användbar när du spårar mediahändelser på webbplatsen. Markera en instans (om du har fler än en). Åtgärden kräver en playerId som representerar en unik identifierare för en spårad mediesession. Det kräver också ett Quality of Experience- och playhead-dataelement när en mediesession startas.

Experience Platform-gränssnittsbild som visar skärmen för att skicka mediahändelser.

Åtgärdstypen Send media event stöder följande egenskaper:

Instance: Den Web SDK-instans som används.
Media Event Type: Den typ av mediahändelse som spåras.
Player ID: Unik identifierare för mediesessionen.
Playhead: Medieuppspelningens aktuella position i sekunder.
Media session details: När du skickar en mediesändningshändelse måste du ange nödvändig information om mediesessionen.
Chapter details: I det här avsnittet kan du ange kapitelinformation när du skickar en kapitelmediahändelse.
Advertising details: När du skickar en AdBreakStart -händelse måste du ange nödvändig annonsinformation.
Advertising pod details: Information om annonseringsområdet när en AdStart -händelse skickas.
Error details: Information om det uppspelningsfel som spåras.
State Update Details: Det spelartillstånd som uppdateras.
Custom Metadata: Anpassade metadata om mediahändelsen som spåras.
Quality of Experience: Mediekvaliteten för upplevelsedata som spåras.

När du har fått ditt samtycke från din användare måste du meddela Adobe Experience Platform Web SDK detta samtycke med hjälp av åtgärden "Ange samtycke". För närvarande stöds två typer av standarder:"Adobe" och"IAB TCF". Se Supporting Customer Consent Preferences. När du använder Adobe version 2.0 stöds bara ett dataelementvärde. Du måste skapa ett dataelement som matchar det godkända objektet.

I den här åtgärden får du även ett valfritt fält där du kan inkludera en identitetskarta så att identiteter kan synkroniseras när du har fått ditt samtycke. Synkronisering är användbart när medgivandet har konfigurerats som Väntande eller Ut eftersom det är sannolikt det första anropet som utlöses.

Uppdatera variabel update-variable

Använd den här åtgärden om du vill ändra ett XDM-objekt som ett resultat av en händelse. Den här åtgärden är avsedd att skapa ett objekt som senare kan refereras från en Send event-åtgärd för att spela in händelsens XDM-objekt.

För att kunna använda den här åtgärdstypen måste du ha definierat ett variabel-dataelement. När du väljer ett variabeldataelement att ändra visas en redigerare som liknar redigeraren för XDM-objektets dataelement.

Det XDM-schema som används för redigeraren är det schema som har valts i dataelementet variable. Du kan ange en eller flera egenskaper för objektet genom att klicka på en av egenskaperna i trädet till vänster och sedan ändra värdet till höger. I skärmbilden nedan ställs egenskapen produceradAv in på dataelementet"Producerad av dataelement".

Det finns vissa skillnader mellan redigeraren i uppdateringen av variabelåtgärden och redigeraren i XDM-objektdataelementet. Först har uppdateringsvariabelåtgärden ett rotnivåobjekt med namnet"xdm". Om du klickar på det här objektet kan du ange ett dataelement som ska användas för att ställa in hela objektet. För det andra har åtgärden för att uppdatera variabeln kryssrutor för att rensa data från xdm-objektet. Klicka på en av egenskaperna till vänster och markera sedan kryssrutan till höger för att ta bort värdet. Detta rensar det aktuella värdet innan du anger värden för variabeln.

Nästa steg next-steps

När du har läst den här artikeln bör du ha en bättre förståelse för hur du konfigurerar dina åtgärder. Läs sedan om hur du konfigurerar dina dataelementtyper.

recommendation-more-help

12b4e4a9-5028-4d88-8ce6-64a580811743