Last update: Sat Jul 20 2024 00:00:00 GMT+0000 (Coordinated Universal Time)
Ä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
Nyckel
Typ
Beskrivning
type
Strä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.
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.
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.
Utbildningsvideo: Svarstoken och anpassade at.js-händelser
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.