targetGlobalSettings()

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

Einstellungen

Folgende Einstellungen können überschrieben werden:

aepSandboxId

  • Typ: String
  • Standardwert: null
  • Beschreibung: Optionaler Parameter für das Senden Adobe Experience Platform Sandbox-ID zum Freigeben Adobe Experience Platform Ziele, die in der nicht standardmäßigen Sandbox mit Target. Wenn aepSandboxId nicht null ist, aepSandboxName müssen ebenfalls angegeben werden.

aepSandboxName

  • Typ: String
  • Standardwert: null
  • Beschreibung: Optionaler Parameter für das Senden Adobe Experience Platform Sandbox-Name zum Freigeben Adobe Experience Platform Ziele, die in der nicht standardmäßigen Sandbox mit Target. Wenn aepSandboxName nicht null ist, aepSandboxId müssen ebenfalls angegeben werden.

artifactLocation

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 (Browser setzen Cookies nur in Ihrer Domäne (Erstanbieter-Cookies), x only (Browser setzen Cookies in Targetnur Domäne) oder beides durch Auswahl von enabled (Browser setzen sowohl Erst- als auch Drittanbieter-Cookies.) Geben Sie für at.js v2.10 und höher an, ob domänenübergreifende Funktionen enabled (Browser setzen sowohl Erst- als auch Drittanbieter-Cookies) oder disabled (Browser setzen keine Drittanbieter-Cookies ein).

cspScriptNonce

cspStyleNonce

dataProviders

decisioningMethod

  • Typ: String

  • Standardwert: Server-seitig

  • Andere Werte: On-Device, Hybrid

  • Beschreibung: Siehe Entscheidungsmethoden weiter unten.

    Entscheidungsmethoden

    Mit gerätebezogenen Entscheidungen Target führt eine neue Einstellung namens Decisioning Method 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 serverseitig ist die standardmäßige Entscheidungsmethode, die vorkonfiguriert ist, wenn at.js 2.5+ implementiert und in Ihren Webeigenschaften bereitgestellt wird.

    Die Verwendung von nur serverseitig als Standardkonfiguration bedeutet, dass alle Entscheidungen auf der Target Edge-Netzwerk, das einen blockierenden Server-Aufruf umfasst. Dieser Ansatz kann zu einer inkrementellen Latenz führen, bietet aber auch erhebliche Vorteile, wie z. B. die Möglichkeit, Targetder maschinellen Lernfunktionen, zu denen Recommendations, Automated Personalization (AP) und Automatisches Targeting Aktivitäten.

    Darüber hinaus können Sie Ihre personalisierten Erlebnisse durch Verwendung von TargetDas Benutzerprofil von kann leistungsstarke Ergebnisse für Ihr Unternehmen liefern, das sitzungs- und kanalübergreifend beibehalten wird.

    Schließlich können Sie nur serverseitig die Adobe Experience Cloud verwenden und Zielgruppen anpassen, 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 allen Webseiten 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 die Adobe Target Das Edge-Netzwerk muss ausgeführt werden.

    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. Mit Hybrid als Entscheidungsmethode Target weiß, wann der Server-Aufruf an die Adobe Target Edge-Netzwerk für Aktivitäten, für die eine serverseitige Ausführung erforderlich ist, und auch, 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 On-Device-Entscheidungsfindung durchgeführt werden und für Aktivitäten, die eine leistungsfähigere ML-gesteuerte Personalisierung erfordern, diese Aktivitäten über die Adobe Target Edge-Netzwerk.

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 bietet Opt-in-Funktionalität über Adobe Experience Platform, um Ihre Einwilligungsverwaltung zu unterstützen. 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 die Target -Tag. 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 Dropdownliste DSGVO-Opt-in in der Installationsansicht der Erweiterung die Option "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 Vorschriften zum Datenschutz.

optoutEnabled

  • Typ: Boolean
  • Standardwert: falsch
  • Beschreibung: Gibt an, ob Target sollte die Besucher-API aufrufen isOptedOut() -Funktion. 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.

ollingInterval

  • Typ: Zahl
  • Standardwert: 300000 (fünf Minuten in Millisekunden)
  • Beschreibung: Intervall, in dem at.js eine neue Version eines auf dem Gerät vorhandenen Entscheidungsartefakts abruft und den Cache aktualisiert. 300000 ist der Mindestwert, der 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 die Target Edge-Server.

serverState

telemetryEnabled

  • Typ: Boolean
  • Standardwert: wahr
  • Beschreibung: Wenn diese Option aktiviert ist, erfasst Adobe SDK-Funktionsnutzung und Leistungstelemetrikdaten. 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 viewsenabled

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

visitorApiTimeout

  • Typ: Zahl
  • Standardwert: 2000 ms = 2 s
  • Beschreibung: Stellt die Zeitüberschreitung bei der Besucher-API-Anfrage dar.

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 data-providers

Mit dieser Einstellung können Kunden Daten von Drittanbietern (wie Demandbase, BlueKai und benutzerdefinierten Diensten) erfassen und die Daten an übergeben. Target als Mbox-Parameter in der globalen Mbox-Anfrage. 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 erfordert 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 zur Verwendung von Adobe TargetDie dataProviders -Funktion von Drittanbietern, um Daten von Drittanbietern abzurufen und sie im Target -Anfrage.

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.

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
  ]
};

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

Im Folgenden finden Sie ein Beispiel, wenn die Parameter, die Sie zum Target -Anfrage von einem Drittanbieterdienst wie Bluekai, Demandbase usw. abgerufen werden:

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
   ]
};

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

Im folgenden Beispiel werden mithilfe von Datenanbietern Wetter-API-Daten erfasst und als Parameter in einer Target -Anfrage. 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 der bereitgestellten Inhalte an das Seiten-DOM angehängt werden Target Angebote.

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

Nachher cspScriptNonce und cspStyleNonce -Einstellungen festgelegt sind, legt at.js 2.3.0+ diese als Nonce-Attribute für alle SCRIPT- und STYLE-Tags fest, die beim Anwenden der Target Angebote.

Hybride Personalisierung

serverState ist eine Einstellung in at.js v2.2+, die zur Optimierung der Seitenleistung verwendet werden kann, wenn eine hybride Integration von Target implementiert wurde. Hybride Integration bedeutet, dass Sie sowohl at.js v2.2+ auf Client-Seite als auch die Bereitstellungs-API oder eine Target SDK auf Server-Seite, um Erlebnisse bereitzustellen. 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.

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.

      Bei SPA Verwendung von Target Ansichten und triggerView() In der at.js-API speichert at.js v2.2 den Inhalt für alle vorab abgerufenen Ansichten zwischen und wendet diese an, sobald jede Ansicht über triggerView(), ohne zusätzliche Aufrufe zum Abrufen von Inhalten an auszulösen Target.

    • Hinweis: Derzeit werden auf der Server-Seite abgerufene mboxes in serverState nicht unterstützt.

  • Bei Anwendung serverState Angebote, bei denen at.js berücksichtigt pageLoadEnabled und viewsEnabled -Einstellungen, z. B. werden Seitenladeangebote nicht angewendet, wenn die pageLoadEnabled auf "false"gesetzt ist.

    Um diese Einstellungen zu aktivieren, aktivieren Sie die Umschaltung in Administration > Implementierung > Bearbeiten > Seitenladeaktivierung.

    Einstellungen für „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
6906415f-169c-422b-89d3-7118e147c4e3