@bigcrunch/react-native-ads 0.3.0 → 0.4.0

package/README.md

@@ -4,12 +4,20 @@ Simplified in-app advertising for React Native apps with Prebid and Google Ad Ma
 
 ## Features
 
-- 🎯 **Simple Integration**: One SDK to handle Prebid, Google Ad Manager, and Amazon demand
-- 📊 **Built-in Analytics**: Automatic tracking of impressions, clicks, and revenue
-- 💰 **Revenue Optimization**: Server-side header bidding via Prebid Server
-- 🔧 **Configuration-Driven**: Manage placements from BigCrunch dashboard
-- 📱 **Cross-Platform**: Supports both iOS and Android
-- 🎨 **Ad Formats**: Banner, Interstitial, and Rewarded ads
+- **Simple Integration**: One SDK to handle Prebid, Google Ad Manager, and Amazon demand
+- **Built-in Analytics**: Automatic tracking of screen views, impressions, clicks, and revenue
+- **Revenue Optimization**: Server-side header bidding via Prebid Server
+- **Configuration-Driven**: Manage placements and ad sizes from the BigCrunch dashboard
+- **Cross-Platform**: Supports both iOS and Android
+- **Ad Formats**: Banner, Interstitial, and Rewarded ads
+
+## Requirements
+
+- React Native 0.60+
+- iOS 13.0+
+- Android API 21+
+- **Bare React Native** project (not Expo managed workflow)
+  - If using Expo, you must first run `expo prebuild` to generate native directories
 
 ## Installation
 
@@ -22,248 +30,318 @@ yarn add @bigcrunch/react-native-ads
 ### iOS Setup
 
 ```bash
-cd ios && pod install
+cd ios && pod install && cd ..
 ```
 
 Add the following to your `Info.plist`:
 
 ```xml
 <key>GADApplicationIdentifier</key>
-<string>YOUR_ADMOB_APP_ID</string>
-
-<key>SKAdNetworkItems</key>
-<array>
-  <!-- Add SKAdNetwork identifiers -->
-</array>
+<string>YOUR_GAM_APP_ID</string>
 ```
 
+> For testing, you can use the Google test ID: `ca-app-pub-3940256099942544~1458002511`
+
 ### Android Setup
 
-Add the following to your `AndroidManifest.xml`:
+Add the following inside the `<application>` tag in your `AndroidManifest.xml`:
 
 ```xml
 <meta-data
     android:name="com.google.android.gms.ads.APPLICATION_ID"
-    android:value="YOUR_ADMOB_APP_ID"/>
+    android:value="YOUR_GAM_APP_ID"/>
 ```
 
+> For testing, you can use: `ca-app-pub-3940256099942544~3347511713`
+
 ## Quick Start
 
 ### 1. Initialize the SDK
 
 ```typescript
+import { useEffect } from 'react';
 import { BigCrunchAds } from '@bigcrunch/react-native-ads';
 
-// Initialize at app startup (e.g., in App.tsx)
-async function initializeAds() {
-  try {
-    await BigCrunchAds.initialize(
-      'your-property-id',
-      'production' // or 'sandbox'
-    );
-    console.log('BigCrunch Ads initialized successfully');
-  } catch (error) {
-    console.error('Failed to initialize BigCrunch Ads:', error);
-  }
-}
+const PROPERTY_ID = 'YOUR_PROPERTY_ID';
+
+function App() {
+  useEffect(() => {
+    initializeBigCrunch();
+  }, []);
 
-// Call on app launch
-initializeAds();
+  const initializeBigCrunch = async () => {
+    try {
+      await BigCrunchAds.initialize(PROPERTY_ID, 'production');
+      console.log('BigCrunch SDK initialized');
+    } catch (error) {
+      console.error('BigCrunch initialization failed:', error);
+    }
+  };
+
+  return (
+    // Your app content
+  );
+}
 ```
 
+| Parameter | Description |
+|-----------|-------------|
+| `PROPERTY_ID` | Unique identifier for your app, provided by BigCrunch |
+| `environment` | `'production'` for live apps, `'sandbox'` for testing |
+
 ### 2. Track Screen Views
 
 ```typescript
+import { useEffect } from 'react';
 import { BigCrunchAds } from '@bigcrunch/react-native-ads';
 
-// Track screen views for analytics
-BigCrunchAds.trackScreenView('HomeScreen');
+function HomeScreen() {
+  useEffect(() => {
+    BigCrunchAds.trackScreenView('HomeScreen');
+  }, []);
+
+  return (
+    // Screen content
+  );
+}
 ```
 
+> For automatic tracking with React Navigation, see the [Tracking-Only Integration Guide](./docs/TRACKING_ONLY_INTEGRATION.md#option-b-automatic-tracking-with-react-navigation-recommended).
+
 ## Ad Formats
 
 ### Banner Ads
 
+Ad sizes are configured per placement in the BigCrunch dashboard. You only need to pass the `placementId` — the SDK handles the rest.
+
 ```tsx
 import { BigCrunchBannerView } from '@bigcrunch/react-native-ads';
 
-function HomeScreen() {
+function ArticleScreen() {
   return (
-    <View>
-      {/* Your content */}
+    <View style={{ flex: 1 }}>
+      <Text>Article content...</Text>
 
       <BigCrunchBannerView
-        placementId="banner-home"
-        size="BANNER" // or "MEDIUM_RECTANGLE", "ADAPTIVE", etc.
-        style={{ alignSelf: 'center' }}
+        placementId="your-banner-placement"
         onAdLoaded={() => console.log('Banner loaded')}
-        onAdFailedToLoad={(error) => console.error('Banner failed:', error)}
-        onAdRevenue={(revenue) => console.log('Revenue:', revenue)}
+        onAdFailedToLoad={(error) => console.error('Banner failed:', error.message)}
       />
     </View>
   );
 }
 ```
 
+#### Props
+
+| Prop | Type | Default | Description |
+|------|------|---------|-------------|
+| `placementId` | `string` | *required* | Placement ID from the BigCrunch dashboard |
+| `size` | `BannerSize \| { width, height }` | *from config* | Optional size override. If omitted, uses the size from placement config. |
+| `autoLoad` | `boolean` | `true` | Automatically load ad on mount |
+| `refreshInterval` | `number` | `0` | Auto-refresh interval in seconds (0 = disabled) |
+| `customTargeting` | `Record<string, string>` | — | Custom key-value targeting |
+| `style` | `ViewStyle` | — | Container style |
+
+#### Callbacks
+
+| Callback | Description |
+|----------|-------------|
+| `onAdLoaded` | Ad loaded successfully |
+| `onAdFailedToLoad` | Ad failed to load. Receives `AdError` with `code` and `message`. |
+| `onAdImpression` | Ad impression recorded |
+| `onAdClicked` | User tapped the ad |
+| `onAdOpened` | Ad opened an overlay |
+| `onAdClosed` | Ad overlay closed |
+| `onAdRevenue` | Revenue event received (ILRD). Receives `AdRevenue` with `valueMicros` and `currencyCode`. |
+
 #### Available Banner Sizes
 
-- `BANNER` - 320x50
-- `LARGE_BANNER` - 320x100
-- `MEDIUM_RECTANGLE` - 300x250
-- `FULL_BANNER` - 468x60
-- `LEADERBOARD` - 728x90
-- `ADAPTIVE` - Full-width adaptive banner (recommended). Google calculates the optimal height for the device screen width.
-- `SMART` - Deprecated, alias for `ADAPTIVE`
-- Custom size: `{ width: 300, height: 250 }`
+| Size | Dimensions | Description |
+|------|-----------|-------------|
+| `'BANNER'` | 320x50 | Standard banner |
+| `'LARGE_BANNER'` | 320x100 | Large banner |
+| `'MEDIUM_RECTANGLE'` | 300x250 | Medium rectangle (MREC) |
+| `'FULL_BANNER'` | 468x60 | Full-size banner |
+| `'LEADERBOARD'` | 728x90 | Leaderboard (tablets) |
+| `'ADAPTIVE'` | Full width, auto height | Adaptive banner (recommended) |
 
 ### Interstitial Ads
 
+Full-screen ads shown at natural transition points. Preload ahead of time, then show when ready.
+
 ```typescript
+import { useEffect, useRef } from 'react';
 import { BigCrunchInterstitial } from '@bigcrunch/react-native-ads';
+import type { EventSubscription } from '@bigcrunch/react-native-ads';
+
+const PLACEMENT_ID = 'interstitial-level-complete';
+
+function GameScreen() {
+  const subscriptions = useRef<EventSubscription[]>([]);
+
+  useEffect(() => {
+    // Preload on mount
+    BigCrunchInterstitial.load({ placementId: PLACEMENT_ID });
+
+    // Set up listeners
+    subscriptions.current.push(
+      BigCrunchInterstitial.addEventListener(PLACEMENT_ID, 'adClosed', () => {
+        // Preload the next interstitial
+        BigCrunchInterstitial.load({ placementId: PLACEMENT_ID });
+      }),
+      BigCrunchInterstitial.addEventListener(PLACEMENT_ID, 'adFailedToLoad', (event) => {
+        console.error('Interstitial failed:', event.error.message);
+      })
+    );
 
-// Load an interstitial
-async function loadInterstitial() {
-  try {
-    await BigCrunchInterstitial.load({
-      placementId: 'interstitial-level-complete'
-    });
-    console.log('Interstitial loaded');
-  } catch (error) {
-    console.error('Failed to load interstitial:', error);
-  }
-}
+    return () => {
+      subscriptions.current.forEach((sub) => sub.remove());
+      BigCrunchInterstitial.destroy(PLACEMENT_ID);
+    };
+  }, []);
 
-// Show the interstitial
-async function showInterstitial() {
-  const isLoaded = await BigCrunchInterstitial.isLoaded('interstitial-level-complete');
+  const handleLevelComplete = async () => {
+    if (await BigCrunchInterstitial.isLoaded(PLACEMENT_ID)) {
+      await BigCrunchInterstitial.show(PLACEMENT_ID);
+    }
+  };
 
-  if (isLoaded) {
-    await BigCrunchInterstitial.show('interstitial-level-complete');
-  }
+  return (
+    <Button title="Complete Level" onPress={handleLevelComplete} />
+  );
 }
-
-// Listen for events
-BigCrunchInterstitial.addEventListener(
-  'interstitial-level-complete',
-  'adClosed',
-  () => {
-    console.log('Interstitial closed');
-    // Load next ad or continue game
-  }
-);
 ```
 
+#### Methods
+
+| Method | Description |
+|--------|-------------|
+| `load(options)` | Load an interstitial ad |
+| `show(placementId)` | Show a loaded interstitial |
+| `isLoaded(placementId)` | Check if an ad is loaded |
+| `destroy(placementId)` | Destroy an interstitial instance |
+| `addEventListener(placementId, event, listener)` | Add an event listener |
+
+#### Events
+
+| Event | Description |
+|-------|-------------|
+| `'adLoaded'` | Ad loaded and ready to show |
+| `'adFailedToLoad'` | Loading failed |
+| `'adImpression'` | Impression recorded |
+| `'adClicked'` | User tapped the ad |
+| `'adOpened'` | Full-screen ad presented |
+| `'adClosed'` | User dismissed the ad |
+| `'adRevenue'` | Revenue event (ILRD) |
+
 ### Rewarded Ads
 
+Full-screen ads that offer the user an in-app reward in exchange for watching. The API is identical to interstitials, with the addition of the `rewardEarned` event.
+
 ```typescript
+import { useEffect, useRef, useState } from 'react';
+import { Button, Alert } from 'react-native';
 import { BigCrunchRewarded } from '@bigcrunch/react-native-ads';
+import type { EventSubscription } from '@bigcrunch/react-native-ads';
+
+const PLACEMENT_ID = 'rewarded-extra-life';
+
+function GameOverScreen() {
+  const [adReady, setAdReady] = useState(false);
+  const subscriptions = useRef<EventSubscription[]>([]);
+
+  useEffect(() => {
+    BigCrunchRewarded.load({ placementId: PLACEMENT_ID });
+
+    subscriptions.current.push(
+      BigCrunchRewarded.addEventListener(PLACEMENT_ID, 'adLoaded', () => {
+        setAdReady(true);
+      }),
+      BigCrunchRewarded.addEventListener(PLACEMENT_ID, 'adClosed', () => {
+        setAdReady(false);
+        BigCrunchRewarded.load({ placementId: PLACEMENT_ID });
+      }),
+      BigCrunchRewarded.addEventListener(PLACEMENT_ID, 'rewardEarned', (event) => {
+        Alert.alert('Reward!', `You earned ${event.rewardAmount} ${event.rewardType}`);
+      })
+    );
 
-// Load a rewarded ad
-async function loadRewardedAd() {
-  try {
-    await BigCrunchRewarded.load({
-      placementId: 'rewarded-extra-life'
-    });
-    console.log('Rewarded ad loaded');
-  } catch (error) {
-    console.error('Failed to load rewarded ad:', error);
-  }
-}
+    return () => {
+      subscriptions.current.forEach((sub) => sub.remove());
+      BigCrunchRewarded.destroy(PLACEMENT_ID);
+    };
+  }, []);
+
+  const handleWatchAd = async () => {
+    if (await BigCrunchRewarded.isLoaded(PLACEMENT_ID)) {
+      await BigCrunchRewarded.show(PLACEMENT_ID);
+    }
+  };
 
-// Set up reward listener
-BigCrunchRewarded.addEventListener(
-  'rewarded-extra-life',
-  'rewardEarned',
-  (event) => {
-    console.log(`User earned ${event.rewardAmount} ${event.rewardType}`);
-    // Grant reward to user
-  }
-);
-
-// Show the rewarded ad
-async function showRewardedAd() {
-  const isLoaded = await BigCrunchRewarded.isLoaded('rewarded-extra-life');
-
-  if (isLoaded) {
-    await BigCrunchRewarded.show('rewarded-extra-life');
-  } else {
-    console.log('Rewarded ad not ready');
-  }
+  return (
+    <Button title="Watch Ad for Extra Life" onPress={handleWatchAd} disabled={!adReady} />
+  );
 }
 ```
 
-## Advanced Features
+#### Additional Events
 
-### Custom Targeting
+All interstitial events plus:
 
-```typescript
-// Banner with custom targeting
-<BigCrunchBannerView
-  placementId="banner-home"
-  customTargeting={{
-    'user_level': '5',
-    'game_mode': 'survival'
-  }}
-/>
-
-// Interstitial with custom targeting
-await BigCrunchInterstitial.load({
-  placementId: 'interstitial-level-complete',
-  customTargeting: {
-    'level': '10',
-    'score': 'high'
-  }
-});
-```
+| Event | Description |
+|-------|-------------|
+| `'rewardEarned'` | User completed the ad and earned a reward. Includes `rewardType` (string) and `rewardAmount` (number). |
 
-### Privacy Settings
+## Privacy & Compliance
 
 ```typescript
-// GDPR Consent
-await BigCrunchAds.setGdprConsent('consent_string_here');
+// GDPR — pass IAB TCF consent string
+await BigCrunchAds.setGdprConsent('consent-string-here');
 
-// CCPA Compliance
+// CCPA — pass IAB US Privacy string
 await BigCrunchAds.setCcpaString('1YNN');
 
-// COPPA Compliance
+// COPPA — for apps directed at children
 await BigCrunchAds.setCoppaCompliant(true);
 ```
 
-### Debug Mode & Test Devices
+## Verifying Your Integration
 
 ```typescript
-// Enable debug mode
+// Check if SDK is initialized
+const isReady = await BigCrunchAds.isInitialized();
+console.log('SDK initialized:', isReady);
+
+// Get session information
+const session = await BigCrunchAds.getSessionInfo();
+console.log('Session ID:', session.sessionId);
+console.log('Screen views:', session.screenViewCount);
+
+// Enable debug logging during development
 await BigCrunchAds.setDebugMode(true);
 
-// Add test devices
+// Register test devices to receive test ads
 await BigCrunchAds.addTestDevice('YOUR_DEVICE_ID');
 ```
 
-### Event Listeners
+> **Finding your device ID:** Run your app with debug mode enabled, load an ad, and check the console output. The Google Mobile Ads SDK will log your device ID.
 
-```typescript
-// Global configuration events
-BigCrunchAds.onConfigUpdated((config) => {
-  console.log('Config updated:', config);
-});
-
-// Session events
-BigCrunchAds.onSessionStarted((session) => {
-  console.log('New session started:', session.sessionId);
-});
-
-// Ad-specific events
-const subscription = BigCrunchInterstitial.addEventListener(
-  'interstitial-main',
-  'adRevenue',
-  (event) => {
-    console.log('Revenue received:', event.revenue);
-  }
-);
-
-// Remove listener when done
-subscription.remove();
-```
+## Error Codes
+
+When an ad fails to load, the `AdError` object contains a `code` and `message`:
+
+| Code | Description |
+|------|-------------|
+| `NETWORK_ERROR` | No network connectivity |
+| `NO_FILL` | No ad available for this request |
+| `INVALID_REQUEST` | Malformed ad request |
+| `INTERNAL_ERROR` | Internal SDK error |
+| `INVALID_PLACEMENT` | Placement ID not found in config |
+| `NOT_INITIALIZED` | SDK not yet initialized |
+| `ALREADY_LOADED` | An ad is already loaded for this placement |
+| `NOT_LOADED` | Attempted to show an ad that isn't loaded |
+| `TIMEOUT` | Ad request timed out |
 
 ## TypeScript Support
 
@@ -274,137 +352,53 @@ import type {
   AdError,
   AdRevenue,
   BannerSize,
+  CustomSize,
   PlacementConfig,
-  SessionInfo
+  AppConfig,
+  SessionInfo,
+  EventSubscription,
+  AdErrorCode,
 } from '@bigcrunch/react-native-ads';
 ```
 
-## API Reference
-
-### BigCrunchAds
-
-| Method | Description |
-|--------|-------------|
-| `initialize(propertyId, environment)` | Initialize the SDK |
-| `trackScreenView(screenName)` | Track a screen view |
-| `getAppConfig()` | Get current app configuration |
-| `getSessionInfo()` | Get current session information |
-| `setGdprConsent(consent)` | Set GDPR consent string |
-| `setCcpaString(ccpaString)` | Set CCPA compliance string |
-| `setCoppaCompliant(isCompliant)` | Set COPPA compliance |
-| `setDebugMode(enabled)` | Enable/disable debug mode |
-
-### BigCrunchBannerView Props
-
-| Prop | Type | Description |
-|------|------|-------------|
-| `placementId` | string | Required. Placement ID from dashboard |
-| `size` | BannerSize \| CustomSize | Banner size (default: BANNER) |
-| `autoLoad` | boolean | Auto-load ad on mount (default: true) |
-| `refreshInterval` | number | Auto-refresh interval in seconds |
-| `customTargeting` | object | Custom targeting parameters |
-| `onAdLoaded` | function | Called when ad loads |
-| `onAdFailedToLoad` | function | Called on load failure |
-| `onAdImpression` | function | Called on impression |
-| `onAdClicked` | function | Called on click |
-| `onAdRevenue` | function | Called on revenue (ILRD) |
-
-### BigCrunchInterstitial
-
-| Method | Description |
-|--------|-------------|
-| `load(options)` | Load an interstitial ad |
-| `show(placementId)` | Show a loaded interstitial |
-| `isLoaded(placementId)` | Check if ad is loaded |
-| `destroy(placementId)` | Destroy an interstitial instance |
-| `addEventListener(placementId, event, listener)` | Add event listener |
-
-### BigCrunchRewarded
-
-| Method | Description |
-|--------|-------------|
-| `load(options)` | Load a rewarded ad |
-| `show(placementId)` | Show a loaded rewarded ad |
-| `isLoaded(placementId)` | Check if ad is loaded |
-| `destroy(placementId)` | Destroy a rewarded instance |
-| `addEventListener(placementId, event, listener)` | Add event listener |
-| `onRewardEarned(placementId, listener)` | Listen for rewards |
-
-## Error Handling
-
-```typescript
-import { AdErrorCode } from '@bigcrunch/react-native-ads';
-
-// Handle banner errors
-<BigCrunchBannerView
-  placementId="banner-home"
-  onAdFailedToLoad={(error) => {
-    switch (error.code) {
-      case AdErrorCode.NO_FILL:
-        console.log('No ads available');
-        break;
-      case AdErrorCode.NETWORK_ERROR:
-        console.log('Network error');
-        break;
-      case AdErrorCode.INVALID_PLACEMENT:
-        console.log('Invalid placement ID');
-        break;
-      default:
-        console.error('Ad error:', error.message);
-    }
-  }}
-/>
-```
+## Full Documentation
 
-## Example App
+- [Full Integration Guide (Tracking + Ads)](./docs/FULL_INTEGRATION.md)
+- [Tracking-Only Integration Guide](./docs/TRACKING_ONLY_INTEGRATION.md)
+- [Google Ad Manager Setup](./docs/GOOGLE_SETUP.md)
+- [Testing Guide](./docs/TESTING_GUIDE.md)
+- [Example App](./example)
 
-Check out the [example app](./example) for a complete implementation:
+## Troubleshooting
 
+### iOS: Pod install fails
 ```bash
-cd react-native/example
-npm install
-npm run ios # or npm run android
+cd ios
+pod deintegrate
+pod cache clean --all
+pod install
 ```
 
-## Troubleshooting
-
-### iOS Issues
-
-1. **Module not found**: Run `cd ios && pod install`
-2. **Build failures**: Clean build folder and rebuild
-3. **App crashes on launch**: Verify GADApplicationIdentifier in Info.plist
-
-### Android Issues
-
-1. **Manifest merger failed**: Check APPLICATION_ID in AndroidManifest.xml
-2. **Build failures**: Sync project with Gradle files
-3. **MultiDex issues**: Enable multidex in your app
-
-### Common Issues
-
-1. **Ads not loading**:
-   - Verify initialization is complete
-   - Check placement IDs match dashboard
-   - Ensure test mode is disabled in production
-
-2. **Revenue not tracking**:
-   - Verify ILRD is enabled in Google Ad Manager
-   - Check revenue event listeners are set up
-
-3. **TypeScript errors**:
-   - Update to latest version
-   - Rebuild TypeScript definitions: `npm run typescript`
-
-## Requirements
-
-- React Native 0.60+
-- iOS 13.0+
-- Android API 21+
-- TypeScript 4.0+ (optional)
+### Android: Build fails with duplicate classes
+Add to `android/app/build.gradle`:
+```gradle
+android {
+    packagingOptions {
+        pickFirst 'META-INF/*'
+    }
+}
+```
 
-## License
+### Ads not loading ("No Fill")
+- Normal during testing — ad inventory varies by region and time
+- Register your device as a test device to receive test ads
+- Verify placement IDs match the BigCrunch dashboard
+- Check the GAM App ID in `Info.plist` / `AndroidManifest.xml`
 
-MIT
+### Interstitial/Rewarded not showing
+- Call `load()` before `show()`
+- Check `isLoaded()` before calling `show()`
+- Listen for `adFailedToLoad` events to diagnose issues
 
 ## Support
 
@@ -412,6 +406,6 @@ MIT
 - Issues: https://github.com/bigcrunch/mobile-ads-sdk/issues
 - Email: support@bigcrunch.com
 
-## Contributing
+## License
 
-See [CONTRIBUTING.md](../CONTRIBUTING.md) for details.
+MIT

package/android/src/main/java/com/bigcrunch/ads/react/BigCrunchAdsModule.kt

@@ -596,29 +596,6 @@ class BigCrunchAdsModule(reactContext: ReactApplicationContext) :
             map.putArray("sizes", sizesArray)
         }
 
-        // Add bidders array if available
-        config.bidders?.let { bidders ->
-            val biddersArray = Arguments.createArray()
-            for (bidderConfig in bidders) {
-                val bidderMap = Arguments.createMap()
-                bidderMap.putString("bidder", bidderConfig.bidder)
-                bidderConfig.params?.let { params ->
-                    val paramsMap = Arguments.createMap()
-                    for ((key, value) in params) {
-                        when (value) {
-                            is String -> paramsMap.putString(key, value)
-                            is Int -> paramsMap.putInt(key, value)
-                            is Double -> paramsMap.putDouble(key, value)
-                            is Boolean -> paramsMap.putBoolean(key, value)
-                        }
-                    }
-                    bidderMap.putMap("params", paramsMap)
-                }
-                biddersArray.pushMap(bidderMap)
-            }
-            map.putArray("bidders", biddersArray)
-        }
-
         // Add refresh config if available
         config.refresh?.let { refresh ->
             val refreshMap = Arguments.createMap()

package/ios/BigCrunchAdsModule.swift

@@ -257,9 +257,10 @@ class BigCrunchAdsModule: RCTEventEmitter {
                 "appName": config.appName,
                 "environment": config.environment,
                 "gamNetworkCode": config.gamNetworkCode,
-                "prebid": [
-                    "serverUrl": config.prebid.serverUrl,
-                    "timeoutMs": config.prebid.timeoutMs
+                "s2s": [
+                    "enabled": config.s2s.enabled,
+                    "serverUrl": config.s2s.serverUrl,
+                    "timeoutMs": config.s2s.timeoutMs
                 ],
                 "placements": config.placements.map { placement in
                     var placementDict: [String: Any] = [
@@ -270,15 +271,6 @@ class BigCrunchAdsModule: RCTEventEmitter {
                     if let sizes = placement.sizes {
                         placementDict["sizes"] = sizes.map { ["width": $0.width, "height": $0.height] }
                     }
-                    if let bidders = placement.bidders {
-                        placementDict["bidders"] = bidders.map { bidderConfig in
-                            var bidderDict: [String: Any] = ["bidder": bidderConfig.bidder]
-                            if let params = bidderConfig.params {
-                                bidderDict["params"] = params.mapValues { $0.value }
-                            }
-                            return bidderDict
-                        }
-                    }
                     return placementDict
                 }
             ]
@@ -400,7 +392,7 @@ class BigCrunchAdsModule: RCTEventEmitter {
             return
         }
 
-        // customTargeting can be used in future for custom Prebid targeting
+        // customTargeting can be used in future for custom S2S targeting
         // let customTargeting = options["customTargeting"] as? [String: String]
 
         BigCrunchRewarded.preload(placementId: placementId) { [weak self] result in

package/lib/types/config.d.ts

@@ -10,6 +10,10 @@ export interface AppConfig {
     propertyId: string;
     /** Property name */
     propertyName: string;
+    /** S2S auction configuration */
+    s2s?: S2SConfig;
+    /** Top-level bidder configurations (bidderName → BidderEntry) */
+    bidders?: Record<string, BidderEntry>;
     /** List of configured placements */
     placements: PlacementConfig[];
     /** Global settings */
@@ -33,8 +37,6 @@ export interface PlacementConfig {
     gamAdUnit: string;
     /** Ad size configuration */
     size?: AdSizeConfig;
-    /** Prebid bidder configurations */
-    bidders?: BidderConfig[];
     /** Amazon APS configuration */
     amazonConfig?: AmazonConfig;
     /** Placement-specific settings */
@@ -54,16 +56,27 @@ export interface AdSizeConfig {
     adaptive?: boolean;
 }
 /**
- * Configuration for a single Prebid bidder
+ * S2S (server-to-server) configuration for bid requests
+ */
+export interface S2SConfig {
+    /** Whether S2S is enabled */
+    enabled: boolean;
+    /** S2S auction server URL */
+    serverUrl: string;
+    /** Timeout for S2S requests in milliseconds */
+    timeoutMs: number;
+}
+/**
+ * Configuration for a single bidder at the app level
  *
- * Contains the bidder name and its params, which get passed inline
- * to the S2S endpoint in the bid request.
+ * Contains shared bidder params and a map of placement-specific params.
+ * Bidder-to-placement mapping is resolved from this structure.
  */
-export interface BidderConfig {
-    /** Bidder name (e.g., "appnexus", "rubicon") */
-    bidder: string;
-    /** Bidder-specific parameters */
+export interface BidderEntry {
+    /** Shared bidder-level parameters */
     params?: Record<string, any>;
+    /** Per-placement params: placementId → imp-level params */
+    placements?: Record<string, Record<string, any>>;
 }
 /**
  * Amazon APS configuration

package/lib/types/config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/types/config.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/types/config.ts"],"names":[],"mappings":"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"}

package/lib/types/events.d.ts

@@ -44,7 +44,7 @@ export interface AdImpressionEvent extends BaseAdEvent {
     gamAdUnit?: string;
     /** Ad size (e.g., "320x50") */
     adSize?: string;
-    /** Auction ID from Prebid */
+    /** Auction ID from S2S bid request */
     auctionId?: string;
     /** Winning bidder name */
     bidder?: string;
@@ -60,7 +60,7 @@ export interface AdImpressionEvent extends BaseAdEvent {
     creativeId?: string;
     /** Refresh count for this placement */
     refreshCount?: number;
-    /** Demand channel (e.g., "Prebid Header", "GAM Direct") */
+    /** Demand channel (e.g., "S2S Header", "GAM Direct") */
     demandChannel?: string;
 }
 /**
@@ -219,7 +219,7 @@ export interface ImpressionEvent extends WebSchemaCommonFields {
     gamAdUnit: string;
     /** Ad format (banner, interstitial, rewarded) */
     format: string;
-    /** Auction ID from Prebid */
+    /** Auction ID from S2S bid request */
     auctionId?: string;
     /** Refresh count for this placement */
     refreshCount?: number;
@@ -247,7 +247,7 @@ export interface ImpressionEvent extends WebSchemaCommonFields {
     amznPrice?: string;
     /** Demand type (banner, video, etc.) */
     demandType?: string;
-    /** Demand channel (e.g., "Prebid Header", "GAM Direct") */
+    /** Demand channel (e.g., "S2S Header", "GAM Direct") */
     demandChannel?: string;
 }
 /**

package/lib/types/events.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"events.d.ts","sourceRoot":"","sources":["../../src/types/events.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"events.d.ts","sourceRoot":"","sources":["../../src/types/events.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@bigcrunch/react-native-ads",
-  "version": "0.3.0",
-  "description": "BigCrunch Mobile Ads SDK for React Native - Simplified in-app advertising with Prebid and Google Ad Manager",
+  "version": "0.4.0",
+  "description": "BigCrunch Mobile Ads SDK for React Native - Simplified in-app advertising with S2S demand and Google Ad Manager",
   "main": "lib/index.js",
   "types": "lib/index.d.ts",
   "react-native": "src/index.ts",
@@ -44,7 +44,8 @@
     "ads",
     "advertising",
     "monetization",
-    "prebid",
+    "s2s",
+    "header-bidding",
     "google-ad-manager",
     "gam",
     "banner",

package/react-native-bigcrunch-ads.podspec

@@ -7,7 +7,7 @@ Pod::Spec.new do |s|
   s.version      = package["version"]
   s.summary      = package["description"]
   s.description  = <<-DESC
-                  BigCrunch Mobile Ads SDK for React Native - Simplified in-app advertising with Prebid and Google Ad Manager
+                  BigCrunch Mobile Ads SDK for React Native - Simplified in-app advertising with S2S demand and Google Ad Manager
                    DESC
   s.homepage     = "https://github.com/bigcrunch/mobile-ads-sdk"
   s.license      = "MIT"
@@ -21,7 +21,6 @@ Pod::Spec.new do |s|
   s.dependency "React"
   s.dependency "BigCrunchAds", "~> 0.1.0"  # Reference to main iOS SDK
   s.dependency "Google-Mobile-Ads-SDK", ">= 10.14.0"
-  s.dependency "PrebidMobile", "~> 2.3.1"
 
   s.swift_version = "5.9"
 end

package/src/types/config.ts

@@ -12,6 +12,10 @@ export interface AppConfig {
   propertyId: string;
   /** Property name */
   propertyName: string;
+  /** S2S auction configuration */
+  s2s?: S2SConfig;
+  /** Top-level bidder configurations (bidderName → BidderEntry) */
+  bidders?: Record<string, BidderEntry>;
   /** List of configured placements */
   placements: PlacementConfig[];
   /** Global settings */
@@ -36,8 +40,6 @@ export interface PlacementConfig {
   gamAdUnit: string;
   /** Ad size configuration */
   size?: AdSizeConfig;
-  /** Prebid bidder configurations */
-  bidders?: BidderConfig[];
   /** Amazon APS configuration */
   amazonConfig?: AmazonConfig;
   /** Placement-specific settings */
@@ -59,16 +61,28 @@ export interface AdSizeConfig {
 }
 
 /**
- * Configuration for a single Prebid bidder
+ * S2S (server-to-server) configuration for bid requests
+ */
+export interface S2SConfig {
+  /** Whether S2S is enabled */
+  enabled: boolean;
+  /** S2S auction server URL */
+  serverUrl: string;
+  /** Timeout for S2S requests in milliseconds */
+  timeoutMs: number;
+}
+
+/**
+ * Configuration for a single bidder at the app level
  *
- * Contains the bidder name and its params, which get passed inline
- * to the S2S endpoint in the bid request.
+ * Contains shared bidder params and a map of placement-specific params.
+ * Bidder-to-placement mapping is resolved from this structure.
  */
-export interface BidderConfig {
-  /** Bidder name (e.g., "appnexus", "rubicon") */
-  bidder: string;
-  /** Bidder-specific parameters */
+export interface BidderEntry {
+  /** Shared bidder-level parameters */
   params?: Record<string, any>;
+  /** Per-placement params: placementId → imp-level params */
+  placements?: Record<string, Record<string, any>>;
 }
 
 /**

package/src/types/events.ts

@@ -49,7 +49,7 @@ export interface AdImpressionEvent extends BaseAdEvent {
   gamAdUnit?: string;
   /** Ad size (e.g., "320x50") */
   adSize?: string;
-  /** Auction ID from Prebid */
+  /** Auction ID from S2S bid request */
   auctionId?: string;
   /** Winning bidder name */
   bidder?: string;
@@ -65,7 +65,7 @@ export interface AdImpressionEvent extends BaseAdEvent {
   creativeId?: string;
   /** Refresh count for this placement */
   refreshCount?: number;
-  /** Demand channel (e.g., "Prebid Header", "GAM Direct") */
+  /** Demand channel (e.g., "S2S Header", "GAM Direct") */
   demandChannel?: string;
 }
 
@@ -246,7 +246,7 @@ export interface ImpressionEvent extends WebSchemaCommonFields {
   gamAdUnit: string;
   /** Ad format (banner, interstitial, rewarded) */
   format: string;
-  /** Auction ID from Prebid */
+  /** Auction ID from S2S bid request */
   auctionId?: string;
   /** Refresh count for this placement */
   refreshCount?: number;
@@ -274,7 +274,7 @@ export interface ImpressionEvent extends WebSchemaCommonFields {
   amznPrice?: string;
   /** Demand type (banner, video, etc.) */
   demandType?: string;
-  /** Demand channel (e.g., "Prebid Header", "GAM Direct") */
+  /** Demand channel (e.g., "S2S Header", "GAM Direct") */
   demandChannel?: string;
 }