Häufig gestellte Fragen zu „at.js“

Antworten auf häufig zu „at.js“ gestellten Fragen

Welche Vorteile hat die Verwendung von at.js gegenüber mbox.js?

Die Bibliothek at.js ersetzt mbox.js. Die Bibliothek mbox.js wird nicht mehr unterstützt. Für die meisten Benutzer birgt at.js allerdings mehr Vorteile als mbox.js.

Neben anderen Vorteilen sorgt at.js für kürzere Ladezeiten von Seiten bei Webimplementierungen, bessere Sicherheit und bessere Implementierungsoptionen für Einzelseiten-Apps.

Im folgenden Diagramm wird die Seitenladeleistung von mbox.js und at.js verglichen.

Wie oben gezeigt wurde bei der Verwendung von mbox.js der Seiteninhalt erst geladen, nachdem der Aufruf Target abgeschlossen wurde. Bei der Verwendung von at.js werden Seiteninhalte schon geladen, wenn der Aufruf von Target eingeleitet wird, nicht erst nach Abschluss des Vorgangs.

Wie wirkt sich at.js und mbox.js auf Seitenladezeiten aus?

Viele Kunden und Berater möchten wissen, wie sich at.js und mbox.js auf die Seitenladezeit auswirken, insbesondere beim Vergleich neuer Besucher mit zurückkehrenden Besuchern. Leider ist es schwierig, zu messen, wie sich at.js oder mbox.js auf die Seitenladezeit auswirken und genaue Zahlen dazu zu nennen. Das liegt an den Implementationen der einzelnen Kunden.

Wenn die Besucher-API jedoch auf der Seite vorhanden ist, kann Target besser verstehen, wie at.js und mbox.js die Seitenladezeit beeinflussen.

HINWEIS

Die Besucher-API und at.js oder mbox.js wirken sich nur dann auf die Seitenladezeit aus, wenn Sie die globale Mbox verwenden (das liegt an der Technik, mit der der Haupttext ausgeblendet wird). Regionale Mboxes sind von der Besucher-API-Integration nicht betroffen.

In den folgenden Abschnitten wird die Aktionssequenz für neue und zurückkehrende Besucher beschrieben:

Neue Besucher

  1. Die Besucher-API ist geladen und analysiert und wird ausgeführt.

  2. at.js/mbox.js ist geladen und analysiert und wird ausgeführt.

  3. Wenn die automatische Erstellung der globalen Mbox aktiviert ist, wird die Target JavaScript-Bibliothek Folgendes tun:

    • Sie wird das Besucher-Objekt instanziieren.
    • Die Target-Bibliothek versucht, Experience Cloud-Besucher-ID-Daten abzurufen.
    • Da es sich bei diesem Besucher um einen neuen Besucher handelt, sendet die Besucher-API eine domänenübergreifende Anfrage an demdex.net.
    • Nachdem die Experience Cloud-Besucher-ID-Daten abgerufen wurden, wird eine Anfrage an Target gesendet.

Zurückkehrende Besucher

  1. Die Besucher-API ist geladen und analysiert und wird ausgeführt.

  2. at.js/mbox.js ist geladen und analysiert und wird ausgeführt.

  3. Wenn die automatische Erstellung der globalen Mbox aktiviert ist, wird die Target JavaScript-Bibliothek Folgendes tun:

    • Sie wird das Besucher-Objekt instanziieren.
    • Die Target-Bibliothek versucht, Experience Cloud-Besucher-ID-Daten abzurufen.
    • Die Besucher-API ruft Cookie-Daten ab.
    • Nachdem die Experience Cloud-Besucher-ID-Daten abgerufen wurden, wird eine Anfrage an Target gesendet.
HINWEIS

Wenn die Besucher-API vorhanden ist, muss Target bei neuen Besuchern mehrfach über die Verbindung gehen, um sicherzustellen, dass Target-Anfragen die Daten der Experience Cloud-Besucher-ID enthalten. Bei zurückkehrenden Besuchern geht Target nur über die Verbindung, um den personalisierten Inhalt in Target abzurufen.

Warum sind die Antwortzeiten nach einem Upgrade von einer vorherigen Version von at.js auf Version 1.0.0 scheinbar langsamer?

Bei at.js der Version 1.0.0 und höher werden alle Anforderungen parallel ausgelöst. In den vorherigen Versionen werden die Anforderungen sequenziell ausgeführt, d. h., die Anforderungen werden in eine Warteschlange verschoben, und Target wartet auf den Abschluss der ersten Anforderung, bevor der Vorgang mit der nächsten Anforderung fortgesetzt wird.

Die Art der Ausführung von Anforderungen in früheren Versionen von at.js unterliegt dem sogenannten „Head of Line Blocking“. In at.js 1.0.0 und höher ist Target zu der parallelen Anforderungsausführung gewechselt.

Wenn Sie beispielsweise das Wasserfallmodell der Netzwerkregisterkarte auf at.js 0.9.1 überprüfen, sehen Sie, dass die nächste Target-Anforderung erst gestartet wird, nachdem die vorherige fertig gestellt wurde. Diese Sequenz ist bei at.js 1.0.0 und höher nicht der Fall, bei der alle Anforderungen im Grunde gleichzeitig beginnen.

Aus Sicht der Antwortzeit kann mathematisch diese Sequenz wie folgt zusammengefasst werden

  • at.js 0.9.1: Antwortzeit aller Target-Anforderungen = Summe der Antwortzeit der Anforderungen
  • at.js 1.0.0 und höher: Antwortzeit aller Target-Anforderungen = Maximum der Antwortzeit der Anforderungen

Die at.js -Bibliothek Version 1.0.0 führt die Anforderungen schneller aus. Zudem laufen at.js-Anforderungen asynchron, sodass das Rendern der Seiten nicht blockiert. Target Selbst wenn der Abschluss von Anforderungen Sekunden dauert, wird die gerenderte Seite weiterhin angezeigt. Es werden nur einige Teile der Seite ausgeblendet, bis Target eine Antwort vom Target-Edge erhält.

Kann ich die Target-Bibliothek asynchron laden?

In at.js 1.0.0 kann die Target-Bibliothek asynchron geladen werden.

So laden Sie at.js asynchron:

  • Der empfohlene Ansatz erfolgt über Adobe Experience Platform Launch. Weitere Informationen finden Sie in der Lektion Hinzufügen von Adobe Target im Tutorial Implementieren des Experience Cloud in Websites mit Launch .

  • Sie können at.js auch asynchron laden, indem Sie dem Skript-Tag zum Laden von at.js das asynchrone Attribut hinzufügen. Verwenden Sie etwa Folgendes:

    <script src="<URL to at.js>" async></script>
    
  • Sie können at.js auch mithilfe dieses Codes asynchron laden:

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

Das asynchrone Laden von at.js eignet sich hervorragend, um zu verhindern, dass das Rendern des Browsers blockiert wird. Bei dieser Technik kann es jedoch zu Flackereffekten auf der Webseite kommen.

Sie können ein Flackern verhindern, indem Sie einen vorab ausgeblendeten Ausschnitt verwenden, der die Seite (oder bestimmte Teile) ausblendet und ihn dann nach at.js einblendet und die globale Anforderung geladen hat. Der Ausschnitt muss vor dem Laden von at.js hinzugefügt werden.

Wenn Sie at.js über eine asynchrone Launch-Implementierung bereitstellen, stellen Sie sicher, dass Sie das vor-ausgeblendete Snippet direkt auf Ihren Seiten vor dem Launch-Einbettungscode einfügen, wie im Abschnitt Hinzufügen des vor-ausgeblendeten Snippets für Target im Tutorial Implementieren des Experience Cloud in Websites mit Launch beschrieben.

Wenn Sie at.js über eine synchrone DTM-Implementierung bereitstellen, kann das vor-ausgeblendete Snippet über eine Seitenladeregel hinzugefügt werden, die oben auf der Seite ausgelöst wird.

Weitere Informationen finden Sie unter Verwaltung von Flackern mit „at.js“.

Ist at.js mit der Adobe Experience Manager-Integration (Experience Manager) kompatibel?

Adobe Experience Manager 6.2 mit FP-11577 (oder neuer) unterstützt jetzt at.js-Implementierungen mit der Adobe Target Cloud Services-Integration.

Wie kann ich mit at.js ein Flackern beim Laden von Seiten verhindern ?

Mit Target wird das Flackern beim Laden von Seiten auf verschiedenen Wegen vermieden: Weitere Informationen finden Sie unter Verwaltung von Flackern mit „at.js“.

Wie groß ist at.js?

Die at.js-Datei hat beim Download eine Größe von etwa 109 KB. Da die meisten Server Dateien jedoch automatisch komprimieren, um die Dateigröße zu verringern, ist at.js bei Komprimierung (mit GZIP oder einer ähnlichen Anwendung) auf dem Server etwa 34 KB groß und wird in dieser Größe auch geladen, wenn Benutzer Ihre Webseite besuchen. Die Komprimierungseinstellungen des Servers, auf dem at.js installiert ist, bestimmen die tatsächliche Größe der Datei.

Warum ist at.js größer als mbox.js?

at.js-Implementierungen verwenden nur eine Bibliothek (at.js), während bei mbox.js-Implementierungen zwei Bibliotheken (mbox.js und target.js) zum Einsatz kommen. Es wäre also gerechter, at.js mit mbox.js und target.js zu vergleichen. Beim Vergleich der komprimierten Größen der beiden Versionen ist ersichtlich, dass die at.js-Version 1.2 34 KB groß ist und die mbox.js-Version 63 eine Größe von 26,2 KB hat. ``

at.js ist deshalb größer, weil im Vergleich zu mbox.js deutlich mehr DOM-Parsing durchgeführt wird. Dies ist erforderlich, da at.js „Rohdaten“ in der JSON-Antwort erhält und diese zunächst verarbeiten muss. mbox.js verwendet document.write() und das Parsen wurde vom Browser durchgeführt.

Trotz der größeren Datei zeigen unsere Tests, dass Seiten mit at.js schneller geladen werden als Seiten mit mbox.js. Zudem bietet at.js eine höhere Sicherheit, da keine zusätzlichen dynamischen Dateien geladen werden und document.write nicht verwendet wird.

Enthält at.js jQuery? Kann ich diese Komponente von „at.js“ löschen, wenn ich jQuery bereits auf meiner Website verwende?

at.js verwendet derzeit Teile von jQuery, sodass oben in at.js die MIT-Lizenzbenachrichtigung angezeigt wird. jQuery wird nicht ausgelöst und die Bibliothek übt keinen Einfluss auf die bereits auf Ihrer Seite eingebettete jQuery-Bibliothek aus, bei der es sich möglicherweise um eine andere Version handelt. Der jQuery-Code in at.js lässt sich nicht löschen.

Unterstützt „at.js“ Safari und domänenübergreifende Einstellungen, die als „nur x“ eingestellt sind?

Nein, wenn domänenübergreifend auf "nur x"festgelegt ist und in Safari Drittanbieter-Cookies deaktiviert sind, setzen sowohl mbox.js als auch at.js ein deaktiviertes Cookie und es werden keine Mbox-Anfragen für die Domäne dieses Kunden ausgeführt.

Sollen Safari-Besucher unterstützt werden, wäre eine bessere X-Domäne „deaktiviert“ (setzt nur ein Erstanbieter-Cookie) oder „aktiviert“ (setzt in Safari nur ein Erstanbieter-Cookie, während in anderen Browsern Erst- und Drittanbieter-Cookies gesetzt werden).

Kann ich den Target Visual Experience Composer (VEC) in meinen Einzelseitenanwendungen verwenden?

Ja, Sie können VEC für Ihre SPA verwenden, wenn Sie at.js 2.x verwenden. Weitere Informationen finden Sie unter Visual Experience Composer für Einzelseiten-SPA (Visual Experience Composer).

Kann ich den Adobe Experience Cloud-Debugger für at.js-Implementierungen verwenden?

Ja. Sie können außerdem mboxTrace für das Debugging oder die Entwicklerwerkzeuge Ihres Browsers verwenden und zum Isolieren von Mbox-Aufrufen nach „mbox“ filtern, um die Netzwerkanforderungen zu analysieren.

Kann ich mit at.js Sonderzeichen in meinen Mbox-Namen verwenden ?

Ja, genau wie bei mbox.js.

Warum werden meine Mboxes nicht auf meinen Webseiten ausgelöst?

Target-Kunden verwenden mitunter Cloud-basierte Instanzen mit Target zum Testen oder für einfache Machbarkeitsprüfungen. Diese Domänen sind neben vielen anderen Teil der öffentlichen Suffix-Liste.

Modere Browser speichern keine Cookies, wenn Sie diese Domänen verwenden, es sei denn, Sie passen die Einstellung cookieDomain mithilfe von targetGlobalSettings() an. Weitere Informationen finden Sie unter Verwenden Cloud-basierter Instanzen mit Target.

Können IP-Adressen bei der Verwendung von at.js als Cookie-Domäne dienen?

Ja, wenn Sie at.js, Version 1.2 oder neuer verwenden. Adobe empfiehlt jedoch dringend, dass Sie mit der neuesten Version auf dem Laufenden bleiben.

HINWEIS

Die folgenden Beispiele sind nicht notwendig, wenn Sie at.js der Version 1.2 oder neuer verwenden.

Abhängig davon, wie Sie targetGlobalSettings verwenden, müssen Sie möglicherweise weitere Änderungen am Code vornehmen, nachdem Sie at.js heruntergeladen haben. Benötigen Sie beispielsweise etwas voneinander abweichende Einstellungen für Ihre Implementierungen von Target auf verschiedenen Websites und konnten Sie diese Einstellungen nicht dynamisch mit JavaScript festlegen, nehmen Sie diese Anpassungen manuell vor, nachdem Sie die Datei heruntergeladen haben und bevor Sie sie auf der entsprechenden Website hochladen.

In den folgenden Beispielen können Sie die at.js-Funktion targetGlobalSettings() zum Einfügen eines Code-Ausschnitts verwenden, um IP-Adressen zu unterstützen:

Dieses Beispiel betrifft eine einzelne IP-Adresse:

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

Dieses Beispiel betrifft einen IP-Adressbereich:

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

Warum werden mir Warnhinweise wie zum Beispiel „Aktionen mit fehlenden Selektoren“ angezeigt?

Diese Meldungen beziehen sich nicht auf die Funktion at.js. Die at.js-Bibliothek versucht, alles zu melden, das nicht im DOM zu finden ist.

Nachfolgend finden Sie mögliche Grundursachen für diesen Warnhinweis:

  • Die Seite wird dynamisch erstellt und at.js kann das Element nicht finden.

  • Die Seite wird langsam erstellt (aufgrund eines langsamen Netzwerks) und at.js kann den Selektor im DOM nicht finden.

  • Die Seitenstruktur, auf der diese Aktivität ausgeführt wird, wurde geändert. Wenn Sie die Aktivität erneut im Visual Experience Composer (VEC) öffnen, sollte Ihnen ein Warnhinweis angezeigt werden. Aktualisieren Sie die Aktivität, sodass alle erforderlichen Elemente gefunden werden können.

  • Die zugrundeliegende Seite ist Teil einer Einzelseiten-App (SPA) oder die Seite enthält Elemente, die weiter unten auf der Seite auftauchen und der „Selektor-Polling-Mechanismus“ von at.js kann diese Elemente nicht finden. Es ist unter Umständen hilfreich, den selectorsPollingTimeout zu erhöhen. Weitere Informationen finden Sie unter targetGlobalSettings().

  • Eine beliebige Klick-Tracking-Metrik versucht, sich zu jeder Seite hinzuzufügen, unabhängig von der URL, in der die Metrik eingerichtet wurde. Diese Situation ist zwar harmlos, hat aber viele dieser Warnhinweise zur Folge.

    Um die bestmöglichen Ergebnisse zu erzielen, sollten Sie die aktuellste Version von at.js herunterladen und verwenden. Weitere Informationen finden Sie unter „at.js“-Versionsdetails und Herunterladen von „at.js“.

Was ist die Domain tt.omtrdc.net, zu der die Target-Server-Aufrufe gehen?

tt.omtrdc.net ist der Domainname für das EDGE-Netzwerk von Adobe, mit dem alle Server-Aufrufe für Target empfangen werden.

Warum verwenden at.js und mbox.js nicht die Cookie-Flags „HttpOnly“ und „Secure“?

„HttpOnly“ kann nur über Server-seitigen Code festgelegt werden. Target-Cookies, wie z. B. Mbox, werden über JavaScript-Code erstellt und gespeichert. Target kann das Cookie-Flag „HttpOnly“ also nicht verwenden.

„Secure“ kann nur über JavaScript festgelegt werden, wenn die Seite mit HTTPS geladen wurde. Wenn die Seite nur mit HTTP geladen wird, kann JavaScript dieses Flag nicht festlegen. Wenn das Flag Sicher verwendet wird, ist das Cookie nur auf HTTPS-Seiten verfügbar.

Damit Target Benutzer richtig verfolgen kann – und weil Cookies Client-seitig generiert werden –, verwendet Target keines dieser Flags.

Wie oft sendet at.js Netzwerkanfragen?

Die gesamte Entscheidungsfindung von Adobe Target findet Server-seitig statt. Das bedeutet, dass at.js jedes Mal, wenn die Seite neu geladen oder eine öffentliche at.js-API aufgerufen wird, eine Netzwerkanfrage gesendet wird.

Können wir im besten Fall davon ausgehen, dass Benutzer durch das Ausblenden, Ersetzen und Wiedereinblenden von Inhalten keine Beeinträchtigung der Seitenladezeit bemerken werden?

at.js versucht, das Vorab-Ausblenden des HTML-BODY oder anderer DOM-Elemente für einen längeren Zeitraum zu vermeiden. Dies hängt jedoch von den Netzwerkbedingungen und der Aktivitätseinrichtung ab. at.js bietet Einstellungen, mit denen Sie den CSS-Style zum Ausblenden des Bodys anpassen können, um nicht den gesamten HTML-Body, sondern nur bestimmte Teile der Seite auszublenden. Hierbei wird erwartet, dass diese Teile DOM-Elemente enthalten, die „personalisiert“ werden müssen.

Wie lautet die Reihenfolge der Ereignisse in einem durchschnittlichen Szenario, in dem sich ein Benutzer für eine Aktivität qualifiziert?

Bei der at.js-Anfrage handelt es sich um eine asynchrone XMLHttpRequest, weshalb wir folgende Schritte ausführen:

  1. Die Seite wird geladen.
  2. at.js blendet den HTML-Body vorab aus. Es gibt eine Einstellung, mit der sich anstelle des gesamten HTML-Bodys nur ein bestimmter Container ausblenden lässt.
  3. Die at.js-Anfrage wird gesendet.
  4. Nachdem die Target-Antwort eingegangen ist, extrahiert Target die CSS-Selektoren.
  5. Mit den CSS-Selektoren erstellt Target STYLE-Tags, um die anzupassenden DOM-Elemente vorab auszublenden.
  6. Der STYLE zum Vorab-Ausblenden des HTML-Bodys wird entfernt.
  7. Target beginnt mit dem Abrufen der DOM-Elemente.
  8. Wenn ein DOM-Element gefunden wird, wendet Target DOM-Änderungen an und der STYLE zum Vorab-Ausblenden des Elements wird entfernt.
  9. Wenn keine DOM-Elemente gefunden werden, werden die Elemente durch eine globale Zeitüberschreitung ausgeblendet, um eine fehlerhafte Seite zu vermeiden.

Wie oft ist der Seiteninhalt vollständig geladen und sichtbar, wenn at.js das Element, das durch die Aktivität geändert wird, zum letzten Mal ausblendet?

Wie oft ist der Seiteninhalt in Anbetracht des obigen Szenarios vollständig geladen und sichtbar, wenn at.js das Element, das durch die Aktivität geändert wird, zum letzten Mal ausblendet? Anders ausgedrückt: Die Seite ist vollständig sichtbar, ausgenommen der Aktivitätsinhalt, der kurz nach dem anderen Inhalt eingeblendet wird.

at.js blockiert nicht das Seiten-Rendering. Ein Benutzer kann einige leere Bereiche auf der Seite bemerken, die Elemente darstellen, die von Target angepasst werden. Wenn der anzuwendende Inhalt nicht viele Remote-Assets, wie z. B. Skripte oder Bilder, enthält, wird alles schnell dargestellt.

Wie wirkt sich eine vollständig zwischengespeicherte Seite auf das oben aufgeführte Szenario aus? Ist es in diesem Fall wahrscheinlicher, dass der Aktivitätsinhalt merklich nach dem Rest des Seiteninhalts geladen wird?

Wenn eine Seite in einem CDN gespeichert ist, das sich nahe am Standort des Benutzers, aber nicht in der Nähe der Target-Edge befindet, erlebt dieser Benutzer möglicherweise Verzögerungen. Die Zielkanten sind auf der ganzen Welt gut verteilt, sodass dies meistens kein Problem ist.

Ist es möglich, ein Hero-Bild anzuzeigen, das nach kurzer Verzögerung ersetzt wird?

Stellen Sie sich folgendes Szenario vor:

Das Target-Timeout beträgt fünf Sekunden. Ein Benutzer lädt eine Seite, die eine Aktivität zum Anpassen des Hero-Bilds aufweist. at.js sendet die Anfrage, um zu bestimmen, ob eine Aktivität angewendet werden muss, die erste Antwort bleibt jedoch aus. Wir können also davon ausgehen, dass der Benutzer den regulären Inhalt des Hero-Bilds sieht, da keine Antwort von Target zu etwaigen anzuwendenden Aktivitäten eingegangen ist. Nach vier Sekunden gibt Target eine Antwort mit den Aktivitätsinhalten zurück.

Ist es zu diesem Zeitpunkt möglich, dass die alternative Version angezeigt wird? Nach vier Sekunden könnte das Hero-Bild also ausgetauscht werden. Würde der Benutzer diesen Austausch bemerken?

Das Hero-DOM-Element ist zu Beginn ausgeblendet. Nachdem eine Antwort von Target eingeht, wendet at.js die DOM-Änderungen an, wie z. B. die IMG-Änderung und die Anzeige des angepassten Hero-Bilds.

Welcher HTML-Doctype ist für at.js erforderlich?

at.js erfordert den Doctype HTML 5.

Diese Syntax lautet:

<!DOCTYPE html>

Der Doctype HTML 5 stellt sicher, dass die Seite im Standardmodus geladen wird. Beim Laden im Quirks-Modus sind einige JS-APIs, von denen at.js abhängig ist, deaktiviert. Target deaktiviert at.js im Quirks-Modus.

Auf dieser Seite