Uniapp Ad Skill

When to use this skill

Use this skill whenever the user wants to:

• Integrate ads into uni-app
• Implement ad monetization
• Configure different ad types (banner, interstitial, rewarded video, etc.)
• Handle ad events (load, show, close, error)
• Optimize ad revenue
• Set up ad placement and timing
• Handle ad policies and compliance

How to use this skill

To integrate ads:

1. Identify the ad type from the user's request:

• Banner ads → Use banner examples
• Interstitial ads → Use interstitial examples
• Rewarded video → Use rewarded video examples
• Native ads → Use native ad examples

2. Load the appropriate example file from the examples/ directory:

• examples/guide/ - Ad integration guide
• examples/ad-types/ - Different ad type examples
• examples/integration/ - Integration examples

3. Load the appropriate API reference from the api/ directory:

• api/ad-api.md - uni-ad API reference

4. Follow the specific instructions in those files for integration

Examples and Templates

Examples

Located in examples/:

• guide/ - Ad integration guide and setup
• ad-types/ - Different ad type examples (banner, interstitial, rewarded video, etc.)
• integration/ - Integration examples and best practices

API Reference

Located in api/:

• ad-api.md - Complete uni-ad API reference

Best Practices

1. User experience: Don't interrupt user experience with excessive ads
2. Ad placement: Place ads strategically for maximum revenue
3. Loading: Handle ad loading states properly
4. Error handling: Implement proper error handling for ad failures
5. Compliance: Follow ad policies and regulations

Resources

• Official Documentation: https://uniapp.dcloud.net.cn/uni-ad/

Keywords

uni-ad, 广告变现, banner广告, 激励视频, 插屏广告, ad monetization, ad integration

能力边界

✅ 适用场景

• 当你需要使用此技能对应的技术栈时
• 当项目需要遵循最佳实践时
• 当需要快速上手或深入理解核心概念时

⚠️ 需要注意

• 复杂业务逻辑需要结合具体场景调整
• 性能优化需要根据实际数据量评估

❌ 不适用场景

• 不相关的技术栈或框架
• 需要完全自定义的特殊场景

常见陷阱 (Gotchas)

1. 版本兼容性：注意框架版本与依赖库的兼容性，不同版本 API 可能有差异
2. 配置文件格式：配置文件格式错误是最常见的问题，建议使用编辑器的语法检查
3. 环境变量：确保所有必要的环境变量已正确设置，敏感信息不要硬编码
4. 依赖冲突：多版本共存时注意依赖冲突，使用 lock 文件锁定版本
5. 性能陷阱：大数据量场景下注意性能优化，避免 N+1 查询等常见问题

使用流程

Step 1: 环境准备

确保开发环境已安装必要的依赖和工具。

Step 2: 配置初始化

根据项目需求进行基础配置。

Step 3: 核心功能使用

按照示例代码实现核心功能。

Step 4: 测试验证

运行测试确保功能正常。

Step 5: 部署上线

完成开发后进行部署和监控。

uni-ad API 参考

官方文档

参考官方文档：https://uniapp.dcloud.net.cn/uni-ad/

常用 API

• uni.createRewardedVideoAd
• uni.createInterstitialAd
• uni.createBannerAd

参考资源

• https://uniapp.dcloud.net.cn/uni-ad/

Banner 广告

官方文档

参考官方文档：https://uniapp.dcloud.net.cn/uni-ad/

示例

<template>
  <ad unit-id="YOUR_AD_UNIT_ID" ad-type="banner"></ad>
</template>

参考资源

• https://uniapp.dcloud.net.cn/uni-ad/

插屏广告

官方文档

参考官方文档：https://uniapp.dcloud.net.cn/uni-ad/

示例

const interstitial = uni.createInterstitialAd({
  adUnitId: 'YOUR_AD_UNIT_ID'
})
interstitial.show()

参考资源

• https://uniapp.dcloud.net.cn/uni-ad/

原生广告

官方文档

参考官方文档：https://uniapp.dcloud.net.cn/uni-ad/

说明

• 原生广告需结合广告位与样式进行自定义渲染
• 注意广告标识与合规要求

参考资源

• https://uniapp.dcloud.net.cn/uni-ad/

激励视频广告

官方文档

参考官方文档：https://uniapp.dcloud.net.cn/uni-ad/

示例

const rewarded = uni.createRewardedVideoAd({
  adUnitId: 'YOUR_AD_UNIT_ID'
})
rewarded.show()

参考资源

• https://uniapp.dcloud.net.cn/uni-ad/

uni-ad 接入概览

官方文档

参考官方文档：https://uniapp.dcloud.net.cn/uni-ad/

适用场景

• 在 uni-app 中进行广告变现
• 需要集成 banner、插屏、激励视频等广告类型

基本流程

1. 开通 uni-ad
2. 获取广告位 ID
3. 在页面中引入广告组件或 API

参考资源

• https://uniapp.dcloud.net.cn/uni-ad/

广告位配置

官方文档

参考官方文档：https://uniapp.dcloud.net.cn/uni-ad/

配置要点

• 在平台配置广告位 ID
• 根据平台选择合适广告类型

参考资源

• https://uniapp.dcloud.net.cn/uni-ad/

广告事件处理

官方文档

参考官方文档：https://uniapp.dcloud.net.cn/uni-ad/

示例

rewarded.onLoad(() => {
  console.log('广告加载成功')
})
rewarded.onError(err => {
  console.error('广告加载失败', err)
})
rewarded.onClose(res => {
  console.log('广告关闭', res)
})

参考资源

• https://uniapp.dcloud.net.cn/uni-ad/