@sellwild/react-native-sdk 1.5.0 → 1.7.0

package/android/src/main/java/com/sellwild/rnsdk/RnPrebidServer.kt

@@ -0,0 +1,36 @@
+package com.sellwild.rnsdk
+
+import com.facebook.react.bridge.ReadableMap
+import com.sellwild.sdk.PrebidServerConfig
+
+/**
+ * Marshals a bridged JS `prebidServer` object (React `ReadableMap`) into the
+ * native [PrebidServerConfig]. Lives in the RN module because `ReadableMap` is a
+ * React type. Mirrors the iOS bridge (`configFromMap`) so an RN partner's custom
+ * Prebid Server (accountId / endpoint / bidders / timeout) routes to the same
+ * auction endpoint on both platforms. Returns null when `accountId`/`endpoint`
+ * are absent, so `bootstrap()` falls back to `S2S_CONFIG` / the hosted default.
+ */
+internal object RnPrebidServer {
+    fun fromMap(map: ReadableMap?): PrebidServerConfig? {
+        if (map == null) return null
+        fun str(k: String) = if (map.hasKey(k) && !map.isNull(k)) map.getString(k) else null
+        val accountId = str("accountId") ?: return null
+        val endpoint = str("endpoint") ?: return null
+        val bidders = if (map.hasKey("bidders") && !map.isNull("bidders")) {
+            map.getArray("bidders")?.let { arr ->
+                (0 until arr.size()).mapNotNull { arr.getString(it) }
+            } ?: emptyList()
+        } else {
+            emptyList()
+        }
+        val timeout = if (map.hasKey("timeout") && !map.isNull("timeout")) map.getInt("timeout") else 1500
+        return PrebidServerConfig(
+            accountId = accountId,
+            endpoint = endpoint,
+            bidders = bidders,
+            timeout = timeout,
+            syncEndpoint = str("syncEndpoint"),
+        )
+    }
+}

package/android/src/main/java/com/sellwild/rnsdk/SellwildBannerViewManager.kt

@@ -11,6 +11,8 @@ import com.sellwild.sdk.AdSize
 import com.sellwild.sdk.SellwildAdStack
 import com.sellwild.sdk.SellwildAdView
 import com.sellwild.sdk.SellwildConfig
+import com.sellwild.sdk.SellwildGrowthCodeConfig
+import com.sellwild.sdk.SellwildLocalizedListingsConfig
 import org.json.JSONObject
 
 /**
@@ -77,6 +79,13 @@ class SellwildBannerViewManager : SimpleViewManager<SellwildAdView>() {
                 emit(reactContext, adView, "onAdImpression", payload)
             }
 
+            override fun onHouseAdImpression(adView: SellwildAdView, zoneId: String) {
+                val payload = com.facebook.react.bridge.Arguments.createMap().apply {
+                    putString("zoneId", zoneId)
+                }
+                emit(reactContext, adView, "onHouseAdImpression", payload)
+            }
+
             override fun onAdClicked(adView: SellwildAdView) {
                 emit(reactContext, adView, "onAdClicked", null)
             }
@@ -154,6 +163,7 @@ class SellwildBannerViewManager : SimpleViewManager<SellwildAdView>() {
         return MapBuilder.builder<String, Any>()
             .put("onAdLoaded", MapBuilder.of("registrationName", "onAdLoaded"))
             .put("onAdImpression", MapBuilder.of("registrationName", "onAdImpression"))
+            .put("onHouseAdImpression", MapBuilder.of("registrationName", "onHouseAdImpression"))
             .put("onAdClicked", MapBuilder.of("registrationName", "onAdClicked"))
             .put("onAdFailed", MapBuilder.of("registrationName", "onAdFailed"))
             .put("onAdResize", MapBuilder.of("registrationName", "onAdResize"))
@@ -209,6 +219,46 @@ class SellwildBannerViewManager : SimpleViewManager<SellwildAdView>() {
                 null
             }
 
+            val growthCode = if (map.hasKey("growthCode") && !map.isNull("growthCode")) {
+                val gc = map.getMap("growthCode")!!
+                fun bool(k: String): Boolean? = if (gc.hasKey(k) && !gc.isNull(k)) gc.getBoolean(k) else null
+                fun str(k: String): String? = if (gc.hasKey(k) && !gc.isNull(k)) gc.getString(k) else null
+                fun int(k: String): Int? = if (gc.hasKey(k) && !gc.isNull(k)) gc.getInt(k) else null
+                SellwildGrowthCodeConfig(
+                    enabled = bool("enabled"),
+                    partnerId = str("partnerId"),
+                    endpoint = str("endpoint"),
+                    syncUrl = str("syncUrl"),
+                    sendMaid = bool("sendMaid"),
+                    ttlHours = int("ttlHours"),
+                )
+            } else {
+                null
+            }
+
+            val localizedListings = if (map.hasKey("localizedListings") && !map.isNull("localizedListings")) {
+                val ll = map.getMap("localizedListings")!!
+                fun bool(k: String): Boolean? = if (ll.hasKey(k) && !ll.isNull(k)) ll.getBoolean(k) else null
+                fun str(k: String): String? = if (ll.hasKey(k) && !ll.isNull(k)) ll.getString(k) else null
+                fun int(k: String): Int? = if (ll.hasKey(k) && !ll.isNull(k)) ll.getInt(k) else null
+                SellwildLocalizedListingsConfig(
+                    enabled = bool("enabled"),
+                    source = str("source"),
+                    baseUrl = str("baseUrl"),
+                    urlTemplate = str("urlTemplate"),
+                    frequency = int("frequency"),
+                    forceState = str("forceState"),
+                )
+            } else {
+                null
+            }
+
+            // Custom Prebid Server (S2S) config — mirror the iOS bridge so the
+            // same RN app auctions against the partner's PBS on both platforms.
+            val prebidServer = RnPrebidServer.fromMap(
+                if (map.hasKey("prebidServer") && !map.isNull("prebidServer")) map.getMap("prebidServer") else null
+            )
+
             return SellwildConfig(
                 partnerCode = partnerCode ?: "",
                 appBundleId = appBundleId,
@@ -221,6 +271,9 @@ class SellwildBannerViewManager : SimpleViewManager<SellwildAdView>() {
                 adRefreshMaxMobile = adRefreshMaxMobile,
                 adRefreshIntervalMs = adRefreshIntervalMs,
                 remoteJson = remoteJson,
+                growthCode = growthCode,
+                localizedListings = localizedListings,
+                prebidServer = prebidServer,
             )
         }
     }

package/android/src/main/java/com/sellwild/rnsdk/SellwildFeedViewManager.kt

@@ -12,6 +12,7 @@ import com.facebook.react.uimanager.events.RCTEventEmitter
 import com.sellwild.sdk.SellwildConfig
 import com.sellwild.sdk.SellwildFeedView
 import com.sellwild.sdk.SellwildListing
+import com.sellwild.sdk.SellwildLocalizedListingsConfig
 import com.sellwild.sdk.SellwildSDK
 import org.json.JSONObject
 
@@ -67,6 +68,11 @@ class SellwildFeedViewManager : SimpleViewManager<SellwildFeedView>() {
                 emit(reactContext, view, "onAdImpression", payload)
             }
 
+            override fun onHouseAdImpression(zoneId: String) {
+                val payload = Arguments.createMap().apply { putString("zoneId", zoneId) }
+                emit(reactContext, view, "onHouseAdImpression", payload)
+            }
+
             override fun onAdClicked(zoneId: String) {
                 val payload = Arguments.createMap().apply { putString("zoneId", zoneId) }
                 emit(reactContext, view, "onAdClicked", payload)
@@ -80,6 +86,11 @@ class SellwildFeedViewManager : SimpleViewManager<SellwildFeedView>() {
                 val payload = Arguments.createMap().apply { putString("message", message) }
                 emit(reactContext, view, "onFeedError", payload)
             }
+
+            override fun onContentHeightChanged(feedView: SellwildFeedView, heightDp: Int) {
+                val payload = Arguments.createMap().apply { putInt("height", heightDp) }
+                emit(reactContext, view, "onContentSizeChange", payload)
+            }
         }
         return view
     }
@@ -89,6 +100,11 @@ class SellwildFeedViewManager : SimpleViewManager<SellwildFeedView>() {
         pendingFor(view).config = value
     }
 
+    @ReactProp(name = "scrollEnabled", defaultBoolean = true)
+    fun setScrollEnabled(view: SellwildFeedView, value: Boolean) {
+        view.scrollEnabled = value
+    }
+
     override fun onAfterUpdateTransaction(view: SellwildFeedView) {
         super.onAfterUpdateTransaction(view)
 
@@ -117,8 +133,10 @@ class SellwildFeedViewManager : SimpleViewManager<SellwildFeedView>() {
             .put("onFeedLoaded", MapBuilder.of("registrationName", "onFeedLoaded"))
             .put("onListingTap", MapBuilder.of("registrationName", "onListingTap"))
             .put("onAdImpression", MapBuilder.of("registrationName", "onAdImpression"))
+            .put("onHouseAdImpression", MapBuilder.of("registrationName", "onHouseAdImpression"))
             .put("onAdClicked", MapBuilder.of("registrationName", "onAdClicked"))
             .put("onFeedError", MapBuilder.of("registrationName", "onFeedError"))
+            .put("onContentSizeChange", MapBuilder.of("registrationName", "onContentSizeChange"))
             .build()
     }
 
@@ -167,6 +185,29 @@ class SellwildFeedViewManager : SimpleViewManager<SellwildFeedView>() {
             if (map.hasKey("adRefreshMax")) config = config.copy(adRefreshMax = map.getInt("adRefreshMax"))
             if (map.hasKey("adRefreshMaxMobile")) config = config.copy(adRefreshMaxMobile = map.getInt("adRefreshMaxMobile"))
             if (map.hasKey("adRefreshIntervalMs")) config = config.copy(adRefreshIntervalMs = map.getDouble("adRefreshIntervalMs").toLong())
+            // Custom Prebid Server (S2S) config — mirror the iOS feed bridge.
+            if (map.hasKey("prebidServer") && !map.isNull("prebidServer")) {
+                config = config.copy(prebidServer = RnPrebidServer.fromMap(map.getMap("prebidServer")))
+            }
+
+            // Local override for the localized (geo-based) secondary-listings
+            // integration; the remote LOCALIZED_LISTINGS object rides `remote`.
+            if (map.hasKey("localizedListings") && !map.isNull("localizedListings")) {
+                val ll = map.getMap("localizedListings")!!
+                fun bool(k: String): Boolean? = if (ll.hasKey(k) && !ll.isNull(k)) ll.getBoolean(k) else null
+                fun str(k: String): String? = if (ll.hasKey(k) && !ll.isNull(k)) ll.getString(k) else null
+                fun int(k: String): Int? = if (ll.hasKey(k) && !ll.isNull(k)) ll.getInt(k) else null
+                config = config.copy(
+                    localizedListings = SellwildLocalizedListingsConfig(
+                        enabled = bool("enabled"),
+                        source = str("source"),
+                        baseUrl = str("baseUrl"),
+                        urlTemplate = str("urlTemplate"),
+                        frequency = int("frequency"),
+                        forceState = str("forceState"),
+                    ),
+                )
+            }
 
             return config
         }

package/ios/SellwildBannerViewManager.m

@@ -19,6 +19,7 @@ RCT_EXPORT_VIEW_PROPERTY(adStack, NSString)
 // Direct events emitted to JS callbacks.
 RCT_EXPORT_VIEW_PROPERTY(onAdLoaded, RCTDirectEventBlock)
 RCT_EXPORT_VIEW_PROPERTY(onAdImpression, RCTDirectEventBlock)
+RCT_EXPORT_VIEW_PROPERTY(onHouseAdImpression, RCTDirectEventBlock)
 RCT_EXPORT_VIEW_PROPERTY(onAdClicked, RCTDirectEventBlock)
 RCT_EXPORT_VIEW_PROPERTY(onAdFailed, RCTDirectEventBlock)
 RCT_EXPORT_VIEW_PROPERTY(onAdResize, RCTDirectEventBlock)

package/ios/SellwildBannerViewManager.swift

@@ -47,6 +47,8 @@ final class SellwildBannerHostView: UIView, SellwildAdViewDelegate {
 
     @objc var onAdLoaded: RCTDirectEventBlock?
     @objc var onAdImpression: RCTDirectEventBlock?
+    /// A house ad backfilled an empty slot (no-fill). Not a paid impression.
+    @objc var onHouseAdImpression: RCTDirectEventBlock?
     @objc var onAdClicked: RCTDirectEventBlock?
     @objc var onAdFailed: RCTDirectEventBlock?
     /// Emitted with the rendered creative size so JS can resize the slot.
@@ -124,6 +126,10 @@ final class SellwildBannerHostView: UIView, SellwildAdViewDelegate {
         onAdImpression?(["zoneId": zoneId])
     }
 
+    func sellwildAdView(_ adView: SellwildAdView, didRecordHouseImpressionForZoneId zoneId: String) {
+        onHouseAdImpression?(["zoneId": zoneId])
+    }
+
     func sellwildAdViewDidRecordClick(_ adView: SellwildAdView) {
         onAdClicked?([:])
     }
@@ -175,6 +181,28 @@ final class SellwildBannerHostView: UIView, SellwildAdViewDelegate {
             )
         }
 
+        if let gc = map["growthCode"] as? NSDictionary {
+            cfg.growthCode = SellwildGrowthCodeConfig(
+                enabled: gc["enabled"] as? Bool,
+                partnerId: gc["partnerId"] as? String,
+                endpoint: gc["endpoint"] as? String,
+                syncUrl: gc["syncUrl"] as? String,
+                sendMaid: gc["sendMaid"] as? Bool,
+                ttlHours: gc["ttlHours"] as? Int
+            )
+        }
+
+        if let ll = map["localizedListings"] as? NSDictionary {
+            cfg.localizedListings = SellwildLocalizedListingsConfig(
+                enabled: ll["enabled"] as? Bool,
+                source: ll["source"] as? String,
+                baseUrl: ll["baseUrl"] as? String,
+                urlTemplate: ll["urlTemplate"] as? String,
+                frequency: ll["frequency"] as? Int,
+                forceState: ll["forceState"] as? String
+            )
+        }
+
         if let remote = map["remote"] as? NSDictionary,
            let data = try? JSONSerialization.data(withJSONObject: remote, options: []) {
             cfg.remoteJSON = data

package/ios/SellwildFeedViewManager.m

@@ -12,12 +12,15 @@
 // Props set from JS — these forward to @objc properties on
 // SellwildFeedHostView.
 RCT_EXPORT_VIEW_PROPERTY(config, NSDictionary)
+RCT_EXPORT_VIEW_PROPERTY(scrollEnabled, BOOL)
 
 // Direct events emitted to JS callbacks.
 RCT_EXPORT_VIEW_PROPERTY(onFeedLoaded, RCTDirectEventBlock)
 RCT_EXPORT_VIEW_PROPERTY(onListingTap, RCTDirectEventBlock)
 RCT_EXPORT_VIEW_PROPERTY(onAdImpression, RCTDirectEventBlock)
+RCT_EXPORT_VIEW_PROPERTY(onHouseAdImpression, RCTDirectEventBlock)
 RCT_EXPORT_VIEW_PROPERTY(onAdClicked, RCTDirectEventBlock)
 RCT_EXPORT_VIEW_PROPERTY(onFeedError, RCTDirectEventBlock)
+RCT_EXPORT_VIEW_PROPERTY(onContentSizeChange, RCTDirectEventBlock)
 
 @end

package/ios/SellwildFeedViewManager.swift

@@ -38,14 +38,22 @@ final class SellwildFeedHostView: UIView, SellwildFeedViewDelegate {
     // MARK: RN-set props
 
     @objc var config: NSDictionary? { didSet { needsApply = true } }
+    /// Disable the feed's internal scrolling so it can be embedded inside a
+    /// parent scroll view. Applied live and on feed creation.
+    @objc var scrollEnabled: Bool = true { didSet { feedView?.scrollEnabled = scrollEnabled } }
 
     // MARK: RN events
 
     @objc var onFeedLoaded: RCTDirectEventBlock?
     @objc var onListingTap: RCTDirectEventBlock?
     @objc var onAdImpression: RCTDirectEventBlock?
+    /// A house ad backfilled an empty feed slot (no-fill). Not a paid impression.
+    @objc var onHouseAdImpression: RCTDirectEventBlock?
     @objc var onAdClicked: RCTDirectEventBlock?
     @objc var onFeedError: RCTDirectEventBlock?
+    /// Emitted whenever the feed's content height changes so JS can size the
+    /// host container when embedding with `scrollEnabled={false}`.
+    @objc var onContentSizeChange: RCTDirectEventBlock?
 
     // MARK: Internals
 
@@ -83,6 +91,7 @@ final class SellwildFeedHostView: UIView, SellwildFeedViewDelegate {
 
         let view = SellwildFeedView(config: sellwildConfig)
         view.delegate = self
+        view.scrollEnabled = scrollEnabled
         view.translatesAutoresizingMaskIntoConstraints = false
         addSubview(view)
         NSLayoutConstraint.activate([
@@ -118,6 +127,10 @@ final class SellwildFeedHostView: UIView, SellwildFeedViewDelegate {
         onAdImpression?(["zoneId": zoneId])
     }
 
+    func sellwildFeed(_ feed: SellwildFeedView, didRecordHouseAdImpressionForZoneId zoneId: String) {
+        onHouseAdImpression?(["zoneId": zoneId])
+    }
+
     func sellwildFeed(_ feed: SellwildFeedView, didRecordAdClickForZoneId zoneId: String) {
         onAdClicked?(["zoneId": zoneId])
     }
@@ -126,6 +139,10 @@ final class SellwildFeedHostView: UIView, SellwildFeedViewDelegate {
         onFeedError?(["message": message])
     }
 
+    func sellwildFeed(_ feed: SellwildFeedView, didChangeContentHeight height: CGFloat) {
+        onContentSizeChange?(["height": height])
+    }
+
     // MARK: Config marshalling
 
     /// Build a full SellwildConfig from a JS dictionary. The JS side
@@ -159,8 +176,17 @@ final class SellwildFeedHostView: UIView, SellwildFeedViewDelegate {
         if let v = map["priceColor"] as? String { cfg.priceColor = v }
         if let v = map["bannerZid"] as? String { cfg.bannerZid = v }
         if let v = map["bottomBannerZid"] as? String { cfg.bottomBannerZid = v }
-        if let v = map["mobileBannerZid"] as? String { cfg.mobileBannerZid = v }
-        if let v = map["mobileZids"] as? [String] { cfg.mobileZids = v }
+
+        // mobileZids / mobileBannerZid are resolved per-platform (iOS here) by
+        // SellwildSDK.apply(_:to:) above, which reads the OS-suffixed CDN keys
+        // (MOBILE_ZID_IOS / MOBILE_BANNER_ZID_IOS) out of `remote`. Only fall
+        // back to the flat JS-passed values when there was no `remote` payload
+        // to resolve from — otherwise the iOS-resolved zones would be clobbered
+        // by the unsuffixed values the JS core mapped (which are OS-agnostic).
+        if map["remote"] == nil {
+            if let v = map["mobileBannerZid"] as? String { cfg.mobileBannerZid = v }
+            if let v = map["mobileZids"] as? [String] { cfg.mobileZids = v }
+        }
 
         // JS bridge passes ms; iOS API is seconds (TimeInterval).
         if let v = map["adRefreshIntervalMs"] as? NSNumber {
@@ -181,6 +207,19 @@ final class SellwildFeedHostView: UIView, SellwildFeedViewDelegate {
             )
         }
 
+        // Local override for the localized (geo-based) secondary-listings
+        // integration; remote LOCALIZED_LISTINGS rides `remote` verbatim.
+        if let ll = map["localizedListings"] as? NSDictionary {
+            cfg.localizedListings = SellwildLocalizedListingsConfig(
+                enabled: ll["enabled"] as? Bool,
+                source: ll["source"] as? String,
+                baseUrl: ll["baseUrl"] as? String,
+                urlTemplate: ll["urlTemplate"] as? String,
+                frequency: ll["frequency"] as? Int,
+                forceState: ll["forceState"] as? String
+            )
+        }
+
         return cfg
     }
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sellwild/react-native-sdk",
-  "version": "1.5.0",
+  "version": "1.7.0",
   "description": "Sellwild mobile advertising SDK for React Native",
   "main": "src/index.ts",
   "types": "src/index.ts",

package/src/SellwildBanner.tsx

@@ -62,6 +62,7 @@ interface NativeBannerProps {
   style?: ViewStyle
   onAdLoaded?: (e: NativeSyntheticEvent<{}>) => void
   onAdImpression?: (e: NativeSyntheticEvent<{ zoneId: string }>) => void
+  onHouseAdImpression?: (e: NativeSyntheticEvent<{ zoneId: string }>) => void
   onAdClicked?: (e: NativeSyntheticEvent<{}>) => void
   onAdFailed?: (e: NativeSyntheticEvent<{ message: string }>) => void
   onAdResize?: (e: NativeSyntheticEvent<{ width: number; height: number }>) => void
@@ -86,6 +87,11 @@ export interface SellwildBannerProps {
   zoneId: number | string
   style?: ViewStyle
   onImpression?: () => void
+  /**
+   * Fired when a house ad backfilled an empty slot (a no-fill). NOT a paid
+   * impression — track it separately. See the `MOBILE_HOUSE_AD_*` config keys.
+   */
+  onHouseImpression?: (zoneId: string) => void
   onClick?: () => void
   onError?: (error: Error) => void
 }
@@ -96,6 +102,7 @@ export function SellwildBanner({
   zoneId,
   style,
   onImpression,
+  onHouseImpression,
   onClick,
   onError,
 }: SellwildBannerProps) {
@@ -167,6 +174,10 @@ export function SellwildBanner({
     adRefreshMaxMobile: config.adRefreshMaxMobile,
     adRefreshIntervalMs: config.adRefreshInterval,
     prebidServer: config.prebidServer,
+    // Local GrowthCode overrides (remote GROWTHCODE_* keys ride `remote`).
+    growthCode: config.growthCode,
+    // Local localized-listings overrides (remote LOCALIZED_LISTINGS rides `remote`).
+    localizedListings: config.localizedListings,
     remote: config.remote,
   }
 
@@ -181,6 +192,7 @@ export function SellwildBanner({
         // No-op event hook today; surfaced for future fill metrics.
       }}
       onAdImpression={() => onImpression?.()}
+      onHouseAdImpression={(e: NativeSyntheticEvent<{ zoneId: string }>) => onHouseImpression?.(e.nativeEvent?.zoneId)}
       onAdClicked={() => onClick?.()}
       onAdFailed={(e: NativeSyntheticEvent<{ message: string }>) => {
         const msg = e.nativeEvent?.message ?? 'Ad failed'

package/src/SellwildFeed.tsx

@@ -29,12 +29,15 @@ const NATIVE_NAME = 'SellwildFeedView'
 
 interface NativeFeedProps {
   config: object
+  scrollEnabled?: boolean
   style?: StyleProp<ViewStyle>
   onFeedLoaded?: (e: NativeSyntheticEvent<{}>) => void
   onListingTap?: (e: NativeSyntheticEvent<{ listing: SellwildListing }>) => void
   onAdImpression?: (e: NativeSyntheticEvent<{ zoneId: string }>) => void
+  onHouseAdImpression?: (e: NativeSyntheticEvent<{ zoneId: string }>) => void
   onAdClicked?: (e: NativeSyntheticEvent<{ zoneId: string }>) => void
   onFeedError?: (e: NativeSyntheticEvent<{ message: string }>) => void
+  onContentSizeChange?: (e: NativeSyntheticEvent<{ width?: number; height: number }>) => void
 }
 
 const NativeFeed = (() => {
@@ -60,6 +63,24 @@ export interface SellwildFeedProps {
   /** Optional style override. The feed expands to its container by default. */
   style?: ViewStyle
 
+  /**
+   * When `false`, the feed's own scrolling is disabled and the component
+   * sizes its own container from the reported content height, so it can be
+   * embedded inside a parent `ScrollView` (single-scroll pages, e.g.
+   * alongside a Taboola feed). The feed then renders every row (no
+   * virtualization) and pull-to-refresh is disabled — the host drives
+   * refresh. Defaults to `true`; existing full-screen integrations are
+   * unaffected.
+   */
+  scrollEnabled?: boolean
+
+  /**
+   * Fired whenever the feed's content height changes. Use it to size the
+   * feed's container when embedding with `scrollEnabled={false}`; when
+   * scroll is disabled the component also applies the height itself.
+   */
+  onContentSizeChange?: (e: { width?: number; height: number }) => void
+
   /** Fired once after the initial listings fetch resolves successfully. */
   onLoad?: () => void
 
@@ -73,6 +94,12 @@ export interface SellwildFeedProps {
   /** Fired when a native ad row records an impression. */
   onAdImpression?: (zoneId: string) => void
 
+  /**
+   * Fired when a house ad backfilled an empty ad row (a no-fill). NOT a paid
+   * impression — track it separately. See the `MOBILE_HOUSE_AD_*` config keys.
+   */
+  onHouseAdImpression?: (zoneId: string) => void
+
   /** Fired when a native ad row is clicked. */
   onAdClicked?: (zoneId: string) => void
 
@@ -83,18 +110,30 @@ export interface SellwildFeedProps {
 export function SellwildFeed({
   config,
   style,
+  scrollEnabled = true,
+  onContentSizeChange,
   onLoad,
   onListingTap,
   onAdImpression,
+  onHouseAdImpression,
   onAdClicked,
   onError,
 }: SellwildFeedProps) {
+  // When embedded (scrollEnabled === false) the parent ScrollView owns
+  // scrolling, so we size our own container from the native-reported content
+  // height rather than filling with flex:1.
+  const [contentHeight, setContentHeight] = React.useState<number | null>(null)
+  const embedded = scrollEnabled === false
+  const containerStyle: StyleProp<ViewStyle> = embedded
+    ? [contentHeight != null ? { height: contentHeight } : undefined, style]
+    : [styles.fill, style]
+
   if (!NativeFeed) {
     // Native module not registered. Most common cause: the host app was
     // built before the @sellwild/react-native-sdk autolink ran, or this
     // is being rendered in a JS-only test environment.
     return (
-      <View style={[styles.fill, style, __DEV__ ? styles.devPlaceholder : undefined]}>
+      <View style={[containerStyle, __DEV__ ? styles.devPlaceholder : undefined]}>
         {__DEV__ ? (
           <Text style={styles.devText}>
             Sellwild native feed not available on {Platform.OS} (yet)
@@ -125,6 +164,8 @@ export function SellwildFeed({
     adRefreshMaxMobile: config.adRefreshMaxMobile,
     adRefreshIntervalMs: config.adRefreshInterval,
     prebidServer: config.prebidServer,
+    // Local localized-listings overrides (remote LOCALIZED_LISTINGS rides `remote`).
+    localizedListings: config.localizedListings,
     remote: config.remote,
     listingsUrl: config.listingsUrl,
     priceColor: config.priceColor,
@@ -136,8 +177,16 @@ export function SellwildFeed({
 
   return (
     <NativeFeed
-      style={[styles.fill, style]}
+      style={containerStyle}
       config={nativeConfig}
+      scrollEnabled={scrollEnabled}
+      onContentSizeChange={(e: NativeSyntheticEvent<{ width?: number; height: number }>) => {
+        const { width, height } = e.nativeEvent ?? { height: 0 }
+        // Only size our own container when embedded; a scrolling feed fills
+        // its parent via flex:1 and doesn't need a measured height.
+        if (embedded && height > 0) setContentHeight(height)
+        onContentSizeChange?.({ width, height })
+      }}
       onFeedLoaded={() => onLoad?.()}
       onListingTap={(e: NativeSyntheticEvent<{ listing: SellwildListing }>) => {
         onListingTap?.(e.nativeEvent.listing)
@@ -145,6 +194,9 @@ export function SellwildFeed({
       onAdImpression={(e: NativeSyntheticEvent<{ zoneId: string }>) => {
         onAdImpression?.(e.nativeEvent.zoneId)
       }}
+      onHouseAdImpression={(e: NativeSyntheticEvent<{ zoneId: string }>) => {
+        onHouseAdImpression?.(e.nativeEvent.zoneId)
+      }}
       onAdClicked={(e: NativeSyntheticEvent<{ zoneId: string }>) => {
         onAdClicked?.(e.nativeEvent.zoneId)
       }}