Adobe Analytics（SiteCatalyst）タグ構成ガイド（レガシー）

これは新しい（推奨）バージョンのレガシーAdobeタグで、タグマーケットプレイスからAdobe AppMeasurement for JavaScriptタグが利用可能です。

動作原理

Adobe Analytics（SiteCatalyst）は、AdobeのWebアナリティクスを提供するSaaSアプリケーションです。

開始する前に

開始する前に、以下の項目を考慮してください：

• Adobe Experience Cloud IDサービスを使用する場合は、このタグを追加する前にAdobe Experience Cloud IDサービスタグを追加してください。
• S-Codeバージョンを変更する際は、正しいテンプレートを取り込むために既存のテンプレートを削除してください。
• 変数値に基づいてレポートスイートを構成するためにs_accountにマッピングします。これはデフォルト構成と動的アカウントリスト構成を上書きします。
• s_accountにマッピングする場合、動的アカウント構成をはいに変更してください。
• AAMオプションを含むS-Codeバージョンを選択してください。これにはパートナー値が必要です。
• サードパーティトラッキングの場合、デフォルトのサーバー位置は122(122.2o7.net)です。
  • 112.2o7.netデータ収集サーバーの場合、サーバーとセキュアサーバーを直接構成します。
  • 例：mysite.112.2o7.net

前提条件

• s_code.jsのローカルコピー
  • このタグを構成するには、Adobeアカウントから生成されたs_code.js JavaScriptファイルが必要です。
  • そのコードのセクションはTiQ構成にコピーされます。

JavaScriptライブラリファイルの名前は異なる場合があります。

• s_code.jsについてもっと学ぶ.

• ソリューションデザインリファレンス

  • （オプション）このドキュメントは、Adobe Analyticsソリューションで追跡されるすべてのprops、eVars、およびイベントを定義します。
  • この情報はTiQでAdobeタグを正確に構成するために必要です。

サポートされているバージョン

• バージョンH.20 - H.27（Adobe Audience Managerを含むH.25 - H.27）

タグ構成

まず、TealiumのタグマーケットプレイスにアクセスしてAdobe Analytics（レガシー）タグを追加します（タグの追加方法について学ぶ）。

タグを追加した後、次の構成を構成します：

• S-Codeバージョン

  • s_code.jsライブラリのバージョン。
  • バージョン25から27はAdobe Audience Managerをサポートしています。

• レポートスイート

  • 使用するデフォルトのレポートスイート。
  • 動的アカウントリストで構成された値に基づいて変更される場合があります。
  • 参照s_code.js: s.account

• サーバー

  • データ収集サーバー。
  • 参照s_code.js: s.trackingServer

• セキュアサーバー

  • “https"データ収集サーバー。
  • 参照s_code.js: s.trackingServerSecure

• ネームスペース

  • サーバーとセキュアサーバーが2o7.netで終わる場合にのみ、サードパーティクッキーに適用されます。
  • 参照s_code.js: s.namespace

• エンタープライズクラウドID

  • バージョンH.27以降でVisitor APIを使用する場合、ここにエンタープライズクラウドIDを入力します。
  • Adobe Enterprise Cloud IDサービスについてもっと学ぶ.

• 自動リンクトラッキング

  • 推奨値はデフォルト値のはいです。
  • いいえに構成する場合、リンクトラッキングエクステンションなどの他の方法を使用してすべての自動リンクトラッキングを複製する必要があります。

• ダウンロードタイプ

  • ダウンロードリンクとしてトラッキングしたいファイル拡張子のタイプをリストします。
  • 参照s_code.js: s.linkDownloadFileTypes

• 内部リンクフィルター

  • リンククリックがAdobeレポートで退出クリックとして報告されないようにするために使用されます。
  • 参照s_code.js: s.linkInternalFilters

• 通貨コード

  • 3文字の通貨コード、例えばUSDはアメリカドルです。
  • 参照s_code.js: s.currencyCode

• 動的アカウント使用

  • ドメインまたは他の動的値に基づいて異なるレポートスイートにデータを送信できるようにするためにはいに構成します。

• 動的アカウントリスト

  • ドメインまたは他の動的値に基づいて動的にレポートスイートを構成するために使用されます。
  • 例：testreportsuite=testing.example.com,qa.example.com;prodreportsuite=www.example.com
  • SiteCatalystで動的アカウントリストを使用する方法について学ぶ.

• S-Object名

  • デフォルト名はsです。
  • ページ上で複数のレガシーAdobe AnalyticsタグまたはAdobe AppMeasurementタグを実行している場合は、異なる名前を構成します。

• クリア変数

  • 各トラッキングコール後にprops、eVars、およびイベントをクリアします。
  • デフォルト値はいいえです。

• パートナー

  • Adobe Audience Managerを使用する場合は、パートナーIDを入力します。それ以外の場合は空白のままにしてください。
  • 参照s_code.js: DIL.create()

ロードルール

ロードルールは、サイト上でこのタグのインスタンスをいつ、どこでロードするかを決定します。

Adobe Analyticsの推奨ロードルール：すべてのページ

データマッピング

マッピングは、データレイヤー変数からベンダータグの対応する宛先変数にデータを送信するプロセスです。変数をタグ宛先にマッピングする方法の説明については、データマッピングを参照してください。

データレイヤー変数（eVars、propsなど）はマッピングツールボックスを使用してマッピングできます。

1. データマッピングタブをクリックし、+ 宛先を選択をクリックします。
   マッピングツールボックスが表示されます。
   

   

2. + カスタム宛先を追加をクリックして、テキストボックスに別のpropまたはeVarを入力することで、追加のマッピングをすばやく追加できます。

同じ変数の複数のpropsとeVarsはカンマ(,)で区切られるべきです。Adobeの構文に合わせてeVarに大文字のVを使用してください。

利用可能なデータレイヤー変数

標準

変数	説明
pageName	ページ名
channel	チャンネル
server	サーバー
hier1 から hier3	階層
visitorID	訪問ID
s_account	レポートスイートオーバーライド

イベント

変数	説明
prodView	prodView
scOpen	scOpen
scAdd	scAdd
scRemove	scRemove
scView	scView
scCheckout	scCheckout
purchase	purchase
event1 から event1000	イベント

製品レベルのイベント

変数	説明
PRODUCTS_event1 から PRODUCTS_event100	製品イベント

Props

prop1 から prop75

eVars

変数	説明
campaign	(eVar0)
eVar1 から eVar75	eVars
contextData.myvar	コンテキストデータ

マーチャンダイジングeVars

変数	説明
PRODUCTS_eVar1 から eVar75	製品eVars

コマース

変数	説明
purchaseID	購入ID
transactionID	トランザクションID
state	州
zip	郵便番号
PRODUCTS_id	製品ID 配列
PRODUCTS_category	製品カテゴリ 配列
PRODUCTS_quantity	製品数量 配列
PRODUCTS_price	製品価格 配列

その他

変数	説明
リンク追跡 - doneAction パラメータ	(H25のみ)
List 1 から List 3	リスト

E-コマース マッピング

Adobe製品の文字列を適切にフォーマットし、収益データをレポートスイートに送信するには、E-コマース拡張機能を追加して構成する必要があります。拡張機能で構成された変数は、タグ統合によって自動的に期待される構文にフォーマットされます。

例えば、製品カテゴリ、製品ID、製品数量、製品価格の変数は、複数の製品を扱う次の例で示されるように製品文字列に変換されます：

s.products= product_category;product_id;product_quantity;product_price;;

マッピングイベント

マッピングツールボックスのイベントセクションを使用して、特定の変数の値に応じてイベントがトリガーされるタイミングを定義します。

変数を選択して左サイドバーの イベント をクリックすると、値 と トリガー の2つのフィールドが表示されます。

• 値 ボックスでは、変数の値を定義します。
• トリガー ボックスでは、追跡するAdobeイベントを選択します。

この例では、変数 page_type が product および cart に等しい場合に、Adobeイベント prodView と scView をトリガーするように構成します：

マーチャンダイジング eVars

Adobeの実装では、s.products 文字列にeVar値を添付することで、製品にeVarを関連付けることができます。例えば、製品文字列の各製品に関連付けたい配列変数 product_discount がある場合、マーチャンダイジングeVarマッピングは次のように s.products 文字列を作成します。

例：

utag_data.product_id       = ["prodA", "prodB"];
utag_data.product_price    = ["25.12", "10.99"];
utag_data.product_discount = ["**12.34**", "**1.23**"];

次に、product_discount をマーチャンダイジング eVar4 にマッピングすると、次のような s.products 文字列が得られます：

s.products=";prodA;1;25.12;;**evar4=12.34**,;prodB;1;10.99;;**evar4=1.23**"

配列でない変数（単一値）をマーチャンダイジング eVar にマッピングする場合、その単一値は各製品に適用されます。

例：

utag_data.product_id       = ["prodA", "prodB"];
utag_data.product_price    = ["25.12", "10.99"];
utag_data.product_discount = "**1.99**";

上記と同じマッピングで、得られる s.products 文字列は次のようになります：

s.products=";prodA;1;25.12;;**evar4=1.99**,;prodB;1;10.99;;**evar4=1.99**"

製品レベルのイベント

製品レベルのイベントは、マーチャンダイジング eVars と同様に機能します。単一の値を使用して製品文字列のすべての製品に同じ変数を適用するか、値の配列を使用して各製品に異なる値を適用することができます。

例：

utag_data.product_id       = ["prodA", "prodB"];
utag_data.product_price    = ["25.12", "10.99"];
utag_data.order_discount   = "**12.00**";

次に、order_discount を product event15 にマッピングすると、次のような s.products 文字列が得られます。

s.products=";prodA;1;25.12;**event15=12.00**;,;prodB;1;10.99;**event15=12.00**;"

両方の製品に同じ注文割引が適用されていることに注意してください。

マーチャンダイジング eVars と製品レベルのイベントの配列マッピングは、バージョンH.26以降で利用可能です。

doPluginsのための必要な拡張機能

s_code.js ファイルの次の2つのセクションのコードを、TiQ構成の拡張機能にコピーする必要があります：

• Do Pluginsセクション
• プラグインとモジュール

Do Plugins

Do Plugins セクションは常に プラグインとモジュール セクションの上にあります。このセクションは通常、次の行で始まります：

/* Plugin Config */
s.usePlugins=true;

これらの行から次の行までのすべてをコピーします：

s.doPlugins=s_doPlugins;

このコードブロックを JavaScript Code extension に貼り付け、Adobe Analyticsタグに適用し、拡張機能の名前を Do Plugins Section とします：

プラグインとモジュール

s_code のプラグインとモジュールセクションは、

/***********************PLUGINS SECTION ********************/

で始まり、この行の直前で終わります：

/************* DO NOT ALTER ANYTHING BELOW THIS LINE ! **************/

このコードセクション全体をコピーして、Adobe Analyticsタグに適用される別のJavaScript Code拡張機能に貼り付けます。この拡張機能の名前を Plugins and Modules とします：

次に、Plugins and Modules JavaScript拡張機能を Do Plugins セクション JavaScript拡張機能の直上にドラッグします。

次のセクションのコードで始まる

/************* DO NOT ALTER ANYTHING BELOW THIS LINE ! **************/

は、TiQ内のタグテンプレートを通じてロードされるAdobe s_code ライブラリのコアです。

新しいバージョンへのアップグレード

Adobeタグの新しいベースコードにアップグレードするには、次の手順を使用します：

1. タグを開いて 編集 をクリックします。
2. S-Codeバージョン フィールドで、ドロップダウンリストから希望のバージョンを選択します。例えば H.27。
   

   

   
   タグテンプレートが更新される必要があることを示す警告モーダルが表示されます。
3. OK をクリックします。
   

   

4. 詳細構成 までスクロールダウンし、クリックして展開します。
5. テンプレートの編集 を選択します。
6. テキストフィールドに、バックアップとしてテキストファイルにテンプレート全体をコピーして貼り付けます。
7. 現在のテンプレートを選択してゴミ箱アイコンをクリックして削除します。
8. 変更を保存して公開します。
   最新のタグバージョンがロードされます。

高度な構成

s.eventsの構成

Adobeタグテンプレート内で、Tealiumは s.event 文字列を構成するのに役立つ u.addEvent() という関数を提供しています。この方法は s.events の最後に新しい値を追加することで、以前に構成されたすべてのイベントを保持し、必要に応じて別のイベントを追加することができます。この方法を使用するには、構成に sc_events という変数が必要です。

s.events をカスタマイズするための次の手順を使用します：

1. Set Data Values 拡張機能を追加します。
2. Scope を Adobe Analyticsタグに構成します。
3. Set メニューから sc_events を選択します。
4. To メニューから JS Code を選択します。
5. テキストフィールドに次のように入力します： u.addEvent("CUSTOM_EVENT")
   ここで、CUSTOM_EVENT は s.events 文字列に追加したいイベントです。例えば event10 などです。
6. 一度に複数のイベントを追加するには、次のように u.addEvent に配列を渡します：
   u.addEvent(["event1","event2","scView"]);

SiteCatalyst ダイナミック変数

Adobeは、複数のプロパティに現れる値を再利用する「ダイナミック変数」と呼ばれる表記法をサポートしており、トラッキングピクセルのサイズを最小限に抑えるのに役立ちます。

TiQのAdobeタグは、ピクセルリクエストをAdobeに送信する際にこの表記法を自動的に適用します。これは、変数の中で v3:D=c2 のような値が表示されることを意味します。この場合、v3 は eVar3 であり、D=c2 は s.prop2 からの値です。s.prop2 の値を繰り返す代わりに、この短縮表記が prop2 への参照として使用され、Adobeのサーバーが適切に解釈します。その結果、トラッキングピクセルはより小さく、より速くなり、1つのピクセルリクエストに最大量のデータを詰め込むことができます。

SiteCatalyst ダイナミック変数についてもっと学ぶ。