アップロードスイッチの設定 - Mobile Platform as a Service - Alibaba Cloud ドキュメントセンター

スイッチ設定機能を使用すると、サーバーから配信されるスイッチ値に基づいてログの自動アップロードのトリガー条件を変更し、ログのアップロードを動的に制御できます。

モバイル分析サービス（MAS）は、クライアント SDK に基づいてトラッキングを実装し、ユーザーの行動、アプリのパフォーマンスデータ、およびその他の関連データを収集してログを生成し、サーバーに報告します。次に、mPaaS は、リアルタイムまたはオフラインコンピューティングに基づいてさまざまなメトリックレポートとダッシュボードを生成し、参照用に提供します。

mPaaS は、トラッキングログのアップロードに使用されたトラフィックを課金します。不要なコストを回避するために、スイッチ設定機能を使用してログのアップロードを管理できます。ログアップロードのトラフィック料金の詳細については、「従量課金制モード」をご参照ください。

トラッキング設定の追加

mPaaS コンソールで、モバイル分析サービスログ管理アップロードスイッチを構成する追跡構成 > > ページに移動し、左上隅のをクリックして、ログスイッチリストページに移動します。
新規ビジネス をクリックし、トラッキング情報を設定します。
- ビジネスコード: ビジネスコードを入力します。カスタム動作トラッキングの場合、ビジネスコードは次のとおりです:
  - Android: クライアントで demoBehavior.setBehaviourPro("Pay") を呼び出すことによって設定された behaviourPro に対応します。
  - iOS: デフォルトは behavior です。writeLogWithActionId API の bizType パラメーターを使用して、クライアントのカスタム値を設定できます。詳細については、「Android ビジネスコード」または「iOS ビジネスコード」をご参照ください。
- ビジネス名: トラッキングビジネスの説明を入力します。値はカスタマイズ可能です。
- ログヘッダー: ログモデルの フィールド 01 の値を入力します。このパラメーターは、さまざまなログタイプを区別するために使用されます。たとえば、カスタム動作ログのログヘッダーは、D-VM です。詳細については、「ログトラッキング」をご参照ください。
[追加] をクリックします。トラッキング構成が追加されます。詳細な構成を指定するには、「トラッキング設定の変更」をご参照ください。

トラッキング設定の変更

新しいトラッキング設定は、ログスイッチリストページに表示されます。ログアップロードスイッチとネットワークを設定し、トラッキング設定を変更および削除できます。

ログアップロードスイッチの設定

ログのアップロードを有効または無効にします。ログアップロードスイッチがオンになると、ビジネスのトラッキングログが自動的にアップロードされます。

アップロードネットワークの設定

トラッキングログがアップロードされるネットワーク環境を設定します。ネットワークは、[すべてのネットワーク]（2G、3G、4G、Wi-Fiなど）または[Wi-Fi]のみに設定できます。

トラッキング設定の変更

トラッキング構成を変更するには、[操作] 列の [変更] をクリックします。トラッキングポイントの次の構成を変更できます。

ビジネスコード: トラッキングの追加時に設定したビジネスコードに対応します。
説明: トラッキングの追加時に設定したビジネス名に対応します。
ログヘッダー: トラッキングの追加時に設定したログヘッダーに対応します。
最小アップロードレベル: ログはレベル 1、2、および 3 に分類され、重要度の降順でソートされます。たとえば、このパラメーターが 2 に設定されている場合、レベル 1 と 2 のログはアップロードされますが、レベル 3 のログはアップロードされません。カスタム動作イベントトラッキングの場合、デフォルト値は 2 です。iOS アプリの場合、クライアントのイベントを構成するときにログレベルを設定できます。詳細については、「iOS カスタム動作イベントログ」をご参照ください。
アップロードされたログ: クライアントのトラッキングログは、最初にローカルファイルに書き込まれます。指定されたビジネスコードを持つローカルログの数が、このパラメーターで定義されたしきい値に達すると、ログは自動的に MAS にアップロードされます。詳細については、「Android の自動ログアップロード」または「iOS の自動ログアップロード」をご参照ください。
ログアップロード率: ログをアップロードするユーザーの割合をパーミルで指定します。たとえば、値 1000 はすべてのユーザーのログがアップロードされることを示します。
戦略: [バックグラウンドでアップロード] 戦略が選択されている場合:
- Android: アプリが 30 分以上バックグラウンドで実行された後、ログは自動的にアップロードされます。
- iOS: アプリがバックグラウンドに切り替わると、ログは自動的にアップロードされます。詳細については、「Android のログアップロード」または「iOS のログアップロード」をご参照ください。

ビジネスの初期化

クライアントによってローカルファイルに書き込まれたログは、特定の条件が満たされると、MAS サーバーに自動的にアップロードされます。このような条件は、デフォルトのトラッキング設定によって異なります。アプリを作成した後、ビジネスを初期化する 機能を使用して、デフォルトのトラッキング設定をアプリに同期できます。手順は次のとおりです。

[ビジネスの初期化] をクリックします。ポップアップ確認 ビジネスを初期化するOK で、をクリックします。
初期化が正常に完了すると、デフォルトのトラッキング設定リストが表示されます。

説明

ビジネスを初期化する をクリックして同期しなくても、デフォルトのトラッキング設定はアプリに適用されます。唯一の違いは、トラッキング設定リストに表示されないことです。

モック

ページでのトラッキング構成の追加と変更に加えて、JSON を使用してトラッキングを追加および構成できます。ただし、次の理由により、この機能を使用することはお勧めしません。

モック機能はトラッキング設定を容易にするだけで、他の機能は提供しません。
ページ操作とモック機能の両方で同じビジネスのトラッキングを設定する場合、モック設定が優先されます。
トラッキング設定形式に慣れていない場合、モック機能を誤って使用することがあります。その結果、デフォルトの自動ログアップロード機能が影響を受ける可能性があります。

モック構成を追加する

モック設定を追加するには、次の手順を実行します。

[アップロードスイッチの構成] タブで、[モック構成の追加] をクリックします。
設定情報を入力します。
- バージョン: アプリのバージョンを入力します。
- プラットフォーム: アプリプラットフォームを選択します。
- 値: JSON 形式で構成を入力します。詳細については、「モック構成フォーマット」をご参照ください。
すべての情報が正しいことを確認したら、[OK] をクリックしてモック構成を追加します。

モック構成フォーマット

モック設定形式は次のとおりです。

{
  "ログヘッダー 1": {
    "ビジネスコード 1": {
      "write": "yes",
      "send": [
        "wifi"
      ],
      "maxLogCount": 50,
      "level": 3,
      "uploadRate": 1000,
      "event": [
        "gotoBackground"
      ]
    },
    "ビジネスコード 2": {
        ...
    },
    ...
  },
  "ログヘッダー 2": {
    ...
  },
  ...
}

ログヘッダー: トラッキング設定のログヘッダーに対応します。
ビジネスコード: トラッキング設定のビジネスコードに対応します。
write: トラッキング設定のアップロードスイッチに対応します。スイッチをオンにするには、このパラメーターを "yes" に設定します。それ以外の場合は、このパラメーターを "no" に設定します。
send: トラッキング設定のネットワークに対応します。すべてのネットワークでログをアップロードするには、このパラメーターを ["2g", "3g", "4g", "wifi"] に設定します。Wi-Fi でのみログをアップロードするには、このパラメーターを ["wifi"] に設定します。
maxLogCount: トラッキング設定のアップロードされたログに対応します。
level: トラッキング設定の最小アップロードレベルに対応します。
uploadRate: トラッキング設定のログアップロード率に対応します。
event: トラッキング設定の戦略に対応します。「バックグラウンドでアップロード」戦略を使用するには、このパラメーターを ["gotoBackground"] として設定します。それ以外の場合は、このパラメーターを [] に設定します。