emi-indo-cordova-plugin-admob 0.0.9 → 1.1.9

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.
Files changed (16) hide show
  1. package/.github/ISSUE_TEMPLATE/bug_report.md +124 -0
  2. package/README.md +137 -347
  3. package/example/Advanced topics/auto_load_and_show.html +94 -0
  4. package/example/{consent.html → Advanced topics/consent.html } +51 -22
  5. package/example/Advanced topics/globalSettings.html +39 -0
  6. package/example/Advanced topics/targeting.html +78 -0
  7. package/example/app_open_ads.html +151 -0
  8. package/example/banner_ads.html +248 -0
  9. package/example/interstitial_ads.html +166 -0
  10. package/example/rewarded_ads.html +185 -0
  11. package/example/rewarded_interstitial_ads.html +184 -0
  12. package/package.json +1 -1
  13. package/plugin.xml +8 -5
  14. package/src/android/emiAdmobPlugin.java +1 -1
  15. package/www/emiAdmobPlugin.js +24 -16
  16. package/example/index.html +0 -296
package/example/{consent.html → Advanced topics/consent.html } RENAMED
@@ -14,7 +14,7 @@
14
14
 
15
15
  let _getConsentRequest = () => {
16
16
  cordova.plugins.emiAdmobPlugin.getConsentRequest(
17
- setTagForUnderAgeOfConsent = false, // boolean
17
+ // Setting Targeting in Device Ready
18
18
 
19
19
  (status) => { alert(status) }, // check event code
20
20
  (error) => { alert(error)
@@ -35,20 +35,61 @@ let _consentReset = () => {
35
35
 
36
36
 
37
37
 
38
- document.addEventListener("deviceready", function(){
39
38
 
40
39
 
41
40
 
41
+ ///// >>>>>> Device Ready <<<<<<
42
+
43
+ document.addEventListener("deviceready", function(){
44
+
45
+ cordova.plugins.emiAdmobPlugin.initialize();
42
46
 
43
- document.addEventListener('onConsentInfoUpdateSuccess', () => {
47
+ cordova.plugins.emiAdmobPlugin.targeting(
48
+ TagForChildDirectedTreatment = 0, // value: 0 | -1 | 1
49
+ TagForUnderAgeOfConsent = 0, // // value: 0 | -1 | 1
50
+ MaxAdContentRating = "G", // value: G | MA | PG | T | ""
44
51
 
45
- alert("on Consent Info Update Success");
52
+ // Optional
53
+ (info) => { console.log(info)},
54
+ (error) => { console.log(error)
55
+
56
+ });
57
+
58
+
59
+
60
+
61
+
62
+
63
+
64
+
65
+
66
+ // Consent Event
67
+
68
+
69
+ /*
70
+ on.consent.info.update
71
+ on.consent.info.update.failed
72
+
73
+ on.consent.status.not_required
74
+ on.consent.status.obtained
75
+ on.consent.status.required
76
+ on.consent.status.unknown
77
+
78
+ on.consent.failed.show
79
+ on.consent.failed.load.from
80
+ on.consent.form.not.available
81
+ */
82
+
83
+
84
+ document.addEventListener('on.consent.info.update', () => {
85
+
86
+ alert("on.consent.info.update");
46
87
 
47
88
  });
48
89
 
49
- document.addEventListener('onConsentInfoUpdateFailure', () => {
90
+ document.addEventListener('on.consent.info.update.failed', () => {
50
91
 
51
- alert("on Consen Info Update Failure");
92
+ alert("on.consent.info.update.failed");
52
93
 
53
94
  });
54
95
 
@@ -56,45 +97,33 @@ alert("on Consen Info Update Failure");
56
97
 
57
98
  // https://developers.google.com/admob/android/privacy/api/reference/com/google/android/ump/ConsentInformation.ConsentStatus
58
99
 
59
- document.addEventListener('on.ConsentStatus.NOT_REQUIRED', () => {
100
+ document.addEventListener('on.consent.status.not_required', () => {
60
101
  // Constant Value: 1
61
102
  alert("User consent not required.");
62
103
 
63
104
  });
64
105
 
65
- document.addEventListener('on.ConsentStatus.OBTAINED', () => {
106
+ document.addEventListener('on.consent.status.obtained', () => {
66
107
  // Constant Value: 3
67
108
  alert("User consent obtained. Personalized vs non-personalized undefined.");
68
109
 
69
110
  });
70
111
 
71
- document.addEventListener('on.ConsentStatus.REQUIRED', () => {
112
+ document.addEventListener('on.consent.status.required', () => {
72
113
  // Constant Value: 2
73
114
  // is Consent Form Available = the code auto, load Consent Form and consent Form show.
74
115
  alert("User consent required but not yet obtained.");
75
116
 
76
117
  });
77
118
 
78
- document.addEventListener('on.ConsentStatus.UNKNOWN', () => {
119
+ document.addEventListener('on.consent.status.unknown', () => {
79
120
  //Constant Value: 0
80
121
  alert("Consent status is unknown.");
81
122
 
82
123
  });
83
124
 
84
125
 
85
- ////////////////////////////////////////////////////////////
86
-
87
- document.addEventListener('on.loadConsentFormError', () => {
88
126
 
89
- alert("on load Consent Form Error");
90
-
91
- });
92
-
93
- document.addEventListener('on.ConsentFormNotAvailable', () => {
94
-
95
- alert("on Consent Form Not Available");
96
-
97
- });
98
127
 
99
128
 
100
129
 
package/example/Advanced topics/globalSettings.html ADDED
@@ -0,0 +1,39 @@
1
+ <html>
2
+ <head>
3
+ <script type="text/javascript" src="cordova.js"></script>
4
+ </head>
5
+ <body>
6
+
7
+ <script>
8
+
9
+
10
+ // ### As suggested by Google, when the SDK initializes this plugin automatically takes the Global Settings and Targeting values.
11
+
12
+ // ### Global Settings
13
+
14
+ ///// >>>>>> Device Ready <<<<<<
15
+
16
+ document.addEventListener("deviceready", function(){
17
+
18
+ // Before loading ads, have your app initialize the Google Mobile Ads SDK by calling
19
+ // This needs to be done only once, ideally at app launch.
20
+
21
+ cordova.plugins.emiAdmobPlugin.initialize();
22
+
23
+ // Instruction: https://developers.google.com/admob/android/global-settings
24
+
25
+ cordova.plugins.emiAdmobPlugin.globalSettings(
26
+
27
+ setAppMuted = false, // Type Boolean default: false
28
+ setAppVolume = 1.0, // Type float
29
+ enableSameAppKey = false // Type Boolean default: false
30
+
31
+ });
32
+
33
+
34
+ }, false);
35
+ </script>
36
+
37
+
38
+ </body>
39
+ </html>
package/example/Advanced topics/targeting.html ADDED
@@ -0,0 +1,78 @@
1
+ <html>
2
+ <head>
3
+ <script type="text/javascript" src="cordova.js"></script>
4
+ </head>
5
+ <body>
6
+
7
+ <script>
8
+
9
+
10
+ // ### As suggested by Google, when the SDK initializes this plugin automatically takes the Global Settings and Targeting values.
11
+
12
+ // ### Targeting
13
+
14
+ ///// >>>>>> Device Ready <<<<<<
15
+
16
+ document.addEventListener("deviceready", function(){
17
+
18
+ // Before loading ads, have your app initialize the Google Mobile Ads SDK by calling
19
+ // This needs to be done only once, ideally at app launch.
20
+
21
+ cordova.plugins.emiAdmobPlugin.initialize();
22
+
23
+ //(Auto Loaded during SDK initialize and ad loaded)
24
+
25
+ // You can see the value when the ad is loaded, set responseInfo = true
26
+
27
+ // Instruction: https://developers.google.com/admob/android/targeting
28
+ // Overview: https://developers.google.com/android/reference/com/google/android/gms/ads/RequestConfiguration
29
+
30
+ cordova.plugins.emiAdmobPlugin.targeting(
31
+ TagForChildDirectedTreatment = 0, // value: 0 | -1 | 1
32
+ TagForUnderAgeOfConsent = 0, // // value: 0 | -1 | 1
33
+ MaxAdContentRating = "G", // value: G | MA | PG | T | ""
34
+
35
+ // Optional
36
+ (info) => { console.log(info)},
37
+ (error) => { console.log(error)
38
+
39
+ });
40
+
41
+ // >>>>>>>>>>> Description <<<<<<<<<<<<<<<
42
+
43
+ // (TagForChildDirectedTreatment)
44
+ // Type number:
45
+ // value: 0 | -1 | 1
46
+ // (value description)
47
+ // 0 = FALSE
48
+ // 1 = TRUE
49
+ // -1 = UNSPECIFIED
50
+ // (if else/undefined = false/0)
51
+
52
+ ///////////////////////////////
53
+
54
+ // (TagForUnderAgeOfConsent)
55
+ // Type number:
56
+ // value: 0 | -1 | 1
57
+ // (value description)
58
+ // 0 = FALSE
59
+ // 1 = TRUE
60
+ // -1 = UNSPECIFIED
61
+ // (if else/undefined = false/0)
62
+
63
+ //////////////////////////////
64
+
65
+ // (MaxAdContentRating)
66
+ // Type String:
67
+ // value: G | MA | PG | T | ""
68
+ // (value description)
69
+ // https://developers.google.com/admob/unity/reference/class/google-mobile-ads/api/max-ad-content-rating
70
+ // (if else/undefined/"" = NULL)
71
+
72
+
73
+ }, false);
74
+ </script>
75
+
76
+
77
+ </body>
78
+ </html>
package/example/app_open_ads.html ADDED
@@ -0,0 +1,151 @@
1
+ <html>
2
+ <head>
3
+ <script type="text/javascript" src="cordova.js"></script>
4
+ </head>
5
+ <body>
6
+
7
+ <label for="event">Debug Event All response :</label>
8
+ <textarea id="event" name="event" rows="5" cols="40"></textarea>
9
+
10
+ <script>
11
+
12
+ let event = document.getElementById('event');
13
+
14
+ let cleanText = () => { event.value = '' };
15
+
16
+ let debug = false;
17
+
18
+
19
+ // load App Open Ad
20
+
21
+ let loadAppOpenAd = () => {
22
+
23
+ cordova.plugins.emiAdmobPlugin.loadAppOpenAd(
24
+ AdUnitId = "ca-app-pub-3940256099942544/3419835294",
25
+ npa = "1", // String | 0 | 1
26
+ responseInfo = debug, // boolean
27
+
28
+ (info) => {
29
+
30
+ if (debug === true) {
31
+
32
+ event.value += "\n ResponseInfo: " + info; // responseInfo = true
33
+
34
+ } else
35
+ if (debug === false) {
36
+
37
+ // responseInfo = false
38
+ // event name: on.appOpenAd.revenue
39
+
40
+ event.value += "\n Micros: " + info.micros;
41
+ event.value += "\n Currency: " + info.currency;
42
+ event.value += "\n Precision: " + info.precision;
43
+ event.value += "\n AdUnitId: " + info.adUnitId;
44
+
45
+ }
46
+
47
+ },
48
+ (error) => {
49
+
50
+ event.value += "\n Error: " + error
51
+
52
+ });
53
+ }
54
+
55
+ // Show App Open Ad
56
+
57
+ let showAppOpenAd = () => {
58
+ cordova.plugins.emiAdmobPlugin.showAppOpenAd();
59
+ }
60
+
61
+
62
+ ///// >>>>>> Device Ready <<<<<<
63
+
64
+
65
+ document.addEventListener("deviceready", function(){
66
+
67
+ // Before loading ads, have your app initialize the Google Mobile Ads SDK by calling
68
+ // This needs to be done only once, ideally at app launch.
69
+
70
+ cordova.plugins.emiAdmobPlugin.initialize(
71
+ // Optional
72
+ (info) => {
73
+ event.value += (info)
74
+ },
75
+ (error) => {
76
+
77
+ event.value += (error)
78
+
79
+ });
80
+
81
+ // SDK EVENT Initialization
82
+
83
+ document.addEventListener('on.sdkInitialization', () => {
84
+
85
+ event.value += ("\n On Sdk Initialization");
86
+
87
+
88
+ });
89
+
90
+
91
+ // App Open Ad EVENT
92
+
93
+ /*
94
+ on.appOpenAd.loaded
95
+ on.appOpenAd.failed.loaded
96
+ on.appOpenAd.dismissed
97
+ on.appOpenAd.failed.show
98
+ on.appOpenAd.show
99
+ on.appOpenAd.revenue
100
+ */
101
+
102
+
103
+ document.addEventListener('on.appOpenAd.loaded', () => {
104
+
105
+ event.value += ("\n on.appOpenAd.loaded");
106
+
107
+ });
108
+
109
+ document.addEventListener('on.appOpenAd.failed.loaded', () => {
110
+
111
+ event.value += ("\n on.appOpenAd.failed.loaded");
112
+
113
+ });
114
+
115
+ document.addEventListener('on.appOpenAd.dismissed', () => {
116
+
117
+ event.value += ("\n on.appOpenAd.dismissed");
118
+
119
+ });
120
+
121
+ document.addEventListener('on.appOpenAd.failed.show', () => {
122
+
123
+ event.value += ("\n on.appOpenAd.failed.show");
124
+
125
+ });
126
+
127
+ document.addEventListener('on.appOpenAd.show', () => {
128
+
129
+ event.value += ("\n on.appOpenAd.show");
130
+
131
+ });
132
+
133
+ document.addEventListener('on.appOpenAd.revenue', () => {
134
+
135
+ event.value += ("\n on.appOpenAd.revenue");
136
+
137
+ });
138
+
139
+
140
+ }, false);
141
+
142
+ </script>
143
+
144
+ <p> <button onclick="loadAppOpenAd();">load App Open Ad</button></p>
145
+ <p> <button onclick="showAppOpenAd();">Show App Open Ad</button></p>
146
+
147
+ <p> <button onclick="cleanText();">Clean response Text</button></p>
148
+
149
+
150
+ </body>
151
+ </html>
package/example/banner_ads.html ADDED
@@ -0,0 +1,248 @@
1
+ <html>
2
+ <head>
3
+ <script type="text/javascript" src="cordova.js"></script>
4
+ </head>
5
+ <body>
6
+
7
+ <label for="event">Debug Event All response :</label>
8
+ <textarea id="event" name="event" rows="5" cols="40"></textarea>
9
+
10
+ <script>
11
+
12
+ let event = document.getElementById('event');
13
+
14
+ let cleanText = () => { event.value = '' };
15
+
16
+ let debug = false;
17
+
18
+ /*
19
+ >>>>>>>>>> Banner position <<<<<<<<<<<<<<
20
+
21
+ top-right
22
+ top-center
23
+ left
24
+ center
25
+ right
26
+ bottom-center
27
+ bottom-right
28
+
29
+ >>>>>>>>>>> Banner size <<<<<<<<<<<<
30
+ ( Ad Size Adaptive )
31
+
32
+ Anchored_adaptive
33
+ Inline_adaptive
34
+ default: Adaptive_FULL_WIDTH
35
+ adaptiveWidth = number/default = 320
36
+
37
+ ( Ad Size not Adaptive )
38
+
39
+ BANNER
40
+ FLUID
41
+ LARGE_BANNER
42
+ MEDIUM_RECTANGLE
43
+ FULL_BANNER
44
+ LEADERBOARD
45
+
46
+ Smart Banners = DEPRECATED ( Replaced by Adaptive_FULL_WIDTH )
47
+
48
+ */
49
+
50
+ // // Note adaptiveWidth = 320, // This is special size = "Inline_adaptive" or "Anchored_adaptive" if else this field will be ignored
51
+
52
+ // Adaptive banner
53
+
54
+ let loadBannerAdaptive = () => {
55
+
56
+ cordova.plugins.emiAdmobPlugin.loadBannerAd(
57
+ AdUnitId = "ca-app-pub-3940256099942544/6300978111",
58
+ npa = "1", // String | 0 | 1
59
+ position = "bottom-center",
60
+ size = "default", // Inline_adaptive | Anchored_adaptive | default = Adaptive_FULL_WIDTH
61
+ adaptiveWidth = 320,
62
+ responseInfo = debug, // boolean
63
+
64
+ (info) => {
65
+
66
+ if (debug === true) {
67
+
68
+ event.value += "\n ResponseInfo: " + info; // responseInfo = true
69
+
70
+ }
71
+
72
+ },
73
+ (error) => {
74
+
75
+ event.value += "\n Error: " + error
76
+
77
+ });
78
+ }
79
+
80
+
81
+
82
+ // not Adaptive banner
83
+
84
+ let loadBannerNotAdaptive = () => {
85
+ cordova.plugins.emiAdmobPlugin.loadBannerAd(
86
+ AdUnitId = "ca-app-pub-3940256099942544/6300978111",
87
+ npa = "1", // String | 0 | 1
88
+ position = "bottom-center",
89
+ size = "BANNER",
90
+ adaptiveWidth = 320, // Ignored
91
+ responseInfo = false, // boolean
92
+
93
+
94
+ (info) => {
95
+
96
+ if (debug === true) {
97
+
98
+ event.value += "\n ResponseInfo: " + info; // responseInfo = true
99
+
100
+ }
101
+
102
+ },
103
+ (error) => {
104
+
105
+ event.value += "\n Error: " + error
106
+
107
+ });
108
+ }
109
+
110
+
111
+
112
+ // show Banner Ad
113
+
114
+ let showBannerAd = () => {
115
+
116
+ cordova.plugins.emiAdmobPlugin.showBannerAd(
117
+
118
+ (info) => {
119
+ // event name: on.banner.revenue
120
+ event.value += "\n Micros: " + info.micros;
121
+ event.value += "\n Currency: " + info.currency;
122
+ event.value += "\n Precision: " + info.precision;
123
+ event.value += "\n AdUnitId: " + info.adUnitId;
124
+
125
+ },
126
+ (error) => {
127
+
128
+ event.value += "\n Error: " + error
129
+
130
+ });
131
+
132
+ }
133
+
134
+
135
+ // Remove Banner
136
+
137
+ let removeBannerAd = () => {
138
+ cordova.plugins.emiAdmobPlugin.removeBannerAd();
139
+ }
140
+
141
+
142
+ ///// >>>>>> Device Ready <<<<<<
143
+
144
+
145
+ document.addEventListener("deviceready", function(){
146
+
147
+ // Before loading ads, have your app initialize the Google Mobile Ads SDK by calling
148
+ // This needs to be done only once, ideally at app launch.
149
+
150
+ cordova.plugins.emiAdmobPlugin.initialize(
151
+ // Optional
152
+ (info) => {
153
+ event.value += (info)
154
+ },
155
+ (error) => {
156
+
157
+ event.value += (error)
158
+
159
+ });
160
+
161
+ // SDK EVENT Initialization
162
+
163
+ document.addEventListener('on.sdkInitialization', () => {
164
+
165
+ event.value += ("\n On Sdk Initialization");
166
+
167
+
168
+ });
169
+
170
+
171
+ // Banner Ad EVENT
172
+
173
+ /*
174
+ on.banner.load
175
+ on.banner.failed.load
176
+ on.banner.click
177
+ on.banner.close
178
+ on.banner.impression
179
+ on.banner.open
180
+ on.banner.revenue
181
+ on.banner.remove
182
+ */
183
+
184
+
185
+ document.addEventListener('on.banner.load', () => {
186
+
187
+ event.value += ("\n on.banner.load");
188
+
189
+ });
190
+
191
+ document.addEventListener('on.banner.failed.load', () => {
192
+
193
+ event.value += ("\n on.banner.failed.load");
194
+
195
+ });
196
+
197
+ document.addEventListener('on.banner.click', () => {
198
+
199
+ event.value += ("\n on.banner.click");
200
+
201
+ });
202
+
203
+ document.addEventListener('on.banner.close', () => {
204
+
205
+ event.value += ("\n on.banner.close");
206
+
207
+ });
208
+
209
+ document.addEventListener('on.banner.impression', () => {
210
+
211
+ event.value += ("\n on.banner.impression");
212
+
213
+ });
214
+
215
+ document.addEventListener('on.banner.open', () => {
216
+
217
+ event.value += ("\n on.banner.open");
218
+
219
+ });
220
+
221
+ document.addEventListener('on.banner.revenue', () => {
222
+
223
+ event.value += ("\n on.banner.revenue");
224
+
225
+ });
226
+
227
+ document.addEventListener('on.banner.remove', () => {
228
+
229
+ event.value += ("\n on.banner.remove");
230
+
231
+ });
232
+
233
+
234
+ }, false);
235
+
236
+ </script>
237
+
238
+ <p> <button onclick="loadBannerAdaptive();">load Banner adaptive</button></p>
239
+ <p> <button onclick="loadBannerNotAdaptive();">load Banner No Adaptive</button></p>
240
+ <p> <button onclick="showBannerAd();">show Banner Ad</button></p>
241
+ <p> <button onclick="removeBannerAd();">remove Banner Ad</button></p>
242
+
243
+
244
+ <p> <button onclick="cleanText();">Clean response Text</button></p>
245
+
246
+
247
+ </body>
248
+ </html>