使用测量协议将应用事件发送到 GA4

一、简介

最后更新: 2021-06-08

你将构建什么

在此 Codelab 中,您将学习如何使用Measurement Protocol将外部事件发送到 GA4。

此 Codelab 假设您已经拥有一个实施了 Google Analytics for Firebase 的应用。如果您想了解如何与 Google Analytics for Firebase 集成,请先参考此 Codelab 。如果您想了解如何使用 Firebase 构建应用,请参阅Firebase Android Codelab-构建友好聊天

你将学到什么

  • 拨打第一个 MP 电话的步骤
  • 了解调用所需的参数
  • 发送并验证您的测试呼叫
  • 使用 Python 构建示例脚本来进行调用

你需要什么

  • 您的 Android 或 iOS 应用程序
  • 任何 IDE 都可以进行更改
  • GA4 帐户
  • 可选 - Python 开发环境(或Colab

2. 收集必填字段

在 GA4 中创建 API 密钥

导航到 GA4 并通过导航到管理>数据流>选择您的流>测量协议>创建来创建新的 API 密钥

6e4afca63054d291.png

c9e9ccd2ffba98eb.png

e714cd969fca4a4d.png

您可以提供任何昵称,系统会显示秘密值,您可以在通话中使用该值

如果您不确定如何访问 GA4,您可以访问您的 Firebase 项目,检查项目设置 > 集成 > Google Analytics,然后单击“管理”。 Google Analytics 连接应该是可见的,您也可以直接从那里导航

73b4d77a57eddfba.png

收集app_instance_id

您可以使用以下任意方法来收集您的 app_instance_id。

  1. 使用 BigQuery 导出
  2. 在您的应用程序源代码中本地获取

下面详细解释这两者

  1. 使用 BigQuery 导出

如果您启用了BigQuery 导出,则可以按照以下步骤操作

  • 登录 Firebase
  • 导航到项目设置 > 集成 > BigQuery
  • 点击数据集附近的“在 BigQuery 中查看”

注意:只有在启用切换大约 24-48 小时后,数据集才可用

63d061088b622961.png

  • 在 BigQuery 中,您可以检查表中的 user_pseudo_id。这是您可以在通话中使用的 app_instance_id

4b1b80bdc2884581.png

  1. 在您的应用程序源代码中本地获取

如果您的应用程序是使用 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”

fd78d961f3e48238.png

您需要填写以下字段

  • api_secret - 之前已在 GA4 上创建
  • firebase_app_id - 要获取此信息,您可以导航到Admin > Data Streams > choice your Stream 。应显示如下

19801c8e5cb29222.png

  • app_instance_id - 您已经检索到该值
  • user_id 不是强制的。您可以暂时将其留空
  • 类别 - 从下拉列表中将其更改为“自定义”,然后输入您选择的任何事件名称(不要使用任何自动收集的事件)。这里我们使用“test_from_codelab”

54cce53df64d697.png

或者,您还可以通过单击下面的按钮选择提供事件参数和/或用户属性

16a8f531a3894021.png

填写完所有内容后,您应该会看到类似这样的内容,其中有一个“验证事件”按钮

475801f25c3caf26.png

到达此位置后,单击“验证事件”,该按钮以橙色突出显示。它应该显示下面的消息,指定该事件有效,并且您现在将看到一个“发送到 GA”的按钮。此时,如果事件显示为无效,该工具将告诉您存在问题的确切字段,您可以修复该问题并重试

23e4e6800705b4aa.png

您现在可以点击该按钮,它应该会向 GA4 发送一个测试事件

4. 验证 GA4 中的事件

发送事件后,您可以导航到您的 GA4 帐户并检查实时。您应该会看到该事件完成

994b51ca46bb1973.png

事件从实时视图传播到实际事件报告选项卡可能需要大约 24 小时,因此如果您没有立即在常规事件报告中看到这一点,无需担心!

如果您遇到问题或差异,在此处查看测量协议的已知限制可能会有所帮助

5. 构建 Python 脚本

现在您已经对其进行了测试,您可以检查 API 调用和事件负载,以在 Python(或您选择的任何语言)中构建可以进行此调用的类似架构。然后,您可以按照您想要的频率安排此操作并实施它。对于此部分,您可以使用您选择的任何支持 Python 的 IDE,也可以仅使用Google Colab 笔记本(无需在您的设备上进行任何安装)

返回到 GA4 Event Builder,您将看到端点如下

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 中成功使用测量协议。现在,您可以构建强大的解决方案架构,将更有意义的数据发送到 Google Analytics,并改进您的营销和业务分析。为了充分利用这一点,我们还建议连接到 Google Ads,并将这些事件作为转化导入。您可以参阅此 Codelab中的步骤 6 以获取详细说明。出于转化跟踪目的,Google Ads 将仅显示过去 60 天内从 Firebase SDK 收集的与 IDFA 或设备 ID 相关的数据。请记住,这仍然是一个 alpha API,并确保通过此处列出的限制,这些限制应在全面发布之前解决

你已经学会了

  • 如何收集正确的变量来进行 MP 调用
  • 如何发送和验证测试事件
  • 如何构建脚本来发送 MP 呼叫