跳至主要内容

深层链接

深层链接是您创建的游戏和 Aghanim Web Hub 环境之间的桥梁。 当您将深层链接集成到您的游戏中时,玩家可以与 Game Hub 互动,无需单独验证。

用于玩家身份验证的深层链接:

  • 将链接嵌入到游戏界面中。
  • 链接应配置为在设备的默认浏览器中打开,而非应用内的 WebView 组件。

它允许玩家发现 Game Hub 并与其互动。

Default structure
https://<GAME_HUB_DOMAIN>/go/login?player_id=<UNIQUE_PLAYER_ID><QUERY_PARAMETERS?>
Structure for redeem code page
https://<GAME_HUB_DOMAIN>/go/redeem?player_id=<UNIQUE_PLAYER_ID><QUERY_PARAMETERS?>

查询参数

要自定义深层链接,请将您感兴趣的查询参数添加到链接中。

player_id

必填项

用于自动将玩家凭据验证到 Game Hub 的玩家标识符。

redirect_path

Optional

要重定向玩家到的游戏枢纽页面。 要知道页面的值,请使用模板:/<PAGE_PATH_IN_HUB>

code

兑换码页面必填项

自动应用的兑换码,玩家访问链接后系统会自动激活该兑换码。

locale

Optional

显示 Game Hub 页面所用的语言。 使用提供的ISO 639 格式进行表示,在支持的语言完整列表中查看。

使用场景

场景一:引导玩家浏览新闻

您可以创建直接将玩家引导至游戏枢纽新闻版块的深层链接,让他们浏览最新的游戏更新、活动公告和其他内容,同时提供购买特色商品的机会。 这类链接最适合放置在游戏主界面的通知横幅、新闻公告按钮中。

Example for News page of game hub
https://<GAME_HUB_URL>/go/login?player_id=<UNIQUE_PLAYER_ID>&redirect_path=/news

场景二:自动兑换奖励码

深层链接还可以用于将玩家导航到游戏枢纽内的优惠券兑换页面,预定义的兑换码会自动应用。 此功能允许玩家在无需手动输入代码的情况下接收免费商品。 此类链接非常适合在游戏内宣传特别优惠或奖励。

Example for code redeem page of game hub
https://<GAME_HUB_URL>/go/redeem?player_id=<UNIQUE_PLAYER_ID>&code=<REDEEM_CODE>

当玩家通过此 URL 成功激活兑换码后,阿哈利姆会自动向您配置的服务器端点发送 Webhook 通知。 您的游戏服务器收到这一通知后,应验证其真实性,然后将对应的奖励商品添加到玩家的游戏账户中,完成整个奖励发放流程。

场景三:多语言版本访问

您可以在深层链接中添加语言参数,确保非英语母语的玩家能够直接访问他们熟悉语言的游戏枢纽界面,提供更加友好的玩家体验。

Example for News page of Portuguese game hub
https://<GAME_HUB_URL>/go/login?player_id=<UNIQUE_PLAYER_ID>&redirect_path=/news&locale=pt

接下来要阅读

需要技术支持?
联系我们的集成技术团队: [email protected]