at.js, aangepaste gebeurtenissen

Laatst bijgewerkt: 27 juli 2023
  • Onderwerpen:

Gemaakt voor:

  • Ontwikkelaar

Informatie over at.js custom events, die u laat weten wanneer een mbox-aanvraag of -aanbieding mislukt of slaagt.

Historisch gezien heeft mbox.js (nu afgekeurd) andere JavaScript-code die op de pagina wordt uitgevoerd, niet laten weten wat er achter de schermen gebeurt. Met de vooruitgang van om.js, hadden wij een unieke kans om deze kwestie op te lossen.

Volgens onze klanten zijn er verschillende scenario's waarvan zij op de hoogte willen worden gesteld, zoals:

  • Een mbox-aanvraag is mislukt als gevolg van een time-out, onjuiste statuscode, JSON-parseringsfout, enz.
  • Een mbox-verzoek is uitgevoerd.
  • Rendering van voorstel is mislukt omdat het element wrapping mbox ontbreekt, de kiezer niet is gevonden, enz.
  • Rendering van aanbieding is gelukt. DOM-wijzigingen zijn toegepast.

Vooraf gedefinieerde gebeurtenissen hebben een structuur waarmee u de vereiste gegevens kunt extraheren op basis van het gebeurtenistype.

Om ervoor te zorgen dat gebeurtenissen in verschillende scenario's kunnen worden gebruikt, hebben de douanegebeurtenissen een ladingsvoorwerp dat aan het detailbezit van het gebeurtenisvoorwerp (dat wordt overgegaan tot de manager) wordt toegewezen. Ook om te voorkomen dat tekenreeksen worden doorgegeven als gebeurtenisnamen, worden de gebeurtenissen als constanten weergegeven met adobe.target.event naamruimte.

Structuur

SleutelTypeBeschrijving
typeString

Er zijn verscheidene scenario's waarin u om in het vinden, het zuiveren, en het aanpassen van interactie met at.js zou willen worden meegedeeld te helpen.

Elke aangepaste gebeurtenis die hieronder wordt vermeld, heeft twee indelingen: een "constante" en een "tekenreekswaarde".

  • Constanten: Voorbereid met adobe.target.event., in kapitalen wordt weergegeven en onderstrepingstekens bevat. Abonneren op aangepaste gebeurtenissen na at.js laadt, maar voor Wanneer de mbox-reactie is ontvangen, gebruikt u de constante.
  • Tekenreekswaarden: Kleine letters en bevatten streepjes. Abonneren op aangepaste gebeurtenissen voor at.js laadt, gebruik de koordwaarde.

Verzoek is mislukt

Constante: adobe.target.event.REQUEST_FAILED

Reekswaarde: at-request-failed

Beschrijving: Een aanvraag voor een box is mislukt als gevolg van een time-out, onjuiste statuscode, JSON-parseringsfout, enz.

Verzoek is uitgevoerd

Constante: adobe.target.event.REQUEST_SUCCEEDED

Tekenreekswaarde: at-request-succeeded

Omschrijving: een postaanvraag is geslaagd.

Renderen van inhoud mislukt

Constante: adobe.target.event.CONTENT_RENDERING_FAILED

Tekenreekswaarde: at-content-rendering-failed

Beschrijving: Rendering van voorstel is mislukt omdat het element wrapping box ontbreekt, de kiezer niet is gevonden, enz.

Renderen van inhoud gelukt

Constante: adobe.target.event.CONTENT_RENDERING_SUCCEEDED

Tekenreekswaarde: at-content-rendering-succeeded

Omschrijving: de rendering van voorstellen is gelukt. DOM-wijzigingen zijn toegepast.

Bibliotheek geladen

Constante: adobe.target.event.LIBRARY_LOADED

Tekenreekswaarde: at-library-loaded

Beschrijving: deze gebeurtenis is ideaal om te volgen wanneer at.js volledig is geladen. Met deze gebeurtenis kunt u de uitvoering van het globale selectievakje aanpassen. U kunt deze gebeurtenis ook gebruiken om de globale mbox onbruikbaar te maken en dan naar deze gebeurtenis te luisteren om globale mbox later te branden.

Verzoek starten

Constante: adobe.target.event.REQUEST_START

Tekenreekswaarde: at-request-start

Beschrijving: deze gebeurtenis wordt geactiveerd voordat een HTTP-aanvraag wordt uitgevoerd. U kunt deze gebeurtenis voor prestatiemetingen gebruiken gebruikend het Middel Timing API.

Begin van weergave van inhoud

Constante: adobe.target.event.CONTENT_RENDERING_START

Tekenreekswaarde: at-content-rendering-start

Beschrijving: deze gebeurtenis wordt geactiveerd voordat de kiezersopiniepeiling wordt gestart en inhoud naar de pagina wordt gerenderd. U kunt deze gebeurtenis gebruiken om de voortgang van de rendering van inhoud bij te houden.

Inhoud renderen geen aanbiedingen

Constante: adobe.target.event.CONTENT_RENDERING_NO_OFFERS

Tekenreekswaarde: at-content-rendering-no-offers

Beschrijving: deze gebeurtenis wordt geactiveerd wanneer er geen voorstellen worden geretourneerd.

Omleiding van weergave van inhoud

Constante: adobe.target.event.CONTENT_RENDERING_REDIRECT

Tekenreekswaarde: at-content-rendering-redirect

Beschrijving: deze gebeurtenis wordt geactiveerd wanneer een aanbieding een omleiding is en Target wordt doorgestuurd naar een andere URL.

mboxStringnaam van mbox
messageStringBevat een beschrijving die leesbaar is voor mensen, zoals wat er is gebeurd, het foutbericht, enzovoort.
bijhoudenObjectBevat de sessionId en deviceId. In sommige gevallen deviceId kan ontbreken omdat Target kan het bestand niet ophalen van de Edge-server.
typeString

Artefact voor apparaatbeslissingen is geslaagd

Constante:

adobe.target.event.ARTIFACT_DOWNLOAD_SUCCEEDED

Reekswaarde: artifactDownloadSucceeded

Beschrijving: Wordt opgeroepen wanneer het doelwit van de beslissing op het apparaat is gedownload.

Artefact voor apparaatbesluitvorming is mislukt

Constante: adobe.target.event.ARTIFACT_DOWNLOAD_FAILED

Tekenreekswaarde: artifactDownloadFailed

Beschrijving: Wordt opgeroepen wanneer het beslissingsartefact op het apparaat niet kan worden gedownload.

Gebruik

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

Trainingsvideo: respontokens en de aangepaste gebeurtenissen at.js Zelfstudie-badge

Bekijk de volgende video om te leren hoe u de Tokens van de Reactie en Aangepaste gebeurtenissen at.js kunt gebruiken om profielgegevens te delen van Target op systemen van derden.

Vorige paginasendNotifications() - at.js 2.1
Volgende paginaFoutopsporing in.js met Adobe Experience Cloud Debugger

Target