@bigcrunch/react-native-ads 0.14.0 → 0.15.0

package/android/bigcrunch-ads/com/bigcrunch/ads/adapters/GoogleAdsAdapter.kt

@@ -238,6 +238,7 @@ internal class GoogleAdsAdapter(
 
                 analyticsClient.trackAdImpression(
                     placementId = placementConfig.placementId,
+                    slotId = placementConfig.id,
                     format = placementConfig.format,
                     gamAdUnit = placementConfig.gamAdUnit,
                     adSize = adSizeString,
@@ -257,7 +258,7 @@ internal class GoogleAdsAdapter(
 
             override fun onAdClicked() {
                 BCLogger.d(TAG, "Banner ad clicked: ${placementConfig.placementId}")
-                analyticsClient.trackAdClick(placementConfig.placementId, placementConfig.format)
+                analyticsClient.trackAdClick(placementConfig.placementId, placementConfig.id, placementConfig.format)
                 safeCallback { callback.onAdClicked() }
             }
 
@@ -398,6 +399,7 @@ internal class GoogleAdsAdapter(
 
                 analyticsClient.trackAdImpression(
                     placementId = placementConfig.placementId,
+                    slotId = placementConfig.id,
                     format = placementConfig.format,
                     gamAdUnit = placementConfig.gamAdUnit,
                     advertiserId = adMetadata["advertiser_id"] as? String,
@@ -420,7 +422,7 @@ internal class GoogleAdsAdapter(
 
             override fun onAdClicked() {
                 BCLogger.d(TAG, "Interstitial ad clicked: ${placementConfig.placementId}")
-                analyticsClient.trackAdClick(placementConfig.placementId, placementConfig.format)
+                analyticsClient.trackAdClick(placementConfig.placementId, placementConfig.id, placementConfig.format)
                 safeCallback { callback.onAdClicked() }
             }
 
@@ -506,6 +508,7 @@ internal class GoogleAdsAdapter(
 
                 analyticsClient.trackAdImpression(
                     placementId = placementConfig.placementId,
+                    slotId = placementConfig.id,
                     format = placementConfig.format,
                     gamAdUnit = placementConfig.gamAdUnit,
                     advertiserId = adMetadata["advertiser_id"] as? String,
@@ -528,7 +531,7 @@ internal class GoogleAdsAdapter(
 
             override fun onAdClicked() {
                 BCLogger.d(TAG, "Rewarded ad clicked: ${placementConfig.placementId}")
-                analyticsClient.trackAdClick(placementConfig.placementId, placementConfig.format)
+                analyticsClient.trackAdClick(placementConfig.placementId, placementConfig.id, placementConfig.format)
                 safeCallback { callback.onAdClicked() }
             }
 

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

@@ -293,6 +293,7 @@ internal class AnalyticsClient(
      */
     fun createImpressionContext(
         placementId: String,
+        slotId: String,
         gamAdUnit: String,
         format: String,
         width: Int? = null,
@@ -300,6 +301,7 @@ internal class AnalyticsClient(
     ): ImpressionContext {
         val context = ImpressionContext(
             placementId = placementId,
+            slotId = slotId,
             gamAdUnit = gamAdUnit,
             format = format,
             width = width,
@@ -396,7 +398,7 @@ internal class AnalyticsClient(
 
         // Create impression record with auction data fields populated
         val impressionRecord = ImpressionRecord(
-            slotId = context.placementId,
+            slotId = context.slotId,
             gamUnit = context.gamAdUnit,
             gamPriceBucket = effectiveAuctionData.gamPriceBucket ?: "",
             impressionId = context.impressionId,
@@ -458,6 +460,7 @@ internal class AnalyticsClient(
      */
     fun trackAdImpression(
         placementId: String,
+        slotId: String,
         format: String,
         gamAdUnit: String = "",
         adSize: String = "",
@@ -482,7 +485,7 @@ internal class AnalyticsClient(
 
         // Create impression record with auction data fields populated
         val impressionRecord = ImpressionRecord(
-            slotId = placementId,
+            slotId = slotId,
             gamUnit = gamAdUnit,
             gamPriceBucket = auctionData?.gamPriceBucket ?: "",
             impressionId = UUID.randomUUID().toString(),
@@ -552,7 +555,7 @@ internal class AnalyticsClient(
      * @param placementId Placement ID
      * @param format Ad format
      */
-    fun trackAdClick(impressionId: String, placementId: String, format: String) {
+    fun trackAdClick(impressionId: String, placementId: String, slotId: String, format: String) {
         // Get common event fields
         val common = getCommonEventFields()
 
@@ -562,7 +565,7 @@ internal class AnalyticsClient(
         // Create nested click data - impressionId must be valid UUID
         val clickData = ClickData(
             clickId = UUID.randomUUID().toString(),
-            slotId = placementId,
+            slotId = slotId,
             impressionId = impressionId.takeIf { it.isNotEmpty() } ?: UUID.randomUUID().toString()
         )
 
@@ -607,8 +610,8 @@ internal class AnalyticsClient(
     /**
      * Track an ad click (simple version without impression ID)
      */
-    fun trackAdClick(placementId: String, format: String) {
-        trackAdClick("", placementId, format)
+    fun trackAdClick(placementId: String, slotId: String, format: String) {
+        trackAdClick("", placementId, slotId, format)
     }
 
     // MARK: - Viewability Tracking
@@ -625,6 +628,7 @@ internal class AnalyticsClient(
     fun trackAdViewable(
         impressionId: String,
         placementId: String,
+        slotId: String,
         format: String,
         viewableTimeMs: Long,
         percentVisible: Int
@@ -637,7 +641,7 @@ internal class AnalyticsClient(
 
         // Create nested viewability data - impressionId must be valid UUID
         val viewabilityData = ViewabilityData(
-            slotId = placementId,
+            slotId = slotId,
             impressionId = impressionId.takeIf { it.isNotEmpty() } ?: UUID.randomUUID().toString()
         )
 
@@ -682,8 +686,8 @@ internal class AnalyticsClient(
     /**
      * Track ad viewability (simple version without metrics)
      */
-    fun trackAdViewable(placementId: String, format: String) {
-        trackAdViewable("", placementId, format, 0, 0)
+    fun trackAdViewable(placementId: String, slotId: String, format: String) {
+        trackAdViewable("", placementId, slotId, format, 0, 0)
     }
 
     // MARK: - Engagement Tracking

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

@@ -188,7 +188,7 @@ internal class BidRequestClient(
 
     private fun buildImp(placement: PlacementConfig): JSONObject {
         val imp = JSONObject()
-        imp.put("id", placement.placementId)
+        imp.put("id", placement.id)
 
         val deviceContext = DeviceContext.getInstance()
 
@@ -268,7 +268,8 @@ internal class BidRequestClient(
      */
     private fun buildBiddersExt(placements: List<PlacementConfig>): JSONObject {
         val bidders = configManager.getCachedConfig()?.bidders ?: return JSONObject()
-        val placementIds = placements.map { it.placementId }.toSet()
+        val placementIdToUuid = placements.associate { it.placementId to it.id }
+        val placementIds = placementIdToUuid.keys
         val biddersExt = JSONObject()
 
         for ((bidderName, bidderEntry) in bidders) {
@@ -285,7 +286,7 @@ internal class BidRequestClient(
                 for (placementId in placementIds) {
                     bidderPlacements[placementId]?.let { impParams ->
                         impArray.put(JSONObject().apply {
-                            put("impid", placementId)
+                            put("impid", placementIdToUuid[placementId])
                             put("params", mapToJson(impParams))
                         })
                     }
@@ -316,8 +317,9 @@ internal class BidRequestClient(
 
             val auctionId = json.optString("id", "")
 
-            // Build floor price lookup from placement configs
-            val floorPrices = placements.associate { it.placementId to it.floorPrice }
+            // Build floor price lookup and UUID-to-placementId mapping
+            val floorPrices = placements.associate { it.id to it.floorPrice }
+            val uuidToPlacementId = placements.associate { it.id to it.placementId }
 
             // Collect all bids grouped by impid
             data class BidInfo(
@@ -376,8 +378,10 @@ internal class BidRequestClient(
                     demandChannel = "S2S"
                 )
 
-                results[impid] = BidResponse(winner.targeting, auctionData)
-                BCLogger.d(TAG, "Winner for $impid: $${winner.price}")
+                // Re-key from UUID to placementId for internal use
+                val placementId = uuidToPlacementId[impid] ?: impid
+                results[placementId] = BidResponse(winner.targeting, auctionData)
+                BCLogger.d(TAG, "Winner for $placementId: $${winner.price}")
             }
 
             BCLogger.i(TAG, "Parsed ${results.size} winning bids")

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

@@ -5,10 +5,14 @@ import com.bigcrunch.ads.internal.HttpClient
 import com.bigcrunch.ads.internal.KeyValueStore
 import com.bigcrunch.ads.models.AppConfig
 import com.bigcrunch.ads.models.PlacementConfig
+import com.squareup.moshi.JsonDataException
+import com.squareup.moshi.JsonEncodingException
 import com.squareup.moshi.Moshi
 import kotlinx.coroutines.sync.Mutex
 import kotlinx.coroutines.sync.withLock
 
+class ConfigParseException(message: String, cause: Throwable? = null) : Exception(message, cause)
+
 /**
  * Manages application configuration fetching, caching, and access
  *
@@ -61,12 +65,14 @@ internal class ConfigManager(
                 refresh = com.bigcrunch.ads.models.RefreshConfig(enabled = true, intervalMs = 30000, maxRefreshes = 20),
                 placements = listOf(
                     PlacementConfig(
+                        id = "00000000-0000-0000-0000-000000000001",
                         placementId = "test_banner_320x50",
                         format = "banner",
                         gamAdUnit = "ca-app-pub-3940256099942544/6300978111",
                         sizes = listOf(com.bigcrunch.ads.models.AdSize(width = 320, height = 50))
                     ),
                     PlacementConfig(
+                        id = "00000000-0000-0000-0000-000000000002",
                         placementId = "test_mrec",
                         format = "banner",
                         gamAdUnit = "ca-app-pub-3940256099942544/6300978111",
@@ -74,18 +80,21 @@ internal class ConfigManager(
                         refresh = com.bigcrunch.ads.models.RefreshConfig(enabled = true, intervalMs = 15000, maxRefreshes = 40)
                     ),
                     PlacementConfig(
+                        id = "00000000-0000-0000-0000-000000000003",
                         placementId = "test_adaptive_banner",
                         format = "banner",
                         gamAdUnit = "ca-app-pub-3940256099942544/6300978111",
                         sizes = listOf(com.bigcrunch.ads.models.AdSize.adaptive())
                     ),
                     PlacementConfig(
+                        id = "00000000-0000-0000-0000-000000000004",
                         placementId = "test_interstitial",
                         format = "interstitial",
                         gamAdUnit = "ca-app-pub-3940256099942544/1033173712",
                         sizes = null
                     ),
                     PlacementConfig(
+                        id = "00000000-0000-0000-0000-000000000005",
                         placementId = "test_rewarded",
                         format = "rewarded",
                         gamAdUnit = "ca-app-pub-3940256099942544/5224354917",
@@ -150,8 +159,9 @@ internal class ConfigManager(
                 val config = try {
                     adapter.fromJson(json)
                 } catch (e: Exception) {
-                    BCLogger.e("ConfigManager", "Failed to parse config JSON from $url", e)
-                    null
+                    val message = describeJsonError(e)
+                    BCLogger.e("ConfigManager", "Failed to parse config JSON from $url: $message", e)
+                    return Result.failure(ConfigParseException(message, e))
                 }
 
                 if (config != null) {
@@ -163,7 +173,7 @@ internal class ConfigManager(
                     Result.success(config)
                 } else {
                     BCLogger.e("ConfigManager", "Invalid config JSON")
-                    Result.failure(Exception("Invalid config JSON"))
+                    Result.failure(ConfigParseException("Config JSON parsed to null"))
                 }
             }
             storedConfig != null -> {
@@ -288,11 +298,22 @@ internal class ConfigManager(
             val json = storage.getString(CONFIG_STORAGE_KEY) ?: return null
             adapter.fromJson(json)
         } catch (e: Exception) {
-            BCLogger.e("ConfigManager", "Failed to load config from storage", e)
+            BCLogger.e("ConfigManager", "Failed to load config from storage: ${describeJsonError(e)}", e)
             null
         }
     }
 
+    /**
+     * Produce a human-readable description from a Moshi parse error
+     */
+    private fun describeJsonError(e: Exception): String {
+        return when (e) {
+            is JsonDataException -> e.message ?: "Invalid JSON data"
+            is JsonEncodingException -> e.message ?: "Malformed JSON"
+            else -> e.message ?: e.toString()
+        }
+    }
+
     /**
      * Save config to persistent storage
      */

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.14.0"
+        internal const val SDK_VERSION = "0.15.0"
 
         @Volatile
         private var instance: DeviceContext? = null

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

@@ -944,6 +944,8 @@ internal data class ImpressionContext(
 
     /** Placement configuration */
     val placementId: String,
+    /** UUID for backend reporting (slot_id) */
+    val slotId: String,
     val gamAdUnit: String,
     val format: String,
 

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

@@ -12,6 +12,9 @@ import com.squareup.moshi.JsonClass
  */
 @JsonClass(generateAdapter = true)
 data class PlacementConfig(
+    @Json(name = "id")
+    val id: String,
+
     @Json(name = "placementId")
     val placementId: String,
 

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

@@ -46,7 +46,7 @@ class BigCrunchAdsModule(reactContext: ReactApplicationContext) :
                     BigCrunchAds.initialize(
                         context = context,
                         propertyId = propertyId,
-                        env = if (environment == "staging")
+                        env = if (environment == "sandbox" || environment == "staging")
                             BigCrunchAds.Environment.Staging
                         else
                             BigCrunchAds.Environment.Prod,

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

@@ -367,6 +367,7 @@ private class BannerDelegateWrapper: NSObject, GoogleMobileAds.BannerViewDelegat
 
         analyticsClient.trackAdImpression(
             placementId: placementConfig.placementId,
+            slotId: placementConfig.id,
             format: placementConfig.format,
             gamAdUnit: placementConfig.gamAdUnit,
             adSize: adSizeString,
@@ -388,6 +389,7 @@ private class BannerDelegateWrapper: NSObject, GoogleMobileAds.BannerViewDelegat
         BCLogger.debug("GoogleAdsAdapter: Banner ad clicked: \(placementConfig.placementId)")
         analyticsClient.trackAdClick(
             placementId: placementConfig.placementId,
+            slotId: placementConfig.id,
             format: placementConfig.format
         )
         delegate?.bannerAdDidRecordClick(bannerView)
@@ -431,6 +433,7 @@ private class InterstitialDelegateWrapper: NSObject, GoogleMobileAds.FullScreenC
 
         analyticsClient.trackAdImpression(
             placementId: placementConfig.placementId,
+            slotId: placementConfig.id,
             format: placementConfig.format,
             gamAdUnit: placementConfig.gamAdUnit,
             advertiserId: adMetadata["advertiser_id"] as? String,
@@ -457,6 +460,7 @@ private class InterstitialDelegateWrapper: NSObject, GoogleMobileAds.FullScreenC
         BCLogger.debug("GoogleAdsAdapter: Interstitial ad clicked: \(placementConfig.placementId)")
         analyticsClient.trackAdClick(
             placementId: placementConfig.placementId,
+            slotId: placementConfig.id,
             format: placementConfig.format
         )
         delegate?.interstitialAdDidRecordClick(interstitialAd)

package/ios/BigCrunchAds/Sources/BigCrunchRewarded.swift

@@ -465,6 +465,7 @@ private class RewardedDelegateWrapper: NSObject, FullScreenContentDelegate {
 
             analyticsClient.trackAdImpression(
                 placementId: placementConfig.placementId,
+                slotId: placementConfig.id,
                 format: placementConfig.format,
                 advertiserId: adMetadata["advertiser_id"] as? String,
                 campaignId: adMetadata["campaign_id"] as? String,
@@ -492,6 +493,7 @@ private class RewardedDelegateWrapper: NSObject, FullScreenContentDelegate {
         BCLogger.debug("BigCrunchRewarded: Rewarded ad clicked: \(placementId)")
         analyticsClient.trackAdClick(
             placementId: placementConfig.placementId,
+            slotId: placementConfig.id,
             format: placementConfig.format
         )
         delegate?.rewardedDidClick(placementId: placementId)

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

@@ -239,6 +239,7 @@ internal class AnalyticsClient {
      */
     func createImpressionContext(
         placementId: String,
+        slotId: String,
         gamAdUnit: String,
         format: String,
         width: Int? = nil,
@@ -246,6 +247,7 @@ internal class AnalyticsClient {
     ) -> ImpressionContext {
         let context = ImpressionContext(
             placementId: placementId,
+            slotId: slotId,
             gamAdUnit: gamAdUnit,
             format: format,
             width: width,
@@ -351,7 +353,7 @@ internal class AnalyticsClient {
 
         // Create the impression record
         let impressionRecord = ImpressionRecord(
-            slotId: context.placementId,
+            slotId: context.slotId,
             gamUnit: context.gamAdUnit,
             gamPriceBucket: effectiveAuctionData.gamPriceBucket ?? "",
             impressionId: context.impressionId,
@@ -417,6 +419,7 @@ internal class AnalyticsClient {
      */
     func trackAdImpression(
         placementId: String,
+        slotId: String,
         format: String,
         gamAdUnit: String = "",
         adSize: String = "",
@@ -445,7 +448,7 @@ internal class AnalyticsClient {
 
         // Create the impression record with auction data fields populated
         let impressionRecord = ImpressionRecord(
-            slotId: placementId,
+            slotId: slotId,
             gamUnit: gamAdUnit,
             gamPriceBucket: auctionData?.gamPriceBucket ?? "",
             impressionId: UUID().uuidString,
@@ -516,7 +519,7 @@ internal class AnalyticsClient {
      *   - placementId: Placement ID
      *   - format: Ad format
      */
-    func trackAdClick(impressionId: String, placementId: String, format: String) {
+    func trackAdClick(impressionId: String, placementId: String, slotId: String, format: String) {
         // Get common event fields
         let common = getCommonEventFields()
 
@@ -530,7 +533,7 @@ internal class AnalyticsClient {
         // Note: customDimensions values must be string arrays per backend validation
         let clickData = ClickData(
             clickId: UUID().uuidString,
-            slotId: placementId,
+            slotId: slotId,
             impressionId: impressionId.isEmpty ? UUID().uuidString : impressionId,  // Must be valid UUID
             refreshCount: 0,
             adAmznp: "",
@@ -586,8 +589,8 @@ internal class AnalyticsClient {
     /**
      * Track an ad click (simple version without impression ID)
      */
-    func trackAdClick(placementId: String, format: String) {
-        trackAdClick(impressionId: "", placementId: placementId, format: format)
+    func trackAdClick(placementId: String, slotId: String, format: String) {
+        trackAdClick(impressionId: "", placementId: placementId, slotId: slotId, format: format)
     }
 
     // MARK: - Viewability Tracking
@@ -605,6 +608,7 @@ internal class AnalyticsClient {
     func trackAdViewable(
         impressionId: String,
         placementId: String,
+        slotId: String,
         format: String,
         viewableTimeMs: Int64,
         percentVisible: Int
@@ -620,7 +624,7 @@ internal class AnalyticsClient {
 
         // Create viewability data with nested structure per backend schema
         let viewabilityData = ViewabilityData(
-            slotId: placementId,
+            slotId: slotId,
             impressionId: impressionId.isEmpty ? UUID().uuidString : impressionId,  // Must be valid UUID
             refreshCount: 0,
             adAmznp: "",
@@ -675,7 +679,7 @@ internal class AnalyticsClient {
     /**
      * Track ad viewability (simple version without metrics)
      */
-    func trackAdViewable(placementId: String, format: String) {
+    func trackAdViewable(placementId: String, slotId: String, format: String) {
         // Get common event fields
         let common = getCommonEventFields()
 
@@ -687,7 +691,7 @@ internal class AnalyticsClient {
 
         // Create viewability data with nested structure per backend schema
         let viewabilityData = ViewabilityData(
-            slotId: placementId,
+            slotId: slotId,
             impressionId: UUID().uuidString,  // Generate UUID since none provided
             refreshCount: 0,
             adAmznp: "",

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

@@ -189,7 +189,7 @@ internal class BidRequestClient {
 
     private func buildImp(_ placement: PlacementConfig) -> [String: Any] {
         var imp: [String: Any] = [
-            "id": placement.placementId
+            "id": placement.id
         ]
 
         switch placement.format {
@@ -262,7 +262,8 @@ internal class BidRequestClient {
             return [:]
         }
 
-        let placementIds = Set(placements.map { $0.placementId })
+        let placementIdToUuid = Dictionary(uniqueKeysWithValues: placements.map { ($0.placementId, $0.id) })
+        let placementIds = Set(placementIdToUuid.keys)
         var biddersExt: [String: Any] = [:]
 
         for (bidderName, bidderEntry) in bidders {
@@ -279,7 +280,7 @@ internal class BidRequestClient {
                 for placementId in placementIds {
                     if let impParams = bidderPlacements[placementId] {
                         impEntries.append([
-                            "impid": placementId,
+                            "impid": placementIdToUuid[placementId] ?? placementId,
                             "params": impParams.mapValues { $0.value }
                         ])
                     }
@@ -326,8 +327,9 @@ internal class BidRequestClient {
 
         let auctionId = json["id"] as? String
 
-        // Build floor price lookup from placement configs
-        let floorPrices = Dictionary(uniqueKeysWithValues: placements.map { ($0.placementId, $0.floorPrice) })
+        // Build floor price lookup (keyed by UUID) and UUID-to-placementId mapping
+        let floorPrices = Dictionary(uniqueKeysWithValues: placements.map { ($0.id, $0.floorPrice) })
+        let uuidToPlacementId = Dictionary(uniqueKeysWithValues: placements.map { ($0.id, $0.placementId) })
 
         // Collect all bids grouped by impid
         struct BidInfo {
@@ -376,8 +378,10 @@ internal class BidRequestClient {
                 demandChannel: "S2S"
             )
 
-            results[impid] = BidResponse(targeting: winner.targeting, auctionData: auctionData)
-            BCLogger.debug("BidRequestClient: Winner for \(impid): $\(winner.price)")
+            // Re-key from UUID to placementId for internal use
+            let placementId = uuidToPlacementId[impid] ?? impid
+            results[placementId] = BidResponse(targeting: winner.targeting, auctionData: auctionData)
+            BCLogger.debug("BidRequestClient: Winner for \(placementId): $\(winner.price)")
         }
 
         BCLogger.info("BidRequestClient: Parsed \(results.count) winning bids")

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

@@ -12,6 +12,17 @@ import Foundation
  *
  * The config is fetched once at SDK initialization and cached for the app session.
  */
+enum ConfigError: LocalizedError {
+    case parseError(String)
+
+    var errorDescription: String? {
+        switch self {
+        case .parseError(let message):
+            return message
+        }
+    }
+}
+
 internal class ConfigManager {
 
     private let httpClient: HTTPClient
@@ -55,12 +66,14 @@ internal class ConfigManager {
             refresh: RefreshConfig(enabled: true, intervalMs: 30000, maxRefreshes: 20),
             placements: [
                 PlacementConfig(
+                    id: "00000000-0000-0000-0000-000000000001",
                     placementId: "test_banner_320x50",
                     format: "banner",
                     gamAdUnit: "ca-app-pub-3940256099942544/2435281174",
                     sizes: [AdSize(width: 320, height: 50)]
                 ),
                 PlacementConfig(
+                    id: "00000000-0000-0000-0000-000000000002",
                     placementId: "test_mrec",
                     format: "banner",
                     gamAdUnit: "ca-app-pub-3940256099942544/2435281174",
@@ -68,18 +81,21 @@ internal class ConfigManager {
                     refresh: RefreshConfig(enabled: true, intervalMs: 15000, maxRefreshes: 40)
                 ),
                 PlacementConfig(
+                    id: "00000000-0000-0000-0000-000000000003",
                     placementId: "test_adaptive_banner",
                     format: "banner",
                     gamAdUnit: "ca-app-pub-3940256099942544/2435281174",
                     sizes: [AdSize.adaptive()]
                 ),
                 PlacementConfig(
+                    id: "00000000-0000-0000-0000-000000000004",
                     placementId: "test_interstitial",
                     format: "interstitial",
                     gamAdUnit: "ca-app-pub-3940256099942544/4411468910",
                     sizes: nil
                 ),
                 PlacementConfig(
+                    id: "00000000-0000-0000-0000-000000000005",
                     placementId: "test_rewarded",
                     format: "rewarded",
                     gamAdUnit: "ca-app-pub-3940256099942544/1712485313",
@@ -152,8 +168,9 @@ internal class ConfigManager {
                 BCLogger.verbose("Config JSON: \(json)")
                 return .success(config)
             } catch {
-                BCLogger.error("Failed to parse config JSON from \(url): \(error)")
-                return .failure(error)
+                let message = Self.describeDecodingError(error)
+                BCLogger.error("Failed to parse config JSON from \(url): \(message)")
+                return .failure(ConfigError.parseError(message))
             }
 
         case .failure(let error):
@@ -295,11 +312,51 @@ internal class ConfigManager {
         do {
             return try JSONDecoder().decode(AppConfig.self, from: data)
         } catch {
-            BCLogger.error("Failed to load config from storage: \(error)")
+            BCLogger.error("Failed to load config from storage: \(Self.describeDecodingError(error))")
             return nil
         }
     }
 
+    /**
+     * Produce a human-readable description from a DecodingError
+     */
+    private static func describeDecodingError(_ error: Error) -> String {
+        guard let decodingError = error as? DecodingError else {
+            return error.localizedDescription
+        }
+
+        let path: String
+        let detail: String
+
+        switch decodingError {
+        case .keyNotFound(let key, let context):
+            path = Self.formatCodingPath(context.codingPath)
+            detail = "missing required field '\(key.stringValue)'"
+        case .typeMismatch(let type, let context):
+            path = Self.formatCodingPath(context.codingPath)
+            detail = "expected \(type)"
+        case .valueNotFound(let type, let context):
+            path = Self.formatCodingPath(context.codingPath)
+            detail = "null value for \(type)"
+        case .dataCorrupted(let context):
+            path = Self.formatCodingPath(context.codingPath)
+            detail = context.debugDescription
+        @unknown default:
+            return error.localizedDescription
+        }
+
+        return path.isEmpty ? detail : "\(path): \(detail)"
+    }
+
+    private static func formatCodingPath(_ codingPath: [CodingKey]) -> String {
+        return codingPath.map { key in
+            if let index = key.intValue {
+                return "[\(index)]"
+            }
+            return key.stringValue
+        }.joined(separator: ".")
+    }
+
     /**
      * Save config to persistent storage
      */

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

@@ -74,7 +74,7 @@ internal final class DeviceContext {
     // MARK: - SDK Properties
 
     /// SDK version
-    static let SDK_VERSION = "0.14.0"
+    static let SDK_VERSION = "0.15.0"
     let sdkVersion: String = SDK_VERSION
 
     /// SDK platform (always "ios")

package/ios/BigCrunchAds/Sources/Models/AdEvent.swift

@@ -860,6 +860,8 @@ internal struct ImpressionContext {
 
     /// Placement configuration
     let placementId: String
+    /// UUID for backend reporting (slot_id)
+    let slotId: String
     let gamAdUnit: String
     let format: String
 
@@ -875,6 +877,7 @@ internal struct ImpressionContext {
 
     init(
         placementId: String,
+        slotId: String,
         gamAdUnit: String,
         format: String,
         width: Int? = nil,
@@ -882,6 +885,7 @@ internal struct ImpressionContext {
     ) {
         self.impressionId = UUID().uuidString
         self.placementId = placementId
+        self.slotId = slotId
         self.gamAdUnit = gamAdUnit
         self.format = format
         self.width = width

package/ios/BigCrunchAds/Sources/Models/PlacementConfig.swift

@@ -8,6 +8,7 @@ import Foundation
  * in the top-level `AppConfig.bidders` dictionary.
  */
 public struct PlacementConfig: Codable {
+    public let id: String
     public let placementId: String
     public let format: String // "banner", "interstitial", "rewarded"
     public let gamAdUnit: String
@@ -16,6 +17,7 @@ public struct PlacementConfig: Codable {
     public let floorPrice: Double?
 
     public init(
+        id: String,
         placementId: String,
         format: String,
         gamAdUnit: String,
@@ -23,6 +25,7 @@ public struct PlacementConfig: Codable {
         refresh: RefreshConfig? = nil,
         floorPrice: Double? = nil
     ) {
+        self.id = id
         self.placementId = placementId
         self.format = format
         self.gamAdUnit = gamAdUnit

package/lib/types/config.d.ts

@@ -27,7 +27,9 @@ export interface AppConfig {
  * Individual placement configuration
  */
 export interface PlacementConfig {
-    /** Unique placement ID */
+    /** Unique placement UUID for backend reporting */
+    id: string;
+    /** Developer-facing placement identifier */
     placementId: string;
     /** Placement name for reporting */
     placementName?: string;

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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bigcrunch/react-native-ads",
-  "version": "0.14.0",
+  "version": "0.15.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",

package/src/types/config.ts

@@ -30,7 +30,9 @@ export interface AppConfig {
  * Individual placement configuration
  */
 export interface PlacementConfig {
-  /** Unique placement ID */
+  /** Unique placement UUID for backend reporting */
+  id: string;
+  /** Developer-facing placement identifier */
   placementId: string;
   /** Placement name for reporting */
   placementName?: string;