一、快速新增
1.1 应用管理
1、登录WINGSDK后台,在左边导航栏选择设置中的应用管理
2、进入应用管理后,点击“+新增应用”

3、在出现的“添加应用”列表中,填写以下字段

| 参数 | 描述 |
|---|---|
| 应用名称 | 输入应用的名称 |
| 语言 | 输入该应用使用的语言,注:此处的语言选择会影响webview支付的语言展示,且客户端需有相应语言包对应 |
| 图标 | 上传该应用的图标,不大于100KB。 |
| 游戏服务器时区 | 需正确选取,选择后将不可再变更(如游戏尚未上线,可和技术人员联系进行修改),该应用的数据将以此设定的时区为准进行统计。如该地区有时令切换问题,SDK后台将自动切换。 |
4、表单填写后,点击保存,新增App完成。
1.2 应用商店信息

B、点击“应用商店信息”配置游戏的公共参数

安卓:
| 参数 | 描述 |
|---|---|
| 平台应用包名 | 应用的包名 |
| 下载地址 | 应用的下载地址 |
| 参数 | 描述 |
|---|---|
| 平台应用ID | ![]() 格式为:id12345678 |
| BundleID | 同上 |
| Scheme | 非必填,如使用到应用墙或消息推送功能可能涉及。这里填写游戏的scheme,用于别的应用打开该应用时使用,如果没有填写,其他应用无法跳转到该应用。 |
| 下载地址 | 应用的下载地址 |
1.3 参数获取

A:点击“设置”,如图红框中的两个参数“应用ID”和“APPKEY”需配置到游戏中(安卓和iOS用同一套参数)
秘钥用于登录校验,具体见“服务端接口文档→2.1、CP验证用户登录接口→osign参数”
支付秘钥用于支付做校验,具体见“服务端接口文档→3.2、CP发货通知接口→osign参数”

| 参数 | 描述 |
|---|---|
| AppKey | 该字段自动生成,表示游戏客户端和SDK后台校验的秘钥。 |
| 登录秘钥 | 该字段自动生成,表示SDK后台和游戏后台校验的秘钥(校验登录) |
| 支付秘钥 | 该字段自动生成,表示SDK后台和游戏后台校验的秘钥(校验支付) |
注:只有应用管理员可获取以上参数
二、登录功能
新增登录平台后,由于默认状态为“测试”,因此需要添加测试设备,才可进行调试,具体见4.1 测试设备管理
2.1 直接使用SDK已对接的登录方式
1、点击左侧导航栏选择设置中的登录平台,注意:如果需配置Google和Apple登录平台,需先配置“应用管理”→“应用商店信息”
2、进入界面后,点击“新增”按钮

3、在出现的“新增平台信息”中,填写以下字段—由于不同登录平台所需参数不一样,具体在后面详细说明:

| 参数 | 描述 |
|---|---|
| 平台类型 | 选择对应的登录平台 |
| 应用ID | 应用ID在创建App时,系统自动生成,不可变更 |
| 可用状态 | 控制该登录方式能否在此应用中使用。可分别控制不同操作系统的可用状态(Facebook有gameroom可选) |
| 图标 | 该平台的登录图标。此处已有默认的登录图标,也可根据需求自行更换 |
| 额外信息 | 该应用的备注信息 |
Google:
“额外信息”需填入从Google后台获取的clientID,客户端的clientID需要和后台配置的相一致(目前SDK 3.6.1.3版本才需要)

clientID获取方式:http://blog.wing-analytics.com/archives/2783.html#create_web_clientid中的第三步
GUEST:
可用状态:根据实际情况选择开关
展示状态:打开

WINGA(手机/邮箱)
可用状态:根据实际情况选择开关
展示状态:打开

Apple登录
可用状态:根据实际情况选择开关
展示状态:打开

Sign in with Apple
可用状态:根据实际情况选择开关
展示状态:打开

可用状态:根据实际情况选择开关
展示状态:打开

Twitter:
具体获取方式见:http://blog.wing-analytics.com/archives/2391.html#Twitter

4、表单填写后,点击保存,生成App对应登录平台,此时生成的登录平台默认为测试状态(登录平台正式/测试模式的使用见4.2登录平台的正式/测试模式)
5、添加完字段后,点击保存,在该页面上即会生成对应登录平台。
6、可对登录平台进行维护

| 操作 | 描述 |
|---|---|
| 修改 | 对登录平台参数进行更新 |
| 删除 | 删除该平台,此操作不可逆,需谨慎操作 |
Facebook H5&小游戏(Facebook instant game):

Facebook H5应用和Facebook小游戏都需要在后台配置FACEBOOK,保存即可;
需要注意,在应用设置里面:
Facebook H5需要配置Facebook H5应用ID(Facebook后台获取的应用编号)

Facebook 小游戏需要配置Facebook小游戏秘钥(Facebook后台获取的应用秘钥)

ARMORGAMES:
- 填写对应的公钥(从ARMORGAMES后台获取):
- 由于ARMORGAMES 登录方式只在 ARMORGAMES 平台上才能使用,因此建议将展示状态设置为“不展示”,防止在其他平台上打开游戏时会展示该登录方式。
HUAWEI_HMS:
可用状态:根据实际情况选择开关
防沉迷:关闭
展示状态:打开

官网包登录配置
可用状态:根据实际情况选择开关
平台应用ID:从GHG\R2平台获取
展示状态:打开
官网包标识:谷歌包选择’否’,官网包选择’是’


Nowgg登录配置

平台应用ID,即Nowgg登录凭据的ClientId 登录凭证
Qoo登录配置
可用状态:根据实际情况选择开关
展示状态:打开

2.2 应用内登录
使用场景:CP有自己的帐号系统,玩家在用CP的帐号系统登录后,SDK再通过CP的验证接口验证用户的登录信息完成登录流程
1、点击左侧导航栏选择设置中的登录平台

2、平台类型选择“APPSELF”,点击保存

3、点击左侧导航栏选择设置中的应用管理,点击C中的“参数设置”,填写“应用内登录验证地址”


三、支付功能
使用支付功能,需要完成以下所有配置,包括3.1商品管理、3.2支付平台、3.3参数设置里的发货通知地址,且新增支付平台后,由于默认状态为“测试”,因此需要添加测试设备,才可进行调试,具体见4.1 测试设备管理
3.1 商品管理
3.1.1 新增商品
1、选择左边导航栏的商品管理 ,进入界面后,点击新增

2、在出现的列表中,填写以下的字段

| 参数 | 描述 |
|---|---|
| 产品ID | 该ID需与游戏里商品列表保持一致,最好为数字及英文字母,长度不超过15。可先在后台自定义生成后,对应配置到游戏;或在游戏中配置好后,同步到WINGSDK后台 |
| 商品名称 | 填写商品名称,长度不超过15,方便使用人员识别即可 |
| 游戏币数量 | 指该商品对应游戏内虚拟货币的价值。如某商品是4.99 美元充值 100 金币,100金币就是游戏币数量 |
| 商品价格 | 用于在充值中心显示,不影响支付价格 |
| 商品货币 | 默认是USD |
| 商品描述 | 添加对该商品的简单描述-注意,该描述会在某些支付页面出现,因此,添加描述时,最好对应不同语言描述。其中如果用到MOL支付,商品描述需不少于5位字符,且该描述会在MOL界面展示给玩家看,所以最好是填写有意义的信息,比如商品名称 |
3、添加完字段后,点击保存,在该页面上即会生成新商品
4、添加新商品后,可进行维护

| 操作 | 描述 |
|---|---|
| 修改 | 对商品的参数进行修改 |
| 删除 | 删除该商品,此操作不可逆,需谨慎操作 |
5.设置折扣
点击修改后会出现折扣的修改

| 参数 | 描述 |
|---|---|
| 第一笔折扣 | 玩家首次支付该商品时的折扣,WEB支付生效,GOOGLE,APPLE等应用内支付不支持。 |
| 商品折扣 | 该商品的折扣,WEB支付生效,GOOGLE,APPLE等应用内支付不支持。注:页游和充值中心,商品折扣需要和第一笔折扣保持一致。 |
| 折扣适用平台 | 指该商品的折扣在哪些平台生效。。 |
3.1.2 批量新增商品
1、选择左边导航栏的商品管理 ,进入界面后,点击新增

2、在出现的天窗中,选择批量新增

3.下载模板,填写商品信息。
4.在批量新增页面,上传商品文件。
3.2 支付平台
1、选择左边导航栏的支付平台,进入该页面后,点击新增

2、在出现的添加支付平台的页面中,填写以下字段——由于不同支付平台所需参数不一样,具体在后面详细说明。

| 参数 | 描述 |
|---|---|
| 平台 | 选择需要用到的第三方支付渠道 |
| 商家ID | 对应第三方支付平台里的商家ID |
| 秘钥 | 对应第三方支付平台里的秘钥 |
| 版本 | 对应第三方支付平台里的版本信息 |
| 基准货币 | 跟对应第三方支付平台的结算货币 |
| 游戏币种 | 对应第三方支付平台里的游戏货币 |
| 可用状态 | 控制该支付方式能否在此应用中使用。可分别控制不同操作系统的可用状态 |
3、填写完以上信息后,点击保存,即可在该页面新增第三方支付平台,此时生成的支付平台默认为测试状态(支付平台正式/测试模式的使用见4.3支付平台的正式/测试模式)
4、可对第三方支付渠道进行相应维护

| 操作 | 描述 |
|---|---|
| 修改 | 对第三方支付渠道设置的参数进行修改 |
| 国家 | 根据客户端获取的当前IP地址,控制该支付渠道可展示的国家。默认所有可用国家都展示。 例如Google支付是全球可用,假如Google支付的国家只选择了美国,则当客户端获取的IP地址为美国时,才会显示Google支付,如为其他国家则不显示,如果不配置该选择,则所有Google支持的国家都可显示。 |
| 商品 | 对该支付渠道下可售的商品进行管理 |
| 删除 | 删除该支付渠道,此操作不可逆,需谨慎操作 |
5、点击商品,进入商品列表界面,点击新增

6、在出现的“添加商品”列表中,添加以下字段

| 参数 | 描述 |
|---|---|
| 产品ID | 此处可供选择的是在商品管理中添加过的产品 |
| 第三方产品ID | 该产品在此支付渠道下的ID,不同支付渠道对应不同ID。Google和apple的ID必填,其他支付渠道的ID可与产品ID一样,其中Google的商品ID不能超过15位长度 |
| 基准订单金额 | 此商品在基准货币下的金额,以此方便对不同国的货币进行换算 |
Facebook的商品信息除了以上内容外,还可控制“定价策略”及“商品图片”

| 参数 | 描述 |
|---|---|
| 定价策略-动态定价 | 用户支付前Facebook 会到WINGSDK后台查询最新价格进行支付,适合价格变动较大的商品 |
| 定价策略-静态定价 | 当用户第一次购买商品后,商品信息会缓存在Facebook后台,下次用户支付时可以让用户快速购买,提高效率,适合价格稳定商品 |
| 商品图片 | 当前商品图片,会显示在购买窗口,展示给用户 |
填写完成后,点击保存,即可在界面看到新增的产品
也可对该商品进行维护

| 操作 | 描述 |
|---|---|
| 修改 | 对该商品的设置的参数进行修改 |
| 删除 | 删除该商品,此操作不可逆,需谨慎操作 |
Google & Apple
如果需配置Google和Apple支付平台,需先配置“应用管理”→“应用商店信息”。
Google:

| 参数 | 对应支付渠道值 |
|---|---|
| 服务邮箱 | 创建服务账号生成的邮箱 参考 公共项目创建服务账号 |
| 应用名称 | 即google cloud后台使用的公共项目名称。 参考 公共项目创建服务账号中的项目名称 |
| p12证书 | 新应用可忽略 |
| json证书 | json文件 参考 公共项目创建服务账号中的json证书 |
注:若google支付掉单严重,可以开启异常订单自动补单功能。
应用管理->参数设置->客户端

Apple

| 参数 | 描述 |
|---|---|
| 商家ID | appstore后台中的套装 ID,即BundleID,参考下图 |

苹果和第三方支付渠道要测试设备,Google不需要(支付平台正式/测试模式的使用见 4.3支付平台的正式/测试模式)
提醒:游戏在Google和App Store提审时,会对第三方支付渠道有限制,请提审时先关闭第三方支付渠道,以免游戏被下架。
Boacompra

| 参数 | 对应支付渠道值 |
|---|---|
| 商家ID | Boacompra(Store id ) |
| 秘钥 | Boacompra(Secret key ) |
| 项目ID | 在Boacompra后台对应项目的Project Id,通常一个游戏/应用对应一个Project Id |
| 系统类型 | 移动端:指定为移动端页面(只有币种为BRL时可以使用);自动适配:根据当前设备自动适配移动端或电脑端(只有币种为BRL时可以使用);电脑端:指定为电脑端页面(币种不是BRL时只能选择电脑端) |
MOL

MOL的相关参数由对方直接提供,其测试和正式支付环境是两个不同的账号,需联系客服获取和切换。如一个游戏里同时需要使用普通支付和点卡、短代的支付方式,可使用同一套账号。
| 参数 | 对应支付渠道值 |
|---|---|
| 商家ID | Application Code |
| 秘钥 | Secret Key |
| 版本 | API Version |
| 基准货币 | 如是内部项目 ,最好使用USD |
| 渠道 | 选填项,不填默认使用支付墙方式,如选择指定使用的渠道(下图,图片截取MOL官方文档),这里配置对应ChannelId |

MOL_VC(点卡,短代)

相关参数及要求同上
注意:“1美元兑换的游戏币数量”——此处是点卡和短代的支付方式,处理方式有所不同,因此不仅此处需填写兑换游戏币数量,同时需要CP 服务端兼容根据 SDK 发货通知中的gameAmount (游戏币数量)给玩家发货的方式,具体见下
http://blog.wing-analytics.com/archives/335.html#32_CP



Paypal

| 参数 | 对应支付渠道值 |
|---|---|
| 版本 | 204.0 |
| API用户 | apiUser |
| API密码 | apiPwd |
| API签名 | apiSign |
| 收款邮箱 | 申请该配置信息的PayPal账号邮箱 |
| 支付页LOGO地址 | 可选字段,配置后,用户的PayPal支付页会显示配置的商家LOGO |
Xsolla
这种形式是商家确认好价格,玩家按定价付款。

Xsolla,分测试和正式两个阶段,在后台自行切换。
| 参数 | 对应支付渠道值 |
|---|---|
| 商家ID | 商户ID |
| 秘钥 | API Key |
| 项目ID | Project ID |
| 项目秘钥 | Project key |
Xsolla_VC(点卡)
这种形式是商家确定一个购买的比例关系,玩家可根据需要任意金额付款,购买的比例关系需同时在SDK后台和Xsolla后台配置

相关参数及要求同上
服务端兼容处理见MOL_VC
Paymentwall

| 参数 | 对应支付渠道值 |
|---|---|
| 商家ID | Project Key |
| 秘钥 | Secret Key |
| 基准货币 | 跟对应第三方支付平台的结算货币,公司内部游戏选USD |
| 移动设备视图编码 | Widget Code—Paymentwall Mobile |
| 电脑视图编码 | Widget Code—Paymentwall Multi New |
1、Paymentwall后台需注意的配置:需要将签名版本设置为2


2、Project Key和Secret Key的获取

3、编码的获取
点击进入widgets


Unipin

Unipin相关参数一般是直接联系对方获取,分别是GUID和Secretkey。该支付渠道会分为测试和正式两个阶段,如需切换,要直接联系对方客服切换。
| 参数 | 对应支付渠道值 |
|---|---|
| 商家ID | GUID |
| 秘钥 | Secretkey |
| 基准货币 | 必须选IDR |
iPayLink

| 参数 | 对应支付渠道值 |
|---|---|
| 商家ID | 会员号 |
| 版本 | 1.1 |
| 基准货币 | 商品定价的币种 |
| 结算货币 | 跟对应第三方支付平台的结算货币,可选,默认RMB,公司内部选USD |
| 支付类型 | DCC:动态汇率转换,会在付款界面显示两种货币,网站/客户端的交易货币,和持卡人卡本币,持卡人自由选择(公司内部项目选择DCC) EDC:持卡人支付时仅知道商家标价的本地货币价格,在收到账单后才知道本位币的扣款金额 |
| 支付卡种 | 可选,默认全部支持,否则只支持选择的卡种 |
| 网站ID | MPS上配置的域名(api.wingsdk.com) |
| 公钥 | iPayLink后台获取,需最高权限负责人才可获取 |
Codapay
需注意:每个不同的币种需要单独配置一个对应的支付平台。

| 参数 | 对应支付渠道值 |
|---|---|
| 秘钥 | ApI key |
| 支付类型 | 默认使用上图选择,泰国及越南VR支付支付时需注意选择对应类型,并配置游戏币兑换关系 |
Gudang Voucher

| 参数 | 对应支付渠道值 |
|---|---|
| 商家ID | Merchant Id |
| 秘钥 | Merchant Key |
Rixty

Rixty后台例图:

注意:Rixty后台中Rixty Callback Url和Rixty ReturnURL必须填写以下地址:
Rixty Callback Url:https://api.wingsdk.com/sdkapi/v1/pay/rixty/callback.do
Rixty ReturnURL:https://api.wingsdk.com/sdkapi/v1/pay/rixty/return.do
| 参数 | 对应支付渠道值 |
|---|---|
| 商家ID | Application Code |
| 秘钥 | Secret Key |
| 版本 | API Version(目前版本:PAYOUT_V1,后台对应配置值为‘v1’) |
| 渠道 | 目前只支持1和2,默认不填写为2;(1:MOLPoints Wallet,2:Rixty) |
Facebook小游戏支付-INSTANTGAMES

| 参数 | 对应支付渠道值 |
|---|---|
| 秘钥 | 应用秘钥(App Secret) |
| 基准货币 | 商品定价的币种 |
MYCARD

| 参数 | 对应支付渠道值 |
|---|---|
| 商家ID | FacserviceId |
| 秘钥 | key |
HUAWEI_HMS
HUAWEI_HMS

| 参数 | 描述 |
|---|---|
| 商家ID | 项目下某个应用的APP ID |
| 支付私钥 | 项目下某个应用的 OAuth 2.0客户端ID(凭据)-Client Secret |
| 支付公钥 | 支付公钥(我的项目–应用内支付服务) |
| 订单信息站点 | 可不填,默认使用德国站点 |
| 中国站点 | https://orders-drcn.iap.hicloud.com |
| 德国站点 | https://orders-dre.iap.hicloud.com |
| 新加坡站点 | https://orders-dra.iap.hicloud.com |
| 俄罗斯站点 | https://orders-drru.iap.hicloud.com |
PAGSMILE
PAGSMILE

| 参数 | 对应支付渠道值 |
|---|---|
| 商家ID | APP ID |
| 私钥 | security key |
LATAMGATEWAY_PICPAY
LATAMGATEWAY_PICPAY

| 参数 | 对应支付渠道值 |
|---|---|
| 商家ID | User |
| 私钥 | Password |
LATAMGATEWAY_PIX
LATAMGATEWAY_PIX

| 参数 | 对应支付渠道值 |
|---|---|
| 商家ID | User |
| 私钥 | Password |
充值中心
充值中心
1)新增”充值中心”支付平台


2)开启充值中心的支付渠道
点击修改

使用默认,或按需开启支付渠道

SDK沙盒支付
注:使用沙盒支付需要安卓sdk版本4.5.0以上
添加沙盒支付平台

| 参数 | 对应支付渠道值 |
|---|---|
| IP白名单 | 公网IP地址 |
Nowgg

| 参数 | 对应支付渠道值 |
|---|---|
| 秘钥 | 支付验证API密钥 |
雷电

| 参数 | 对应支付渠道值 |
|---|---|
| 商家ID | 雷电的APP_ID |
| 秘钥 | 雷电的ServiceKey |
QOOAPP

| 参数 | 对应支付渠道值 |
|---|---|
| 商家ID | APP ID |
| 公钥 | publicKey |
Aghanim

| 参数 | 对应支付渠道值 |
|---|---|
| 商家ID | APP ID |
| 密钥 | webhook 中的 Secret Key |
| API KEY | API密钥中的 S2S Key |
3.3 支付商品添加
1、在支付平台列表选择具体的支付渠道点击“商品”

2.选择“新增”

3.可选择手动新增或者批量导入


3.4 参数设置里的发货通知地址
1、点击左侧导航栏选择设置中的应用管理,点击C中的“参数设置”,填写“发货通知地址”


3.6 官网包支付方式配置
配置web方式的支付渠道,例如:paypal,xsolla等,选择具体的支付渠道后,可使用默认配置
配置入口在 WingSDK后台->支付平台->新增
注:使用默认配置后,需要根据游戏修改币种

四、登录/支付平台测试模式的使用
4.1测试设备管理
测试过程中,如涉及到沙盒支付和debug模式的控制,则需要添加测试设备
注:需对接SDK 3.6及以上的版本才可通过后台控制是否开启debug模式
1、选择左边导航栏的“测试设备”,进入界面后,点击新增

2、出现“新增测试设备“列表,添加以下参数

A:设备标识:“client id”——添加了的设备为测试设备
B:沙盒环境:是——开启沙盒模式,该设备可以进行沙盒测试
否——关闭沙盒模式,该设备不能进行沙盒测试,只能进行正式购买
备注:支持沙盒模式开关控制的支付渠道包括除Google 外的所有支付渠道
3、点击“搜索”获取设备标识

可输入其中一种手机标识,点击“查询”,在出现的设备中,点击“选择”,即可

4、点击“保存”即可生成测试设备

4.2登录平台的正式/测试模式
在游戏正常运作的过程中,如果需要新增登录平台,可通过以下的方式,在SDK后台将新增未通过测试的平台和正式运行的平台隔离开。
该功能需要登录平台和测试设备模块同时使用
登录平台涉及的状态:
1、测试状态:测试设备可以看到该登录平台,并登录; 对其他设备(即正式玩家)不开放。
2、正式状态:对所有玩家正式开放。 其中从测试状态转为正式状态时,系统会检查该登录平台下是否有登录成功的记录,否则不允许转为正式。
3、禁用状态:将登录平台关闭,不对任何玩家开放。
测试模式的使用
1、按照登录平台指引新增一个平台后,该平台默认为测试状态

2、在测试设备模块进行配置
1)在测试设备页面,点击新增,出现“新增测试设备“列表,添加以下参数,该功能使用说明见“测试设备管理”

A:设备标识:“client id”——添加了的设备为测试设备
B:沙盒环境:只与支付平台有关,此处根据支付平台实际情况选择
正式模式的使用
1、登录平台测试通过后,可转换为正式状态


2、测试设备页面无需做改动
4.3支付平台的正式/测试模式
在游戏正常运作的过程中,如果需要新增支付平台,可通过以下的方式,在SDK后台将新增未通过测试的平台和正式运行的平台隔离开。
该功能需要支付平台和测试设备模块同时使用
支付平台涉及的状态:
1、测试状态:测试设备可以看到该支付平台,并进行沙盒支付; 对其他设备(即正式玩家)不开放。
2、正式状态:对所有玩家正式开放。 其中从测试状态转为正式状态时,系统会检查该支付平台下是否有支付成功的记录,否则不允许转为正式。
3、禁用状态:将支付平台关闭,不对任何玩家开放。
测试模式的使用
1、按照支付平台指引新增一个平台后,该平台默认为测试状态

2、在测试设备模块进行配置
1)在测试设备页面,点击新增,出现“新增测试设备“列表,添加以下参数,该功能使用说明见“测试设备管理”

A:设备标识:“client id”——添加了的设备为测试设备
B:沙盒环境:是——开启沙盒模式,该设备可以进行沙盒测试
否——关闭沙盒模式,该设备不能进行沙盒测试,只能进行正式购买
此处选“是”,进入沙盒模式
备注:支持沙盒模式开关控制的支付渠道包括除Google外的所有支付渠道
正式模式的使用
1、支付平台测试通过后,可转换为正式状态

2、进入测试设备页面,将沙盒模式转换为“否”

五、高级设置
5.1 服务器管理——用于分服看数据
1、选择导航栏左边的服务器管理,进入界面后,点击新增

2、出现“新增服务器“列表,添加以下参数

| 参数 | 描述 |
|---|---|
| 游戏区ID | 添加游戏后台对应的游戏区ID |
| 游戏区名 | 添加游戏后台对应的游戏区名 |
| 状态 | 控制该游戏区的使用状态,启用/禁用 |
| 备注 | 对该游戏区进行简要说明 |
3、填写完以上参数后,点击保存,即可在该界面看到新增的游戏区
4、可对该游戏区进行维护

| 操作 | 描述 |
|---|---|
| 修改 | 对该游戏区的参数进行修改 |
| 删除 | 删除该游戏区,此操作不可逆,需谨慎操作 |
5、可对“游戏区ID”,“游戏区名”,“状态”进行筛选
| 筛选类型 | 作用 |
|---|---|
| 游戏区ID | 根据游戏区ID,快速筛选出对应的游戏区 |
| 游戏区名 | 根据游戏区名,快速筛选出对应的游戏区 |
| 状态 | 快速筛选出所有处于启用或禁用状态的游戏区 |
5.2 参数设置
1、点击进入应用管理页面

C:点击“参数设置”,如有用到相应功能,请设置对应参数

| 参数 | 描述 |
|---|---|
| 邀请奖励物品类型 | 如果使用了SDK的社交(目前有Facebook和VK)邀请事件奖励接口,则需填写奖励的物品。物品可有多项,用“,”分割 |
| 客户端FB 安全秘钥 | 如果需要在Facebook后台进行礼物相关配置,则需填写Facebook的app secret |
| 新建账户 | 账户管理页面中,SDK3.5.2版本之后可在后台控制是否出现“新建账户”的按钮。默认为开 |
| 切换账户 | 账户管理页面中,SDK3.5.2版本之后可在后台控制是否出现“切换账户”的按钮。默认为开 |

| 参数 | 描述 |
|---|---|
| 发货通知地址 | 发货通知地址,在支付成功后用来通知CP进行发货 |
| 游戏角色类型名称 | 该参数主要用于“等级分布”模块。由于游戏传回SDK后台的角色类型值的可读性不确定,如传回数字,此时可通过设置该参数,明确角色,详解如下。游戏角色可有多个,用“#”号分割。例如,游戏传回SDK后台的角色类型是1,2,则可以设置“1=骑士#2=法师” |
| 邀请奖励发货通知地址 | 如果使用了SDK的社交(目前有Facebook和VK)邀请事件奖励接口,则需填写通知奖励发放的地址 |
| 应用内登录验证地址 | 应用内登录的回调地址,用以校验CP 使用应用内登录时的token是否合法,并获取对应的user ID |
| 玩家退款通知地址 | SDK后台定时到Google退款通知接口查询最近30天是否有退款订单,如有则会通过该地址通知CP,后续处理则CP自行跟进 |
| 用户隐私协议地址 | 隐私协议地址,如果配置,则SDK 会在玩家登录时弹出提示,要求玩家同意,并展示对应的协议地址链接。 注意:如果修改了该地址并希望玩家强制看到,需点击刷新按钮,并保存。 |
详解:在未配置“游戏角色类型名称”的情况下,“等级分布”的标识为“_unknown”,如配置“_unknown=骑士”,则此处会显示“骑士”

5.3 充值补单
如果游戏在运营过程中出现掉单的情况,需要通过该功能进行补单。该过程需要有财务及运营APM进行审核,具体操作过程如下:
1、根据玩家提供的订单信息,包括UID、所在区服、充值金额等信息,在充值查询页面找一笔该用户相同金额、状态不是成功(支付中、取消购买)的订单

2、根据找到的订单信息,选择左边导航栏的充值补单,进入界面后,点击新增

3、出现“新增补单“列表,添加以下参数

以下信息可在“用户行为分析”的“充值查询”中获取
| 参数 | 描述 |
|---|---|
| 选择服务器 | 选择需补单的订单号所在的服务器 |
| 订单号 | 填写需补单的订单号 |
| 用户ID | 此处会根据服务器和订单号,自动识别生成 |
| 商品 | 此处会根据服务器和订单号,自动识别生成 |
| 交易流水号 | 填写需补单的交易流水号 |
| 支付币种 | 支付时使用的币种 |
| 支付金额 | 支付的金额 |
| 支付时间 | 充值的时间 |
| 备注 | 对该订单信息进行简单说明 |
4、填写完以上参数后,点击保存,即可在该界面看到新增的订单信息。此时该订单将提交财务做第一次审核,如图可见提示当前审核角色为财务:


5、财务审核完后,如果“通过”,则该订单提交下一审核人“运营APM”,如“拒绝”,则该订单结束。
6、如财务点击“通过”,此时订单提交“运营APM”审核。


7、运营APM操作后,该补单流程结束。


5.4 APP货币汇率管理(可直接使用实时汇率,也可手动维护)
此页面中展示的货币汇率均为雅虎API获取,每日自动更新,也可手动自行维护。该汇率主要用于数据统计。目前SDK后台有关充值数据的展示币种都是美金,但在实际充值中会出现各国的货币,因此需要根据此处的汇率进行转换。
如需手动维护,操作如下:
1、选择左边导航栏的APP货币汇率管理,进入界面后,点击修改

2、将所需要的汇率(最多显示到小数点后8位)填入方框中,点击“保存”

3、主界面中手动维护的货币将会有“修改”,“删除”两种操作

4、如果之后不再希望手动维护汇率,而使用自动更新,点击“删除”即可。
5.5 应用事件管理
该页面主要用于添加自定义事件,并在推广效果展示。
1、选择左边导航栏的“应用事件管理”,进入界面后,点击新增

2、出现“新增应用事件“列表,添加以下参数

| 参数 | 描述 |
|---|---|
| 事件名 | 自定义事件名称 |
| GHW事件 | 自定义事件应用中埋点的事件名,必须以“ghw_self_”开头,例如ghw_self_lv23 |
| AppsFlyer事件名 | 根据AF的规则自定义事件名,非必填项 |
| 类型 | 推广统计事件:应用中的自定义事件 Facebook邀请奖励事件:应用中Facebook里的邀请奖励事件 VK邀请奖励事件:应用中VK里的邀请奖励事件 |
| 备注 | 对该自定义事件添加说明 |
5.6 页游推广渠道管理
该页面主要用于为页游推广添加对应推广渠道、生成推广链接。
5.6.1. 新增推广渠道:(注意:推广平台选择后不可更改)

5.6.2. 根据所选择的推广渠道生成对应推广链接:

5.7 充值中心管理
5.7.1、充值中心弹窗配置
1)点开充值中心配置

2)开启用户中心CharacterID 模式, 订单是否统计到手游改成 统计。

注意:旧的商品需要在商品配置中配置商品价格。
5.8 SDK推送配置
5.8.1、新建消息
1)“设置”→“消息推送”,点击“新建消息”,出现“添加推送消息”列表,填写以下参数

具体参数描述如下表
| 参数 | 描述 |
|---|---|
| 标 题 | 推送给用户的消息标题 |
| 内容 | 推送给用户的消息内容 |
| 消息类型 | 目前只有文本形式 |
| 动作类型 | 唤醒、召回、推新 备注:唤醒的是本应用,因此需要为本应用进行推送配置 |
| 平台 | Android或iOS |
| 应用 | 用于筛选目标受众的应用,同时需为这些用于推送的应用进行推送配置(唤醒操作时无此选项) |
| 受众过滤 | 国家:推送用户所在国家 充值金额范围:推送用户在该游戏中充值总额,可只填一个输入框,表示大于等于或小于等于(币种:美金)最后登录时间范围:推送用户最后登录该游戏的时间 可只填一个输入框,表示大于等于或小于等于注意:如果是唤醒和召回操作,是以当前应用的用户进行过滤;如果是推新操作,是以所选应用的用户为种子用户进行过滤 |
| 营销ID | 该消息属于的营销分类,可用数字和字母命名 |
| 跳转链接 | 默认展示Android/iOS对应的官方市场下载链接(即应用商店信息的地址),也可选择“URL”,填写自定义地址跳转官网/其他应用市场等(唤醒操作时无此选项) |
| 提醒类型 | 目前iOS只有声音提醒。Android机有些没有三色灯,且Android机声音和震动有些会受到系统设置干扰 |
| 推送时机 | 立即推送:保存选项后,在主页面点击“开始推送”,消息推送立即执行指定时间推送:保存选项后,在主页面点击“开始推送”,消息会在指定的时间内推送 |
| 推送时间 | 在所选的指定时间内将消息推送到苹果/Google的服务器 |
2)点击“保存”,新增一条推送的消息。根据预受众用户数情况,在“操作”一栏“修改”受众的过滤条件,达到筛选目标
3)点击“开始推送”,正式推送消息。如推送时机是“立即推送”,数据处理完成后即开始推送,如推送时机是“指定时间推送”,消息会在指定的时间内推送。
SDK集成的第三方SDK如下表:
| 参数 | 描述 |
|---|---|
| 状态 | 草稿:未点击“开始推送”,可修改筛选条件状态 准备计算受众:已点击“开始推送”, 受众计算任务等待执行中 计算受众中:受众计算任务进行中 受众计算完成:受众计算任务已完成并等 推送开始 推送中:推送进行中 推送完成:推送已完成 已废弃:点击“停止该推送”后状态,未完成的消息将停止发送,已经推送的消息不受影响,推送情况在数据表中显示 备注:点击“开始推送”后,即进入“准备计算受众”状态,如要关注目前的推送情况,需刷新该页面,否则状态会维持不变 |
| 操作 | 消息未发送: 修改——在点击“开始推送”前,可修改推送的筛选条件,以满足目标需求 开始推送——开始执行消息推送。需点击该按钮后,消息推送才正式启动 停止该推送——该条消息推送停止 无论是否完成推送 消息发送后:查看——查看消息推送的设置内容。 |
5.8.2、推送配置
1、选择左边导航栏的“消息推送”,进入界面后,点击 “推送配置”


如向iOS用户推送,需配置APNS证书和APNS秘钥,获取方式见:配置APNS证书和APNS秘钥
如向安卓用户推送,需配置FireBase证书,获取方式见:配置FireBase证书
注:如果要使用接口来推送,需要配置CP服务器的IP到白名单中。
注:安卓证书名称示例:xxxx-firebase-adminsdk-ef18j-b47abfdd21.json
注:IOS证书名称示例:push_dev.p12或者push_dis.p12。
5.9 商品手动消耗
目前支持谷歌、IOS
设置->支付平台->消耗

输入userId,选择商品后点击保存

5.10 FB小游戏广告
配置FB小游戏的广告ID
设置->应用管理->应用参数管理->FB小游戏广告ID


5.11 账号注销
账号注销入口:设置->应用管理->账号注销参数管理

1)客户端配置
可在此处开启账号注销

2)服务端配置
注:只有ios配置

苹果应用私钥:即和苹果服务端验证signinwithapple 的私钥
应该应用私钥标识:即和苹果服务端验证signinwithapple 的私钥文件的Key ID
苹果账号TeamId :即开发者账号的Team ID
配置苹果账号注销接口所需参数(苹果应用私钥、私钥标识、苹果账号TeamId),获取方式参考:Sign in with Apple账号删除参数获取
5.12 配置查询区服角色地址
登录wingsdk应用后台,应用-参数设置-服务端-获取区服角色地址,填写对应的查询区服角色地址。

5.13 admob广告功能开启
进入 广告 > AdMob管理
5.13.1 配置激励广告发货地址
1)点击”奖励通知接口配置”
2)填入”奖励通知接口”(此接口由CP提供)
3)点击保存

5.13.2 配置广告单元
1)点击”新增”
2)选择”广告类型”
3)填入广告所需要的信息
| 参数 | 描述 |
|---|---|
| 广告名称 | 广告名称,由运营或市场定义,可定义成具体意义的名称,见文知意,便于CP对接。例如: 1)奖励100金币,可命名成: reward_gold_100 2)死亡复活奖励,可命名成:death_resurrection |
| 广告单元ID | 可从Admob管理后台获取(不需要提供给cp) |
| 奖励物品ID | 可从Admob管理后台获取 |
| 奖励物品数量 | 可从Admob管理后台获取 |
4)选择状态为”测试”
5)点击保存

5.14 官网平台
官网平台参数管理 所在的位置如下:

5.14.1 账号互通配置
在官网包的”官网平台参数管理”->”服务端”->”GHG/R2官网包应用互通配置”填入谷歌包的sdk appid

5.14.2 官网礼包配置
1)在官网包的”官网平台参数管理”->”服务端”->”CP礼包通知接口”填入游戏研发提供的礼包发货接口

2)设置官网平台类型

3)填写官网平台的游戏id,由GHG/R2提供

4)配置礼包浮窗累计登录多少天弹出。配置1标识直接显示,-1表示关闭

注:安卓WINGSDK 4.6.0及以上版本,使用’浮窗总开关来控制’

选择开启后,会提示是否生成默认规则,谷歌包选择’确认’,官网包选择’取消’

5)浮窗按钮完整展示控制,当对按钮操作后,才会靠边收起并变半透明显示,操作指移动或点击按钮打开浮窗页。
关闭 (默认靠边收起并半透明显示)
设备首次 (只在设备首次打开时才会完整显示)
每天首次 (每天首次进入游戏都会完整显示)

6)浮窗页自动弹出,当浮窗按钮启用时,进入游戏获取到角色信息后,每天自动打开浮窗1次,自动打开的浮窗,5秒无操作则自动关闭
关闭 (不会自动打开)
启用 (每天自动打开1次)

7)刷新浮窗页面状态,后台可刷新玩家“下次不再提醒”状态,让自动打开生效,用来强制弹出重要信息
关闭 (不会自动打开)
启用 (每天自动打开1次)

8)浮窗方向控制(横屏游戏),只对横屏游戏生效。默认竖屏打开浮窗,可以通过控制来切换横屏打开浮窗

5.15 配置App secret(FB 应用密钥)
登录wingsdk应用后台,应用-参数设置-服务端-FB应用密钥,填写对应的App secret(FB 应用密钥)

5.16 AIHELP开启
使用AIHELP客服系统需在SDK管理后台开启
位置:应用->客服参数管理->aihelp appid (安卓/iOS) 和 aihelp domain
![WEV[(_QT[O(U%K]V$J$)JAD](http://blog.wing-analytics.com/wp-content/uploads/2019/05/WEV_QTOUKVJJAD.png)

1)SDK客服开关–>开启
2)aihelp客服入口id –> 非必填
3)aihelp appId (安卓) –> 必填项,填入安卓的aihelp appid
4)aihelp appId (IOS) –> 必填项,填入IOS的aihelp appid
5)aihelp domain –> 必填项,填入aihelp domain
5.17 Consent开启
登录wingsdk应用后台,应用-参数设置-客户端-Consent开关,选择开启

5.18 关键等级配置
登录wingsdk应用后台,应用-参数设置-客户端-关键等级(纯数字,多个等级使用英文逗号分隔)

5.19 预注册商品添加及配置
1、在WingSDK管理后台,增加预注册商品,像正常的商品那边配置,“商品配置参考”。注意:预注册商品在wingsdk后台价格不能配置为0
2、在WingSDK管理后台,配置预注册商品ID。位置:设置-参数配置-服务端-预注册商品ID(参照下图)
注意:通过礼包接口通知发放预注册奖励时, 礼包ID对应预注册商品的 “产品 ID”


5.20 预注册奖励通知方式
登录wingsdk应用后台,应用-参数设置-服务端-预注册奖励通知方式,进行发货通知选择
5.21 iOS 互推广告开关
登录wingsdk应用后台,应用-设置-官网平台参数管理-iOS互推广告开关,设置为打开


5.22 邀请活动管理
5.22.1 邀请参数配置
配置入口:”邀请活动管理”->”邀请活动”->”邀请参数配置”

| 配置项 | 参数说明 |
|---|---|
| AppsFlyer模板ID | 此项为空则表示关闭邀请功能。模板ID获取参考 https://blog.wing-analytics.com/archives/2783.html#aftempId |
| 渠道 | 被邀请者的归因渠道(wing_invite) |
| 活动名称 | 被邀请者的归因活动 |
| 被邀请者上报时机 | 根据事件名称触发,目前支持”完成新手任务”时触发上报 |
| 系统邀请活动标题 | 系统邀请时,可根据此项生成标题 |
| 邀请活动文案 | 邀请时,根据此项生成默认文案(建议末尾加两个空格) |
| 邀请奖励服务端通知链接 | 使用服务端发奖时填写,需CP提供地址 |
| 触发邀请奖励服务端通知人数 | 使用服务端发奖时填写,每分享X人通知一次。填0则关闭此功能 |
5.23 FB特殊权限配置
配置项在”应用管理”->”参数设置”->”客户端”,可根据此配置觉得是否申请获取玩家的FB邮箱的权限。


5.24 子母包创建
5.24.1 创建母包
新建应用时,”选择母包”处选择’创建母包’

5.24.2 创建子包
新建应用时,”选择母包”处选择对应的母包



