跳至主要内容

游戏内弹窗

游戏内弹窗是游戏开发者与玩家之间的直接沟通渠道，用于及时传递信息、促销和激励内容。 通过使用阿哈利姆 LiveOps 构建器，开发者可基于玩家游戏内行为或游戏枢纽互动智能触发弹窗，精准匹配运营策略，有效提升用户参与度与游戏体验。

要求

要将游戏内弹窗与阿哈利姆集成，确保您的游戏满足以下要求：

  • 为游戏内弹窗开发与您游戏风格一致的前端界面，提供无缝用户体验。
  • 一个公开可访问的 HTTPS 端点，用于接收阿哈利姆 弹窗 Webhook 并在您的游戏中触发弹窗显示。
  • 对于由游戏内事件触发的活动，定义会启动活动的游戏内条件，并实现必要的逻辑来 执行阿哈利姆 API 调用以启动活动。

实现游戏内弹窗的一般流程

要实现游戏内弹窗，请按照以下步骤操作：

  1. 在Aghanim控制台的游戏 → Webhooks中，注册用于处理Aghanim弹出式webhooks的webhook URL。 确保选择 游戏内弹窗 作为事件类型。
  2. 在阿哈利姆控制台上创建一个活动，详细说明何时以及为何应向玩家显示游戏内弹窗。
  3. 在活动编辑模式的设置部分发布该活动。
  4. 对于由游戏内事件启动的活动，通过在您的游戏中设置必要的 API 调用和触发逻辑，使用 阿哈利姆 API 触发活动。
  5. 满足活动条件后，阿哈利姆会发送一个 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 小时以上未访问游戏枢纽的玩家，旨在通过突出最新新闻吸引他们回来：

Payment flow image
Payment flow image

活动从自定义事件开始，需要您在游戏端实现触发逻辑。 例如，可以考虑使用玩家登录作为该活动的触发器。 登录后，您的游戏向阿哈利姆发起 API 调用以启动活动。 然后阿哈利姆检查玩家在过去 12 小时内是否与游戏枢纽互动。 如果玩家未访问超过 12 小时，阿哈利姆会发送一个包含弹窗详情的 Webhook。 您的游戏端点处理此信息，显示弹窗，有效地将玩家引导回游戏枢纽活动。

要实现该活动：

  1. 为活动弹窗开发前端界面。

  2. 创建一个 深层链接 指向游戏枢纽的新闻页面，并将其集成到弹窗中。

  3. 定义触发弹窗的游戏内条件（如玩家登录），并在您的游戏中实现相应逻辑。

  4. 玩家登录后，调用阿哈利姆 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" \
          } \
      }'

  5. 收到您的 Webhook 后，阿哈利姆检查指定玩家在过去 12 小时内是否访问过游戏枢纽。

  6. 如果玩家上次访问超过 12 小时，阿哈利姆会发送一个包含弹窗内容的 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
            }
          }'

  7. 在您的游戏端处理收到的 Webhook，显示提供的弹窗内容。

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

On this page