ドキュメントTarget 開発者ガイド

targetGlobalSettings()

Last update: Wed Dec 13 2023 00:00:00 GMT+0000 (Coordinated Universal Time)

作成対象：

  • Developer

at.js ライブラリの設定は、 targetGlobalSettings()を設定する代わりに、 Target UI または REST API を使用します。

設定

次の設定を上書きできます。

aepSandboxId

  • 型：String
  • デフォルト値: null
  • 説明：送信に使用されるオプションのパラメーター Adobe Experience Platform 共有するサンドボックス ID Adobe Experience Platform を使用してデフォルト以外のサンドボックスで作成された宛先 Target. 次の場合 aepSandboxId が null 以外の場合、 aepSandboxName また、を指定する必要があります。

aepSandboxName

  • 型：String
  • デフォルト値: null
  • 説明：送信に使用されるオプションのパラメーター Adobe Experience Platform 共有するサンドボックス名 Adobe Experience Platform を使用してデフォルト以外のサンドボックスで作成された宛先 Target. 次の場合 aepSandboxName が null 以外の場合、 aepSandboxId また、を指定する必要があります。

artifactLocation

bodyHiddenStyle

  • 型：String

  • デフォルト値：body

  • 説明：globalMboxAutocreate === true の場合にのみ使用して、ちらつきの発生を最小限に抑えます。

    詳しくは、「at.js によるちらつきの制御方法」を参照してください。

bodyHidingEnabled

  • タイプ：ブール値
  • デフォルト値：true
  • 説明：Visual Experience Composer で作成されたオファー（）の配信に target-global-mbox が使用される場合に、ちらつきの制御に使用します。

clientCode

  • 型：String
  • デフォルト値：UI で設定された値。
  • 説明：クライアントコードを表します。

cookieDomain

  • 型：String
  • デフォルト値：可能であれば、トップレベルドメインに設定します。
  • 説明：Cookie の保存時に使用するドメインを表します。

crossDomain

  • 型：String
  • デフォルト値：UI で設定された値。
  • 説明：クロスドメイントラッキングが有効になっているかどうかを表します。使用できる値は、at.js のバージョンによって異なります。 at.js v1 の場合。x、クロスドメイン機能が disabled ( ブラウザーはお客様のドメインに cookie を設定します（ファーストパーティ cookie のみ）。 x only ( ブラウザーが Targetのドメインのみ )、またはその両方（選択による） enabled （ブラウザーはファーストパーティ Cookie とサードパーティ Cookie の両方を設定します）。 at.js v2.10 以降の場合は、クロスドメイン機能を使用するかどうかを指定します enabled （ブラウザーはファーストパーティ Cookie とサードパーティ Cookie の両方を設定）または disabled （ブラウザーはサードパーティ Cookie を設定しません）。

cspScriptNonce

cspStyleNonce

dataProviders

decisioningMethod

  • 型：String

  • デフォルト値：server-side

  • その他の値：on-device、hybrid

  • 説明：以下の「判定方法」を参照してください。

    判定方法

    オンデバイス判定を使用する場合、 Target では、at.js がエクスペリエンスを提供する方法を指示する、判定方法と呼ばれる新しい設定を導入します。 decisioningMethod には、server-side（サーバー側のみ）、on-device（オンデバイスのみ）、hybrid（ハイブリッド）の 3 つの値があります。decisioningMethod が targetGlobalSettings() で設定されると、Target のあらゆる決定のデフォルトの判定方法として機能します。

    サーバー側のみ：

    at.js 2.5 以降が実装され Web プロパティにデプロイされている場合、サーバー側のみが初期設定で設定されるデフォルトの判定方法です。

    サーバーサイドのみをデフォルトの設定として使用する場合、 Target エッジネットワーク。ブロックサーバー呼び出しが含まれます。 このアプローチは、徐々に遅延を引き起こす可能性がありますが、適用する機能を提供するなど、大きなメリットも提供します Targetを含むの機械学習機能 Recommendations, Automated Personalization (AP) および 自動ターゲット アクティビティ。

    さらに、 Targetのユーザープロファイルは、セッションやチャネルをまたいで保持され、ビジネスに強力な成果をもたらすことができます。

    最後に、サーバーサイドでは、Adobe Experience Cloudを使用し、Audience ManagerおよびAdobe Analyticsセグメントを通じてターゲットに設定できるオーディエンスを微調整することのみできます。

    オンデバイスのみ：

    オンデバイス判定は、Web ページ全体でのみ使用する場合に at.js 2.5 以降で設定する必要がある判定方法です。

    オンデバイス判定では、オンデバイス判定の対象となるすべてのアクティビティを含んだ、キャッシュされたルールアーティファクトから決定が行われるので、エクスペリエンスとパーソナライゼーションアクティビティを超高速で配信できます。

    どのアクティビティがオンデバイス判定の対象となるかについて詳しくは、サポートされている機能の節を参照してください。

    この判定方法は、Target からの決定を必要とするすべてのページでパフォーマンスが非常に重要な場合にのみ使用してください。さらに、この判定方法を選択した場合、オンデバイス判定の対象とならない Target アクティビティは配信も実行もされないことに注意してください。at.js ライブラリ 2.5 以降は、キャッシュされたルールアーティファクトのみを探して決定を下すように設定されています。

    ハイブリッド：

    ハイブリッドは、オンデバイス判定と、 Adobe Target Edge ネットワークを実行する必要があります。

    オンデバイス判定アクティビティとサーバー側アクティビティの両方を管理している場合は、ページに Target をデプロイしてプロビジョニングする方法を考える際に、少し複雑で面倒な場合があります。判定方法としてハイブリッドを使用する場合、 Target は、 Adobe Target サーバー側での実行を必要とするアクティビティと、デバイス上での決定のみを実行する必要がある場合に備えた Edge ネットワーク。

    JSON ルールアーティファクトには、mbox がサーバー側アクティビティを実行しているか、オンデバイス判定アクティビティを実行しているかを at.js に通知するメタデータが含まれています。この判定方法では、迅速に配信するアクティビティをオンデバイス判定を通じて確実におこない、より強力な ML 駆動型パーソナライゼーションを必要とするアクティビティでは、 Adobe Target Edge ネットワーク。

defaultContentHiddenStyle

  • 型：String
  • デフォルト値：visibility: hidden
  • 説明：クラス名が「mboxDefault」である DIV を使用し、mboxCreate()、mboxUpdate() または mboxDefine() から実行される mbox のラッピングにのみ使用されて、デフォルトコンテンツを非表示にします。

defaultContentVisibleStyle

  • 型：String
  • デフォルト値：visibility: visible
  • Description：クラス名が「mboxDefault」である DIV を使用し、mboxCreate()、mboxUpdate() または mboxDefine() から実行される mbox のラッピングにのみ使用されて、適用されたオファー（存在する場合）またはデフォルトコンテンツを表示します。

deviceIdLifetime

  • タイプ：数値
  • デフォルト値：63244800000 ミリ秒 = 2 年
  • 説明：deviceId が Cookie に保持される時間。
NOTE
deviceIdLifetime 設定は、at.js バージョン 2.3.1 以降で上書きできます。

有効

  • タイプ：ブール値

  • デフォルト値：true

  • 説明：有効にすると、エクスペリエンスおよびエクスペリエンスをレンダリングする DOM 操作を取得する Target リクエストが自動的に実行されます。さらに、Target 呼び出しは、getOffer(s)／applyOffer(s) を介して手動で実行できます。

    無効にした場合、Target リクエストは自動でも手動でも実行されません。

globalMboxAutoCreate

  • タイプ：数値
  • デフォルト値：UI で設定された値。
  • 説明：グローバル mbox リクエストをトリガーするかどうかを示します。

imsOrgId

  • 型：String
  • デフォルト値：true
  • 説明：IMS ORG ID を表します。

optinEnabled

  • タイプ：ブール値
  • デフォルト値：false
  • 説明: Target では、お客様の同意管理戦略を支援できるよう、Adobe Experience Platformを介してオプトイン機能がサポートされています。 オプトイン機能を使用すると、Target タグを実行する方法とタイミングを制御できます。また、Adobe Experience Platformを介して事前に Target タグを使用します。 Target の at.js ライブラリでオプトインを使用する機能を有効にするには、optinEnabled=true 設定を追加する必要があります。Adobe Experience Platformで、拡張機能のインストール表示の GDPR オプトインドロップダウンリストから「有効」を選択する必要があります。 詳しくは、Adobe Experience Platform ドキュメントを参照してください。 この設定がプライバシーとデータ保護規制に関するものである場合、欧州連合の EU 一般データ保護規則 (GDPR) やカリフォルニア州消費者プライバシー法 (CCPA) などに関する詳細は、 プライバシーとデータ保護規制.

optoutEnabled

  • タイプ：ブール値
  • デフォルト値：false
  • 説明：が Target 訪問者 API を呼び出す必要がある isOptedOut() 関数に置き換えます。 これは、デバイスグラフ有効化の一部です。

overrideMboxEdgeServer

  • タイプ：ブール値

  • デフォルト値：true（at.js バージョン 1.6.2 以降）

  • 説明：<clientCode>.tt.omtrdc.netドメインまたは mboxedge<clusterNumber>.tt.omtrdc.net ドメインを使用する必要があるかどうかを示します。

    この値が true の場合、mboxedge<clusterNumber>.tt.omtrdc.net ドメインは Cookie に保存されます。at.js 1.8.2 および at.js 2.3.1 より前のバージョンの at.js を使用している場合、現時点では、CNAME が機能しません。この問題が発生する場合は、at.js を新しいサポート対象バージョンに更新することを検討してください。

overrideMboxEdgeServerTimeout

  • タイプ：数値
  • デフォルト値：1860000 => 31 分
  • 説明：mboxedge<clusterNumber>.tt.omtrdc.net 値を含んだ Cookie の有効期間を示します。

pageLoadEnabled

  • タイプ：ブール値
  • デフォルト値：true
  • 説明：有効にすると、ページ読み込み時に返す必要のあるエクスペリエンスが自動的に取得されます。

pollingInterval

  • タイプ：数値
  • デフォルト値:300000(5 分（ミリ秒）
  • 説明:at.js がオンデバイス判定アーティファクトの新しいバージョンを取得し、キャッシュを更新する間隔。 300000は、 pollingInterval.

secureOnly

  • タイプ：ブール値
  • デフォルト値：false
  • 説明：at.js で HTTPS のみを使用するか、ページのプロトコルに基づいて HTTP と HTTPS を切り替えることができるかを示します。true に設定した場合、secureOnly は Secure 属性と SameSite 属性も mbox Cookie に設定します。

selectorsPollingTimeout

  • タイプ：数値

  • デフォルト値：5000 ミリ秒 = 5 秒

  • 説明：at.js 0.9.6 では、targetGlobalSettings で上書きできるこの新しい設定が Target に導入されました。

    selectorsPollingTimeout 設定は、セレクターで識別されたすべての要素がページに表示されるまでクライアントが待機できる時間を表します。

    Visual Experience Composer（VEC）によって作成されたアクティビティには、セレクターが含まれたオファーがあります。

serverDomain

  • 型：String
  • デフォルト値：UI で設定された値。
  • 説明：を表します Target エッジサーバー。

serverState

telemetryEnabled

  • タイプ：ブール値
  • デフォルト値：true
  • 説明：有効にすると、Adobeは SDK 機能の使用状況とパフォーマンスのテレメトリデータを収集します。 個人データは収集されません。

timeout

  • タイプ：数値
  • デフォルト値：UI で設定された値。
  • 説明：Target エッジリクエストのタイムアウトを表します。

viewsEnabled viewsenabled

  • タイプ：ブール値
  • デフォルト値：true
  • 説明：有効にすると、ページが読み込まれるとビューが自動的に取得されます。 条件 triggerView が呼び出されると、該当するビューがブラウザに表示されます。 このオプションが無効な場合、ページの読み込み時にビューが取得されず、 triggerView は何もしません。 ビューは at.js 2 でサポートされています。x のみで使用できます。

visitorApiTimeout

  • タイプ：数値
  • デフォルト値：2000 ms = 2 秒
  • 説明：訪問者 API リクエストのタイムアウトを表します。

使用方法

この関数は、at.js が読み込まれる前か、管理／実装／at.js 設定を編集／コード設定／ライブラリヘッダー ​で定義できます。

「ライブラリのヘッダー」フィールドでは、JavaScript を自由形式で入力できます。カスタマイズコードは次の例のようになります。

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

データプロバイダー data-providers

この設定を使用すると、Demandbase、BlueKai、カスタムサービスなどのサードパーティのデータプロバイダーからデータを収集し、そのデータをに渡すことができます。 Target を mbox パラメーターとしてグローバル mbox リクエストに追加します。 非同期および同期リクエストを介した複数のプロバイダーからのデータ収集もサポートしています。この手法では、デフォルトのページコンテンツのちらつきを制御しながら、プロバイダーごとに個別のタイムアウトを指定し、ページのパフォーマンスへの影響を抑制することが簡単にできます。

NOTE
データプロバイダーは、at.js 1.3 以降を必要とします。

詳細は次のビデオで説明されています。

ビデオ
説明
Adobe Target でのデータプロバイダーの使用
データプロバイダーは、サードパーティから Target へデータを簡単に渡すことのできる機能です。サードパーティとしては、気象予報サービス、DMP、自社の Web サービスなども利用可能です。このデータを利用して、オーディエンスやターゲットコンテンツを構築したり、訪問者プロファイルを充実させることができます。
Adobe Target でのデータプロバイダーの実装
実装の詳細と使用方法の例 Targetの dataProviders 機能を使用して、サードパーティのデータプロバイダーからデータを取得し、 Target リクエスト。

window.targetGlobalSettings.dataProviders 設定は、データプロバイダーの配列です。

各データプロバイダーの構造は次のとおりです。

キー
タイプ
説明
name
文字列
プロバイダーの名前。
version
文字列
プロバイダーのバージョン。このキーはプロバイダーの展開に使用されます。
timeout
数値
ネットワークリクエストの場合は、プロバイダーのタイムアウトを表します。このキーはオプションです。
provider
関数

プロバイダーデータの取得ロジックを含む関数。

この関数の必須パラメーターは 1 つだけです。 callback. この callback パラメーターは、データを適切に取得した場合またはエラーが発生した場合にのみ呼び出す必要があります。

このコールバックは、次の 2 つのパラメーターを受け取ります。

  • error：エラーの有無を表します。エラーがない場合、このパラメーターは null に設定されます。
  • params: JSON オブジェクト。 Target リクエスト。

データプロバイダーで同期実行を使用する場合の例は次のとおりです。

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

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

at.js の処理後 window.targetGlobalSettings.dataProviders、 Target リクエストには次の新しいパラメーターが含まれます。 t1=1.

次の例は、 Target リクエストは、BlueKai、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
   ]
};

at.js の処理後 window.targetGlobalSettings.dataProviders、 Target リクエストには、追加のパラメーターが含まれます。 t1=1, t2=2 および t3=3.

次の例では、データプロバイダーを使用して weather API データを収集し、 Target リクエスト。 The Target リクエストには、 country および 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]
    };

dataProviders 設定を使用する際は、次の点に注意してください。

  • window.targetGlobalSettings.dataProviders に追加されたデータプロバイダーが非同期の場合は、同時並行で実行されます。訪問者 API リクエストは、待ち時間を最小限に抑えるために、window.targetGlobalSettings.dataProviders に追加された関数と同時に実行されます。
  • at.js では、データはキャッシュされません。データプロバイダーが 1 回だけデータを取得する場合は、データをキャッシュし、そのプロバイダーの関数が呼び出されたら、2 回目の呼び出しでキャッシュデータを配信できるようにする必要があります。

コンテンツセキュリティポリシー

at.js 2.3.0 以降では、配信された配信を適用する際の SCRIPT タグとページ DOM に追加された STYLE タグに対するコンテンツセキュリティポリシーナンスの設定がサポートされます Target オファー。

at.js 2.3.0 以降の読み込みに先立って、SCRIPT と STYLE の Nonce を targetGlobalSettings.cspScriptNonce と targetGlobalSettings.cspStyleNonce で設定する必要があります。 以下の例を参照してください。

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

後 cspScriptNonce および cspStyleNonce 設定が指定されている場合、at.js 2.3.0 以降は、適用時に DOM に追加されるすべての SCRIPT タグと STYLE タグに対して、これらを nonce 属性として設定します Target オファー。

ハイブリッドパーソナライゼーション

serverState は、at.js v2.2 以降で使用可能な設定で、 Target が実装されている。 ハイブリッド統合とは、クライアント側で at.js v2.2 以降と Delivery API または Target エクスペリエンスを配信するためのサーバー側の SDK。 serverState には、at.js v2.2 以降で、サーバーサイドで取得したコンテンツからエクスペリエンスを直接適用し、提供されるページの一部としてクライアントに返す機能が備わっています。

前提条件

Target のハイブリッド統合が必要です。

コードサンプル

この仕組みをより深く理解するには、サーバー上にある以下のコード例を参照してください。 このコードは、Target Node.js SDK の使用を前提としています。

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

ビュー事前読み込みの serverState オブジェクト JSON の例を次に示します。

{
 "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"
    }
   ]
  }
 }
}

ページがブラウザーに読み込まれた後、at.js は Target エッジに対するネットワーク呼び出しを実行せずに、serverState からのすべての Target オファーを直ちに適用します。さらに、at.js は、コンテンツが取得されたサーバー側で Target オファーが使用可能な DOM 要素のみを事前に非表示にするので、ページ読み込みのパフォーマンスとエンドユーザーエクスペリエンスに好影響を及ぼします。

重要事項

serverState を使用する場合は、以下の事項を考慮してください。

  • 現時点で、at.js v2.2 は、以下に対してのみ serverState を介したエクスペリエンスの配信をサポートしています。

    • ページの読み込み時に実行される、VEC で作成されたアクティビティ。

    • 事前読み込みされたビュー。

      を使用してSPAを実行する場合 Target ビューと triggerView() at.js API では、at.js v2.2 は、サーバー側でプリフェッチされたすべてのビューのコンテンツをキャッシュし、各ビューが経由でトリガーされるとすぐに適用します。 triggerView()を呼び出す前に、 Target.

    • 注意：現在、サーバー側で取得された mbox は、serverState ではサポートされていません。

  • 適用時 serverState オファー， at.js は考慮 pageLoadEnabled および viewsEnabled 設定（ページ読み込みオファーなど）は、 pageLoadEnabled の設定が false の場合、

    これらの設定をオンにするには、 管理/実装/編集/ページ読み込みが有効になっています。.

    「ページ読み込みが有効」設定

  • serverState を使用し、返されるコンテンツで <script> タグを使用する場合は、HTML コンテンツで </script> の代わりに <\/script> が使用されていることを確認してください。</script> を使用すると、ブラウザーが </script> をインライン SCRIPT の終わりと解釈して、HTML ページが破損する可能性があります。

その他のリソース

serverState の仕組みについて詳しくは、次のリソースを参照してください。

recommendation-more-help
6906415f-169c-422b-89d3-7118e147c4e3