at.js, anpassade händelser

Senast uppdaterad: 20 juli 2024
  • Ämnen:

Skapat för:

  • Utvecklare

Information om at.js custom events, som talar om för dig när en mbox-begäran eller ett erbjudande misslyckas eller lyckas.

Historiskt sett har mbox.js (nu föråldrat) inte låtit andra JavaScript-koder som körs på sidan veta vad som händer bakom kulisserna. I och med utvecklingen av at.js hade vi en unik möjlighet att åtgärda det här problemet.

Enligt våra kunder finns det flera scenarier som de vill bli informerade om, bland annat:

  • En mbox-begäran misslyckades på grund av timeout, felaktig statuskod, JSON-tolkningsfel osv.
  • En mbox-begäran lyckades.
  • Det gick inte att återge erbjudandet på grund av att elementet i en omslutningsruta saknas, det går inte att hitta väljaren osv.
  • Återgivningen av erbjudandet lyckades. DOM-ändringar har tillämpats.

Fördefinierade händelser har en struktur som gör att du kan extrahera nödvändiga data baserat på händelsetyp.

För att vara säker på att händelser kan användas i olika scenarier har de anpassade händelserna ett nyttolastobjekt som tilldelas till egenskapen detail för händelseobjektet (som skickas till hanteraren). För att undvika att skicka strängar som händelsenamn visas händelserna som konstanter med namnutrymmet adobe.target.event.

Struktur

NyckelTypBeskrivning
typeSträng

Det finns flera scenarier där du vill bli informerad om hjälp med att spåra, felsöka och anpassa interaktion med at.js.

Varje anpassad händelse i listan nedan har två format: en "konstant" och ett "strängvärde".

  • Konstanter: Prepended with adobe.target.event., presenteras i versaler och innehåller understreck. Om du vill prenumerera på anpassade händelser efter att at.js har lästs in men före mbox-svaret har tagits emot, använder du konstanten.
  • Strängvärden: Gemener och innehåller streck. Använd strängvärdet om du vill prenumerera på anpassade händelser före at.js-inläsningar.

Begäran misslyckades

Konstant: adobe.target.event.REQUEST_FAILED

Strängvärde: at-request-failed

Beskrivning: En mbox-begäran misslyckades på grund av timeout, felaktig statuskod, JSON-tolkningsfel osv.

Begäran lyckades

Konstant: adobe.target.event.REQUEST_SUCCEEDED

Strängvärde: at-request-succeeded

Beskrivning: En mbox-begäran lyckades.

Innehållsåtergivningen misslyckades

Konstant: adobe.target.event.CONTENT_RENDERING_FAILED

Strängvärde: at-content-rendering-failed

Beskrivning: Det gick inte att återge erbjudandet på grund av att elementet i omslutningsrutan saknas, det går inte att hitta väljaren osv.

Innehållsåtergivningen lyckades

Konstant: adobe.target.event.CONTENT_RENDERING_SUCCEEDED

Strängvärde: at-content-rendering-succeeded

Beskrivning: Återgivningen av erbjudandet lyckades. DOM-ändringar har tillämpats.

Biblioteket har lästs in

Konstant: adobe.target.event.LIBRARY_LOADED

Strängvärde: at-library-loaded

Beskrivning: Den här händelsen är idealisk för att spåra när at.js har lästs in helt. Du kan använda den här händelsen för att anpassa den globala mbox-körningen. Du kan också använda den här händelsen för att inaktivera den globala mbox-filen och sedan lyssna efter den här händelsen för att utlösa den globala mbox-filen senare.

Begär start

Konstant: adobe.target.event.REQUEST_START

Strängvärde: at-request-start

Beskrivning: Den här händelsen utlöses innan en HTTP-begäran körs. Du kan använda den här händelsen för prestandamätningar med hjälp av API:t för resurstimer.

Start för innehållsåtergivning

Konstant: adobe.target.event.CONTENT_RENDERING_START

Strängvärde: at-content-rendering-start

Beskrivning: Den här händelsen utlöses innan väljaravsökningen startas och innehållet återges på sidan. Du kan använda den här händelsen för att spåra återgivningsförloppet för innehåll.

Innehållsåtergivning - inga erbjudanden

Konstant: adobe.target.event.CONTENT_RENDERING_NO_OFFERS

Strängvärde: at-content-rendering-no-offers

Beskrivning: Den här händelsen utlöses när inga erbjudanden returneras.

Omdirigering av innehållsåtergivning

Konstant: adobe.target.event.CONTENT_RENDERING_REDIRECT

Strängvärde: at-content-rendering-redirect

Beskrivning: Den här händelsen utlöses när ett erbjudande är en omdirigering och Target omdirigeras till en annan URL.

mboxSträngmbox name
messageSträngInnehåller en beskrivning som kan läsas av människor, t.ex. vad som hände, felmeddelandet.
spårningObjektInnehåller sessionId och deviceId. I vissa fall kan deviceId saknas eftersom Target inte kunde hämta den från edge-servern.
typeSträng

Avvikelsen för enhetsbeslut lyckades

Konstant:

adobe.target.event.ARTIFACT_DOWNLOAD_SUCCEEDED

Strängvärde: artifactDownloadSucceeded

Beskrivning: Anropas när enhetens beslutsartefakt har hämtats.

Det gick inte att tolka felaktigheter på enheten

Konstant: adobe.target.event.ARTIFACT_DOWNLOAD_FAILED

Strängvärde: artifactDownloadFailed

Beskrivning: Anropas när det inte gick att hämta beslutsartefakten på enheten.

Användning

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

Utbildningsvideo: Svarstoken och anpassade at.js-händelser Självstudiemärke

Titta på följande video för att lära dig hur du använder responstoken och anpassade at.js-händelser för att dela profilinformation från Target till tredjepartssystem.

Föregående sidasendNotifications() - at.js 2.1
Nästa sidaFelsöka at.js med Adobe Experience Cloud Debugger

Target