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.

Hier einige Vorteile der Verwendung von at.js 2.x, die in früheren Versionen nicht verfügbar sind:

at.js 2.x - Systemdiagramme

Die folgenden Diagramme helfen Ihnen, den Arbeitsablauf von at.js 2.x mit View zu verstehen und wie dieser die SPA-Integration verbessert. Eine bessere Einführung in die in at.js 2.x verwendeten Konzepte finden Sie unter Implementieren von Einzelseiten-Apps.

(Klicken Sie auf Bild , um die volle Breite zu vergrößern.)

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

(Klicken Sie auf Bild , um die volle Breite zu vergrößern.)

{modal="regular"}

Bereitstellen von at.js 2 x

Bereitstellen von at.js 2 x über Tags in Adobe Experience Platform -Erweiterung.

Nicht mehr unterstützte Funktionen von at.js

Es gibt mehrere Funktionen, die in at.js 2.x nicht mehr unterstützt werden.

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.

Übersicht über veraltete, neue und unterstützte Funktionen in at.js 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 auf anderen Seiten?

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

Neue API-Nutzung in at.js 2.x

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

Target Global Mbox wird nicht mehr verwendet

In at.js 2.x nicht mehr angezeigt wird "target-global-mbox" in den Netzwerkaufrufen sichtbar. Stattdessen haben wir dietarget-global-mbox" Syntax zu "execute > pageLoad" in der JSON-Payload an die Target -Server, 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 > Implementierung > "at.js"-Einstellungen bearbeiten. 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. Wir empfehlen dringend, dass Sie auch sicherstellen, dass derselbe globale Mbox-Name für die Administration > Visual Experience Composer auch dann, wenn Sie noch Seiten haben, die at.js 1 verwenden.x, wie in den folgenden Abbildungen dargestellt.

und

Muss die Einstellung „Globale Mbox automatisch erstellen“ für at.js 2.x aktiviert sein?

In den meisten Fällen ja. Diese Einstellung teilt at.js 2.x mit, dass beim Laden der Seite eine Anfrage an die Target-Edge-Server gesendet wird. 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.

Funktionieren vorhandene VEC-Aktivitäten weiterhin, auch wenn der Zielname der globalen Mbox nicht in at.js 2.x angegeben ist?

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 von domänenübergreifendem 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, die sich über siteA.com und siteB.com und Besucher bleiben beim Navigieren über eindeutige Domänen im selben Erlebnis. Diese Funktion ist in Targetdas Verhalten von Drittanbieter- und Erstanbieter-Cookies.

In Target, wird das Drittanbieter-Cookie in <CLIENTCODE>.tt.omtrdc.net. Das Erstanbieter-Cookie wird in clientdomain.com. 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.x, wird HTTP-GET nicht verwendet. Stattdessen wird die HTTP-POST über at.js 2 verwendet.x Target verwendet, um JSON-Payloads an Edge-Server zu senden. Die Verwendung von HTTP-POST bedeutet, dass die Weiterleitungsanfrage zur Überprüfung, 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) nicht nativ unterstützt. Nur at.js 1.x verfügt über native Unterstützung für domänenübergreifendes Tracking.

Um domänenübergreifendes Tracking für at.js v2.10 oder höher zu verwenden, können Sie eine der folgenden Aktionen durchführen:

Verwenden des domänenübergreifenden Trackings für Versionen von at.js v2.x vor 2.10 implementieren Sie möglicherweise Option 1 oben (installieren Sie die ECID-Bibliothek).

Automatische Erstellung einer globalen Mbox wird unterstützt

Diese Einstellung veranlasst at.js 2.x beim Laden der Seite eine Anfrage an die Target-Edge-Server zu senden. 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 > Implementierung > Bearbeiten. 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().

Es heißt, wenn ich triggerView() mit {"page" : "true"&brace; es sendet eine Benachrichtigung an die Target -Backend verwenden und die Impression erhöhen. 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 Pre-Hiding- und Flacker-Logik, 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 sind: NOT wird 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 konnte vst verwenden.* Mbox-Parameter zur Erstellung von Zielgruppen. Dies war eine unbeabsichtigte Nebenwirkung von at.js 1.x mbox-Parameter an die Target Backend. 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 auf at.js 2.x Payload-Mapping

In diesem Abschnitt werden die Zuordnungen zwischen at.js 1.x und 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, dessen Beschreibung und die entsprechenden 2.x JSON-Nutzlast (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 Domäne der Seite, auf der die Target -Bibliothek ausgeführt.

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-Drittanbieter-ID, die zur Verknüpfung verschiedener Target IDs.

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)

Analytics-Tracking-Server. ​ 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 Verbesserung der Adobe Targetunterstützt SPA und integriert in andere Experience Cloud-Lösungen. In diesem Video wird erklärt, wie alles zusammenkommt.

Siehe Grundlagen zu at.js 2.x works für weitere Informationen.