Adobe Analytics AppMeasurement for JSタグ構成ガイド

タグのヒント

• Adobe Experience Cloud IDサービスを使用するには、このタグを追加する前にAdobe Experience Cloud IDサービスタグを追加してください。
• AppMeasurementタグでは、すべてのレガシーH26機能がサポートされているわけではありません。
• サーバーの値を正しく入力してください。例えば、サードパーティのサーバーでは112.2o7.netや122.2o7.netがあるかもしれません。
• モバイル用のAppMeasurementを使用するには、Tealium Mobile SDKをアプリケーションに実装する必要があります。
• サポートされているプラグインのリストについては、次を参照してください：Adobe: AppMeasurementプラグインの概要。
• 追加情報については、次を参照してください：Adobe: JavaScript用AppMeasurementを使用したAdobe Analyticsの実装

タグの構成

タグマーケットプレイスに移動し、Adobe Analytics AppMeasurement for JSタグを追加します（タグの追加方法について詳しくはこちら）。

タグを追加したら、以下の構成を行います：

• コードバージョン
  • AppMeasurement.jsライブラリのバージョン。
• デバイスタイプ
  • 実装のプラットフォームに基づいて以下のいずれかを選択します：
    • Standard デスクトップウェブサイトのインストール用。
    • Mobile App ネイティブモバイルのインストール用。Tealium for iOSまたはTealium for Androidを使用。
• レポートスイート
  • 必須。
  • レポートスイートを動的に構成するためのマッピングを使用しても、デフォルト値を構成します。
  • 使用するデフォルトのレポートスイート。動的アカウントリストで構成された値に基づいて変更される場合があります。
  • AppMeasurement.jsの参照：s.account
• サーバー
  • 必須。
  • データ収集サーバー。
  • AppMeasurement.jsの参照：s.trackingServer
  • 例：metrics.tealium.comまたはtealiumclient.122.2o7.net
• サーバーセキュア
  • 必須。
  • httpsデータ収集サーバー。
  • AppMeasurement.jsの参照：s.trackingServerSecure
  • 例：smetrics.tealium.comまたはtealiumclient.122.2o7.net
• 自動イベントシリアライゼーション検出
  • トリガー文字列内のイベントシリアライゼーションを自動的に検出します。
  • イベントトリガー値にコロン文字（:）が含まれている場合は、Noに構成する必要があります。
• 自動リンクトラッキング
  • デフォルト値はYesで、推奨される選択です。
  • Noに構成した場合は、リンクトラッキング拡張などの他の方法を使用して自動リンクトラッキングを再現する必要があります。
• 内部リンクフィルター
  • 内部として分類されたドメインのカンマ区切りリストで、リンククリックがAdobeレポートに対して退出クリックとして報告されないようにするために使用されます。
  • AppMeasurement.jsの参照：s.linkInternalFilters
  • 例：tealium.com,tealiumiq.com
• clearVarsの実行
  • デフォルト値はNoです。
  • トラッキングリクエストごとにグローバルS-Object内のprops、eVars、およびイベントをクリアします。
  • Data Mapping画面で、clearVars_in_RPTCallbackパラメータを使用して、clearVarsアクションをregisterPostTrackコールバック内で発生するように割り当てます。
• S-Object名
  • 必須。
  • デフォルト名はsです。
  • ページ上でAdobe AnalyticsまたはAppMeasurementの複数のインスタンスを実行している場合は、別の名前を構成します。
• ネームスペース
  • 任意。
  • 訪問のネームスペース。
  • サーバーとサーバーセキュアが2o7.netで終わる場合にのみ、サードパーティのクッキーに適用されます。
  • AppMeasurement.jsの参照：s.visitorNamespace
• Experience Cloud ID
  • 任意。
  • あなたのAdobe Experience Cloud ID。
  • バージョン1.3.x以降でサポートされているVisitor APIを使用している場合は、ここにエンタープライズクラウドIDを入力します。
  • 詳細については、Adobe: Enterprise Cloud ID Serviceを参照してください。
• Advertising Cloud Viewthroughの実行
  • バージョン2.17以降でのみ利用可能です。
  • Advertising Cloud Viewthroughファイルをロードし、viewthroughデータを送信します。
• Viewthrough間隔
  • viewthroughスクリプトをロードする試みの間隔をミリ秒単位で構成します。
• Viewthrough最大試行回数
  • viewthroughのロードを試みる最大回数を構成します。これを超えると、アナリティクスのみが実行されます。
• タイムスタンプの送信
  • トラッキングコールごとにタイムスタンプを送信することを許可します。モバイルデバイスのトラッキングのみに適用されます。
• リンクパラメータのデコード
  • リンクトラッキング変数を一度エンコードするにはfalseに構成します。
  • リンクトラッキング変数を二度エンコードするにはtrueに構成します。
  • デフォルト値はfalseです。
  • 詳細については、Adobe: decodeLinkParametersを参照してください。

ロードルール

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

推奨されるロードルール：すべてのページ。

データマッピング

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

利用可能なカテゴリーは以下の通りです：

スタンダード

イベント

イベントのマッピングは、他の宛先のマッピングとは異なります。

イベントをマッピングするには、以下の手順を使用します：

1. データマッピングの下で、変数ドロップダウンリストからイベント変数を選択します。
2. 宛先を選択をクリックし、イベントトリガーカテゴリに移動します。
3. 値フィールドに、マッピングされる変数の値を入力します。
   この変数がトリガー文字列になります。
4. トリガードロップダウンリストから、トリガーしたいイベントを選択します。
   プラスアイコン（+）をクリックして、追加の値/トリガーの組み合わせを追加することができます。

商品レベルのイベント

SiteCatalystは、商品特有のアクションを送信するための100の宛先を提供します。

値イベント

SiteCatalystは、値イベントを送信するための100の宛先を提供します。

Props

SiteCatalystでは、カスタムprops（トラフィック変数とも呼ばれる）を使用できます。

SiteCatalystでは、75のカスタムprops（トラフィック変数とも呼ばれる）を使用できます。Propsには、ページビューを超えて持続することを意図していないデータが含まれています。別の変数とpropを相関させたい場合は、両方の変数が同じページで構成されるようにします。製品文字列に渡されるときやシリアライズされるときに特定の数値を保持するためにイベントを使用します。

カスタム宛先をマッピングするには、次の手順を使用します：

1. 任意のprop宛先に変数をマッピングします。
2. 上部のテキストボックスに、選択した組み込み宛先の代わりにカスタム宛先を入力します。
3. 他の変数のマッピングを続けるか、完了をクリックして終了します。

eVars

マーチャンダイジングeVars

マーチャンダイジングeVarsを使用すると、商品文字列で指定するカテゴリに加えて、商品に何らかの値を関連付けることができます。

コマース

AppMeasurementタグはeコマース対応しているため、デフォルトのE-Commerce Extensionマッピングを自動的に使用します。このカテゴリで手動でマッピングする必要は通常ありませんが、拡張マッピングを上書きしたい場合や、希望するeコマース変数が拡張機能に含まれていない場合は必要です。

E-Commerce拡張機能によって、Product Stringを含むいくつかのSiteCatalyst変数が自動的に入力されます。SiteCatalystはProduct Stringを使用して、商品情報、収益、販売単位、購入に関するその他の情報をキャプチャします。標準的なProduct stringは次のようになります：

商品文字列のベストプラクティス：

• セミコロン ; は、Products stringのほとんどのアイテムの標準的なセパレータです。
• 複数のマーチャンダイジングeVarsをパイプ (|) 文字で区切ります。
• 複数の商品インスタンスをコンマ (,) で区切ります。
• 合計価格は、単価に数量を掛けたものです。E-Commerce extensionの合計価格 (_ctotal) 出力は、自動的にProducts stringにマッピングされません。
• SiteCatalystのベストプラクティスは、商品のカテゴリをSiteCatalystで構成した後に変更できないため、カテゴリを空白にすることです。ただし、Tealiumでは、後でカテゴリを変更することが問題でない場合、コンバージョン時にカテゴリを構成することができます。

E-Commerce宛先

以下のe-commerce宛先はツールボックスに組み込まれています：

その他

モバイル

リンクトラッキング

イベントシリアライゼーション検出

AppMeasurementタグは、データレイヤーのトリガー値内のイベントシリアライゼーションを自動的に検出します。タグが発火するとき、タグはイベントタブでマッピングされたトリガー文字列とデータレイヤー内のトリガー値を比較し、どちらかのトリガーにコロンが含まれているかどうかを確認します。

• イベントシリアライゼーション検出：オン
  イベントシリアライゼーション検出がオンになっている場合（デフォルト構成）、タグはコロンの隣のトリガー値を検出し、残りの文字列をマッピングされたトリガーと一致させようとします。完全に一致する場合、イベントはシリアライズされます。
• イベントシリアライゼーション検出：オフ
  イベントシリアライゼーション検出がオフになっている場合、タグはコロンを検出しません。タグは、両方のトリガー値を全体として一致させようとします。この構成は、マッピングされたトリガー文字列にコロンが含まれている場合に強く推奨されます。イベントシリアライゼーション検出をオフにすることで、コロンを含む値でイベントが正しくトリガーされる唯一の方法です。

イベントシリアライゼーション検出がオンでもオフでも、イベントシリアライゼーションタブを介して直接マッピングされたシリアルは常に優先されます（シナリオ3の例を参照）。

以下のシナリオは、イベントシリアライゼーション検出がコロンを含むトリガー値をどのように解釈するかを理解するのに役立ちます。

このセクション全体で、「マッピングされたトリガー」はタグのデータマッピング構成の値を、「データレイヤートリガー」はウェブサイトのデータレイヤーに見つかる値を指します。

例：コロンを含まないマッピングされたトリガー

例えば、ページにfireEvtが含まれているときにprodViewイベントをトリガーし、それをシリアライズする場合、次のようにします：

1. UDO変数serialをイベントシリアライゼーションタブのSERIAL_prodViewにマッピングします。
2. UDO変数triggerをイベントのprodViewにマッピングします。
3. fireEvtをprodViewのトリガー文字列としてマッピングします。
   

   

データレイヤーで発生する可能性のあるシナリオは多数あります。

シナリオ1：データレイヤートリガーがfireEvtで、serial値が空

var utag_data = {
  trigger: "fireEvt",
  serial: ""
}

• イベントシリアライゼーション検出：オン
  タグはfireEvtをマッピングされたトリガーと一致させ、ページ上でprodViewを成功させますが、シリアライゼーションはありません。
• イベントシリアライゼーション検出：オフ
  上記と同じ結果です。

成功したネットワークコールは次のようになります：

シナリオ2：データレイヤートリガーがfireEvt:123で、serial値が空

var utag_data = {
  trigger: "fireEvt:123",
  serial: ""
}

• イベントシリアライゼーション検出：オン
  タグは123をシリアライズし、fireEvtをマッピングされたトリガーと一致させ、ページ上でprodViewを成功させます。
  

  

• イベントシリアライゼーション検出：オフ
  タグはfireEvt:123をマッピングされたトリガーと一致させることができず、その結果、prodViewはページ上で発火しません。

シナリオ3：データレイヤートリガーがfireEvt:123で、シリアル値が456

var utag_data = {
  trigger: "fireEvt:123",
  serial: "456"
}

• イベントシリアライゼーション検出：オン
  最初に、タグは123をシリアライズし、fireEvtをマッピングされたトリガーと一致させます。その後、prodViewが成功して発火し、123ではなく456でシリアライズされます。
  これは、イベントシリアライゼーションマッピングによって検出されたシリアル値（456）が、イベントシリアライゼーション検出によって検出されたもの（123）よりも優先されるためです。
  

  

• イベントシリアライゼーション検出：オフ
  タグはfireEvt:123をマッピングされたトリガーと一致させることができず、その結果、prodViewはページ上で発火しません。

例：コロンを含むマッピングされたトリガー

この例はシナリオ2と同じ経路をたどりますが、マッピングされたトリガーはfireEvtではなくfireEvt:123です。

シナリオ：データレイヤートリガーがfireEvt:123

var utag_data = {
  trigger: "fireEvt:123",
  serial: ""
}

• イベントシリアライゼーション検出：オン
  タグは123をシリアライズしますが、fireEvtをマッピングされたトリガーと一致させることができず、その結果、prodViewはページ上で発火しません。
• イベントシリアライゼーション検出：オフ
  タグはfireEvt:123をマッピングされたトリガーと一致させ、prodViewが成功して発火します。このため、文字列にコロンが含まれている場合は、イベントシリアライゼーション検出をオフにすることを推奨します。

高度な構成

s.eventsの構成

Tealiumは、s.event文字列を構成するための関数u.addEvent()を提供しています。このメソッドは、新しい値をs.eventsの末尾に追加するため、すべての以前に構成されたイベントを保持したまま、必要に応じて別のイベントを追加することができます。このメソッドを使用するには、構成にsc_eventsという名前の変数を追加します。

s.eventsをu.addEventを使用してカスタマイズするには、次の手順を使用します：

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"]);

関数に渡される文字列(s)内に直接値を追加するには：u.addEvent(['event500=500', 'event501=' + b.demo_event_value]);

関数に渡される文字列(s)内に直接シリアライゼーションを追加するには：u.addEvent("event78:" + b.booking_reference);

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

以下のAppMeasurement for JavaScriptのコードバージョンがサポートされています：

• 2.26.0 バンドル最適化版
• 2.26.0
• 2.25.0
• 2.24.0
• 2.23.0
• 2.22.4
• 2.22.3
• 2.22.0
• 2.21.0
• 2.20.0
• 2.18.0
• 2.17.0
• 2.15.0
• 2.14.0
• 2.12.0
• 2.9.0
• 2.8.2
• 2.7.0
• 2.6.0
• 2.4.0
• 2.3.0
• 2.1.0
• 1.8.0
• 1.6.3
• 1.6.1
• 1.6.0
• 1.5.3
• 1.5.2
• 1.5.1
• 1.4.1
• 1.3.2
• 1.2.2
• 1.2.1
• 1.0.1

リリースノート

v2.23.0 リリース日 9月23日

• 高エントロピーユーザーエージェント情報のサポートを追加しました。

v2.22.3 リリース日 2021年12月21日

v2.20.0 リリース日 2020年3月5日

• IE検出を更新し、JSLint警告を抑制してセキュリティ関連の問題を修正しました。

v2.18.0 リリース日：2020年2月13日

• AppMeasurementは、writeSecureCookies変数を構成することで、クッキーにSecure属性を強制的に含めることができるようになりました。この変数をサポートするためには、クライアントのウェブサイト全体がHTTPSを使用して安全に提供されている必要があります。

v2.17.0 リリース日：2019年8月23日

• Baiduクエリ文字列の並べ替えに対応しました。
• オプトイン待ちでキューに入れられたヒットで古い訪問値が発生する問題を修正しました。

v2.15.0 リリース日：2019年7月15日

• Activity Map拡張機能にActivityMapスクロールリーチトラッキングを追加しました（AN-172949）

• DIL 9.2をAppMeasurementに追加しました（AN-182472）

v2.9.0 リリース日：2018年5月24日

Experience Cloud ID Serviceを使用する顧客には、Visitor API 3.0以上が必要です。Adobeは、at.js、AppMeasurement.jsなどの関連コードライブラリが更新されたときに、最新のVisitor APIバージョンにアップグレードすることを推奨します。

• AppMeasurementを更新して、IDのリクエストに更新されたVisitorインターフェースを使用するようにしました。（AN-151483）
• リンクトラッキングがオフになった後にリンクトラッキングクッキーが書き込まれる問題を修正しました。（AN-156332）
• registerPreTrackCallbackとregisterPostTrackCallbackが複数回呼び出されるとコールバック関数のシグネチャが壊れる問題を修正しました。（AN-158566）

v2.8.2 リリース日：2018年4月12日

• AppMeasurementを更新して、IDのリクエストに更新されたvisitorインターフェースを使用するようにしました。
• リンクトラッキングクッキーの問題を修正しました。
• AppMeasurementのデフォルトのクッキー寿命を5年から2年に短縮しました。
• Visitor API（別名 Enterprise Cloud ID Service）バージョン3.1.2をサポートします。

v2.7.0 リリース日：2018年1月18日

• Internet Explorer（IE）バージョン6から9のサポートを非推奨としました。
• DIL v7.00を含みます。
• Visitor API（別名 Marketing Cloud ID Service）バージョン3.0をサポートします。

v2.6.0 リリース日：2017年11月9日

• s_glが呼び出されたときにAppMeasurementライブラリが常に正しいアカウントの組み合わせを構成しない問題を修正しました。（AN-152153）
• dil.js 6.12（Audience Managerモジュール）を含みます。
• Visitor API 2.5.0をサポートします。

v2.3.0 リリース日：2017年8月22日

• s.Util.getQueryParamが#をキャプチャするバグを修正しました。
• 最新バージョンのdil.js（v6.10）を含みます。
• 複数のAppMeasurementインスタンス化順序をサポートします。
• Visitor API（別名 Marketing Cloud ID Service）バージョン2.2.0をサポートします。

v2.1.0 リリース日：2017年5月11日

• AppMeasurement JavaScript 2.1.0をサポートします。
• Marketing Cloud ID Serviceバージョン2.1.0をサポートします。
• 最新バージョンのdil.jsを含みます。
• ページリファラーを上書きするadobe_mc_refパラメータのサポートを追加しました。
• mcorgidパラメータを追加しました。
• cp（customerPerspective）パラメータを追加しました。

v1.8.0 リリース日：2017年3月10日

• AppMeasurement JavaScript 1.8.0をサポートします。
• Marketing Cloud ID Serviceバージョン2.0.0をサポートします。
• 2つのコールフックを追加しました：s.registerPreTrackCallbackとs.registerPostTrackCallback。

v1.6.3 リリース日：2016年8月23日

• AppMeasurementがリクエスト接続を早期に終了する問題を修正しました。
• AppMeasurementがVisitor APIの間違った難読化メソッドを呼び出す問題を修正しました。
• JavaScriptエラー：“Attribute only valid on v:image"を引き起こす問題を修正しました。
• Marketing Cloud IDサポート（別名 Visitor API）を新しいタグ、Marketing Cloud ID Service Tagに分離しました。

Marketing Cloud ID Service Tagは、プロファイル内のすべての他のAdobeタグ（AppMeasurementを含む）よりも先にロードする必要があります。それがないと、訪問のトラッキングの整合性が失われます。タグを最初にロードするには、バンドル構成をすべてのページで有効にし、他のAdobeタグよりも先にロードします。

完全なAdobe AppMeasurementリリースノートを見る。

v1.6.1 リリース日：2016年7月28日

以下の更新は、AppMeasurementのイベント、値イベント、およびイベントシリアライゼーションに影響します：

• データマッピングツールボックスに新しいイベントシリアライゼーションマッピングタブを追加しました。
• AppMeasurementタグ構成に、イベントシリアライゼーションのON/OFFを切り替える新しいドロップダウンリストを追加しました。

v1.6.1 リリース日：2016年7月14日

• 新しいバージョン1.6.1を追加しました。
• Visitor APIバージョン1.5.7と1.5.6をサポートします。
• Firefoxでのリンククリックトラッキングの処理方法を改善しました。

完全なAdobe AppMeasurementリリースノートを見る。

ベンダー文書

• Adobe Experience League：JavaScript用AppMeasurementについて
• Adobe Experience League：AppMeasurementリリース履歴
• Adobe Experience League：アクティビティマップの有効化
• Adobe Experience League：モバイルメトリクスの理解
• Adobe Experience League：モバイルメトリクスリファレンス