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

タグのヒント

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

タグの構成

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

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

• コードバージョン
  • AppMeasurement.js ライブラリのバージョン。
• デバイスタイプ
  • 実装のプラットフォームに基づいて以下から選択してください：
    • 標準 デスクトップウェブサイトのインストール用。
    • モバイルアプリ Tealium for iOS や Tealium for Android でのネイティブモバイルインストール用。
• レポートスイート
  • (必須) マッピングを使用して動的にレポートスイートを構成する場合でも、デフォルト値を構成してください。
  • 使用するデフォルトのレポートスイート。Dynamic Acct Listで構成された値に基づいて変更される場合があります。
  • 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
• 自動イベントシリアライゼーション検出
  • トリガー文字列内のイベントシリアライゼーションを自動的に検出します。
  • イベントトリガー値にコロン文字(:)が含まれている場合は、いいえに構成する必要があります。
• 自動リンクトラッキング
  • デフォルト値ははいで、推奨される選択です。
  • いいえに構成する場合は、リンクトラッキング拡張などの他の方法を使用して自動リンクトラッキングを再現する必要があります。
• 内部リンクフィルター
  • ドメインをカンマ区切りでリストアップし、内部として分類されることで、リンククリックがAdobeレポートの退出クリックとして報告されないようにします。
  • AppMeasurement.jsの参照：s.linkInternalFilters
  • 例：tealium.com,tealiumiq.com
• Run clearVars
  • デフォルト値はいいえです。
  • 各トラッキングリクエスト後にグローバルS-Objectに構成されたprops、eVars、およびイベントをクリアします。
  • データマッピング画面で、registerPostTrackコールバック内でclearVarsアクションが発生するようにclearVars_in_RPTCallbackパラメータを割り当てます。
• S-Object名
  • (必須) デフォルト名はsです。
  • ページ上でAdobe AnalyticsまたはAppMeasurementの複数のインスタンスを実行している場合は、異なる名前を構成してください。
• 名前空間
  • (オプション) 訪問の名前空間。
  • サーバーとサーバーセキュアが2o7.netで終わる場合にのみ、サードパーティのクッキーに適用されます。
  • AppMeasurement.jsの参照：s.visitorNamespace
• Experience Cloud ID
  • (オプション) あなたのAdobe Experience Cloud ID。
  • バージョン1.3.x以降でサポートされているVisitor APIを使用する場合は、ここにEnterprise Cloud IDを入力してください。
  • 詳細については、Adobe: Enterprise Cloud IDサービスを参照してください。
• Run Advertising Cloud Viewthrough
  • バージョン2.17以降でのみ利用可能です。
  • Advertising Cloud Viewthroughファイルをロードし、viewthroughデータを送信します。
• Viewthrough Interval
  • viewthroughスクリプトをロードする試みの間隔をミリ秒単位で構成します。
• Viewthrough Max Tries
  • viewthroughをロードする最大試行回数を構成します。それを超えると、アナリティクスのみを実行します。
• Send Timestamp
  • トラッキングコールごとにタイムスタンプを送信することを許可します。モバイルデバイスのトラッキングにのみ適用されます。
• Decode Link Parameters
  • リンクトラッキング変数を一度エンコードするには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コマース変数を使用したい場合を除き、このカテゴリでの手動マッピングは通常必要ありません。

いくつかのSiteCatalyst変数、製品文字列を含む、はE-Commerce拡張によって自動的に入力されます。SiteCatalystは製品情報、収益、販売単位、および購入に関連するその他の情報をキャプチャするために製品文字列を使用します。標準的な製品文字列は次のようになります：

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

• セミコロン ; は製品文字列のほとんどの項目の標準セパレータです。
• 複数のマーチャンダイジングeVarsをパイプ (|) 文字で区切ります。
• 複数の製品インスタンスをコンマ (,) で区切ります。
• 合計価格は単価に数量を掛けたものです。E-Commerce拡張の合計価格 (_ctotal) 出力は自動的に製品文字列にマッピングされません。
• SiteCatalystのベストプラクティスでは、カテゴリを空にしておくことが推奨されます。なぜなら、一度SiteCatalystで構成された製品のカテゴリは変更できないからです。ただし、後でカテゴリを変更することが問題ない場合は、変換時にカテゴリを構成することができます。

E-Commerceデスティネーション

ツールボックスに組み込まれている以下のeコマースデスティネーション：

その他

モバイル

リンクトラッキング

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

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

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

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

このセクションでは、コロンの有無に関わらず、イベントシリアライゼーション検出がトリガー値をどのように解釈するかを理解するためのシナリオを説明します。

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

例：コロンなしのマップされたトリガー

例えば、ページにfireEvtが含まれている場合にprodViewイベントをトリガーしてシリアライズする場合、以下の手順を実行します：

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

   

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

シナリオ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でシリアライズされます。
  これは、イベントシリアライゼーション検出によって検出されたシリアル値(123)よりも、イベントシリアライゼーションマッピングによって検出されたシリアル値(456)が優先されるためです。
  

  

• イベントシリアライゼーション検出：オフ
  タグは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. データ値の構成拡張機能を追加します。
2. スコープを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"]);

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

関数に渡される文字列内で直接シリアライゼーションを追加するには：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 リリース日 2019年9月23日

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

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

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

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

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

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

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

• Baiduクエリ文字列の並び替えをサポート。
• オプトインを待っている間にキューに入れられたヒットで訪問の値が古くなる問題を修正。

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

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

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

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

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

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

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

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

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

• Internet Explorer（IE）のバージョン6から9までのサポートを非推奨に。
• DIL v7.00を含む
• Visitor API（別名Marketing Cloud IDサービス）、バージョン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サービス）バージョン2.2.0をサポート。

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

• AppMeasurement JavaScript 2.1.0をサポート
• Marketing Cloud IDサービスバージョン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サービスバージョン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を含む）よりも先にプロファイルで読み込む必要があります。そうしないと、訪問トラッキングの整合性が失われます。タグを最初にロードするには、bundle settingをAll Pagesで有効にし、他の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: モバイルメトリックスリファレンス