1. はじめに
最終更新日: 2021 年 6 月 8 日
作成するアプリの概要
この Codelab では、Measurement Protocol を使用して外部イベントを GA4 に送信する方法を学びます。
この Codelab は、Firebase 向け Google アナリティクスが実装されたアプリがすでに実装されていることを前提としています。Firebase 向け Google アナリティクスと統合する方法については、まずこちらの Codelab をご覧ください。Firebase を使用してアプリを構築する方法については、Firebase Android Codelab - Build Friendly Chat をご覧ください。
ラボの内容
- MP での最初の通話の手順
- 呼び出しに必要なパラメータを理解する
- テスト通話を送信して検証する
- Python で呼び出しを行うサンプル スクリプトを作成します。
必要なもの
- Android アプリまたは iOS アプリ
- すべての IDE で変更を加える
- GA4 アカウント
- 省略可 - Python 開発環境(または Colab)
2. 必須フィールドを収集する
GA4 で API Secret を作成する
GA4 で新しい API Secret を作成するには、[管理] > [データ ストリーム] > ストリームを選択 > [Measurement Protocol] > [作成] に移動します。
任意のニックネームを指定すると、呼び出しで使用できるシークレットの値が表示されます。
GA4 へのアクセス方法がわからない場合は、Firebase プロジェクトにアクセスし、[プロジェクトの設定] > [統合] > [Google アナリティクス] に移動して、[管理] をクリックします。Google アナリティクスの接続が表示され、そこから直接移動することもできます。
app_instance_id を収集する
app_instance_id は次のいずれかの方法で収集できます。
- BigQuery Export の使用
- アプリのソースコードでネイティブにフェッチする
この 2 つの詳細については、以下で説明します。
- BigQuery Export の使用
BigQuery へのエクスポート を有効にしている場合は、次の手順を行います。
- Firebase にログインする
- [プロジェクトの設定] > [統合] > [BigQuery] に移動します。
- データセットの近くにある [BigQuery で表示] をクリックします。
注 : データセットは、切り替えボタンを約 24 ~ 48 時間有効にした後でのみ利用可能になります
- BigQuery では、テーブルの user_pseudo_id を確認できます。呼び出しで使用できる app_instance_id
- アプリのソースコードでネイティブにフェッチする
アプリが Java でビルドされている場合は、次のようなコマンドを使用して app_instance_id を取得できます。
FirebaseAnalytics.getInstance(this).getAppInstanceId().addOnCompleteListener(new OnCompleteListener<String>() {
@Override
public void onComplete(@NonNull Task<String> task) {
if (task.isSuccessful()) {
String user_pseudo_id = task.getResult();
}
}
});
Kotlin の場合は以下を試すことができます。
Thread {
Firebase.analytics.appInstanceId.addOnSuccessListener { user_pseudo_id ->
Log.d("Firebase", "user_pseudo_id using appInstanceId is $user_pseudo_id")
/*
Store the value to your server or do something with the retrieved id
*/
}
}.start()
iOS アプリをお持ちの場合は、Swift で以下を使用できます。
let user_pseudo_id = Analytics.appInstanceID()
print("user_pseudo_id = \(user_pseudo_id)")
/*
Store the value to your server or do something with the retrieved id
*/
ご利用のインフラストラクチャに応じて、以下のリンクをご覧ください。
3. コールの構成
GA4 のイベント ビルダーを使用すると、サンプル呼び出しを作成できます。(Cookie を有効にしてログインしている必要があります)。切り替えボタンが [firebase] に設定されていることを確認します。
次のフィールドに入力してください
- api_secret - GA4 ですでに作成済み
- firebase_app_id - 確認するには、[管理] > [データ ストリーム] > [ストリームを選択] に移動します。次のように表示されます。
- app_instance_id - この値はすでに取得されています
- user_id は必須ではありません。今は空欄のままでかまいません
- カテゴリ - プルダウンから [カスタム] に変更し、任意のイベント名を入力します(自動収集イベントは使用しないでください)。ここでは「test_from_codelab」を使用します。
必要に応じて、下のボタンをクリックして、イベント パラメータやユーザー プロパティを指定することもできます。
すべて入力すると、次のような [Validate Event] のボタンが表示されます。
ここが表示されたら、オレンジ色でハイライト表示されている [イベントを検証] をクリックします。イベントが有効であることを示す以下のメッセージと、[SEND TO GA] ボタンが表示されます。この時点でイベントが無効と表示される場合は、問題のあるフィールドが示されるので、修正して再試行できます。
ボタンをクリックすると、テストイベントが GA4 に送信されます。
4. GA4 でイベントを検証する
イベントを送信したら、GA4 アカウントに移動して [リアルタイム] を確認できます。このようにしてイベントが
イベントがリアルタイム ビューから実際のイベント レポート タブに反映されるまでに 24 時間ほどかかることがあるため、通常のイベント レポートにすぐに反映されていなくても心配する必要はありません。
問題や不一致が発生している場合は、Measurement Protocol の既知の制限事項をご確認ください。
5. Python スクリプトの構築
テストを行ったので、API 呼び出しとイベント ペイロードを調べて、この呼び出しが可能な同様のアーキテクチャを Python(または任意の言語)で構築します。その後、希望する頻度でこれをスケジュールし、運用化できます。ここでは、Python をサポートする任意の IDE を使用することも、デバイスにインストールする必要がない Google Colab ノートブックを使用することもできます。
GA4 イベント ビルダーに戻ると、エンドポイントが以下のようになっています。
POST /mp/collect?firebase_app_id=XXXX&api_secret=XXXX
HTTP/1.1
Host: www.google-analytics.com
イベント ペイロードは次のとおりです。
{
"app_instance_id": XXXX,
"non_personalized_ads": false,
"events": [
{
"name": "test_from_codelab",
"params": {
"test_param": "test_123"
}
}
]
}
これを Python に変換するには、次のようなコードを使用します。
import requests
import json
url = "https://www.google-analytics.com/mp/collect?firebase_app_id=XXXX&api_secret=XXXX"
payload = {
"app_instance_id": XXXX,
"non_personalized_ads": False,
"events": [
{
"name": "test_from_codelab",
"params": {
"test_param": "test_123"
}
}
]
}
r = requests.post(url,data=json.dumps(payload),verify=True)
print(r.status_code)
適切な値でこれを実行すると、同様に GA4 にイベントがリアルタイムで反映されます。
6. 完了
これで、GA4 で Measurement Protocol を正しく使用できるようになりました。パワフルなソリューション アーキテクチャを構築して、より有意義なデータを Google アナリティクスに送信し、マーケティング分析やビジネス分析を改善できるようになりました。コンバージョンを最大限に引き出すには、Google 広告に接続し、これらのイベントをコンバージョンとしてインポートすることもおすすめします。詳しい手順については、こちらの Codelab のステップ 6 をご覧ください。Google 広告では、コンバージョン トラッキングを目的として、過去 60 日間に Firebase SDK から収集された IDFA またはデバイス ID に関連付けられたデータのみが表示されます。なお、これはまだアルファ版の API です。こちら に記載されている制限を必ず行ってください。こうした制限は、完全にリリースする前に対処する必要があります。
学習した内容
- MP 呼び出しを行うための適切な変数の収集方法
- テストイベントを送信して検証する方法
- MP 通話を送信するスクリプトを作成する方法