Adobe Analytics（SiteCatalyst）タグセットアップガイド（レガシー） | クライアントサイドタグ

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

動作原理

Adobe Analytics（SiteCatalyst）は、AdobeのWeb Analyticsを提供するSoftware as a Service（SaaS）アプリケーションです。

開始する前に

開始する前に、次の項目を考慮してください。

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

必要条件

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

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

s_code.jsについて詳しく見る。
ソリューションデザインリファレンス
- オプションです。
- このドキュメントでは、Adobe Analyticsソリューションでトラッキングされるすべてのプロップ、eVar、およびイベントを定義します。
- この情報は、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をサポートしています。
レポートスイート
- 使用するデフォルトのレポートスイート。
- これはDynamic Acct Listで構成された値に基づいて変更される場合があります。
- s_code.jsを参照：s.account
サーバー
- データ収集サーバー。
- s_code.jsを参照：s.trackingServer
サーバー（セキュア）
- “https"のデータ収集サーバー。
- s_code.jsを参照：s.trackingServerSecure
名前空間
- サーバーとサーバー（セキュア）が2o7.netで終わる場合にのみ適用されます。
- s_code.jsを参照：s.namespace
Enterprise Cloud ID
- バージョンH.27以降でVisitor APIを使用する場合は、ここにEnterprise Cloud IDを入力してください。
- Adobe Enterprise Cloud ID Serviceについて詳しく見る。
自動リンクトラッキング
- 推奨値はデフォルト値のYesです。
- Noに構成する場合、Link Tracking Extensionなどの他の方法を使用して、すべての自動リンクトラッキングを複製する必要があります。
ダウンロードタイプ
- ダウンロードリンクとしてトラッキングするファイル拡張子のタイプをリストします。
- s_code.jsを参照：s.linkDownloadFileTypes
内部リンクフィルター
- リンククリックがAdobeレポートに出口クリックとして報告されないようにするために使用します。
- s_code.js: s.linkInternalFilters
通貨コード
- 3文字の通貨コード（例：米ドルの場合はUSD）。
- s_code.jsを参照：s.currencyCode
Use Dynamic Acct
- ドメインまたは他の動的な値に基づいて異なるレポートスイートにデータを送信するためにYesに構成します。
Dynamic Acct List
- ドメインまたは他の動的な値に基づいてレポートスイートを動的に構成するために使用します。
- 例：testreportsuite=testing.example.com,qa.example.com;prodreportsuite=www.example.com
- SiteCatalystで動的アカウントリストを使用する方法について詳しくはこちら。
S-Object Name
- デフォルトの名前はsです。
- ページ上でレガシーAdobe AnalyticsタグまたはAdobe AppMeasurementタグの複数のインスタンスを実行している場合は、異なる名前を構成します。
Clear Vars
- 各トラッキングコール後にプロップ、eVar、およびイベントをクリアします。
- デフォルト値はNoです。
パートナー
- Adobe Audience Managerで使用するパートナーIDを入力します。入力しない場合は空白のままにしてください。
- s_code.js: DIL.create()

ロードルール

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

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

データマッピング

マッピングは、データレイヤ変数からベンダータグの対応する宛先変数にデータを送信するプロセスです。変数をタグの宛先にマッピングする方法についての手順は、[データマッピング]（/iq-tag-management/data-mappings/manage/）を参照してください。

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

[データマッピング]タブをクリックし、+ 宛先を選択をクリックします。マッピングツールボックスが表示されます。
テキストボックスに別のpropまたはeVarを入力して、+ カスタム宛先を追加をクリックすることで、追加のマッピングを迅速に追加できます。

同じ変数の複数のpropとeVarは、カンマ（,）で区切られるべきです。eVarの期待される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`	商品イベント

プロップ

prop1 から prop75

eVar

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

マーチャンダイジングeVar

変数	説明
`PRODUCTS_eVar1` から `eVar75`	商品eVar

コマース

変数	説明
`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;;

イベントのマッピング

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

変数が選択され、左側のサイドバーでEventsをクリックすると、2つのフィールドが表示されます：ValueとTrigger。

Valueボックスは、変数の値を定義する場所です。
Triggerボックスは、トラッキングするAdobeイベントを選択する場所です。

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

Data Mapping_Events_Value and Trigger.jpg

マーチャンダイジングeVar

Adobeの実装では、マーチャンダイジングeVarマッピングを使用して、s.products文字列に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**"

商品レベルのイベント

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

例：

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**;"

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

マーチャンダイジングeVarおよび商品レベルのイベントの配列マッピングは、バージョンH.26以降で使用できます。

doPluginsの必要な拡張機能

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

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

Do Plugins

Do Pluginsセクションは、常にs_code.jsのPlugins and Modulesセクションの上にあります。このセクションは通常、次の行で始まります。

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

これらの行からs.doPlugins=s_doPlugins;の行までのコードブロックを、Adobe Analyticsタグにスコープを構成したJavaScript Code拡張機能にコピーし、拡張機能の名前をDo Plugins Sectionとします。

プラグインとモジュール

s_codeのプラグインとモジュールセクションは、次の行で始まります。

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

および次の行の直前で終了します。

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

このコードセクション全体をコピーし、Adobe Analyticsタグにスコープを構成した2番目のJavaScript Code拡張機能に貼り付けます。この拡張機能の名前をPlugins and Modulesとします。

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

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

から始まるコードセクションは、Adobeのs_codeライブラリであり、TiQのタグテンプレート内でロードされます。

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

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

タグを開き、編集をクリックします。
S-Codeバージョンフィールドで、ドロップダウンリストから必要なバージョン（たとえばH.27）を選択します。

タグテンプレートを更新する必要があることを示す警告モーダルが表示されます。
OKをクリックします。
スクロールして詳細構成を展開し、テンプレートを編集を選択します。
テキストフィールドに、バックアップとしてテンプレート全体をテキストファイルにコピーして保存します。
現在のテンプレートを選択し、ゴミ箱アイコンをクリックして削除します。
変更内容を保存して公開します。最新のタグバージョンがロードされます。

高度な構成

s.eventsの構成

Adobeタグテンプレートでは、u.addEvent()という関数を使用してs.event文字列を構成するための支援を提供しています。このメソッドは、新しいイベントを追加するだけで、以前に構成されたすべてのイベントを保持し、必要に応じて別のイベントを追加できるようにします。このメソッドを使用するには、構成にsc_eventsという変数が必要です。

u.addEventを使用してs.eventsをカスタマイズする手順は次のとおりです。

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

SiteCatalystダイナミック変数

Adobeは、トラッキングピクセルのサイズを最小限に抑えるために、複数のプロパティに表示される値を再利用する動的変数という表記法をサポートしています。

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

SiteCatalyst Dynamic Variablesについて詳しく見る。