emi-indo-cordova-plugin-admob 1.4.3 → 1.4.5
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +456 -219
- package/example/Advanced topics/globalSettings.html +1 -0
- package/example/banner_ads.html +15 -1
- package/example/wewrtr.html +0 -0
- package/package.json +1 -1
- package/plugin.xml +1 -1
- package/src/android/emiAdmobPlugin.java +1 -1
- package/src/ios/emiAdmobPlugin.h +1 -0
- package/src/ios/emiAdmobPlugin.m +2622 -501
- package/www/emiAdmobPlugin.js +15 -16
package/README.md
CHANGED
@@ -1,3 +1,5 @@
|
|
1
|
+
|
2
|
+
|
1
3
|
# emi-indo-cordova-plugin-admob
|
2
4
|
Cordova Plugin Admob Android and IOS
|
3
5
|
|
@@ -9,7 +11,6 @@
|
|
9
11
|
- cordova-android version = 12.0.0
|
10
12
|
- cordova-ios version = 7.0.0
|
11
13
|
|
12
|
-
|
13
14
|
## Minimum macOS | Xcode, and others
|
14
15
|
- Monterey
|
15
16
|
- Xcode 14.1 or higher
|
@@ -17,9 +18,69 @@
|
|
17
18
|
- Target iOS 11.0 or higher
|
18
19
|
https://developers.google.com/admob/ios/quick-start
|
19
20
|
|
21
|
+
<details>
|
22
|
+
<summary>Guaranteed income using this plugin #14</summary>
|
23
|
+
|
24
|
+
> __Note__
|
25
|
+
> - ## It's Not a fork, it's purely rewritten, clean of 3rd party code.
|
26
|
+
|
27
|
+
> __Note__
|
28
|
+
> - ### No Ad-Sharing
|
29
|
+
> - ### No Remote Control
|
30
|
+
> - ### I guarantee 100% revenue for you.
|
31
|
+
> - [Code source:](https://github.com/googleads/googleads-mobile-android-examples) - Admob:
|
32
|
+
> -
|
33
|
+
</details>
|
34
|
+
|
35
|
+
## VIDEO Test Collapsible banner ads
|
36
|
+
- Test Plugin with construct 3
|
37
|
+
|
38
|
+
[](https://youtu.be/uUivVBC0cqs)
|
39
|
+
|
40
|
+
## VIDEO Test UMP or CMP SDK Android
|
41
|
+
- Test Plugin with construct 3
|
42
|
+
|
43
|
+
[](https://youtu.be/lELJRKDrkNk)
|
44
|
+
|
45
|
+
## VIDEO Test UMP or CMP SDK IOS
|
46
|
+
- Test Plugin with construct 3
|
47
|
+
|
48
|
+
[](https://youtu.be/d2dSn4LBvro)
|
49
|
+
|
50
|
+
## VIDEO Test Ad Type with Xcode/IOS
|
51
|
+
- Test Plugin with construct 3
|
52
|
+
|
53
|
+
[](https://youtu.be/YYMJuf7gIsg)
|
20
54
|
|
21
55
|
|
22
56
|
|
57
|
+
|
58
|
+
|
59
|
+
|
60
|
+
## 💰Sponsor this project
|
61
|
+
[](https://paypal.me/emiindo)
|
62
|
+
|
63
|
+
## [Check all release notes:](https://github.com/EMI-INDO/emi-indo-cordova-plugin-admob/releases/)
|
64
|
+
|
65
|
+
## Features
|
66
|
+
<details>
|
67
|
+
<summary>Features #1</summary>
|
68
|
+
<ul>
|
69
|
+
<li> initialize</li>
|
70
|
+
<li> targeting</li>
|
71
|
+
<li> globalSettings</li>
|
72
|
+
<li> AppTrackingTransparency (ATT)</li>
|
73
|
+
<li> CMP SDK</li>
|
74
|
+
<li> UMP SDK</li>
|
75
|
+
<li> App Open Ads</li>
|
76
|
+
<li> Banner Ads</li>
|
77
|
+
<li> Interstitial Ads</li>
|
78
|
+
<li> Rewarded Ads</li>
|
79
|
+
<li> Mediation</li>
|
80
|
+
<li> impression-level-ad-revenue</li>
|
81
|
+
</ul>
|
82
|
+
</details>
|
83
|
+
|
23
84
|
## Installation
|
24
85
|
|
25
86
|
```sh
|
@@ -36,7 +97,7 @@ cordova plugin rm emi-indo-cordova-plugin-admob
|
|
36
97
|
|
37
98
|
|
38
99
|
|
39
|
-
## Import the Mobile Ads SDK
|
100
|
+
## Import the Mobile Ads SDK IOS
|
40
101
|
### Then from the command line run:
|
41
102
|
- cd platforms/ios
|
42
103
|
### Then from the command line run:
|
@@ -44,259 +105,455 @@ cordova plugin rm emi-indo-cordova-plugin-admob
|
|
44
105
|
|
45
106
|
|
46
107
|
|
47
|
-
|
108
|
+
## >>> Device Ready <<<
|
48
109
|
|
49
|
-
|
50
|
-
|
51
|
-
|
52
|
-
|
53
|
-
- [Example requestIDFA:](https://github.com/EMI-INDO/emi-indo-cordova-plugin-admob/blob/main/example/Advanced%20topics/requestIDFA.html) index.html
|
54
|
-
- [Example IABTFC:](https://github.com/EMI-INDO/emi-indo-cordova-plugin-admob/blob/main/example/Advanced%20topics/IABTFC.html) index.html
|
55
|
-
```
|
56
|
-
// Support Platform: Android or IOS
|
57
|
-
<script>
|
110
|
+
<details>
|
111
|
+
<summary>Methods: #2</summary>
|
112
|
+
<pre>
|
113
|
+
// Support Platform: Android | IOS
|
58
114
|
cordova.plugins.emiAdmobPlugin.globalSettings([config_globalSettings]);
|
59
115
|
cordova.plugins.emiAdmobPlugin.targeting([config_Targeting]);
|
60
116
|
cordova.plugins.emiAdmobPlugin.initialize();
|
61
|
-
|
62
|
-
/*
|
63
|
-
cordova.plugins.emiAdmobPlugin.requestIDFA(); // UMP SDK to handle Apple's App Tracking Transparency (ATT) (Platform: IOS)
|
64
|
-
cordova.plugins.emiAdmobPlugin.getIabTfc((IABTFC) => {JSONstringify(IABTFC)}); // CMP SDK 2.2 (Platform: Both)
|
65
|
-
|
66
117
|
// UMP SDK 2.1.0
|
67
118
|
cordova.plugins.emiAdmobPlugin.getConsentRequest(); // (Platform: Both)
|
68
119
|
cordova.plugins.emiAdmobPlugin.consentReset(); // (Platform: Both)
|
69
120
|
cordova.plugins.emiAdmobPlugin.showPrivacyOptionsForm(); // (Platform: Both)
|
70
|
-
|
71
|
-
|
72
|
-
|
73
|
-
|
74
|
-
### AppOpenAd ADS
|
75
|
-
[FULL AppOpenAd basic:](https://github.com/EMI-INDO/emi-indo-cordova-plugin-admob/blob/main/example/app_open_ads.html) index.html
|
76
|
-
```
|
77
|
-
<script>
|
78
|
-
// Support Platform: Android | IOS
|
79
|
-
cordova.plugins.emiAdmobPlugin.loadAppOpenAd([config_AppOpenAd]);
|
80
|
-
cordova.plugins.emiAdmobPlugin.showAppOpenAd();
|
81
|
-
</script>
|
82
|
-
```
|
83
|
-
|
84
|
-
|
85
|
-
### BANNER ADS
|
86
|
-
[FULL Banner basic:](https://github.com/EMI-INDO/emi-indo-cordova-plugin-admob/blob/main/example/banner_ads.html) index.html
|
87
|
-
```
|
88
|
-
// Support Platform: Android | IOS
|
89
|
-
<script>
|
90
|
-
cordova.plugins.emiAdmobPlugin.loadBannerAd([bannerConfig]);
|
91
|
-
cordova.plugins.emiAdmobPlugin.showBannerAd();
|
92
|
-
cordova.plugins.emiAdmobPlugin.hideBannerAd();
|
93
|
-
cordova.plugins.emiAdmobPlugin.removeBannerAd();
|
94
|
-
</script>
|
95
|
-
```
|
96
|
-
|
97
|
-
### Interstitial ADS
|
98
|
-
[FULL Interstitial basic:](https://github.com/EMI-INDO/emi-indo-cordova-plugin-admob/blob/main/example/interstitial_ads.html) index.html
|
99
|
-
```
|
100
|
-
// Support Platform: Android | IOS
|
101
|
-
<script>
|
102
|
-
cordova.plugins.emiAdmobPlugin.loadInterstitialAd([config_Interstitial]);
|
103
|
-
cordova.plugins.emiAdmobPlugin.showInterstitialAd();
|
104
|
-
</script>
|
105
|
-
```
|
121
|
+
// CMP SDK 2.2.0
|
122
|
+
cordova.plugins.emiAdmobPlugin.requestIDFA(); // UMP SDK to handle Apple's App Tracking Transparency (ATT) (Platform: IOS)
|
123
|
+
cordova.plugins.emiAdmobPlugin.getIabTfc((IABTFC) => { console.log(JSONstringify(IABTFC)) }); // CMP SDK 2.2 (Platform: Both)
|
106
124
|
|
125
|
+
</pre>
|
126
|
+
<details>
|
127
|
+
<summary>Note setDebugGeography #2</summary>
|
128
|
+
Testing is very easy, no need for VPN, TEST-DEVICE-HASHED-ID, or anything else, everything has been made programmatically.
|
107
129
|
|
108
|
-
|
109
|
-
|
110
|
-
|
111
|
-
// Support Platform: Android | IOS
|
112
|
-
<script>
|
113
|
-
cordova.plugins.emiAdmobPlugin.loadRewardedInterstitialAd([config_rewardedInt]);
|
114
|
-
cordova.plugins.emiAdmobPlugin.showRewardedInterstitialAd();
|
115
|
-
</script>
|
116
|
-
```
|
117
|
-
|
118
|
-
### Rewarded ADS
|
119
|
-
[FULL Rewarded basic:](https://github.com/EMI-INDO/emi-indo-cordova-plugin-admob/blob/main/example/rewarded_ads.html) index.html
|
120
|
-
```
|
121
|
-
// Support Platform: Android | IOS
|
122
|
-
<script>
|
123
|
-
cordova.plugins.emiAdmobPlugin.loadRewardedAd([config_rewarded]);
|
124
|
-
cordova.plugins.emiAdmobPlugin.showRewardedAd();
|
125
|
-
</script>
|
126
|
-
```
|
130
|
+
must be false if the application is released to the play store / app store.
|
131
|
+
consent from will continue to be called regardless of its status 0,1,2,3,
|
132
|
+
until the value is changed to false.
|
127
133
|
|
134
|
+
setDebugGeography = true | false
|
135
|
+
</details>
|
136
|
+
<li>example</li></ul>
|
137
|
+
<pre>
|
138
|
+
|
128
139
|
|
140
|
+
document.addEventListener("deviceready", function(){
|
141
|
+
|
142
|
+
const config_globalSettings = [
|
143
|
+
|
144
|
+
setAppMuted = false, // default: false
|
145
|
+
setAppVolume = 1, // float: default: 1
|
146
|
+
enableSameAppKey = false, // default: false
|
147
|
+
npa = "1", // string "0" | "1"
|
148
|
+
enableCollapsible = true, // (BETA) activate the collapsible banner ads
|
149
|
+
responseInfo = false, // default: false
|
150
|
+
setDebugGeography = false // default: false
|
151
|
+
|
152
|
+
]
|
153
|
+
|
154
|
+
cordova.plugins.emiAdmobPlugin.getConsentRequest( (ststus) => { console.log("Consent Status: " + ststus) });
|
155
|
+
cordova.plugins.emiAdmobPlugin.globalSettings(config_globalSettings);
|
156
|
+
|
157
|
+
document.addEventListener('on.get.consent.status', () => {
|
158
|
+
// Regardless of the state, call SDK initialize
|
159
|
+
|
160
|
+
cordova.plugins.emiAdmobPlugin.initialize();
|
161
|
+
cordova.plugins.emiAdmobPlugin.getIabTfc((IABTFC) => { console.log(JSONstringify(IABTFC)) });
|
162
|
+
});
|
129
163
|
|
164
|
+
}, false);
|
130
165
|
|
166
|
+
</pre>
|
131
167
|
|
168
|
+
</details>
|
132
169
|
|
133
170
|
|
134
|
-
|
135
|
-
|
171
|
+
<details>
|
172
|
+
<summary>Event UMP SDK #3</summary>
|
173
|
+
<pre>
|
174
|
+
on.get.consent.status
|
175
|
+
<br>
|
176
|
+
</pre>
|
177
|
+
<li>example:#4</li></ul>
|
178
|
+
<pre>
|
179
|
+
document.addEventListener('on.get.consent.status', () => {
|
136
180
|
|
137
|
-
|
138
|
-
document.addEventListener('on.appOpenAd.loaded', () => {
|
181
|
+
console.log("on get consent status");
|
139
182
|
|
140
|
-
|
183
|
+
});
|
184
|
+
</pre>
|
185
|
+
</details>
|
186
|
+
|
187
|
+
<details>
|
188
|
+
<summary>Event CMP SDK #5</summary>
|
189
|
+
<pre>
|
190
|
+
on.getIabTfc
|
191
|
+
on.TCString.expired
|
192
|
+
on.TCString.remove
|
193
|
+
<br>
|
194
|
+
</pre>
|
195
|
+
|
196
|
+
<details>
|
197
|
+
<summary>Note #6</summary>
|
198
|
+
TCString expires 360 days, plugin automatically deletes it after 360 days. call consentRest()
|
199
|
+
</details>
|
200
|
+
<li>example: #7</li></ul>
|
201
|
+
<pre>
|
202
|
+
document.addEventListener('on.TCString.expired', () => {
|
203
|
+
|
204
|
+
console.log("on TCString expires 360 days");
|
205
|
+
cordova.plugins.emiAdmobPlugin.consentReset();
|
141
206
|
|
142
207
|
});
|
208
|
+
</pre>
|
209
|
+
</details>
|
143
210
|
|
144
|
-
```
|
145
211
|
|
146
|
-
> __Note__
|
147
|
-
### (final) cannot be changed.
|
148
212
|
|
149
|
-
## ( SDK )
|
150
|
-
- on.sdkInitialization
|
151
213
|
|
152
|
-
|
214
|
+
- [AppTrackingTransparency (ATT) framework:](https://developer.apple.com/documentation/apptrackingtransparency/attrackingmanager/authorizationstatus)
|
215
|
+
- [Consent Management Platform API:](https://github.com/InteractiveAdvertisingBureau/GDPR-Transparency-and-Consent-Framework/blob/master/TCFv2/IAB%20Tech%20Lab%20-%20CMP%20API%20v2.md#in-app-details)
|
153
216
|
|
154
|
-
|
217
|
+
- [Example Get Consent Status:](https://github.com/EMI-INDO/emi-indo-cordova-plugin-admob/blob/main/example/Advanced%20topics/consent.html) index.html
|
218
|
+
- [Example requestIDFA:](https://github.com/EMI-INDO/emi-indo-cordova-plugin-admob/blob/main/example/Advanced%20topics/requestIDFA.html) index.html
|
219
|
+
- [Example IABTFC:](https://github.com/EMI-INDO/emi-indo-cordova-plugin-admob/blob/main/example/Advanced%20topics/IABTFC.html) index.html
|
155
220
|
|
156
|
-
- on.appOpenAd.loaded
|
157
|
-
- on.appOpenAd.failed.loaded
|
158
221
|
|
159
|
-
### Event Show
|
160
222
|
|
161
|
-
|
162
|
-
- on.appOpenAd.failed.show
|
163
|
-
- on.appOpenAd.show
|
164
|
-
### NEW
|
165
|
-
- on.appOpenAd.revenue
|
223
|
+
## Global Variable adunitId
|
166
224
|
|
225
|
+
```
|
226
|
+
<script>
|
227
|
+
Ad format Demo ad unit ID
|
228
|
+
// https://developers.google.com/admob/android/test-ads
|
229
|
+
// https://developers.google.com/admob/ios/test-ads
|
230
|
+
|
231
|
+
var App_Open_ID;
|
232
|
+
var Banner_ID;
|
233
|
+
var Interstitial_ID;
|
234
|
+
var Rewarded_ID;
|
235
|
+
var Rewarded_Interstitial_ID;
|
236
|
+
|
237
|
+
if (window.cordova.platformId === 'ios') {
|
238
|
+
|
239
|
+
App_Open_ID = 'ca-app-pub-3940256099942544/5575463023';
|
240
|
+
Banner_ID = 'ca-app-pub-3940256099942544/2934735716';
|
241
|
+
Interstitial_ID = 'ca-app-pub-3940256099942544/4411468910';
|
242
|
+
Rewarded_ID = 'ca-app-pub-3940256099942544/1712485313';
|
243
|
+
Rewarded_Interstitial_ID = 'ca-app-pub-3940256099942544/6978759866';
|
244
|
+
|
245
|
+
} else {
|
246
|
+
// Assume Android
|
247
|
+
App_Open_ID = 'ca-app-pub-3940256099942544/9257395921';
|
248
|
+
Banner_ID = 'ca-app-pub-3940256099942544/6300978111';
|
249
|
+
Interstitial_ID = 'ca-app-pub-3940256099942544/1033173712';
|
250
|
+
Rewarded_ID = 'ca-app-pub-3940256099942544/5224354917';
|
251
|
+
Rewarded_Interstitial_ID = 'ca-app-pub-3940256099942544/5354046379';
|
252
|
+
}
|
253
|
+
</script>
|
254
|
+
```
|
167
255
|
|
168
|
-
## ( Banner Ads )
|
169
256
|
|
170
|
-
|
257
|
+
## AppOpenAd ADS
|
258
|
+
|
259
|
+
<details>
|
260
|
+
<summary>Methods:</summary>
|
261
|
+
<pre>
|
262
|
+
// Support Platform: Android | IOS
|
263
|
+
cordova.plugins.emiAdmobPlugin.loadAppOpenAd([config_AppOpenAd]);
|
264
|
+
cordova.plugins.emiAdmobPlugin.showAppOpenAd();
|
265
|
+
<br>
|
266
|
+
</pre>
|
267
|
+
<li>example:</li></ul>
|
268
|
+
<pre>
|
269
|
+
|
270
|
+
// WARNING config must be an array[] not an object{}
|
271
|
+
// adUnitId = call Global Variable
|
272
|
+
|
273
|
+
cordova.plugins.emiAdmobPlugin.loadAppOpenAd([ adUnitId = App_Open_ID, autoShow = true ]);
|
274
|
+
</pre>
|
275
|
+
</details>
|
276
|
+
|
277
|
+
<details>
|
278
|
+
<summary>Event</summary>
|
279
|
+
<pre>
|
280
|
+
on.appOpenAd.loaded
|
281
|
+
on.appOpenAd.failed.loaded
|
282
|
+
on.appOpenAd.dismissed
|
283
|
+
on.appOpenAd.failed.show
|
284
|
+
on.appOpenAd.show
|
285
|
+
on.appOpenAd.revenue
|
286
|
+
<br>
|
287
|
+
</pre>
|
288
|
+
<li>example:</li></ul>
|
289
|
+
<pre>
|
290
|
+
document.addEventListener('on.appOpenAd.loaded', () => {
|
171
291
|
|
172
|
-
|
173
|
-
- top-center
|
174
|
-
- left
|
175
|
-
- center
|
176
|
-
- right
|
177
|
-
- bottom-center
|
178
|
-
- bottom-right
|
292
|
+
console.log("On App Open Ad loaded");
|
179
293
|
|
294
|
+
});
|
295
|
+
</pre>
|
296
|
+
</details>
|
180
297
|
|
298
|
+
- [FULL AppOpenAd basic:](https://github.com/EMI-INDO/emi-indo-cordova-plugin-admob/blob/main/example/app_open_ads.html) -index.html
|
181
299
|
|
182
|
-
### size
|
183
300
|
|
184
|
-
- ANCHORED
|
185
|
-
- IN_LINE
|
186
|
-
- FULL_WIDTH
|
187
|
-
- BANNER
|
188
|
-
- FLUID
|
189
|
-
- LARGE_BANNER
|
190
|
-
- MEDIUM_RECTANGLE
|
191
|
-
- FULL_BANNER
|
192
|
-
- LEADERBOARD
|
193
|
-
- adaptive_Width = number
|
194
|
-
- Smart Banners = DEPRECATED
|
195
301
|
|
302
|
+
|
303
|
+
## BANNER ADS
|
196
304
|
|
197
|
-
|
305
|
+
<details>
|
306
|
+
<summary>Methods:</summary>
|
307
|
+
<pre>
|
308
|
+
cordova.plugins.emiAdmobPlugin.loadBannerAd([bannerConfig]);
|
309
|
+
cordova.plugins.emiAdmobPlugin.showBannerAd();
|
310
|
+
cordova.plugins.emiAdmobPlugin.hideBannerAd();
|
311
|
+
cordova.plugins.emiAdmobPlugin.removeBannerAd();
|
312
|
+
</pre>
|
313
|
+
<li>example:</li></ul>
|
314
|
+
<pre>
|
315
|
+
// WARNING config must be an array[] not an object{}
|
316
|
+
// adUnitId = call Global Variable
|
317
|
+
|
318
|
+
const bannerConfig = [
|
319
|
+
|
320
|
+
adUnitId = Banner_ID,
|
321
|
+
position = "bottom-center",
|
322
|
+
size = "BANNER",
|
323
|
+
collapsible = "bottom", // (BETA) enable in globalSettings
|
324
|
+
adaptive_Width = 320, // Ignored
|
325
|
+
autoShow = true // boolean
|
326
|
+
|
327
|
+
]
|
328
|
+
|
329
|
+
cordova.plugins.emiAdmobPlugin.loadBannerAd(bannerConfig);
|
330
|
+
|
331
|
+
</pre>
|
332
|
+
</details>
|
333
|
+
|
334
|
+
<details>
|
335
|
+
<summary>Position type string</summary>
|
336
|
+
<pre>
|
337
|
+
top-right
|
338
|
+
top-center
|
339
|
+
left
|
340
|
+
center
|
341
|
+
right
|
342
|
+
bottom-center
|
343
|
+
bottom-right
|
344
|
+
</pre>
|
345
|
+
</details>
|
346
|
+
|
347
|
+
<details>
|
348
|
+
<summary>Size type string</summary>
|
349
|
+
<pre>
|
350
|
+
ANCHORED
|
351
|
+
IN_LINE
|
352
|
+
FULL_WIDTH
|
353
|
+
BANNER
|
354
|
+
FLUID
|
355
|
+
LARGE_BANNER
|
356
|
+
MEDIUM_RECTANGLE
|
357
|
+
FULL_BANNER
|
358
|
+
LEADERBOARD
|
359
|
+
adaptive_Width = number
|
360
|
+
</pre>
|
361
|
+
</details>
|
362
|
+
|
363
|
+
<details>
|
364
|
+
<summary>Event</summary>
|
365
|
+
<pre>
|
366
|
+
on.banner.load
|
367
|
+
on.banner.failed.load
|
368
|
+
on.banner.click
|
369
|
+
on.banner.close
|
370
|
+
on.banner.impression
|
371
|
+
on.banner.open
|
372
|
+
// new
|
373
|
+
on.banner.revenue
|
374
|
+
on.banner.remove
|
375
|
+
on.banner.hide
|
376
|
+
</pre>
|
377
|
+
<li>example:</li></ul>
|
378
|
+
<pre>
|
379
|
+
document.addEventListener('on.banner.load', () => {
|
380
|
+
|
381
|
+
console.log("on banner load");
|
382
|
+
|
383
|
+
});</pre>
|
384
|
+
</details>
|
198
385
|
|
199
|
-
-
|
200
|
-
- on.banner.failed.load
|
386
|
+
[FULL Banner basic:](https://github.com/EMI-INDO/emi-indo-cordova-plugin-admob/blob/main/example/banner_ads.html) index.html
|
201
387
|
|
202
|
-
### Event Show
|
203
388
|
|
204
|
-
|
205
|
-
- on.banner.close
|
206
|
-
- on.banner.impression
|
207
|
-
- on.banner.open
|
208
|
-
### NEW
|
209
|
-
- on.banner.revenue
|
210
|
-
- on.banner.remove
|
211
|
-
- on.banner.hide
|
212
|
-
|
389
|
+
## Interstitial ADS
|
213
390
|
|
214
391
|
|
392
|
+
<details>
|
393
|
+
<summary>Methods:</summary>
|
394
|
+
<pre>
|
395
|
+
// Support Platform: Android | IOS
|
396
|
+
cordova.plugins.emiAdmobPlugin.loadInterstitialAd([config_Interstitial]);
|
397
|
+
cordova.plugins.emiAdmobPlugin.showInterstitialAd();
|
398
|
+
<br>
|
399
|
+
</pre>
|
400
|
+
<li>example:</li></ul>
|
401
|
+
<pre>
|
402
|
+
|
403
|
+
// WARNING config must be an array[] not an object{}
|
404
|
+
// adUnitId = call Global Variable
|
405
|
+
|
406
|
+
cordova.plugins.emiAdmobPlugin.loadInterstitialAd([ adUnitId = Interstitial_ID, autoShow = true ]);
|
407
|
+
</pre>
|
408
|
+
</details>
|
409
|
+
|
410
|
+
<details>
|
411
|
+
<summary>Event</summary>
|
412
|
+
<pre>
|
413
|
+
on.interstitial.loaded
|
414
|
+
on.interstitial.failed.load
|
415
|
+
on.interstitial.click
|
416
|
+
on.interstitial.dismissed
|
417
|
+
on.interstitial.failed.show
|
418
|
+
on.interstitial.impression
|
419
|
+
on.interstitial.show
|
420
|
+
// new
|
421
|
+
on.interstitial.revenue
|
422
|
+
<br>
|
423
|
+
</pre>
|
424
|
+
<li>example:</li></ul>
|
425
|
+
<pre>
|
426
|
+
document.addEventListener('on.interstitial.loaded', () => {
|
427
|
+
|
428
|
+
console.log("on interstitial Ad loaded");
|
215
429
|
|
216
|
-
|
430
|
+
});
|
431
|
+
</pre>
|
432
|
+
</details>
|
217
433
|
|
218
|
-
### Event Load
|
219
434
|
|
220
|
-
-
|
221
|
-
- on.interstitial.failed.load
|
435
|
+
[FULL Interstitial basic:](https://github.com/EMI-INDO/emi-indo-cordova-plugin-admob/blob/main/example/interstitial_ads.html) index.html
|
222
436
|
|
223
|
-
### Event Show
|
224
437
|
|
225
|
-
- on.interstitial.click
|
226
|
-
- on.interstitial.dismissed
|
227
|
-
- on.interstitial.failed.show
|
228
|
-
- on.interstitial.impression
|
229
|
-
- on.interstitial.show
|
230
|
-
### NEW
|
231
|
-
- on.interstitial.revenue
|
232
438
|
|
233
439
|
|
440
|
+
## Rewarded Interstitial ADS
|
234
441
|
|
235
442
|
|
236
443
|
|
237
|
-
|
444
|
+
<details>
|
445
|
+
<summary>Methods:</summary>
|
446
|
+
<pre>
|
447
|
+
// Support Platform: Android | IOS
|
448
|
+
cordova.plugins.emiAdmobPlugin.loadRewardedInterstitialAd([config_rewardedInt]);
|
449
|
+
cordova.plugins.emiAdmobPlugin.showRewardedInterstitialAd();
|
450
|
+
<br>
|
451
|
+
</pre>
|
452
|
+
<li>example:</li></ul>
|
453
|
+
<pre>
|
454
|
+
|
455
|
+
// WARNING config must be an array[] not an object{}
|
456
|
+
// adUnitId = call Global Variable
|
457
|
+
|
458
|
+
cordova.plugins.emiAdmobPlugin.loadRewardedInterstitialAd([ adUnitId = Rewarded_Interstitial_ID, autoShow = true ]);
|
459
|
+
</pre>
|
460
|
+
</details>
|
461
|
+
|
462
|
+
<details>
|
463
|
+
<summary>Event</summary>
|
464
|
+
<pre>
|
465
|
+
on.rewardedInt.loaded
|
466
|
+
on.rewardedInt.failed.load
|
467
|
+
on.rewardedInt.click
|
468
|
+
on.rewardedInt.dismissed
|
469
|
+
on.rewardedInt.failed.show
|
470
|
+
on.rewardedInt.impression
|
471
|
+
on.rewardedInt.showed
|
472
|
+
on.rewardedInt.userEarnedReward
|
473
|
+
// new
|
474
|
+
on.rewardedInt.revenue
|
475
|
+
on.rewardedInt.ad.skip
|
476
|
+
<br>
|
477
|
+
</pre>
|
478
|
+
<li>example:</li></ul>
|
479
|
+
<pre>
|
480
|
+
document.addEventListener('on.rewardedInt.loaded', () => {
|
481
|
+
|
482
|
+
console.log("on rewarded Interstitial load");
|
238
483
|
|
239
|
-
|
484
|
+
});
|
485
|
+
</pre>
|
486
|
+
</details>
|
240
487
|
|
241
|
-
-
|
242
|
-
- on.rewarded.failed.load
|
488
|
+
[FULL Rewarded Interstitial basic:](https://github.com/EMI-INDO/emi-indo-cordova-plugin-admob/blob/main/example/rewarded_interstitial_ads.html) index.html
|
243
489
|
|
244
490
|
|
245
|
-
### Event Show
|
246
491
|
|
247
|
-
|
248
|
-
- on.rewarded.dismissed
|
249
|
-
- on.rewarded.failed.show
|
250
|
-
- on.rewarded.impression
|
251
|
-
- on.rewarded.show
|
252
|
-
### NEW
|
253
|
-
- on.rewarded.revenue
|
254
|
-
- on.rewarded.ad.skip
|
255
|
-
- on.reward.userEarnedReward
|
492
|
+
## Rewarded ADS
|
256
493
|
|
257
494
|
|
258
495
|
|
259
|
-
|
496
|
+
<details>
|
497
|
+
<summary>Methods:</summary>
|
498
|
+
<pre>
|
499
|
+
// Support Platform: Android | IOS
|
500
|
+
cordova.plugins.emiAdmobPlugin.loadRewardedAd([config_rewarded]);
|
501
|
+
cordova.plugins.emiAdmobPlugin.showRewardedAd();
|
502
|
+
<br>
|
503
|
+
</pre>
|
504
|
+
<li>example:</li></ul>
|
505
|
+
<pre>
|
506
|
+
// adUnitId = call Global Variable
|
507
|
+
|
508
|
+
cordova.plugins.emiAdmobPlugin.loadRewardedAd([ adUnitId = Rewarded_ID, autoShow = true ]);
|
509
|
+
</pre>
|
510
|
+
</details>
|
511
|
+
|
512
|
+
<details>
|
513
|
+
<summary>Event</summary>
|
514
|
+
<pre>
|
515
|
+
on.rewarded.loaded
|
516
|
+
on.rewarded.failed.load
|
517
|
+
on.rewarded.click
|
518
|
+
on.rewarded.dismissed
|
519
|
+
on.rewarded.failed.show
|
520
|
+
on.rewarded.impression
|
521
|
+
on.rewarded.show
|
522
|
+
on.reward.userEarnedReward
|
523
|
+
// new
|
524
|
+
on.rewarded.revenue
|
525
|
+
on.rewarded.ad.skip
|
526
|
+
|
527
|
+
<br>
|
528
|
+
</pre>
|
529
|
+
<li>example:</li></ul>
|
530
|
+
<pre>
|
531
|
+
document.addEventListener('on.rewarded.loaded', () => {
|
532
|
+
|
533
|
+
console.log("on rewarded Ad loaded");
|
260
534
|
|
261
|
-
|
535
|
+
});
|
536
|
+
</pre>
|
537
|
+
</details>
|
538
|
+
|
539
|
+
[FULL Rewarded basic:](https://github.com/EMI-INDO/emi-indo-cordova-plugin-admob/blob/main/example/rewarded_ads.html) index.html
|
262
540
|
|
263
|
-
- on.rewardedInt.loaded
|
264
|
-
- on.rewardedInt.failed.load
|
265
541
|
|
266
542
|
|
267
|
-
### Event Show
|
268
543
|
|
269
|
-
- on.rewardedInt.click
|
270
|
-
- on.rewardedInt.dismissed
|
271
|
-
- on.rewardedInt.failed.show
|
272
|
-
- on.rewardedInt.impression
|
273
|
-
- on.rewardedInt.showed
|
274
|
-
### NEW
|
275
|
-
- on.rewardedInt.revenue
|
276
|
-
- on.rewardedInt.ad.skip
|
277
|
-
- on.rewardedInt.userEarnedReward
|
278
544
|
|
279
545
|
|
280
546
|
|
281
547
|
|
282
548
|
|
283
|
-
> __Note__
|
284
|
-
> - ## It's Not a fork, it's purely rewritten, clean of 3rd party code.
|
285
549
|
|
286
|
-
> __Note__
|
287
|
-
> - ### No Ad-Sharing
|
288
|
-
> - ### No Remote Control
|
289
|
-
> - ### I guarantee 100% revenue for you.
|
290
|
-
> - [Code source:](https://github.com/googleads/googleads-mobile-android-examples) - Admob:
|
291
550
|
|
292
551
|
|
293
|
-
## 💰Sponsor this project
|
294
|
-
[](https://paypal.me/emiindo)
|
295
|
-
|
296
|
-
## [Check all release notes:](https://github.com/EMI-INDO/emi-indo-cordova-plugin-admob/releases/)
|
297
552
|
|
298
553
|
|
299
554
|
|
555
|
+
<details>
|
556
|
+
<summary>Features and Coming soon #13</summary>
|
300
557
|
|
301
558
|
## Features
|
302
559
|
|
@@ -326,38 +583,16 @@ alert("On App Open Ad loaded");
|
|
326
583
|
- https://github.com/InteractiveAdvertisingBureau/GDPR-Transparency-and-Consent-Framework/ ( Finished ) v1.4.0 [index.html](https://github.com/EMI-INDO/emi-indo-cordova-plugin-admob/blob/main/example/Advanced%20topics/consent_GDPR_IAB_TFCv2.2.html)
|
327
584
|
|
328
585
|
|
586
|
+
</details>
|
329
587
|
|
330
588
|
|
331
589
|
|
332
590
|
|
333
591
|
|
334
|
-
|
335
|
-
> __Note__
|
336
|
-
>
|
337
|
-
|
338
|
-
> - # Plugin version @1.4.0
|
339
|
-
|
340
|
-
### [ GDPR | IAB TFC code example: ](https://github.com/EMI-INDO/emi-indo-cordova-plugin-admob/blob/main/example/Advanced%20topics/consent_GDPR_IAB_TFCv2.2.html)
|
341
|
-
- replace all AdUnitId to adUnitId
|
342
|
-
- new banner size: FULL_WIDTH
|
343
|
-
### New only on github
|
344
|
-
https://github.com/EMI-INDO/emi-indo-cordova-plugin-admob/releases/tag/%401.4.0
|
345
|
-
|
346
|
-
> - # Plugin version @1.3.9
|
347
|
-
|
348
|
-
[FULL Example ](https://github.com/EMI-INDO/emi-indo-cordova-plugin-admob/blob/main/example/) - index.html:
|
349
|
-
|
350
|
-
### [ App Open Ad code example: ](https://github.com/EMI-INDO/emi-indo-cordova-plugin-admob/blob/main/example/app_open_ads.html)
|
351
|
-
### [ Banner Ad code example: ](https://github.com/EMI-INDO/emi-indo-cordova-plugin-admob/blob/main/example/banner_ads.html)
|
352
|
-
### [ Interstitial Ad code example: ](https://github.com/EMI-INDO/emi-indo-cordova-plugin-admob/blob/main/example/interstitial_ads.html)
|
353
|
-
### [ Rewarded interstitial Ad code example: ](https://github.com/EMI-INDO/emi-indo-cordova-plugin-admob/blob/main/example/rewarded_interstitial_ads.html)
|
354
|
-
### [ Rewarded Ad code example: ](https://github.com/EMI-INDO/emi-indo-cordova-plugin-admob/blob/main/example/rewarded_ads.html)
|
355
|
-
|
356
|
-
### [ Advanced topics: ](https://github.com/EMI-INDO/emi-indo-cordova-plugin-admob/tree/main/example/Advanced%20topics)
|
357
|
-
|
358
592
|
# IAB Europe Transparency & Consent Framework
|
359
|
-
### Example How to read consent choices
|
360
593
|
|
594
|
+
<details>
|
595
|
+
<summary>Example How to read consent choices #12</summary>
|
361
596
|
|
362
597
|
// index.html https://github.com/EMI-INDO/emi-indo-cordova-plugin-admob/blob/main/example/Advanced%20topics/consent_GDPR_IAB_TFCv2.2.html
|
363
598
|
```sh
|
@@ -408,11 +643,17 @@ alert("On App Open Ad loaded");
|
|
408
643
|
|
409
644
|
```
|
410
645
|
|
411
|
-
|
646
|
+
</details>
|
412
647
|
|
413
648
|
|
414
649
|
|
415
650
|
# Admob Mediation
|
651
|
+
|
652
|
+
<details>
|
653
|
+
<summary>Mediation #9</summary>
|
654
|
+
|
655
|
+
|
656
|
+
|
416
657
|
<img src="https://user-images.githubusercontent.com/78555833/229587307-91a7e380-aa2d-4140-a62d-fa8e6a8dd153.png" width="500">
|
417
658
|
|
418
659
|
|
@@ -487,10 +728,16 @@ cordova plugin add emi-indo-cordova-plugin-mediation-chartboost
|
|
487
728
|
```sh
|
488
729
|
cordova plugin add emi-indo-cordova-plugin-mediation-ironsource
|
489
730
|
```
|
731
|
+
</details>
|
490
732
|
|
491
733
|
|
492
734
|
|
493
735
|
## Variables name or preference name
|
736
|
+
|
737
|
+
<details>
|
738
|
+
<summary>Variables name #10</summary>
|
739
|
+
|
740
|
+
|
494
741
|
> __Warning__
|
495
742
|
> This is so that if I don't have time to update the Mediation Adapter version later, you can do it yourself as below.
|
496
743
|
|
@@ -522,24 +769,10 @@ cordova plugin add emi-indo-cordova-plugin-mediation-meta --variable META_ADAPTE
|
|
522
769
|
- IRONSOURCE_ADAPTER_VERSION
|
523
770
|
|
524
771
|
- ================================
|
772
|
+
</details>
|
525
773
|
|
526
774
|
|
527
|
-
emi-indo-cordova-plugin-admob@0.0.5
|
528
|
-
|
529
|
-
|
530
|
-
> - ## Note Release
|
531
|
-
- [emi-indo-cordova-plugin-admob@0.0.4](https://github.com/EMI-INDO/emi-indo-cordova-plugin-admob/releases/tag/%400.0.4)
|
532
|
-
|
533
|
-
- [emi-indo-cordova-plugin-admob@0.0.5](https://github.com/EMI-INDO/emi-indo-cordova-plugin-admob/releases/tag/v0.0.5)
|
534
|
-
|
535
|
-
<img src="https://user-images.githubusercontent.com/78555833/231241800-8834ca2a-fa95-4cc2-91ca-1478c6b3c1ef.jpg" width="250">
|
536
775
|
|
537
|
-
- [emi-indo-cordova-plugin-admob@0.0.6](https://github.com/EMI-INDO/emi-indo-cordova-plugin-admob/releases/tag/v0.0.6)
|
538
|
-
|
539
|
-
|
540
|
-
### Platform Support
|
541
|
-
- Android
|
542
|
-
- IOS
|
543
776
|
|
544
777
|
|
545
778
|
## 💰Sponsor this project
|
@@ -547,6 +780,10 @@ emi-indo-cordova-plugin-admob@0.0.5
|
|
547
780
|
|
548
781
|
|
549
782
|
## Earn more money, with other ad networks.
|
783
|
+
|
784
|
+
<details>
|
785
|
+
<summary>Other plugins #11</summary>
|
786
|
+
|
550
787
|
- ### emi-indo-cordova-plugin-fan
|
551
788
|
|
552
789
|
[Facebook Audience Network:](https://github.com/EMI-INDO/emi-indo-cordova-plugin-fan) - Ads:
|
@@ -567,4 +804,4 @@ emi-indo-cordova-plugin-admob@0.0.5
|
|
567
804
|
- ### emi-indo-cordova-plugin-fanalytics
|
568
805
|
|
569
806
|
[Cordova Plugin Firebase Analytics:](https://github.com/EMI-INDO/emi-indo-cordova-plugin-fanalytics) - Firebase Analytics:
|
570
|
-
|
807
|
+
</details>
|