feat: add ppid option to request options (#153)

* feat: add ppid option to request options
* fix: run lint fixes

android/src/main/java/io/invertase/googlemobileads/ReactNativeGoogleMobileAdsCommon.java

@@ -183,6 +183,11 @@ public static AdManagerAdRequest buildAdRequest(ReadableMap adRequestOptions) {
       }
     }
 
+    if (adRequestOptions.hasKey("publisherProvidedId")) {
+      builder.setPublisherProvidedId(
+          Objects.requireNonNull(adRequestOptions.getString("publisherProvidedId")));
+    }
+
     return builder.build();
   }
 

ios/RNGoogleMobileAds/RNGoogleMobileAdsCommon.m

@@ -83,6 +83,10 @@ + (GAMRequest *)buildAdRequest:(NSDictionary *)adRequestOptions {
     request.customTargeting = adRequestOptions[@"customTargeting"];
   }
 
+  if (adRequestOptions[@"publisherProvidedId"]) {
+    request.publisherProvidedID = adRequestOptions[@"publisherProvidedId"];
+  }
+
   return request;
 }
 

src/types/RequestOptions.ts

@@ -93,4 +93,11 @@ export interface RequestOptions {
    * See [Google Mobile SDK Docs](https://developers.google.com/admob/android/ssv) for more information.
    */
   serverSideVerificationOptions?: ServerSideVerificationOptions;
+
+  /**
+   * Publisher provided identifier (PPID) for use in frequency capping, audience segmentation and targeting,
+   * sequential ad rotation, and other audience-based ad delivery controls across devices.
+   * See [this article](https://support.google.com/admanager/answer/2880055) for more information.
+   */
+  publisherProvidedId?: string;
 }

src/validateAdRequestOptions.ts

@@ -126,5 +126,12 @@ export function validateAdRequestOptions(options?: RequestOptions) {
     out.customTargeting = options.customTargeting;
   }
 
+  if (options.publisherProvidedId) {
+    if (!isString(options.publisherProvidedId)) {
+      throw new Error("'options.publisherProvidedId' expected a string value");
+    }
+    out.publisherProvidedId = options.publisherProvidedId;
+  }
+
   return out;
 }