游戏内弹窗

游戏内弹出窗口是游戏开发者与玩家之间的一种直接沟通渠道，旨在及时传递信息、促销和奖励。通过使用 Aghanim LiveOps Builder，开发者可以基于游戏内的玩家操作或您游戏中心的交互来触发这些弹出窗口，以符合战略标准来增强参与度并改善游戏体验。

需求

为了将游戏内弹出窗口与 Aghanim 集成，确保您的游戏达到以下要求：

为游戏内弹出窗口开发前端，符合您的游戏美学，提供无缝用户体验。
一个公开可访问的 HTTPS 端点可接收 Aghanim 弹出窗口 webhook 并在您的游戏中触发弹出窗口的显示。
对于由游戏内事件触发的活动，定义将启动活动的游戏内条件，并实现必要的逻辑以执行 Aghanim API 调用以启动活动。

运行游戏内弹窗的一般流程

要实现游戏内弹出窗口，请按照以下步骤进行：

在 Aghanim 仪表板的 Game → Webhooks 中，注册用于处理 Aghanim 弹出窗口 webhook 的 webhook URL。确保您选择 In Game Popup 作为事件类型。
在 Aghanim 仪表板上创建一个活动，详细说明游戏内弹出窗口应何时和为何出现在玩家面前。
在活动编辑模式的设置部分发布活动。
对于由游戏内事件启动的活动，通过在您的游戏中设置必要的 API 调用和触发逻辑，通过 Aghanim API 触发活动。
一旦满足活动条件，Aghanim 发送一个 webhook 以以下格式显示弹出窗口：

curl -X "https://your-webhook-endpoint.com/your/webhook/uri" \
  -H "Host: your-webhook-endpoint.com" \
  -H "x-aghanim-signature-timestamp: <EVENT_TIMESTAMP>" \
  -H "x-aghanim-signature: <HMAC-SHA256_SIGNATURE>" \
  -H 'user-agent: Aghanim/0.1.0' \
  -H 'content-type: application/json' \
  -H 'accept-encoding: gzip, deflate' \
  -H 'accept: */*' \
  -d '{
        "event_id": "<EVENT_ID>",
        "event_time": 1709974737,
        "event_type": "ingame.popup",
        "idempotency_key": null,
        "event_data": {
          "player_id": "<PLAYER_ID>",
          "title": "<IN_GAME_POPUP_TITLE>",
          "body": "<IN_GAME_POPUP_BODY>",
          "icon": null,
          "url": null
        }
      }'

使用场景：通过游戏内弹出窗口重新吸引玩家关注游戏中心新闻

此活动针对超过 12 小时未访问游戏中心的玩家，旨在通过强调最新新闻吸引他们回归：

活动开始于一个自定义事件，需要您侧的触发逻辑实现。例如，考虑将玩家登录作为本活动的触发器。登录后，您的游戏向 Aghanim 发起 API 调用以启动活动。然后 Aghanim 检查玩家在过去 12 小时内是否与游戏中心互动。如果缺席时间超过 12 小时，Aghanim 会派发一个包含弹出窗口详细信息的 webhook。您的游戏端点然后处理此信息，显示弹出窗口，有效地将玩家拉回游戏中心活动。

要实施这一活动：

开发活动弹窗的前端。
创建一个深度链接将玩家引导到游戏中心的新闻页面，并将其集成到弹出窗口中。
定义触发弹出窗口的游戏内条件，如玩家登录，并在您的游戏中实施相应逻辑。
玩家登录后，调用 Aghanim API 为玩家启动活动，例如。:

curl -u sk_xxxxxxxxxxxx: -X POST https://api.aghanim.com/s2s/v1/events \
  -H "Content-Type: application/json" \
  -d '{ \
      "event_time":1711366555685, \
      "event_type":"My Campaign", \
      "event_data":{ \
          "player_id":"testplayer" \
      } \
  }'

在接收到您的 webhook 后，Aghanim 检查指定玩家在过去 12 小时内是否访问过游戏中心。
如果玩家的最后访问时间超过 12 小时，Aghanim 会派发一个包含弹出窗口内容的 webhook，例如。:

curl -X "https://your-webhook-endpoint.com/your/webhook/uri" \
  -H "Host: your-webhook-endpoint.com" \
  -H "x-aghanim-signature-timestamp: <EVENT_TIMESTAMP>" \
  -H "x-aghanim-signature: <HMAC-SHA256_SIGNATURE>" \
  -H 'user-agent: Aghanim/0.1.0' \
  -H 'content-type: application/json' \
  -H 'accept-encoding: gzip, deflate' \
  -H 'accept: */*' \
  -d '{
        "event_id": "cam_ezSOgmVybuV",
        "event_time": 1709974737,
        "event_type": "ingame.popup",
        "idempotency_key": null,
        "event_data": {
          "player_id": "testplayer",
          "title": "始终走在游戏前沿！ 🌟",
          "body": "深入了解最新的游戏更新和资讯，让您体验刺激的游戏旅程。立即探索，加入全球玩家的游戏冒险！",
          "icon": null,
          "url": null
        }
      }'

在您的游戏端处理收到的 webhook，并显示提供的弹出窗口内容。

需要帮助吗？
联系我们的集成团队 integration@aghanim.com

需求​

运行游戏内弹窗的一般流程​

使用场景：通过游戏内弹出窗口重新吸引玩家关注游戏中心新闻​

需求

运行游戏内弹窗的一般流程

使用场景：通过游戏内弹出窗口重新吸引玩家关注游戏中心新闻