Dokumentation Target Target-Entwicklerhandbuch

targetGlobalSettings()

Letzte Aktualisierung: 5. Mai 2025

Themen:

Erstellt für:

Entwickler

Sie können Einstellungen in der at.js-Bibliothek mithilfe von targetGlobalSettings() überschreiben, anstatt sie in der Target-Benutzeroberfläche oder durch Verwendung von REST-APIs zu konfigurieren.

Einstellungen

Folgende Einstellungen können überschrieben werden:

aepSandboxId

Typ: String
Standardwert: null
Beschreibung: Optionaler Parameter, der zum Senden Adobe Experience Platform Sandbox-ID verwendet wird, um Adobe Experience Platform in der nicht standardmäßigen Sandbox erstellten Ziele für Target freizugeben. Wenn aepSandboxId nicht null ist, muss aepSandboxName ebenfalls angegeben werden.

aepSandboxName

Typ: String
Standardwert: null
Beschreibung: Optionaler Parameter, der zum Senden Adobe Experience Platform Sandbox-Namens verwendet wird, um Adobe Experience Platform in der nicht standardmäßigen Sandbox erstellten Ziele für Target freizugeben. Wenn aepSandboxName nicht null ist, muss aepSandboxId ebenfalls angegeben werden.

artifactLocation

Typ: String
Standardwert: keine
Beschreibung: Eine vollständig qualifizierte URL zum Artefakt der geräteinternen Entscheidungsregel

bodyHiddenStyle

Typ: String
Standardwert: body
Beschreibung: Wird nur verwendet, wenn globalMboxAutocreate === true, um die Wahrscheinlichkeit eines Flackerns zu minimieren.

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

bodyHidingEnabled

Typ: Boolean
Standardwert: wahr
Beschreibung: Wird zur Verminderung eines Flackerns eingesetzt, wenn target-global-mbox verwendet wird, um in Visual Experience Composer erstellte Angebote, auch „visuelle Angebote“ genannt, bereitzustellen.

clientCode

Typ: String
Standardwert: Wert, der über die Benutzeroberfläche festgelegt wird.
Beschreibung: Stellt den Clientcode dar.

cookieDomain

Typ: String
Standardwert: Legen Sie nach Möglichkeit die Domäne auf oberster Ebene fest.
Beschreibung: Steht für die Domäne, die beim Speichern von Cookies verwendet wird.

crossDomain

Typ: String
Standardwert: Wert, der über die Benutzeroberfläche festgelegt wird.
Beschreibung: Gibt an, ob domänenübergreifende Verfolgung aktiviert ist oder nicht. Die zulässigen Werte hängen von Ihrer at.js-Version ab. Für at.js v1.x, geben Sie an, ob domänenübergreifende Funktionen disabled sind (Browser setzen Cookies nur in Ihrer Domain (Erstanbieter-Cookies), x only (Browser setzen Cookies nur in der Domain von Target) oder beides, indem Sie enabled auswählen (Browser setzen sowohl Cookies von Erstanbietern als auch von Drittanbietern). Geben Sie für at.js v2.10 und höher an, ob domänenübergreifende Funktionen enabled (Browser setzen sowohl Cookies von Erstanbietern als auch von Drittanbietern) oder disabled (Browser setzen keine Cookies von Drittanbietern) sind.

cspScriptNonce

Typ: Siehe Content Security-Richtlinie weiter unten.
Standardwert: Siehe Content Security-Richtlinie weiter unten.
Beschreibung: Siehe Content Security-Richtlinie weiter unten.

cspStyleNonce

Typ: Siehe Content Security-Richtlinie weiter unten.
Standardwert: Siehe Content Security-Richtlinie weiter unten.
Beschreibung: Siehe Content Security-Richtlinie weiter unten.

dataProviders

Typ: Siehe Daten-Anbieter weiter unten.
Standardwert: Siehe Datenanbieter unten.
Beschreibung: Siehe Daten-Anbieter weiter unten.

decisioningMethod

Typ: String
Standardwert: Server-seitig
Andere Werte: On-Device, Hybrid
Beschreibung: Siehe Entscheidungsmethoden weiter unten.

Entscheidungsmethoden

Bei der Entscheidungsfindung auf dem Gerät führt Target eine neue Einstellung namens Entscheidungsmethode ein, die bestimmt, wie at.js Ihre Erlebnisse bereitstellt. decisioningMethod hat drei Werte: nur Server-seitig, nur auf dem Gerät und hybrid. Wenn decisioningMethod in targetGlobalSettings() festgelegt ist, fungiert es als Standard-Entscheidungsmethode für alle Target-Entscheidungen.

Nur Server-seitig:

Nur Server-seitig ist die standardmäßige Entscheidungsmethode, die vorkonfiguriert ist, wenn at.js 2.5+ implementiert und in Ihren Web-Eigenschaften bereitgestellt wird.

Die Verwendung von Nur Server-seitig als Standardkonfiguration bedeutet, dass alle Entscheidungen im Target Edge Network getroffen werden, was einen blockierenden Server-Aufruf beinhaltet. Dieser Ansatz kann zu einer inkrementellen Latenz führen, bietet aber auch erhebliche Vorteile, z. B. die Möglichkeit, die maschinellen Lernfunktionen von Target anzuwenden, zu denen die Aktivitäten Recommendations, Automated Personalization (AP) und Automatisches Targeting gehören.

Darüber hinaus kann die Verbesserung Ihrer personalisierten Erlebnisse mithilfe des Benutzerprofils von Target, das sitzungs- und kanalübergreifend beibehalten wird, leistungsstarke Ergebnisse für Ihr Unternehmen liefern.

Schließlich erlaubt Ihnen Nur Server-seitig , die Adobe Experience Cloud zu verwenden und Zielgruppen anzupassen, die über Audience Manager- und Adobe Analytics-Segmente angesprochen werden können.

Nur auf dem Gerät:

Nur auf dem Gerät ist die Entscheidungsmethode, die in at.js 2.5 oder höher festgelegt werden muss, wenn die Entscheidungsfindung auf dem Gerät nur auf Ihren Web-Seiten verwendet werden soll.

Die Entscheidungsfindung auf dem Gerät kann Ihre Erlebnisse und Personalisierungsaktivitäten schnell bereitstellen, da die Entscheidungen aus einem zwischengespeicherten Regelartefakt getroffen werden, das all Ihre Aktivitäten enthält, die für die Entscheidungsfindung auf dem Gerät qualifiziert sind.

Weitere Informationen dazu, welche Aktivitäten für die Entscheidungsfindung auf dem Gerät qualifiziert sind, finden Sie im Abschnitt „Unterstützte Funktionen“.

Diese Entscheidungsmethode sollte nur verwendet werden, wenn die Leistung auf allen Seiten, für die Entscheidungen von Target erforderlich sind, äußerst kritisch ist. Beachten Sie außerdem, dass bei Auswahl dieser Entscheidungsmethode Ihre Target-Aktivitäten, die nicht für die Entscheidungsfindung auf dem Gerät qualifiziert sind, nicht bereitgestellt bzw. ausgeführt werden. Die Bibliothek at.js 2.5+ ist so konfiguriert, dass nur nach dem zwischengespeicherten Regelartefakt gesucht wird, um Entscheidungen zu treffen.

Hybrid:

Hybrid ist die Entscheidungsmethode, die in at.js 2.5 oder höher festgelegt werden muss, wenn sowohl Entscheidungen auf dem Gerät als auch Aktivitäten, die einen Netzwerkaufruf an das Adobe Target Edge-Netzwerk erfordern, ausgeführt werden müssen.

Wenn Sie sowohl Entscheidungsaktivitäten auf dem Gerät als auch Server-seitige Aktivitäten verwalten, kann es bei der Bereitstellung von Target auf Ihren Seiten etwas kompliziert und mühsam werden. Bei „Hybrid“ als Entscheidungsmethode weiß Target, wann ein Server-Aufruf an das Adobe Target Edge-Netzwerk für Aktivitäten durchgeführt werden muss, für die eine Server-seitige Ausführung erforderlich ist, und wann nur Entscheidungen auf dem Gerät ausgeführt werden sollen.

Das JSON-Regelartefakt enthält Metadaten, die at.js darüber informieren, ob eine Mbox eine Server-seitige Aktivität ausführt oder eine Entscheidungsaktivität auf dem Gerät aufweist. Diese Entscheidungsmethode stellt sicher, dass Aktivitäten, die Sie schnell bereitstellen möchten, über Entscheidungsfindung auf dem Gerät durchgeführt werden und für Aktivitäten, die eine leistungsfähigere ML-gesteuerte Personalisierung erfordern, diese Aktivitäten über das Adobe Target Edge-Netzwerk erfolgen.

defaultContentHiddenStyle

Typ: String
Standardwert: Sichtbarkeit: ausgeblendet
Beschreibung: Wird nur für das Umbrechen von Mboxes verwendet, bei denen DIV mit dem Klassennamen „mboxDefault“ eingesetzt wird und die über mboxCreate(), mboxUpdate() oder mboxDefine() ausgeführt werden, um Standardinhalte auszublenden.

defaultContentVisibleStyle

Typ: String
Standardwert: Sichtbarkeit: sichtbar
Beschreibung: Wird nur für das Umbrechen von Mboxes verwendet, bei denen DIV mit dem Klassennamen „mboxDefault“ eingesetzt wird und die über mboxCreate(), mboxUpdate() oder mboxDefine() ausgeführt werden, um Standardinhalte oder angewendete Angebote einzublenden.

deviceIdLifetime

Typ: Zahl
Standardwert: 63244800000 ms = 2 Jahre
Beschreibung: Die Dauer von deviceId wird in Cookies beibehalten.

NOTE

Die Einstellung deviceIdLifetime kann in at.js Version 2.3.1 oder höher überschrieben werden.

aktiviert

Typ: Boolean
Standardwert: wahr
Beschreibung: Wenn diese Option aktiviert ist, wird automatisch eine Target-Anfrage zum Abrufen von Erlebnissen und DOM-Manipulationen zum Rendern der Erlebnisse ausgeführt. Außerdem können Target-Aufrufe manuell über getOffer(s) / applyOffer(s) ausgeführt werden.

Wenn diese Option deaktiviert ist, werden Target-Anforderungen nicht automatisch oder manuell ausgeführt.

globalMboxAutoCreate

Typ: Zahl
Standardwert: Wert, der über die Benutzeroberfläche festgelegt wird.
Beschreibung: Gibt an, ob die globale mbox-Anfrage gestellt werden soll oder nicht.

imsOrgId

Typ: String
Standardwert: wahr
Beschreibung: Steht für die IMS-ORG-ID.

optinEnabled

Typ: Boolean
Standardwert: falsch
Beschreibung: Target unterstützt die Opt-in-Funktionalität über Adobe Experience Platform und hilft Ihnen bei der Einwilligungsverwaltung. Mit der Opt-in-Funktion können Kunden steuern, wie und wann das Target-Tag ausgelöst wird. Es gibt auch eine Option über Adobe Experience Platform, um das Target-Tag vorab zu genehmigen. Um die Möglichkeit der Verwendung von Opt-in in der Target-at.js-Bibliothek zu aktivieren, fügen Sie die Einstellung optinEnabled=true hinzu. In Adobe Experience Platform müssen Sie in der Dropdown-Liste DSGVO-Opt-in im Installationsfenster der Erweiterung „Aktivieren“ auswählen. Weitere Informationen finden Sie in der Adobe Experience Platform-Dokumentation. Weitere Informationen zu dieser Einstellung in Bezug auf Datenschutz und Datenschutzbestimmungen, einschließlich der Datenschutz-Grundverordnung (DSGVO) der Europäischen Union und des California Consumer Privacy Act (CCPA), finden Sie unter Datenschutz und Datenschutzbestimmungen.

optoutEnabled

Typ: Boolean
Standardwert: falsch
Beschreibung: Gibt an, ob Target die Besucher-API-isOptedOut() aufrufen soll. Diese Funktion ist Teil der Aktivierung für Gerätediagramme.

overrideMboxEdgeServer

Typ: Boolean
Standardwert: wahr (ab at.js-Version 1.6.2)
Beschreibung: Zeigt an, ob die Domäne <clientCode>.tt.omtrdc.net oder die Domäne mboxedge<clusterNumber>.tt.omtrdc.net verwendet werden soll.

Ist dieser Wert wahr, wird die Domäne mboxedge<clusterNumber>.tt.omtrdc.net in einem Cookie gespeichert. Funktioniert derzeit nicht mit CNAME bei der Verwendung von at.js-Versionen vor at.js 1.8.2 und at.js 2.3.1. Wenn dies ein Problem für Sie ist, sollten Sie at.js evtl. auf eine neuere, unterstützte Version aktualisieren.

overrideMboxEdgeServerTimeout

Typ: Zahl
Standardwert: 1860000 =>; 31 Minuten
Beschreibung: Zeigt die Gültigkeitsdauer des Cookies an, in dem der Wert mboxedge<clusterNumber>.tt.omtrdc.net gespeichert wurde.

pageLoadEnabled

Typ: Boolean
Standardwert: wahr
Beschreibung: Wenn diese Option aktiviert ist, werden automatisch Erlebnisse abgerufen, die beim Laden der Seite zurückgegeben werden müssen.

Abrufintervall

Typ: Zahl
Standardwert: 300000 (fünf Minuten in Millisekunden)
Beschreibung: Das Intervall, in dem at.js eine neue Version eines geräteinternen Entscheidungsartefakts abruft und den Cache aktualisiert. 300000 ist der zulässige Mindestwert für pollingInterval.

secureOnly

Typ: Boolean
Standardwert: falsch
Beschreibung: Zeigt an, ob at.js nur HTTPS verwenden sollte oder es ermöglicht wird, dass basierend auf dem Seitenprotokoll zwischen HTTP und HTTPS umgeschaltet wird. Wenn es auf „wahr“ gesetzt ist, setzt secureOnly auch die Attribute „Secure“ und „SameSite“ auf das mbox-Cookie.

selectorsPollingTimeout

Typ: Zahl
Standardwert: 5000 ms = 5 s
Beschreibung: In at.js 0.9.6 führte Target diese neue Einstellung ein, die über targetGlobalSettings außer Kraft gesetzt werden kann.

selectorsPollingTimeout gibt an, wie lange der Kunde bereit ist, darauf zu warten, dass sämtliche über Selektoren identifizierten Elemente auf der Seite angezeigt werden.

Über Visual Experience Composer (VEC) erstellte Aktivitäten haben Angebote, die Selektoren enthalten.

serverDomain

Typ: String
Standardwert: Wert, der über die Benutzeroberfläche festgelegt wird.
Beschreibung: Stellt den Target Edge-Server dar.

serverState

Typ: Siehe Hybride Personalisierung weiter unten.
Standardwert: Siehe Hybride Personalisierung weiter unten.
Beschreibung: Siehe Hybride Personalisierung weiter unten.

telemetrisch aktiviert

Typ: Boolean
Standardwert: wahr
Beschreibung: Wenn diese Option aktiviert ist, erfasst Adobe Daten zur Nutzung von SDK-Funktionen und Daten der Leistungsmessung. Personenbezogene Daten werden nicht erfasst.

Zeitüberschreitung

Typ: Zahl
Standardwert: Wert, der über die Benutzeroberfläche festgelegt wird.
Beschreibung: Stellt das Target-Edge-Anfrage-Timeout dar.

viewsEnabled

Typ: Boolean
Standardwert: wahr
Beschreibung: Wenn diese Option aktiviert ist, werden Ansichten beim Laden der Seite automatisch abgerufen. Wenn triggerView aufgerufen wird, werden die entsprechenden Ansichten im Browser angezeigt. Wenn diese Option deaktiviert ist, werden Ansichten nicht beim Laden der Seite abgerufen und triggerView tut nichts. Ansichten werden in at.js 2 unterstützt.x, zutrifft.

visitorApiTimeout

Typ: Zahl
Standardwert: 2000 ms = 2 s
Beschreibung: Steht für die Anfrage-Zeitüberschreitung der Besucher-API.

Nutzung

Diese Funktion kann definiert werden, bevor at.js geladen wird, oder alternativ unter Einrichten > Implementierung > at.js-Einstellungen bearbeiten > Code-Einstellungen > Bibliothekskopfzeile.

Die Bibliothekskopfzeile ermöglicht es Ihnen, JavaScript ohne Formvorgabe zu verwenden. Der Anpassungscode sollte dem folgenden Beispiel ähneln:

window.targetGlobalSettings = {
   timeout: 200, // using custom timeout
   visitorApiTimeout: 500, // using custom API timeout
   enabled: document.location.href.indexOf('https://www.adobe.com') >= 0 // enabled ONLY on adobe.com
};

Datenanbieter

Mit dieser Einstellung können Kundinnen und Kunden Daten von Drittanbieterdatenanbietern wie Demandbase, BlueKai und benutzerdefinierten Services erfassen und die Daten als Mbox-Parameter in der globalen Mbox-Anfrage an Target übergeben. Sie unterstützt die Sammlung von Daten von mehreren Anbietern über asynchrone und synchrone Anfragen. Mit diesem Ansatz ist es ein Leichtes, Flicker- oder Standardinhalte zu verwalten und gleichzeitig unabhängige Timeouts für die einzelnen Anbieter festzulegen, um die Auswirkungen auf die Seitenleistung zu begrenzen

NOTE

Datenanbieter benötigen at.js 1.3 oder höher.

Weitere Informationen dazu finden Sie in den folgenden Videos:

Video

Beschreibung

Verwenden von Datenanbietern in Adobe Target

Mit der Datenanbieterfunktion können Sie Dateien von Drittanbietern einfach an Target übergeben. Ein Drittanbieter kann ein Wetterdienst, ein DMP oder sogar Ihr eigener Web-Service sein. Anschließend können Sie diese Daten zur Erstellung von Zielgruppen und zielgerichtetem Inhalt und zur Aufwertung des Benutzerprofils verwenden.

Implementieren von Datenanbietern in Adobe Target

Implementierungsdetails und Beispiele für die Verwendung der dataProviders-Funktion von Adobe Target zum Abrufen von Daten von Drittanbietern und zum Übergeben in der Target.

Die Einstellung window.targetGlobalSettings.dataProviders entspricht einer Reihe von Datenanbietern.

Jeder Datenanbieter weist die folgende Struktur auf:

Schlüssel

Typ

Beschreibung

name

Zeichenfolge

Name des Anbieters.

version

Zeichenfolge

Anbieterversion. Dieser Schlüssel wird für die Anbieterentwicklung verwendet.

Zeitüberschreitung

Nummer

Gibt die Anbieter-Zeitüberschreigung an, wenn es sich hierbei um eine Netzwerkanfrage handelt. Dieser Schlüssel ist optional.

provider

Funktion

Die Funktion, welche die Logik zum Abrufen der Anbieterdaten enthält.

Die Funktion verfügt über einen einzelnen erforderlichen Parameter: callback. Der Parameter „callback“ ist eine Funktion, die nur aufgerufen werden sollte, wenn die Daten erfolgreich abgerufen wurden oder ein Fehler vorliegt.

Der Callback erwartet zwei Parameter:

error: Gibt an, ob ein Fehler aufgetreten ist. Wenn alles in Ordnung ist, sollte dieser Parameter auf „null“ festgelegt sein.
params: Ein JSON-Objekt, das die Parameter darstellt, die in einer Target-Anfrage gesendet werden.

Im folgenden Beispiel wird gezeigt, wo der Datenanbieter die Synchronisierungsausführung verwendet:

var syncDataProvider = {
  name: "simpleDataProvider",
  version: "1.0.0",
  provider: function(callback) {
    callback(null, {t1: 1});
  }
};

window.targetGlobalSettings = {
  dataProviders: [
    syncDataProvider
  ]
};

Nachdem at.js window.targetGlobalSettings.dataProviders verarbeitet hat, enthält die Target-Anfrage einen neuen Parameter: t1=1.

Im Folgenden finden Sie ein Beispiel dafür, ob die Parameter, die Sie der Target-Anfrage hinzufügen möchten, von einem Drittanbieter-Service abgerufen werden, z. B. Bluekai oder Demandbase:

var blueKaiDataProvider = {
   name: "blueKai",
   version: "1.0.0",
   provider: function(callback) {
      // simulating network request
     setTimeout(function() {
       callback(null, {t1: 1, t2: 2, t3: 3});
     }, 1000);
   }
}

window.targetGlobalSettings = {
   dataProviders: [
      blueKaiDataProvider
   ]
};

Nachdem at.js window.targetGlobalSettings.dataProviders verarbeitet hat, enthält die Target-Anfrage zusätzliche Parameter: t1=1, t2=2 und t3=3.

Im folgenden Beispiel werden Datenanbieter verwendet, um Wetter-API-Daten zu erfassen und als Parameter in einer Target-Anfrage zu senden. Die Target Anfrage weist zusätzliche Parameter auf, z. B. country und weatherCondition.

var weatherProvider = {
      name: "weather-api",
      version: "1.0.0",
      timeout: 2000,
      provider: function(callback) {
        var API_KEY = "caa84fc6f5dc77b6372d2570458b8699";
        var lat = 44.426767399999996;
        var lon = 26.1025384;
        var url = "//api.openweathermap.org/data/2.5/weather?";
        var data = {
          lat: lat,
          lon: lon,
          appId: API_KEY
        }

        $.ajax({
          type: "GET",
                url: url,
          dataType: "json",
          data: data,
          success: function(data) {
            console.log("Weather data", data);
            callback(null, {
              country: data.sys.country,
              weatherCondition: data.weather[0].main
            });
          },
          error: function(err) {
            console.log("Error", err);
            callback(err);
          }
        });
      }
    };

    window.targetGlobalSettings = {
      dataProviders: [weatherProvider]
    };

Beachten Sie Folgendes, wenn Sie die Einstellung dataProviders verwenden.

Wenn die window.targetGlobalSettings.dataProviders hinzugefügten Datenanbieter asynchron sind, werden sie parallel ausgeführt. Die Besucher-API-Anfrage wird parallel mit den window.targetGlobalSettings.dataProviders hinzugefügten Funktionen ausgeführt, um eine minimale Wartezeit zu ermöglichen.
at.js versucht nicht, die Daten zwischenzuspeichern. Wenn der Datenanbieter die Daten nur einmal abruft, sollte er sicherstellen, dass die Daten zwischengespeichert werden, und die Cachedaten für den zweiten Aufruf verarbeiten, wenn die Anbieterfunktion aufgerufen wird.

Content Security Policy

at.js 2.3.0+ unterstützt das Festlegen von Content Security Policy-Nonces für SCRIPT- und STYLE-Tags, die beim Anwenden bereitgestellter Target-Angebote an das Seiten-DOM angehängt werden.

Die SCRIPT- und STYLE-Nonces sollten vor dem Laden von at.js 2.3.0 und höher entsprechend in targetGlobalSettings.cspScriptNonce und targetGlobalSettings.cspStyleNonce festgelegt werden. Sehen Sie sich das Beispiel unten an:

...
<head>
 <script nonce="<script_nonce_value>">
window.targetGlobalSettings = {
  cspScriptNonce: "<csp_script_nonce_value>",
  cspStyleNonce: "<csp_style_nonce_value>"
};
 </script>
 <script nonce="<script_nonce_value>" src="at.js"></script>
...
</head>
...

Nachdem cspScriptNonce- und cspStyleNonce angegeben wurden, legt at.js 2.3.0+ diese als Nonce-Attribute für alle SCRIPT- und STYLE-Tags fest, die beim Anwenden Target Angebote an das DOM angehängt werden.

Hybride Personalisierung

serverState ist eine in at.js v2.2+ verfügbare Einstellung zur Optimierung der Seitenleistung, wenn eine Hybrid-Integration von Target implementiert ist. Hybrid-Integration bedeutet, dass Sie zur Bereitstellung Ihrer Erlebnisse sowohl at.js v2.2+ auf der Client-Seite als auch die Bereitstellungs-API oder eine Target SDK auf der Server-Seite verwenden. serverState ermöglicht at.js v2.2+, Erlebnisse direkt aus Inhalten anzuwenden, die auf Serverseite abgerufen und als Teil der bereitzustellenden Seite an den Client zurückgegeben wurden.

Voraussetzungen

Sie müssen über eine hybride Integration von Target verfügen.

Server-seitig: Sie müssen die Bereitstellungs-API oder Target-SDKs verwenden.
Client-seitig: Sie müssen at.js, Version 2.2 oder neuer verwenden.

Code-Beispiele

Um besser zu verstehen, wie dies funktioniert, sehen Sie sich die Code-Beispiele unten an, die Sie auf Ihrem Server haben würden. Der Code setzt voraus, dass Sie das Target Node.js-SDK verwenden.

// First, we fetch the offers via Target Node.js SDK API, as usual
const targetResponse = await targetClient.getOffers(options);
// A successfull response will contain Target Delivery API request and response objects, which we need to set as serverState
const serverState = {
  request: targetResponse.request,
  response: targetResponse.response
};
// Finally, we should set window.targetGlobalSettings.serverState in the returned page, by replacing it in a page template, for example
const PAGE_TEMPLATE = `
<!doctype html>
<html>
<head>
  ...
  <script>
    window.targetGlobalSettings = {
      overrideMboxEdgeServer: true,
      serverState: ${JSON.stringify(serverState, null, " ")}
    };
  </script>
  <script src="at.js"></script>
</head>
...
</html>
`;
// Return PAGE_TEMPLATE to the client ...

Ein Beispiel für serverState-Objekt-JSON für den Vorab-Abruf der Ansicht sieht wie folgt aus:

{
 "request": {
  "requestId": "076ace1cd3624048bae1ced1f9e0c536",
  "id": {
   "tntId": "08210e2d751a44779b8313e2d2692b96.21_27"
  },
  "context": {
   "channel": "web",
   "timeOffsetInMinutes": 0
  },
  "experienceCloud": {
   "analytics": {
    "logging": "server_side",
    "supplementalDataId": "7D3AA246CC99FD7F-1B3DD2E75595498E"
   }
  },
  "prefetch": {
   "views": [
    {
     "address": {
      "url": "my.testsite.com/"
     }
    }
   ]
  }
 },
 "response": {
  "status": 200,
  "requestId": "076ace1cd3624048bae1ced1f9e0c536",
  "id": {
   "tntId": "08210e2d751a44779b8313e2d2692b96.21_27"
  },
  "client": "testclient",
  "edgeHost": "mboxedge21.tt.omtrdc.net",
  "prefetch": {
   "views": [
    {
     "name": "home",
     "key": "home",
     "options": [
      {
       "type": "actions",
       "content": [
        {
         "type": "setHtml",
         "selector": "#app > DIV.app-container:eq(0) > DIV.page-container:eq(0) > DIV:nth-of-type(2) > SECTION.section:eq(0) > DIV.container:eq(1) > DIV.heading:eq(0) > H1.title:eq(0)",
         "cssSelector": "#app > DIV:nth-of-type(1) > DIV:nth-of-type(1) > DIV:nth-of-type(2) > SECTION:nth-of-type(1) > DIV:nth-of-type(2) > DIV:nth-of-type(1) > H1:nth-of-type(1)",
         "content": "<span style=\"color:#FF0000;\">Latest</span> Products for 2020"
        }
       ],
       "eventToken": "t0FRvoWosOqHmYL5G18QCZNWHtnQtQrJfmRrQugEa2qCnQ9Y9OaLL2gsdrWQTvE54PwSz67rmXWmSnkXpSSS2Q==",
       "responseTokens": {
        "profile.memberlevel": "0",
        "geo.city": "dublin",
        "activity.id": "302740",
        "experience.name": "Experience B",
        "geo.country": "ireland"
       }
      }
     ],
     "state": "J+W1Fq18hxliDDJonTPfV0S+mzxapAO3d14M43EsM9f12A6QaqL+E3XKkRFlmq9U"
    }
   ]
  }
 }
}

Nachdem die Seite im Browser geladen wurde, wendet at.js alle Target-Angebote von serverState sofort an, ohne Netzwerkaufrufe an den Target-Edge auszulösen. Darüber hinaus blendet at.js nur die DOM-Elemente vorab aus, für die im Server-seitig abgerufenen Inhalt Target-Angebote verfügbar sind, was sich positiv auf die Seitenladeleistung und das Endbenutzererlebnis auswirkt.

Wichtige Hinweise

Beachten Sie bei der Verwendung von serverState Folgendes:

Derzeit unterstützt at.js v2.2 nur die Bereitstellung von Erlebnissen über serverState für:
- Mit VEC erstellte Aktivitäten, die beim Laden der Seite ausgeführt werden.
- Vorab abgerufene Ansichten.
  
  SPA Im Falle der Verwendung von Target Views und triggerView() in der at.js-API speichert at.js v2.2 den Inhalt für alle Ansichten, die vorab auf der Serverseite abgerufen wurden, zwischen und wendet diese an, sobald jede Ansicht über triggerView() ausgelöst wird, auch wieder ohne dass zusätzliche Aufrufe zum Abrufen von Inhalten an Target ausgelöst werden.
- Hinweis: Derzeit werden auf der Server-Seite abgerufene mboxes in serverState nicht unterstützt.
Bei der Anwendung serverState Angebote berücksichtigt at.js pageLoadEnabled- und viewsEnabled, z. B. werden Seitenladeangebote nicht angewendet, wenn die pageLoadEnabled auf „false“ gesetzt ist.

Um diese Einstellungen zu aktivieren, aktivieren Sie den Umschalter in Administration > Implementierung > Bearbeiten > Seitenladen aktiviert.
Stellen Sie bei Verwendung von serverState und gleichzeitiger Verwendung von <script>-Tags im zurückgegebenen Inhalt sicher, dass Ihr HTML-Inhalt <\/script> statt </script> verwendet. Wenn Sie </script> verwenden, interpretiert der Browser </script> als Ende auf einem Inline-SCRIPT und es kann zur Beschädigung der HTML-Seite kommen.

Zusätzliche Ressourcen

Weitere Informationen zur Funktionsweise von serverState finden Sie in den folgenden Ressourcen:

recommendation-more-help