<p align="center">
  <h1 align="center">Cordova HMS Ads</h1>
</p>


<p align="center">
  <a href="https://www.npmjs.com/package/@hmscore/cordova-plugin-hms-ads"><img src="https://img.shields.io/npm/dm/@hmscore/cordova-plugin-hms-ads?color=%23007EC6&style=for-the-badge" alt="downloads"></a>
  <a href="https://www.npmjs.com/package/@hmscore/cordova-plugin-hms-ads"><img src="https://img.shields.io/npm/v/@hmscore/cordova-plugin-hms-ads?color=%23ed2a1c&style=for-the-badge" alt="NPM version"></a>
  <a href="./LICENSE"><img src="https://img.shields.io/npm/l/@hmscore/cordova-plugin-hms-ads.svg?color=%3bcc62&style=for-the-badge" alt="License"></a>
</p>

----

This plugin enables communication between Huawei Ads SDK and Cordova platform. It exposes all functionality provided by Huawei Ads SDK.

[> Learn More](https://developer.huawei.com/consumer/en/doc/development/HMS-Plugin-Guides/introduction-0000001050437673?ha_source=hms1)

## Installation

### Cordova

```bash
$ cordova plugin add @hmscore/cordova-plugin-hms-ads
```

### Ionic with Cordova Runtime

```bash
$ ionic cordova plugin add @hmscore/cordova-plugin-hms-ads
```

### Ionic with Capacitor Runtime

```bash
$ npm install @hmscore/cordova-plugin-hms-ads
```

### Ionic Native Wrappers

```bash
$ npm install @hmscore/ionic-native-hms-ads
```

## Documentation

- [Quick Start](https://developer.huawei.com/consumer/en/doc/development/HMS-Plugin-Guides/preparedevenv-0000001050733529?ha_source=hms1)
- [Reference](https://developer.huawei.com/consumer/en/doc/development/HMS-Plugin-References/ads-0000001050200658?ha_source=hms1)

### Additional Topics

- [Rewarded Ads](https://developer.huawei.com/consumer/en/doc/development/HMS-Plugin-Guides/rewarded-ads-0000001050195456?ha_source=hms1)
- [Banner Ads](https://developer.huawei.com/consumer/en/doc/development/HMS-Plugin-Guides/banner-ads-0000001050312772?ha_source=hms1)

## Questions or Issues

If you have questions about how to use HMS samples, try the following options:

- [Stack Overflow](https://stackoverflow.com/questions/tagged/huawei-mobile-services) is the best place for any programming questions. Be sure to tag your question with `huawei-mobile-services`.
- [GitHub](https://github.com/HMS-Core/hms-cordova-plugin) is the official repository for these plugins, You can open an issue or submit your ideas.
- [Huawei Developer Forum](https://forums.developer.huawei.com/forumPortal/en/home?fid=0101187876626530001&ha_source=hms1) HMS Core Module is great for general questions, or seeking recommendations and opinions.
- [Huawei Developer Docs](https://developer.huawei.com/consumer/en/doc/overview/HMS-Core-Plugin?ha_source=hms1) is place to official documentation for all HMS Core Kits, you can find detailed documentations in there.

If you run into a bug in our samples, please submit an issue to the [GitHub repository](https://github.com/HMS-Core/hms-cordova-plugin).

## License

Huawei Ads Kit Cordova Plugin is licensed under the [Apache 2.0 license](LICENSE).