リアルタイムのアンインストールトラッキングとは

リアルタイムのアンインストールトラッキングを使用すると、Firebase Analytics が統合されたアプリをユーザーがアンインストールした直後に、そのアンインストールをトラッキングできます。 Firebase は、アプリがアンインストールされると app-remove イベントをトラッキングします。MoEngage は Firebase Cloud Functions を使用してこの app-remove イベントを利用します。

Firebase Cloud Functions とは

Cloud Functions for Firebase は、Firebase の機能や HTTPS リクエストによってトリガーされたイベントに対してプログラムでレスポンスを返すサーバーレスフレームワークです。詳細については、Cloud Functions for Firebase を参照してください。

リアルタイムのアンインストールトラッキングは既存のアンインストールトラッキングとどう違うのか

MoEngage の現在のアンインストールトラッキングは、1 日 1 回すべてのユーザーデバイスにサイレントプッシュ通知を送信することで行われます。アンインストールのトラッキングには最大 24 時間かかります。リアルタイムのアンインストールトラッキングを使用すると、Firebase SDK によってアンインストールが即座にトラッキングされるため、ユーザーのアンインストールに迅速に対応できます。

リアルタイムのアンインストールトラッキングの実装

Firebase Blaze プランのアカウントがあることを確認してください。Cloud Functions をランタイム環境にデプロイするには、プロジェクトが Firebase の料金プランに加入している必要があります。

共通識別子の設定

アプリに Firebase Analytics SDK が統合されていることを確認してください。詳細については、Google アナリティクスを使ってみるを参照してください。 MoEngage と Firebase の間で共通の識別子を設定するには、アプリに次のコードを追加します。

val firebaseAnalytics = FirebaseAnalytics.getInstance(this)
MoEHelper.getInstance(this).setUniqueId("<unique-id>")
firebaseAnalytics.setUserProperty("MOE_USER_ATTRIBUTE_UNIQUE_ID", "<unique-id>")
}

注： UniqueID フィールドでは次の値は使用できません：“unknown”、“guest”、“null”、“0”、“1”、“true”、“false”、“user_attribute_unique_id”、“(empty)”、“na”、“n/a”、""、“dummy_seller_code”、“user_id”、“id”、“customer_id”、“uid”、“userid”、“none”、“-2”、“-1”、“2”

Firebase を使用したコンバージョンイベントの設定

リアルタイムのアンインストールトラッキングのために、アプリが Firebase Analytics と統合されていることを確認してください。

Firebase Analytics はイベント app_remove を自動的に収集します。app_remove イベントは Android 専用のイベントで、インストール元に関係なく、アプリケーションパッケージがデバイスから削除またはアンインストールされたときにトラッキングされます。リアルタイムのアンインストールを設定するには、Firebase ダッシュボードで app_remove イベントがコンバージョンイベントとしてマークされていることを確認してください。コンバージョンイベントを設定するには、次の手順に従います。

Firebase コンソールに移動し、アプリと統合されている Firebase プロジェクトを選択します。
Firebase ダッシュボードで、Analytics > Events を選択します。
イベントリストで app_remove イベントの Mark as Conversion トグルを有効にします。

Cloud Function の作成

コンバージョンイベントを設定したら、Cloud Function for Firebase を使用して関数を作成し、app_remove イベントを MoEngage に送信します。 Node JS を使用して Cloud Function を作成・公開するには、次の手順に従います。

Node.js と npm をインストールします。
関数を記述するには Node.js 環境が必要です。Firebase CLI を使用して、関数を Cloud Functions ランタイムにデプロイします。
次のコードを使用して Firebase CLI をインストールします。

npm install -g firebase-tools

firebase login を実行してブラウザでログインし、Firebase ツールを認証します。
Firebase プロジェクトのディレクトリに移動します。
firebase init functions を実行します。
言語オプションとして Javascript を選択します。
index.js ファイルに次のコードを追加します。

"use strict";

const functions = require("firebase-functions");
const admin = require("firebase-admin");
const https = require("https");
require("firebase-functions/lib/logger/compat");

admin.initializeApp();

exports.sendAndroidUninstallToMoEngage = functions.analytics.event("app_remove")
    .onLog((event) => {
      console.log("sendAndroidUninstallToMoEngage() : Event is: " +
      JSON.stringify(event));
      return exports.sendAppUninstallEventData(event);
    });

exports.sendAppUninstallEventData = function(event) {
//fetch the unique ID <MOE_USER_ATTRIBUTE_UNIQUE_ID>
var uniqueId = event.user.userProperties.MOE_USER_ATTRIBUTE_UNIQUE_ID.value;
//send event using S2S API of MoEngage
//https://www.moengage.com/docs/api/data/data-overview
};

package.json ファイルに次のコードを追加します。

{
  "name": "functions",
  "description": "Cloud Functions for Firebase",
  "scripts": {
    "lint": "eslint .",
    "serve": "firebase emulators:start --only functions",
    "shell": "firebase functions:shell",
    "start": "npm run shell",
    "deploy": "firebase deploy --only functions",
    "logs": "firebase functions:log"
  },
  "engines": {
    "node": "12"
  },
  "main": "index.js",
  "dependencies": {
    "firebase-admin": "^10.0.0",
    "firebase-functions": "^3.16.0",
    "firebase-tools": "^9.23.0",
    "g": "^2.0.1",
    "requestretry": "^4.1.1"
  },
  "devDependencies": {
    "eslint": "^7.6.0",
    "eslint-config-google": "^0.14.0",
    "eslint-plugin-promise": "^4.0.1",
    "firebase-functions-test": "^0.2.0",
    "requestretry": "^4.1.1",
    "web-push": "^3.4.5"
  },
  "private": true
}

​リアルタイムのアンインストールトラッキングとは

​Firebase Cloud Functions とは

​リアルタイムのアンインストールトラッキングは既存のアンインストールトラッキングとどう違うのか

​リアルタイムのアンインストールトラッキングの実装

​共通識別子の設定

​Firebase を使用したコンバージョンイベントの設定

​Cloud Function の作成

リアルタイムのアンインストールトラッキングとは

Firebase Cloud Functions とは

リアルタイムのアンインストールトラッキングは既存のアンインストールトラッキングとどう違うのか

リアルタイムのアンインストールトラッキングの実装

共通識別子の設定

Firebase を使用したコンバージョンイベントの設定

Cloud Function の作成