GameAPI.GameVIPAction.show

特别声明
1.本接口仅针对已经接入支付的应用。
2.请先在自助营销平台提交活动申请(活动申请详见这里),审核通过的应用将获得接口权限及活动批号信息。
3.本接口属于下面的流程图所示第二个环节(详见开通包月送礼包开发说明)。

marketing_21.png

目录

What's New?

2012年11月21日,修改参数“is_luxury”为“service_type”,表示开通的蓝钻类型(普通蓝钻或豪华蓝钻);
新增参数:open_gamevip_mode,支持开发者传入蓝钻开通对象(给自己开通或者给好友开通)。
2012年10月12日,新增参数:is_luxury,duration。支持开发者传入蓝钻类型(普通蓝钻版或豪华蓝钻)和开通时长。

1 功能说明

“开通蓝钻”前端JS接口,弹框模式。
本接口适用场景:开通蓝钻送礼包活动。
接入蓝钻的应用,可以提示用户开通蓝钻或续费蓝钻即可获赠应用礼包,方便引导用户开通蓝钻,在用户成功开通蓝钻后,即赠送用户应用中的礼包,提升蓝钻用户付费群。

2 接口调用说明

2.1 域名检查

调用接口前,首先保证应用所在的域名是 app$appid.qqgameapp.com 或 s\d\d.app$appid.qqgameapp.com,或者为qqgame.app$appid.twsapp.com,即应用已经接入游戏平台。
其中$appid为应用接入时分配的应用id,\d代表任一0~9整数,s\d\d代表多区多服应用的大区ID。

2.2 调用接口

在调用本接口前,需要先调用如下JS接口:
http://qqgameplatcdn.qq.com/social_hall/js/jquery.js
http://qqgameplatcdn.qq.com/social_hall/js/jquery.pm.js
http://qqgameplatcdn.qq.com/social_hall/app_frame/qqgamelib.js

2.3 参数说明

参数名称 是否必须 类型 描述
appid 必须 string 应用的唯一ID。
mp_id 必须 string 开通包月送礼包的营销活动ID。

在管理中心“支付结算”tab下的“营销接入”提交活动申请后,将获取该营销活动ID。

token 必须 string 领取道具的token,通过调用v3/pay/get_token接口获取。
zoneid 必须 string 在管理中心“支付结算”tab的“营销接入”下,在“发货配置”中配置好的分区ID。
openid 必须 string 根据APPID以及用户QQ号码生成用户ID。
version string 表示使用的OpenAPI版本。v3:使用OpenAPI V3.0,v2或不指定:使用OpenAPI V2.0。

如果您的应用中,回调的赠送道具发货URL使用的是OpenAPI V3.0协议,则这里必须传值"v3"。

close_cb 必须 回调函数 关闭对话框的回调函数(无参数)。
service_type number 标识开通的蓝钻类型。

1:普通蓝钻,开通界面将不显示豪华蓝钻;
2:豪华蓝钻,开通界面将不显示普通蓝钻;
3:开通界面同时显示普通蓝钻和豪华蓝钻;
不传入此参数:开通界面将显示普通蓝钻和豪华蓝钻选项,允许用户选择。

duration number 表示蓝钻的开通时长。取值范围为1-24,单位为月。

在设置了此参数后,开通界面将不能手动更改开通时长,付费模式为“按月付费”,也不能手动更改。
不传入此参数,付费模式和开通时长均允许用户手动更改。

open_gamevip_mode number 蓝钻的开通对象。

1:给自己开通;
2:给好友开通;
不传入此参数,默认给自己开通。

2.4 调用示例

GameAPI.GameVIPAction.show

(

  // appid
  10001, 


  // mp_id
  10000000,


  // token
  '39DBE00A043F8DB011391759A3A8A25',


  // zoneid
  1, 


  // openid
  '000000000000000000000000032373DF',


  // version
  'v3',


  // 回调函数
  function() {alert('close!');},


  // service_type
  1,


  // duration
  15,


  // open_gamevip_mode
  1

);

3 效果展示

在应用中放置开通蓝钻送礼包营销活动入口,用户点击活动链接,应用调用前台接口弹出“开通蓝钻”弹框,弹框样式如下所示。
marketing_26.png

相关文档

上一步:v3/pay/get_token

下一步:回调赠送道具发货URL的协议说明_V3.0

其他相关文档:开通包月送礼包

以上信息是否解决您的问题?

Copyright © 1998 - 2019 Tencent. All Rights Reserved.

腾讯公司 版权所有

有问必答 返回顶部