Dokumentation Target Target-Entwicklerhandbuch

Aktualisieren von at.js 1.x auf at.js 2.x

Letzte Aktualisierung: 5. Mai 2025

Themen:

Erstellt für:

Entwickler

Die neueste Version von at.js Adobe Target bietet umfassende Funktionen, mit denen Ihr Unternehmen mithilfe von Client-seitigen Technologien der neuesten Generation Personalisierungen ausführen kann. Diese neue Version konzentriert sich auf die Aktualisierung von at.js, um harmonische Interaktionen mit Einzelseitenanwendungen (SPAs) zu ermöglichen.

Im Folgenden finden Sie einige Vorteile der Verwendung von at.js 2.x, die in früheren Versionen nicht verfügbar waren:

Möglichkeit zur Zwischenspeicherung aller Angebote beim Seitenladen, um mehrere Server-Aufrufe auf einen einzelnen Server-Aufruf zu reduzieren
Drastische Verbesserung der Erlebnisse Ihrer Endbenutzer auf Ihrer Site, da Angebote sofort über den Cache angezeigt werden, ohne dass die herkömmlichen Serveraufrufe verzögert werden.
Einfache, einzeilige Code- und einmalige Entwicklereinrichtung, damit Ihre Marketing-Fachleute A/B Test- und Experience Targeting (XT)-Aktivitäten über den VEC auf Ihrer SPA erstellen und ausführen können.

at.js 2.x Systemdiagramme

Die folgenden Diagramme helfen Ihnen, den Workflow von at.js 2 zu verstehen.x mit Ansichten und wie dadurch die SPA-Integration verbessert wird. Hier erhalten Sie eine bessere Einführung in die in at.js 2 verwendeten Konzepte.x, siehe Implementierung von Einzelseiten-Apps.

(Klicken Sie auf das Bild, um es auf die volle Breite zu erweitern.)

Target-Fluss mit at.js 2.x

Aufruf	Details
1	Ein Aufruf gibt die Experience Cloud ID zurück, falls sich der Benutzer authentifiziert hat. Bei einem weiteren Aufruf wird die Kunden-ID synchronisiert.
2	Die Bibliothek at.js wird synchron geladen und im Dokumentenkörper verborgen. „at.js“ kann auch asynchron geladen werden, mit der Option, dass ein Code-Ausschnitt auf der Seite vorab ausgeblendet wird.
3	Es wird eine Seitenlade-Anfrage durchgeführt, in der alle konfigurierten Parameter (MCID, SDID und Kunden-ID) enthalten sind.
4	Profilskripte werden ausgeführt und anschließend in den Profilspeicher eingespeist. Der Store fordert qualifizierte Zielgruppen aus der Zielgruppenbibliothek an (z. B. von Adobe Analytics freigegebene Zielgruppen, Audience Manager usw.). Kundenattribute werden in einem Batch-Prozess an den Profilspeicher übermittelt.
5	Basierend auf den URL-Anfrageparametern und den Profildaten entscheidet Target, welche Aktivitäten und Erlebnisse für die aktuelle Seite und zukünftige Ansichten an den Besucher zurückgegeben werden sollen.
6	Zielgerichteter Inhalt wird zurück an die Seite übermittelt. Dieser enthält optional Profilwerte für eine weitere Personalisierung. Zielgerichtete Inhalte auf der aktuellen Seite werden so schnell wie möglich angezeigt, ohne dass der Standardinhalt flackert. Zielgerichteter Inhalt für Ansichten, die als Ergebnis von Benutzeraktionen in einer SPA angezeigt werden, die im Browser zwischengespeichert wird, sodass er sofort ohne zusätzlichen Server-Aufruf angewendet werden kann, wenn die Ansichten durch `triggerView()` ausgelöst werden.
7	Analytics-Daten werden an Datenerfassungsserver übermittelt.
8	Zielgruppendaten werden über die SDID mit Analytics abgeglichen und in den Analytics-Reporting-Speicher verarbeitet. Analytics Daten können dann sowohl in Analytics als auch Target über Analytics for Target (A4T)-Berichte angezeigt werden.

Egal, wo triggerView() in Ihrer SPA implementiert ist, werden die Ansichten und Aktionen aus dem Cache abgerufen und dem Benutzer ohne Serveraufruf gezeigt. triggerView() sendet außerdem eine Benachrichtigungsanfrage an das Target-Backend, um Impressions-Zählungen zu erhöhen und aufzuzeichnen.

(Klicken Sie auf das Bild, um es auf die volle Breite zu erweitern.)

Target-Fluss at.js 2.*x* triggerView

Aufruf	Details
1	`triggerView()` wird in der Einzelseiten-App aufgerufen, um eine Ansicht wiederzugeben und Aktionen anzuwenden, die visuelle Elemente ändern.
2	Gezielte Inhalte für die Ansicht werden aus dem Cache gelesen.
3	Die zielgerichteten Inhalte werden so schnell wie möglich bereitgestellt, ohne dass Standardinhalte aufflackern.
4	Die Benachrichtigungsanfrage wird an den Target-Profilspeicher gesendet, damit der Besucher in der Aktivität erfasst und die Metrik erhöht wird.
5	Analytics Daten an Datenerfassungs-Server gesendet.
6	Target Daten werden über die SDID mit Analytics Daten abgeglichen und in den Analytics-Reporting-Speicher verarbeitet. Analytics Daten können dann sowohl in Analytics als auch Target über A4T-Berichte angezeigt werden.

Bereitstellen von at.js 2 x

Bereitstellen von at.js 2 x über Tags in der Erweiterung {2🔗Adobe Experience Platform}.

NOTE

Die Bereitstellung von at.js mit Tags in Adobe Experience Platform ist die bevorzugte Methode.

Oder

Herunterladen von at.js 2.x mithilfe der Target-Benutzeroberfläche und Bereitstellen mithilfe der Methode Ihrer Wahl.

Nicht mehr unterstützte Funktionen von at.js

Es gibt mehrere Funktionen, die in at.js 2 veraltet sind.x.

WARNING

Wenn diese veralteten Funktionen auf Ihrer Site weiterhin verwendet werden, wenn at.js 2.x wird bereitgestellt, werden Konsolenwarnungen angezeigt. Beim Aktualisieren wird empfohlen, die Bereitstellung von at.js 2 zu testen.x in einer Staging-Umgebung verwenden und sicherstellen, dass Sie alle Warnungen durchgehen, die in der Konsole protokolliert wurden, und die veralteten Funktionen in neue Funktionen übersetzen, die in at.js 2 eingeführt wurden.x.

Sie finden die veralteten Funktionen und das zugehörige Gegenstück unten. Eine vollständige Liste der Funktionen finden Sie unter „at.js“-Funktionen.

NOTE

at.js 2.x blendet mboxDefault markierten Elemente nicht mehr automatisch vorab aus. Kunden müssen daher die Pre-Hide-Logik entweder manuell auf der Site selbst oder über einen Tag-Manager verwalten.

mboxCreate(mbox,params)

Beschreibung:

Führt eine Anfrage aus und wendet das Angebot auf das nächste DIV mit dem mboxDefault-Klassennamen an.

Beispiel:

<div class="mboxDefault">
  default content to replace by offer
</div>
<script>
  mboxCreate('mboxName','param1=value1','param2=value2');
</script>

at.js 2.x-Äquivalent

Eine Alternative zu mboxCreate(mbox, params) sind getOffer() und applyOffer().

Beispiel:

<div class="mboxDefault">
  default content to replace by offer
</div>
<script>
  var el = document.currentScript.previousElementSibling;
  adobe.target.getOffer({
    mbox: "mboxName",
    params: {
      param1: "value1",
      param2: "value2"
    },
    success: function(offer) {
      adobe.target.applyOffer({
        mbox: "mboxName",
        selector: el,
        offer: offer
      });
    },
    error: function(error) {
      console.error(error);
      el.style.visibility = "visible";
    }
  });
</script>

„mboxDefine()“ und „mboxUpdate()“

Beschreibung:

Erstellt eine interne Zuordnung zwischen einem Element und einem Mbox-Namen, führt die Anforderung jedoch nicht aus. Wird zusammen mit mboxUpdate() verwendet, was die Anfrage ausführt und das Angebot auf das in mboxDefine() von der nodeId identifizierte Element anwendet. Die Funktion kann auch dazu genutzt werden, eine Mbox zu aktualisieren, die durch mboxCreate initiiert wurde.

Beispiel:

<div id="someId" class="mboxDefault"></div>
<script>
 mboxDefine('someId','mboxName','param1=value1','param2=value2');
 mboxUpdate('mboxName','param3=value3','param4=value4');
</script>

at.js 2.x-Äquivalent:

Eine Alternative zu mboxDefine() und mboxUpdate sind getOffer() und applyOffer(), mit Verwendung der Selektor-Option in applyOffer(). Mit diesem Ansatz können Sie das Angebot einem Element mit jedem CSS-Selektor zuordnen, nicht nur mit einem mit einer ID.

Beispiel:

<div id="someId" class="mboxDefault">
  default content to replace by offer
</div>
<script>
  adobe.target.getOffer({
    mbox: "mboxName",
    params: {
      param1: "value1",
      param2: "value2",
      param3: "value3",
      param4: "value4"
    },
    success: function(offer) {
      adobe.target.applyOffer({
        mbox: "mboxName",
        selector: "#someId",
        offer: offer
      });
    },
    error: function(error) {
      console.error(error);
      var el = document.getElementById("someId");
      el.style.visibility = "visible";
    }
  });
</script>

adobe.target.registerExtension()

Beschreibung:

Stellt eine Standardart zur Registrierung bestimmter Erweiterungen dar.

Dies wird nicht mehr unterstützt und sollte nicht verwendet werden.

Zusammenfassung veralteter, neuer und unterstützter at.js-Funktionen in 2.x

Methode

Unterstützt?

Neu?

Nicht mehr verwendet?

(Standardinhalt wird angezeigt)

getOffer()

Ja

getOffers()

Ja

applyOffer()

Ja

applyOffers()

Ja

triggerView()

Ja

trackEvent()

Ja

mboxCreate()

Ja

mboxDefine()

mboxUpdate()

Ja

targetGlobalSettings()

Ja

Data Providers

Ja

targetPageParams()

Ja

targetPageParamsAll()

Ja

registerExtension()

Ja

At.js Custom Events

Ja

Einschränkungen und Legenden

Beachten Sie die folgenden Einschränkungen und Legenden:

Konversions-Tracking

Kunden, die mboxCreate() für ihr Konversions-Tracking verwenden, müssen trackEvent() oder getOffer() benutzen.

Bereitstellung von Angeboten

Kunden, die mboxCreate() nicht durch getOffer() oder applyOffer() ersetzen, riskieren möglicherweise, dass Angebote nicht bereitgestellt werden.

Kann at.js 2.x auf manchen Seiten verwendet werden, während at.js 1.x ist auf anderen Seiten?

Ja, das Besucherprofil wird über verschiedene Seiten mit verschiedenen Versionen und Bibliotheken hinweg erhalten. Das Cookie-Format ist identisch.

Neue API-Verwendung in at.js 2.x

at.js 2.x verwendet eine neue API, die wir Bereitstellungs-API nennen. Um zu debuggen, ob at.js den Target Edge-Server korrekt aufruft, können Sie die Registerkarte „Netzwerk“ der Entwickler-Tools Ihres Browsers nach „Bereitstellung“, "tt.omtrdc.net" oder Ihrem Client-Code filtern. Sie werden außerdem feststellen, dass Target eine JSON-Nutzlast anstelle von Schlüssel/Wert-Paaren sendet.

Target Globale Mbox wird nicht mehr verwendet

In at.js 2.x wird in den Netzwerkaufrufen kein "target-global-mbox" mehr angezeigt. Stattdessen haben wir in der JSON-Payload, die an die Target-Server gesendet wird, die Syntax "target-global-mbox" durch "execute > pageLoad" ersetzt, wie unten dargestellt:

{
  "id": {
    // ...
  },
  "context": {
    "channel": "web",
    // ...
  },
  "execute": {
    "pageLoad": {}
  }
}

Im Grunde wurde das Konzept der globalen Mbox eingeführt, um Target mitzuteilen, ob Angebote und Inhalt beim Laden der Seite abgerufen werden sollten. Daher haben wir dies in unserer neuesten Version deutlicher gemacht.

Ist der Name der globalen Mbox in at.js nicht mehr wichtig?

Kunden können einen globalen Mbox-Namen über Target > Administration > Implementation > Edit at.js Settings angeben. Diese Einstellung wird von den Target-Edge-Servern verwendet, um „Ausführen > Seite laden“ in den globalen Mbox-Namen zu übersetzen, der in der Target-Benutzeroberfläche angezeigt wird. Dadurch können Kunden mit dem globalen Mbox-Namen weiterhin Server-seitige APIs, den Form-Based Composer und Profilskripts verwenden und Zielgruppen erstellen. Es wird dringend empfohlen, auch auf der Seite Administration > Visual Experience Composer denselben globalen Mbox-Namen zu konfigurieren, falls Sie noch Seiten haben, die at.js 1 verwenden.x, wie in den folgenden Abbildungen gezeigt.

Dialogfeld „at.js ändern“

und

Benutzerdefinierte globale Mbox

Muss die Einstellung für die automatische Erstellung einer globalen Mbox für at.js 2 aktiviert werden?x?

In den meisten Fällen ja. Diese Einstellung teilt at.js 2 mit.x, um beim Laden der Seite eine Anfrage an die Target Edge-Server auszulösen. Da die globale Mbox als „Ausführen > Seite laden“ übersetzt wird, sollte diese Einstellung aktiviert sein, wenn Sie eine Anfrage beim Laden der Seite auslösen möchten.

Funktioniert die VEC-Aktivität weiterhin, auch wenn der Name der globalen Mbox in at.js 2 nicht angegeben ist?x?

Ja, weil „Ausführen > Seite laden“ auf dem Target-Backend wie target-global-mbox behandelt wird.

Wenn meine formularbasierten Aktivitäten auf `target-global-mbox` zielen, funktionieren diese Aktivitäten weiterhin?

Ja, weil „Ausführen > Seite laden“ auf den Target-Edge-Servern wie target-global-mbox behandelt wird.

Unterstützte und nicht unterstützte at.js 2.x-Einstellungen

Einstellung

Unterstützt?

X-Domäne

Nein

Globale Mbox automatisch erstellen

Ja

Globaler Mbox-Name

Ja

Unterstützung für Domain-übergreifendes Tracking in at.js 2.x

Durch domänenübergreifendes Tracking können Besucher auf verschiedenen Domänen verbunden werden. Da für jede Domain ein neues Cookie erstellt werden muss, ist es schwierig, Besucher zu tracken, wenn sie beim Navigation von einer Domain zu einer anderen wechseln. Um domänenübergreifendes Tracking zu ermöglichen, verwendet Target ein Drittanbieter-Cookie, um Besucher über verschiedene Domänen hinweg zu verfolgen. Auf diese Weise können Sie eine Target-Aktivität erstellen, die sich über siteA.com und siteB.com erstreckt, während Besuchern dasselbe Erlebnis angezeigt wird, auch wenn sie die Domain wechseln. Diese Funktion ist mit dem Verhalten von Drittanbietern und Erstanbieter-Cookies von Target verknüpft.

NOTE

Domain-übergreifendes Tracking wird ab at.js 2.10 unterstützt, wird aber in at.js 2 nicht standardmäßig unterstützt.x vor 2.10. Domain-übergreifendes Tracking wird in at.js 2 unterstützt.x über die Experience Cloud ID (ECID)-Bibliothek v 4.3.0+ unterstützt.

Target wird das Drittanbieter-Cookie in <CLIENTCODE>.tt.omtrdc.net gespeichert. Das Erstanbieter-Cookie wird in clientdomain.com gespeichert. Die erste Anfrage gibt HTTP-Antwort-Header zurück, die versuchen, Drittanbieter-Cookies namens mboxSession und mboxPC festzulegen. Eine Weiterleitungsanfrage wird zusammen mit einem zusätzlichen Parameter (mboxXDomainCheck=true) zurückgesendet. Wenn der Browser Drittanbieter-Cookies akzeptiert, enthält die Weiterleitungsanfrage diese Cookies und das Erlebnis wird zurückgegeben. Dieser Arbeitsablauf ist möglich, da wir die HTTP GET-Methode verwenden.

In at.js 2 jedoch.x, HTTP-GET wird nicht verwendet. Stattdessen wird die HTTP-POST über at.js 2 verwendet.x, um JSON-Payloads an Target Edge-Server zu senden Die Verwendung der HTTP-POST bedeutet, dass die Umleitungsanfrage, um zu überprüfen, ob ein Browser Drittanbieter-Cookies unterstützt, beschädigt wird. Dies liegt daran, dass HTTP GET-Anfragen idempotent sind, während HTTP POST nicht idempotent ist und nicht willkürlich wiederholt werden darf. Daher wird domänenübergreifendes Tracking in at.js 2.x (vor 2.10) wird standardmäßig nicht unterstützt. Nur at.js 1.x verfügt über native Unterstützung für domänenübergreifendes Tracking.

Um Domain-übergreifendes Tracking für at.js v2.10 oder höher zu verwenden, haben Sie folgende Möglichkeiten:

Installieren Sie ECID-Bibliothek v4.3.0+ in Verbindung mit at.js 2.x installieren. Die ECID-Bibliothek hat den Zweck, persistente IDs zu verwalten, die zur domänenübergreifenden Identifizierung eines Besuchers verwendet werden können. Nach der Installation der ECID-Bibliothek v 4.3.0 + und at.js 2.x können Sie Aktivitäten erstellen, die mehrere Domänen umfassen und Benutzer tracken können. Beachten Sie, dass diese Funktion erst nach Ablauf der Sitzung funktioniert.
Anstatt die ECID-Bibliothek zu installieren, können Sie bei Verwendung von at.js v2.10 oder höher die Einstellung Domain-übergreifend in der Target-Benutzeroberfläche unter Administration > Implementation aktivieren. (Alternativ können Sie die Option crossDomain im at.js Code auf enabled setzen.)

So verwenden Sie domänenübergreifendes Tracking für Versionen von at.js v2.x Vor 2.10 können Sie die oben stehende Option #1 implementieren (ECID-Bibliothek installieren).

Automatische Erstellung einer globalen Mbox wird unterstützt

Diese Einstellung teilt at.js 2 mit.x, um beim Laden der Seite eine Anfrage an die Target Edge-Server auszulösen. Da die globale Mbox als „Ausführen > Seite laden“ übersetzt wird und dies von den Target-Edge-Servern interpretiert wird, sollten Kunden dies aktivieren, wenn sie eine Anfrage beim Laden der Seite auslösen möchten.

Globaler Mbox-Name wird unterstützt

Kunden können einen globalen Mbox-Namen über Target > Administration > Implementation > Edit angeben. Diese Einstellung wird von den Target-Edge-Servern verwendet, um „Ausführen > Seite laden“ in den eingegebenen globalen Mbox-Namen zu übersetzen. Dadurch können Kunden weiterhin Server-seitige APIs, den formularbasierten Composer und Profilskripts verwenden und Zielgruppen erstellen, die auf die globale Mbox zielen.

Gelten die folgenden benutzerdefinierten at.js-Ereignisse für `triggerView()` oder gilt dies nur für `applyOffer()` oder `applyOffers()`?

adobe.target.event.CONTENT_RENDERING_FAILED
adobe.target.event.CONTENT_RENDERING_SUCCEEDED
adobe.target.event.CONTENT_RENDERING_NO_OFFERS
adobe.target.event.CONTENT_RENDERING_REDIRECT

Ja, die benutzerdefinierten at.js-Ereignisse gelten auch für triggerView().

Wenn ich `triggerView()` mit {`"page" : "true"`} aufrufe, werde eine Benachrichtigung an das Target-Backend gesendet und die Impression erhöht. Führt dies auch dazu, dass die Profilskripts ausgeführt werden?

Wenn ein Prefetch-Aufruf an das Target-Backend erfolgt, werden die Profilskripts ausgeführt. Anschließend werden die betroffenen Profildaten verschlüsselt und an die Client-Seite zurückgegeben. Nachdem triggerView() mit {"page": "true"} aufgerufen wurde, wird eine Benachrichtigung zusammen mit den verschlüsselten Profildaten gesendet. Dann entschlüsselt das Target-Backend die Profildaten und speichert sie in den Datenbanken.

Müssen wir vor dem Aufrufen von `triggerView()` Pre-hiding-Code hinzufügen, um Flackern zu verhindern?

Nein, Sie müssen vor dem Aufrufen von triggerView() keinen Pre-hiding-Code hinzufügen. at.js 2.x verwaltet die Logik des Vorab-Ausblendens und Flackerns, bevor die Ansicht angezeigt und angewendet wird.

Welches at.js 1.x-Parameter zum Erstellen von Zielgruppen werden in at.js 2 nicht unterstützt.x?

Die folgenden at.js 1.x-Parameter werden NICHT derzeit für die Erstellung von Zielgruppen bei Verwendung von at.js 2 unterstützt.x:

browserHeight
browserWidth
browserTimeOffset
screenHeight
screenWidth
screenOrientation
colorDepth
devicePixelRatio
vst.* Parameter (siehe unten)

at.js 2.x unterstützt nicht das Erstellen von Zielgruppen unter Verwendung von vst.* Parameter

Kunden mit at.js 1.x konnten VST verwenden.* Mbox-Parameter zum Erstellen von Zielgruppen. Dies war ein unbeabsichtigter Nebeneffekt von at.js 1.x hat Mbox-Parameter an das Target-Backend gesendet. Nach der Migration zu at.js 2.x können Sie mit diesen Parametern keine Zielgruppen mehr erstellen, da at.js 2.x sendet Mbox-Parameter unterschiedlich.

Kompatibilität von at.js

Die folgenden Tabellen erläutern die at.js. 2.x Kompatibilität mit verschiedenen Aktivitätstypen, Integrationen, Funktionen und at.js-Funktionen.

Aktivitätstypen

Typ

Unterstützt?

A/B Test

Ja

Auto-Allocate

Ja

Auto-Target

Ja

Experience Targeting

Ja

Multivariate Test

Ja

Automated Personalization

Ja

Recommendations

Ja

NOTE

Auto-Target-Aktivitäten werden über at.js 2 unterstützt.x und VEC, wenn alle Änderungen auf die Page Load Event angewendet werden. Wenn Änderungen an bestimmten Ansichten hinzugefügt werden, werden nur A/B Test-, Auto-Allocate- und Experience Targeting (XT)-Aktivitäten unterstützt.

Integrationen

Typ

Unterstützt?

Analytics for Target (A4T)

Ja

Zielgruppen

Ja

Kundenattribute

Ja

AEM-Experience Fragments

Ja

Adobe Experience Platform-Erweiterung

Ja

Debugger

Ja

Auditor

Regeln für at.js 2 wurden noch nicht aktualisiert.x

Opt-in-Unterstützung für DSGVO

Dies wird in at.js-Version 2.1.0höher unterstützt.

AEM Enhanced Personalization powered by Adobe Target

Nein

Funktionen

Funktion

Unterstützt?

X-Domäne

Nein

Eigenschaften/Workspaces

Ja

QA-Links

Ja

Form-Based Experience Composer

Ja

Visual Experience Composer (VEC)

Ja

Benutzerspezifischer Code

Ja

Antwort-Token

Ja

Klick-Tracking

Ja

Bereitstellung mehrerer Aktivitäten

Ja

targetGlobalSettings

Ja (jedoch nicht X-Domäne)

at.js-Methoden

Alles wird unterstützt, mit Ausnahme von

mboxCreate()

mboxUpdate()

mboxDefine()

, der den Standardinhalt anzeigt.

Abfragezeichenfolge-Parameter

Parameter

Unterstützt?

?mboxDisable

Ja

?mboxDisable

Ja

?mboxTrace

Ja

?mboxSession

Nein

?mboxOverride.browserIp

Ja

Antwort-Token

at.js 2.x verwendet genau wie at.js 1.x das benutzerdefinierte Ereignis at-request-succeeded zu den Antworttoken. Codebeispiele, die das at-request-succeeded benutzerdefinierte Ereignis verwenden, finden Sie unter Antwort-Token.

at.js 1.x-Parameter an at.js 2.x-Payload-Zuordnung

In diesem Abschnitt werden die Zuordnungen zwischen at.js 1.x und in at.js 2.x.

Beachten Sie vor dem Befassen mit der Parameterzuordnung, dass sich die Endpunkte, die diese Bibliotheksversionen verwenden, geändert haben:

at.js 1.x - http://<client code>.tt.omtrdc.net/m2/<client code>/mbox/json
at.js 2.x - http://<client code>.tt.omtrdc.net/rest/v1/delivery

Ein weiterer wichtiger Unterschied besteht darin, dass:

at.js 1.x - Client-Code ist Teil des Pfads
at.js 2.x - Client-Code wird als Abfragezeichenfolgen-Parameter gesendet, z. B.:
http://<client code>.tt.omtrdc.net/rest/v1/delivery?client=democlient

Die folgenden Abschnitte listen jeden at.js 1.x-Parameter, seine Beschreibung und der entsprechende 2.x JSON-Payload (falls zutreffend):

at_property

(at.js 1.x-Parameter)

Wird für Unternehmens-Benutzerberechtigungen verwendet.

{
  ....
  "property": {
    "token": "1213213123122313121"
  }
  ....
}

mboxHost

(at.js 1.x-Parameter)

Die Domain der Seite, auf der die Target ausgeführt wird.

at.js 2.x JSON-Payload:

{
  "context": {
    "browser": {
       "host": "test.com"
    }
  }
}

webGLRenderer

(at.js 1.x-Parameter)

Die WEB-GL-Renderer-Funktionen des Browsers. Dies wird von unserem Geräteerkennungsmechanismus verwendet, um festzustellen, ob das Gerät des Besuchers ein Desktop, iPhone, Android-Gerät usw. ist.

at.js 2.x JSON-Payload:

{
  "context": {
    "browser": {
       "webGLRenderer": "AMD Radeon Pro 560X OpenGL Engine"
    }
  }
}

mboxURL

(at.js 1.x-Parameter)

Die Seiten-URL.

at.js 2.x JSON-Payload:

{
  "context": {
    "address": {
       "url": "http://test.com"
    }
  }
}

mboxReferrer

(at.js 1.x-Parameter)

Der Seitenverweis.

at.js 2.x JSON-Payload:

{
  "context": {
    "address": {
       "referringUrl": "http://google.com"
    }
  }
}

mbox (der Name) entspricht der globalen Mbox

(at.js 1.x-Parameter)

Die Bereitstellungs-API hat kein globales Mbox-Konzept mehr. In der JSON-Nutzlast müssen Sie execute > pageLoad verwenden.

at.js 2.x JSON-Payload:

{
  "execute": {
    "pageLoad": {
       "parameters": ....
       "profileParameters": ...
       .....
    }
  }
}

mbox (der Name) entspricht nicht der globalen Mbox

(at.js 1.x-Parameter)

Um einen Mbox-Namen zu verwenden, übergeben Sie ihn an execute > mboxes. Eine Mbox erfordert einen Index und einen Namen.

at.js 2.x JSON-Payload:

{
  "execute": {
    "mboxes": [{
       "index": 0,
       "name": "some-mbox",
       "parameters": ....
       "profileParameters": ...
       .....
    }]
  }
}

mboxId

(at.js 1.x-Parameter)

Wird nicht mehr länger verwendet.

mboxCount

(at.js 1.x-Parameter)

Wird nicht mehr länger verwendet.

mboxRid

(at.js 1.x-Parameter)

Von Downstream-Systemen verwendete Anforderungs-ID zur Hilfe beim Debugging.

at.js 2.x JSON-Payload:

{
  "requestId": "2412234442342"
  ....
}

mboxTime

(at.js 1.x-Parameter)

Wird nicht mehr länger verwendet.

mboxSession

(at.js 1.x-Parameter)

Sitzungs-ID wird als Abfragezeichenfolgenparameter (sessionId) zum Bereitstellungs-API-Endpunkt gesendet.

mboxPC

(at.js 1.x-Parameter)

Die TNT-ID wird an id > tntId übergeben.

at.js 2.x JSON-Payload:

{
  "id": {
    "tntId": "ca5ddd7e33504c58b70d45d0368bcc70.21_3"
  }
  ....
}

mboxMCGVID

(at.js 1.x-Parameter)

Experience Cloud-Besucher-ID wird an id > marketingCloudVisitorId übergeben.

at.js 2.x JSON-Payload:

{
  "id": {
    "marketingCloudVisitorId": "797110122341429343505"
  }
  ....
}

`vst.aaaa.id` und `vst.aaaa.authState`

(at.js 1.x -Parameter)

Kunden-IDs sollten an id > customerIds übergeben werden.

at.js 2.x JSON-Payload:

{
  "id": {
    "customerIds": [{
       "id": "1232131",
       "integrationCode": "aaaa",
       "authenticatedState": "....."
     }]
  }
  ....
}

mbox3rdPartyId

(at.js 1.x-Parameter)

Kunden-Third-Party-ID, die zur Verknüpfung verschiedener Target-IDs verwendet wird.

at.js 2.x JSON-Payload:

{
  "id": {
    "thirdPartyId": "1232312323123"
  }
  ....
}

mboxMCSDID

(at.js 1.x-Parameter)

SDID, auch als zusätzliche Daten-ID bekannt. Sollte an experienceCloud > analytics > supplementalDataId übergeben werden.

at.js 2.x JSON-Payload:

{
  "experienceCloud": {
    "analytics": {
      "supplementalDataId": "1212321132123131"
    }
  }
  ....
}

vst.trk

(at.js 1.x-Parameter)

Trackingserver Analytics. Sollte an experienceCloud > analytics > trackingServer übergeben werden.

at.js 2.x JSON-Payload:

{
  "experienceCloud": {
    "analytics": {
      "trackingServer": "analytics.test.com"
    }
  }
  ....
}

vst.trks

(at.js 1.x-Parameter)

Sicherer Analytics-Tracking-Server. Sollte an experienceCloud > analytics > trackingServerSecure übergeben werden.

at.js 2.x JSON-Payload:

{
  "experienceCloud": {
    "analytics": {
      "trackingServerSecure": "secure-analytics.test.com"
    }
  }
  ....
}

mboxMCGLH

(at.js 1.x-Parameter)

Audience Manager-Standorthinweis. Sollte an experienceCloud > audienceManager > locationHint übergeben werden.

at.js 2.x JSON-Payload:

{
  "experienceCloud": {
    "audienceManager": {
      "locationHint": 9
    }
  }
  ....
}

mboxAAMB

(at.js 1.x-Parameter)

Audience Manager-Blob. Sollte an experienceCloud > audienceManager > blob übergeben werden.

at.js 2.x JSON-Payload:

{
  "experienceCloud": {
    "audienceManager": {
      "blob": "2142342343242342"
    }
  }
  ....
}

mboxVersion

(at.js 1.x-Parameter)

Version wird als Abfragezeichenfolgenparameter über den Versionsparameter gesendet.

Schulungsvideo: at.js 2.x Architekturdiagramm

at.js 2.x erweitert die Unterstützung von Adobe Target für SPA und integriert sich in andere Experience Cloud-Lösungen. In diesem Video wird erklärt, wie alles zusammenkommt.

video poster

https://video.tv.adobe.com/v/26250/?quality=12

Siehe So verstehen Sie at.js 2.x funktioniert für weitere Informationen.

recommendation-more-help

Aktualisieren von at.js 1.x auf at.js 2.x

at.js 2.x Systemdiagramme

Bereitstellen von at.js 2 x

Nicht mehr unterstützte Funktionen von at.js

mboxCreate(mbox,params)

„mboxDefine()“ und „mboxUpdate()“

adobe.target.registerExtension()

Zusammenfassung veralteter, neuer und unterstützter at.js-Funktionen in 2.x

Einschränkungen und Legenden

Konversions-Tracking

Bereitstellung von Angeboten

Kann at.js 2.x auf manchen Seiten verwendet werden, während at.js 1.x ist auf anderen Seiten?

Neue API-Verwendung in at.js 2.x

Target Globale Mbox wird nicht mehr verwendet

Ist der Name der globalen Mbox in at.js nicht mehr wichtig?

Muss die Einstellung für die automatische Erstellung einer globalen Mbox für at.js 2 aktiviert werden?x?

Funktioniert die VEC-Aktivität weiterhin, auch wenn der Name der globalen Mbox in at.js 2 nicht angegeben ist?x?

Wenn meine formularbasierten Aktivitäten auf target-global-mbox zielen, funktionieren diese Aktivitäten weiterhin?

Unterstützte und nicht unterstützte at.js 2.x-Einstellungen

Unterstützung für Domain-übergreifendes Tracking in at.js 2.x

Automatische Erstellung einer globalen Mbox wird unterstützt

Globaler Mbox-Name wird unterstützt

Gelten die folgenden benutzerdefinierten at.js-Ereignisse für triggerView() oder gilt dies nur für applyOffer() oder applyOffers()?

Wenn ich triggerView() mit {"page" : "true"} aufrufe, werde eine Benachrichtigung an das Target-Backend gesendet und die Impression erhöht. Führt dies auch dazu, dass die Profilskripts ausgeführt werden?

Müssen wir vor dem Aufrufen von triggerView() Pre-hiding-Code hinzufügen, um Flackern zu verhindern?

Welches at.js 1.x-Parameter zum Erstellen von Zielgruppen werden in at.js 2 nicht unterstützt.x?

at.js 2.x unterstützt nicht das Erstellen von Zielgruppen unter Verwendung von vst.* Parameter

Kompatibilität von at.js

Aktivitätstypen

Integrationen

Funktionen

Abfragezeichenfolge-Parameter

Antwort-Token

at.js 1.x-Parameter an at.js 2.x-Payload-Zuordnung

at_property

mboxHost

webGLRenderer

mboxURL

mboxReferrer

mbox (der Name) entspricht der globalen Mbox

mbox (der Name) entspricht nicht der globalen Mbox

mboxId

mboxCount

mboxRid

mboxTime

mboxSession

mboxPC

mboxMCGVID

vst.aaaa.id und vst.aaaa.authState

mbox3rdPartyId

mboxMCSDID

vst.trk

vst.trks

mboxMCGLH

mboxAAMB

mboxVersion

Schulungsvideo: at.js 2.x Architekturdiagramm

Wenn meine formularbasierten Aktivitäten auf `target-global-mbox` zielen, funktionieren diese Aktivitäten weiterhin?

Gelten die folgenden benutzerdefinierten at.js-Ereignisse für `triggerView()` oder gilt dies nur für `applyOffer()` oder `applyOffers()`?

Wenn ich `triggerView()` mit {`"page" : "true"`} aufrufe, werde eine Benachrichtigung an das Target-Backend gesendet und die Impression erhöht. Führt dies auch dazu, dass die Profilskripts ausgeführt werden?

Müssen wir vor dem Aufrufen von `triggerView()` Pre-hiding-Code hinzufügen, um Flackern zu verhindern?

`vst.aaaa.id` und `vst.aaaa.authState`