スイッチ設定を使用して、ログレポートを動的にコントロールできます。サーバーはスイッチ値を送信して、自動ログレポートの条件を変更します。
Mobile Analysis Service (MAS) は、クライアント SDK に依存してタグ付けを行います。SDK は、ユーザー行動とアプリのパフォーマンスに関するデータを収集します。このデータからログを生成し、サーバーにレポートします。その後、リアルタイムコンピューティングまたはオフラインコンピューティングによってこれらのログが処理され、メトリックとダッシュボードが生成されます。
mPaaS は、レポートされたタグ付けログから発生するトラフィックに対して課金します。不要なコストを避けるために、スイッチ設定を通じてログレポートを管理できます。ログレポートのトラフィック課金の詳細については、「後払い」をご参照ください。
このトピックでは、タグ付け設定を追加および管理する方法について説明します。
タグ付け設定の追加
mPaaS コンソールにログインします。左側のナビゲーションウィンドウで、[Mobile Analysis Service] > [ログ管理] > [アップロードスイッチの設定] を選択します。左上隅にある [タグ付け設定] をクリックして、ログスイッチのリストページを開きます。
[新規ビジネス] をクリックし、タグ付け情報を設定します。
ビジネスコード：ビジネスコードです。カスタム動作タグの場合、ビジネスコードの設定はプラットフォームによって異なります。
Android: クライアントが
MPLogger.event(String logId, String bizType, Map<String, String> params)メソッドを使用して設定するbizTypeです。bizType にはアンダースコア (_) を含めることはできません。iOS の場合、デフォルト値は
behaviorです。クライアントは、writeLogWithActionIdインターフェイスのbizTypeパラメーターを使用してカスタマイズできます。詳細については、「Android ビジネスコード」または「iOS ビジネスコード」をご参照ください。
ビジネス名：タグ付け操作の説明です。ビジネス名はカスタマイズできます。
ログヘッダー: ログモデルのフィールド 01です。異なるログタイプを区別するために使用されます。カスタム動作タグのログヘッダーは
D-VMです。詳細については、「ログモデル」をご参照ください。
[追加] をクリックして、タグ付け設定を追加します。設定の変更の詳細については、後述の「タグ付け設定の変更」をご参照ください。
タグ付け設定の変更
新しいタグ付け設定がログスイッチリストに表示されます。ログレポートスイッチの設定、ネットワーク設定の構成、タグの変更、および設定の削除ができます。
ログレポートスイッチの設定
ログレポートのオン/オフを切り替えることができます。レポートスイッチがオンの場合、操作のタグ付けログは自動的にレポートされます。
レポートネットワークの設定
タグ付けログを [すべてのネットワーク環境] (2G、3G、4G、Wi-Fi など) でレポートするか、[Wi-Fi] 環境のみでレポートするかを選択できます。
タグ付け情報の変更
[操作] 列で [変更] をクリックして、タグ付け設定の変更ページを開きます。設定にさらに変更を加えることができます：
ビジネスコード：タグ付け設定を追加したときに入力したビジネスコードに対応します。
説明：タグ付け設定を追加したときに入力したビジネス名に対応します。
ログヘッダー：タグ付け設定を追加したときに入力したログヘッダーに対応します。
最小アップロードレベル：各ログには 1、2、または 3 の重要度レベルがあります。レベル 1 が最も重要で、次にレベル 2、レベル 3 と続きます。最小レポートレベルを 2 に設定した場合、レベル 1 と 2 のログはレポートされますが、レベル 3 のログはレポートされません。カスタム動作タグのデフォルトレベルは 2 です。iOS アプリケーションの場合、クライアント側のタグ付け中にログレベルを変更できます。詳細については、「iOS のカスタム動作のタグ付け」をご参照ください。
アップロードされたログ：クライアント側でタグ付けされたログは、まずローカルファイルに書き込まれます。ローカルファイル内のこのビジネスコードタイプのログ数が指定された数に達すると、MAS のサーバー側に自動的にレポートされます。詳細については、「Android の自動ログレポート」または「iOS の自動ログレポート」をご参照ください。
ログアップロード率：ユーザーごとに計算されるログレポート率です。これはパーミル値 (千分率) です。たとえば、値が 1000 の場合、すべてのユーザーのログがレポートされることを意味します。
戦略：[バックグラウンドでアップロード] ポリシーをチェックした場合、レポート時間はプラットフォームによって異なります。
Android：アプリケーションがバックグラウンドに 30 分以上入ると、自動ログレポートがトリガーされます。
iOS：アプリケーションがバックグラウンドに入ると、すぐに自動ログレポートがトリガーされます。詳細については、「Android のログレポート」または「iOS のログレポート」をご参照ください。
ビジネスの初期化
クライアントによってローカルに書き込まれたログは、指定された条件が満たされると、MAS のサーバー側に自動的にレポートされます。デフォルトのタグ付け設定によって、自動レポートのトリガー条件が決まります。新しいアプリケーションを作成した後、[ビジネスの初期化] 機能を使用して、デフォルトのタグ付け設定を新しいアプリケーションのタグ付け設定リストに同期できます。
ビジネス設定を初期化するには、ページ上の [ビジネスの初期化] ボタンをクリックし、操作を確定します。初期化が成功すると、デフォルトのタグ付け設定リストが表示されます。
[ビジネスの初期化] 機能を使用してデフォルトのタグ付け設定を新しいアプリケーションのリストに同期しない場合でも、デフォルトの設定は有効です。ただし、タグ付け設定リストには表示されません。
モック
前述のとおり、コンソールページでタグ付け構成を追加および変更して、ログレポートポリシーを制御できます。また、コンソールでは、JSON を直接使用してタグ付けを構成することも可能です。ただし、以下の理由により、この機能の使用は推奨しません。
モック機能は、タグ付けを設定するための便利な方法にすぎず、追加機能を提供するものではありません。
コンソールページとモック機能の両方を使用して同じビジネスタグを設定した場合、モック設定が優先されます。
タグ付け設定のフォーマットに慣れていない場合、モック機能を正しく使用することが難しい場合があります。誤った使用は、デフォルトの自動ログレポートの動作に影響を与える可能性があります。
モック設定の追加
次の手順に従って、モック設定を追加します：
[アップロードスイッチの設定] ページで、[モック設定の追加] をクリックします。
設定情報を入力します。
バージョン：アプリケーションのバージョンを選択します。
プラットフォーム：アプリケーションのタイプを選択します。
値：JSON フォーマットの設定情報です。詳細については、後述の「モック設定のフォーマット」セクションをご参照ください。
情報が正しいことを確認した後、[OK] をクリックしてモック設定を追加します。
モック設定のフォーマット
モック設定のフォーマットは次のとおりです：
{
"LogHeader1": {
"BusinessCode1": {
"write": "yes",
"send": [
"wifi"
],
"maxLogCount": 50,
"level": 3,
"uploadRate": 1000,
"event": [
"gotoBackground"
]
},
"BusinessCode2": {
...
},
...
},
"LogHeader2": {
...
},
...
}LogHeader：タグ付け設定のログヘッダーに対応します。
BusinessCode：タグ付け設定のビジネスコードに対応します。
write: タグ付け構成のレポートスイッチに対応し、スイッチがオンの場合は値が
"yes"に、それ以外の場合は"no"になります。send: タギング構成のネットワークに対応します。 値は [すべてのネットワーク] の場合は
["2g", "3g", "4g", "wifi"]、Wi-Fi のみの場合は["wifi"]です。maxLogCount：タグ付け設定のログレポート数に対応します。
level：タグ付け設定の最小レポートレベルに対応します。
uploadRate：タグ付け設定のログレポート率に対応します。
イベント: タギング構成のポリシーに対応します。値は、「バックグラウンドでレポート」ポリシーが選択されている場合は
["gotoBackground"]、それ以外の場合は[]です。