タグマネージャーを使用しない Target の実装

Adobe Experience Platform でタグマネージャーまたはタグを使用せずに Adobe Target を実装する方法に関する情報です。

NOTE
Adobe Experience Platform のタグは、Target および at.js ライブラリを実装するための推奨される方法です。 次の情報は、Adobe Experience Platform でタグを使用して Target を実装する場合は適用されません。

実装ページにアクセスするには、Administration/Implementation をクリックします。

このページでは、次の設定を指定できます。

  • アカウントの詳細
  • 実装方法
  • プロファイル API
  • デバッガーツール
  • プライバシー
NOTE
Target Standard/Premium UI や REST API を使用して設定を設定する代わりに、at.js ライブラリで設定を上書きできます。 詳しくは、targetGlobalSettings() を参照してください。

アカウントの詳細

次のアカウントの詳細を表示できます。 これらの設定は変更できません。

設定
説明
Client Code
クライアントコードは、Target API を使用する際に必要となることが多い、クライアント固有の文字シーケンスです。
IMS Organization ID
この ID は、実装とAdobe Experience Cloud アカウントを結び付けます。
On-Device Decisioning

オンデバイス判定を有効にするには、切り替えスイッチを「オン」の位置にスライドします。

オンデバイス判定を使用すると、A/B およびエクスペリエンスのターゲット設定(XT)キャンペーンをサーバーにキャッシュし、ほぼゼロの待ち時間でメモリ内判定を実行できます。 詳しくは、 オンデバイス判定の概要を参照してください。

Include all existing on-device decisioning qualified activities in the artifact

(条件付き)このオプションは、オンデバイス判定を有効にした場合に表示されます。

オンデバイス判定の対象となるすべてのライブ Target アクティビティをアーティファクトに自動的に含める場合は、切り替えスイッチを「オン」の位置にスライドします。

このトグルをオフのままにすると、生成されたルールアーティファクトに含めるために、オンデバイス判定アクティビティを再作成してアクティブ化する必要があります。

実装方法

次の設定を実装方法パネルで設定できます。

グローバル設定

NOTE
これらの設定は、すべての.js ライブラリ Target 適用されます。 「実装方法」セクションで変更を実行した後、ライブラリをダウンロードして、実装で更新する必要があります。
設定
説明
Page load enabled (Auto-create global mbox)
各ページが読み込まれると自動的に実行されるように、グローバル mbox 呼び出しを at.js ファイルに埋め込むかどうかを選択します。
Global mbox

global mbox の名前を選択します。デフォルトでは、この名前は target-global-mbox です。

特殊文字(アンパサンド(&)を含む)は、at.js を使用した mbox 名で使用できます。

Timeout (seconds)

Target が定義された期間内にコンテンツの応答をしない場合、サーバー呼び出しはタイムアウトし、デフォルトコンテンツが表示されます。訪問者のセッション中、追加の呼び出しが引き続き試行されます。デフォルト値は 5 秒です。

at.js ライブラリは、XMLHttpRequest のタイムアウト設定を使用します。 タイムアウトは、リクエストが発生すると開始し、サーバーから応答を受け取 Target と停止します。 詳しくは、Mozilla Developer Network の XMLHttpRequest.timeout を参照してください。

指定したタイムアウトが応答の受信前に発生した場合、デフォルトのコンテンツが表示され、すべてのデータ収集は Target ーザーエッジで行われるので、訪問者はアクティビティの参加者としてカウントされる場合があります。 リクエストが Target エッジに到達すると、訪問者がカウントされます。

タイムアウト設定を構成する際は、次の点を考慮してください。

  • 値が低すぎると、訪問者はアクティビティの参加者としてカウントされるものの、ほとんどの時間デフォルトのコンテンツが表示される可能性があります。
  • 値が高すぎると、Web ページに空白の領域が表示されるか、長時間の本文の非表示を使用している場合は空白のページが表示される可能性があります。

mbox の応答時間をよりよく把握するには、ブラウザーの開発者ツールの「ネットワーク」タブを確認してください。また、Catchpoint など、サードパーティの Web パフォーマンス監視ツールを使用することもできます。

注意: visitorApiTimeout 設定を使用すると、訪問者 API 応答の待機時間が長くなりすぎないよ Target になります。 この設定と、ここで説明している at.js のタイムアウト設定は相互に影響しません。

Profile Lifetime

この設定は、訪問者プロファイルが保存される期間を決定します。デフォルトでは、プロファイルは 2 週間保存されます。この設定は、最大 90 日まで増やすことができます。

プロファイルの有効期間の設定を変更するには、Client Care にお問い合わせください。

主な実装方法

NOTE
Adobe Target は、両方の at.js 1 をサポートしています。x と at.js 2 の両方について示しています。x を通じてクロスドメイントラッキングを使用している場合です。サポート対象のバージョンを使用するには、at.js のいずれかのメジャーバージョンの最新アップデートにアップグレードしてください。

目的の at.js バージョンをダウンロードするには、該当する ダウンロード ボタンをクリックします。

at.js の設定を編集するには、目的の at.js バージョンの横にある Edit をクリックします。

WARNING
これらのデフォルト設定を変更する前に、現在の実装に影響を与えないように、Client Care に相談してください。

上記の設定に加えて、次の特定の at.js 設定も使用できます。

設定
説明
クロスドメイン
at.js v1 の場合。x:enabled (ブラウザーがファーストパーティ cookie とサードパーティ cookie の両方を設定する)を選択することにより、クロスドメイン機能を disabled (ブラウザーがドメインに cookie を設定する(ファーストパーティ cookie のみ))、x only (ブラウザーが Target のドメインにのみ cookie を設定する)、またはその両方のいずれにするかを指定します。 at.js v2.10 以降で、クロスドメイン機能を enabled (ブラウザーがファーストパーティとサードパーティの Cookie を両方とも設定する)にするか、disabled (ブラウザーがサードパーティの Cookie を設定しない)にするかを指定します。
カスタムライブラリヘッダー
ライブラリの最上部に含めるカスタム JavaScript を追加します。
カスタムライブラリフッター
ライブラリの最下部に含めるカスタム JavaScript を追加します。

プロファイル API

API による一括更新の認証を有効または無効にし、プロファイル認証トークンを生成します。

詳しくは、 プロファイル API 設定を参照してください。

デバッガーツール

高度な Target デバッグツールを使用するための認証トークンを生成します。 Generate New Authentication Token をクリックします。

新しい認証トークンの生成

プライバシー

これらの設定により、適用されるデータプライバシー法に従って Target を使用できます。

訪問者 IP アドレスを不明化ドロップダウンリストから目的の設定を選択します。

  • 最後のオクテットの不明化
  • IP の不明化全体
  • None

詳しくは、プライバシーを参照してください。

NOTE
レガシーブラウザーサポートオプションは、at.js バージョン 0.9.3 以前で使用できました。 このオプションは、at.js バージョン 0.9.4 で削除されました。at.js でサポートされているブラウザーのリストについては、 サポートされているブラウザーを参照してください。
レガシーブラウザーは、CORS(クロスオリジンリソース共有)を完全にはサポートしない古いブラウザーです。こうしたブラウザーには、バージョン 11 より前の Internet Explorer およびバージョン 6 以下の Safari が含まれます。従来のブラウザーサポートが無効になっている場合、Target れらのブラウザーでコンテンツを配信しなかったか、レポートで訪問者がカウントされていました。 このオプションを有効にした場合、カスタマーエクスペリエンス(顧客体験)を良好にするために、古いブラウザーをまたいで品質保証を行うことをお勧めします。

at.js のダウンロード

Target インターフェイスまたはダウンロード API を使用してライブラリをダウンロードする手順。

NOTE
Adobe Experience Platform は、Target および at.js ライブラリを実装するための推奨される方法です。 次の情報は、Adobe Experience Platform でタグを使用して Target を実装する場合は適用されません。
Adobe Target は、両方の at.js 1 をサポートしています。x と at.js 2 の両方について示しています。x を通じてクロスドメイントラッキングを使用している場合です。サポート対象のバージョンを使用するには、at.js のいずれかのメジャーバージョンの最新アップデートにアップグレードしてください。 各バージョンについて詳しくは、 at.js のバージョンの詳細を参照してください。

Target インターフェイスを使用した at.js のダウンロード

Target インターフェイスから at.js をダウンロードするには:

  1. AdministrationImplementation ​をクリックします。
  2. 「実装方法」セクションで、目的の at.js バージョンの横にある「Download」ボタンをクリックします。

Target Download API を使用して at.js をダウンロードします

API を使用して at.js をダウンロードするには、次の手順に従います。

  1. クライアントコードを取得します。

    クライアントコードは、Target インターフェイスの Administration/Implementation ページの上部に表示されます。

  2. 管理番号を取得します。

    次の URL を読み込みます。

    code language-none
    https://admin.testandtarget.omniture.com/rest/v1/endpoint/<varname>client code</varname>
    

    client code を手順 1 のクライアントコードに置き換えます。

    この URL を読み込んだ結果は、次の例のようになります。

    code language-none
    {
      "api": "https://admin6.testandtarget.omniture.com/admin/rest/v1"
    }
    

    この例では、「6」が管理番号です。

  3. at.js をダウンロードします。

    この URL を次の構造で読み込みます。 この URL を読み込むと、カスタマイズされた at.js ファイルのダウンロードが開始されます。

    code language-none
    https://admin<varname>admin number</varname>.testandtarget.omniture.com/admin/rest/v1/libraries/atjs/download?client=<varname>client code</varname>&version=<version number>
    
    • admin number を管理番号に置き換えます。
    • client code を手順 1 のクライアントコードに置き換えます。
    • version number を目的の at.js バージョン番号(例:2.2)に置き換えます。
WARNING
Target チームがサポートを提供しているのは、at.js の最新バージョンとその 1 つ前のバージョンの 2 つのみです。 必要に応じて at.js をアップグレードし、サポート対象のバージョンを使用するようにしてください。 各バージョンについて詳しくは、 at.js のバージョンの詳細を参照してください。

at.js の実装

at.js は、Web サイトのすべてのページの <head> 要素で実装する必要があります。

Adobe Experience Platformのタグなど、タグマネージャーを使用しない Target の一般的な実装は次のよになります。

<!doctype html>
<html>
<head>
    <meta charset="utf-8">
    <title>Title of the Page</title>
    <!--Preconnect and DNS-Prefetch to improve page load time-->
    <link rel="preconnect" href="//<client code>.tt.omtrdc.net">
    <link rel="dns-prefetch" href="//<client code>.tt.omtrdc.net">
    <!--/Preconnect and DNS-Prefetch-->
    <!--Data Layer to enable rich data collection and targeting-->
    <script>
        var digitalData = {
            "page": {
                "pageInfo": {
                    "pageName": "Home"
                }
            }
        };
    </script>
    <!--/Data Layer-->
    <!-- targetPageParams(), targetPageParamsAll(), Data Providers or targetGlobalSettings() functions to enrich the visitor profile or modify the library settings-->
    <script>
        targetPageParams = function() {
            return {
                "a": 1,
                "b": 2,
                "pageName": digitalData.page.pageInfo.pageName,
                "profile": {
                    "age": 26,
                    "country": {
                        "city": "San Francisco"
                    }
                }
            };
        };
    </script>
    <!--/targetPageParams()-->

    <!--jQuery or other helper libraries should be implemented before at.js if you would like to use their methods in Target-->
    <script src="jquery-3.3.1.min.js"></script>
    <!--/jQuery-->
    <!--Target's JavaScript SDK, at.js-->
    <script src="at.js"></script>
    <!--/at.js-->
</head>
<body>
    The default content of the page
</body>
</html>

次の重要な注意点を考慮してください。

  • HTML 5 Doctype (例:<!doctype html>)を使用する必要があります。 サポートされていない doctype または古い doctype を使用すると、Target がリクエストを作成できなくなる可能性があります。
  • 事前接続とプリフェッチのオプションは、Web ページの読み込みを高速化するのに役立ちます。これらの設定を使用する場合は、<client code> を独自のクライアントコードに置き換えます。これは、Administration/Implementation ページから取得できます。
  • データレイヤーがある場合、at.js が読み込まれる前にページの <head> でデータレイヤーについてできるだけ多く定義することが最適です。このプレースメントは、パーソナライゼーションに Target してこの情報を使用する最大限の機能を提供します。
  • targetPageParams()targetPageParamsAll()、データプロバイダー、targetGlobalSettings() などの特別な Target 関数は、データレイヤーの後、および at.js の読み込み前に定義する必要があります。 または、これらの関数を at.js 設定を編集ページのライブラリヘッダーセクションに保存して、at.js ライブラリ自体の一部として保存することもできます。 これらの関数について詳しくは、「at.js 関数」を参照してください。
  • jQuery などのJavaScript ヘルパーライブラリを使用する場合は、Target エクスペリエンスの構築時に構文とメソッドを使用できるように、Target の前にそれらを含めます。
  • at.js はページの <head> に含めます。

コンバージョンの追跡

注文の確認 mbox では、サイトでの注文に関する詳細が記録され、売上高および注文に基づくレポートが可能になります。また、注文の確認 mbox は、「商品 x および商品 y を購入した人」などのレコメンデーションアルゴリズムを駆動できます。

NOTE
Adobeでは、Web サイトで購入する場合は、レポートに Analytics for Target (A4T)を使用していても、注文確認 mbox を実装することをお勧めします。
  1. 注文の詳細ページで、以下のモデルに示す mbox スクリプトを挿入します。

  2. 大文字のテキストを、カタログの動的値または静的値に置き換えます。

    note tip
    TIP
    また、任意の mbox で注文情報を渡すこともできます(orderConfirmPage という名前にする必要はありません)。 また、同じキャンペーン内の複数の mbox に注文情報を渡すこともできます。
    code language-none
    <script type="text/javascript">
    adobe.target.trackEvent({
        "mbox": "orderConfirmPage",
        "params":{
            "orderId": "ORDER ID FROM YOUR ORDER PAGE",
            "orderTotal": "ORDER TOTAL FROM YOUR ORDER PAGE",
            "productPurchasedId": "PRODUCT ID FROM YOUR ORDER PAGE, PRODUCT ID2, PRODUCT ID3"
        }
    });
    </script>
    
NOTE
注文確認 mbox で、複数の製品 ID を区切るにはコンマで区切ります。

注文の確認 mbox では、次のパラメーターを使用します。

パラメーター
説明
orderId

注文を識別する一意の値(コンバージョンのカウントに使用)。

orderId は一意である必要があります。重複する注文はレポートで無視されます。

orderTotal

購入金額。

通貨記号は渡さないでください。(コンマではなく)小数点を使用して、10 進数値を示します。

productPurchasedId(オプション)

この注文で購入された製品 ID のコンマ区切りのリスト。

これらの製品 ID は、追加のレポート分析をサポートするために監査レポートに表示されます。

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