@bigcrunch/react-native-ads 0.13.0 → 0.15.0

package/android/bigcrunch-ads/com/bigcrunch/ads/BigCrunchAds.kt

@@ -341,6 +341,20 @@ object BigCrunchAds {
         DeviceHelper.getDeviceData(appContext)
     }
 
+    /**
+     * 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"
+     *
+     * @param accountType The user's account type
+     */
+    fun setAccountType(accountType: String) = runSafely {
+        requireInitialized()
+        analyticsClient.setAccountType(accountType)
+        BCLogger.d(TAG, "Account type set to: $accountType")
+    }
+
     /**
      * Set GDPR consent string for privacy compliance
      *

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

@@ -77,6 +77,10 @@ internal class AnalyticsClient(
     @Volatile
     private var currentCustomDimensions: Map<String, String> = emptyMap()
 
+    /** Current account type (set by setAccountType, used by all events) */
+    @Volatile
+    private var currentAcctType: String = "guest"
+
     // MARK: - Session Context
 
     private val sessionManager: SessionManager
@@ -265,7 +269,7 @@ internal class AnalyticsClient(
             utmContent = common.utmContent ?: "",
             gclid = "",
             fbclid = "",
-            acctType = "anonymous",
+            acctType = currentAcctType,
             diiSource = "",
             gamNetworkCode = gamNetworkCode,
             amznPubId = NIL_UUID,
@@ -289,6 +293,7 @@ internal class AnalyticsClient(
      */
     fun createImpressionContext(
         placementId: String,
+        slotId: String,
         gamAdUnit: String,
         format: String,
         width: Int? = null,
@@ -296,6 +301,7 @@ internal class AnalyticsClient(
     ): ImpressionContext {
         val context = ImpressionContext(
             placementId = placementId,
+            slotId = slotId,
             gamAdUnit = gamAdUnit,
             format = format,
             width = width,
@@ -331,6 +337,10 @@ internal class AnalyticsClient(
     /**
      * Store auction data for a placement (called by AdOrchestrator after S2S demand fetch)
      */
+    fun setAccountType(accountType: String) {
+        currentAcctType = accountType
+    }
+
     fun setAuctionData(placementId: String, auctionData: AuctionData) {
         placementAuctionData[placementId] = auctionData
         BCLogger.d(TAG, "Stored auction data for placement: $placementId (channel: ${auctionData.demandChannel ?: "unknown"})")
@@ -388,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,
@@ -434,7 +444,7 @@ internal class AnalyticsClient(
             utmContent = common.utmContent ?: "",
             gclid = "",
             fbclid = "",
-            acctType = "anonymous",
+            acctType = currentAcctType,
             diiSource = "",
             gamNetworkCode = getGamNetworkCode(),
             amznPubId = NIL_UUID,
@@ -450,6 +460,7 @@ internal class AnalyticsClient(
      */
     fun trackAdImpression(
         placementId: String,
+        slotId: String,
         format: String,
         gamAdUnit: String = "",
         adSize: String = "",
@@ -474,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(),
@@ -524,7 +535,7 @@ internal class AnalyticsClient(
             utmContent = common.utmContent ?: "",
             gclid = "",
             fbclid = "",
-            acctType = "anonymous",
+            acctType = currentAcctType,
             diiSource = "",
             gamNetworkCode = getGamNetworkCode(),
             amznPubId = NIL_UUID,
@@ -544,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()
 
@@ -554,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()
         )
 
@@ -585,7 +596,7 @@ internal class AnalyticsClient(
             utmContent = common.utmContent ?: "",
             gclid = "",
             fbclid = "",
-            acctType = "anonymous",
+            acctType = currentAcctType,
             diiSource = "",
             gamNetworkCode = getGamNetworkCode(),
             amznPubId = NIL_UUID,
@@ -599,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
@@ -617,6 +628,7 @@ internal class AnalyticsClient(
     fun trackAdViewable(
         impressionId: String,
         placementId: String,
+        slotId: String,
         format: String,
         viewableTimeMs: Long,
         percentVisible: Int
@@ -629,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()
         )
 
@@ -660,7 +672,7 @@ internal class AnalyticsClient(
             utmContent = common.utmContent ?: "",
             gclid = "",
             fbclid = "",
-            acctType = "anonymous",
+            acctType = currentAcctType,
             diiSource = "",
             gamNetworkCode = getGamNetworkCode(),
             amznPubId = NIL_UUID,
@@ -674,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
@@ -721,7 +733,7 @@ internal class AnalyticsClient(
             utmContent = common.utmContent ?: "",
             gclid = "",
             fbclid = "",
-            acctType = "anonymous",
+            acctType = currentAcctType,
             diiSource = "",
             gamNetworkCode = getGamNetworkCode(),
             amznPubId = NIL_UUID,

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.13.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,
@@ -543,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

@@ -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/BigCrunchAds.swift

@@ -249,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
 
     /**

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

@@ -38,6 +38,9 @@ internal class AnalyticsClient {
     /// Current custom dimensions (set by trackScreenView, used by all events)
     private var currentCustomDimensions: [String: String] = [:]
 
+    /// Current account type (set by setAccountType, used by all events)
+    private var currentAcctType: String = "guest"
+
     /// Batching for impressions (250ms delay)
     private var impressionBatch: [ImpressionBatchEvent] = []
     private var impressionBatchTimer: Timer?
@@ -200,7 +203,7 @@ internal class AnalyticsClient {
             utmContent: common.utmContent ?? "",
             gclid: "",
             fbclid: "",
-            acctType: "anonymous",
+            acctType: currentAcctType,
             diiSource: "",
             gamNetworkCode: gamNetworkCode,
             amznPubId: AnalyticsClient.nilUUID,  // amzn_pub_id must be valid UUID
@@ -236,6 +239,7 @@ internal class AnalyticsClient {
      */
     func createImpressionContext(
         placementId: String,
+        slotId: String,
         gamAdUnit: String,
         format: String,
         width: Int? = nil,
@@ -243,6 +247,7 @@ internal class AnalyticsClient {
     ) -> ImpressionContext {
         let context = ImpressionContext(
             placementId: placementId,
+            slotId: slotId,
             gamAdUnit: gamAdUnit,
             format: format,
             width: width,
@@ -283,6 +288,10 @@ internal class AnalyticsClient {
     /**
      * Store auction data for a placement (called by AdOrchestrator after S2S demand fetch)
      */
+    func setAccountType(_ accountType: String) {
+        currentAcctType = accountType
+    }
+
     func setAuctionData(placementId: String, auctionData: AuctionData) {
         contextLock.lock()
         placementAuctionData[placementId] = auctionData
@@ -344,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,
@@ -394,7 +403,7 @@ internal class AnalyticsClient {
             utmContent: common.utmContent ?? "",
             gclid: "",
             fbclid: "",
-            acctType: "anonymous",
+            acctType: currentAcctType,
             diiSource: "",
             gamNetworkCode: gamNetworkCode,
             amznPubId: AnalyticsClient.nilUUID,  // amzn_pub_id must be valid UUID
@@ -410,6 +419,7 @@ internal class AnalyticsClient {
      */
     func trackAdImpression(
         placementId: String,
+        slotId: String,
         format: String,
         gamAdUnit: String = "",
         adSize: String = "",
@@ -438,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,
@@ -488,7 +498,7 @@ internal class AnalyticsClient {
             utmContent: common.utmContent ?? "",
             gclid: "",
             fbclid: "",
-            acctType: "anonymous",
+            acctType: currentAcctType,
             diiSource: "",
             gamNetworkCode: gamNetworkCode,
             amznPubId: AnalyticsClient.nilUUID,  // amzn_pub_id must be valid UUID
@@ -509,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()
 
@@ -523,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: "",
@@ -565,7 +575,7 @@ internal class AnalyticsClient {
             utmContent: common.utmContent ?? "",
             gclid: "",
             fbclid: "",
-            acctType: "anonymous",
+            acctType: currentAcctType,
             diiSource: "",
             gamNetworkCode: gamNetworkCode,
             amznPubId: AnalyticsClient.nilUUID,
@@ -579,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
@@ -598,6 +608,7 @@ internal class AnalyticsClient {
     func trackAdViewable(
         impressionId: String,
         placementId: String,
+        slotId: String,
         format: String,
         viewableTimeMs: Int64,
         percentVisible: Int
@@ -613,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: "",
@@ -655,7 +666,7 @@ internal class AnalyticsClient {
             utmContent: common.utmContent ?? "",
             gclid: "",
             fbclid: "",
-            acctType: "anonymous",
+            acctType: currentAcctType,
             diiSource: "",
             gamNetworkCode: gamNetworkCode,
             amznPubId: AnalyticsClient.nilUUID,
@@ -668,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()
 
@@ -680,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: "",
@@ -722,7 +733,7 @@ internal class AnalyticsClient {
             utmContent: common.utmContent ?? "",
             gclid: "",
             fbclid: "",
-            acctType: "anonymous",
+            acctType: currentAcctType,
             diiSource: "",
             gamNetworkCode: gamNetworkCode,
             amznPubId: AnalyticsClient.nilUUID,
@@ -778,7 +789,7 @@ internal class AnalyticsClient {
             utmContent: common.utmContent ?? "",
             gclid: "",
             fbclid: "",
-            acctType: "anonymous",
+            acctType: currentAcctType,
             diiSource: "",
             gamNetworkCode: gamNetworkCode,
             amznPubId: AnalyticsClient.nilUUID,

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.13.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/ios/BigCrunchAdsModule.m

@@ -89,6 +89,11 @@ RCT_EXTERN_METHOD(setCoppaCompliant:(BOOL)compliant
                   resolver:(RCTPromiseResolveBlock)resolve
                   rejecter:(RCTPromiseRejectBlock)reject)
 
+// Account Type
+RCT_EXTERN_METHOD(setAccountType:(NSString *)accountType
+                  resolver:(RCTPromiseResolveBlock)resolve
+                  rejecter:(RCTPromiseRejectBlock)reject)
+
 // Debug Settings
 RCT_EXTERN_METHOD(setDebugMode:(BOOL)enabled
                   resolver:(RCTPromiseResolveBlock)resolve

package/ios/BigCrunchAdsModule.swift

@@ -616,6 +616,16 @@ class BigCrunchAdsModule: RCTEventEmitter {
         resolver(nil)
     }
 
+    // MARK: - Account Type
+
+    @objc(setAccountType:resolver:rejecter:)
+    func setAccountType(accountType: String,
+                       resolver: RCTPromiseResolveBlock,
+                       rejecter: RCTPromiseRejectBlock) {
+        BigCrunchAds.setAccountType(accountType)
+        resolver(nil)
+    }
+
     // MARK: - Debug & Testing
 
     @objc(setDebugMode:resolver:rejecter:)

package/lib/BigCrunchAds.d.ts

@@ -2,7 +2,7 @@
  * BigCrunch Mobile Ads SDK for React Native
  * Main API class
  */
-import type { InitializationOptions, Environment, SessionInfo, DeviceContext, AppConfig, EventSubscription, ScreenViewOptions } from './types';
+import type { InitializationOptions, Environment, AccountType, SessionInfo, DeviceContext, AppConfig, EventSubscription, ScreenViewOptions } from './types';
 /**
  * Main entry point for BigCrunch Mobile Ads SDK
  */
@@ -97,6 +97,20 @@ export declare class BigCrunchAds {
      * @param isCompliant - Whether the app is COPPA compliant
      */
     static setCoppaCompliant(isCompliant: boolean): Promise<void>;
+    /**
+     * Set the account type for the current user
+     *
+     * This value is included in all analytics events (pageviews, impressions, revenue, etc.)
+     * and persists until changed. Defaults to 'guest' if not set.
+     *
+     * @param accountType - The user's account type
+     *
+     * @example
+     * ```typescript
+     * BigCrunchAds.setAccountType('subscriber');
+     * ```
+     */
+    static setAccountType(accountType: AccountType): Promise<void>;
     /**
      * Enable or disable debug mode
      *

package/lib/BigCrunchAds.d.ts.map

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

package/lib/BigCrunchAds.js

@@ -146,6 +146,22 @@ export class BigCrunchAds {
     static async setCoppaCompliant(isCompliant) {
         return NativeBigCrunchAds.setCoppaCompliant(isCompliant);
     }
+    /**
+     * Set the account type for the current user
+     *
+     * This value is included in all analytics events (pageviews, impressions, revenue, etc.)
+     * and persists until changed. Defaults to 'guest' if not set.
+     *
+     * @param accountType - The user's account type
+     *
+     * @example
+     * ```typescript
+     * BigCrunchAds.setAccountType('subscriber');
+     * ```
+     */
+    static async setAccountType(accountType) {
+        return NativeBigCrunchAds.setAccountType(accountType);
+    }
     /**
      * Enable or disable debug mode
      *

package/lib/NativeBigCrunchAds.d.ts

@@ -24,6 +24,7 @@ export interface NativeBigCrunchAdsModule {
     setGdprConsent(consent: string): Promise<void>;
     setCcpaString(ccpaString: string): Promise<void>;
     setCoppaCompliant(isCompliant: boolean): Promise<void>;
+    setAccountType(accountType: string): Promise<void>;
     setDebugMode(enabled: boolean): Promise<void>;
     addTestDevice(deviceId: string): Promise<void>;
     removeTestDevice(deviceId: string): Promise<void>;

package/lib/NativeBigCrunchAds.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"NativeBigCrunchAds.d.ts","sourceRoot":"","sources":["../src/NativeBigCrunchAds.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAiB,kBAAkB,EAAY,MAAM,cAAc,CAAC;AAC3E,OAAO,KAAK,EAAE,qBAAqB,EAAE,gBAAgB,EAAE,WAAW,EAAE,aAAa,EAAE,SAAS,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAC;AAGjI,MAAM,WAAW,wBAAwB;IAEvC,UAAU,CAAC,OAAO,EAAE,qBAAqB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1D,aAAa,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC;IAGlC,YAAY,IAAI,OAAO,CAAC,SAAS,GAAG,IAAI,CAAC,CAAC;IAC1C,aAAa,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAG/B,eAAe,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAGhF,gBAAgB,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC3D,gBAAgB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACrD,oBAAoB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAC5D,mBAAmB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAGxD,YAAY,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACvD,YAAY,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACjD,gBAAgB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IACxD,eAAe,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAGpD,cAAc,IAAI,OAAO,CAAC,WAAW,CAAC,CAAC;IACvC,eAAe,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAGjC,gBAAgB,IAAI,OAAO,CAAC,aAAa,CAAC,CAAC;IAG3C,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC/C,aAAa,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACjD,iBAAiB,CAAC,WAAW,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAGvD,YAAY,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC9C,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC/C,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAClD,cAAc,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IAGpC,gBAAgB,CAAC,MAAM,EAAE;QACvB,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,OAAO,CAAC,EAAE,MAAM,CAAC;KAClB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAClB,kBAAkB,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACrC;AAgBD,eAAO,MAAM,kBAAkB,EAAyB,wBAAwB,CAAC;AAGjF,eAAO,MAAM,wBAAwB,oBAA6C,CAAC;AAGnF,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAqCnB,CAAC"}
+{"version":3,"file":"NativeBigCrunchAds.d.ts","sourceRoot":"","sources":["../src/NativeBigCrunchAds.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAiB,kBAAkB,EAAY,MAAM,cAAc,CAAC;AAC3E,OAAO,KAAK,EAAE,qBAAqB,EAAE,gBAAgB,EAAE,WAAW,EAAE,aAAa,EAAE,SAAS,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAC;AAGjI,MAAM,WAAW,wBAAwB;IAEvC,UAAU,CAAC,OAAO,EAAE,qBAAqB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1D,aAAa,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC;IAGlC,YAAY,IAAI,OAAO,CAAC,SAAS,GAAG,IAAI,CAAC,CAAC;IAC1C,aAAa,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAG/B,eAAe,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAGhF,gBAAgB,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC3D,gBAAgB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACrD,oBAAoB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAC5D,mBAAmB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAGxD,YAAY,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACvD,YAAY,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACjD,gBAAgB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IACxD,eAAe,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAGpD,cAAc,IAAI,OAAO,CAAC,WAAW,CAAC,CAAC;IACvC,eAAe,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAGjC,gBAAgB,IAAI,OAAO,CAAC,aAAa,CAAC,CAAC;IAG3C,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC/C,aAAa,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACjD,iBAAiB,CAAC,WAAW,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAGvD,cAAc,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAGnD,YAAY,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC9C,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC/C,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAClD,cAAc,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IAGpC,gBAAgB,CAAC,MAAM,EAAE;QACvB,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,OAAO,CAAC,EAAE,MAAM,CAAC;KAClB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAClB,kBAAkB,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACrC;AAgBD,eAAO,MAAM,kBAAkB,EAAyB,wBAAwB,CAAC;AAGjF,eAAO,MAAM,wBAAwB,oBAA6C,CAAC;AAGnF,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAqCnB,CAAC"}

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":"AAAA;;GAEG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAEnC;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB,kBAAkB;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,oBAAoB;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,gCAAgC;IAChC,GAAG,CAAC,EAAE,SAAS,CAAC;IAChB,iEAAiE;IACjE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;IACtC,oCAAoC;IACpC,UAAU,EAAE,eAAe,EAAE,CAAC;IAC9B,sBAAsB;IACtB,QAAQ,CAAC,EAAE,cAAc,CAAC;IAC1B,6BAA6B;IAC7B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,qBAAqB;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,kDAAkD;IAClD,EAAE,EAAE,MAAM,CAAC;IACX,4CAA4C;IAC5C,WAAW,EAAE,MAAM,CAAC;IACpB,mCAAmC;IACnC,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,qBAAqB;IACrB,MAAM,EAAE,QAAQ,CAAC;IACjB,mCAAmC;IACnC,SAAS,EAAE,MAAM,CAAC;IAClB,4BAA4B;IAC5B,IAAI,CAAC,EAAE,YAAY,CAAC;IACpB,+BAA+B;IAC/B,YAAY,CAAC,EAAE,YAAY,CAAC;IAC5B,kCAAkC;IAClC,QAAQ,CAAC,EAAE,iBAAiB,CAAC;IAC7B,kCAAkC;IAClC,OAAO,EAAE,OAAO,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,yBAAyB;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,0BAA0B;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,qCAAqC;IACrC,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB,6BAA6B;IAC7B,OAAO,EAAE,OAAO,CAAC;IACjB,6BAA6B;IAC7B,SAAS,EAAE,MAAM,CAAC;IAClB,+CAA+C;IAC/C,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;;;;GAKG;AACH,MAAM,WAAW,WAAW;IAC1B,qCAAqC;IACrC,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAC7B,2DAA2D;IAC3D,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,CAAC;CAClD;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,qBAAqB;IACrB,MAAM,EAAE,MAAM,CAAC;IACf,gCAAgC;IAChC,OAAO,EAAE,OAAO,CAAC;IACjB,kCAAkC;IAClC,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,uBAAuB;IACvB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,sBAAsB;IACtB,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;IACzB,6BAA6B;IAC7B,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,iCAAiC;IACjC,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,2BAA2B;IAC3B,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,0CAA0C;IAC1C,sBAAsB,CAAC,EAAE,MAAM,CAAC;IAChC,6BAA6B;IAC7B,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,0BAA0B;IAC1B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,6BAA6B;IAC7B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,uBAAuB;IACvB,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,iEAAiE;IACjE,OAAO,CAAC,EAAE,aAAa,CAAC;CACzB;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,iCAAiC;IACjC,OAAO,EAAE,OAAO,CAAC;IACjB,uCAAuC;IACvC,UAAU,EAAE,MAAM,CAAC;IACnB,kCAAkC;IAClC,YAAY,EAAE,MAAM,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,sDAAsD;IACtD,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,4BAA4B;IAC5B,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,kCAAkC;IAClC,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B,uCAAuC;IACvC,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,0CAA0C;IAC1C,eAAe,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC1C"}

package/lib/types/index.d.ts

@@ -9,6 +9,10 @@ export * from './ads';
  * SDK Environment options
  */
 export type Environment = 'production' | 'sandbox';
+/**
+ * Account type for the current user
+ */
+export type AccountType = 'guest' | 'logged_in' | 'paid' | 'subscriber' | 'free';
 /**
  * Ad formats supported by the SDK
  */

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

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bigcrunch/react-native-ads",
-  "version": "0.13.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",
@@ -92,4 +92,4 @@
       "optional": false
     }
   }
-}
+}

package/src/BigCrunchAds.ts

@@ -11,6 +11,7 @@ import {
 import type {
   InitializationOptions,
   Environment,
+  AccountType,
   SessionInfo,
   DeviceContext,
   AppConfig,
@@ -183,6 +184,23 @@ export class BigCrunchAds {
     return NativeBigCrunchAds.setCoppaCompliant(isCompliant);
   }
 
+  /**
+   * Set the account type for the current user
+   *
+   * This value is included in all analytics events (pageviews, impressions, revenue, etc.)
+   * and persists until changed. Defaults to 'guest' if not set.
+   *
+   * @param accountType - The user's account type
+   *
+   * @example
+   * ```typescript
+   * BigCrunchAds.setAccountType('subscriber');
+   * ```
+   */
+  static async setAccountType(accountType: AccountType): Promise<void> {
+    return NativeBigCrunchAds.setAccountType(accountType);
+  }
+
   /**
    * Enable or disable debug mode
    *

package/src/NativeBigCrunchAds.ts

@@ -43,6 +43,9 @@ export interface NativeBigCrunchAdsModule {
   setCcpaString(ccpaString: string): Promise<void>;
   setCoppaCompliant(isCompliant: boolean): Promise<void>;
 
+  // Account type
+  setAccountType(accountType: string): Promise<void>;
+
   // Debug
   setDebugMode(enabled: boolean): Promise<void>;
   addTestDevice(deviceId: string): Promise<void>;

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;

package/src/types/index.ts

@@ -12,6 +12,11 @@ export * from './ads';
  */
 export type Environment = 'production' | 'sandbox';
 
+/**
+ * Account type for the current user
+ */
+export type AccountType = 'guest' | 'logged_in' | 'paid' | 'subscriber' | 'free';
+
 /**
  * Ad formats supported by the SDK
  */