cloudx-react-native 3.11.0 → 3.11.1

package/lib/typescript/src/specs/CloudXNativeAdViewNativeComponent.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"CloudXNativeAdViewNativeComponent.d.ts","sourceRoot":"","sources":["../../../../src/specs/CloudXNativeAdViewNativeComponent.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,KAAK,MAAM,OAAO,CAAC;AACpC,OAAO,KAAK,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAC7D,OAAO,KAAK,EACR,MAAM,EACN,KAAK,EACL,kBAAkB,EAClB,WAAW,EACd,MAAM,2CAA2C,CAAC;AAInD;;;;;;;;;GASG;AACH,MAAM,MAAM,uBAAuB,GAAG,QAAQ,CAAC;IAC3C,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,gBAAgB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAChC,CAAC,CAAC;AAEH;;GAEG;AACH,MAAM,MAAM,6BAA6B,GAAG,QAAQ,CAAC;IACjD,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC3B,CAAC,CAAC;AAEH,MAAM,MAAM,yBAAyB,GAAG,QAAQ,CAAC;IAC7C,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,WAAW,CAAC;CACtB,CAAC,CAAC;AAEH;;;;;;GAMG;AACH,MAAM,WAAW,WAAY,SAAQ,SAAS;IAC1C,sCAAsC;IACtC,QAAQ,EAAE,MAAM,CAAC;IAEjB;;;;;;;;OAQG;IACH,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAE7B,6CAA6C;IAC7C,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAE1B,mCAAmC;IACnC,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAE3B,mEAAmE;IACnE,eAAe,CAAC,EAAE,aAAa,CAAC,yBAAyB,CAAC,CAAC;IAE3D,8EAA8E;IAC9E,oBAAoB,CAAC,EAAE,aAAa,CAAC,yBAAyB,CAAC,CAAC;IAEhE,2DAA2D;IAC3D,sBAAsB,CAAC,EAAE,OAAO,CAAC;IAEjC,gDAAgD;IAChD,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAE5B,4CAA4C;IAC5C,sBAAsB,CAAC,EAAE,OAAO,CAAC;IAEjC;;;OAGG;IACH,YAAY,CAAC,EAAE,OAAO,CAAC;IAEvB,gDAAgD;IAChD,eAAe,EAAE,kBAAkB,CAAC,uBAAuB,CAAC,CAAC;IAE7D,+CAA+C;IAC/C,mBAAmB,EAAE,kBAAkB,CAAC,6BAA6B,CAAC,CAAC;IAEvE,mFAAmF;IACnF,sBAAsB,EAAE,kBAAkB,CAAC,6BAA6B,CAAC,CAAC;IAE1E,qCAAqC;IACrC,gBAAgB,EAAE,kBAAkB,CAAC,uBAAuB,CAAC,CAAC;IAE9D,yCAAyC;IACzC,gBAAgB,EAAE,kBAAkB,CAAC,uBAAuB,CAAC,CAAC;IAE9D,oCAAoC;IACpC,eAAe,EAAE,kBAAkB,CAAC,uBAAuB,CAAC,CAAC;IAE7D,sCAAsC;IACtC,oBAAoB,EAAE,kBAAkB,CAAC,uBAAuB,CAAC,CAAC;CACrE;AAED,MAAM,WAAW,cAAc;IAC3B,MAAM,EAAE,CAAC,OAAO,EAAE,KAAK,CAAC,UAAU,CAAC,aAAa,CAAC,WAAW,CAAC,CAAC,KAAK,IAAI,CAAC;IACxE,SAAS,EAAE,CAAC,OAAO,EAAE,KAAK,CAAC,UAAU,CAAC,aAAa,CAAC,WAAW,CAAC,CAAC,KAAK,IAAI,CAAC;IAC3E,eAAe,EAAE,CACb,OAAO,EAAE,KAAK,CAAC,UAAU,CAAC,aAAa,CAAC,WAAW,CAAC,CAAC,EACrD,YAAY,EAAE,KAAK,EACnB,SAAS,EAAE,MAAM,KAChB,IAAI,CAAC;IACV,cAAc,EAAE,CAAC,OAAO,EAAE,KAAK,CAAC,UAAU,CAAC,aAAa,CAAC,WAAW,CAAC,CAAC,KAAK,IAAI,CAAC;CACnF;AAED,eAAO,MAAM,QAAQ,EAAE,cAErB,CAAC;AAEH;;GAEG;wBACyE,aAAa,CAAC,WAAW,CAAC;AAAtG,wBAAuG"}
+{"version":3,"file":"CloudXNativeAdViewNativeComponent.d.ts","sourceRoot":"","sources":["../../../../src/specs/CloudXNativeAdViewNativeComponent.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,KAAK,MAAM,OAAO,CAAC;AACpC,OAAO,KAAK,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAC7D,OAAO,KAAK,EACR,MAAM,EACN,KAAK,EACL,kBAAkB,EAClB,WAAW,EACd,MAAM,2CAA2C,CAAC;AAInD;;;;;;;;;GASG;AACH,MAAM,MAAM,uBAAuB,GAAG,QAAQ,CAAC;IAC3C,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,gBAAgB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAChC,CAAC,CAAC;AAEH;;GAEG;AACH,MAAM,MAAM,6BAA6B,GAAG,QAAQ,CAAC;IACjD,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC3B,CAAC,CAAC;AAEH,gEAAgE;AAChE,MAAM,MAAM,iCAAiC,GAAG,QAAQ,CAAC;IACrD,UAAU,EAAE,MAAM,CAAC;CACtB,CAAC,CAAC;AAEH,MAAM,MAAM,yBAAyB,GAAG,QAAQ,CAAC;IAC7C,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,WAAW,CAAC;CACtB,CAAC,CAAC;AAEH;;;;;;GAMG;AACH,MAAM,WAAW,WAAY,SAAQ,SAAS;IAC1C,wEAAwE;IACxE,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAEzB;;;;OAIG;IACH,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAE3B;;;;;;;;OAQG;IACH,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAE7B,6CAA6C;IAC7C,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAE1B,mCAAmC;IACnC,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAE3B,mEAAmE;IACnE,eAAe,CAAC,EAAE,aAAa,CAAC,yBAAyB,CAAC,CAAC;IAE3D,8EAA8E;IAC9E,oBAAoB,CAAC,EAAE,aAAa,CAAC,yBAAyB,CAAC,CAAC;IAEhE,2DAA2D;IAC3D,sBAAsB,CAAC,EAAE,OAAO,CAAC;IAEjC,gDAAgD;IAChD,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAE5B,4CAA4C;IAC5C,sBAAsB,CAAC,EAAE,OAAO,CAAC;IAEjC;;;OAGG;IACH,YAAY,CAAC,EAAE,OAAO,CAAC;IAEvB,gDAAgD;IAChD,eAAe,EAAE,kBAAkB,CAAC,uBAAuB,CAAC,CAAC;IAE7D,+CAA+C;IAC/C,mBAAmB,EAAE,kBAAkB,CAAC,6BAA6B,CAAC,CAAC;IAEvE,mFAAmF;IACnF,sBAAsB,EAAE,kBAAkB,CAAC,6BAA6B,CAAC,CAAC;IAE1E;;;OAGG;IACH,kBAAkB,EAAE,kBAAkB,CAAC,uBAAuB,CAAC,CAAC;IAEhE,qCAAqC;IACrC,gBAAgB,EAAE,kBAAkB,CAAC,uBAAuB,CAAC,CAAC;IAE9D,yCAAyC;IACzC,gBAAgB,EAAE,kBAAkB,CAAC,uBAAuB,CAAC,CAAC;IAE9D,oCAAoC;IACpC,eAAe,EAAE,kBAAkB,CAAC,uBAAuB,CAAC,CAAC;IAE7D,sCAAsC;IACtC,oBAAoB,EAAE,kBAAkB,CAAC,uBAAuB,CAAC,CAAC;IAElE;;;;OAIG;IACH,uBAAuB,CAAC,EAAE,kBAAkB,CAAC,iCAAiC,CAAC,CAAC;CACnF;AAED,MAAM,WAAW,cAAc;IAC3B,MAAM,EAAE,CAAC,OAAO,EAAE,KAAK,CAAC,UAAU,CAAC,aAAa,CAAC,WAAW,CAAC,CAAC,KAAK,IAAI,CAAC;IACxE,SAAS,EAAE,CAAC,OAAO,EAAE,KAAK,CAAC,UAAU,CAAC,aAAa,CAAC,WAAW,CAAC,CAAC,KAAK,IAAI,CAAC;IAC3E,eAAe,EAAE,CACb,OAAO,EAAE,KAAK,CAAC,UAAU,CAAC,aAAa,CAAC,WAAW,CAAC,CAAC,EACrD,YAAY,EAAE,KAAK,EACnB,SAAS,EAAE,MAAM,KAChB,IAAI,CAAC;IACV,cAAc,EAAE,CAAC,OAAO,EAAE,KAAK,CAAC,UAAU,CAAC,aAAa,CAAC,WAAW,CAAC,CAAC,KAAK,IAAI,CAAC;CACnF;AAED,eAAO,MAAM,QAAQ,EAAE,cAErB,CAAC;AAEH;;GAEG;wBACyE,aAAa,CAAC,WAAW,CAAC;AAAtG,wBAAuG"}

package/lib/typescript/src/specs/NativeCloudX.d.ts

@@ -46,6 +46,10 @@ export interface Spec extends TurboModule {
         ON_APPOPEN_DISPLAY_FAILED_EVENT: string;
         ON_APPOPEN_HIDDEN_EVENT: string;
         ON_APPOPEN_AD_REVENUE_PAID: string;
+        ON_NATIVE_AD_CLICKED_EVENT: string;
+        ON_NATIVE_AD_EXPIRED_EVENT: string;
+        ON_NATIVE_AD_CLOSED_EVENT: string;
+        ON_NATIVE_AD_REVENUE_PAID: string;
     };
     isInitialized(): Promise<boolean>;
     initialize(pluginVersion: string, appKey: string): Promise<CloudXConfiguration>;
@@ -103,6 +107,15 @@ export interface Spec extends TurboModule {
     isAppOpenReady(adUnitId: string): Promise<boolean>;
     showAppOpen(adUnitId: string, placement?: string | null, customData?: string | null): void;
     destroyAppOpen(adUnitId: string): void;
+    /**
+     * Loads a native ad with no view attached. Resolves with
+     * `{ nativeAdId, adInfo }` once an ad is held natively; rejects with the
+     * CloudX error code as the promise code. The ad stays held until
+     * `destroyNativeAd`, expiry, or module invalidation.
+     */
+    loadNativeAd(adUnitId: string, options: UnsafeObject): Promise<UnsafeObject>;
+    /** Releases a held native ad. Idempotent; unknown ids are ignored. */
+    destroyNativeAd(nativeAdId: string): void;
     addListener(eventName: string): void;
     removeListeners(count: number): void;
 }

package/lib/typescript/src/specs/NativeCloudX.d.ts.map

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

package/lib/typescript/src/types/NativeAd.d.ts

@@ -1,7 +1,8 @@
 import type { ViewProps } from 'react-native';
 import type { CloudXAdDisplayFailedInfo, CloudXAdInfo } from './AdInfo';
 import type { CloudXAdProps } from './AdProps';
-import type { CloudXExtraParameterValue } from './ExtraParameters';
+import type { CloudXExtraParameters, CloudXExtraParameterValue } from './ExtraParameters';
+import type { CloudXNativeAd } from '../CloudXNativeAd';
 /**
  * Built-in native ad template variants rendered by the SDK's view component.
  *
@@ -75,40 +76,102 @@ export type CloudXLocalExtraParameters = {
     [key: string]: CloudXExtraParameterValue;
 };
 /**
- * Props for the native-ad view component.
- *
- * Callbacks inherited from {@link CloudXAdProps} (`onAdLoaded`, `onAdLoadFailed`,
- * `onAdClicked`, `onAdRevenuePaid`) receive unwrapped payloads, not synthetic events.
+ * Load-time options for {@link CloudXNativeAd.load}. These configure the
+ * auction and the loader, so they are fixed once the ad is loaded; the view
+ * that later renders the ad only chooses the layout.
  */
-export type CloudXNativeAdViewProps = CloudXAdProps & ViewProps & {
-    template?: CloudXNativeTemplate;
-    localExtraParameters?: CloudXLocalExtraParameters;
+export type CloudXNativeAdLoadOptions = {
+    placement?: string | null;
+    customData?: string | null;
+    extraParameters?: CloudXExtraParameters | null;
+    localExtraParameters?: CloudXLocalExtraParameters | null;
     disableVideoFullScreen?: boolean;
     startVideoUnmuted?: boolean;
     hideVideoMediaControls?: boolean;
+};
+/** Events a preloaded {@link CloudXNativeAd} reports on its own handle. */
+export type CloudXNativeAdEventType = 'clicked' | 'revenuePaid' | 'expired' | 'closed';
+/** Props every native-ad view accepts, whichever way the ad was loaded. */
+type CloudXNativeAdViewRenderProps = ViewProps & {
+    template?: CloudXNativeTemplate;
     /** Selects between the SDK's bundled template layouts and manual asset binding. */
     renderMode?: 'template' | 'manual';
     /**
-     * Called when a loaded ad subsequently fails to display or track.
+     * Called each time the ad is rendered into this view and registered for
+     * click and impression tracking. Fires again after a re-bind.
+     */
+    onAdDisplayed?: (adInfo: CloudXAdInfo) => void;
+    /**
+     * Called when an ad fails to display or track in this view.
      *
      * Emitted on both platforms. Android fires it for post-load
      * adapter/render errors and when click/impression registration fails in
-     * manual mode. iOS fires it on the three manual-mode failure paths:
-     * render requested before load, expired ad, and registration refused.
+     * manual mode. iOS fires it on the manual-mode failure paths: render
+     * requested before load, expired ad, and registration refused. With
+     * `nativeAd`, it also fires when the handle is destroyed or expired.
      */
     onAdDisplayFailed?: (errorInfo: CloudXAdDisplayFailedInfo) => void;
+};
+/**
+ * Props for a native-ad view that loads its own ad when it attaches and
+ * destroys it on unmount. This is the shape `CloudXNativeAdView` has always
+ * taken, so wrappers that extend, `Omit` or `Pick` it keep compiling.
+ *
+ * Callbacks inherited from {@link CloudXAdProps} (`onAdLoaded`, `onAdLoadFailed`,
+ * `onAdClicked`, `onAdRevenuePaid`) receive unwrapped payloads, not synthetic events.
+ */
+export type CloudXNativeAdViewProps = CloudXNativeAdViewRenderProps & CloudXAdProps & {
+    localExtraParameters?: CloudXLocalExtraParameters;
+    disableVideoFullScreen?: boolean;
+    startVideoUnmuted?: boolean;
+    hideVideoMediaControls?: boolean;
     onAdExpired?: (adInfo: CloudXAdInfo) => void;
     onAdClosed?: (adInfo: CloudXAdInfo) => void;
+    nativeAd?: never;
 };
+/**
+ * The view renders an ad loaded earlier with {@link CloudXNativeAd.load}. It
+ * never loads and never destroys the ad. Clicks, revenue, expiry and close
+ * are reported once, on the handle (`nativeAd.addListener`), never on the
+ * view, so revenue cannot be counted twice.
+ */
+export type CloudXNativeAdViewPreloadedProps = CloudXNativeAdViewRenderProps & {
+    nativeAd: CloudXNativeAd;
+    adUnitId?: never;
+    placement?: never;
+    customData?: never;
+    extraParameters?: never;
+    localExtraParameters?: never;
+    disableVideoFullScreen?: never;
+    startVideoUnmuted?: never;
+    hideVideoMediaControls?: never;
+    onAdLoaded?: never;
+    onAdLoadFailed?: never;
+    onAdClicked?: never;
+    onAdRevenuePaid?: never;
+    onAdExpired?: never;
+    onAdClosed?: never;
+};
+/**
+ * Everything `CloudXNativeAdView` accepts: either it loads its own ad
+ * ({@link CloudXNativeAdViewProps}) or it renders one loaded earlier
+ * ({@link CloudXNativeAdViewPreloadedProps}). Mixing the two is a type error.
+ */
+export type CloudXNativeAdViewComponentProps = CloudXNativeAdViewProps | CloudXNativeAdViewPreloadedProps;
 export type CloudXNativeAdViewHandle = {
     /**
-     * Requests a load. This does NOT force a new auction: both native SDKs
+     * Requests a load. No-op when the view renders a preloaded `nativeAd`.
+     * This does NOT force a new auction: both native SDKs
      * re-serve the ad they already hold while it is neither expired nor
      * destroyed, including after its impression. Changed targeting is
      * therefore not picked up. Call `destroyAd()` first for a fresh ad.
      */
     loadAd: () => void;
-    /** Releases the native ad and its resources. */
+    /**
+     * Releases the native ad and its resources. No-op when the view renders a
+     * preloaded `nativeAd`: the handle owns that ad, so call `nativeAd.destroy()`.
+     */
     destroyAd: () => void;
 };
+export {};
 //# sourceMappingURL=NativeAd.d.ts.map

package/lib/typescript/src/types/NativeAd.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"NativeAd.d.ts","sourceRoot":"","sources":["../../../../src/types/NativeAd.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAC9C,OAAO,KAAK,EAAE,yBAAyB,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AACxE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAC/C,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,mBAAmB,CAAC;AAEnE;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,oBAAY,oBAAoB;IAC5B,6DAA6D;IAC7D,KAAK,mBAAmB;IAExB,wBAAwB;IACxB,MAAM,oBAAoB;IAE1B,sCAAsC;IACtC,YAAY,0BAA0B;IAEtC;;;;OAIG;IACH,cAAc,4BAA4B;CAC7C;AAED;;GAEG;AACH,oBAAY,qBAAqB;IAC7B,KAAK,cAAc;IACnB,UAAU,mBAAmB;IAC7B,IAAI,aAAa;IACjB,cAAc,qBAAqB;IACnC,IAAI,aAAa;IACjB,OAAO,gBAAgB;IACvB,KAAK,cAAc;IACnB,WAAW,mBAAmB;CACjC;AAED;;;;GAIG;AACH,MAAM,MAAM,sBAAsB,GAAG;IACjC,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,uBAAuB,CAAC,EAAE,MAAM,CAAC;IACjC,oBAAoB,EAAE,OAAO,CAAC;IAC9B,sBAAsB,EAAE,OAAO,CAAC;IAChC,oBAAoB,EAAE,OAAO,CAAC;IAC9B,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,cAAc,EAAE,OAAO,CAAC;IACxB,aAAa,EAAE,MAAM,CAAC;IACtB,SAAS,EAAE,OAAO,CAAC;CACtB,CAAC;AAIF,MAAM,MAAM,0BAA0B,GAAG;IACrC,CAAC,GAAG,EAAE,MAAM,GAAG,yBAAyB,CAAC;CAC5C,CAAC;AAEF;;;;;GAKG;AACH,MAAM,MAAM,uBAAuB,GAAG,aAAa,GAC/C,SAAS,GAAG;IACR,QAAQ,CAAC,EAAE,oBAAoB,CAAC;IAChC,oBAAoB,CAAC,EAAE,0BAA0B,CAAC;IAClD,sBAAsB,CAAC,EAAE,OAAO,CAAC;IACjC,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,sBAAsB,CAAC,EAAE,OAAO,CAAC;IACjC,mFAAmF;IACnF,UAAU,CAAC,EAAE,UAAU,GAAG,QAAQ,CAAC;IACnC;;;;;;;OAOG;IACH,iBAAiB,CAAC,EAAE,CAAC,SAAS,EAAE,yBAAyB,KAAK,IAAI,CAAC;IACnE,WAAW,CAAC,EAAE,CAAC,MAAM,EAAE,YAAY,KAAK,IAAI,CAAC;IAC7C,UAAU,CAAC,EAAE,CAAC,MAAM,EAAE,YAAY,KAAK,IAAI,CAAC;CAC/C,CAAC;AAEN,MAAM,MAAM,wBAAwB,GAAG;IACnC;;;;;OAKG;IACH,MAAM,EAAE,MAAM,IAAI,CAAC;IACnB,gDAAgD;IAChD,SAAS,EAAE,MAAM,IAAI,CAAC;CACzB,CAAC"}
+{"version":3,"file":"NativeAd.d.ts","sourceRoot":"","sources":["../../../../src/types/NativeAd.ts"],"names":[],"mappings":"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"}

package/lib/typescript/src/types/index.d.ts

@@ -14,6 +14,6 @@ export type { CloudXMRECAdType } from './MRECAd';
 export type { CloudXAdProps } from './AdProps';
 export type { CloudXAdEventObject, CloudXAdEventListener } from './AdEvent';
 export type { CloudXExtraParameterValue, CloudXExtraParameters } from './ExtraParameters';
-export type { CloudXNativeAdMetadata, CloudXNativeAdViewHandle, CloudXNativeAdViewProps, CloudXLocalExtraParameters, } from './NativeAd';
+export type { CloudXNativeAdMetadata, CloudXNativeAdViewHandle, CloudXNativeAdViewProps, CloudXNativeAdViewComponentProps, CloudXNativeAdViewPreloadedProps, CloudXNativeAdLoadOptions, CloudXNativeAdEventType, CloudXLocalExtraParameters, } from './NativeAd';
 export { CloudXNativeTemplate, CloudXNativeAssetType } from './NativeAd';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/types/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,YAAY,EAAE,sBAAsB,EAAE,yBAAyB,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAC;AACpH,YAAY,EAAE,0BAA0B,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AACvF,YAAY,EAAE,UAAU,EAAE,mBAAmB,EAAE,MAAM,UAAU,CAAC;AAChE,YAAY,EACR,gBAAgB,EAChB,0BAA0B,EAC1B,qBAAqB,EACrB,mBAAmB,EACnB,mBAAmB,EACnB,yBAAyB,EACzB,wBAAwB,EACxB,sBAAsB,EACtB,qBAAqB,EACrB,mBAAmB,GACtB,MAAM,WAAW,CAAC;AACnB,OAAO,EAAE,qBAAqB,EAAE,sBAAsB,EAAE,MAAM,eAAe,CAAC;AAC9E,YAAY,EAAE,iBAAiB,EAAE,0BAA0B,EAAE,2BAA2B,EAAE,MAAM,eAAe,CAAC;AAChH,YAAY,EAAE,sBAAsB,EAAE,MAAM,gBAAgB,CAAC;AAC7D,YAAY,EAAE,wBAAwB,EAAE,MAAM,kBAAkB,CAAC;AACjE,YAAY,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AACvD,YAAY,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AACzD,YAAY,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AACjD,YAAY,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AACrD,YAAY,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AACjD,YAAY,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAC/C,YAAY,EAAE,mBAAmB,EAAE,qBAAqB,EAAE,MAAM,WAAW,CAAC;AAC5E,YAAY,EAAE,yBAAyB,EAAE,qBAAqB,EAAE,MAAM,mBAAmB,CAAC;AAC1F,YAAY,EACR,sBAAsB,EACtB,wBAAwB,EACxB,uBAAuB,EACvB,0BAA0B,GAC7B,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,oBAAoB,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/types/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,YAAY,EAAE,sBAAsB,EAAE,yBAAyB,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAC;AACpH,YAAY,EAAE,0BAA0B,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AACvF,YAAY,EAAE,UAAU,EAAE,mBAAmB,EAAE,MAAM,UAAU,CAAC;AAChE,YAAY,EACR,gBAAgB,EAChB,0BAA0B,EAC1B,qBAAqB,EACrB,mBAAmB,EACnB,mBAAmB,EACnB,yBAAyB,EACzB,wBAAwB,EACxB,sBAAsB,EACtB,qBAAqB,EACrB,mBAAmB,GACtB,MAAM,WAAW,CAAC;AACnB,OAAO,EAAE,qBAAqB,EAAE,sBAAsB,EAAE,MAAM,eAAe,CAAC;AAC9E,YAAY,EAAE,iBAAiB,EAAE,0BAA0B,EAAE,2BAA2B,EAAE,MAAM,eAAe,CAAC;AAChH,YAAY,EAAE,sBAAsB,EAAE,MAAM,gBAAgB,CAAC;AAC7D,YAAY,EAAE,wBAAwB,EAAE,MAAM,kBAAkB,CAAC;AACjE,YAAY,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AACvD,YAAY,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AACzD,YAAY,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AACjD,YAAY,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AACrD,YAAY,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AACjD,YAAY,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAC/C,YAAY,EAAE,mBAAmB,EAAE,qBAAqB,EAAE,MAAM,WAAW,CAAC;AAC5E,YAAY,EAAE,yBAAyB,EAAE,qBAAqB,EAAE,MAAM,mBAAmB,CAAC;AAC1F,YAAY,EACR,sBAAsB,EACtB,wBAAwB,EACxB,uBAAuB,EACvB,gCAAgC,EAChC,gCAAgC,EAChC,yBAAyB,EACzB,uBAAuB,EACvB,0BAA0B,GAC7B,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,oBAAoB,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC"}

package/lib/typescript/src/version.d.ts

@@ -1,2 +1,2 @@
-export declare const PLUGIN_VERSION = "3.11.0";
+export declare const PLUGIN_VERSION = "3.11.1";
 //# sourceMappingURL=version.d.ts.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "cloudx-react-native",
-  "version": "3.11.0",
+  "version": "3.11.1",
   "description": "React Native wrapper for CloudX SDK (iOS & Android)",
   "main": "lib/commonjs/index",
   "module": "lib/module/index",

package/src/CloudXNativeAd.ts

@@ -0,0 +1,177 @@
+import type { EventSubscription } from 'react-native';
+import { emitter } from './EventEmitter';
+import { toNativeExtraParameterEntries } from './extraParameters';
+import NativeCloudX from './specs/NativeCloudX';
+import type { CloudXErrorCode } from './CloudXErrorCode';
+import type { CloudXAdInfo, CloudXAdLoadFailedInfo } from './types/AdInfo';
+import type { CloudXNativeAdEventType, CloudXNativeAdLoadOptions, CloudXNativeAdMetadata } from './types/NativeAd';
+
+const {
+    ON_NATIVE_AD_CLICKED_EVENT,
+    ON_NATIVE_AD_EXPIRED_EVENT,
+    ON_NATIVE_AD_CLOSED_EVENT,
+    ON_NATIVE_AD_REVENUE_PAID,
+} = NativeCloudX.getConstants();
+
+type NativeAdEventPayload = Partial<CloudXAdInfo> & { nativeAdId?: string };
+type NativeAdListener = (adInfo: CloudXAdInfo) => void;
+
+const toAdInfo = (payload: NativeAdEventPayload, adUnitId: string): CloudXAdInfo => ({
+    adUnitId: payload.adUnitId ?? adUnitId,
+    adFormat: payload.adFormat ?? 'NATIVE',
+    networkName: payload.networkName ?? '',
+    networkPlacement: payload.networkPlacement ?? null,
+    placement: payload.placement ?? null,
+    creativeId: payload.creativeId ?? null,
+    revenue: payload.revenue ?? 0,
+    adValues: payload.adValues ?? {},
+    nativeAd: payload.nativeAd ?? null,
+});
+
+// Live handles by native id. Native events arrive on the module-wide emitter
+// and are routed here, so a handle never hears another ad's events.
+const liveAds = new Map<string, CloudXNativeAd>();
+let routingSubscriptions: EventSubscription[] | null = null;
+
+const ensureEventRouting = (): void => {
+    if (routingSubscriptions) return;
+    const route = (type: CloudXNativeAdEventType) => (payload: NativeAdEventPayload) => {
+        const ad = payload.nativeAdId ? liveAds.get(payload.nativeAdId) : undefined;
+        ad?._handleNativeEvent(type, payload);
+    };
+    // Subscribe on the shared emitter directly: the module-level
+    // addEventListener helper keeps one listener per event name and would
+    // replace a publisher's own subscription.
+    routingSubscriptions = [
+        emitter.addListener(ON_NATIVE_AD_CLICKED_EVENT, route('clicked')),
+        emitter.addListener(ON_NATIVE_AD_REVENUE_PAID, route('revenuePaid')),
+        emitter.addListener(ON_NATIVE_AD_EXPIRED_EVENT, route('expired')),
+        emitter.addListener(ON_NATIVE_AD_CLOSED_EVENT, route('closed')),
+    ];
+};
+
+const toLoadFailedInfo = (adUnitId: string, error: unknown): CloudXAdLoadFailedInfo => {
+    const { code, message } = (error ?? {}) as { code?: unknown; message?: unknown };
+    const numeric = Number(code);
+    return {
+        adUnitId,
+        code: (Number.isFinite(numeric) ? numeric : 0) as CloudXErrorCode,
+        message: typeof message === 'string' ? message : null,
+    };
+};
+
+/**
+ * A native ad loaded ahead of its view.
+ *
+ * Load it whenever it suits the app, then render it with
+ * `<CloudXNativeAdView nativeAd={ad} />`. The handle owns the ad: unmounting a
+ * view never destroys it, and its impression is counted once. Clicks, revenue,
+ * expiry and close are reported here, not on the view.
+ *
+ * Moving an ad to another view differs by platform:
+ * - iOS: mount another view with the same ad and it shows there; the latest
+ *   view wins.
+ * - Android: once the ad has been shown in a view, it stays with that view.
+ *   Any other view, including a remounted list cell or a reopened screen,
+ *   reports `onAdDisplayFailed` with `AD_ALREADY_SHOWING`. Load a fresh ad
+ *   for each new view.
+ *
+ * An ad that expires before its impression (its `revenuePaid` event) reports
+ * `expired` on both platforms, even if it was already shown in a view.
+ *
+ * Call `destroy()` when the ad is no longer needed.
+ */
+export class CloudXNativeAd {
+    readonly id: string;
+    readonly adUnitId: string;
+    /** Ad info as of load. Revenue callbacks carry the impression-time values. */
+    readonly info: CloudXAdInfo;
+    /** Asset metadata for manual layouts; `null` if the network reported none. */
+    readonly metadata: CloudXNativeAdMetadata | null;
+
+    private expired = false;
+    private destroyed = false;
+    private readonly listeners = new Map<CloudXNativeAdEventType, Set<NativeAdListener>>();
+
+    /**
+     * Loads a native ad without a view. Resolves once the ad is held natively;
+     * rejects with a `CloudXAdLoadFailedInfo`.
+     *
+     * Loads per ad unit are limited, so preload several ads one after another
+     * rather than all at once.
+     */
+    static async load(adUnitId: string, options: CloudXNativeAdLoadOptions = {}): Promise<CloudXNativeAd> {
+        ensureEventRouting();
+        // Extra parameters cross the bridge as {key, value} entries, the same
+        // wire format CloudXNativeAdView sends, so both native load paths
+        // configure the loader through one helper.
+        const wireOptions = {
+            ...options,
+            extraParameters: toNativeExtraParameterEntries(options.extraParameters),
+            localExtraParameters: toNativeExtraParameterEntries(options.localExtraParameters),
+        };
+        let result: { nativeAdId?: string; adInfo?: NativeAdEventPayload };
+        try {
+            result = (await NativeCloudX.loadNativeAd(adUnitId, wireOptions)) as typeof result;
+        } catch (error) {
+            throw toLoadFailedInfo(adUnitId, error);
+        }
+        if (!result?.nativeAdId) {
+            throw toLoadFailedInfo(adUnitId, { code: 0, message: 'Native module returned no native ad id' });
+        }
+        return new CloudXNativeAd(result.nativeAdId, adUnitId, result.adInfo ?? {});
+    }
+
+    private constructor(id: string, adUnitId: string, payload: NativeAdEventPayload) {
+        this.id = id;
+        this.adUnitId = adUnitId;
+        this.info = toAdInfo(payload, adUnitId);
+        this.metadata = this.info.nativeAd ?? null;
+        liveAds.set(id, this);
+    }
+
+    get isExpired(): boolean {
+        return this.expired;
+    }
+
+    get isDestroyed(): boolean {
+        return this.destroyed;
+    }
+
+    addListener(type: CloudXNativeAdEventType, listener: NativeAdListener): { remove: () => void } {
+        if (this.destroyed) {
+            console.warn(`CloudXNativeAd(${this.id}): addListener('${type}') after destroy() never fires.`);
+            return { remove: () => undefined };
+        }
+        let set = this.listeners.get(type);
+        if (!set) {
+            set = new Set();
+            this.listeners.set(type, set);
+        }
+        set.add(listener);
+        return { remove: () => this.listeners.get(type)?.delete(listener) };
+    }
+
+    /** Releases the native ad. Safe to call more than once. */
+    destroy(): void {
+        if (this.destroyed) return;
+        this.destroyed = true;
+        liveAds.delete(this.id);
+        this.listeners.clear();
+        NativeCloudX.destroyNativeAd(this.id);
+    }
+
+    /** @internal Routed from the module emitter; not part of the public API. */
+    _handleNativeEvent(type: CloudXNativeAdEventType, payload: NativeAdEventPayload): void {
+        if (this.destroyed) return;
+        if (type === 'expired') this.expired = true;
+        const adInfo = toAdInfo(payload, this.adUnitId);
+        this.listeners.get(type)?.forEach((listener) => {
+            try {
+                listener(adInfo);
+            } catch (error) {
+                console.error(`CloudXNativeAd(${this.id}): '${type}' listener threw`, error);
+            }
+        });
+    }
+}

package/src/CloudXNativeAdView.tsx

@@ -6,7 +6,7 @@ import NativeCloudXNativeAdView, { Commands } from './specs/CloudXNativeAdViewNa
 import type { CloudXNativeAdInfoEvent, CloudXNativeAdLoadFailedEvent } from './specs/CloudXNativeAdViewNativeComponent';
 import { toNativeExtraParameterEntries } from './extraParameters';
 import { CloudXNativeAssetType } from './types/NativeAd';
-import type { CloudXNativeAdMetadata, CloudXNativeAdViewHandle, CloudXNativeAdViewProps } from './types/NativeAd';
+import type { CloudXNativeAdMetadata, CloudXNativeAdViewHandle, CloudXNativeAdViewComponentProps } from './types/NativeAd';
 import type { CloudXAdDisplayFailedInfo, CloudXAdInfo, CloudXAdLoadFailedInfo } from './types/AdInfo';
 import type { CloudXErrorCode } from './CloudXErrorCode';
 import { CloudXNativeAdViewContext, CloudXNativeAdViewProvider } from './CloudXNativeAdViewProvider';
@@ -59,18 +59,54 @@ const toLoadFailedInfo = (event: CloudXNativeAdLoadFailedEvent): CloudXAdLoadFai
     message: event.message || null,
 });
 
+// Props that only mean something when the view loads its own ad. Passing one
+// next to `nativeAd` is a type error, but plain-JS callers can still do it.
+const AUTO_LOAD_ONLY_PROPS = [
+    'adUnitId',
+    'placement',
+    'customData',
+    'extraParameters',
+    'localExtraParameters',
+    'disableVideoFullScreen',
+    'startVideoUnmuted',
+    'hideVideoMediaControls',
+    'onAdLoaded',
+    'onAdLoadFailed',
+    'onAdClicked',
+    'onAdRevenuePaid',
+    'onAdExpired',
+    'onAdClosed',
+] as const;
+
 /**
  * Renders a native ad. Defaults to the SDK's bundled template layouts;
  * set `renderMode="manual"` to drive layout through the pre-built asset
  * components (`CloudXTitleView`, `CloudXMediaView`, etc.) instead.
  *
+ * Pass `adUnitId` and the view loads its own ad on attach. Pass `nativeAd`
+ * (from `CloudXNativeAd.load`) and it renders that ad instead, without
+ * loading or destroying it.
+ *
  * Manual mode is never inferred from the presence of children — `renderMode`
  * is always explicit so a publisher's intent is visible at the call site.
  */
-export const CloudXNativeAdView = forwardRef<CloudXNativeAdViewHandle, CloudXNativeAdViewProps>(
+export const CloudXNativeAdView = forwardRef<CloudXNativeAdViewHandle, CloudXNativeAdViewComponentProps>(
     function CloudXNativeAdView(props, ref) {
         const { renderMode = 'template', style, testID, children } = props;
 
+        const warnedMixedProps = useRef(false);
+        if (__DEV__ && props.nativeAd && !warnedMixedProps.current) {
+            const ignored = AUTO_LOAD_ONLY_PROPS.filter((name) => Reflect.get(props, name) != null);
+            if (ignored.length > 0) {
+                warnedMixedProps.current = true;
+                console.warn(
+                    `CloudXNativeAdView: ${ignored.join(', ')} ignored because nativeAd is set. ` +
+                        'Pass load options to CloudXNativeAd.load() and subscribe to clicks, revenue, ' +
+                        'expiry and close with nativeAd.addListener().'
+                );
+            }
+        }
+
         /*
          * Gate native ad-view creation on SDK initialization; shared with
          * CloudXAdViewBase (banner/MREC) via useCloudXSdkInitializationGate.
@@ -114,8 +150,11 @@ export const CloudXNativeAdView = forwardRef<CloudXNativeAdViewHandle, CloudXNat
             );
         }
 
+        // Keyed by the bound handle: swapping `nativeAd` remounts the provider
+        // and native view, so the previous ad's metadata and asset bindings
+        // can never be shown under the new ad's click and impression tracking.
         return (
-            <CloudXNativeAdViewProvider onAssetRoleRegistered={handleAssetRoleRegistered}>
+            <CloudXNativeAdViewProvider key={props.nativeAd?.id} onAssetRoleRegistered={handleAssetRoleRegistered}>
                 <CloudXNativeAdViewImpl {...props} ref={ref} />
             </CloudXNativeAdViewProvider>
         );
@@ -124,7 +163,7 @@ export const CloudXNativeAdView = forwardRef<CloudXNativeAdViewHandle, CloudXNat
 
 export default CloudXNativeAdView;
 
-const CloudXNativeAdViewImpl = forwardRef<CloudXNativeAdViewHandle, CloudXNativeAdViewProps>(
+const CloudXNativeAdViewImpl = forwardRef<CloudXNativeAdViewHandle, CloudXNativeAdViewComponentProps>(
     function CloudXNativeAdViewImpl(props, ref) {
         const {
             adUnitId,
@@ -137,8 +176,10 @@ const CloudXNativeAdViewImpl = forwardRef<CloudXNativeAdViewHandle, CloudXNative
             extraParameters,
             localExtraParameters,
             renderMode = 'template',
+            nativeAd,
             onAdLoaded,
             onAdLoadFailed,
+            onAdDisplayed,
             onAdDisplayFailed,
             onAdClicked,
             onAdExpired,
@@ -151,6 +192,7 @@ const CloudXNativeAdViewImpl = forwardRef<CloudXNativeAdViewHandle, CloudXNative
         } = props;
 
         const isManual = renderMode === 'manual';
+        const isPreloaded = nativeAd != null;
 
         const {
             setNativeAd,
@@ -175,12 +217,14 @@ const CloudXNativeAdViewImpl = forwardRef<CloudXNativeAdViewHandle, CloudXNative
         const [bindTick, setBindTick] = useState(0);
 
         const loadAd = useCallback(() => {
-            if (nativeRef.current) {
+            if (nativeRef.current && !isPreloaded) {
                 Commands.loadAd(nativeRef.current);
             }
-        }, []);
+        }, [isPreloaded]);
 
         const destroyAd = useCallback(() => {
+            // A preloaded ad belongs to its handle, not to this view.
+            if (isPreloaded) return;
             if (nativeRef.current) {
                 Commands.destroyAd(nativeRef.current);
             }
@@ -189,7 +233,7 @@ const CloudXNativeAdViewImpl = forwardRef<CloudXNativeAdViewHandle, CloudXNative
             pendingMetadata.current = null;
             lastAdInfoRef.current = null;
             setNativeAd(null);
-        }, [setNativeAd]);
+        }, [isPreloaded, setNativeAd]);
 
         /**
          * Escape hatch for imperative control. The native view auto-loads on
@@ -222,15 +266,33 @@ const CloudXNativeAdViewImpl = forwardRef<CloudXNativeAdViewHandle, CloudXNative
                 const adInfo = toAdInfo(event.nativeEvent);
                 lastAdInfoRef.current = adInfo;
 
-                if (isManual && adInfo.nativeAd) {
-                    pendingMetadata.current = adInfo.nativeAd;
-                    setNativeAd(adInfo.nativeAd);
+                // A preloaded ad's metadata travelled with the handle, so a
+                // bind event that omits it still has assets to lay out.
+                const metadata = adInfo.nativeAd ?? nativeAd?.metadata ?? null;
+                if (isManual && metadata) {
+                    pendingMetadata.current = metadata;
+                    setNativeAd(metadata);
                     setBindTick((n) => n + 1);
                 }
 
                 onAdLoaded?.(adInfo);
             },
-            [isManual, setNativeAd, onAdLoaded]
+            [isManual, nativeAd, setNativeAd, onAdLoaded]
+        );
+
+        // Native released the preloaded ad this view showed (destroy, expiry,
+        // or a newer view took it). Its React-rendered text and images must
+        // go with it, and any asset binds still pending must stop. Silent:
+        // a transfer to another view is not a publisher lifecycle event.
+        const handleBindingCleared = useCallback(() => {
+            pendingMetadata.current = null;
+            lastAdInfoRef.current = null;
+            setNativeAd(null);
+        }, [setNativeAd]);
+
+        const handleAdDisplayed = useCallback(
+            (event: NativeSyntheticEvent<CloudXNativeAdInfoEvent>) => onAdDisplayed?.(toAdInfo(event.nativeEvent)),
+            [onAdDisplayed]
         );
 
         const handleAdLoadFailed = useCallback(
@@ -248,8 +310,10 @@ const CloudXNativeAdViewImpl = forwardRef<CloudXNativeAdViewHandle, CloudXNative
                 // failure if it describes the ad unit that actually failed. A
                 // display failure arriving after a re-target would otherwise
                 // report the previous unit's network, placement and revenue.
-                const cached = lastAdInfoRef.current;
-                const base = cached && cached.adUnitId === failedAdUnitId ? cached : null;
+                // A preloaded ad can fail before it ever rendered here (e.g. the
+                // handle was destroyed), so fall back to its load-time info.
+                const cached = lastAdInfoRef.current ?? nativeAd?.info ?? null;
+                const base = cached && (!failedAdUnitId || cached.adUnitId === failedAdUnitId) ? cached : null;
                 const displayFailedInfo: CloudXAdDisplayFailedInfo = {
                     // The event's own adUnitId is authoritative.
                     adUnitId: failedAdUnitId || base?.adUnitId || '',
@@ -265,7 +329,7 @@ const CloudXNativeAdViewImpl = forwardRef<CloudXNativeAdViewHandle, CloudXNative
                 };
                 onAdDisplayFailed(displayFailedInfo);
             },
-            [onAdDisplayFailed]
+            [nativeAd, onAdDisplayFailed]
         );
 
         const handleAdClicked = useCallback(
@@ -392,7 +456,8 @@ const CloudXNativeAdViewImpl = forwardRef<CloudXNativeAdViewHandle, CloudXNative
                 ref={(r) => {
                     nativeRef.current = r;
                 }}
-                adUnitId={adUnitId}
+                adUnitId={isPreloaded ? null : adUnitId}
+                nativeAdId={nativeAd?.id ?? null}
                 templateName={template}
                 placement={placement ?? null}
                 customData={customData ?? null}
@@ -404,7 +469,9 @@ const CloudXNativeAdViewImpl = forwardRef<CloudXNativeAdViewHandle, CloudXNative
                 manualRender={isManual}
                 onAdLoadedEvent={handleAdLoaded}
                 onAdLoadFailedEvent={handleAdLoadFailed}
+                onAdDisplayedEvent={handleAdDisplayed}
                 onAdDisplayFailedEvent={handleAdDisplayFailed}
+                onAdBindingClearedEvent={handleBindingCleared}
                 onAdClickedEvent={handleAdClicked}
                 onAdExpiredEvent={handleAdExpired}
                 onAdClosedEvent={handleAdClosed}