at.js の On-device decisioning

バージョン 2.5.0 以降、at.js は on-device decisioning を提供します。 On-device decisioning を使用すると、ブラウザー上で A/B テストおよび エクスペリエンスのターゲット設定（XT）アクティビティをキャッシュして、Adobe Target Edge Networkへのネットワークリクエストをブロックすることなく、インメモリ判定を実行できます。

また、Target は、ライブサーバー呼び出しを通じて、実験や機械学習に基づく（ML 駆動の）パーソナライゼーションアクティビティから最も関連性が高い最新のエクスペリエンスを柔軟に提供します。 つまり、パフォーマンスが最も重要な場合は、on-device decisioning の使用を選択できます。 ただし、最も関連性が高く、最新の ML ドリブン型のエクスペリエンスが必要な場合は、代わりにサーバーコールを行うことができます。

on-device decisioning の利点は何ですか？

on-device decisioning の利点は次のとおりです。

サポートされる機能

Adobe Target JS SDK を使用すると、意思決定のためのデータのパフォーマンスと鮮度を柔軟に選択できます。 つまり、最も関連性が高く、魅力的なパーソナライズされたコンテンツを機械学習を通じて配信することが最も重要な場合は、ライブサーバーを呼び出す必要があります。 ただし、パフォーマンスがより重要な場合は、オンデバイスおよびメモリ内の決定を行う必要があります。 動作する on-device decisioning については、サポートされている機能のリストを参照してください。

詳しくは、on-device decisioning でサポートされる機能」を参照してください。

on-device decisioning の仕組み

on-device decisioning を有効にして at.js をデプロイおよび初期化すると、A/B および XT のアクティビティ、オーディエンスおよびアセット用の on-device decisioning を含んだ ルールアーティファクトが、最も近い Akamai CDN から訪問者にダウンロードされ、訪問者のブラウザーにローカルにキャッシュされます。 エクスペリエンスを取得するためのリクエストが at.js から送信されると、キャッシュされたルールアーティファクトにエンコードされたメタデータに基づいて、返すエクスペリエンスに関する決定がメモリ内で行われます。

判定方法

on-device decisioning では、Decisioning MethodTarget いう新しい設定が導入されています。 判定方法の設定は、at.js でのエクスペリエンスの提供方法を指定します。 判定方法には次の 3 つの値があります。

サーバー側のみ

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

サーバーサイドのみをデフォルト設定として使用すると、すべての決定は Target エッジネットワーク上で行われます。これにはブロッキングサーバーコールが必要になります。 このアプローチでは、待ち時間が徐々に増えるおそれがありますが、Recommendations、Automated Personalization （AP）および 自動ターゲットのアクティビティなど、Target の機械学習機能を適用する機能を提供するなど、大きなメリットもあります。

さらに、すべてのセッションやチャネルにわたって永続化された Target のユーザープロファイルを使用して、パーソナライズされたエクスペリエンスを強化することで、ビジネスに大きな成果をもたらすことができます。

最後に、サーバーサイドのみでは、Adobe Experience Cloudを使用して、Audience ManagerセグメントやAdobe Analytics セグメントを介してターゲティングできるオーディエンスを微調整できます。

次の図は、訪問者、ブラウザー、at.js 2.5.0 以降と Adobe Target Edge ネットワークの間のやり取りを示しています。 次のフロー図は、新規訪問者と再訪問者を取り込みます。

（全幅に拡大するには、画像をクリックします）。

次のリストは、図の数値に対応します。

オンデバイスのみ

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

決定 On-device decisioning、エクスペリエンススコアに該当するすべてのアクティビティを含んだ、キャッシュされたルールアーティファクトから行われるので、エクスペリエンスとパーソナライゼーションアクティビティを超高速で配信で on-device decisioning ます。

どのアクティビティが on-device decisioning の対象となるかについて詳しくは、on-device decisioning でサポートされる機能」を参照してください。

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

次の図は、訪問者、ブラウザー、at.js 2.5.0 以降と Akamai CDN の間のやり取りを示しています。 Akamai CDN は、訪問者の初回訪問のルールアーティファクトをキャッシュします。 新規訪問者の最初のページ訪問では、JSON ルールアーティファクトを Akamai CDN からダウンロードして、訪問者のブラウザー上でローカルにキャッシュする必要があります。 JSON ルールアーティファクトがダウンロードされると、ネットワーク呼び出しをブロックすることなく、すぐに決定が行われます。 次のフロー図は、新規訪問者を取り込んでいます。

（全幅に拡大するには、画像をクリックします）。

次のリストは、図の数値に対応します。

次の図は、訪問者、ブラウザー、at.js 2.5.0 以降および訪問者の後続のページヒットまたは再訪問に対するキャッシュされた JSON ルールアーティファクトの間のインタラクションを示しています。 JSON ルールアーティファクトは既にキャッシュされており、ブラウザーで使用できるので、ネットワーク呼び出しをブロックすることなく、すぐに決定が行われます。 このフロー図は、その後のページナビゲーションまたは再訪問者を取り込みます。

（全幅に拡大するには、画像をクリックします）。

次のリストは、図の数値に対応します。

ハイブリッド

ハイブリッドは、on-device decisioning アクティビティと、Adobe Target Edge ネットワークへのネットワーク呼び出しを必要とするアクティビティの両方を実行する必要がある場合に、at.js 2.5.0 以降で設定する必要がある判定方法です。

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

JSON ルールアーティファクトには、mbox がサーバー側アクティビティを実行しているか、on-device decisioning アクティビティを実行しているかを at.js に通知するメタデータが含まれています。 この判定方法では、迅速に配信すべきアクティビティを on-device decisioning を通じて行い、機械学習によるより強力なパーソナライゼーションを必要とするアクティビティについては、Adobe Target Edge ネットワークを介して行います。

次の図は、新しい訪問者が初めてページにアクセスする場合の、訪問者、ブラウザー、at.js 2.5.0 以降、Akamai CDN および Adobe Target Edge Network間のインタラクションを示しています。 この図から得られるメリットは、JSON ルールアーティファクトが非同期でダウンロードされる一方で、決定は Adobe Target Edge Network を介して行われることです。

このアプローチにより、多くのアクティビティを含む可能性のあるアーティファクトのサイズが、決定の待ち時間に悪影響を与えないようにします。 JSON ルールアーティファクトを同期的にダウンロードし、その後に決定を行うと、待ち時間に悪影響を及ぼす可能性があり、一貫性がなくなる場合があります。 したがって、ハイブリッド判定方法は、新しい訪問者の決定を常にサーバー側で呼び出すためのベストプラクティスの推奨事項です。JSON ルールのアーティファクトは並行してキャッシュされます。 以降のページ訪問および再来訪では、JSON ルールアーティファクトを通じてキャッシュとメモリ内から決定が行われます。

（全幅に拡大するには、画像をクリックします）。

次のリストは、図の数値に対応します。

次の図は、訪問者、ブラウザー、at.js 2.5.0 以降および後続のページナビゲーションまたは再訪問のためのキャッシュされた JSON ルールアーティファクトの間のインタラクションを示しています。 この図では、後続のページナビゲーションや再来訪に対してデバイス上の決定が行われるユースケースにのみ焦点を当てています。 特定のページでライブになっているアクティビティに応じて、サーバーサイドの呼び出しを行ってサーバーサイドの決定を実行できます。

（全幅に拡大するには、画像をクリックします）。

次のリストは、図の数値に対応します。

on-device decisioning を有効にするにはどうすればよいですか？

On-device decisioning は、At.js 2.5.0 以降を使用するすべての Target ユーザーが利用できます。

on-device decisioning を有効にするには：

オンデバイス判定トグルを有効に Target ると、クライアントの ルールアーティファクトの生成と伝播が開始されます。

at.js 2.5.0 以降で on-device decisioning を使用するように設定するにはどうすればよいですか？

グローバル設定

すべての決定に対してデフォルトの判定方法 Target 設定できます。 様々な判定方法として、サーバー側のみ、オンデバイスのみ、ハイブリッドがあります。 Target UI で選択された判定方法は、decisioningMethod フィールドの下の window.targetGlobalSettings で設定されます。 decisioningMethod について詳しくは、targetGlobalSettings （）を参照してください。

<head>
    <script type="text/javascript">

        window.targetGlobalSettings = {
            clientCode: "yourClientCodeHere",
            imsOrgId: "imsOrgId@AdobeOrg",
            decisioningMethod: "on-device"

        };
    </script>

    <script type="text/javascript" src="at.js"></script>
</head>

カスタマイズされた設定

window.targetGlobalSettings で decisioningMethod を設定しても、ユースケースに従って各 Adobe Target 決定の decisioningMethod を上書きする場合は、At.js2.5.0 以降の getOffers （）呼び出しで decisioningMethod を指定することで、この手順を実行できます。

adobe.target.getOffers({

  decisioningMethod:"on-device",
  request: {
    execute: {
      mboxes: [
        {
          index: 0,
          name: "homepage"
        }
      ]
    }
 }
});

アーティファクトキャッシュ TTL

Target は、メタデータ、ルールおよび条件で構成されるアーティファクトとして on-device decisioning に適合するアクティビティを表します。 このアーティファクトは Akamai CDN にキャッシュされます。 ユーザーの初回の訪問時に、ユーザーのブラウザーが、on-device decisioning のアクティビティを表すアーティファクトをダウンロードしてキャッシュします。

その後サイトに訪問すると、ブラウザーはアーティファクトの新しいバージョンをダウンロードする必要があるかどうかを自動的に確認します。 このチェックにより、待ち時間が追加されます。 アーティファクトキャッシュ TTL は、最後に成功したダウンロード以降に更新されたアーティファクトをブラウザーがチェックしないようにする時間（分）を定義します。 期間が長いほど、パフォーマンスが向上します。 時間枠が短いほど、データの鮮度は高くなりますが、待ち時間が追加されるというコストがかかります。

アクティビティが実施要件を満たしていることを確認するにはどうすればよ on-device decisioning ですか？

実施要件を満たしてい on-device decisioning いアクティビティを作成すると、オンデバイス判定が実施要件を満たしていることを示すラベルがアクティビティの概要ページに表示されます。

このラベルは、アクティビティが常に on-device decisioning 経由で配信されるとは限りません。 at.js 2.5.0 以降が on-device decisioning を使用するように設定されている場合にのみ、このアクティビティはデバイス上で実行されます。 at.js 2.5.0 以降がオンデバイスを使用するように設定されていない場合、このアクティビティは、at.js から行われるサーバー呼び出しを使用して引き続き配信されます。

オンデバイス判定実施要件フィルターを使用すると、アクティビティページで実施要件を満たしてい on-device decisioning いすべてのアクティビティをフィルタリングできます。

on-device decisioning アクティビティが At.js 2.5.0 を介して確実に配信されるようにする手順の概要+?