一.互推盒子广告介绍
1.互推盒子是基于小游戏场景开发的一种广告能力，可用来增强小游戏商业化变现能力，小游戏开发者可在米盟后台http://ssp.xiaomi.com内进行广告位创建和变现数据查看
2.目前盒子能力支持5种样式：九宫格样式、横幅样式、抽屉样式、悬浮球样式、退出卡片样式。当前仅支持小游戏（RPK）创建使用，不支持APK游戏。
二.互推盒子广告创建流程
1.前往米盟后台http://ssp.xiaomi.com
2.找到对应的小游戏并点击“启用”，注意：不启用应用不可创建广告位
3.在“我的广告位”中点击“新的广告位”开始创建广告位
4.如需接入九宫格样式，请选择“互推盒子” - “九宫格”
5.如需接入横幅样式，请选择“互推盒子” - “横幅”
6.如需接入抽屉样式，请选择“互推盒子” - “抽屉”（抽屉广告可选择黑/白两种背景颜色，并且支持在线修改）
7.如需接入悬浮球样式，请选择“互推盒子” - “悬浮球”
8.如需接入退出卡片样式，请选择“互推盒子” - “退出卡片”（退出卡片广告位无法接入代码，只需开启广告位即可生效）
9.创建完对应广告位后，务必“启用”该广告位，否则广告位无法生效
三.互推盒子广告接入规范
1.互推盒子-九宫格
展示场景：
需在游戏场景添加相应按钮（如：精选游戏），用户主动点击按钮后展示九宫格，可在游戏内多场景展示，但如需要将九宫格广告作为插屏类的被动广告展示，需要严格按照插屏类广告的接入规范进行，请求间隔不得小于30S，并在用户切换场景时调用关闭接口，否则会遮挡游戏界面和阻碍用户操作，影响游戏体验
展示逻辑：
单次展示9个资源位，资源位每隔1min会自动刷新，展示后支持用户主动关闭，支持开发者主动调用接口隐藏
2.互推盒子-横幅
展示场景：
主要在游戏结算页场景展示（即当用户通关成功结束任务时），如需在其他场景展示，横幅的展示位置不得遮挡用户主要交互操作区域，并在用户切换场景时调用关闭接口，否则会遮挡游戏界面和阻碍用户操作，影响游戏体验
展示逻辑：
单次展示5个资源位，资源位每隔1min会自动刷新，展示后支持用户主动关闭，支持开发者主动调用接口隐藏
3.互推盒子-抽屉
展示场景：
主要在游戏主界面、游戏结算页等场景展示，不得在游戏进行中展示
展示逻辑：
点击“>>”按钮区域展开抽屉，点击“<<”按钮区域收起抽屉，单次展示6个资源位，支持开发者创建广告位时选择背景颜色（黑色/白色），展开后资源位每隔1min会自动刷新，每次收起、展开抽屉资源位会自动刷新，支持开发者主动调用接口隐藏
4.互推盒子-悬浮球
展示场景：
可在游戏内多场景进行展示（游戏进行中不要展示），初始展示位置默认在屏幕右侧
展示逻辑：
单次展示1个资源位，资源位每隔1min会自动刷新，展示后支持用户主动关闭，支持用户主动拖拽，支持开发者主动调用接口隐藏
5.互推盒子-退出卡片
展示场景：
在用户点击右上角“×”退出游戏的场景下进行展示，自动弹出退出卡片广告，该广告位不需要接入对应代码，只需在米盟后台进行创建并开启即可，具体方式见上方接入流程
展示逻辑：
单次展示6个资源位，资源位每隔1min会自动刷新，展示后支持用户主动关闭（返回游戏页面），退出卡片广告展示时，其余场景会置灰无法点击操作
四.互推盒子接入文档
1.互推盒子-九宫格
- 展示广告
qg.displayAd({
type: 100,
upid：'米盟后台获得的广告位ID'
success:(res)=>{
console.log(res)
// 将会打印以下信息，表示调用成功
// {errMsg: "", errCode: 0}
},
fail:(res)=>{
console.log(res)
}
})
- 监听广告被关闭的通知
globalThis.document.addEventListener('qgCustomEvent',(param)=>{
console.log(param)
// {detail:{type:"qgAdClosed",adType:100}}
// 其中 adType 对应qg.displayAd()中的type参数
})
- 关闭广告
qg.closeAd({
type: 100,
success:(res)=>{
console.log(res)
// 将会打印以下信息，表示调用成功
// {errMsg: "", errCode: 0}
},
fail:(res)=>{
console.log(res)
}
})
2.互推盒子-横幅
- 展示广告
qg.displayAd({
type: 120,
upid：'米盟后台获得的广告位ID'
success:(res)=>{
console.log(res)
// 将会打印以下信息，表示调用成功
// {errMsg: "", errCode: 0}
},
fail:(res)=>{
console.log(res)
}
})
- 监听广告被关闭的通知
globalThis.document.addEventListener('qgCustomEvent',(param)=>{
console.log(param)
// {detail:{type:"qgAdClosed",adType:120}}
// 其中 adType 对应qg.displayAd()中的type参数
})
- 关闭广告
qg.closeAd({
type: 120,
success:(res)=>{
console.log(res)
// 将会打印以下信息，表示调用成功
// {errMsg: "", errCode: 0}
},
fail:(res)=>{
console.log(res)
}
})
3.互推盒子-抽屉
- 展示广告
qg.displayAd({
type: 130, // 此处type值，白色背景为130，黑色背景为140，如在米盟后台创建的是黑色背景抽屉，此处必须为140
upid：'米盟后台获得的广告位ID'
success:(res)=>{
console.log(res)
// 将会打印以下信息，表示调用成功
// {errMsg: "", errCode: 0}
},
fail:(res)=>{
console.log(res)
}
})
- 监听广告被关闭的通知
globalThis.document.addEventListener('qgCustomEvent',(param)=>{
console.log(param)
// {detail:{type:"qgAdClosed",adType: 此处type值，白色背景为130，黑色背景为140}}
// 其中 adType 对应qg.displayAd()中的type参数
})
- 关闭广告
qg.closeAd({
type: 130, // 此处type值，白色背景为130，黑色背景为140
success:(res)=>{
console.log(res)
// 将会打印以下信息，表示调用成功
// {errMsg: "", errCode: 0}
},
fail:(res)=>{
console.log(res)
}
})
4.互推盒子-悬浮球
- 展示广告
qg.displayAd({
type: 150,
upid：'米盟后台获得的广告位ID'
success:(res)=>{
console.log(res)
// 将会打印以下信息，表示调用成功
// {errMsg: "", errCode: 0}
},
fail:(res)=>{
console.log(res)
}
})
- 监听广告被关闭的通知
globalThis.document.addEventListener('qgCustomEvent',(param)=>{
console.log(param)
// {detail:{type:"qgAdClosed",adType:150}}
// 其中 adType 对应qg.displayAd()中的type参数
})
- 关闭广告
qg.closeAd({
type: 150,
success:(res)=>{
console.log(res)
// 将会打印以下信息，表示调用成功
// {errMsg: "", errCode: 0}
},
fail:(res)=>{
console.log(res)
}
})
5.互推盒子-退出卡片
- 该广告位不需要接入对应代码，只需在米盟后台进行创建并开启即可，注意：同一款小游戏只能开启一个“退出卡片”广告位
