タグマネージャーを使用せずにTargetを実装する

タグマネージャー(Adobe Experience Platform Launch)を使用しないでのAdobe Targetの実装に関する情報です。

メモ

Adobe Experience Platform ランチは、ターゲットおよびat.jsライブラリを実装する場合に推奨される方法です。次の情報は、AdobePlatform launchを使用してターゲットを実装する場合には適用されません。

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

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

  • アカウントの詳細
  • 導入方法
  • プロファイルAPI
  • デバッガツール
  • プライバシー
メモ

Target Standard/Premium UI や REST API を使用して設定を構成する代わりに、at.js ライブラリで設定を上書きすることができます。詳しくは、targetGlobalSettings() を参照してください。

アカウントの詳細

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

設定 説明
クライアントコード クライアントコードは、Target API を使用する際に必要になることの多い、クライアント固有の一連の文字です。
IMS 組織 ID この ID は、実装を Adobe Experience Cloud アカウントと結び付けます。
オンデバイス判定 オンデバイス判定を有効にするには、トグルを「オン」の位置にスライドさせます。
オンデバイス判定機能を使用すると、A/Bアンドエクスペリエンスターゲット設定(XT)キャンペーンをサーバー上にキャッシュし、ほぼゼロの遅延でメモリ内判定を実行できます。詳しくは、Adobe TargetSDK​ガイドのオンデバイス判定の概要を参照してください。
既存のOn-Device Decisioningの条件を満たすアクティビティをすべてアーティファクトに含めます。 (条件付き)このオプションは、オンデバイスの判定を有効にした場合に表示されます。
オンデバイスの判定に適したすべてのライブターゲットアクティビティを自動的にアーティファクトに含める場合は、トグルを「オン」の位置にスライドします。
このチェックボックスをオフにしたままにすると、生成されたルールのアーティファクトに含めるために、オンデバイス判定アクティビティを再作成し、アクティブ化する必要があります。

導入方法

以下の設定は、Implementation methodsパネルで設定できます。

グローバル設定

メモ

これらの設定は、すべての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 にお問い合わせください。

主な実装方法

重要

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

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

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

重要

これらのデフォルト設定を変更する前に、現在の実装に影響を与えないように、ClientCareにお問い合わせください。

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

設定 説明
カスタムライブラリヘッダー ライブラリの最上部に含めるカスタム JavaScript を追加します。
カスタムライブラリフッター ライブラリの最下部に含めるカスタム JavaScript を追加します。

プロファイルAPI

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

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

デバッガツール

高度なTargetデバッグツールを使用するための認証トークンを生成します。 「新しい認証トークンを生成」をクリックします。

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

プライバシー

これらの設定により、プライバシーに関する法律に準拠したTargetを使用できます。

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

  • 最終オクテットの不明化
  • IPの全体的な不明化
  • None

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

メモ

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

at.js のダウンロード

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

メモ
  • Adobe Experience Platform ランチは、ターゲットおよびat.jsライブラリを実装する場合に推奨される方法です。次の情報は、AdobePlatform launchを使用してターゲットを実装する場合には適用されません。

  • ターゲットチームは、at.js 1の両方をサポートしています。x と at.js 2.x 間のマッピングについて説明します。サポートされているバージョンを実行していることを確認するには、at.jsのメジャーバージョンのいずれかを最新のアップデートにアップグレードしてください。 各バージョンについて詳しくは、 at.js のバージョンの詳細を参照してください。

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

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

  1. 管理実装​をクリックします。
  2. 実装メソッドセクションで、目的のat.jsバージョンの横にある「ダウンロード」ボタンをクリックします。

TargetダウンロードAPIを使用したat.jsのダウンロード

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

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

    クライアントコードは、Targetインターフェイスの​管理 > 実装​ページの先頭で入手できます。

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

    次の URL を読み込みます。

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

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

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

    { 
      "api": "https://admin6.testandtarget.omniture.com/admin/rest/v1" 
    }
    

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

  3. ダウンロード at.js.

    この URL を次の構造で読み込みます。

    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など)に置き換えます。
    重要

    Target チームがサポートを提供しているのは、at.js の最新バージョンとその 1 つ前のバージョンの 2 つのみです。必要に応じて at.js をアップグレードし、サポート対象のバージョンを使用するようにしてください。各バージョンについて詳しくは、 at.js のバージョンの詳細を参照してください。

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

at.js の実装

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

AdobePlatform launchのようなタグマネージャーを使用しないターゲットの一般的な実装は、次のようになります。

<!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 関数(targetPageParams()targetPageParamsAll()、データプロバイダー、および targetGlobalSettings() など)は、データレイヤーの後で、at.js が読み込まれる前に定義する必要があります。また、これらの関数は、at.js設定を編集ページのライブラリヘッダーセクションに保存し、at.jsライブラリ自体の一部として保存することもできます。 これらの関数について詳しくは、at.js 関数.
  • jQueryなどのJavaScriptヘルパーライブラリを使用する場合は、ターゲットの前にこれらのライブラリを含めておくと、ターゲットエクスペリエンスを構築する際に構文とメソッドを使用できるようになります。
  • at.js はページの <head> に含めます。

コンバージョンの追跡

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

メモ

Webサイトで購入を行う場合、レポートにAnalyticsのターゲット(A4T)を使用している場合でも、Adobeでは注文の確認mboxを実装することをお勧めします。

  1. 注文の詳細ページで、以下のモデルに示す mbox スクリプトを挿入します。

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

    メモ

    複数の製品 ID を区切るには、コンマを使用してください。

    ヒント:​任意の mbox に注文情報を渡すこともできます(orderConfirmPage という名前にする必要はありません)。また、同じキャンペーン内の複数の mbox に注文情報を渡すこともできます。

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

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

パラメーター 説明
orderId 注文を識別する一意の値(コンバージョンのカウントに使用)。
orderId は一意である必要があります。重複する注文はレポートで無視されます。
orderTotal 購入金額。
通貨記号を渡さないでください。(コンマではなく)小数点を使用して、10 進数値を示します。
productPurchasedId(オプション) この注文で購入された製品 ID のコンマ区切りのリスト。
これらの製品 ID は監査レポートに表示され、さらに詳細なレポート分析ができます。

このページ