Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/lreiner/cordova-plugin-startapp-ads
Cordova Plugin to use StartApp Ads with Cordova based Hybrid Apps. Free to use for everyone 💰
https://github.com/lreiner/cordova-plugin-startapp-ads
ads android cordova cordova-android cordova-plugin startapp
Last synced: 2 months ago
JSON representation
Cordova Plugin to use StartApp Ads with Cordova based Hybrid Apps. Free to use for everyone 💰
- Host: GitHub
- URL: https://github.com/lreiner/cordova-plugin-startapp-ads
- Owner: lreiner
- License: apache-2.0
- Created: 2019-07-17T23:18:39.000Z (over 5 years ago)
- Default Branch: master
- Last Pushed: 2020-05-05T12:47:08.000Z (over 4 years ago)
- Last Synced: 2024-05-20T18:31:14.546Z (7 months ago)
- Topics: ads, android, cordova, cordova-android, cordova-plugin, startapp
- Language: Java
- Homepage: https://www.startapp.com/
- Size: 1.82 MB
- Stars: 10
- Watchers: 4
- Forks: 5
- Open Issues: 6
-
Metadata Files:
- Readme: README.md
- Funding: .github/FUNDING.yml
- License: LICENSE
Awesome Lists containing this project
README
# Cordova Plugin for StartApp Ads
Cordova Plugin for StartApp Ads. This Cordova Plugin is made to use StartApp Ads with Frameworks like Ionic. You can use Banner Ads, Interstitial Ads and Video Reward Ads. Easy to implement and easy to use. Please read the documentation below!
### IMPORTANT
:warning: Only ANDROID is supported at the moment. I'm working hard to implement iOS as well. Stay tuned for future updates!
## Ionic 3+ Implementation
### 1. Installation
First you need to install the cordova plugin in your Ionic Project with Cordova CLI
```
ionic cordova plugin add cordova-plugin-startapp-ads
```
or with URL
```
ionic cordova plugin add https://github.com/lreiner/cordova-plugin-startapp-ads.git
```
### 2. Setup the Plugin
To start declare the Plugin below your imports:
**NOTE: This must be declared in every Page where you want to use StartAppAds!**
```javascript
import ..... //your imports
declare var StartAppAds:any;
```
Now you need to init your Plugin with your App ID from StartApp first. I would recommend to do it in your **app.component.ts** file when platfrom is ready.
```javascript
this.platform.ready().then(() => {
if(this.platform.is("android")) {
StartAppAds.init("");
}
});
```
Nice! :) Now you can use StartAppAds everywhere in your project.
### 3. Show/Hide Banner Ads
Show a Banner Ad on the bottom of your app. (I recommend to either do this in **app.components.ts** or in the **constructor** of any other page).
```javascript
StartAppAds.showBanner();
```
Hide the Banner
```javascript
StartAppAds.hideBanner();
```
Events you can subscribe to (recommended to put it in the **constructor** of any page):
```javascript
document.addEventListener('startappads.banner.load', () => {
//banner has been loaded and displayed.
//do something here
});
document.addEventListener('startappads.banner.load_fail', () => {
//banner failed to load
//do something here
//IMPORTANT: if banner failed to load dont use StartAppAds.showBanner(); again. StartAppAds will load a new one by itself!
});
document.addEventListener('startappads.banner.clicked', () => {
//banner has been clicked
//do something here. Usefull to hide banner to prevent click bombing.
});
document.addEventListener('startappads.banner.hide', () => {
//banner has been removed
//do something here
});
```
### 4. Show Interstitial Ads
Show a Interstitial Ad:
```javascript
StartAppAds.showInterstitial();
```
Events you can subscribe to (recommended to put it in the **constructor** of any page):
```javascript
document.addEventListener('startappads.interstitial.closed', () => {
//interstitial closed by user
//do something here
});
document.addEventListener('startappads.interstitial.displayed', () => {
//interstitial showed up
//do something here
});
document.addEventListener('startappads.interstitial.clicked', () => {
//interstitial clicked by user
//do something here
});
document.addEventListener('startappads.interstitial.not_displayed', () => {
//interstitial loaded and ready but somehow not showed to user
//do something here
});
document.addEventListener('startappads.interstitial.load_fail', () => {
//interstitial failed to load
//do something here
});
```
#### IMPORTANT:
```
Do not call `showInterstitial()` from within `load_fail` event. The SDK will automatically try to reload an ad upon a failure.
```
### 5. Show Rewarded Video Ads
Show a Rewarded Video Ad:
```javascript
StartAppAds.showRewardVideo();
```
Events you can subscribe to (recommended to put it in the **constructor** of any page):
```javascript
document.addEventListener('startappads.reward_video.reward', () => {
//user watched video reward can be given now
//do something here
});
document.addEventListener('startappads.reward_video.load', () => {
//reward video finished loading
//do something here
});
document.addEventListener('startappads.reward_video.closed', () => {
//user closed video reward
//do something here
});
document.addEventListener('startappads.reward_video.clicked', () => {
//user click on video reward
//do something here
});
document.addEventListener('startappads.reward_video.load_fail', () => {
//reward video failed to load. Probably no Ads available at the moment
//do something here
});
```
## Donation [](https://www.paypal.me/LukasReiner/)
If this project help you reduce time to develop, you can give me a cup of coffee (or a Beer of course) :)
[](https://www.paypal.me/LukasReiner/)
## Git - Fork
```
$ git clone https://github.com/lreiner/cordova-plugin-startapp-ads
```
When you fork a project in order to propose changes to the original repository, you can configure Git to pull changes from the original, or upstream, repository into the local clone of your fork.
[Click here to see how to keep a fork synched](https://help.github.com/articles/fork-a-repo/)
## Releases
Too see all published releases, please take a look at the [tags of this repository](https://github.com/lreiner/cordova-plugin-startapp-ads/tags).