@bigcrunch/react-native-ads 0.11.0 → 0.13.0

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

@@ -38,6 +38,95 @@ internal struct RevenueData: Codable {
     let currency: String
 }
 
+// MARK: - Screen View Options
+
+/**
+ * Options for customizing screen view tracking
+ *
+ * Allows app developers to provide page URL, content metadata,
+ * and custom dimensions for analytics events.
+ */
+public struct ScreenViewOptions {
+    /// Override the auto-generated page URL (must be a valid URL)
+    public var pageUrl: String?
+
+    /// Content metadata for this screen/page
+    public var pageMeta: PageMetaData?
+
+    /// Custom key-value dimensions attached to analytics events
+    public var customDimensions: [String: String]?
+
+    public init(
+        pageUrl: String? = nil,
+        pageMeta: PageMetaData? = nil,
+        customDimensions: [String: String]? = nil
+    ) {
+        self.pageUrl = pageUrl
+        self.pageMeta = pageMeta
+        self.customDimensions = customDimensions
+    }
+}
+
+/**
+ * Content metadata for a screen/page view
+ *
+ * Matches the `page_meta_data` fields in the analytics schema.
+ */
+public struct PageMetaData: Codable {
+    /// Canonical page URL
+    public var url: String?
+    /// Content author
+    public var author: String?
+    /// Page/screen title
+    public var title: String?
+    /// Featured image URL
+    public var thumbnailUrl: String?
+    /// Content section/category
+    public var articleSection: String?
+    /// Comma-separated keywords
+    public var keywords: String?
+    /// Content creation date (ISO 8601)
+    public var dateCreated: String?
+    /// Content last modified date (ISO 8601)
+    public var dateModified: String?
+    /// Content publication date (ISO 8601)
+    public var datePublished: String?
+
+    public init(
+        url: String? = nil,
+        author: String? = nil,
+        title: String? = nil,
+        thumbnailUrl: String? = nil,
+        articleSection: String? = nil,
+        keywords: String? = nil,
+        dateCreated: String? = nil,
+        dateModified: String? = nil,
+        datePublished: String? = nil
+    ) {
+        self.url = url
+        self.author = author
+        self.title = title
+        self.thumbnailUrl = thumbnailUrl
+        self.articleSection = articleSection
+        self.keywords = keywords
+        self.dateCreated = dateCreated
+        self.dateModified = dateModified
+        self.datePublished = datePublished
+    }
+
+    enum CodingKeys: String, CodingKey {
+        case url
+        case author
+        case title
+        case thumbnailUrl = "thumbnailUrl"
+        case articleSection = "articleSection"
+        case keywords
+        case dateCreated = "dateCreated"
+        case dateModified = "dateModified"
+        case datePublished = "datePublished"
+    }
+}
+
 // MARK: - Enhanced Analytics Events (matching web SDK data model)
 
 /**
@@ -91,6 +180,9 @@ internal struct PageViewEvent: Codable {
     let amznPubId: String  // Must be valid UUID (nil UUID for empty)
     let customDimensions: [String: String]
 
+    // Page metadata (only for pageview events)
+    let pageMetaData: PageMetaData?
+
     enum CodingKeys: String, CodingKey {
         case payloadVersion = "payload_version"
         case configVersion = "config_version"
@@ -123,6 +215,7 @@ internal struct PageViewEvent: Codable {
         case gamNetworkCode = "gam_network_code"
         case amznPubId = "amzn_pub_id"
         case customDimensions = "custom_dimensions"
+        case pageMetaData = "page_meta_data"
     }
 }
 
@@ -269,7 +362,7 @@ internal struct ImpressionBatchEvent: Codable {
     let customDimensions: [String: String]
 
     // Nested impressions array
-    let impressions: [ImpressionRecord]
+    var impressions: [ImpressionRecord]
 
     enum CodingKeys: String, CodingKey {
         case payloadVersion = "payload_version"
@@ -577,7 +670,7 @@ internal struct ViewabilityEvent: Codable {
     let amznPubId: String
 
     // Nested viewability array (per backend schema)
-    let viewability: [ViewabilityData]
+    var viewability: [ViewabilityData]
 
     enum CodingKeys: String, CodingKey {
         case payloadVersion = "payload_version"
@@ -735,8 +828,23 @@ internal struct AuctionData {
     /// Creative ID from winning bid
     let creativeId: String?
 
+    /// GAM price bucket (hb_pb value from targeting KVPs)
+    let gamPriceBucket: String?
+
+    /// Floor price sent to bidders
+    let floorPrice: Double?
+
+    /// Second-highest bid price (for computing min_bid_to_win)
+    let secondHighestBid: Double?
+
+    /// Demand channel ("S2S", "Google Ad Exchange", etc.)
+    let demandChannel: String?
+
     /// Empty auction data
-    static let empty = AuctionData(auctionId: nil, bidder: nil, bidPriceCpm: nil, creativeId: nil)
+    static let empty = AuctionData(
+        auctionId: nil, bidder: nil, bidPriceCpm: nil, creativeId: nil,
+        gamPriceBucket: nil, floorPrice: nil, secondHighestBid: nil, demandChannel: nil
+    )
 }
 
 // MARK: - Impression Context

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

@@ -13,19 +13,22 @@ public struct PlacementConfig: Codable {
     public let gamAdUnit: String
     public let sizes: [AdSize]?
     public let refresh: RefreshConfig?
+    public let floorPrice: Double?
 
     public init(
         placementId: String,
         format: String,
         gamAdUnit: String,
         sizes: [AdSize]?,
-        refresh: RefreshConfig? = nil
+        refresh: RefreshConfig? = nil,
+        floorPrice: Double? = nil
     ) {
         self.placementId = placementId
         self.format = format
         self.gamAdUnit = gamAdUnit
         self.sizes = sizes
         self.refresh = refresh
+        self.floorPrice = floorPrice
     }
 }
 

package/ios/BigCrunchAdsModule.m

@@ -20,6 +20,7 @@ RCT_EXTERN_METHOD(isInitialized:(RCTPromiseResolveBlock)resolve
 
 // Screen Tracking
 RCT_EXTERN_METHOD(trackScreenView:(NSString *)screenName
+                  options:(NSDictionary *)options
                   resolver:(RCTPromiseResolveBlock)resolve
                   rejecter:(RCTPromiseRejectBlock)reject)
 

package/ios/BigCrunchAdsModule.swift

@@ -1,4 +1,5 @@
 import Foundation
+import BigCrunchAds
 #if canImport(React)
 import React
 #endif
@@ -278,12 +279,38 @@ class BigCrunchAdsModule: RCTEventEmitter {
 
     // MARK: - Screen Tracking
 
-    @objc(trackScreenView:resolver:rejecter:)
+    @objc(trackScreenView:options:resolver:rejecter:)
     func trackScreenView(screenName: String,
+                        options: NSDictionary?,
                         resolver: @escaping RCTPromiseResolveBlock,
                         rejecter: @escaping RCTPromiseRejectBlock) {
         DispatchQueue.main.async {
-            BigCrunchAds.trackScreen(screenName)
+            var screenViewOptions: ScreenViewOptions? = nil
+
+            if let opts = options as? [String: Any] {
+                var pageMeta: PageMetaData? = nil
+                if let metaDict = opts["pageMeta"] as? [String: String] {
+                    pageMeta = PageMetaData(
+                        url: metaDict["url"],
+                        author: metaDict["author"],
+                        title: metaDict["title"],
+                        thumbnailUrl: metaDict["thumbnailUrl"],
+                        articleSection: metaDict["articleSection"],
+                        keywords: metaDict["keywords"],
+                        dateCreated: metaDict["dateCreated"],
+                        dateModified: metaDict["dateModified"],
+                        datePublished: metaDict["datePublished"]
+                    )
+                }
+
+                screenViewOptions = ScreenViewOptions(
+                    pageUrl: opts["pageUrl"] as? String,
+                    pageMeta: pageMeta,
+                    customDimensions: opts["customDimensions"] as? [String: String]
+                )
+            }
+
+            BigCrunchAds.trackScreen(screenName, options: screenViewOptions)
             resolver(nil)
         }
     }

package/ios/BigCrunchBannerViewManager.swift

@@ -1,4 +1,5 @@
 import Foundation
+import BigCrunchAds
 import React
 import UIKit
 import GoogleMobileAds

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 } from './types';
+import type { InitializationOptions, Environment, SessionInfo, DeviceContext, AppConfig, EventSubscription, ScreenViewOptions } from './types';
 /**
  * Main entry point for BigCrunch Mobile Ads SDK
  */
@@ -34,13 +34,30 @@ export declare class BigCrunchAds {
      * Track a screen view for analytics
      *
      * @param screenName - Name of the screen being viewed
+     * @param options - Optional overrides for page URL, content metadata, and custom dimensions
      *
      * @example
      * ```typescript
+     * // Simple usage
      * BigCrunchAds.trackScreenView('HomeScreen');
+     *
+     * // With options
+     * BigCrunchAds.trackScreenView('ArticlePage', {
+     *   pageUrl: 'https://example.com/articles/123',
+     *   pageMeta: {
+     *     title: 'My Article Title',
+     *     author: 'Jane Smith',
+     *     articleSection: 'Technology',
+     *     keywords: 'tech,mobile,apps',
+     *   },
+     *   customDimensions: {
+     *     content_type: 'article',
+     *     content_id: '123',
+     *   },
+     * });
      * ```
      */
-    static trackScreenView(screenName: string): Promise<void>;
+    static trackScreenView(screenName: string, options?: ScreenViewOptions): Promise<void>;
     /**
      * Get the current app configuration
      * Returns null if config hasn't been loaded yet

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

@@ -60,15 +60,32 @@ export class BigCrunchAds {
      * Track a screen view for analytics
      *
      * @param screenName - Name of the screen being viewed
+     * @param options - Optional overrides for page URL, content metadata, and custom dimensions
      *
      * @example
      * ```typescript
+     * // Simple usage
      * BigCrunchAds.trackScreenView('HomeScreen');
+     *
+     * // With options
+     * BigCrunchAds.trackScreenView('ArticlePage', {
+     *   pageUrl: 'https://example.com/articles/123',
+     *   pageMeta: {
+     *     title: 'My Article Title',
+     *     author: 'Jane Smith',
+     *     articleSection: 'Technology',
+     *     keywords: 'tech,mobile,apps',
+     *   },
+     *   customDimensions: {
+     *     content_type: 'article',
+     *     content_id: '123',
+     *   },
+     * });
      * ```
      */
-    static async trackScreenView(screenName) {
+    static async trackScreenView(screenName, options) {
         this.ensureInitialized();
-        return NativeBigCrunchAds.trackScreenView(screenName);
+        return NativeBigCrunchAds.trackScreenView(screenName, options);
     }
     /**
      * Get the current app configuration

package/lib/NativeBigCrunchAds.d.ts

@@ -3,13 +3,13 @@
  * This is the bridge to the native Android/iOS implementation
  */
 import { NativeEventEmitter } from 'react-native';
-import type { InitializationOptions, AdRequestOptions, SessionInfo, DeviceContext, AppConfig } from './types';
+import type { InitializationOptions, AdRequestOptions, SessionInfo, DeviceContext, AppConfig, ScreenViewOptions } from './types';
 export interface NativeBigCrunchAdsModule {
     initialize(options: InitializationOptions): Promise<void>;
     isInitialized(): Promise<boolean>;
     getAppConfig(): Promise<AppConfig | null>;
     refreshConfig(): Promise<void>;
-    trackScreenView(screenName: string): Promise<void>;
+    trackScreenView(screenName: string, options?: ScreenViewOptions): Promise<void>;
     loadInterstitial(options: AdRequestOptions): Promise<void>;
     showInterstitial(placementId: string): Promise<void>;
     isInterstitialLoaded(placementId: string): Promise<boolean>;

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,MAAM,SAAS,CAAC;AAG9G,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,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAGnD,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,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/index.d.ts

@@ -43,6 +43,42 @@ export interface InitializationOptions {
     /** Session timeout in seconds (default: 1800) */
     sessionTimeout?: number;
 }
+/**
+ * Content metadata for a screen/page view
+ *
+ * Matches the `page_meta_data` fields in the BigCrunch analytics schema.
+ */
+export interface PageMetaData {
+    /** Canonical page URL */
+    url?: string;
+    /** Content author */
+    author?: string;
+    /** Page/screen title */
+    title?: string;
+    /** Featured image URL */
+    thumbnailUrl?: string;
+    /** Content section/category */
+    articleSection?: string;
+    /** Comma-separated keywords */
+    keywords?: string;
+    /** Content creation date (ISO 8601) */
+    dateCreated?: string;
+    /** Content last modified date (ISO 8601) */
+    dateModified?: string;
+    /** Content publication date (ISO 8601) */
+    datePublished?: string;
+}
+/**
+ * Options for customizing screen view tracking
+ */
+export interface ScreenViewOptions {
+    /** Override the auto-generated page URL (must be a valid web URL) */
+    pageUrl?: string;
+    /** Content metadata for this screen/page */
+    pageMeta?: PageMetaData;
+    /** Custom key-value dimensions attached to analytics events */
+    customDimensions?: Record<string, string>;
+}
 /**
  * Ad request options
  */

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.11.0",
+  "version": "0.13.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/react-native-bigcrunch-ads.podspec

@@ -19,7 +19,7 @@ Pod::Spec.new do |s|
   s.requires_arc = true
 
   s.dependency "React"
-  s.dependency "Google-Mobile-Ads-SDK", ">= 10.14.0"
+  s.dependency "BigCrunchAds"
 
   s.swift_version = "5.9"
 end

package/src/BigCrunchAds.ts

@@ -15,6 +15,7 @@ import type {
   DeviceContext,
   AppConfig,
   EventSubscription,
+  ScreenViewOptions,
 } from './types';
 
 /**
@@ -84,15 +85,35 @@ export class BigCrunchAds {
    * Track a screen view for analytics
    *
    * @param screenName - Name of the screen being viewed
+   * @param options - Optional overrides for page URL, content metadata, and custom dimensions
    *
    * @example
    * ```typescript
+   * // Simple usage
    * BigCrunchAds.trackScreenView('HomeScreen');
+   *
+   * // With options
+   * BigCrunchAds.trackScreenView('ArticlePage', {
+   *   pageUrl: 'https://example.com/articles/123',
+   *   pageMeta: {
+   *     title: 'My Article Title',
+   *     author: 'Jane Smith',
+   *     articleSection: 'Technology',
+   *     keywords: 'tech,mobile,apps',
+   *   },
+   *   customDimensions: {
+   *     content_type: 'article',
+   *     content_id: '123',
+   *   },
+   * });
    * ```
    */
-  static async trackScreenView(screenName: string): Promise<void> {
+  static async trackScreenView(
+    screenName: string,
+    options?: ScreenViewOptions
+  ): Promise<void> {
     this.ensureInitialized();
-    return NativeBigCrunchAds.trackScreenView(screenName);
+    return NativeBigCrunchAds.trackScreenView(screenName, options);
   }
 
   /**

package/src/NativeBigCrunchAds.ts

@@ -4,7 +4,7 @@
  */
 
 import { NativeModules, NativeEventEmitter, Platform } from 'react-native';
-import type { InitializationOptions, AdRequestOptions, SessionInfo, DeviceContext, AppConfig } from './types';
+import type { InitializationOptions, AdRequestOptions, SessionInfo, DeviceContext, AppConfig, ScreenViewOptions } from './types';
 
 // Type definition for the native module
 export interface NativeBigCrunchAdsModule {
@@ -17,7 +17,7 @@ export interface NativeBigCrunchAdsModule {
   refreshConfig(): Promise<void>;
 
   // Screen tracking
-  trackScreenView(screenName: string): Promise<void>;
+  trackScreenView(screenName: string, options?: ScreenViewOptions): Promise<void>;
 
   // Interstitial ads
   loadInterstitial(options: AdRequestOptions): Promise<void>;

package/src/types/index.ts

@@ -57,6 +57,44 @@ export interface InitializationOptions {
   sessionTimeout?: number;
 }
 
+/**
+ * Content metadata for a screen/page view
+ *
+ * Matches the `page_meta_data` fields in the BigCrunch analytics schema.
+ */
+export interface PageMetaData {
+  /** Canonical page URL */
+  url?: string;
+  /** Content author */
+  author?: string;
+  /** Page/screen title */
+  title?: string;
+  /** Featured image URL */
+  thumbnailUrl?: string;
+  /** Content section/category */
+  articleSection?: string;
+  /** Comma-separated keywords */
+  keywords?: string;
+  /** Content creation date (ISO 8601) */
+  dateCreated?: string;
+  /** Content last modified date (ISO 8601) */
+  dateModified?: string;
+  /** Content publication date (ISO 8601) */
+  datePublished?: string;
+}
+
+/**
+ * Options for customizing screen view tracking
+ */
+export interface ScreenViewOptions {
+  /** Override the auto-generated page URL (must be a valid web URL) */
+  pageUrl?: string;
+  /** Content metadata for this screen/page */
+  pageMeta?: PageMetaData;
+  /** Custom key-value dimensions attached to analytics events */
+  customDimensions?: Record<string, string>;
+}
+
 /**
  * Ad request options
  */