adobe.target.triggerView (viewName, options) - at.js 2.x

最終更新日： 2025年5月5日
  • トピック：

作成対象：

  • 開発者

この関数は、新しいページが読み込まれるときや、ページ上のコンポーネントが再レンダリングされるときに呼び出すことができます。Visual Experience Composer （VEC）を使用して A/B Test と Experience Targeting （XT）アクティビティを作成するには、シングルページアプリケーション（SPA）に adobe.target.triggerView() を実装する必要があります。 adobe.target.triggerView() がサイトに実装されていない場合、VEC はSPAに使用できません。 詳細については、「シングルページアプリケーションの実装」を参照してください。

メモ
この関数は at.js 2 で導入されました。x を通じてクロスドメイントラッキングを使用している場合です。この関数は at.js バージョン 1 では使用できません。x.
パラメータータイプ必須？説明
viewName文字列○ビューを表す文字列型として任意の名前を渡します。このビュー名は、マーケターがアクションを作成して A/B Test アクティビティと Experience Targeting XT アクティビティを実行するために、VEC の Modifications パネルに表示されます。
optionsオブジェクト×
options > pageブール値×

TRUE： ページのデフォルト値は true です。page = true の場合、インプレッション数を増分するために Target のバックエンドに通知が送信されます。

通知は、オプション / ページが false に設定されている場合を除き、triggerView が呼び出されたときに常にデフォルトで送信されます。

FALSE: page=false の場合、インプレッション数を増分するための通知は送信されません。 この方法は、オファーを含むページでコンポーネントの再レンダリングのみを行う場合に使用します。

メモ：オプションとして {page: false} を使用して VEC が呼び出される場合、triggerView() のカスタムコードオファーは再レンダリングされません。

例：True

アクティビティのインプレッションやその他の指標を増分するための通知を Target バックエンドに送信する triggerView() 呼び出し。

adobe.target.triggerView("homeView")

例：False

triggerView() の呼び出しには、インプレッション数をカウントするための通知が Target バックエンドに送信されません。

adobe.target.triggerView("homeView", {page: false})

例：getoffers() および applyOffers() を使用した Promise 連結

getOffers() promise が解決されたときに triggerView() を実行するには、次の例に示すように、最終ブロックで triggerView() を実行することが重要です。 これは、VEC がオーサリングモードで Views を検出するために必要です。

adobe.target.getOffers({
    'request': {
        'prefetch': {
            'views': [{
                'parameters': {}
            }]
        }
    }
}).then(function(response) {
    // Apply Offers
    adobe.target.applyOffers({
        response: response
    });
}).catch(function(error) {
    console.log("AT: getOffers failed - Error", error);
}).finally(() => {
    // Trigger View call, assuming pageView is defined elsewhere
    adobe.target.triggerView(pageView, {
        page: true
    });
    console.log('AT: View triggered on : ' + pageView);
});

例：Adobe Visual Editing Helper extension との triggerView() の最適な互換性

Adobe Visual Editing Helper 拡張機能を使用する場合は、次の点を考慮してください

Google の Chrome 拡張機能の新しい V3 マニフェストポリシーにより、Visual Editing Helper extension は VEC の Target ライブラリを読み込む前に DOMContentLoaded イベントを待機する必要があります。 この遅延により、オーサリングライブラリの準備が整う前に web ページで triggerView() 呼び出しが実行され、読み込み時にビューが入力されない場合があります。

この問題を軽減するには、ページ load イベントのリスナーを使用します。

実装の例を次に示します。

function triggerViewIfLoaded() {
    adobe.target.triggerView("homeView");
}

if (document.readyState === "complete") {
    // If the page is already loaded
    triggerViewIfLoaded();
} else {
    // If the page is not yet loaded, set up an event listener
    window.addEventListener("load", triggerViewIfLoaded);
}
recommendation-more-help