home / skills / partme-ai / full-stack-skills / uniapp-ad

uniapp-ad skill

safe

This skill helps you integrate uni-app ads, configure types, handle events, and optimize ad monetization by following official uni-ad guidelines.

npx playbooks add skill partme-ai/full-stack-skills --skill uniapp-ad

Review the files below or copy the command above to add this skill to your agents.

Files (10)

SKILL.md

2.1 KB

---
name: uniapp-ad
description: A comprehensive skill for uni-ad monetization in uni-app. Use this skill to integrate ads, configure ad types, handle ad events, and follow official uni-ad documentation.
license: Complete terms in LICENSE.txt
---

## 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

Overview

This skill provides a complete toolkit for integrating uni-ad monetization into uni-app projects. It helps configure common ad formats, wire up event handling, and follow official uni-ad guidance to maximize revenue while preserving user experience. The skill includes examples, templates, and an API reference to speed implementation.

How this skill works

The skill inspects the requested ad format (banner, interstitial, rewarded video, native) and directs you to the matching integration example and API reference. It provides code templates for loading, showing, and handling ad events (load, show, close, error), plus guidance on placement, timing, and compliance. Use the included examples and the uni-ad API reference to adapt the integration to your app lifecycle and platform.

When to use it

You want to add ad monetization to a uni-app project
You need examples for banner, interstitial, rewarded video, or native ads
You must implement robust ad event handling and error recovery
You want strategic ad placement and loading patterns to optimize revenue
You need to follow uni-ad policies and platform compliance

Best practices

Prioritize user experience; avoid intrusive or frequent ads
Preload interstitials and rewarded videos and handle load states
Place banners and native ads in predictable, non-disruptive spots
Implement comprehensive error handling and fallbacks for ad failures
Respect privacy and ad policies; show consent flows where required

Example use cases

Add a banner ad to a home or list screen with safe margins and throttled refresh
Preload and show an interstitial after a level completes or during natural breaks
Reward users with in-game currency using rewarded video flow and robust completion callbacks
Integrate native ads into feed layouts while preserving content hierarchy and performance
Implement centralized ad manager that abstracts ad-type loading, retries, and analytics

FAQ

Which ad types are supported?

Banner, interstitial, rewarded video, and native ads are covered along with common event hooks for each type.

Where do I find code examples and API details?

The skill points to categorized examples for guides and ad-types and includes the uni-ad API reference to implement calls and event handlers.