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

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:

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.)

{modal="regular"}

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-Back-End, um Impressions-Zählungen zu erhöhen und aufzuzeichnen.

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

{modal="regular"}

Bereitstellen von at.js 2 x

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

Nicht mehr unterstützte Funktionen von at.js

Es gibt mehrere Funktionen, die in at.js 2 veraltet sind.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.

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

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-global-mbox-Server gesendet wird, die Syntax “execute > pageLoad” durch “Target” 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.

und

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

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.

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 Workflow ist möglich, da wir die HTTP GET-Methode verwenden.

In at.js 2 jedoch.x, HTTP-GET wird nicht verwendet. Stattdessen wird HTTP POST über at.js 2 verwendet.x, um JSON-Payloads an Target Edge-Server zu senden Die Verwendung von 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:

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()?

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:

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

Integrationen

Funktionen

Abfragezeichenfolge-Parameter

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:

Ein weiterer wichtiger Unterschied besteht darin, dass:

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 SPAs und integriert diese in andere Experience Cloud-Lösungen. In diesem Video wird erklärt, wie alles zusammenkommt.

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