setupad-prebid-react-native 0.1.3

package/LICENSE

@@ -0,0 +1,20 @@
+MIT License
+
+Copyright (c) 2025 jahonov
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,325 @@
+# Veon Prebid React Native
+
+A React Native plugin for integrating Veon Prebid SDK with Google Ad Manager (GAM). Supports banner, interstitial, and rewarded video ads with waterfall approach (Prebid → GAM fallback).
+
+## Features
+
+✅ **Banner Ads** - Standard and custom sizes  
+✅ **Interstitial Ads** - Full-screen ads  
+✅ **Rewarded Video Ads** - User-rewarded video ads  
+✅ **Waterfall Approach** - Prebid first, GAM fallback  
+✅ **Explicit Control** - Manual load/show/hide methods  
+✅ **TypeScript Support** - Full type definitions  
+✅ **React Hooks** - `useVeonPrebidAd` hook for easy integration  
+
+## Installation
+
+```bash
+npm install setupad-prebid-react-native
+# or
+yarn add setupad-prebid-react-native
+```
+
+### iOS Setup
+
+1. Add Google Ad Manager App ID to `Info.plist`:
+
+```xml
+<key>GADApplicationIdentifier</key>
+<string>ca-app-pub-################~##########</string>
+```
+
+2. Add SKAdNetworkItems (see [Google's documentation](https://developers.google.com/ad-manager/mobile-ads-sdk/ios/quick-start#update_your_infoplist))
+
+3. Install pods:
+
+```bash
+cd ios && pod install
+```
+
+### Android Setup
+
+1. Add Google Ad Manager App ID to `AndroidManifest.xml`:
+
+```xml
+<application>
+    <meta-data
+        android:name="com.google.android.gms.ads.APPLICATION_ID"
+        android:value="ca-app-pub-################~##########"/>
+</application>
+```
+
+2. Add JitPack repository to `android/build.gradle`:
+
+```gradle
+allprojects {
+    repositories {
+        maven { url 'https://jitpack.io' }
+    }
+}
+```
+
+## Usage
+
+### 1. Initialize SDK
+
+```typescript
+import { VeonPrebidSDK } from 'setupad-prebid-react-native';
+
+// Initialize once at app startup
+await VeonPrebidSDK.getInstance().initialize({
+  prebidHost: 'https://prebid.veonadx.com/openrtb2/auction',
+  configHost: 'https://config.veonadx.com',
+  accountId: 'YOUR_ACCOUNT_ID',
+  timeoutMillis: 3000,
+  pbsDebug: __DEV__,
+});
+```
+
+### 2. Display Banner Ad
+
+```typescript
+import React, { useRef } from 'react';
+import { VeonPrebidAd, AdType, AdController } from 'setupad-prebid-react-native';
+
+function BannerExample() {
+  const adRef = useRef<AdController>(null);
+
+  return (
+    <VeonPrebidAd
+      ref={adRef}
+      adType={AdType.BANNER}
+      configId="YOUR_CONFIG_ID"
+      adUnitId="/YOUR_NETWORK_ID/YOUR_AD_UNIT"
+      width={300}
+      height={250}
+      refreshInterval={60}
+      onAdLoaded={(data) => {
+        console.log('Banner loaded from', data.sdk);
+        adRef.current?.showBanner();
+      }}
+      onAdFailed={(error) => console.error('Banner failed:', error)}
+    />
+  );
+}
+```
+
+### 3. Display Interstitial Ad
+
+```typescript
+import React, { useRef, useEffect } from 'react';
+import { VeonPrebidAd, AdType, AdController } from 'setupad-prebid-react-native';
+
+function InterstitialExample() {
+  const adRef = useRef<AdController>(null);
+
+  useEffect(() => {
+    // Load interstitial on mount
+    adRef.current?.loadInterstitial();
+  }, []);
+
+  const showAd = () => {
+    adRef.current?.showInterstitial();
+  };
+
+  return (
+    <>
+      <VeonPrebidAd
+        ref={adRef}
+        adType={AdType.INTERSTITIAL}
+        configId="YOUR_CONFIG_ID"
+        adUnitId="/YOUR_NETWORK_ID/YOUR_AD_UNIT"
+        onAdLoaded={(data) => console.log('Interstitial loaded')}
+        onAdClosed={() => console.log('Interstitial closed')}
+      />
+      <Button title="Show Interstitial" onPress={showAd} />
+    </>
+  );
+}
+```
+
+### 4. Using Hooks
+
+```typescript
+import { useVeonPrebidAd, AdType } from 'setupad-prebid-react-native';
+
+function HookExample() {
+  const { adRef, loadBanner, showBanner } = useVeonPrebidAd(
+    {
+      adType: AdType.BANNER,
+      configId: 'YOUR_CONFIG_ID',
+      adUnitId: '/YOUR_NETWORK_ID/YOUR_AD_UNIT',
+      width: 300,
+      height: 250,
+    },
+    {
+      onAdLoaded: (data) => {
+        console.log('Ad loaded:', data);
+        showBanner();
+      },
+    }
+  );
+
+  useEffect(() => {
+    loadBanner();
+  }, []);
+
+  return <VeonPrebidAd ref={adRef} />;
+}
+```
+
+## API Reference
+
+### VeonPrebidSDK
+
+Singleton class for SDK initialization.
+
+#### Methods
+
+**`initialize(config: PrebidConfig): Promise<string>`**
+- Initialize Prebid SDK
+- Should be called once at app startup
+
+**`getSDKVersion(): Promise<string>`**
+- Get SDK version
+
+**`isSDKInitialized(): boolean`**
+- Check if SDK is initialized
+
+### VeonPrebidAd Component
+
+#### Props
+
+| Prop | Type | Required | Description |
+|------|------|----------|-------------|
+| `adType` | `AdType` | ✅ | Ad type: `banner`, `interstitial`, or `rewardVideo` |
+| `configId` | `string` | ✅ | Prebid config ID |
+| `adUnitId` | `string` | ✅ | Google Ad Manager ad unit ID |
+| `width` | `number` | For banners | Ad width in pixels |
+| `height` | `number` | For banners | Ad height in pixels |
+| `refreshInterval` | `number` | ❌ | Refresh interval (30-120 seconds, default: 30) |
+| `onAdLoaded` | `function` | ❌ | Called when ad is loaded |
+| `onAdDisplayed` | `function` | ❌ | Called when ad is displayed |
+| `onAdFailed` | `function` | ❌ | Called when ad fails |
+| `onAdClicked` | `function` | ❌ | Called when ad is clicked |
+| `onAdClosed` | `function` | ❌ | Called when ad is closed |
+
+#### Ref Methods (AdController)
+
+```typescript
+interface AdController {
+  loadBanner(): void;
+  showBanner(): void;
+  hideBanner(): void;
+  loadInterstitial(): void;
+  showInterstitial(): void;
+  hideInterstitial(): void;
+  pauseAuction(): void;
+  resumeAuction(): void;
+  destroyAuction(): void;
+}
+```
+
+### useVeonPrebidAd Hook
+
+```typescript
+const {
+  adRef,
+  loadBanner,
+  showBanner,
+  hideBanner,
+  loadInterstitial,
+  showInterstitial,
+  hideInterstitial,
+  pauseAuction,
+  resumeAuction,
+  destroyAuction,
+} = useVeonPrebidAd(config, eventListener);
+```
+
+## Types
+
+```typescript
+enum AdType {
+  BANNER = 'banner',
+  INTERSTITIAL = 'interstitial',
+  REWARD_VIDEO = 'rewardVideo',
+}
+
+interface PrebidConfig {
+  prebidHost: string;
+  configHost: string;
+  accountId: string;
+  timeoutMillis?: number;
+  pbsDebug?: boolean;
+}
+
+interface AdEventData {
+  adId?: string;
+  sdk?: string; // 'PREBID' or 'GAM'
+  message?: string;
+}
+```
+
+## Best Practices
+
+### Banner Ads
+1. Load banner: `adRef.current?.loadBanner()`
+2. Show when loaded: `onAdLoaded={() => adRef.current?.showBanner()}`
+3. Hide if needed: `adRef.current?.hideBanner()`
+
+### Interstitial Ads
+1. Load early: `useEffect(() => adRef.current?.loadInterstitial(), [])`
+2. Show on user action: `adRef.current?.showInterstitial()`
+3. Reload after close: `onAdClosed={() => adRef.current?.loadInterstitial()}`
+
+### Lifecycle Management
+- Pause banner refresh when app goes background: `pauseAuction()`
+- Resume when app comes foreground: `resumeAuction()`
+- Destroy when unmounting: `destroyAuction()`
+
+## Troubleshooting
+
+### Android
+
+**Issue:** Build fails with "Maven repository not found"  
+**Solution:** Add JitPack repository to `android/build.gradle`
+
+**Issue:** Ads not showing  
+**Solution:** Check LogCat for "VeonPrebidView" logs
+
+### iOS
+
+**Issue:** Build fails with "Module not found"  
+**Solution:** Run `cd ios && pod install`
+
+**Issue:** Ads not showing  
+**Solution:** Check Xcode console for "LOG:" messages
+
+## Example App
+
+See the `example/` directory for a complete working example with banner and interstitial ads.
+
+```bash
+cd example
+npm install
+npm run ios
+# or
+npm run android
+```
+
+## Requirements
+
+- React Native >= 0.70
+- iOS >= 11.0
+- Android minSdkVersion >= 21
+
+## License
+
+MIT
+
+## Support
+
+For issues and questions, please visit:
+- GitHub Issues: [veonadtech/veon_prebid_react_native](https://github.com/veonadtech/veon_prebid_react_native/issues)
+- Documentation: [docs.veonadx.com](https://docs.veonadx.com)

package/VeonPrebidReactNative.podspec

@@ -0,0 +1,59 @@
+require "json"
+
+package = JSON.parse(File.read(File.join(__dir__, "package.json")))
+
+Pod::Spec.new do |s|
+  s.name         = "VeonPrebidReactNative"
+  s.version      = package["version"]
+  s.summary      = package["description"]
+  s.description  = <<-DESC
+                  React Native bridge for Veon Prebid SDK
+                   DESC
+  s.homepage     = "https://github.com/veonadtech/veon-prebid-react-native"
+  s.license      = "MIT"
+  s.authors      = { "Veon" => "info@veon.com" }
+  s.platforms    = { :ios => "12.0" }
+  s.source       = { :git => "https://github.com/veonadtech/veon-prebid-react-native.git", :tag => "#{s.version}" }
+
+  s.source_files = "ios/**/*.{h,m,mm,swift}"
+
+  # Install all dependencies
+  s.dependency "React-Core"
+
+  # Fabric (New Architecture) dependencies
+  install_modules_dependencies(s)
+  s.dependency "Google-Mobile-Ads-SDK", "12.3.0"
+  s.dependency "VeonPrebidMobileGAMEventHandlers", "0.0.4"
+  s.dependency "VeonPrebidMobile", "0.0.4"
+  
+  s.static_framework = true
+  s.swift_version = "5.0"
+  
+  # When consumer uses `use_frameworks!`, headers are inside .framework bundles
+  # and need explicit search paths for React Native internal C++ headers
+  if ENV['USE_FRAMEWORKS']
+    s.pod_target_xcconfig = {
+      'DEFINES_MODULE' => 'YES',
+      'EXCLUDED_ARCHS[sdk=iphonesimulator*]' => 'i386',
+      'HEADER_SEARCH_PATHS' => [
+        '"$(PODS_CONFIGURATION_BUILD_DIR)/React-utils/React_utils.framework/Headers"',
+        '"$(PODS_CONFIGURATION_BUILD_DIR)/React-debug/React_debug.framework/Headers"',
+        '"$(PODS_CONFIGURATION_BUILD_DIR)/React-featureflags/React_featureflags.framework/Headers"',
+        '"$(PODS_CONFIGURATION_BUILD_DIR)/React-rendererdebug/React_rendererdebug.framework/Headers"',
+        '"$(PODS_CONFIGURATION_BUILD_DIR)/React-Fabric/React_Fabric.framework/Headers"',
+        '"$(PODS_CONFIGURATION_BUILD_DIR)/React-FabricComponents/React_FabricComponents.framework/Headers"',
+        '"$(PODS_CONFIGURATION_BUILD_DIR)/React-graphics/React_graphics.framework/Headers"',
+        '"$(PODS_CONFIGURATION_BUILD_DIR)/React-graphics/React_graphics.framework/Headers/react/renderer/graphics/platform/ios"',
+        '"$(PODS_CONFIGURATION_BUILD_DIR)/ReactCommon/ReactCommon.framework/Headers/react/nativemodule/core"',
+        '"$(PODS_CONFIGURATION_BUILD_DIR)/ReactCommon/ReactCommon.framework/Headers/react/nativemodule/core/platform/ios"',
+        '"$(PODS_ROOT)/DoubleConversion"',
+        '"$(PODS_ROOT)/RCT-Folly"',
+      ].join(' ')
+    }
+  else
+    s.pod_target_xcconfig = {
+      'DEFINES_MODULE' => 'YES',
+      'EXCLUDED_ARCHS[sdk=iphonesimulator*]' => 'i386',
+    }
+  end
+end

package/android/build.gradle

@@ -0,0 +1,90 @@
+buildscript {
+  ext.getExtOrDefault = {name ->
+    return rootProject.ext.has(name) ? rootProject.ext.get(name) : project.properties['VeonPrebidReactNative_' + name]
+  }
+
+  repositories {
+    google()
+    mavenCentral()
+  }
+
+  dependencies {
+    classpath "com.android.tools.build:gradle:8.7.2"
+    // noinspection DifferentKotlinGradleVersion
+    classpath "org.jetbrains.kotlin:kotlin-gradle-plugin:${getExtOrDefault('kotlinVersion')}"
+  }
+}
+
+
+apply plugin: "com.android.library"
+apply plugin: "kotlin-android"
+
+apply plugin: "com.facebook.react"
+
+def getExtOrIntegerDefault(name) {
+  return rootProject.ext.has(name) ? rootProject.ext.get(name) : (project.properties["VeonPrebidReactNative_" + name]).toInteger()
+}
+
+android {
+  namespace "com.setupadprebidreactnative"
+
+  compileSdkVersion getExtOrIntegerDefault("compileSdkVersion")
+
+  defaultConfig {
+    minSdkVersion getExtOrIntegerDefault("minSdkVersion")
+    targetSdkVersion getExtOrIntegerDefault("targetSdkVersion")
+  }
+
+  buildFeatures {
+    buildConfig true
+  }
+
+  buildTypes {
+    release {
+      minifyEnabled false
+    }
+  }
+
+  lintOptions {
+    disable "GradleCompatible"
+  }
+
+  compileOptions {
+    sourceCompatibility JavaVersion.VERSION_1_8
+    targetCompatibility JavaVersion.VERSION_1_8
+  }
+
+  sourceSets {
+    main {
+      java.srcDirs += [
+        "generated/java",
+        "generated/jni"
+      ]
+    }
+  }
+}
+
+repositories {
+  mavenCentral()
+  google()
+
+  // JitPack repository for Veon Prebid SDK
+  maven { url 'https://jitpack.io' }
+}
+
+def kotlin_version = getExtOrDefault("kotlinVersion")
+
+dependencies {
+  // React Native
+  implementation "com.facebook.react:react-android"
+  implementation "org.jetbrains.kotlin:kotlin-stdlib:$kotlin_version"
+
+  // Google Mobile Ads (AdManager)
+  implementation 'com.google.android.gms:play-services-ads:22.2.0'
+
+  // Veon Prebid SDK
+  implementation 'com.github.veonadtech.prebid-android-sdk:core:0.1.1'
+  implementation 'com.github.veonadtech.prebid-android-sdk:eventhandlers:0.1.1'
+  implementation 'com.github.veonadtech.prebid-android-sdk:mobile:0.1.1'
+  implementation 'com.github.veonadtech.prebid-android-sdk:prebidorg:0.1.1'
+}

package/android/gradle.properties

@@ -0,0 +1,5 @@
+VeonPrebidReactNative_kotlinVersion=2.0.21
+VeonPrebidReactNative_minSdkVersion=21
+VeonPrebidReactNative_targetSdkVersion=34
+VeonPrebidReactNative_compileSdkVersion=35
+VeonPrebidReactNative_ndkVersion=27.1.12297006

package/android/src/main/AndroidManifest.xml

@@ -0,0 +1,4 @@
+<manifest xmlns:android="http://schemas.android.com/apk/res/android">
+  <uses-permission android:name="android.permission.INTERNET" />
+  <uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
+</manifest>

package/android/src/main/java/com/setupadprebidreactnative/VeonPrebidReactNativeModule.kt

@@ -0,0 +1,130 @@
+package com.setupadprebidreactnative
+
+import android.app.Activity
+import android.util.Log
+import com.facebook.react.bridge.*
+import com.facebook.react.modules.core.DeviceEventManagerModule
+import com.google.android.gms.ads.MobileAds
+import org.prebid.mobile.PrebidMobile
+import org.prebid.mobile.api.data.InitializationStatus
+import java.util.concurrent.CompletableFuture
+
+/**
+ * Native module for initializing Prebid SDK and handling SDK-level operations
+ */
+class VeonPrebidReactNativeModule(private val reactContext: ReactApplicationContext) :
+    ReactContextBaseJavaModule(reactContext) {
+
+    private val TAG = "VeonPrebidReactNative"
+    private val activityFuture = CompletableFuture<Activity>()
+
+    override fun getName(): String {
+        return "VeonPrebidReactNativeModule"
+    }
+
+    /**
+     * Initialize Prebid Mobile SDK
+     * @param prebidHost - Prebid server host URL
+     * @param configHost - Configuration host URL
+     * @param accountId - Prebid account ID
+     * @param timeoutMillis - Timeout in milliseconds for bid requests
+     * @param pbsDebug - Enable/disable debug mode
+     * @param promise - Promise to return initialization result
+     */
+    @ReactMethod
+    fun initializeSDK(
+        prebidHost: String,
+        configHost: String,
+        accountId: String,
+        timeoutMillis: Int,
+        pbsDebug: Boolean,
+        promise: Promise
+    ) {
+        try {
+            Log.d(TAG, "Initializing Prebid SDK")
+            Log.d(TAG, "Host: $prebidHost")
+            Log.d(TAG, "Config Host: $configHost")
+            Log.d(TAG, "Account ID: $accountId")
+            Log.d(TAG, "Timeout: $timeoutMillis ms")
+            Log.d(TAG, "Debug: $pbsDebug")
+
+            val activity = reactContext.currentActivity
+            if (activity == null) {
+                promise.reject("NO_ACTIVITY", "Activity is not available")
+                return
+            }
+
+            // Set Prebid account ID
+            PrebidMobile.setPrebidServerAccountId(accountId)
+
+            // Initialize SDK
+            PrebidMobile.initializeSdk(activity.applicationContext, prebidHost, configHost) { status ->
+                when (status) {
+                    InitializationStatus.SUCCEEDED -> {
+                        Log.d(TAG, "Prebid Mobile SDK initialized successfully!")
+                        sendEvent("prebidSdkInitialized", "successfully")
+                        promise.resolve("successfully")
+                    }
+                    InitializationStatus.SERVER_STATUS_WARNING -> {
+                        val message = "Server status warning: ${status.description}"
+                        Log.w(TAG, message)
+                        sendEvent("prebidSdkInitialized", message)
+                        promise.resolve(message)
+                    }
+                    else -> {
+                        val errorMessage = "Initialization error: ${status.description}"
+                        Log.e(TAG, errorMessage)
+                        sendEvent("prebidSdkInitializeFailed", errorMessage)
+                        promise.reject("INIT_FAILED", errorMessage)
+                    }
+                }
+            }
+
+            // Set debug mode
+            PrebidMobile.setPbsDebug(pbsDebug)
+
+            // Check Google Mobile Ads compatibility
+            PrebidMobile.checkGoogleMobileAdsCompatibility(MobileAds.getVersion().toString())
+
+            // Set timeout
+            PrebidMobile.setTimeoutMillis(timeoutMillis)
+
+            // Enable geo location sharing
+            PrebidMobile.setShareGeoLocation(true)
+
+        } catch (e: Exception) {
+            Log.e(TAG, "Error initializing Prebid SDK: ${e.message}", e)
+            promise.reject("INIT_ERROR", "Failed to initialize SDK: ${e.message}", e)
+        }
+    }
+
+    /**
+     * Get Prebid SDK version
+     */
+    @ReactMethod
+    fun getSDKVersion(promise: Promise) {
+        try {
+            val version = PrebidMobile.SDK_VERSION
+            promise.resolve(version)
+        } catch (e: Exception) {
+            promise.reject("VERSION_ERROR", "Failed to get SDK version: ${e.message}", e)
+        }
+    }
+
+    /**
+     * Send event to JavaScript
+     */
+    private fun sendEvent(eventName: String, params: Any?) {
+        try {
+            reactContext
+                .getJSModule(DeviceEventManagerModule.RCTDeviceEventEmitter::class.java)
+                .emit(eventName, params)
+        } catch (e: Exception) {
+            Log.e(TAG, "Error sending event: ${e.message}", e)
+        }
+    }
+
+    companion object {
+        const val NAME = "VeonPrebidReactNativeModule"
+    }
+}

package/android/src/main/java/com/setupadprebidreactnative/VeonPrebidReactNativePackage.kt

@@ -0,0 +1,20 @@
+package com.setupadprebidreactnative
+
+import com.facebook.react.ReactPackage
+import com.facebook.react.bridge.NativeModule
+import com.facebook.react.bridge.ReactApplicationContext
+import com.facebook.react.uimanager.ViewManager
+
+class VeonPrebidReactNativeViewPackage : ReactPackage {
+  override fun createViewManagers(reactContext: ReactApplicationContext): List<ViewManager<*, *>> {
+    return listOf(
+      VeonPrebidReactNativeViewManager(reactContext)
+    )
+  }
+
+  override fun createNativeModules(reactContext: ReactApplicationContext): List<NativeModule> {
+    return listOf(
+      VeonPrebidReactNativeModule(reactContext)
+    )
+  }
+}