跳至主要内容

阿哈利姆-Google Analytics for Firebase 集成

本指南说明了如何将 Aghanim 与 Google Analytics for Firebase 集成,以跟踪购买事件和用户行为。 将 Aghanim 与 Google Analytics for Firebase 连接后,您可以监控 Game Hub 的购买事件,确保整个游戏环境中的用户交易得到全面跟踪。

信息

目前,Aghanim 仅在玩家在 Game Hub 中成功完成支付时向 Google Analytics for Firebase 发送购买事件。

要求

第 1 步:获取您的衡量 ID

首先,您需要获取您的 Google Analytics 4 衡量 ID:

  1. 登录到您的 Google Analytics 仪表板
  2. 依次点击管理数据流 → 选择您的应用数据流。
  3. 数据流详情 中,查找您的 衡量 ID (格式:G-XXXXXXXXXX)。
  4. 复制此衡量 ID - 您将在插件配置中需要它。

第 2 步:创建 API 密钥

为了启用服务器到服务器的事件跟踪,您需要为 Measurement Protocol 创建 API 密钥。 您可以为不同平台(iOS、Android)创建单独的 API 密钥,或为所有平台使用单一常规密钥。

  1. 在第 1 步的相同 数据流详情 页面中。
  2. 向下滚动到 衡量协议 API 密钥 并点击 创建
  3. 为 API 密钥提供一个昵称,例如 "Aghanim Integration - Generic" 或 "Aghanim Integration - iOS",然后点击 创建
  4. 复制生成的 API 密钥 值 —— 这是认证您的服务器到服务器请求的唯一字符串。
  5. 如果您希望为不同的平台使用不同的 API 密钥,请为每个平台重复步骤 2-4。

有关更多信息,请参见 Google Analytics 衡量协议文档

第 3 步:在 Aghanim 控制台中配置插件

  1. 进入 Aghanim 控制台 → Aghanim ConnectGoogle Analytics for Firebase 并安装插件。
  2. 在插件设置中提供您的凭据。 您可以配置:
    • 常规(适用于所有平台):Measurement ID 和 API 密钥
    • iOS 特定:用于 iOS 的 Measurement ID 和 API 密钥
    • Android 特定:用于 Android 的 Measurement ID 和 API 密钥

至少需要一个完整的配置(Measurement ID + API 密钥)。 当提供了两者时,平台特定值将覆盖通用值。

工作原理

当玩家在 Game Hub 上完成购买时,Aghanim 自动将 purchase 事件发送到 Google Analytics for Firebase,并附上以下数据:

  • client_id:从Game Hub或结账页获取的唯一客户端标识符
  • 用户 ID:设为玩家的 player_id 以确保用户识别的一致性
  • 时间戳(微秒):购买时的时间戳(以微秒为单位)
  • Event data:
    • 事件名称:purchase
    • 货币:订单货币(例如,USD
    • 金额:购买金额
    • 交易 ID:唯一的订单标识符
    • 项目:含有其 ID 和名称的已购项目列表

这种集成确保了从您的 Game Hub 的所有购买事件都能自动跟踪到 Google Analytics for Firebase,使您获得对玩家消费行为和购买模式的全面洞察。

需要技术支持?
联系我们的集成技术团队: integration@aghanim.com