Androidアンインストールトラッキングのセットアップ

AndroidのアンインストールトラッキングはFirebase Cloud Messagingサービスを利用しています。Firebaseは2024年7月22日にレガシーHTTP APIを廃止する予定です。 まだレガシーHTTP APIを使用している場合は、Singularアプリの設定ページからHTTP V1 APIを使用するようにアップデートしてください。詳細はこちら

Singularでは、マーケティングキャンペーンで獲得したトラフィックの質を測定するもう一つの方法として、アプリのアンインストールを追跡するオプションを提供しています。この機能はSingular Android SDKバージョン7.x+で利用可能で、有効にするにはアプリのアップデートが必要です。

注意事項

  • SingularのアンインストールトラッキングはGoogleのサービスを利用していますが、Googleとは異なる方法を使用しています。Google は、デバイス上のオペレーティングシステムから直接アンインストールを報告します。そのため、Google が報告する数値と Singular が報告する数値が異なる場合があります。
  • アンインストールは Singular のイベントとして追跡され、その結果、元のインストールまたは再エンゲージメントソースからアトリビューションリンクが削除されません。 ユーザーはアプリを一生の間に何度もアンインストールする可能性があるため、この結果、アンインストール率が 100% を超える場合があります。

セットアップ手順

HTTP V1 API
  1. Android SDK 7.x+ を統合します:アンインストール追跡は、Android SDK バージョン 7.x 以上で利用可能です。SDK のアップグレード方法については、Android SDK 統合ガイドを参照してください。
  2. AndroidManifest.xml を変更します:Android SDK アンインストール追跡ガイドの詳細を参照してください。
  3. Singular Apps] ページ>[App] > [Advanced Settings] > [Uninstall Tracking] で、プロジェクト ID を入力します。


    プロジェクト ID を作成および設定するには

    1. Firebase Cloud Messenger Consoleにアクセスします。
    2. プロジェクトを選択または新規作成します。
    3. Project Overview>Project Settingsに移動し、プロジェクトIDを コピーします。 このプロジェクトIDは、この後のステップでプロジェクトに適切なロールとパーミッションが付与された後、Singular appsページに入力する必要があります。


    4. Cloud Messagingに 移動し、Firebase Cloud Messaging API (V1)を有効にして、プロジェクトのFCMクラウドメッセージングを有効にします。
    5. Service Accounts > Manage service account permissionsに移動します。
    6. 正しいプロジェクトの役割と権限を割り当てます。
      1. 左のナビゲーションメニューからRolesを 選択します。
      2. ロールの作成 ]をクリックし、次の情報を入力します。
        タイトルシンギュラーアンインストールトラッキング
        ID:singular_uninstalls
        ロールの起動段階一般公開
      3. Add Permissionsを クリックし、cloudmessaging.messages.createを追加します。
      4. Createをクリックしてロールの作成を完了する
    7. ロールにSingularを割り当てる

      1. 左のナビゲーションメニューでIAMを選択します。
      2. 権限]タブで、[アクセスの許可]をクリックします。
      3. Add principals(プリンシパルの追加 )> New principals(新規プリンシパル)で、singular-uninstall-tracking@singular-uninstall-tracking.iam.gserviceaccount.comと入力します。
      4. ロールの割り当てで、前のステップで作成したSingular Uninstall Trackingを選択します。
      5. Saveをクリックします。
(レガシー)HTTP API

Androidでアンインストールトラッキングを設定するには

  1. Android SDK 7.x+をインストールしてください:アンインストールトラッキングは、Android SDK バージョン 7.x 以上で利用可能です。SDK のアップグレード方法については、Android SDK 統合ガイドを参照してください。
  2. AndroidManifest.xml を変更します:AndroidSDK アンインストール追跡ガイドの詳細を参照してください。
  3. 送信者IDとサーバーキーを追加します:アンインストール追跡を有効にするには、SingularにGoogleプロジェクト番号とサーバーキーが必要です。これらの値を取得するには
    • FirebaseでGo to Consoleを選択し、プロジェクトを選択します。
    • 歯車のアイコンを選択し、プロジェクト設定 > クラウドメッセージングに進みます。

      Screen_Shot_2017-12-27_at_4.48.09_PM.png

    • Singular アカウントで、[Settings] > [Apps] に移動し、アンインストールを追跡したいアプリを見つけ、[Edit] を選択します。
    • アンインストールトラッキングの下に、プロジェクト番号(Firebaseの送信者ID )とサーバーキーを追加します。

      Screen_Shot_2017-12-27_at_4.56.56_PM.png

  4. 以下のようにアプリで FCM を設定します:

    1. Firebase コンソールで、Firebase プロジェクトを作成します。
    2. プロジェクトダッシュボードで、Add Firebase to your Android Appを選択します。
    3. AndroidアプリのパッケージIDを入力します。

      Screen_Shot_2017-12-27_at_4.55.41_PM.png

    4. 設定ファイル(google-services.json)をダウンロードし、Androidプロジェクトのappモジュールにコピーします。
    5. プロジェクトレベルのbuild.gradleファイル(><project>/build.gradle>)に、以下を追加する:
      buildscript {
      dependencies {
      // この行または最新バージョンを追加する
      classpath 'com.google.gms:google-services:3.1.0'
      }
      }
    6. アプリレベルのbuild.gradleファイル(><project>/<app-module>/build.gradle>)に、以下を追加する:
      // ファイルの一番下に追加
      apply plugin: 'com.google.gms.google-services'
    7. プロジェクトを同期します。
    8. Androidのコードで、以下のサービスを作成します:
      public class FCMService extends FirebaseInstanceIdService {
      @Override
      public void onTokenRefresh() {
      super.onTokenRefresh();
      //これで、トークン
      String token = FirebaseInstanceId.getInstance().getToken();
      }
      }
      onTokenRefreshメソッドは、通知を送信するために必要なFCMトークンを取得します。
    9. このサービスをAndroidマニフェストファイルに追加します:
      <service android:name=".FCMService">
      <intent-filter>
      <action android:name="com.google.firebase.INSTANCE_ID_EVENT"/
      </intent-filter>
      </service>

これで、Singular は更新されたバージョンのアプリケーションを持っているユーザーのアンインストールを追跡します。

通知のテスト

FCMトークンを提供することで、コンソールを使って通知をテストできます:

Screen_Shot_2017-12-27_at_4.56.12_PM.png