Allows to send an user identifier to be used in Validating Server-Side Verification (SSV) Callbacks

docs/README.md

@@ -241,6 +241,7 @@ AdMob.setOptions({
     job: "sailor",
     age: "23",
     interest: ["boats","ports"],
+	userId: "YOUR_USER_IDENTIFIER" // necessary if you plan to use some kind of server validation to reward-videos https://developers.google.com/admob/android/rewarded-video-ssv
   },
 });
 ```
@@ -379,6 +380,7 @@ Extra key/value for param **options**
 - **error**, *function*, call back when fail.
 
 > Note: it will take some time to get Ad resource before it can be showed. You may buffer the Ad by calling **prepareRewardVideoAd**, and show it later.
+> Note #2: if you plan to use some kind of server-side validation to reward your users, please use the setConfig method to provide identifier of the user seeing the video before prepare any video. Ref.: https://developers.google.com/admob/android/rewarded-video-ssv.
 
 ## AdMob.showRewardVideoAd() ##
 

src/android/AdMobPlugin.java

@@ -64,7 +64,8 @@ public class AdMobPlugin extends GenericAdPlugin {
   public static final String OPT_FORFAMILY = "forFamily";
   public static final String OPT_CONTENTURL = "contentUrl";
   public static final String OPT_CUSTOMTARGETING = "customTargeting";
-  public static final String OPT_EXCLUDE = "exclude";
+  public static final String OPT_EXCLUDE = "exclude";  
+  public static final String OPT_USER_ID = "userId";
 
   protected String mGender = null;
   protected String mForChild = null;
@@ -140,6 +141,9 @@ public void setOptions(JSONObject options) {
     }
     if(options.has(OPT_EXCLUDE)) {
       mExclude = options.optJSONArray(OPT_EXCLUDE);
+    }    
+    if(options.has(OPT_USER_ID)) {
+      mUserId = options.optString(OPT_USER_ID);
     }
   }
 
@@ -310,6 +314,10 @@ protected Object __prepareRewardVideoAd(String adId) {
     RewardedVideoAd ad = MobileAds.getRewardedVideoAdInstance(getActivity());
     ad.setRewardedVideoAdListener(new RewardVideoListener());
 
+    // if an useId is set, provide it to admob and it will be sent in server callback verification
+    if(mUserId != null)
+      ad.setUserId(mUserId);
+
     synchronized (mLock) {
       if (!mIsRewardedVideoLoading) {
         mIsRewardedVideoLoading = true;

src/ios/CDVAdMobPlugin.m

@@ -34,6 +34,7 @@
 #define OPT_CONTENTURL      @"contentURL"
 #define OPT_CUSTOMTARGETING @"customTargeting"
 #define OPT_EXCLUDE         @"exclude"
+#define OPT_USER_ID         @"userId"
 
 @interface CDVAdMobPlugin()<GADBannerViewDelegate, GADInterstitialDelegate, GADRewardBasedVideoAdDelegate>
 
@@ -122,6 +123,10 @@ - (void) parseOptions:(NSDictionary *)options
     arr = [options objectForKey:OPT_EXCLUDE];
     if(arr != nil) {
         self.mExclude = arr;
+    }    
+    str = [options objectForKey:OPT_USER_ID];
+    if(str != nil){
+        self.mUserId = str;
     }
 }
 
@@ -339,6 +344,9 @@ - (void) __destroyInterstitial:(NSObject*)interstitial {
 
 - (NSObject*) __prepareRewardVideoAd:(NSString*)adId {
     [GADRewardBasedVideoAd sharedInstance].delegate = self;
+    if (self.mUserId) {
+        [GADRewardBasedVideoAd sharedInstance].userIdentifier = self.mUserId;
+    }
     [[GADRewardBasedVideoAd sharedInstance] loadRequest:[GADRequest request]
                                            withAdUnitID:adId];
     return nil;