跳至主要内容

移动推送 Webhook

借助阿哈利姆的 LiveOps 构建器 活动管理工具，游戏开发者可以设置自动触发条件，当玩家在游戏枢纽执行特定操作或满足特定条件时，向其发送个性化的移动设备推送通知。 当玩家满足您在 LiveOps 活动中设置的触发条件后，阿哈利姆会自动向您的游戏服务器发送 Webhook 请求，其中包含需要推送给特定玩家的完整通知内容。

要求

如需接入阿哈利姆的移动推送通知系统，请按照以下要求配置您的 Webhook 服务器：

  • HTTPS 端点，可接收 POST Webhook 请求。
  • 监听由阿哈利姆生成并 签名 的事件。
  • 接收到资料更新通知后，更新游戏系统中的相应用户信息，并可选择向玩家发送确认通知。
  • 当您的服务器成功接收并处理弹窗请求时，应返回 2xx 系列状态码；如遇请求无效或处理失败，则应返回适当的 4xx 或 5xx 状态码。

配置步骤

  1. 为 ingame.push Webhook 处理开发一个函数。
  2. 部署您的端点使其可访问。
  3. 在Aghanim账号中注册您的端点 → Game → Webhooks → New Webhook，选择游戏内推送事件类型。
  4. 在阿哈利姆上创建一个 LiveOps 活动，设置合适的触发条件和目标受众，并选择“发送移动推送”作为活动操作。

您也可以参考 移动推送配置指南 设置玩家资料更新确认通知。

或者，您也可以使用 Create Webhook API 方法在阿哈利姆中注册您的端点。

Request Schema

下面是一个 ingame.push Webhook 请求示例：

POST /your/webhook/uri HTTP/1.1
Content-Type: application/json
Host: your-webhook-endpoint.com
User-Agent: Aghanim/0.1.0
X-Aghanim-Signature: 2e45ed4dede5e09506717490655d2f78e96d4261040ef48cc623a780bda38812
X-Aghanim-Signature-Timestamp: 1725548450

{
  "event_type": "ingame.push",
  "event_data": {
    "player_id": "2D2R-OP3C",
    "title": "您好！",
    "body": "点击查看您今天的专属优惠！",
    "icon": null,
    "url": null
  },
  "event_time": 1725548450,
  "event_id": "whevt_eCacGbJVbvToOgzjXUgOCitkQE",
  "idempotency_key": null,
  "request_id": "d1593e9c-c291-4004-8846-6679c2e5810b",
  "sandbox": false,
  "trigger": "liveops.execute_action",
  "transaction_id": "whtx_eCacGbJVbvT",
  "context": null,
  "game_id": "gm_exTAyxPsVwh"
}

事件 Schema

键名类型描述
event_idstring阿哈利姆生成的唯一事件标识符。
game_idstring您的游戏在阿哈利姆中的唯一标识符。
event_typestring事件的类型， ingame.push 在此情境下。
event_timenumber以 Unix 时间戳表示的事件发生日期。
event_dataEventData包含事件特定数据的字段，其中可能包含用于继承对象的各种键值。
idempotency_keystring|null即使出现重试情况，也能确保 Webhook 操作只执行一次。 可以是 null 具体取决于事件类型。
request_idstring|null如果事件是通过 API 请求触发的，此字段将包含对应的请求 ID。
sandboxboolean标识事件是否来自沙盒测试环境的指示器。
triggerstring|nullThe trigger that caused the event to be sent.
transaction_idstring阿哈利姆生成的交易标识符。在同一交易过程中触发的多个事件可能共享相同的交易 ID。
contextEventContext|null事件的相关上下文信息。

EventContext Schema

键名类型描述
orderOrderContext|null与事件相关的订单信息（如果适用）。
playerPlayerContext|null（可选）玩家信息。如需启用，请在webhook设置中选择“添加玩家上下文”。

EventData Schema

键名类型描述
player_idstring要向其发送推送通知的目标玩家的唯一标识符。
titlestring推送通知的主标题文本。
bodystring推送通知的正文。
icon`string\null`
url`string\null`

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

On this page