Regler

OBSERVERA

Adobe Experience Platform Launch har omklassificerats som en serie datainsamlingstekniker i Adobe Experience Platform. Som ett resultat av detta har flera terminologiska förändringar införts i produktdokumentationen. Se följande dokument för en konsoliderad hänvisning till terminologiska förändringar.

Taggar i Adobe Experience Platform följer ett regelbaserat system. De letar efter användarinteraktion och tillhörande data. När villkoren som beskrivs i reglerna är uppfyllda utlöser regeln det tillägg, skript eller den klientkod som du identifierade.

Bygg regler för att integrera data och funktionalitet i marknadsförings- och annonseringsteknologier som förenar olika produkter i en enda lösning.

Regelstruktur

Händelser (om): Händelsen är vad du vill att regeln ska söka efter. Detta definieras genom att välja en händelse, tillämpliga villkor och eventuella undantag.

Åtgärder (sedan): Utlösare inträffar efter att en regel har inträffat och alla villkor är uppfyllda. En taggregel kan utlösa så många diskreta åtgärder som du vill och du kan styra i vilken ordning åtgärderna utförs. En enskild regel för en e-handelssida - Tack! kan till exempel utlösa analysverktyg och tredjepartstaggar från en enda regel. Du behöver inte skapa separata regler för varje tillägg eller tagg.

Du kan lägga till fler händelsetyper. Flera händelser förenas med en OR, så regelns villkor utvärderas om någon av händelserna uppfylls.

VIKTIGT

Ändringarna börjar inte gälla förrän de är publicerad.

Händelser och villkor (om)

Händelser med alla villkor är If del av en regel.

Om en angiven händelse inträffar utvärderas villkoren och de angivna åtgärderna utförs om det behövs.

  • Händelser: Ange en eller flera händelser som måste äga rum för att aktivera regeln. Flera händelser förenas med en OR. Alla angivna händelser utlöser regeln.

  • Villkor: Begränsa händelsen genom att konfigurera alla villkor som måste vara sanna för att en händelse ska aktivera regeln. Ett undantag definieras som ett NOT-villkor. Flera villkor förenas med en AND.

Vilka händelser som är tillgängliga beror på vilka tillägg som är installerade. Mer information om händelserna i Core-tillägget finns i Huvudtilläggshändelsetyper.

Åtgärder (sedan)

Åtgärderna är Sedan del av en regel. De definierar vad som ska hända när regeln körs. När en händelse aktiveras utförs åtgärderna om villkoren utvärderas till true och undantagen utvärderas till false. Du kan dra och släppa funktionsmakron för att ordna dem som du vill.

Skapa en regel

Skapa en regel genom att ange vilka åtgärder som ska utföras om ett villkor uppfylls.

  1. Öppna Rules tabbtangenten och sedan Create New Rule.

  2. Namnge regeln.

  3. Välj händelser Add ikon.

  4. Välj ditt tillägg och en av de händelsetyper som är tillgängliga för tillägget och konfigurera sedan inställningarna för händelsen.

    Vilka händelsetyper som är tillgängliga beror på vilket tillägg du har valt. Händelseinställningarna skiljer sig åt beroende på händelsetyp. Vissa händelser har inga inställningar som behöver konfigureras.

    VIKTIGT

    I en klientregel tokeniseras dataelement med en % i början och slutet av dataelementnamnet. Exempel, %viewportHeight%. I en regel för vidarebefordran av händelser tokeniseras dataelement med {{ i början och }} i slutet av dataelementnamnet. Exempel, {{viewportHeight}}.

    Om du vill referera till data från Edge-nätverket måste sökvägen till dataelementet vara arc.event._<element>_.

    arc står för Adobe Response Context.

    Exempel: arc.event.xdm.web.webPageDetails.URL

    VIKTIGT

    Om den här sökvägen inte har angetts korrekt samlas inga data in.

  5. Ange parametern Ordning och välj sedan Keep Changes.

    Standardordningen för alla regelkomponenter är 50. Om du vill att en ska köras tidigare, ger du den en siffra som är lägre än 50.

    • Körningsordningen är nummerordning. 1 kommer före 3. 3 kommer före 10. 10 kommer före 100, osv.

    • Regler som har samma ordning körs i ingen speciell ordning.

    • Regler aktiveras i ordning, men avslutas inte nödvändigtvis i samma ordning. Om regel A och regel B delar en händelse och du tilldelar ordning så att regel A kommer först, så finns det ingen garanti för att regel A avslutas innan regel B börjar om regel A gör något asynkront.

      Om du vill att den ska köras senare ger du den ett tal som är högre än 50. Mer information om beställning finns i Regelordning.

  6. Välj villkor Add väljer du sedan en logiktyp, ett tillägg, en villkorstyp och konfigurerar inställningarna för villkoret. Nästa, välj Keep Changes.

    Vilka villkorstyper som är tillgängliga beror på vilket tillägg du har valt. Villkorsinställningarna varierar beroende på villkorstypen.

    Typ av logik:

    • Med en vanlig logiktyp kan åtgärder utföras om villkoret är uppfyllt
    • Undantagslogiktypen förhindrar att åtgärder körs om villkoret uppfylls

    (Avancerat) Tidsgräns: Det här alternativet är tillgängligt när regelkomponentsekvensering är aktiverat på din egenskap. Det här attributet definierar den maximala tid som tillåts för villkoret att köras. Om tidsgränsen nås misslyckas villkoret och resten av regelns villkor och åtgärder tas bort från behandlingskön. Standardvärdet är 2 000 ms.

    Du kan lägga till så många villkor du vill. Flera villkor i samma regel förenas med AND.

  7. Välj funktionsmakron Add -ikonen, välj sedan ditt tillägg och en av de tillgängliga åtgärdstyperna för tillägget, konfigurera inställningarna för åtgärden och välj sedan Keep Changes.

    Vilka åtgärder som är tillgängliga beror på vilket tillägg du har valt. Åtgärdsinställningarna skiljer sig åt beroende på åtgärdstyp.

    (Avancerat) Vänta tills nästa åtgärd körs: Det här alternativet är tillgängligt när regelkomponentsekvensering är aktiverat på din egenskap. När det här alternativet är markerat kommer taggarna inte att anropa nästa åtgärd förrän den här åtgärden har slutförts. När alternativet är avmarkerat börjar nästa åtgärd att utföras omedelbart. Standardvärdet är Checked.

    (Avancerat) Tidsgräns: Det här alternativet är tillgängligt när regelkomponentsekvensering är aktiverat på din egenskap. Den definierar den maximala tiden som åtgärden kan slutföras. Om tidsgränsen nås misslyckas åtgärden och alla efterföljande åtgärder för den här regeln tas bort från arbetskön. Standardvärdet är 2 000 ms.

  8. Granska din regel och välj sedan Save Rule.

    Senare när du publiceralägger du till den här regeln i ett bibliotek och distribuerar den.

När du skapar eller redigerar regler kan du spara och bygga enligt aktivt bibliotek. Ändringen sparas omedelbart i biblioteket och en bygge körs. Byggets status visas.

Regelordning

Med regelordning kan du styra körningsordningen för regler som delar en händelse. Varje regel innehåller ett heltal som bestämmer dess ordningsprioritet (standardvärdet är 50). Regler som innehåller lägre värden för deras ordning körs före regler med högre värden.

Ta en titt på fem regler som alla delar en händelse och som alla har standardprioritet:

  • Om det finns en regel som du vill köra sist kan du redigera den regelkomponenten och ge den ett tal som är högre än 50 (till exempel 60).
  • Om det finns en regel som du vill köra först kan du redigera den regelkomponenten och ge den ett tal som är lägre än 50 (till exempel 40).
OBSERVERA

I slutändan ligger ansvaret för att utföra åtgärder hos den utökade utvecklaren av den händelsetyp som du använder. Adobe-utvecklare ser till att deras tillägg fungerar som de ska. Adobe tillhandahåller vägledning till tredjepartsutvecklare för att göra detta på rätt sätt, men kan inte garantera hur dessa riktlinjer följs.

Vi rekommenderar att du ordnar reglerna med positiva tal mellan 1 och 100 (standardvärdet är 50). Eftersom regelordningen måste upprätthållas manuellt är det bäst att behålla beställningsschemat så enkelt som möjligt. Om det finns kantfall där begränsningen är för begränsad stöder taggarna ordningsnummer mellan +/- 2 147 483 648.

Regelhantering på klientsidan

Inläsningsordningen för regler beror på om regelåtgärden har konfigurerats med JavaScript, HTML eller annan kod på klientsidan, och om reglerna använder en sidhändelse längst ned eller längst upp, eller en annan typ av händelse.

Du kan använda document.write i dina egna skript, oavsett vilka händelser som har konfigurerats för regeln.

Du kan beställa olika anpassade kodtyper tillsammans. Nu kan du till exempel ha en anpassad JavaScript-kodsåtgärd, sedan en anpassad HTML-kodsåtgärd och sedan en anpassad JavaScript-kodsåtgärd. Taggar säkerställer att de körs i den ordningen.

Regelbuntning

Regelhändelser och -villkor paketeras alltid i huvudtaggbiblioteket. Åtgärder kan vid behov paketeras i huvudbiblioteket eller laddas för sent som underresurser. Huruvida åtgärderna paketeras eller inte avgörs av regelns händelsetyp.

Regler med händelserna "Core - Library Loaded" eller "Core - Page Top"

Dessa händelser måste köras nästan alltid (om inte villkoren utvärderas till false), så för att vara effektiva paketeras de i huvudbiblioteket, den fil som din inbäddningskod refererar till.

  • Javascript: JavaScript är inbäddat i huvudtaggbiblioteket. Det anpassade skriptet kapslas i en script-tagg och skrivs till dokumentet med document.write. Om regeln har flera anpassade skript skrivs de i ordning.

  • HTML: HTML är inbäddad i huvudtaggbiblioteket. document.write används för att skriva HTML till dokumentet. Om regeln har flera anpassade skript skrivs de i ordning.

Regler för alla andra händelser

Adobe kan inte garantera att andra regler verkligen kommer att aktiveras och att deras åtgärdskod kommer att behövas. Därför paketeras inte åtgärderna för alla händelsetyper som inte listas ovan i huvudbiblioteket. I stället lagras de som underresurser och refereras av huvudbiblioteket efter behov.

  • JavaScript: JavaScript läses in från servern som vanlig text, omsluts av en script-tagg och läggs till i dokumentet med Postscribe. Om regeln har flera anpassade JavaScript-skript läses de in parallellt från servern, men körs i samma ordning som konfigurerades i regeln.
  • HTML: HTML läses in från servern och läggs till i dokumentet med Postscribe. Om regeln har flera anpassade HTML-skript läses de in parallellt från servern, men körs i samma ordning som konfigurerades i regeln.

Ordna regelkomponenter

Körningsmiljöns beteende beror på om Run rule components in sequence är på eller av för din egendom. Den här inställningen avgör om en regels komponenter kan utvärderas parallellt (asynkront) eller om de måste utvärderas sekventiellt.

VIKTIGT

Den här inställningen avgör bara hur villkor och åtgärder utvärderas inom varje regel, och påverkar inte den sekvens i vilken reglerna körs på din egenskap. Se föregående avsnitt på regelordning om du vill ha mer information om hur du fastställer körningsordningen för flera regler.

I händelsevidarebefordran egenskaper, regelåtgärder utförs alltid sekventiellt och den här inställningen är inte tillgänglig. Kontrollera att ordningen är korrekt när du skapar regeln.

Aktiverad

Om inställningen är aktiverad när en händelse aktiveras vid körning läggs regelns villkor och åtgärder till i en behandlingskö (baserat på den ordning du har definierat) och bearbetas en i taget på FIFO-basis (first in, first out). Regeln väntar på att komponenten ska slutföras innan den går vidare till nästa.

Om ett villkor utvärderas som falskt eller når sin definierade tidsgräns tas regelns efterföljande villkor och åtgärder bort från kön.

Om en åtgärd misslyckas eller når sin definierade tidsgräns tas regelns efterföljande åtgärder bort från kön.

Handikappade

Om det är inaktiverat utvärderas regelns villkor omedelbart när en händelse aktiveras vid körning. Flera villkor utvärderas parallellt.

Om alla villkor returnerar true (och undantagen returnerar false) körs regelns åtgärder omedelbart. Åtgärderna anropas i ordning, men taggarna väntar inte på att en ska slutföras innan nästa anropas. Om dina åtgärder är synkrona körs de fortfarande i rätt ordning. Om en eller flera åtgärder är asynkrona körs vissa åtgärder parallellt.

På denna sida