Eventi personalizzati at.js

Ultimo aggiornamento: 5 maggio 2025
  • Argomenti:

Creato per:

  • Sviluppatore

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 (ora obsoleto) non ha permesso ad altri codici JavaScript in esecuzione sulla pagina di sapere 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

ChiaveTipoDescrizione
typeStringa

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 del contenuto non riuscito

Costante: adobe.target.event.CONTENT_RENDERING_FAILED

Valore stringa: at-content-rendering-failed

Descrizione: offerta di rendering fallita a causa di elemento mbox di wrapping mancante, selettore che non può essere trovato, ecc.

Rendering del contenuto riuscito

Costante: adobe.target.event.CONTENT_RENDERING_SUCCEEDED

Valore stringa: at-content-rendering-succeeded

Descrizione: l'offerta di rendering ha avuto esito positivo. Sono state applicate modifiche DOM.

Libreria caricata

Costante: adobe.target.event.LIBRARY_LOADED

Valore stringa: at-library-loaded

Descrizione: questo evento è ideale per le attività di monitoraggio quando at.js è stato completamente caricato. È 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.

Avvio richiesta

Costante: adobe.target.event.REQUEST_START

Valore stringa: at-request-start

Descrizione: questo evento viene attivato prima dell'esecuzione di una richiesta HTTP. È possibile utilizzare questo evento per le misurazioni delle prestazioni utilizzando l'API di timing delle risorse.

Avvio rendering del contenuto

Costante: adobe.target.event.CONTENT_RENDERING_START

Valore stringa: at-content-rendering-start

Descrizione: questo evento viene attivato prima dell'avvio del polling del selettore e viene eseguito il rendering del contenuto nella pagina. È possibile utilizzare questo evento per tenere traccia dello stato di rendering del contenuto.

Rendering del contenuto nessuna offerta

Costante: adobe.target.event.CONTENT_RENDERING_NO_OFFERS

Valore stringa: at-content-rendering-no-offers

Descrizione: questo evento viene attivato quando non vengono restituite offerte.

Reindirizzamento del rendering del contenuto

Costante: adobe.target.event.CONTENT_RENDERING_REDIRECT

Valore stringa: at-content-rendering-redirect

Descrizione: questo evento si attiva quando un'offerta è un reindirizzamento e Target reindirizzerà a un URL diverso.

mboxStringaNome Mbox
messageStringaContiene una descrizione leggibile, come l'accaduto, il messaggio di errore, ecc.
trackingOggettoContiene sessionId e deviceId. In alcuni casi, deviceId potrebbe mancare perché Target non è riuscito a recuperarlo dal server Edge.
typeStringa

Artefatto di decisioning sul dispositivo completato

Costante:

adobe.target.event.ARTIFACT_DOWNLOAD_SUCCEEDED

Valore stringa: artifactDownloadSucceeded

Descrizione: chiamato quando l’artefatto del decisioning sul dispositivo viene scaricato correttamente.

Artefatto di decisioning sul dispositivo non riuscito

Costante: adobe.target.event.ARTIFACT_DOWNLOAD_FAILED

Valore stringa: artifactDownloadFailed

Descrizione: chiamato quando non è stato possibile scaricare l’artefatto del decisioning sul dispositivo.

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 Icona esercitazione

Guarda il video seguente per scoprire 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.

Pagina precedentesendNotifications() - at.js 2.1
Pagina successivaEseguire il debug di at.js utilizzando il debugger di Adobe Experience Cloud

Target