共通トラッキングの設定 - Mobile Platform as a Service - Alibaba Cloud ドキュメントセンター

PC およびモバイル HTML5 ページで統一された HTML5 トラッキングソリューションを使用できます。トラッキングを設定することで、統一された HTML5 トラッキングを実現できます。

このタスクについて

さまざまなビジネスシナリオで異なる HTML5 共通トラッキングを設定できます。具体的なビジネスシナリオと対応するトラッキングタイプについては、「共通トラッキングタイプ」をご参照ください。

手順

CDN バージョンの mtracker を直接導入します。 mtracker が導入されると、Tracker オブジェクトがグローバル window に挿入されます。
ダウンロードした mtracker JS ファイルにコードの乱れがある場合でも、トラッキングの設定には影響しないため、JS ファイルは通常どおり使用できます。コードの乱れは、ファイルのエンコード形式とブラウザが解釈するエンコード形式の違いによって発生する可能性があります。

設定を初期化します。状況に応じて、HTML5 トラッキング JS ファイルに対応する情報を挿入します。

mPaaS HTML5 コンテナと統合されたアプリの場合

<script>
window._to = {
  bizScenario: 'alipay',  
  mtrDebug: true,        
};
</script>

パラメーター	説明
bizScenario	チャネルソース。省略可能。デフォルトは空です。
mtrDebug	mtracker のデバッグモードを有効にするかどうか。デバッグモードでは、レポートされたログが出力されます。デフォルトは「false」です。

mPaaS HTML5 コンテナと統合されていないアプリ、またはブラウザ側のアプリの場合

<script>
window._to = {
  server: 'https://cn-hangzhou-mas-log.cloud.alipay.com/loggw/webLog.do', 
  appId: 'xxxxxxxxxx', 
  workspaceId: 'default', 
  h5version: '1.0.0',    
  userId: '1234567890',     
  bizScenario: 'alipay',  
  mtrDebug: true,        
  extendParams: { test: 111 } 
};
</script>

パラメーター	説明
server	トラッキングを受け入れるサービスアドレス。
appId	アプリの一意の識別子。
workspaceId	ワークスペース ID。
h5version	アプリのバージョンまたは HTML5 ページのバージョン。省略可能。
userId	ユーザー ID。省略可能。
bizScenario	チャネルソース。省略可能。デフォルトは空です。
mtrDebug	mtracker のデバッグモードを有効にするかどうか。デバッグモードでは、レポートされたログが出力されます。デフォルトは false です。
extendParams	グローバル拡張パラメーター。 mtracker 1.2.0 以後のバージョンでサポートされています。デフォルトは空です。

mtracker オブジェクトを初期化します。
デフォルトでは、JS ファイルが導入されると、mtracker は自動的に初期化され、window オブジェクトに挿入されます。一部のシナリオで手動による初期化が必要な場合は、以下の手順を実行して初期化を完了する必要があります。
1. JS ファイルが導入される場所の前に次のコードを追加して、自動初期化を禁止します。
```
window.notInitTrackerOnStart = true;
```
2. 初期化コードを追加します。
```
window.initTracker();
```

説明

グローバル拡張パラメーターは、mtracker 1.2.0 以後で変更できます。 mtracker のバージョンが 1.2.0 より前の場合は、最初にアップグレードしてください。

必要に応じて、グローバル拡張パラメーターを変更します。 window._to に extendParams を設定することにより、設定した拡張パラメーターを後続のトラッキングログに追加できます。 click メソッドまたは expo メソッドで設定された ext パラメーターセットに重複する属性が存在する場合は、click メソッドまたは expo メソッドの値が優先されます。

次のコードを呼び出して extendParams を変更できます。新しく設定されたオブジェクトは、以前に設定されたすべての extendParams 値を上書きします。

window.changeTrackerExtendParams({ newValue: 11111 });

次のステップ

モバイル分析サービスコンソールにログインすると、カスタム分析ページで mtracker によってレポートされた HTML5 共通トラッキングログを分析できます。詳細については、「共通トラッキングログの分析」をご参照ください。