実装方法 Target タグマネージャーなし

実装に関する情報 Adobe Target タグマネージャーやタグを Adobe Experience Platform.

NOTE
のタグ Adobe Experience Platform は、 Target と at.js ライブラリに含まれています。 次の情報は、 Adobe Experience Platform 実装する Target.

実装ページにアクセスするには、 管理 > 実装.

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

  • アカウントの詳細
  • 実装方法
  • プロファイル API
  • デバッガーツール
  • プライバシー
NOTE
設定を、 Target Standard/Premium UI または REST API を使用する。 詳しくは、targetGlobalSettings() を参照してください。

アカウントの詳細

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

設定
説明
クライアントコード
クライアントコードは、Target API を使用する際に必要になることの多い、クライアント固有の一連の文字です。
IMS 組織 ID
この ID は、実装を Adobe Experience Cloud アカウントと結び付けます。
オンデバイス判定

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

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

既存のすべてのオンデバイス判定対象アクティビティをアーティファクトに含めます

(条件付き)このオプションは、On-Device Decisioning を有効にした場合に表示されます。

すべてをライブにしたい場合は、切り替えを「オン」の位置にスライドさせます。 Target オンデバイス判定がアーティファクトに自動的に含まれると認定されるアクティビティ。

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

実装方法

以下の設定は、実装方法パネルで設定できます。

グローバル設定

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

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

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

タイムアウト(秒)

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

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

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

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

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

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

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

プロファイルの有効期間

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

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

主な実装方法

NOTE
Adobe Target は、at.js 1.x と at.js 2.x 間のマッピングについて説明します。at.js のメジャーバージョンのいずれかの最新の更新にアップグレードして、サポート対象のバージョンを実行していることを確認してください。

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

at.js 設定を編集するには、 編集 をクリックします。

WARNING
これらのデフォルト設定を変更する前に、 ClientCare したがって、現在の実装に影響を与えません。

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

設定
説明
Cross-Domain
at.js v1 の場合。x、クロスドメイン機能が disabled ( ブラウザーはお客様のドメインに cookie を設定します(ファーストパーティ cookie のみ)。 x only (ブラウザーは、Target のドメインにのみ cookie を設定します)、またはその両方に対して、 enabled (ブラウザーはファーストパーティ Cookie とサードパーティ Cookie の両方を設定します)。 at.js v2.10 以降の場合は、クロスドメイン機能を使用するかどうかを指定します enabled (ブラウザーはファーストパーティ Cookie とサードパーティ Cookie の両方を設定)または disabled (ブラウザーはサードパーティ Cookie を設定しません)。
カスタムライブラリヘッダー
ライブラリの最上部に含めるカスタム JavaScript を追加します。
カスタムライブラリのフッター
ライブラリの最下部に含めるカスタム JavaScript を追加します。

プロファイル API

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

詳しくは、 プロファイル API 設定.

デバッガーツール

詳細を使用するための認証トークンを生成する Target デバッグツールを使用します。 クリック 新しい認証トークンを生成.

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

プライバシー

これらの設定を使用すると、 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 のバージョンの詳細を参照してください。

を使用して at.js をダウンロードします。 Target インターフェイス

at.js を Target インターフェイス:

  1. 管理実装 ​をクリックします。
  2. 「実装方法」セクションで、 ダウンロード ボタンをクリックします。

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

API を使用して at.js をダウンロードするには:

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

    クライアントコードは、 管理 > 実装 ページ Target インターフェイス。

  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
The Target チームがサポートを提供している at.js は、最新バージョンとその 1 つ前のバージョンの 2 つのみです。 必要に応じて at.js をアップグレードし、サポート対象のバージョンを実行していることを確認してください。各バージョンについて詳しくは、 at.js のバージョンの詳細を参照してください。

at.js の実装

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

の典型的な実装 Target タグマネージャーを使用しない(例:内のタグ) Adobe Experience Platform 次のようになります。

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

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

  • HTML5 の Doctype( 例: <!doctype html>) を使用する必要があります。 サポートされていない doctype や古い doctype を使用すると、が発生する可能性があります Target リクエストを実行できません。
  • 事前接続とプリフェッチのオプションは、Web ページの読み込みを高速化するのに役立ちます。これらの設定を使用する場合は、 <client code> 独自のクライアントコードを使用して、 管理 > 実装 ページに貼り付けます。
  • データレイヤーがある場合、at.js が読み込まれる前にページの <head> でデータレイヤーについてできるだけ多く定義することが最適です。この場所に、 Target パーソナライゼーション用。
  • 特殊 Target 関数 targetPageParams(), targetPageParamsAll()、データプロバイダー、 targetGlobalSettings() は、データレイヤーの後で、at.js が読み込まれる前に定義する必要があります。 または、これらの関数を at.js 設定を編集ページの「ライブラリヘッダー」セクションに保存して、at.js ライブラリ自体の一部として保存することもできます。 これらの関数について詳しくは、at.js 関数.
  • jQuery などの JavaScript ヘルパーライブラリを使用する場合は、その前にこれらのライブラリをインクルードします。 Target したがって、 Target エクスペリエンス。
  • at.js はページの <head> に含めます。

コンバージョンの追跡

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

NOTE
ユーザーが Web サイトで買い物をする場合、Analytics を Target (A4T) を使用して、レポートに反映させます。
  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