diff --git a/inner/README.md b/inner/README.md index 5dea247..23e025e 100644 --- a/inner/README.md +++ b/inner/README.md @@ -14,11 +14,13 @@ PCSDK上报小游戏用户所触发的各种行为数据到噗嗤管理后台, # 噗嗤管理后台 -噗嗤管理后台对sdk中上报的各项数据进行分析;管理sdk中所需要的配置信息:分享/视频配置、配置参数(在线参数配置)、交叉推广位配置、用户自定义事件配置。 +噗嗤管理后台对sdk中上报的各项数据进行分析,管理sdk中所需要的配置信息:分享/视频配置、配置参数(在线参数配置)、交叉推广位配置、用户自定义事件配置。 -噗嗤管理后台地址: +噗嗤管理后台地址:方便开发者联调测试阶段不影响上线游戏运营相关数据或者配置信息,{% em %}注意:开发者需在游戏客户端维护一个版本号version,作为[PCSDK.game模块的env](game.md#env) api的参数传递;第一次接入设置version为1.0,此时API跑的是测试环境,游戏提审通过发布上线后,1.0则会被后端切为正式服地址,用于线上游戏运行,1.1则被后端改成测试服地址,方便开发者进行新的版本功能迭代,请客户端版本号加0.1,改成1.1,依次类推,每个版本上线后开发者都要对version加上0.1。{% endem %} -- https://data.d3games.com/#/login +> 测试环境各种配置管理、数据分析查看,请[前往测试服后台](http://pre-data.d3games.com/#/login) + +> 正式环境各种配置管理、数据分析查看,请[前往正式服后台](https://data.d3games.com/#/login) **友情提示:** @@ -27,7 +29,6 @@ PCSDK上报小游戏用户所触发的各种行为数据到噗嗤管理后台, - **登录后台即可使用后台提供的各项服务** - **后台概览:** ## ![sdk文件目录结构](https://dep.miso-lab.com/sdkword/sdk_006.png "🔍点击查看大图") @@ -42,10 +43,10 @@ PCSDK上报小游戏用户所触发的各种行为数据到噗嗤管理后台, -**后台提供配置相关功能(不能跳转请联系管理员添加权限):** +**后台提供配置相关功能,开发者去测试后台配置,提审后让相关人员同步测试配置到正式配置(不能跳转请联系管理员添加权限):** -- [分享/视频配置](https://data.d3games.com/index.html#/share_list) -- [配置参数](https://data.d3games.com/index.html#/config_list) +- [分享/视频配置](http://pre-data.d3games.com/index.html#/share_list) +- [配置参数](http://pre-data.d3games.com/index.html#/config_list) # 更多: diff --git a/inner/book.json b/inner/book.json index 5b8b71e..9837532 100644 --- a/inner/book.json +++ b/inner/book.json @@ -39,12 +39,12 @@ "versions": { "options": [ { - "value": "http://dep.miso-lab.com/sdkword/web/v1.0/intro.html", - "text": "外部游戏-v1.0.0.3" - }, - { "value": "http://dep.miso-lab.com/sdkword/web/v2.0/intro.html", "text": "内部游戏-v1.0.0.3" + }, + { + "value": "http://dep.miso-lab.com/sdkword/web/v1.0/intro.html", + "text": "外部游戏-v1.0.0.3" } ] }, diff --git a/inner/download.md b/inner/download.md index 0004689..beac95d 100644 --- a/inner/download.md +++ b/inner/download.md @@ -2,7 +2,7 @@ ------ -## [v1.0.0.3 下载](https://dep.miso-lab.com/sdkword/versions/sdk-out-v1.0.0.3.zip) +## [v1.0.0.3 下载](https://dep.miso-lab.com/sdkword/versions/sdk-in-v1.0.0.3.zip) > *发布时间*:2019.09.18 @@ -12,7 +12,7 @@ 2. 微信小游戏引入GameIcon、GameBanner、GamePortal组件。 3. config.js添加积分投放IntegralChannelId参数,用于积分投放渠道统计。 -## [v1.0.0.2 下载](https://dep.miso-lab.com/sdkword/versions/sdk-out-v1.0.0.2.zip) +## [v1.0.0.2 下载](https://dep.miso-lab.com/sdkword/versions/sdk-in-v1.0.0.2.zip) > *发布时间*:2019.09.11 @@ -25,7 +25,7 @@ 1. 外部游戏修改setLogind接口为setLoginInfo( { openId: strinng , retTime: number } )。 2. loadingFinish传递isActive参数,isActive为true SDK在loadingFinish结束后自动调用active。 -## [v1.0.0.1 下载](https://dep.miso-lab.com/sdkword/versions/sdk-out-v1.0.0.1.zip) +## [v1.0.0.1 下载](https://dep.miso-lab.com/sdkword/versions/sdk-in-v1.0.0.1.zip) > *发布时间*:2019.09.04 diff --git a/inner/inner/README.md b/inner/inner/README.md deleted file mode 100644 index 89665db..0000000 --- a/inner/inner/README.md +++ /dev/null @@ -1,64 +0,0 @@ -# 噗嗤SDK -PCSDK(噗嗤SDK)是一款封装了微信小游戏、QQ小游戏平台常用api接口和用户行为数据上报的一款产品。 -PCSDK上报小游戏用户所触发的各种行为数据到噗嗤管理后台,后台对数据统计分析后以多样化的方式展现数据。 - -**PCSDK提供的模块功能:** - -- [统计模块](stat.md) -- [分享视频模块](share.md) -- [配置参数模块️](online.md) -- [多平台接口模块](platform.md) -- [数据模块](data.md) -- [事件模块](event.md) - - - -# 噗嗤管理后台 -噗嗤管理后台对sdk中上报的各项数据进行分析;管理sdk中所需要的配置信息:分享/视频配置、配置参数(在线参数配置)、交叉推广位配置、用户自定义事件配置。 - -方便开发者联调测试阶段不影响上线游戏运营相关数据或者配置信息,config.js的Env配置提供测试和正式环境切换。 - -> 测试环境各种配置管理、数据分析查看,请[前往测试服后台](http://pre-data.d3games.com/#/login) - -> 正式环境各种配置管理、数据分析查看,请[前往正式服后台](https://data.d3games.com/#/login) - -噗嗤管理后台地址: - -- 测试服后台,地址:http://pre-data.d3games.com/#/login - -- 正式服后台,地址:https://data.d3games.com/#/login - -**友情提示:** - -- **之后文档中'后台'指的是[噗嗤管理后台],而不是微信小程序/小游戏后台。** -- **后台登录账号获取:需提供手机信息给我方运营,运营创建后台登录账号、密码后提供反馈。** -- **登录后台即可使用后台提供的各项服务** - - - -**后台概览:** -## ![sdk文件目录结构](https://dep.miso-lab.com/sdkword/sdk_006.png "🔍点击查看大图") - - - -**后台提供数据分析功能(不能跳转请联系管理员添加权限):** - -- [注册/活跃用户,在线时长实时数据分析](https://data.d3games.com/index.html#/view_chart) -- [分享数据分析](https://data.d3games.com/index.html#/share_exact) -- [用户事件行为分析](https://data.d3games.com/index.html#/dot_list) -- [渠道数据统计分析](https//data.d3games.com/index.html#/channel_stat_list) - - - -**后台提供配置相关功能(不能跳转请联系管理员添加权限):** - -- [分享/视频配置](http://pre-data.d3games.com/index.html#/share_list) -- [配置参数](http://pre-data.d3games.com/index.html#/config_list) - - -# 更多: -- 快速接入,请详读 [安装步骤](install.md) - - - -- 遇到问题可以查看 [FAQ](faq.md) \ No newline at end of file diff --git a/inner/inner/install.md b/inner/inner/install.md deleted file mode 100644 index 37cb60f..0000000 --- a/inner/inner/install.md +++ /dev/null @@ -1,233 +0,0 @@ -# 安装步骤 - ------- - -## SDK下载 - -1. 下载最新版本的SDK [SDK下载](download.md) 。 -2. 解压下载的sdk-out-v{版本号}.zip包,解压文件夹里面的的目录结构: - -``` -├── sdk.d.ts -├── sdk/ -| ├── config.js -| └── index.js -| └── libs/ - | └── game.min.js -``` - -![sdk文件目录结构](https://dep.miso-lab.com/sdkword/sdk_001.png "🔍点击查看大图") - -- **sdk.d.ts:sdk的ts声明文件,开发者项目采用Typescript开发,请复制该文件到项目中。** -- sdk/config.js:sdk配置文件,【[详细请阅读下方config.js参数说明](install.md#config)】 -- sdk/index.js:sdk入口文件,引入了sdk所提供的模块功能 -- sdk/libs/game.min.js:sdk类库核心代码文件 - - - -## 配置合法域名 - -* ##### 管理员或开发者身份在微信小程序后台→设置→开发者设置中添加 request、download合法域名 - 测试环境 request 合法域名: - - https://pre-dataapi.d3games.com (统计平台测试服域名) - - 正式环境 request 合法域名: - - https://dataapi.d3games.com (统计平台正式服域名) - - cdn资源请求合法域名: - - https://dep.miso-lab.com (>>>request、download均要添加<<<) - - - - - -​ -## SDK配置步骤 - -* #### 将下载下来的sdk压缩包,解压后,拷贝sdk文件夹到微信开发者工具项目中。 - - 示例:将sdk放入到小游戏开发者工具项目的src文件夹中 - - ![引入目录](https://dep.miso-lab.com/sdkword/sdk_002.png "🔍点击查看大图") - - - - - -* #### 在game.js中将sdk.js文件使用require导入。 - - 示例:将sdk放入到小游戏开发者工具项目的src文件夹中 - ![引入目录](https://dep.miso-lab.com/sdkword/sdk_003.png "🔍点击查看大图") - - - - -* #### 根据运营提供的信息修改sdk文件夹下的**config**.js文件(可横向拖动查看查看更多====>)
- - ```javascript - export default { - IsDebug: false, // 是否debug模式,debug模式会打印log,可使用stat模块setDebug api进行修改 - Env: 100, // 100表示正式环境,110表示测试环境,推荐测试联调阶段使用110,提审前切记改成100!!! - AdCacheDuration: 30, // 广告列表缓存持续时间间隔 - IsUseShareModule: true, // 是否使用分享模块 - IsOnlineAutoUse: true, // 是否开启sdk自动请求online模块(在线参数配置)的updateOnlineConfig,拉取在线参数配置 - IsOnlineDebug: true, // 是否开启online模块(配置参数模块)debug模式 - ShareRightKey: 'forward', // 右上角分享的shareKey,shareKey请阅读share模块说明,默认为forward,为空字符串则不使用右上角分享 - - ShareData: { // 必填,默认分享数据(拉取不到分享配置后使用,默认分享,SDK自动分配share_id为99999) - share_desc: 'xxx', - share_wxad_id: '', // 可选,视频广告uid,配置此参数,拉取不到对应的shareKey,推送看视频,不配置或者配置的uid无效则推送分享 - share_icon: 'xxx' - }, - GameId: 0, // 必填,游戏ID,运营提供; - ChannelId: 0, // 必填,游戏渠道ID,运营提供; - Secret: '***请配置你的Secret***', // 必填,游戏的secret key - MidasPay: { // 米大师虚拟支付配置 - OfferId: "0", // 在米大师申请的应用id - ZoneId: "1", // 分区ID,默认:1 - Mode: "game", // 支付的类型,不同的支付类型有各自额外要传的附加参数,默认:game - CurrencyType: "CNY", // 币种,默认:CNY - Platform: '' // 申请接入时的平台,platform与应用id有关。默认:android(ios暂时没有开放,这里需要配置Platform,开放后,删掉此配置,sdk已经判断平台) - } -}; - ``` - - - 参数详解: - -
-1. **Env ( number ):**SDK执行环境,建议开发者测试联调阶段设为110。 - - > 提审阶段一定要设为100 - - > 测试环境各种配置管理、数据分析查看,请[前往测试服后台](http://pre-data.d3games.com/#/login) - - > 正式环境各种配置管理、数据分析查看,请[前往正式服后台](https://data.d3games.com/#/login) - - 100:正式环境,请求api域名地址为:https://dataapi.d3games.com - - 110:测试环境,请求api域名地址为:https://pre-dataapi.d3games.com - -2. **IsDebug ( boolean ):**是否debug模式,debug模式会打印sdk中的console.log/error/warn log。 - - false:关闭log打印,提审前建议设置为false,不打印log信息 - - true:开启log打印,如遇到联调问题,可设置为true,发体验版本或者查看log发给相关人员进行查看解决问题 - - 也可在代码中动态设置:PCSDK.stat.setDebug( boolean ) - -3. **AdCacheDuration(number):**表示获取广告位列表的缓存时间,例如:配置30,SDK中拉取交叉推广位列表后缓存30秒。此参数对接入交叉推广位模块后有效,没有接入可不修改,使用默认值。 - -4. **IsUseShareModule( boolean ):**是否启用sdk分享/视频功能(sdk把分享和视频封装为share模块,登录后台->【游戏数据】->【配置相关】->【分享/视频配置】后可对分享视频进行动态配置) - - false:SDK启动时不拉取分享/视频列表,不接入分享/视频模块功能 - - true:SDK启动时拉取后台配置的分享/视频列表,运营或者开发者登录后台后,配置分享/视频,开发者请详看分享视频模块接入。 - -5. **IsOnlineAutoUse( boolean ):**是否启用在线配置参数模块功能 - - false:两种处理 1)不启用在线配置参数模块功能; 2)启用在线配置参数功能,但是SDK启动时不自动调用updateOnlineConfig拉取后台配置参数列表,开发者在代码主动调用拉取在线配置参数:PCSDK.online.updateOnlineConfig(); - - 示例:开发者代码中主动拉取在线配置参数。 - - ```javascript - // 后台 ->【游戏数据】->【配置参数】栏配置了:是否显示微信插屏广告、交叉推广位是否展示动态开关 - PCSDK.online.updateOnlineConfig().then(() => { - // 获取是否后台动态配置开启插屏广告,1为开启,0为关闭 - let isInterstitialAd = PCSDK.online.getParamsInt('interstitial_ad_open', 0) === 1; - // isInterstitialAd && '显示插屏广告'; - // 获取动态多个广告位开启的配置 - let pcGameOpenMap = PCSDK.online.getParamsObj('pc_games_open', { "Drawer": 0, "GuessLike": 0, "Cross": 0 }); - // pcGameOpenMap.Drawer === 1 && '显示抽屉推广位'; - // pcGameOpenMap.GuessLike === 1 && '显示猜你喜欢推广位'; - // pcGameOpenMap.Cross === 1 && '显示交叉推广位'; - }); - ``` - true:sdk启动时自动调用updateOnlineConfig拉取后台在线配置参数列表,开发者可通过 - - PCSDK.online.getParamsObj、PCSDK.online.getParamsInt、PCSDK.online.getParamsString、PCSDK.online.getParams api传递后台配置参数key获取在线配置参数。 - - 示例:IsOnlineAutoUse: true,开发者可使用下面api获取在线配置参数配置的值 - - ```javascript - let isInterstitialAd = PCSDK.online.getParamsInt('interstitial_ad_open', 0) === 1; - let pcGameOpenMap = PCSDK.online.getParamsObj('pc_games_open', { "Drawer": 0, "GuessLike": 0, "Cross": 0 }); - ``` - -6. **IsOnlineDebug( boolean ):**是否启用online模块(在线配置参数)debug模式,建议设置为true。 - - false:不启动debug模式,开发者主动调用updateOnlineConfig或者SDK启动时调用updateOnlineConfig都会把在线配置参数列表设置10分钟缓存,不用每次都去服务器请求,参照了友盟在线参数功能的设计 - - true: 开启debug模式,只要是请求updateOnlineConfig api都会立即发起请求,而不是去检测读取缓存 - -7. **ShareRightKey( string ):**右上角分享的shareKey,shareKey请阅读分享视频模块,默认为forward,为空字符串则不使用右上角分享,此配置在配置【IsUseShareModule: true】情况下生效。 - - 示例: - - 在后台的【分享/视频配置】栏目配置了一条分享key为:forward的分享配置 - - ![sdk文件目录结构](https://dep.miso-lab.com/sdkword/sdk_004.png "🔍点击查看大图") - -8. **ShareData( object ):**此配置在【IsUseShareModule: true】起效,开发者如果接入了分享视频模块,>>> 请务必配置一条 <<<。 - - > IsUseShareModule设置true sdk启动拉取分享视频配置列表,如果分享视频列表拉取请求失败,或此shareKey不在分享视频配置列表中(登录后台 ->【游戏数据】->【分享/视频配置】栏没有配置分享key)就会使用此条设置的数据。 - - 示例:可从后台【游戏数据】->【分享/视频配置】中选取一条:复制文案,点击分享素材icon -> 查看大图 -> 右键查看分享图片的html源码复制src图片地址: - - ```json - { - // 分享文案内容 - share_desc: ' 半夜传来啪啪啪!竟是隔壁老王偷偷打气球', - // 可选,视频广告uid,配置此参数,拉取不到对应的shareKey,推送看视频,不配置或者配置的uid无效则推送分享 - share_wxad_id: 'adunit-6958dcfc3f0bed31', - // 分享图 - share_icon: 'https://dep.miso-lab.com/data_analysis/games/res/5D57D4A3Yx.png' - } - ``` - - 操作步骤: - - ![sdk文件目录结构](https://dep.miso-lab.com/sdkword/sdk_005.png "🔍点击查看大图") - -9. **GameId:必填,游戏id,请联系运营人员提供** - -10. **ChannelId:必填,游戏渠道id,请联系运营人员提供** - -11. **Secret:必填,游戏 Secret Key,请联系运营人员提供** - -12. **MidasPay( object ):**米大水虚拟支付配置,没有接入微信的米大师支付,请注意下面规则 - - OfferId:在米大师申请的应用id,没有接入米大师,默认为"0" - - ZoneId:分区ID,默认:"1" - - Mode:支付的类型,不同的支付类型有各自额外要传的附加参数,默认:"game" - - CurrencyType:币种,默认:"CNY" - - Platform:申请接入时的平台,platform与应用id有关。 - - 1)接入了米大师,填写"android"(ios暂时没有开放) - - 2)未接入米大师,使用其他支付,如果只支持android,则填写"android"; - - 3)未接入米大师,使用其他支付,如果只支持ios,则填写"ios"; - - 4)未接入米大师,使用其他支付,如果支持ios和android,则填写为"",sdk会根据手机识别android还是ios - - - -* #### 如果项目使用Typescript语言开发,请引入解压文件夹下的sdk.d.ts文件到项目中。 - - 示例:项目采用的是Laya Typescript版本进行开发,将该文件复制到libs目录下面 - - ![sdk文件目录结构](https://dep.miso-lab.com/sdkword/sdk_007.png "🔍点击查看大图") - -* #### 到此,SDK的准备工作已经配置完毕,运行起来: - - 运行中碰到问题,[[请查看FAQ](faq.md)],或者微信群联系相关人员。 - - 正常运行,阅读SDK手册,开始[[SDK模块功能](modules.md)]接入。 \ No newline at end of file diff --git a/inner/inner/intro.md b/inner/inner/intro.md deleted file mode 100644 index 89665db..0000000 --- a/inner/inner/intro.md +++ /dev/null @@ -1,64 +0,0 @@ -# 噗嗤SDK -PCSDK(噗嗤SDK)是一款封装了微信小游戏、QQ小游戏平台常用api接口和用户行为数据上报的一款产品。 -PCSDK上报小游戏用户所触发的各种行为数据到噗嗤管理后台,后台对数据统计分析后以多样化的方式展现数据。 - -**PCSDK提供的模块功能:** - -- [统计模块](stat.md) -- [分享视频模块](share.md) -- [配置参数模块️](online.md) -- [多平台接口模块](platform.md) -- [数据模块](data.md) -- [事件模块](event.md) - - - -# 噗嗤管理后台 -噗嗤管理后台对sdk中上报的各项数据进行分析;管理sdk中所需要的配置信息:分享/视频配置、配置参数(在线参数配置)、交叉推广位配置、用户自定义事件配置。 - -方便开发者联调测试阶段不影响上线游戏运营相关数据或者配置信息,config.js的Env配置提供测试和正式环境切换。 - -> 测试环境各种配置管理、数据分析查看,请[前往测试服后台](http://pre-data.d3games.com/#/login) - -> 正式环境各种配置管理、数据分析查看,请[前往正式服后台](https://data.d3games.com/#/login) - -噗嗤管理后台地址: - -- 测试服后台,地址:http://pre-data.d3games.com/#/login - -- 正式服后台,地址:https://data.d3games.com/#/login - -**友情提示:** - -- **之后文档中'后台'指的是[噗嗤管理后台],而不是微信小程序/小游戏后台。** -- **后台登录账号获取:需提供手机信息给我方运营,运营创建后台登录账号、密码后提供反馈。** -- **登录后台即可使用后台提供的各项服务** - - - -**后台概览:** -## ![sdk文件目录结构](https://dep.miso-lab.com/sdkword/sdk_006.png "🔍点击查看大图") - - - -**后台提供数据分析功能(不能跳转请联系管理员添加权限):** - -- [注册/活跃用户,在线时长实时数据分析](https://data.d3games.com/index.html#/view_chart) -- [分享数据分析](https://data.d3games.com/index.html#/share_exact) -- [用户事件行为分析](https://data.d3games.com/index.html#/dot_list) -- [渠道数据统计分析](https//data.d3games.com/index.html#/channel_stat_list) - - - -**后台提供配置相关功能(不能跳转请联系管理员添加权限):** - -- [分享/视频配置](http://pre-data.d3games.com/index.html#/share_list) -- [配置参数](http://pre-data.d3games.com/index.html#/config_list) - - -# 更多: -- 快速接入,请详读 [安装步骤](install.md) - - - -- 遇到问题可以查看 [FAQ](faq.md) \ No newline at end of file diff --git a/inner/inner/stat_ads.md b/inner/inner/stat_ads.md deleted file mode 100644 index e07e60d..0000000 --- a/inner/inner/stat_ads.md +++ /dev/null @@ -1,543 +0,0 @@ -# 交叉推广位 - ------- - -#### **简介** - -交叉推广位是在游戏中展示其他游戏,用户点击某个游戏跳转进入游戏,达到共享用户的目的。 - -噗嗤游戏提供了3种类型的交叉推广位,后台可对交叉推广位进行配置管理,对交叉推广位各项指标分析阅览。 - -**3种广告类型:交叉悬浮广告框、交叉抽屉式广告位、交叉猜你喜欢广告位** - -1. 交叉悬浮广告框,放置到首页、结算页 - - ![sdk文件目录结构](https://dep.miso-lab.com/sdkword/sdk_013.png "🔍点击查看大图") - -2. 交叉抽屉式广告位,放置到首页、结算页 - - ![sdk文件目录结构](https://dep.miso-lab.com/sdkword/sdk_014.png "🔍点击查看大图") - -3. 交叉猜你喜欢广告位,推荐放置到结算页 - - ![sdk文件目录结构](https://dep.miso-lab.com/sdkword/sdk_015.png "🔍点击查看大图") - - - - - -#### **后台使用** - -完成接入交叉推广位后,登录后台->头部tab切换到【游戏数据】->【流量分析】->【广告导出】即可查看推广位的各项数据信息(需要后台管理人员添加权限): - -![sdk文件目录结构](https://dep.miso-lab.com/sdkword/sdk_012.png "🔍点击查看大图") - - - -#### **接入必读** - -- 由于微信对每个游戏可跳转其他游戏有10个限制,可跳转的其它游戏需要在小游戏根目录下的全局配置文件game.json中进行添加配置:navigateToMiniProgramAppIdList,该参数定义请详读[小程序全局配置](https://developers.weixin.qq.com/minigame/dev/reference/configuration/app.html)。 - -- 噗嗤游戏为了方便开发者接入调试交叉推广位,【后台测试服】已经配置测试使用的不同类型推广位,并提供以下10个测试服广告位appid: - - 水果爆破 :"wx26822126b4d99eda", - - 球球涂涂涂:"wxac0750884d5bed0c", - - 狂野漂移3D:"wx019a09df638e6683", - - 星星爱消消:"wx9ff47d13a88e5511", - - 土耳其方块消消乐:"wx89efb2282d65a2d0", - - 成语小才子:"wxd4d478c7d331ce80", - - 球球蹦蹦蹦:"wxabee9afe62d0b114", - - 俄罗斯方块连连消:"wx4cd087f19f4cb7c3", - - 球球爆爆爆:"wxae33d68413f40641", - - 疯狂水果一刀切:"wxdf26a04c53d6f1e9" - - ```javascript - "navigateToMiniProgramAppIdList": [ - "wx26822126b4d99eda", - "wxac0750884d5bed0c", - "wx019a09df638e6683", - "wx9ff47d13a88e5511", - "wx89efb2282d65a2d0", - "wxd4d478c7d331ce80", - "wxabee9afe62d0b114", - "wx4cd087f19f4cb7c3", - "wxae33d68413f40641", - "wxdf26a04c53d6f1e9" - ] - ``` - - - -- 完成下面的操作步骤,即可拉取交叉推广位: - - 1、开发者复制上面的10个其他游戏的appid,配置到game.json的navigateToMiniProgramAppIdList参数: - - ![sdk文件目录结构](https://dep.miso-lab.com/sdkword/sdk_010.png "🔍点击查看大图") - - 2、修改[config.js的Env配置](install.md#config_env)为110,开发者测试联调阶段,走测试环境 - - > 提示:广告位接入完毕测试通过,提交审核前,修改Env为100。 - - ![sdk文件目录结构](https://dep.miso-lab.com/sdkword/sdk_011.png "🔍点击查看大图") - - - -#### **接入API:** - -| **名称** | **功能说明** | -| --------------------------- | ------------------------------------------------------------ | -| PCSDK.stat.bannerList | 根据类型获取对应类型交叉广告列表,目前SDK支持3种类型:40(交叉悬浮广告框)、70(交叉抽屉式广告位)、50(交叉猜你喜欢广告位) | -| PCSDK.stat.bannerNavigateTo | 交叉推广位点击跳转到对应appid的游戏,该接口封装了小游戏的跳转功能(navigateToMiniProgram) | -| PCSDK.stat.addExposure | 交叉推广位一条或者多条广告展示,添加曝光数据,SDK在onHide时候上报数据到后台 | - - - - - - - -1. ##### **bannerList** - - ```javascript - PCSDK.stat.loadingFinish(banner_type): Promise - ``` - - 定义:根据类型获取对应类型交叉广告列表,目前SDK支持3种类型 - - 参数: - - ``` - banner_type: number 必填 目前支持三种广告类型:40、50、70 - ``` - - 返回值:Promise - - 返回的是Promise类型,Promise resolve成功回调数据结构为: - - ```json - { - "banner_list": [ - { - "banner_id": "3568", - "banner_name": "土耳其方块", - "banner_type": "40", - "banner_location": "100", - "banner_ad_id": "50", - "banner_launch_appid": "", - "banner_launch_path": "", - "banner_appid": "wx89efb2282d65a2d0", - "banner_path": "?channel_id=20361", - "banner_icon": "https://dep.miso-lab.com/data_analysis/games/res/5D42CB97RK.png", - "banner_user_num": "0", - "banner_exposure_num": "0", - "banner_sort": "1", - "banner_game_id": "1000053", - "banner_qqgame": "0", - "banner_qqgame_id": "0", - "banner_game_type": 0, - "banner_bone": "0", - "banner_system": "0", - "banner_online": "1", - "banner_reddot": "0", - "banner_gender": "0", - "banner_resident": "0", - "banner_qrcode": "0", - "banner_qrcode_img": "", - "banner_bone_info": false, - "banner_img_info": { - "banner_icon": "https://dep.miso-lab.com/data_analysis/games/res/5D42CB97RK.png" - } - }, - { - "banner_id": "3571", - "banner_name": "水果一刀切", - "banner_type": "40", - "banner_location": "100", - "banner_ad_id": "99", - "banner_launch_appid": "", - "banner_launch_path": "", - "banner_appid": "wxdf26a04c53d6f1e9", - "banner_path": "?channel_id=20361", - "banner_icon": "https://dep.miso-lab.com/data_analysis/games/res/5D42CBACTt.png", - "banner_user_num": "0", - "banner_exposure_num": "0", - "banner_sort": "1", - "banner_game_id": "1000053", - "banner_qqgame": "0", - "banner_qqgame_id": "0", - "banner_game_type": 0, - "banner_bone": "0", - "banner_system": "0", - "banner_online": "1", - "banner_reddot": "0", - "banner_gender": "0", - "banner_resident": "0", - "banner_qrcode": "0", - "banner_qrcode_img": "", - "banner_bone_info": false, - "banner_img_info": { - "banner_icon": "https://dep.miso-lab.com/data_analysis/games/res/5D42CBACTt.png" - } - } - ] - } - - ``` - - > **返回的数据banner_list列表解析为 Array< BannerData >,BannerData是banner_list每一项数据实体,下面的bannerNavigateTo与addExposure接口api参数banner_data属于此BannerData结构**。 - - 示例: - - ```javascript - /** - * 演示交叉推广位使用示例 - */ - export default class TestBannerSample { - constructor() { - // 示例:加载交叉悬浮广告框 - this.loadBannerList(BannerType.TYPE_CROSS) - .then((dataList: Array) => { - // 渲染广告位数据 - this.renderAdCrossList(dataList); - }).catch(err => { - // bannerList不存在获取请求拉取失败 - }); - } - - /** - * 渲染广告位列表 - * @param dataList 广告位列表 - */ - private renderAdCrossList(dataList: Array) { - // ... - } - - /** - * 根据类型获取交叉推广位列表 - * @param banner_type 广告位类型 - */ - private loadBannerList(banner_type: BannerType): Promise { - return new Promise((resolve, reject) => { - PCSDK.stat.bannerList(banner_type) - .then(data => { - let bannerList: Array = data.banner_list || []; - if (bannerList.length) { - // 处理bannerList数据列表 - resolve(bannerList); - } else { - // 处理数据为空情况 - reject(null); - } - }).catch(err => { - // 请求接口报错情况 - reject(err); - }); - }); - } - } - - // 广告位类型的枚举 - enum BannerType { - TYPE_CROSS = 40, // 交叉悬浮广告框 - TYPE_LIKE = 50, // 交叉猜你喜欢广告位 - TYPE_LIST = 70, // 交叉抽屉广告位 - } - - /* - * banner数据实体结构 - */ - class BannerData { - public banner_id: string; - public banner_appid: string; - public banner_diamond: number; - public banner_type: string; - public banner_icon: string; - public banner_name: string; - public banner_resident: string; // 是否常驻 - } - ``` - -2. ##### **bannerNavigateTo** - - ```javascript - PCSDK.stat.bannerNavigateTo( location:number, banner_data: any, opts?: { extraData?: string; envVersion?: string }): Promise - ``` - - 定义:交叉推广位点击游戏跳转到对应appid的游戏,该接口封装了小游戏的跳转功能(navigateToMiniProgram), 第三个参数配置可参考[wx.navigateToMiniProgram extraData、envVersion配置信息](https://developers.weixin.qq.com/minigame/dev/api/open-api/miniprogram-navigate/wx.navigateToMiniProgram.html) - - 参数: - - ```javascript - location: number 必传,统一传递为:100 - - banner_data:any 必传,点击跳转项对应数据,该数据的结构为BannerData,为bannerList获取的Array的单元实体项 - - opts: object 选传,调试阶段可参照[wx.navigateToMiniProgram(Object object) extraData配置信息]进行裴旭 - { - extraData: string 选传, 需要传递给目标小程序的数据,目标小程序可在 App.onLaunch,App.onShow 中获取到这份数据 - envVersion: string 选传,要打开的小程序版本,合法值:develop、trial、release - } - ``` - - 示例:获取猜你喜欢推广位,以列表的形式显示在界面上,点击任意一项游戏跳转其他游戏 - - ```javascript - // 发起登录请求,得到登录数据信息,调用setLogind设置SDK用户信息 - /** - * 演示交叉推广位使用示例 - */ - export default class TestBannerSample extends ui.shop.ShopPopwinUI { - private list: Laya.List; - - constructor() { - super(); - - // 创建List ui - this.list = new Laya.List(); - this.list.itemRender = AdItem; - this.list.vScrollBarSkin = ""; - this.list.scrollBar.elasticBackTime = 500; - this.list.scrollBar.elasticDistance = 350; - this.list.x = 0; - this.list.y = 0; - this.list.spaceY = 10; - this.list.height = 1000; - this.list.renderHandler = new Laya.Handler(this, this.renderAdItem); - this.boxList.addChild(this.list); - - // 示例:加载猜你喜欢广告位数据列表 - this.loadBannerList(BannerType.TYPE_LIKE) - .then((dataList: Array) => { - this.renderAdLikeList(dataList); - }).catch(err => { - // bannerList不存在获取请求拉取失败 - }); - } - - /** - * 渲染单个广告位ui - * @param cell - */ - private renderAdItem(cell: AdItem) { - cell.init(); - } - - /** - * 渲染广告位列表 - * @param dataList 广告位列表 - */ - private renderAdLikeList(dataList: Array) { - this.list.array = dataList; - } - - /** - * 根据类型获取交叉推广位列表 - * @param banner_type 广告位类型 - */ - private loadBannerList(banner_type: BannerType): Promise { - return new Promise((resolve, reject) => { - PCSDK.stat.bannerList(banner_type) - .then(data => { - let bannerList: Array = data.banner_list || []; - if (bannerList.length) { - // 处理bannerList数据列表 - resolve(bannerList); - } else { - // 处理数据为空情况 - reject(null); - } - }).catch(err => { - // 请求接口报错情况 - reject(err); - }); - }); - } - } - - class AdItem extends ui.ads.GameIconUI { - constructor() { - super(); - this.on(Laya.Event.CLICK, this, this.onJumpGame); - } - - init() { - let { banner_icon, banner_name, banner_reddot } = this.dataSource; - this.iconTex.skin = banner_icon; - this.nametxt.text = banner_name; - this.hot.visible = banner_reddot + '' === '1'; - } - - private onJumpGame(ev: Laya.Event) { - PCSDK.stat.bannerNavigateTo(100, { ...this.dataSource }).catch(err => { - // 跳转游戏微信弹出二次确认框,点击取消执行此处 - }); - } - } - - // 广告位类型的枚举 - enum BannerType { - TYPE_CROSS = 40, // 交叉悬浮广告框 - TYPE_LIKE = 50, // 交叉猜你喜欢广告位 - TYPE_LIST = 70, // 交叉抽屉广告位 - } - - /* - * banner数据实体结构 - */ - class BannerData { - public banner_id: string; - public banner_appid: string; - public banner_diamond: number; - public banner_type: string; - public banner_icon: string; - public banner_name: string; - public banner_resident: string; // 是否常驻 - } - ``` - - -3. ##### **addExposure** - - ```javascript - PCSDK.stat.addExposure( location: number, banner_data: Array< any > | any ): void - ``` - - 定义:对一个或者多个展示的推广位添加曝光,SDK在onHide时候上报曝光数据到后台,后台进行统计查阅 - - 参数: - - ```javascript - location: number 必传,统一传递为:100 - - banner_data:any 必传,添加展推广位曝光数据,可添加一个或者多个曝光数据,banner_data参数数据结构为上面bannerList api返回的列表数据的项BannerData实体结构:Array | BannerData - - ``` - - > 提示: - > - > 展示猜你喜欢/抽屉推广位:获取到9个推广位数据,展示了其中5个,调用曝光接口传入推广位数据为展示的5个,剩余的4个需在其展示的时候再调用曝光api接口传入。 - > - > 展示交叉悬浮框推广位:展示一个,将此推广位传入曝光接口,点击展示下一个,则把这个最新的数据传入曝光api - - 示例:根据交叉悬浮框类型调用PCSDK.stat.bannnerList接口获取交叉悬浮框推广位列表,显示第一个,每隔4秒切换到下一个,点击一个切换下一个展示。此示例没有使用定时器方式,采用的是监听动画帧实现。 - ```javascript - /** - * 演示交叉推广位使用示例 - */ -export default class TestBannerSample extends ui.ads.ADbtnUI { - private data; - private count: number; - private adList: Array; - - constructor() { - super(); - this.count = 0; - this.adList = []; - this.on(Laya.Event.CLICK, this, this.onJumpGame); - } - - // 初始化显示交叉悬浮框广告位 - init(isFirst: boolean) { - isFirst && (this.count = 0); - this.anim_entice.play(0, true); - this.anim_entice.addLabel('refresh', 38); - // 交叉悬浮框动画执行到第38帧,自动更新下一个,开发者可根据实际使用定时器实现切换下一个 - this.anim_entice.on(Laya.Event.LABEL, this, this.handleAutoRrefresh); - // 第一次 - this.refresh(); - } - - // 清理交叉悬浮框广告位 - clear() { - this.anim_entice.gotoAndStop(0); - this.anim_entice.removeLabel('refresh'); - this.anim_entice.off(Laya.Event.LABEL, this, this.handleAutoRrefresh); - } - - private refresh() { - let list = this.adList; - if (!list || !list.length) { - this.loadBannerList(BannerType.TYPE_CROSS).then(() => this.refresh()); - return; - } - let data = list.pop(); - this.renderAdui(data); - this.data = data; - // 添加曝光数据 - PCSDK.stat.addExposure(100, data); - // 也可以采用传递多个方式 - // PCSDK.stat.addExposure(100, [{...data}]); - } - - private renderAdui(data) { - let { banner_bone_info, banner_img_info } = data; - if (banner_bone_info) { - this.imgIcon.visible = false; - } else { - this.imgIcon.visible = true; - this.imgIcon.skin = banner_img_info.banner_icon; - } - this.imgHot.visible = data.banner_reddot + '' === '1'; - } - - private onJumpGame(ev: Laya.Event) { - this.anim_entice.gotoAndStop(39); - this.anim_entice.play(39, true); - // 切换下一个 - this.refresh(); - PCSDK.stat.bannerNavigateTo(100, { ...this.data }).catch(err => { - // 跳转游戏微信弹出二次确认框,点击取消执行此处 - }); - } - - /** - * 处理自动切换下一个 - * @param name - */ - private handleAutoRrefresh(name) { - if (name === 'refresh' && this.count !== 0) { - this.refresh(); - } - this.count++; - } - - /** - * 根据类型获取交叉推广位列表 - * @param banner_type 广告位类型 - */ - private loadBannerList(banner_type: BannerType): Promise { - return new Promise((resolve, reject) => { - PCSDK.stat.bannerList(banner_type) - .then(data => { - let bannerList: Array = data.banner_list || []; - if (bannerList.length) { - // 处理bannerList数据列表 - resolve(bannerList); - } else { - // 处理数据为空情况 - reject(null); - } - }).catch(err => { - // 请求接口报错情况 - reject(err); - }); - }); - } - } - - // 广告位类型的枚举 - enum BannerType { - TYPE_CROSS = 40, // 交叉悬浮广告框 - TYPE_LIKE = 50, // 交叉猜你喜欢广告位 - TYPE_LIST = 70, // 交叉抽屉广告位 - } - ``` \ No newline at end of file diff --git a/inner/install.md b/inner/install.md index 915d4e6..a43dffe 100644 --- a/inner/install.md +++ b/inner/install.md @@ -32,15 +32,13 @@ https://dataapi.d3games.com (统计平台正式服域名) + https://pre-dataapi.d3games.com (统计平台测试服域名) + cdn资源请求合法域名: https://dep.miso-lab.com (>>>request、download均要添加<<<) - - - -​ ## SDK配置步骤 * #### 将下载下来的sdk压缩包,解压后,拷贝sdk文件夹到微信开发者工具项目中。 @@ -71,6 +69,10 @@ IsOnlineDebug: true, // 是否开启online模块(配置参数模块)debug模式 ShareRightKey: 'forward', // 右上角分享的shareKey,shareKey请阅读share模块说明,默认为forward,为空字符串则不使用右上角分享 + GameHost: { // 必填,游戏服务端的host + Prod: 'https://xxx/xxx', + Pre: 'https://pre-xxx/xxx' + }, ShareData: { // 必填,默认分享数据(拉取不到分享配置后使用,默认分享,SDK自动分配share_id为99999) share_desc: 'xxx', share_wxad_id: '', // 可选,视频广告uid,配置此参数,拉取不到对应的shareKey,推送看视频,不配置或者配置的uid无效则推送分享 @@ -153,8 +155,8 @@ 在后台的【分享/视频配置】栏目配置了一条分享key为:forward的分享配置 ![sdk文件目录结构](https://dep.miso-lab.com/sdkword/sdk_004.png "🔍点击查看大图") - -8. **ShareData( object ):**此配置在【IsUseShareModule: true】起效,开发者如果接入了分享视频模块,>>> 请务必配置一条 <<<。 +8. **GameHost( object ):**必填,游戏服务端的host,此配置需运营or后端人员提供,目前是后端人员提供,游戏服务器API的测试、正式服地址。 +9. **ShareData( object ):**此配置在【IsUseShareModule: true】起效,开发者如果接入了分享视频模块,>>> 请务必配置一条 <<<。 > IsUseShareModule设置true sdk启动拉取分享视频配置列表,如果分享视频列表拉取请求失败,或此shareKey不在分享视频配置列表中(登录后台 ->【游戏数据】->【分享/视频配置】栏没有配置分享key)就会使用此条设置的数据。 diff --git a/inner/intro.md b/inner/intro.md index 84e8e28..6aaee46 100644 --- a/inner/intro.md +++ b/inner/intro.md @@ -16,9 +16,11 @@ PCSDK上报小游戏用户所触发的各种行为数据到噗嗤管理后台, # 噗嗤管理后台 噗嗤管理后台对sdk中上报的各项数据进行分析,管理sdk中所需要的配置信息:分享/视频配置、配置参数(在线参数配置)、交叉推广位配置、用户自定义事件配置。 -噗嗤管理后台地址: +噗嗤管理后台地址:方便开发者联调测试阶段不影响上线游戏运营相关数据或者配置信息,{% em %}注意:开发者需在游戏客户端维护一个版本号version,作为[PCSDK.game模块的env](game.md#env) api的参数传递;第一次接入设置version为1.0,此时API跑的是测试环境,游戏提审通过发布上线后,1.0则会被后端切为正式服地址,用于线上游戏运行,1.1则被后端改成测试服地址,方便开发者进行新的版本功能迭代,请客户端版本号加0.1,改成1.1,依次类推,每个版本上线后开发者都要对version加上0.1。{% endem %} -- https://data.d3games.com/#/login +> 测试环境各种配置管理、数据分析查看,请[前往测试服后台](http://pre-data.d3games.com/#/login) + +> 正式环境各种配置管理、数据分析查看,请[前往正式服后台](https://data.d3games.com/#/login) **友情提示:** @@ -42,10 +44,10 @@ PCSDK上报小游戏用户所触发的各种行为数据到噗嗤管理后台, -**后台提供配置相关功能(不能跳转请联系管理员添加权限):** +**后台提供配置相关功能,开发者去测试后台配置,提审后让相关人员同步测试配置到正式配置(不能跳转请联系管理员添加权限):** -- [分享/视频配置](https://data.d3games.com/index.html#/share_list) -- [配置参数](https://data.d3games.com/index.html#/config_list) +- [分享/视频配置](http://pre-data.d3games.com/index.html#/share_list) +- [配置参数](http://pre-data.d3games.com/index.html#/config_list) # 更多: diff --git a/outer/install.md b/outer/install.md index 915d4e6..d1e6be4 100644 --- a/outer/install.md +++ b/outer/install.md @@ -5,7 +5,7 @@ ## SDK下载 1. 下载最新版本的SDK [SDK下载](download.md) 。 -2. 解压下载的sdk-in-v{版本号}.zip包,解压文件夹里面的的目录结构: +2. 解压下载的sdk-out-v{版本号}.zip包,解压文件夹里面的的目录结构: ``` ├── sdk.d.ts -- libgit2 0.21.0