Regole

NOTA

Adobe Experience Platform Launch è stato classificato come una suite di tecnologie di raccolta dati in Adobe Experience Platform. Di conseguenza, sono state introdotte diverse modifiche terminologiche nella documentazione del prodotto. Consulta questo documento come riferimento consolidato delle modifiche terminologiche.

I tag in Adobe Experience Platform seguono un sistema basato su regole. Cercano le interazione degli utenti e i relativi dati. Quando i criteri descritti nelle tue regole vengono soddisfatti, la regola attiva l'estensione, lo script o il codice lato client identificato.

Genera le regole per integrare dati e funzionalità di tecnologie marketing e annunci che unificano prodotti diversi in un'unica soluzione.

Struttura delle regole

Eventi (If): la regola deve cercare l'evento. Ciò viene definito scegliendo un evento, eventuali condizioni applicabili ed eventuali eccezioni.

Azioni (Then): gli attivatori si manifestano dopo che gli eventi di una regola si sono verificati e tutte le condizioni sono state soddisfatte. Una regola di tag può attivare tutte le azioni discrete che desideri e controllare l’ordine in cui si verificano tali azioni. Ad esempio, una singola regola per una pagina di ringraziamento per l'e-commerce può attivare gli strumenti di analisi e i tag di terze parti da una singola regola. Non è necessario creare regole separate per ogni estensione o tag.

Puoi aggiungere più tipi di evento. Più eventi sono collegati con un operatore OR, pertanto le condizioni della regola saranno valutate se uno qualsiasi degli eventi viene soddisfatto.

IMPORTANTE

Le modifiche diventano effettive solo dopo la loro pubblicazione.

Eventi e condizioni (if)

Gli eventi con qualsiasi condizione sono la porzione If di una regola.

Se si verifica un evento specificato, vengono valutate le condizioni, quindi vengono eseguite le azioni specificate, se necessario.

  • Eventi: specifica uno o più eventi che devono aver luogo affinché la regola venga attivata. Gli eventi multipli sono collegati da un operatore OR. Uno qualsiasi degli eventi specificati attiva la regola.

  • Condizioni: restringi l’evento configurando eventuali condizioni che devono essere soddisfatte affinché l’evento possa attivare la regola. Un'eccezione è definita come condizione NOT. Condizioni multiple sono collegate da un AND.

Gli eventi disponibili dipendono dalle estensioni installate. Per informazioni sugli eventi nell'estensione Core, consulta Tipi di evento estensione Core.

Azioni (then)

Le azioni sono la parte Then di una regola. Definiscono ciò che si desidera che accada quando la regola viene eseguita. Se quando viene attivato un evento le condizioni restituiscono true come risultato e le eccezioni restituiscono false, le azioni vengono eseguite. Puoi trascinare e rilasciare azioni per ordinarle come desideri.

Creare una regola

Crea una regola specificando le azioni che si verificano se viene soddisfatta una condizione.

  1. Apri la scheda Regole, quindi seleziona Crea nuova regola.

  2. Denomina la regola.

  3. Fai clic sull’icona Aggiungi degli Eventi.

  4. Scegli l’estensione e uno dei tipi di evento disponibili per tale estensione, quindi configura le Impostazioni dell’evento.

    I tipi di evento disponibili dipendono dall’estensione selezionata. Le impostazioni dell’evento variano a seconda del tipo di evento. Alcuni eventi non dispongono di impostazioni da configurare.

    IMPORTANTE

    In una regola lato client, gli elementi dati sono tokenizzati con un simbolo % all’inizio e alla fine del nome. Ad esempio, %viewportHeight%. In una regola per l’inoltro degli eventi, gli elementi dati vengono tokenizzati, con {{ all’inizio e }} alla fine del nome dell’elemento dati. Ad esempio, {{viewportHeight}}.

    Per fare riferimento ai dati provenienti dalla rete Edge, il percorso dell’elemento dati deve essere arc.event._<element>_.

    arc sta per Adobe Response Context (Contesto di risposta Adobe).

    Ad esempio: arc.event.xdm.web.webPageDetails.URL

    IMPORTANTE

    Se il percorso specificato non è corretto, i dati non vengono raccolti.

  5. Imposta il parametro Ordine, quindi seleziona Mantieni modifiche.

    L'ordine predefinito per tutti i componenti della regola è 50. Se vuoi che una di queste venga eseguita prima, impostala con un numero inferiore a 50.

    • L'ordine dell'esecuzione equivale all'ordine dei numeri. 1 precede 3. 3 precede 10. 10 viene precede 100 ecc.

    • Le regole che hanno lo stesso ordine vengono eseguite senza nessun ordine specifico.

    • Le regole vengono attivate in ordine, ma non necessariamente completate nello stesso ordine. Se la Regola A e la Regola B condividono un evento e assegni l'ordine in modo che la Regola A arrivi per prima, se la Regola A esegue un elemento in modo asincrono, non c'è garanzia che la Regola A termini prima dell'avvio della Regola B.

      Se desideri che venga eseguita in un secondo momento, impostala con un numero maggiore di 50. Per ulteriori informazioni sull'ordinamento, consulta Ordinamento delle regole.

  6. Fai clic sull’icona Aggiungi delle Condizioni, quindi scegli un tipo di logica, un’estensione, un tipo di condizione e configura le impostazioni della condizione. Quindi, seleziona Mantieni modifiche.

    I tipi di condizioni disponibili dipendono dall’estensione selezionata. Le impostazioni delle condizioni variano a seconda del tipo di condizione.

    Tipo di logica:

    • Il tipo di logica Standard consente di eseguire azioni se la condizione viene soddisfatta
    • Il tipo logica Eccezione impedisce l'esecuzione delle azioni se la condizione viene soddisfatta

    (Avanzata) Timeout: questa opzione è disponibile quando la sequenza dei componenti della regola è abilitata sulla proprietà. Questo attributo definisce il tempo massimo consentito per l’esecuzione della condizione. Se viene raggiunto il timeout, la condizione non riesce e il resto delle condizioni e delle azioni della regola verrà rimosso dalla coda di elaborazione. Il valore predefinito è 2000 ms.

    È possibile aggiungere tutte le condizioni desiderate. Più condizioni all’interno della stessa regola sono collegate da AND.

  7. Fai clic sull’icona Aggiungi delle Azioni, quindi scegli l’estensione e uno dei tipi di azione disponibili, configura le impostazioni per l’azione e seleziona Mantieni modifiche.

    I tipi di azioni disponibili dipendono dall’estensione selezionata. Le impostazioni delle azioni variano a seconda del tipo di azione.

    (Avanzata) Wait to run next action (Attendi di eseguire l’azione successiva): questa opzione è disponibile quando la sequenza dei componenti della regola è abilitata sulla proprietà. Se questa opzione è selezionata, i tag non chiameranno l’azione successiva fino al completamento di questa. Se questa opzione è deselezionata, l’azione successiva inizia a essere eseguita immediatamente. Il valore predefinito è Selezionata.

    (Avanzata) Timeout: questa opzione è disponibile quando la sequenza dei componenti della regola è abilitata sulla proprietà. Definisce il tempo massimo consentito per il completamento dell’azione. Se viene raggiunto il timeout, l’azione non riesce e tutte le azioni successive per questa regola verranno rimosse dalla coda di elaborazione. Il valore predefinito è 2000 ms.

  8. Rivedi la regola, quindi seleziona Salva regola.

    Successivamente, quando pubblichi, aggiungi questa regola a una libreria e distribuiscila.

Quando crei o modifichi regole, puoi salvarle e distribuirle nella libreria attiva. In questo modo la tua libreria viene salvata immediatamente e viene eseguita una build. Viene visualizzato lo stato della build.

Ordine regole

L'ordinamento delle regole consente di controllare l'ordine di esecuzione per le regole che condividono un evento.

Spesso è importante attivare le regole in un ordine specifico. Esempi: (1) disponi di diverse regole che impostano le variabili Analytics in modo condizionato e devi accertarti che la regola con Invia Beacon sia attivata per ultima. (2) disponi di una regola che attiva Target e di un'altra regola che attiva Analytics e desideri che la regola Target venga eseguita per prima.

In sostanza, la responsabilità di eseguire azioni in ordine è dello sviluppatore di estensione del tipo di evento in uso. Gli sviluppatori di estensioni Adobe assicurano che le loro estensioni funzionino come previsto. Per le estensioni di terze parti, Adobe fornisce indicazioni agli sviluppatori per consentire loro di implementarle correttamente, ma spetta a loro metterle in pratica.

Adobe consiglia caldamente di ordinare le regole con numeri positivi compresi tra 1 e 100 (il valore predefinito è 50). La semplicità è la scelta migliore. Ricorda che devi mantenere l'ordine che hai stabilito. Tuttavia, Adobe riconosce che ci possono essere casi limite in cui questa potrebbe essere una scelta limitativa, per questo sono concessi anche altri numeri. I tag supportano numeri compresi tra +/- 2.147.483.648. Puoi anche utilizzare una dozzina di decimali, ma se ti trovi in uno scenario in cui hai necessità di farlo, dovresti ripensare ad alcune delle decisioni che hai preso per arrivare al punto in cui ti trovi.

IMPORTANTE

Nella sezione Azione di una regola, le regole lato server vengono eseguite in sequenza. Nel creare la regola è importante accertarsi che l’ordine sia corretto.

Situazioni che potrebbero verificarsi con

  • Cinque regole condividono un evento. Tutte hanno priorità predefinita. Desidero che una di queste venga eseguita per ultima. È sufficiente modificare tale componente della regola e assegnargli un numero maggiore di 50 (ad esempio, 60).
  • Cinque regole condividono un evento. Tutte hanno priorità predefinita. Desidero che una di queste venga eseguita per prima. È sufficiente modificare tale componente della regola e assegnargli un numero inferiore di 50 (ad esempio, 40).

Gestione delle regole lato client

L'ordine di caricamento delle regole dipende dal fatto che l'azione delle regole sia configurata con JavaScript, HTML o altro codice lato client, e che le regole utilizzino un evento fine pagina, principale o un altro tipo di evento.

Puoi utilizzare document.write tra gli script personalizzati indipendentemente dagli eventi configurati per la regola.

Puoi ordinare diversi tipi di codici personalizzati tra loro. Ad esempio, puoi utilizzare un'azione codice personalizzato JavaScript, poi un'azione codice personalizzato HTML, quindi un'azione codice personalizzato JavaScript. I tag assicurano che vengano eseguite in tale ordine.

Raggruppamento delle regole

Gli eventi e le condizioni delle regole sono sempre raggruppati nella libreria principale di tag. Le azioni possono essere raggruppate nella libreria principale o caricate in ritardo come risorse secondarie, a seconda delle necessità. Il fatto che le azioni siano raggruppate o meno è determinato dal tipo di evento della regola.

Regole con eventi “Core - libreria caricata” o “Core - parte superiore della pagina”

Questi eventi devono essere eseguiti quasi sempre (a meno che le condizioni non vengano valutate come false), quindi per maggiore efficienza vengono raggruppati nella libreria principale, il file a cui fa riferimento il codice da incorporare.

  • JavaScript: JavaScript è incorporato nella libreria principale di tag. Lo script personalizzato viene racchiuso in un tag script e scritto nel documento utilizzando document.write. Se la regola dispone di più script personalizzati, questi vengono scritti in ordine.

  • HTML: il codice HTML è incorporato nella libreria principale di tag. document.write viene utilizzato per scrivere il codice HTML nel documento. Se la regola dispone di più script personalizzati, questi vengono scritti in ordine.

Regole con qualsiasi altro evento

Adobe non è in grado di garantire che vengano attivate altre regole e che sia necessario il relativo codice di azione. Per questo motivo, le azioni per tutti i tipi di evento non elencati sopra non vengono incluse nella libreria principale. Vengono invece archiviate come risorse secondarie e a cui fa riferimento la libreria principale quando necessario.

  • JavaScript: il JavaScript viene caricato dal server come testo normale, racchiuso in un tag script e aggiunto al documento utilizzando Postscribe. Se la regola dispone di più script personalizzati JavaScript, questi verranno caricati in parallelo dal server, ma vengono eseguiti nello stesso ordine configurato nella regola.
  • HTML: l’HTML viene caricato dal server e aggiunto al documento utilizzando Postscribe. Se la regola dispone di più script personalizzati HTML, questi verranno caricati in parallelo dal server, ma vengono eseguiti nello stesso ordine configurato nella regola.

Sequenza dei componenti della regola

Il comportamento dell’ambiente runtime dei tag dipende dall’abilitazione o meno di Esegui componenti regola in sequenza per la tua proprietà.

Abilitata

Se l’impostazione è abilitata, quando un evento viene attivato in fase di runtime, le condizioni e le azioni della regola vengono aggiunte a una coda di elaborazione in base all’ordine definito ed elaborate una alla volta in base al FIFO. Il tag attende il completamento del componente prima di passare a quello successivo.

Se una condizione risulta false o raggiunge il timeout definito, le condizioni e le azioni successive della regola vengono rimosse dalla coda.

Se un’azione ha esito negativo o raggiunge il timeout definito, le azioni successive della regola vengono rimosse dalla coda.

NOTA

Con questa impostazione abilitata, tutte le condizioni e le azioni vengono eseguite in modo asincrono, anche se la libreria di tag è stata caricata in modo sincrono.

Disabilitata

Se l’impostazione è disabilitata, quando un evento viene attivato in fase di runtime, le condizioni della regola vengono valutate immediatamente. Più condizioni vengono valutate in parallelo.

Se tutte le condizioni risultano true (e le eccezioni risultano false), le azioni della regola vengono eseguite immediatamente. Le azioni vengono richiamate in ordine, ma i tag non attendono che un’azione sia completata prima di chiamare quella successiva. Se le azioni sono sincronizzate, vengono comunque eseguite in ordine. Se una o più azioni sono asincrone, alcune vengono eseguite in parallelo.

In questa pagina