Aktualisieren von at.js 1.x bis 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 zu verstehen.x mit Ansichten und wie dies die SPA-Integration verbessert. Eine bessere Einführung in die in at.js 2 verwendeten Konzepte.x, siehe Implementierung von Einzelseiten-Apps.

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

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

Bereitstellen von at.js 2 x

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

Nicht mehr unterstützte Funktionen von at.js

Es gibt mehrere Funktionen, die in at.js 2 nicht mehr unterstützt werden.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 vorhanden?

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

Neue API 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 den Target -Edge-Server korrekt aufruft, können Sie die Registerkarte "Netzwerk"in den Entwicklerwerkzeugen Ihres Browsers nach "Bereitstellung", "tt.omtrdc.net"oder Ihrem Clientcode 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, sehen Sie "target-global-mbox"nicht mehr in den Netzwerkaufrufen. Stattdessen haben wir die "target-global-mbox"-Syntax in der JSON-Payload, die an die Target -Server gesendet wird, in "execute > pageLoad"ersetzt:

{
  "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. Wir empfehlen dringend, dass Sie auch sicherstellen, dass derselbe globale Mbox-Name auch auf der Seite Administration > Visual Experience Composer konfiguriert ist, falls Sie noch Seiten haben, die at.js 1.x, wie in den folgenden Abbildungen dargestellt.

und

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

In den meisten Fällen ja. Diese Einstellung gibt at.js 2 an.x , um beim Laden der Seite eine Anfrage an die Target -Edge-Server zu senden. 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 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 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 erstellen, die siteA.com und siteB.com umfasst und Besuchern beim Navigieren über individuelle Domänen dasselbe Erlebnis bleibt. Diese Funktion ist mit dem Verhalten von Drittanbieter- und Erstanbieter-Cookies von Target verknüpft.

In 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.x, HTTP-GET wird nicht verwendet. Stattdessen wird die HTTP-POST über at.js 2 verwendet.x , um JSON-Nutzlasten an Target 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) wird nicht standardmäßig 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, können Sie Option 1 oben implementieren (Installation der ECID-Bibliothek).

Automatische Erstellung einer globalen Mbox wird unterstützt

Diese Einstellung gibt at.js 2 an.x , um 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 > 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"&rbrace aufrufe, wird 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 Pre-hiding- und Flacker-Logik, bevor die Ansicht angezeigt und angewendet wird.

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

Die folgenden at.js 1.x-Parameter werden derzeit für die Erstellung von Zielgruppen bei der Verwendung von at.js 2 NOT 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 hat Mbox-Parameter an das Backend Target 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 auf 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, 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 wird.

at.js 2.x JSON-Nutzlast:

{
  "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-Nutzlast:

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

mboxURL

(at.js 1.x-Parameter)

Die Seiten-URL.

at.js 2.x JSON-Nutzlast:

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

mboxReferrer

(at.js 1.x-Parameter)

Der Seitenverweis.

at.js 2.x JSON-Nutzlast:

{
  "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-Nutzlast:

{
  "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-Nutzlast:

{
  "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-Nutzlast:

{
  "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-Nutzlast:

{
  "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-Nutzlast:

{
  "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-Nutzlast:

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

mbox3rdPartyId

(at.js 1.x-Parameter)

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

at.js 2.x JSON-Nutzlast:

{
  "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-Nutzlast:

{
  "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-Nutzlast:

{
  "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-Nutzlast:

{
  "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-Nutzlast:

{
  "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-Nutzlast:

{
  "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 verbessert die Unterstützung von Adobe Target für SPA und kann mit anderen Experience Cloud-Lösungen integriert werden. In diesem Video wird erklärt, wie alles zusammenkommt.

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