CPS服务商-使用CPS参数推广

参数说明

参数格式如下（仅举例），实际投放以登录微信服务市场获取到的实际参数为准：

?wxgamepro=PkgCBXXXXX

l参数一定是以"?"开头（注意是英文半角的"?"，非中文全角的"？"）

l参数中"wxgamepro"是渠道号的参数名，固定不变

l"PkgCBXXXXX"为参数值，代表对应的渠道组（一包多发模式）或CPS场景（CPS合作模式），需要替换为实际参数值

l参数在其他场景中也叫“path”、路径

l某些需要query的场景，需要把第一个"?"去掉

应用CPS参数

服务商根据自己的场景形态（如APP/小程序/公众号等），将参数埋入对应的path路径字段。用户成功打开小游戏时，将通过path路径中的“CPS参数”进行染色与统计，以判定用户的分发归属和收益结算。不同场景形态的配置方式不同：

1、如果你是APP

使用功能介绍 | 微信开放文档 ，userName字段传入小游戏的账号原始ID（服务商-游戏库获取，微信打开小游戏-基本资料也-更多资料-账号原始ID，gh开头的字符串就是），path字段传入参数。

以Android拉起小程序为例：

String appId = "你的App的AppId，非小游戏appid"; // 填移动应用(App)的 AppId，非小程序的 AppID

IWXAPI api = WXAPIFactory.createWXAPI(context, appId);



WXLaunchMiniProgram.Req req = new WXLaunchMiniProgram.Req();

req.userName = "gh_d43f693ca31f"; // 服务商-游戏库-账号原始ID

req.path = "?wxgamepro=PkgCBXXXXX"; // 服务商-参数

req.miniprogramType = WXLaunchMiniProgram.Req.MINIPTOGRAM_TYPE_RELEASE;// 可选打开 开发版，体验版和正式版

api.sendReq(req);

如需要进一步增强安全性，避免userName/path被第三方恶意篡改，可以接入加密方案，参考：开放平台通用加密指南

2、如果你是小程序

使用小程序wx.navigateToMiniProgram(Object object) | 微信开放文档的能力，appId字段传入小游戏的AppID（服务商-游戏库获取），path字段传入参数，示例代码：

wx.navigateToMiniProgram({

  appId: 'wx7c8d593b2c3a7703', // 此处以跳一跳的AppID为例，实际需要从服务商-游戏库里面选择对应游戏的AppID

  path: '?wxgamepro=PkgCBXXXXX', // 此处填入参数

  envVersion: 'release',

  success(res) {

    // 打开成功

  }

})

3、如果你是公众号

1）正文->顶部的“小程序”tab->“去搜索”

2）输入想要推广的小游戏AppID进行搜索（图示以“跳一跳”为例，实际需要从服务商-游戏库选择想要推广的小游戏AppID）

3）小程序路径处填写服务商平台获取到的参数("?"开头那串字符串)，展示方式可以自由选择

4）最终效果如下

4、如果你是PC网站应用

使用网站应用调用 PC 微信能力的能力，userName字段传入小游戏的账号原始ID，path字段传入参数。示例代码：

wxopensdk.launchMiniProgram({
  appid: "网站应用AppID，非小游戏的AppID",

  userName: "需拉起的小游戏的账号原始ID", // 小游戏账号原始ID
  path: "?wxgamepro=CpsCBXXXXX", // 小游戏参数

  ticket: "申请到的 ticket",
  });

5、如果你是其他场景

1）如果可以直接跳转打开小游戏，可以在跳转路径中加入path参数

2）如果无直接跳转路径，可以使用H5跳转能力，在微信服务市场获取H5链接

①点击推广单游戏，选择游戏可生成链接，用户点击 h5 链接跳转，可以直接打开微信跳转对应游戏（二维码同样的效果）

②点击推广游戏列表，选择想添加的游戏并保存配置，用户点击 h5 链接跳转，会跳转到微信，打开游戏列表页