Eventi personalizzati at.js

Informazioni su at.js custom events, che consente di sapere quando una richiesta o un’offerta mbox ha esito negativo o positivo.

Storicamente, mbox.js non ha permesso di sapere ad altri codici JavaScript in esecuzione sulla pagina cosa succede dietro le quinte. Con l'avanzamento di at.js, abbiamo avuto un'occasione unica per risolvere questo problema.

I nostri clienti richiedono di essere informati in diversi scenari, tra cui:

  • Una richiesta mbox non riuscita a causa di timeout, codice di stato errato, errore di analisi JSON, ecc.
  • Una richiesta mbox riuscita.
  • Offerta di rendering fallita a causa di elemento mbox di wrapping mancante, selettore che non può essere trovato, ecc.
  • Offerta di rendering riuscita. Sono state applicate modifiche DOM.

Gli eventi predefiniti hanno una struttura che consente di estrarre i dati necessari, in base al tipo di evento.

Per assicurarti che gli eventi possano essere usati in scenari diversi, gli eventi personalizzati hanno un oggetto payload che viene assegnato alla proprietà di dettaglio dell'oggetto evento (che viene passato al gestore). Anche per evitare di passare stringhe come nomi di eventi, gli eventi sono esposti come costanti usando lo spazio dei nomi adobe.target.event.

Struttura

Chiave Tipo Descrizione
type Stringa Ci sono diversi scenari per cui si desidera ricevere notifica per contribuire a monitorare, eseguire il debug e personalizzare l'interazione con at.js.
Ogni evento personalizzato elencato di seguito contiene due formati: una “costante” e un “valore stringa”.
  • Costanti: aggiunte a adobe.target.event., includono trattini bassi e lettere solo maiuscole. Per abbonarti a eventi personalizzati dopo i carichi di at.js ma prima che la risposta mbox sia stata ricevuta, utilizza la costante.
  • Valori stringa: in minuscolo e contengono trattini. Per abbonarti a eventi personalizzati prima dei carichi at.js, utilizza il valore stringa.
Richiesta non riuscita
Costante: adobe.target.event.REQUEST_FAILED
Valore stringa: at-request-failed
Descrizione: Una richiesta mbox non riuscita a causa di timeout, codice di stato errato, errore di analisi JSON, ecc.
Richiesta riuscita
Costante: adobe.target.event.REQUEST_SUCCEEDED
Valore stringa: at-request-succeeded
Descrizione: una richiesta mbox ha avuto esito positivo.
Rendering contenuto fallito
Costante: adobe.target.event.CONTENT_RENDERING_FAILED
Valore stringa: at-content-rendering-failed
Descrizione: rendering dell’offerta fallito a causa di elemento mbox di wrapping mancante, selettore che non può essere trovato, ecc.
Rendering contenuto riuscito
Costante: adobe.target.event.CONTENT_RENDERING_SUCCEEDED
Valore stringa: at-content-rendering-succeeded
Descrizione: rendering dell’offerta eseguito correttamente. Sono state applicate modifiche DOM.
Libreria caricata
Costante: adobe.target.event.LIBRARY_LOADED
Valore stringa: at-library-loaded
Descrizione: questo evento è ideale per il tracciamento dopo il caricamento completo di at.js. È possibile utilizzare questo evento per personalizzare l'esecuzione della mbox globale. È anche possibile utilizzare questo evento per disattivare la mbox globale e quindi ascoltare l'attivazione della mbox globale da parte dell'evento in un secondo momento.
Inizio richiesta
Costante: adobe.target.event.REQUEST_START
Valore stringa: at-request-start
Descrizione: questo evento si attiva prima dell’esecuzione di una richiesta HTTP. È possibile utilizzare questo evento per le misurazioni delle prestazioni utilizzando l'API di timing delle risorse.
Inizio rendering contenuto
Costante: adobe.target.event.CONTENT_RENDERING_START
Valore stringa: at-content-rendering-start
Descrizione: questo si attiva prima dell’avvio del polling del selettore e dell’esecuzione del rendering del contenuto sulla pagina. È possibile utilizzare questo evento per tenere traccia dello stato di rendering del contenuto.
Rendering contenuto senza offerte
Costante: adobe.target.event.CONTENT_RENDERING_NO_OFFERS
Valore stringa: at-content-rendering-no-offers
Descrizione: questo evento si attiva quando non sono presenti offerte.
Contenuto rendering redirect
Costante: adobe.target.event.CONTENT_RENDERING_REDIRECT
Valore stringa: at-content-rendering-redirect
Descrizione: questo evento si attiva quando un’offerta è un redirect e Target reindirizzerà a un altro URL.
mbox Stringa Nome Mbox
message Stringa Contiene una descrizione leggibile, come l'accaduto, il messaggio di errore, ecc.
tracking Oggetto Contiene sessionId e deviceId. In alcuni casi, deviceId potrebbe mancare perché Target non è riuscito a recuperarlo dal server Edge.
type Stringa Artefatto decisionale su dispositivo
riuscitoConstant:
adobe.target.event.ARTIFACT_DOWNLOAD_SUCCEEDED
Valore stringa: artifactDownloadSucceeded
Descrizione: Chiamata eseguita quando l'artefatto decisionale del dispositivo viene scaricato correttamente.
Artefatto
fallimentareConstant nelle decisioni sul dispositivo: adobe.target.event.ARTIFACT_DOWNLOAD_FAILED
Valore stringa: artifactDownloadFailed
Descrizione: Chiamato quando l'artifact di decisione sul dispositivo non è stato scaricato.

Utilizzo

document.addEventListener(adobe.target.event.REQUEST_SUCCEEDED, function(event) { 
  console.log('Event', event); 
});

Video di formazione: Token di risposta ed eventi personalizzati at. js Badge tutorial

Guarda il video seguente e scopri come utilizzare i token di risposta e gli eventi personalizzati at.js per condividere le informazioni del profilo da Target a sistemi di terze parti.

In questa pagina