Documentatie Target Doelontwikkelaarsgids

om.js Veelgestelde Vragen

Laatst bijgewerkt: 5 mei 2025

Onderwerpen:

Gemaakt voor:

Ontwikkelaar

Antwoorden op veelgestelde vragen over de Adobe Target at.js JavaScript-bibliotheek.

Wat zijn de voordelen om at.js tegenover mbox.js te gebruiken?

De bibliotheek at.js vervangt mbox.js. De bibliotheek mbox.js wordt niet meer ondersteund. Voor de meeste mensen biedt at.js echter voordelen ten opzichte van mbox.js.

Het bestand at.js verbetert onder andere de laadtijden voor webimplementaties, verbetert de beveiliging en biedt betere implementatieopties voor toepassingen van één pagina.

In het volgende diagram worden de prestaties bij het laden van een pagina geïllustreerd met mbox.js versus at.js.

(Klik op de afbeelding om deze uit te breiden naar de volledige breedte.)

Paginaprestatiediagram waarin mbox.js wordt vergeleken met at.js

Zoals hierboven is geïllustreerd, is met mbox.js de pagina-inhoud pas na de gebeurtenis Target de vraag is volledig. Wanneer u at.js gebruikt, wordt pagina-inhoud geladen wanneer de Target de vraag wordt in werking gesteld en wacht niet tot de vraag volledig is.

Wat is het effect van at.js en mbox.js op pagina-ladingstijd?

Veel klanten en consultants willen weten wat het effect is van at.js en mbox.js op de laadtijd van de pagina, vooral in de context van nieuwe gebruikers of terugkerende gebruikers. Jammer genoeg, is het moeilijk om concrete aantallen betreffende te meten en te geven hoe te.js of mbox.js pagina-ladingstijd wegens de implementatie van elke klant beïnvloeden.

Als de API voor bezoekers echter aanwezig is op de pagina, Target kan beter begrijpen hoe at.js en mbox.js pagina-lading tijd beïnvloeden.

OPMERKING

De API van de Bezoeker en at.js of mbox.js hebben alleen invloed op de laadtijd van de pagina wanneer u de globale mbox gebruikt (vanwege de body-hide techniek). De regionale mboxes worden niet beïnvloed door de integratie van de Bezoeker API.

De volgende secties beschrijven de opeenvolging van acties voor nieuwe en terugkerende bezoekers:

Nieuwe bezoekers

De bezoeker-API wordt geladen, geparseerd en uitgevoerd.
at.js / mbox.js wordt geladen, geparseerd en uitgevoerd.
Als de optie voor automatisch maken van globale mbox is ingeschakeld, wordt de optie Target JavaScript-bibliotheek:
- Instantieert het object Visitor.
- De Target De bibliotheek probeert om de gegevens van de Bezoeker van het Experience Cloud terug te winnen identiteitskaart
- Omdat deze bezoeker een nieuwe bezoeker is, leidt de bezoeker-API een aanvraag voor een ander domein in op demdex.net.
- Nadat de gegevens van identiteitskaart van de Bezoeker van het Experience Cloud worden teruggewonnen, een verzoek aan Target wordt afgegaan.

Bezoekers terugsturen

De bezoeker-API wordt geladen, geparseerd en uitgevoerd.
at.js / mbox.js wordt geladen, geparseerd en uitgevoerd.
Als de optie voor automatisch maken van globale mbox is ingeschakeld, wordt de optie Target JavaScript-bibliotheek:
- Instantieert het object Visitor.
- De Target De bibliotheek probeert om de gegevens van de Bezoeker van het Experience Cloud terug te winnen identiteitskaart
- De bezoeker-API haalt gegevens op uit cookies.
- Nadat de gegevens van identiteitskaart van de Bezoeker van het Experience Cloud worden teruggewonnen, een verzoek aan Target wordt afgegaan.

OPMERKING

Voor nieuwe bezoekers, wanneer de API voor bezoekers aanwezig is, Target moet over de draad veelvoudige tijden gaan om ervoor te zorgen dat Target Aanvragen bevatten gegevens van Experience Cloud Visitor ID. Voor terugkerende bezoekers Target gaat over de draad slechts aan Target om de gepersonaliseerde inhoud op te halen.

Waarom lijkt het alsof ik langzamere reactietijden na bevordering van een vorige versie van at.js aan versie 1.0.0 zie?

in.js versie 1.0.0 en hoger worden alle aanvragen parallel geactiveerd. Eerdere versies voeren de aanvragen opeenvolgend uit, wat betekent dat de aanvragen in een wachtrij worden geplaatst en Target wacht op eerste verzoek om te voltooien alvorens op het volgende verzoek over te gaan.

De manier vorige versies van at.js verzoeken uitvoeren is vatbaar voor de zogenaamde "hoofd van lijn het blokkeren." In at.js 1.0.0 en hoger Target geschakeld naar parallelle uitvoering van aanvragen.

Als u de waterval van het netwerklusje voor at.js 0.9.1 controleert, bijvoorbeeld, zult u dat volgende zien Target De aanvraag start pas nadat de vorige is voltooid. Deze volgorde is niet het geval bij at.js 1.0.0 en later, waar alle aanvragen eigenlijk tegelijkertijd beginnen.

Vanuit het perspectief van de reactietijd, wiskundig, kan deze opeenvolging als dit worden samengevoegd

om.js 0.9.1: Reactietijd van allen Target verzoeken = som van verzoeken, reactietijd
om.js 1.0.0 en later: Reactietijd van allen Target verzoeken = maximum van verzoeken reactietijd

Met versie 1.0.0 van de bibliotheek at.js worden de aanvragen sneller afgehandeld. Daarnaast zijn aanvragen van het type at.js asynchroon, dus Target blokkeert niet het weergeven van pagina's. Zelfs als verzoeken seconden duren, wordt de weergegeven pagina nog steeds weergegeven, maar enkele delen van de pagina worden gewist tot Target krijgt een antwoord van Target rand.

Kan ik de Target asynchroon bibliotheek?

Met de release van at.js 1.0.0 kunt u de Target bibliotheek asynchroon.

Zo laadt u at.js asynchroon:

De aanbevolen aanpak is via tags in Adobe Experience Platform.
U kunt ook asynchroon laden bij .js door het asynchrone attribuut aan de manuscriptmarkering toe te voegen die at.js laadt. Gebruik iets als dit:
<script src="<URL to at.js>" async></script>

U kunt ook asynchroon laden bij .js met deze code:

var script = document.createElement('script');
script.async = true;
script.src = "<URL to at.js>";
document.head.appendChild(script);

Het asynchroon laden bij.js is een goede manier om te voorkomen dat de browser wordt geblokkeerd bij het renderen. Deze techniek kan echter leiden tot flikkering op de webpagina.

U kunt flikkering vermijden door een vooraf verborgen fragment te gebruiken dat de pagina (of gespecificeerde gedeelten) verbergt en het dan onthult nadat om.js en het globale verzoek hebben geladen. Het fragment moet worden toegevoegd voordat u het bestand at.js laadt.

Als u at.js door asynchroon opstelt Adobe Experience Platform implementatie, zorg ervoor dat u het vooraf verborgen fragment direct op uw pagina's opneemt, voordat u het implementeert Target gebruiken Adobe Experience Platform Code insluiten.

Als u at.js door een synchrone implementatie DTM opstelt, kan het pre-verbergende fragment worden toegevoegd door een lijn van de Lading van de Pagina die bij de bovenkant van de pagina wordt teweeggebracht.

Zie voor meer informatie Hoe at.js flikkering beheert.

Is at.js compatibel met Adobe Experience Manager integratie (Experience Manager)?

Adobe Experience Manager 6.2 met FP-11577 (of later) steunt nu bij.js implementaties met zijn Adobe Target Cloud Services integratie.

Hoe kan ik flikkering tijdens het laden van pagina's voorkomen met at.js?

Target biedt verschillende manieren om flikkering bij het laden van pagina's te voorkomen. Zie voor meer informatie Flikkering voorkomen met at.js.

Wat is de bestandsgrootte van at.js?

Het bestand at.js is ongeveer 109 kB wanneer het wordt gedownload. Omdat de meeste servers bestanden echter automatisch comprimeren om de bestandsgrootte te verkleinen, is at.js ongeveer 34 kB bij het comprimeren (met GZIP of een andere methode) op uw server en het laden als gebruikers uw website bezoeken. De compressie-instellingen op de server waarop u .js hebt geïnstalleerd, bepalen de werkelijke gecomprimeerde grootte.

Waarom is at.js groter dan mbox.js?

bij.js de implementaties gebruiken één enkele bibliotheek ( at.js), terwijl mbox.js de implementaties eigenlijk twee bibliotheken ( mbox.js en target.js) gebruiken. Een eerlijkere vergelijking is dus at.js versus mbox.js en target.js. Wanneer de gecomprimeerde grootte van de twee versies wordt vergeleken, is versie 1.js 1.2 34 kB en versie 63 mbox.js 26,2 kB. "

at.js is groter omdat het veel meer DOM ontleedt in vergelijking met mbox.js. Dit is vereist omdat at.js "onbewerkte"gegevens in de reactie JSON krijgt en het moet zinvol maken. mbox.js gebruikt document.write() en al het parseren werd gedaan door browser.

Ondanks de grotere bestandsgrootte geven onze tests aan dat pagina's sneller worden geladen met at.js versus mbox.js. Ook, is at.js superieur vanuit veiligheidsperspectief omdat het geen extra dossiers dynamisch laadt of gebruikt document.write.

Heeft at.js er jQuery in? Kan ik dit deel van at.js verwijderen omdat ik al jQuery op mijn website heb?

at.js gebruikt momenteel delen van jQuery en dus ziet u de MIT-licentiemelding boven aan at.js. jQuery wordt niet weergegeven en heeft geen invloed op de jQuery-bibliotheek die u al op de pagina hebt, wat een andere versie kan zijn. Het verwijderen van de jQuery-code in at.js wordt niet ondersteund.

Biedt at.js ondersteuning voor Safari en cross domain ingesteld op x-only?

Nee, als cross-domain is ingesteld op x-only en Safari cookies van derden heeft uitgeschakeld, wordt zowel mbox.js als at.js een uitgeschakelde cookie ingesteld en worden geen box-aanvragen uitgevoerd voor het domein van die client.

Om Safari bezoekers te ondersteunen, zou een beter X-Domein "gehandicapt"zijn (plaatst slechts een eerste-partijkoekje) of "toegelaten"(plaatst slechts een eerste-partijkoekje op Safari, terwijl het plaatsen van eerste en derdekoekjes op andere browsers).

Kan ik het doel gebruiken Visual Experience Composer (VEC) in mijn toepassingen van één pagina?

Ja, u kunt VEC voor uw SPA gebruiken als u at.js 2.x gebruikt. Zie voor meer informatie Single Page (SPA) Visual Experience Composer.

Kan ik de Adobe Experience Cloud Debugger gebruiken met at.js implementaties?

Ja. U kunt mboxTrace voor het zuiveren doeleinden of de Hulpmiddelen van de Ontwikkelaar van uw browser ook gebruiken om de verzoeken van het Netwerk te inspecteren, filtrerend aan "mbox"om mbox vraag te isoleren.

Kan ik speciale karakters in mbox namen met at.js gebruiken?

Ja, hetzelfde als met mbox.js.

Waarom worden mijn dozen niet op mijn webpagina's geactiveerd?

Target klanten gebruiken soms cloudgebaseerde instanties met Target voor tests of eenvoudige concepttest. Deze en vele andere domeinen maken deel uit van de Lijst met openbare achtervoegsels.

Moderne browsers slaan cookies niet op als u deze domeinen gebruikt, tenzij u de opties cookieDomain instellen met targetGlobalSettings(). Zie voor meer informatie Op cloud gebaseerde instanties gebruiken met Target.

Kunnen IP adressen als koekjesdomein worden gebruikt wanneer het gebruiken van at.js?

Ja, als u at.js versie 1.2 of hoger. Adobe raadt u echter ten zeerste aan de nieuwste versie bij te houden.

NOTE

De volgende voorbeelden zijn niet nodig als u at.js versie 1.2 of later gebruikt.

Afhankelijk van hoe u targetGlobalSettings, moet u mogelijk aanvullende wijzigingen in de code aanbrengen nadat u het bestand at.js hebt gedownload. Als u bijvoorbeeld iets andere instellingen voor uw Target implementaties op verschillende websites die deze instellingen niet dynamisch kunnen definiëren met behulp van aangepaste JavaScript, deze aanpassingen handmatig uitvoeren nadat het bestand is gedownload en voordat het bestand naar de desbetreffende website wordt geüpload.

In de volgende voorbeelden kunt u de targetGlobalSettings() de functie at.js om een codefragment op te nemen om IP adressen te steunen:

Dit voorbeeld is voor één enkel IP adres:

if (window.location.hostname === '123.456.78.9') {
    window.targetGlobalSettings = window.targetGlobalSettings || {};
    window.targetGlobalSettings.cookieDomain = window.location.hostname;
}

Dit voorbeeld is voor een waaier van IP adressen:

if (/^123\.456\.78\..*/g.test(window.location.hostname)) {
    window.targetGlobalSettings = window.targetGlobalSettings || {};
    window.targetGlobalSettings.cookieDomain = window.location.hostname;
}

Waarom zie ik waarschuwingsberichten, zoals "acties met ontbrekende kiezers"?

Deze berichten hebben geen betrekking op de functionaliteit at.js. De bibliotheek at.js probeert om het even wat te melden die niet in DOM kan worden gevonden.

Als dit waarschuwingsbericht wordt weergegeven, zijn de volgende mogelijke hoofdoorzaken:

De pagina wordt dynamisch samengesteld en at.js kan het element niet vinden.
De pagina wordt langzaam gebouwd (wegens een langzaam netwerk) en at.js kan niet de selecteur in DOM vinden.
De paginastructuur waarop de activiteit wordt uitgevoerd, is gewijzigd. Als u de activiteit in de Visuele Composer van de Ervaring (VEC) heropent, zou u een waarschuwingsbericht moeten krijgen. Werk de activiteit bij zodat alle noodzakelijke elementen kunnen worden gevonden.
De onderliggende pagina maakt deel uit van een toepassing voor één pagina (SPA) of de pagina bevat elementen die verder naar beneden op de pagina worden weergegeven en het 'opiniepeilingsmechanisme' van at.js kan die elementen niet vinden. De selectorsPollingTimeout zou kunnen helpen. Zie voor meer informatie targetGlobalSettings().
Om het even welke klik-volgende metrisch probeert om aan elke pagina toe te voegen, ongeacht URL waarop metrisch opstelling was. Hoewel onschuldig, maakt deze situatie veel van deze berichten tonen.

Download en gebruik de nieuwste versie van at.js. Voor meer informatie over het downloaden van at.js raadpleegt u de Download om.js met de Target interface in de Hoe te opstellen bij.js > Implementeren Target zonder tagbeheer artikel.

Wat is het domein tt.omtrdc.net dat Target serveraanroepen gaan naar?

tt.omtrdc.net is de domeinnaam voor het netwerk van EDGE van de Adobe, dat wordt gebruikt om alle servervraag te ontvangen Target.

Waarom gebruikt at.js altijd vlaggen van het Toegangske- en Veilige koekje HttpOnly?

HttpOnly kan alleen worden ingesteld via code op de server. Target cookies, zoals mbox, worden gemaakt en opgeslagen via JavaScript-code, zodat Target Kan de koekjesvlag niet gebruiken HttpOnly. Target Hierbij wordt HttpOnly ingesteld voor cookies van derden die vanaf de server worden ingesteld wanneer cross-domain is ingeschakeld.

Beveiliging kan alleen via JavaScript worden ingesteld wanneer de pagina via HTTPS is geladen. Als de pagina voor het eerst wordt geladen via HTTP, kan JavaScript deze markering niet instellen. Als de markering Beveiligen wordt gebruikt, is de cookie bovendien alleen beschikbaar op HTTPS-pagina's. Voor pagina's die via HTTPS worden geladen, Target Hiermee worden de kenmerken Secure en SameSite=None ingesteld.

Om ervoor te zorgen dat Target gebruikers goed kunnen volgen en omdat de cookies op de client worden gegenereerd, Target gebruikt geen van beide vlaggen behalve in de hierboven vermelde situaties.

Hoe behandelt at.js veiligheidskwesties zoals aanvallen XSS en MITM?

Communicatie met het Adobe Edge-netwerk, ingeschakeld door at.js, vindt alleen plaats via HTTPS zolang de secureOnly option is ingesteld op true in de targetGlobalSettings() functie (targetGlobalSettings), anders is at.js toegestaan tussen HTTP en HTTPS te schakelen op basis van het paginaprotocol.

De volgende headers worden standaard afgedwongen:

HTTP Strict Transport Security (HSTS)
X-XSS-beveiliging
Opties voor X-inhoudstype
Referrer-Policy

Alle kopteksten die al in cliëntpagina's worden gebruikt kunnen worden afgedwongen. Een algemene manier om dit te doen is door "HTTP-aanvraagheaderautorisatie". De klantenservice van de Adobe kan verder advies geven over de beste methoden en praktijken.

Bovendien zijn verzoeken aan het Adobe Edge-netwerk openbaar (omdat ze ontworpen zijn om te worden gemaakt vanuit browsers van bezoekers) en bevatten ze geen zichtbare bezoekersgegevens (ze bevatten alleen een bezoekersidentiteitskaart). Deze verzoeken bieden bezoekers ervaringen en bevatten informatie over wat een bezoeker op de pagina moet zien.

Merk op dat voor reactietokens en zitting IDs die in deze verzoeken worden overgebracht:

Ze houden communicatiesessies bij
Ze bestaan uit willekeurige tekens
Sessie-id's zijn 30 minuten geldig
Responstokens kunnen worden uitgeschakeld (Reactietokens)
Ze zijn alleen nuttig in de omgeving van Adobe-oplossingen.

Verwacht wordt dat de Access-Control-Allow-Origin header met de waarde "*" in at.js-aanvragen, omdat ze openbaar zijn, is verificatie niet vereist en moet het Adobe Edge-netwerk via JavaScript-aanroepen vanuit elk domein worden benaderd.

Het inhoudsbeveiligingsbeleid (CSP) moet echter op de pagina worden afgedwongen. Zie voor meer informatie over CSP-vereisten voor at.js Beveiligingsbeleid voor inhoud en targetGlobalSettings.

Hoe vaak leidt at.js een netwerkverzoek in brand?

Target voert al zijn besluit op de server uit. Dit betekent dat at.js elke keer dat de pagina opnieuw wordt geladen of een openbare API van at.js wordt aangeroepen, een netwerkverzoek in werking stelt.

In het beste geval, kunnen wij verwachten dat de gebruiker geen zichtbare gevolgen op paginading met betrekking tot het verbergen van, het vervangen van, en het tonen van inhoud ervaart?

at.js probeert pre-verbergen HTML BODY of andere DOM elementen voor een langere periode te vermijden, maar dit hangt van netwerkvoorwaarden en activiteitenopstelling af. at.js biedt instellingen U kunt de LICHAAM die CSS-stijl verbergt, aanpassen, zodat u in plaats van de hele HTML BODY te lekken, slechts enkele delen van de pagina kunt voorverbergen. De verwachting is dat die onderdelen DOM-elementen bevatten die "gepersonaliseerd" moeten worden.

Wat is de opeenvolging van gebeurtenissen in een gemiddeld scenario waar een gebruiker voor een activiteit kwalificeert?

Het verzoek at.js is een asynchroon XMLHttpRequest, dus voeren we de volgende stappen uit:

De pagina wordt geladen.
at.js prehides the HTML BODY. Er is een instelling voor het vooraf verbergen van een bepaalde container in plaats van de HTML BODY.
De aanvraag at.js wordt geactiveerd.
Na de Target antwoord ontvangen; Target Hiermee worden de CSS-kiezers uitgepakt.
CSS-kiezers gebruiken Target maakt STIJL-tags om de DOM-elementen die worden aangepast, vooraf te verbergen.
De vooraf verborgen STIJL voor het HTML-LICHAAM wordt verwijderd.
Target start opiniepeiling voor DOM-elementen.
Als een DOM-element wordt gevonden, Target past DOM-wijzigingen toe en de vooraf verborgen STIJL van het element wordt verwijderd.
Als DOM-elementen niet worden gevonden, verbergt een algemene time-out de elementen om te voorkomen dat een pagina wordt verbroken.

Hoe vaak wordt de inhoud van de pagina volledig geladen en zichtbaar wanneer at.js definitief het element ontverbergt de activiteit verandert?

Gezien het bovenstaande scenario, hoe vaak wordt de inhoud van de pagina volledig geladen en zichtbaar wanneer at.js definitief het element ontverbergt de activiteit verandert? Met andere woorden, de pagina is volledig zichtbaar behalve de inhoud van de activiteit, die dan lichtjes na de rest van de inhoud wordt onthuld.

at.js blokkeert niet dat de pagina wordt weergegeven. Een gebruiker kan enkele lege gebieden op de pagina opmerken die elementen vertegenwoordigen die zijn aangepast door Target. Als de toe te passen inhoud niet vele verre activa, zoals SCRIPTs of IMGs bevat, zou alles snel moeten teruggeven.

Hoe zou een volledig caching pagina het bovengenoemde scenario beïnvloeden? Zou het waarschijnlijker zijn dat de inhoud van de activiteit merkbaar zichtbaar wordt nadat de rest inhoud van de pagina laadt?

Als een pagina in de cache wordt geplaatst op een CDN die dicht bij de locatie van de gebruiker staat, maar niet bij de locatie Target Edge, kan de gebruiker enige vertragingen zien. Target de randen zijn over de hele wereld goed verdeeld , dus dit is niet de meeste tijd een probleem .

Is het mogelijk dat een hoofdafbeelding na een korte vertraging wordt weergegeven en vervolgens wordt omgewisseld?

Met het volgende scenario:

De Target time-out is vijf seconden. Een gebruiker laadt een pagina die een activiteit heeft om een hoofdafbeelding aan te passen. at.js verzendt het verzoek om te bepalen als er een activiteit is om toe te passen, maar er is geen aanvankelijke reactie. Stel dat de gebruiker de reguliere inhoud van de hoofdafbeelding ziet, omdat er geen reactie is ontvangen van Target met betrekking tot de vraag of er een verwante activiteit is. Na vier seconden Target retourneert een reactie met de inhoud van de activiteit.

Zou het in dit stadium mogelijk zijn de alternatieve versie te tonen? Na vier seconden kon de hoofdafbeelding worden omgewisseld en kon de gebruiker deze afbeeldingswisseling zien?

In eerste instantie is het DOM-element voor de held van de afbeelding verborgen. Na een reactie van Target ontvangen, past at.js de DOM-wijzigingen toe, zoals het vervangen van de IMG en het weergeven van de aangepaste hoofdafbeelding.

Welk HTML doctype vereist at.js?

at.js vereist het documenttype van HTML 5.

Deze syntaxis is:

<!DOCTYPE html>

Het documenttype HTML 5 zorgt ervoor dat de pagina in de standaardmodus wordt geladen. Bij het laden in de modus Kirken zijn sommige JS API's waarvan at.js afhankelijk is, uitgeschakeld. Target Schakelt in de modus kirken de modus at.js uit.

At.js werkt in een Ionic-toepassingsomgeving.

Deze implementatie is nooit getest, omdat at.js niet bedoeld was om te werken in een niet-webomgeving. Adobe beveelt aan SDK's voor mobiele implementaties.

recommendation-more-help