跳至主要内容

通过 Firebase Cloud Messaging 推送移动通知

本指南说明如何将阿哈利姆与 Firebase Cloud Messaging (FCM) 集成,向玩家设备发送移动推送通知,以提高玩家参与度、留存率和变现能力。

使用阿哈利姆的 LiveOps 构建器,您可以定义触发移动推送通知的条件,基于玩家在阿哈利姆生成的游戏枢纽中的操作或互动。 当满足活动条件时,阿哈利姆会激活 FCM 集成,向玩家发送相应的移动推送通知。

要求

第 1 步:获取 Service Account Key

要向玩家设备发送推送通知,您需要从 Google Cloud Console 获取服务账户 (Service Account) 信息并提供给阿哈利姆。

  1. 访问 Google Cloud Console → APIs & ServicesCredentials
  2. 点击 Create Credentials 并选择 Service Account
  3. 填写表单中的必要信息并点击 Create
  4. 确保创建的服务账户有权访问 Firebase Cloud Messaging API。
  5. 点击新创建的服务账户,并导航到 Keys 标签页。
  6. 点击 Add Key 并选择 Create new key
  7. 选择 JSON 作为密钥类型并点击 Create
  8. 包含 Service Account Key 的 JSON 文件将下载到您的设备。
  9. 打开 JSON 文件并复制其内容。 这些内容将作为 Service Account Key 使用。

第 2 步:在阿哈利姆控制台中提供 Service Account Key

获取 Service Account Key 后,将其提供给阿哈利姆控制台:

  1. 进入阿哈利姆控制台 → 应用接入通过 Firebase Cloud Messaging 推送通知
  2. 安装该插件。
  3. 在插件设置中,将复制的密钥粘贴到 Service Account Key 字段。

第 3 步:在 player.verify Webhook 响应中添加 FCM 属性

当阿哈利姆向您的服务器发送 验证玩家 (player.verify) Webhook 时,您的响应必须包含特定的 firebase_* 参数。 这些参数对 FCM 向玩家设备发送推送通知至关重要。

参数

键名类型描述是否必需
firebase_fcm_tokenobject设备的唯一标识符。 示例:bk3RNwTe3H0:CI2k_HHwgIpoDKCIZvvDMExUdFQ3P1…

Webhook 响应示例:

{
"player_id": "1x1x-xxxx1",
"name": "Molly",
"attributes": {
"firebase_fcm_token": "bk3RNwTe3H0:CI2k_HHwgIpoDKCIZvvDMExUdFQ3P1…"
}
}

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