Tipi di azioni
Dopo aver configurato l'estensione tag Adobe Experience Platform Web SDK, è necessario configurare i tipi di azione.
Questa pagina descrive i tipi di azioni supportati dall'estensione tag Adobe Experience Platform Web SDK.
Applicare le proposte apply-propositions
Il tipo di azione Applica proposte consente di eseguire il rendering delle proposte nelle applicazioni a pagina singola senza incrementare le metriche.
Questo tipo di azione è utile quando si lavora con applicazioni a pagina singola in cui viene eseguito nuovamente il rendering di parti della pagina, sovrascrivendo potenzialmente eventuali personalizzazioni già applicate alla pagina.
Puoi utilizzare questo tipo di azione per vari casi d’uso, ad esempio:
- Rendering offerte mbox HTML. Le proposte esplicitamente richieste tramite un ambito o una superficie da un'azione Invia evento non vengono sottoposte a rendering automaticamente. È possibile utilizzare il tipo di azione Applica proposizioni per indicare a Web SDK dove eseguirne il rendering specificando i metadati della proposta.
- Eseguire il rendering delle offerte per una visualizzazione in un'applicazione a pagina singola. Durante il rendering di un evento di modifica della visualizzazione, se i dati di analisi non sono ancora pronti, puoi utilizzare l'azione Applica proposte per eseguire il rendering delle proposte di visualizzazione nella parte superiore della pagina. Per ulteriori dettagli, vedi eventi di inizio e fine pagina (seconda visualizzazione pagina - opzione 2). Per utilizzare questa proprietà, immettere un Nome visualizzazione nel modulo.
- Riesegui rendering delle proposte. Quando il sito utilizza un framework come React per eseguire nuovamente il rendering del contenuto, potrebbe essere necessario riapplicare la personalizzazione. In questi casi è possibile utilizzare il tipo di azione Applica proposizioni.
Questo tipo di azione non invierà un evento di visualizzazione per le proposte sottoposte a rendering. Tiene traccia delle proposte sottoposte a rendering in modo che possano essere incluse nelle chiamate Invia evento successive.
Questo tipo di azione supporta i campi seguenti:
-
Proposte: array di oggetti delle proposte di cui si desidera eseguire nuovamente il rendering.
-
Nome visualizzazione: nome della visualizzazione da riprodurre.
-
Metadati della proposta: oggetto che determina il modo in cui le offerte HTML possono essere applicate. Puoi fornire queste informazioni tramite il modulo o un elemento dati. Contiene le seguenti proprietà:
- Ambito
- Selettore
- Tipo azione
Applica risposta apply-response
Utilizza il tipo di azione Applica risposta quando desideri eseguire varie azioni in base a una risposta dell'Edge Network. Questo tipo di azione viene in genere utilizzato nelle implementazioni ibride in cui il server effettua una chiamata iniziale all’Edge Network, quindi prende la risposta da tale chiamata e inizializza l’SDK web nel browser.
L’utilizzo di questo tipo di azione può ridurre i tempi di caricamento del client per i casi di utilizzo della personalizzazione ibrida.
Questo tipo di azione supporta le seguenti opzioni di configurazione:
- Istanza: selezionare l'istanza Web SDK in uso.
- Intestazioni di risposta: seleziona l'elemento dati che restituisce un oggetto contenente le chiavi e i valori di intestazione restituiti dalla chiamata al server Edge Network.
- Corpo risposta: seleziona l'elemento dati che restituisce l'oggetto contenente il payload JSON fornito dalla risposta dell'Edge Network.
- Decisioni di personalizzazione visiva: abilita questa opzione per eseguire automaticamente il rendering del contenuto di personalizzazione fornito dall'Edge Network e nascondere anticipatamente il contenuto per evitare sfarfallii.
Valuta set di regole evaluate-rulesets
Questo tipo di azione attiva manualmente la valutazione del set di regole. I set di regole vengono restituiti da Adobe Journey Optimizer per supportare funzioni come i messaggi nel browser.
Questo tipo di azione supporta le seguenti opzioni:
- Decisioni di personalizzazione visiva: abilita questa opzione per eseguire il rendering delle decisioni di personalizzazione visiva per gli elementi del set di regole corrispondenti.
- Contesto della decisione: si tratta di una mappa chiave-valore utilizzata durante la valutazione dei set di regole di Adobe Journey Optimizer per il decisioning sul dispositivo. Puoi fornire il contesto decisionale manualmente o tramite un elemento dati.
Ottieni tracciamento Media Analytics get-media-analytics-tracker
Questa azione viene utilizzata per ottenere l’API legacy di Media Analytics. Quando si configura l’azione e viene fornito il nome di un oggetto, l’API legacy di Media Analytics verrà esportata nell’oggetto finestra in questione. Se non ne viene fornito alcuno, verrà esportato in window.Media
come avviene per la libreria Media JS corrente.
Reindirizza con identità redirect-with-identity
Utilizza questo tipo di azione per condividere le identità dalla pagina corrente ad altri domini. Questa azione è progettata per essere utilizzata con un tipo di evento click e una condizione di confronto dei valori. Per ulteriori informazioni su come utilizzare questo tipo di azione, consulta aggiungere un'identità all'URL tramite l'estensione Web SDK.
Invia evento send-event
Invia un evento ad Experience Platform in modo che Platform possa raccogliere i dati inviati e agire in base a tali informazioni. Tutti i dati che desideri inviare possono essere inviati nel campo Dati XDM. Utilizzare un oggetto JSON conforme alla struttura dello schema XDM. Questo oggetto può essere creato sulla tua pagina o tramite un Codice personalizzato Elemento dati.
Il tipo di azione Invia evento supporta i campi e le impostazioni descritti di seguito. Questi campi sono tutti facoltativi.
Impostazioni delle istanze instance
Utilizza il selettore Istanza per scegliere l'istanza dell'SDK Web che desideri configurare. Se disponi di una sola istanza, questa viene preselezionata.
-
Istanza: selezionare l'istanza dell'SDK Web che si desidera configurare. Se disponi di una sola istanza, questa verrà preselezionata.
-
Utilizza eventi guidati: abilita questa opzione per compilare o nascondere automaticamente alcuni campi per abilitare un particolare caso d'uso. L’attivazione di questa opzione attiva la visualizzazione delle seguenti impostazioni.
-
Richiedi personalizzazione: questo evento deve essere chiamato nella parte superiore della pagina. Quando è selezionato, questo evento imposta i campi seguenti:
- Tipo: Recupero proposta di decisione
- Invia automaticamente un evento di visualizzazione: false
- Per eseguire automaticamente il rendering della personalizzazione in questo caso, abilita l'opzione Esegui rendering delle decisioni di personalizzazione visiva.
-
Raccogli analisi: questo evento deve essere chiamato nella parte inferiore della pagina. Quando è selezionato, questo evento imposta i campi seguenti:
- Includi proposte sottoposte a rendering: true
- Le impostazioni di Personalization sono nascoste
note note NOTE Gli eventi guidati sono correlati a eventi principali e finali della pagina. -
Dati data
- Tipo: questo campo consente di specificare un tipo di evento da registrare nello schema XDM. Per ulteriori informazioni, vedere
type
nel comandosendEvent
. - XDM:
- Dati: utilizzare questo campo per inviare dati che non corrispondono a uno schema XDM. Questo campo è utile se stai tentando di aggiornare un profilo Adobe Target o di inviare gli attributi Recommendations di Target. Per ulteriori informazioni, vedere
data
nel comandosendEvent
. - Includi proposte sottoposte a rendering: abilita questa opzione per includere tutte le proposte sottoposte a rendering, ma non è stato inviato un evento di visualizzazione. Utilizzalo insieme a Invia automaticamente un evento di visualizzazione disabilitato. Questa impostazione aggiorna il campo XDM
_experience.decisioning
con informazioni sulle proposte sottoposte a rendering. - Il documento verrà scaricato: abilitare questa opzione per assicurarsi che gli eventi raggiungano il server anche se l'utente si sposta dalla pagina. Questo consente agli eventi di raggiungere il server, ma le risposte vengono ignorate.
- ID unione: Questo campo è obsoleto. Verrà popolato il campo XDM
eventMergeId
.
Personalizzazione personalization
-
Ambiti: selezionare gli ambiti (Adobe Target mboxes) che si desidera richiedere esplicitamente alla personalizzazione. Puoi immettere gli ambiti manualmente o fornendo un elemento dati.
-
Superfici: imposta le superfici Web disponibili nella pagina per la personalizzazione. Per ulteriori dettagli, consulta la documentazione di Adobe Journey Optimizer.
-
Decisioni di personalizzazione visiva: Se desideri eseguire il rendering di contenuti personalizzati sulla pagina, seleziona la casella di controllo Decisioni di personalizzazione visiva. Se necessario, è inoltre possibile specificare ambiti decisionali e/o superfici. Per ulteriori informazioni sul rendering di contenuti personalizzati, consulta la documentazione sulla personalizzazione.
-
Richiedi personalizzazione predefinita: utilizza questa sezione per controllare se sono richiesti l'ambito a livello di pagina (mbox globale) e la superficie predefinita (superficie Web basata sull'URL corrente). Per impostazione predefinita, questo viene richiesto automaticamente durante la prima chiamata
sendEvent
del caricamento della pagina. Puoi scegliere tra le seguenti opzioni:- Automatico: comportamento predefinito. Richiedi la personalizzazione predefinita solo se non è ancora stata richiesta. Corrisponde a
requestDefaultPersonalization
non impostato nel comando Web SDK. - Abilitato: richiede esplicitamente l'ambito della pagina e la superficie predefinita. Questo aggiorna la cache di visualizzazione SPA. Corrisponde a
requestDefaultPersonalization
impostato sutrue
. - Disabilitato: elimina esplicitamente la richiesta per l'ambito della pagina e la superficie predefinita. Corrisponde a
requestDefaultPersonalization
impostato sufalse
.
- Automatico: comportamento predefinito. Richiedi la personalizzazione predefinita solo se non è ancora stata richiesta. Corrisponde a
-
Contesto della decisione: si tratta di una mappa chiave-valore utilizzata durante la valutazione dei set di regole di Adobe Journey Optimizer per il decisioning sul dispositivo. Puoi fornire il contesto decisionale manualmente o tramite un elemento dati.
Override della configurazione dello stream di dati datastream-overrides
Gli override dello stream di dati consentono di definire configurazioni aggiuntive per gli stream di dati, che vengono passate alla rete Edge tramite il Web SDK.
Questo consente di attivare comportamenti diversi dello stream di dati rispetto a quelli predefiniti, senza creare un nuovo stream di dati o modificare le impostazioni esistenti. Per ulteriori dettagli, consulta la documentazione su configurazione delle sostituzioni dello stream di dati.
Invia evento multimediale send-media-event
Invia un evento multimediale a Adobe Experience Platform e/o Adobe Analytics. Questa azione è utile quando tieni traccia degli eventi multimediali sul sito web. Seleziona un’istanza (se ne hai più di una). L'azione richiede un playerId
che rappresenti un identificatore univoco per una sessione multimediale tracciata. Inoltre, all'avvio di una sessione multimediale, è necessario un elemento dati Quality of Experience e playhead
.
Il tipo di azione Invia evento multimediale supporta le proprietà seguenti:
- Istanza: l'istanza Web SDK in uso.
- Tipo di evento multimediale: il tipo di evento multimediale da tracciare.
- ID lettore: identificatore univoco della sessione multimediale.
- Testina di riproduzione: la posizione corrente della riproduzione multimediale, in secondi.
- Dettagli sessione multimediale: quando si invia un evento di avvio multimediale, è necessario specificare i dettagli richiesti della sessione multimediale.
- Dettagli capitolo: in questa sezione è possibile specificare i dettagli del capitolo quando si invia un evento multimediale di inizio capitolo.
- Dettagli Advertising: quando si invia un evento
AdBreakStart
, è necessario specificare i dettagli pubblicitari richiesti. - Dettagli del pod di Advertising: dettagli sul pod pubblicitario durante l'invio di un evento
AdStart
. - Dettagli errore: dettagli sull'errore di riproduzione che viene tracciato.
- Dettagli aggiornamento stato: lo stato del lettore che viene aggiornato.
- Metadati personalizzati: i metadati personalizzati sull'evento multimediale di cui viene eseguito il tracciamento.
- Qualità dell'esperienza: la qualità dei contenuti multimediali dei dati dell'esperienza che vengono tracciati.
Impostare il consenso set-consent
Dopo aver ricevuto il consenso dell’utente, questo deve essere comunicato a Adobe Experience Platform Web SDK utilizzando il tipo di azione "Imposta consenso". Attualmente sono supportati due tipi di consenso standard: "Adobe" e "IAB-TCF". Consulta Preferenze di supporto per il consenso del cliente. Quando si utilizza Adobe versione 2.0, è supportato solo un valore di elemento dati. Dovrai creare un elemento dati che venga risolto nell’oggetto di consenso.
In questa azione, ti viene fornito anche un campo facoltativo per includere una Identity Map, in modo che le identità possano essere sincronizzate una volta ricevuto il consenso. La sincronizzazione è utile quando il consenso è configurato come "In sospeso" o "Out" perché la chiamata di consenso è probabilmente la prima chiamata da attivare.
Aggiorna variabile update-variable
Utilizza questa azione per modificare un oggetto XDM a seguito di un evento. Questa azione ha lo scopo di creare un oggetto a cui è possibile fare successivamente riferimento da un'azione Invia evento, per registrare l'oggetto XDM dell'evento.
Per utilizzare questo tipo di azione è necessario aver definito un elemento dati variable. Dopo aver scelto un elemento dati variabile da modificare, viene visualizzato un editor simile a quello dell'elemento dati XDM.
Lo schema XDM utilizzato per l'editor è lo schema selezionato nell'elemento dati variable. Puoi impostare una o più proprietà dell'oggetto facendo clic su una delle proprietà nella struttura a sinistra, quindi modificando il valore a destra.Ad esempio, nella schermata seguente, la proprietà productby viene impostata sull'elemento dati "Produced by data element".
Esistono alcune differenze tra l’editor nell’azione aggiorna variabile e l’editor nell’elemento dati dell’oggetto XDM. Innanzitutto, l’azione aggiorna variabile ha un elemento a livello principale etichettato "xdm". Se fai clic su questo elemento, puoi specificare un elemento dati da utilizzare per impostare l’intero oggetto. In secondo luogo, l’azione aggiorna variabile dispone di caselle di controllo per cancellare i dati dall’oggetto xdm. Fai clic su una delle proprietà a sinistra, quindi seleziona la casella di controllo a destra per deselezionare il valore. Questo cancellerà il valore corrente prima di impostare qualsiasi valore sulla variabile.
Passaggi successivi next-steps
Dopo aver letto questo articolo, dovresti conoscere meglio come configurare le azioni. Quindi, leggi come configurare i tipi di elementi dati.