@bigcrunch/react-native-ads 0.11.0 → 0.14.0

package/android/bigcrunch-ads/com/bigcrunch/ads/core/BidRequestClient.kt

@@ -4,6 +4,7 @@ import com.bigcrunch.ads.BigCrunchAds
 import com.bigcrunch.ads.internal.BCLogger
 import com.bigcrunch.ads.internal.HttpClient
 import com.bigcrunch.ads.internal.PrivacyStore
+import com.bigcrunch.ads.models.AuctionData
 import com.bigcrunch.ads.models.PlacementConfig
 import com.bigcrunch.ads.models.S2SConfig
 import kotlinx.coroutines.*
@@ -37,9 +38,15 @@ internal class BidRequestClient(
         private const val BATCH_DELAY_MS = 100L
     }
 
+    /** Bid response containing both targeting KVPs and auction metadata */
+    internal data class BidResponse(
+        val targeting: Map<String, String>,
+        val auctionData: AuctionData
+    )
+
     private class PendingRequest(
         val placement: PlacementConfig,
-        val deferred: CompletableDeferred<Map<String, String>?>
+        val deferred: CompletableDeferred<BidResponse?>
     )
 
     // MARK: - Public API
@@ -53,13 +60,13 @@ internal class BidRequestClient(
      * @param placement The placement to fetch demand for
      * @return Targeting KVPs to apply to GAM request, or null
      */
-    suspend fun fetchDemand(placement: PlacementConfig): Map<String, String>? {
+    suspend fun fetchDemand(placement: PlacementConfig): BidResponse? {
         if (!s2sConfig.enabled) {
             BCLogger.d(TAG, "S2S is disabled, skipping bid request")
             return null
         }
 
-        val deferred = CompletableDeferred<Map<String, String>?>()
+        val deferred = CompletableDeferred<BidResponse?>()
 
         mutex.withLock {
             pendingRequests.add(PendingRequest(placement, deferred))
@@ -94,8 +101,8 @@ internal class BidRequestClient(
 
         // Distribute results to each pending deferred
         for (pending in batch) {
-            val targeting = results[pending.placement.placementId]
-            pending.deferred.complete(targeting)
+            val bidResponse = results[pending.placement.placementId]
+            pending.deferred.complete(bidResponse)
         }
     }
 
@@ -103,7 +110,7 @@ internal class BidRequestClient(
 
     private suspend fun executeBidRequest(
         placements: List<PlacementConfig>
-    ): Map<String, Map<String, String>> {
+    ): Map<String, BidResponse> {
         val requestBody = buildRequestJSON(placements)
         val jsonString = requestBody.toString()
 
@@ -118,7 +125,7 @@ internal class BidRequestClient(
         return when {
             result.isSuccess -> {
                 val responseJson = result.getOrNull()!!
-                parseResponse(responseJson)
+                parseResponse(responseJson, placements)
             }
             else -> {
                 BCLogger.e(TAG, "Bid request failed: ${result.exceptionOrNull()?.message}")
@@ -302,16 +309,29 @@ internal class BidRequestClient(
      *
      * Groups bids by impid, picks winner (highest price), copies ext.targeting.
      */
-    private fun parseResponse(jsonString: String): Map<String, Map<String, String>> {
+    private fun parseResponse(jsonString: String, placements: List<PlacementConfig>): Map<String, BidResponse> {
         return try {
             val json = JSONObject(jsonString)
             val seatbids = json.optJSONArray("seatbid") ?: return emptyMap()
 
+            val auctionId = json.optString("id", "")
+
+            // Build floor price lookup from placement configs
+            val floorPrices = placements.associate { it.placementId to it.floorPrice }
+
             // Collect all bids grouped by impid
-            val bidsByImpId = mutableMapOf<String, MutableList<Pair<Double, Map<String, String>>>>()
+            data class BidInfo(
+                val price: Double,
+                val targeting: Map<String, String>,
+                val seat: String,
+                val creativeId: String?
+            )
+
+            val bidsByImpId = mutableMapOf<String, MutableList<BidInfo>>()
 
             for (i in 0 until seatbids.length()) {
                 val seatbid = seatbids.getJSONObject(i)
+                val seat = seatbid.optString("seat", "")
                 val bids = seatbid.optJSONArray("bid") ?: continue
 
                 for (j in 0 until bids.length()) {
@@ -320,6 +340,7 @@ internal class BidRequestClient(
                     val price = bid.optDouble("price", 0.0)
                     val ext = bid.optJSONObject("ext") ?: continue
                     val targetingJson = ext.optJSONObject("targeting") ?: continue
+                    val crid = bid.optString("crid", null)
 
                     val targeting = mutableMapOf<String, String>()
                     val keys = targetingJson.keys()
@@ -330,19 +351,33 @@ internal class BidRequestClient(
 
                     if (impid.isNotEmpty()) {
                         bidsByImpId.getOrPut(impid) { mutableListOf() }
-                            .add(Pair(price, targeting))
+                            .add(BidInfo(price, targeting, seat, crid))
                     }
                 }
             }
 
-            // Pick winner (highest price) for each impid
-            val results = mutableMapOf<String, Map<String, String>>()
+            // Pick winner (highest price) for each impid and compute auction metadata
+            val results = mutableMapOf<String, BidResponse>()
             for ((impid, bids) in bidsByImpId) {
-                val winner = bids.maxByOrNull { it.first }
-                if (winner != null) {
-                    results[impid] = winner.second
-                    BCLogger.d(TAG, "Winner for $impid: $${winner.first}")
-                }
+                val sortedBids = bids.sortedByDescending { it.price }
+                val winner = sortedBids.first()
+
+                val secondHighestBid = if (sortedBids.size > 1) sortedBids[1].price else null
+                val floorPrice = floorPrices[impid]
+
+                val auctionData = AuctionData(
+                    auctionId = auctionId.ifEmpty { null },
+                    bidder = winner.seat,
+                    bidPriceCpm = winner.price,
+                    creativeId = winner.creativeId,
+                    gamPriceBucket = winner.targeting["hb_pb"],
+                    floorPrice = floorPrice,
+                    secondHighestBid = secondHighestBid,
+                    demandChannel = "S2S"
+                )
+
+                results[impid] = BidResponse(winner.targeting, auctionData)
+                BCLogger.d(TAG, "Winner for $impid: $${winner.price}")
             }
 
             BCLogger.i(TAG, "Parsed ${results.size} winning bids")

package/android/bigcrunch-ads/com/bigcrunch/ads/core/DeviceContext.kt

@@ -28,7 +28,7 @@ internal class DeviceContext private constructor(context: Context) {
 
     companion object {
         private const val TAG = "DeviceContext"
-        internal const val SDK_VERSION = "0.11.0"
+        internal const val SDK_VERSION = "0.14.0"
 
         @Volatile
         private var instance: DeviceContext? = null

package/android/bigcrunch-ads/com/bigcrunch/ads/models/AdEvent.kt

@@ -69,6 +69,69 @@ internal data class RevenueData(
     val currency: String
 )
 
+// MARK: - Screen View Options
+
+/**
+ * Options for customizing screen view tracking
+ *
+ * Allows app developers to provide page URL, content metadata,
+ * and custom dimensions for analytics events.
+ */
+data class ScreenViewOptions(
+    /** Override the auto-generated page URL (must be a valid URL) */
+    val pageUrl: String? = null,
+
+    /** Content metadata for this screen/page */
+    val pageMeta: PageMetaData? = null,
+
+    /** Custom key-value dimensions attached to analytics events */
+    val customDimensions: Map<String, String>? = null
+)
+
+/**
+ * Content metadata for a screen/page view
+ *
+ * Matches the `page_meta_data` fields in the analytics schema.
+ */
+@JsonClass(generateAdapter = true)
+data class PageMetaData(
+    /** Canonical page URL */
+    @Json(name = "url")
+    val url: String? = null,
+
+    /** Content author */
+    @Json(name = "author")
+    val author: String? = null,
+
+    /** Page/screen title */
+    @Json(name = "title")
+    val title: String? = null,
+
+    /** Featured image URL */
+    @Json(name = "thumbnailUrl")
+    val thumbnailUrl: String? = null,
+
+    /** Content section/category */
+    @Json(name = "articleSection")
+    val articleSection: String? = null,
+
+    /** Comma-separated keywords */
+    @Json(name = "keywords")
+    val keywords: String? = null,
+
+    /** Content creation date (ISO 8601) */
+    @Json(name = "dateCreated")
+    val dateCreated: String? = null,
+
+    /** Content last modified date (ISO 8601) */
+    @Json(name = "dateModified")
+    val dateModified: String? = null,
+
+    /** Content publication date (ISO 8601) */
+    @Json(name = "datePublished")
+    val datePublished: String? = null
+)
+
 // MARK: - Enhanced Analytics Events (matching web SDK data model)
 
 /**
@@ -178,7 +241,11 @@ internal data class PageViewEvent(
 
     // Custom dimensions
     @Json(name = "custom_dimensions")
-    val customDimensions: Map<String, String> = emptyMap()
+    val customDimensions: Map<String, String> = emptyMap(),
+
+    // Page metadata (only for pageview events)
+    @Json(name = "page_meta_data")
+    val pageMetaData: PageMetaData? = null
 )
 
 /**
@@ -845,7 +912,19 @@ internal data class AuctionData(
     val bidPriceCpm: Double? = null,
 
     /** Creative ID from winning bid */
-    val creativeId: String? = null
+    val creativeId: String? = null,
+
+    /** GAM price bucket (hb_pb value from targeting KVPs) */
+    val gamPriceBucket: String? = null,
+
+    /** Floor price sent to bidders */
+    val floorPrice: Double? = null,
+
+    /** Second-highest bid price (for computing min_bid_to_win) */
+    val secondHighestBid: Double? = null,
+
+    /** Demand channel ("S2S", "Google Ad Exchange", etc.) */
+    val demandChannel: String? = null
 ) {
     companion object {
         val EMPTY = AuctionData()

package/android/bigcrunch-ads/com/bigcrunch/ads/models/PlacementConfig.kt

@@ -25,7 +25,10 @@ data class PlacementConfig(
     val sizes: List<AdSize>? = null,
 
     @Json(name = "refresh")
-    val refresh: RefreshConfig? = null
+    val refresh: RefreshConfig? = null,
+
+    @Json(name = "floorPrice")
+    val floorPrice: Double? = null
 )
 
 /**

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

@@ -95,10 +95,52 @@ class BigCrunchAdsModule(reactContext: ReactApplicationContext) :
      * Track screen view
      */
     @ReactMethod
-    fun trackScreenView(screenName: String, promise: Promise) {
+    fun trackScreenView(screenName: String, options: ReadableMap?, promise: Promise) {
         scope.launch {
             try {
-                BigCrunchAds.trackScreenView(screenName)
+                var screenViewOptions: ScreenViewOptions? = null
+
+                if (options != null) {
+                    var pageMeta: PageMetaData? = null
+                    if (options.hasKey("pageMeta")) {
+                        val metaMap = options.getMap("pageMeta")
+                        if (metaMap != null) {
+                            pageMeta = PageMetaData(
+                                url = metaMap.getString("url"),
+                                author = metaMap.getString("author"),
+                                title = metaMap.getString("title"),
+                                thumbnailUrl = metaMap.getString("thumbnailUrl"),
+                                articleSection = metaMap.getString("articleSection"),
+                                keywords = metaMap.getString("keywords"),
+                                dateCreated = metaMap.getString("dateCreated"),
+                                dateModified = metaMap.getString("dateModified"),
+                                datePublished = metaMap.getString("datePublished")
+                            )
+                        }
+                    }
+
+                    var customDimensions: Map<String, String>? = null
+                    if (options.hasKey("customDimensions")) {
+                        val dimMap = options.getMap("customDimensions")
+                        if (dimMap != null) {
+                            val dims = mutableMapOf<String, String>()
+                            val iterator = dimMap.keySetIterator()
+                            while (iterator.hasNextKey()) {
+                                val key = iterator.nextKey()
+                                dimMap.getString(key)?.let { dims[key] = it }
+                            }
+                            customDimensions = dims
+                        }
+                    }
+
+                    screenViewOptions = ScreenViewOptions(
+                        pageUrl = if (options.hasKey("pageUrl")) options.getString("pageUrl") else null,
+                        pageMeta = pageMeta,
+                        customDimensions = customDimensions
+                    )
+                }
+
+                BigCrunchAds.trackScreenView(screenName, screenViewOptions)
                 promise.resolve(null)
             } catch (e: Exception) {
                 promise.reject("TRACK_ERROR", "Failed to track screen view: ${e.message}", e)
@@ -501,6 +543,19 @@ class BigCrunchAdsModule(reactContext: ReactApplicationContext) :
         }
     }
 
+    /**
+     * Set account type
+     */
+    @ReactMethod
+    fun setAccountType(accountType: String, promise: Promise) {
+        try {
+            BigCrunchAds.setAccountType(accountType)
+            promise.resolve(null)
+        } catch (e: Exception) {
+            promise.reject("ACCOUNT_ERROR", "Failed to set account type: ${e.message}", e)
+        }
+    }
+
     /**
      * Set debug mode
      */

package/ios/BigCrunchAds/Sources/Adapters/GoogleAdsAdapter.swift

@@ -361,9 +361,15 @@ private class BannerDelegateWrapper: NSObject, GoogleMobileAds.BannerViewDelegat
         let responseInfo = bannerView.responseInfo
         let adMetadata = GoogleAdsAdapter.extractAdMetadata(from: responseInfo)
 
+        // Extract ad size from the loaded banner
+        let adSize = bannerView.adSize
+        let adSizeString = "\(Int(adSize.size.width))x\(Int(adSize.size.height))"
+
         analyticsClient.trackAdImpression(
             placementId: placementConfig.placementId,
             format: placementConfig.format,
+            gamAdUnit: placementConfig.gamAdUnit,
+            adSize: adSizeString,
             refreshCount: refreshCount,
             advertiserId: adMetadata["advertiser_id"] as? String,
             campaignId: adMetadata["campaign_id"] as? String,
@@ -426,6 +432,7 @@ private class InterstitialDelegateWrapper: NSObject, GoogleMobileAds.FullScreenC
         analyticsClient.trackAdImpression(
             placementId: placementConfig.placementId,
             format: placementConfig.format,
+            gamAdUnit: placementConfig.gamAdUnit,
             advertiserId: adMetadata["advertiser_id"] as? String,
             campaignId: adMetadata["campaign_id"] as? String,
             lineItemId: adMetadata["line_item_id"] as? String,

package/ios/BigCrunchAds/Sources/BigCrunchAds.swift

@@ -156,14 +156,16 @@ public final class BigCrunchAds {
     /**
      * Track screen view for analytics
      *
-     * - Parameter screenName: Name of the screen being viewed
+     * - Parameters:
+     *   - screenName: Name of the screen being viewed
+     *   - options: Optional overrides for page URL, content metadata, and custom dimensions
      */
-    public static func trackScreen(_ screenName: String) {
+    public static func trackScreen(_ screenName: String, options: ScreenViewOptions? = nil) {
         guard _isInitialized else {
             BCLogger.warning("trackScreen called before initialization, ignoring")
             return
         }
-        analyticsClient.trackScreenView(screenName)
+        analyticsClient.trackScreenView(screenName, options: options)
         SessionManager.shared.startPageView()
     }
 
@@ -247,6 +249,25 @@ public final class BigCrunchAds {
         )
     }
 
+    // MARK: - Account Type
+
+    /**
+     * Set the account type for the current user
+     *
+     * Included in all analytics events. Defaults to "guest" if not set.
+     * Valid values: "guest", "logged_in", "paid", "subscriber", "free"
+     *
+     * - Parameter accountType: The user's account type
+     */
+    public static func setAccountType(_ accountType: String) {
+        guard _isInitialized else {
+            BCLogger.warning("setAccountType called before initialization, ignoring")
+            return
+        }
+        analyticsClient.setAccountType(accountType)
+        BCLogger.debug("Account type set to: \(accountType)")
+    }
+
     // MARK: - Privacy Compliance
 
     /**
@@ -352,10 +373,12 @@ public final class BigCrunchAds {
     /**
      * Track screen view for analytics (alias for Android API compatibility)
      *
-     * - Parameter screenName: Name of the screen being viewed
+     * - Parameters:
+     *   - screenName: Name of the screen being viewed
+     *   - options: Optional overrides for page URL, content metadata, and custom dimensions
      */
-    public static func trackScreenView(_ screenName: String) {
-        trackScreen(screenName)
+    public static func trackScreenView(_ screenName: String, options: ScreenViewOptions? = nil) {
+        trackScreen(screenName, options: options)
     }
 
     // MARK: - Internal

package/ios/BigCrunchAds/Sources/BigCrunchRewarded.swift

@@ -172,8 +172,8 @@ public final class BigCrunchRewarded {
 
         // Fetch S2S demand
         if let bidRequestClient = BigCrunchAds.getBidRequestClient() {
-            let targeting = await bidRequestClient.fetchDemand(placement: placement)
-            if let targeting = targeting, !targeting.isEmpty {
+            let bidResponse = await bidRequestClient.fetchDemand(placement: placement)
+            if let targeting = bidResponse?.targeting, !targeting.isEmpty {
                 var customTargeting = request.customTargeting ?? [:]
                 for (key, value) in targeting {
                     customTargeting[key] = value
@@ -183,6 +183,14 @@ public final class BigCrunchRewarded {
             } else {
                 BCLogger.warning("\(TAG): S2S demand fetch returned no targeting, continuing with Google only")
             }
+
+            // Store auction data for analytics
+            let auctionData = bidResponse?.auctionData ?? AuctionData(
+                auctionId: nil, bidder: "google_ad_exchange", bidPriceCpm: nil, creativeId: nil,
+                gamPriceBucket: nil, floorPrice: placement.floorPrice, secondHighestBid: nil,
+                demandChannel: "Google Ad Exchange"
+            )
+            BigCrunchAds.getAnalyticsClient().setAuctionData(placementId: placement.placementId, auctionData: auctionData)
         }
 
         // Load Google rewarded ad

package/ios/BigCrunchAds/Sources/Core/AdOrchestrator.swift

@@ -160,8 +160,8 @@ internal class AdOrchestrator {
         let adRequest = GoogleMobileAds.Request()
 
         // 3. Fetch S2S demand (even if it fails, continue with Google)
-        let targeting = await bidRequestClient.fetchDemand(placement: placement)
-        if let targeting = targeting, !targeting.isEmpty {
+        let bidResponse = await bidRequestClient.fetchDemand(placement: placement)
+        if let targeting = bidResponse?.targeting, !targeting.isEmpty {
             var customTargeting = adRequest.customTargeting ?? [:]
             for (key, value) in targeting {
                 customTargeting[key] = value
@@ -172,6 +172,14 @@ internal class AdOrchestrator {
             BCLogger.warning("\(AdOrchestrator.TAG): S2S demand fetch returned no targeting, continuing with Google only")
         }
 
+        // Store auction data for analytics (or default to GAM if no S2S)
+        let auctionData = bidResponse?.auctionData ?? AuctionData(
+            auctionId: nil, bidder: "google_ad_exchange", bidPriceCpm: nil, creativeId: nil,
+            gamPriceBucket: nil, floorPrice: placement.floorPrice, secondHighestBid: nil,
+            demandChannel: "Google Ad Exchange"
+        )
+        analyticsClient.setAuctionData(placementId: placement.placementId, auctionData: auctionData)
+
         // 4. Load Google ad with the (possibly enriched) ad request
         let delegateWrapper = BannerDelegateAdapterWrapper(
             placementId: placement.placementId,
@@ -284,8 +292,8 @@ internal class AdOrchestrator {
         let adRequest = GoogleMobileAds.Request()
 
         // 3. Fetch S2S demand
-        let targeting = await bidRequestClient.fetchDemand(placement: placement)
-        if let targeting = targeting, !targeting.isEmpty {
+        let bidResponse = await bidRequestClient.fetchDemand(placement: placement)
+        if let targeting = bidResponse?.targeting, !targeting.isEmpty {
             var customTargeting = adRequest.customTargeting ?? [:]
             for (key, value) in targeting {
                 customTargeting[key] = value
@@ -296,6 +304,14 @@ internal class AdOrchestrator {
             BCLogger.warning("\(AdOrchestrator.TAG): S2S demand fetch returned no targeting, continuing with Google only")
         }
 
+        // Store auction data for analytics (or default to GAM if no S2S)
+        let auctionData = bidResponse?.auctionData ?? AuctionData(
+            auctionId: nil, bidder: "google_ad_exchange", bidPriceCpm: nil, creativeId: nil,
+            gamPriceBucket: nil, floorPrice: placement.floorPrice, secondHighestBid: nil,
+            demandChannel: "Google Ad Exchange"
+        )
+        analyticsClient.setAuctionData(placementId: placement.placementId, auctionData: auctionData)
+
         // Check if we should use test ad units
         let useTestAds = configManager.shouldUseTestAds()