at.js, anpassade händelser

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

Tidigare tillät inte mbox.js (nu föråldrat) annan JavaScript-kod som körs på sidan vad som händer bakom scenerna. 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 adobe.target.event namnutrymme.

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: Förväntades med adobe.target.event., visas med versaler och innehåller understreck. Så här prenumererar du på anpassade händelser efter at.js laddas men före Använd konstanten när mbox-svaret har tagits emot.
  • Strängvärden: Gemener och innehåller streck. Så här prenumererar du på anpassade händelser före at.js läses in, använd strängvärdet.

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återgivning 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återgivning 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.

Bibliotek inläst

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 kommer att omdirigeras till en annan URL.

mbox
Sträng
mbox name
message
Sträng
Innehåller en beskrivning som kan läsas av människor, t.ex. vad som hände, felmeddelandet.
spårning
Objekt
Innehåller sessionId och deviceId. I vissa fall deviceId kan saknas eftersom Target det gick inte att hämta den från edge-servern.
type
Sträng

Beslutsartifakt på enheten har slutförts

Konstant:

adobe.target.event.ARTIFACT_DOWNLOAD_SUCCEEDED

Strängvärde: artifactDownloadSucceeded

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

Avvikelsefakt på enheten misslyckades

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: Response Tokens och at.js Custom Events 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 system från tredje part.

recommendation-more-help
6906415f-169c-422b-89d3-7118e147c4e3