タグマネージャーなしでTargetを実装する
タグマネージャーまたはAdobe Experience Platformのタグを使用せずにAdobe Targetを実装する方法について説明します。
実装ページにアクセスするには、管理/実装をクリックします。
このページでは、次の設定を指定できます。
- アカウントの詳細
- 実装方法
- プロファイル API
- デバッガーツール
- プライバシー
アカウントの詳細
次のアカウントの詳細を表示できます。 これらの設定は変更できません。
オンデバイス判定を有効にするには、切り替えスイッチを「オン」の位置にスライドさせます。
オンデバイス判定により、A/Bおよびエクスペリエンスのターゲット設定（XT）キャンペーンをサーバー上にキャッシュし、ほぼゼロの遅延でメモリ内の判定を実行できます。 詳しくは、 オンデバイス判定の概要を参照してください。
（条件付き）このオプションは、オンデバイス判定を有効にした場合に表示されます。
オンデバイス判定に適格なすべてのライブ Target アクティビティをアーティファクトに自動的に含める場合は、切り替えスイッチを「オン」の位置にスライドさせます。
このトグルをオフにすると、生成されたルール アーティファクトに含めるために、デバイス上の決定アクティビティを再作成してアクティブ化する必要があります。
実装方法
実装方法パネルでは、次の設定を行うことができます。
グローバル設定
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がVisitor API応答を長時間待たずに済みます。 この設定と、ここで説明している at.js のタイムアウト設定は相互に影響しません。
この設定は、訪問者プロファイルが保存される期間を決定します。 デフォルトでは、プロファイルは 2 週間保存されます。 この設定は、最大90日間まで延長できます。
プロファイルの有効期間の設定を変更するには、 クライアントケア にお問い合わせください。
主な実装方法
目的のat.js バージョンをダウンロードするには、適切なダウンロード ボタンをクリックします。
at.js設定を編集するには、目的のat.js バージョンの横にある 編集 をクリックします。
上記の設定に加えて、次の特定のat.js設定も使用できます。
enabled （ブラウザーが1st パーティ Cookieと3rd パーティ Cookieの両方を設定）を選択して、クロスドメイン機能がdisabled （ブラウザーがドメイン内のCookieを設定）、x only （ブラウザーがTargetのドメイン内のCookieを設定）、またはその両方かどうかを指定します。 at.js v2.10以降の場合、クロスドメイン機能がenabled （ブラウザーがファーストパーティ Cookieとサードパーティ Cookieの両方を設定）またはdisabled （ブラウザーがサードパーティ Cookieを設定しない）のどちらかを指定します。プロファイル API
API による一括更新の認証を有効または無効にし、プロファイル認証トークンを生成します。
詳しくは、 プロファイル API設定を参照してください。
デバッガーツール
高度なTarget デバッグツールを使用するための認証トークンを生成します。 「新しい認証トークンを生成」をクリックします。
プライバシー
これらの設定を使用すると、適用されるデータプライバシー法に準拠してTargetを使用できます。
「訪問者IP アドレスを難読化」ドロップダウンリストから目的の設定を選択します。
- 最後のオクテットの難読化
- IP難読化全体
- None
詳しくは、プライバシーを参照してください。
at.js のダウンロード
Target インターフェイスまたはダウンロード APIを使用してライブラリをダウンロードする手順。
Target インターフェイスを使用したat.jsのダウンロード
Target インターフェイスからat.jsをダウンロードするには：
- 管理 / 実装をクリックします。
- 「実装方法」セクションで、目的のat.js バージョンの横にある「ダウンロード」ボタンをクリックします。
Target ダウンロード APIを使用したat.jsのダウンロード
APIを使用してat.jsをダウンロードします。
-
クライアントコードを取得します。
クライアントコードは、Target インターフェイスの管理 > 実装 ページの上部にあります。
-
管理番号を取得します。
次の 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」が管理番号です。
-
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）に置き換えます。
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>
次の重要な注意点を考慮してください。
- HTML5 Doctype （例：
<!doctype html>）を使用してください。 サポートされていない古いdoctypeまたは古いdoctypeの場合、Targetはリクエストを実行できません。 - 事前接続とプリフェッチのオプションは、Web ページの読み込みを高速化するのに役立ちます。 これらの設定を使用する場合は、
<client code>を独自のクライアントコードに置き換えて、管理 > 実装 ページから取得できるようにしてください。 - データレイヤーがある場合、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 を購入した人」などのレコメンデーションアルゴリズムを駆動できます。
-
注文の詳細ページで、以下のモデルに示す mbox スクリプトを挿入します。
-
大文字のテキストを、カタログの動的値または静的値に置き換えます。
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>
注文の確認 mbox では、次のパラメーターを使用します。
注文を識別する一意の値（コンバージョンのカウントに使用）。
orderId は一意である必要があります。 重複する注文はレポートで無視されます。
購入金額。
通貨記号は渡さないでください。 （コンマではなく）小数点を使用して、10 進数値を示します。
この注文で購入された製品 ID のコンマ区切りのリスト。
これらの製品 ID は、追加のレポート分析をサポートするために監査レポートに表示されます。