@advergic-ads/react-native-sdk 1.0.0

package/AdvergicReactNative.podspec

@@ -0,0 +1,32 @@
+require "json"
+
+package = JSON.parse(File.read(File.join(__dir__, "package.json")))
+
+Pod::Spec.new do |s|
+  s.name         = "AdvergicReactNative"
+  s.version      = package["version"]
+  s.summary      = package["description"]
+  s.homepage     = package["homepage"]
+  s.license      = package["license"]
+  s.author       = package["author"]
+  s.platforms    = { :ios => "15.0" }
+  s.source       = { :git => "https://github.com/advergic/react-native-sdk.git", :tag => "#{s.version}" }
+
+  s.source_files = "ios/**/*.{h,m,mm,swift}"
+  s.swift_version = "5.0"
+  s.requires_arc = true
+
+  # React Native core
+  s.dependency "React-Core"
+
+  # Native Advergic iOS SDK. It is NOT on the CocoaPods trunk — it is published
+  # via a podspec hosted at app.advergic.com (which always serves the latest
+  # version). The consuming app must therefore add the following line to its
+  # Podfile so CocoaPods can resolve this dependency:
+  #
+  #   pod 'AdvergicSDK', :podspec => 'https://app.advergic.com/ios/sdk/AdvergicSDK.podspec'
+  #
+  # A `>=` floor (not `~>`) is used so future releases served at that single,
+  # always-latest podspec URL keep resolving.
+  s.dependency "AdvergicSDK", ">= 0.1.4"
+end

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Advergic
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,329 @@
+# Getting Started with Advergic React Native SDK
+
+Welcome! This guide will help you integrate mobile advertising into your React Native app in just a few minutes.
+
+## 📋 Prerequisites
+
+- **React Native**: 0.85.3 or higher
+- **Node.js**: 18.0 or higher
+- **Android**: API 24+ (Android 7.0) for Android apps
+- **iOS**: 15.0+ for iOS apps
+- **API Key**: Get one from [app.advergic.com](https://app.advergic.com)
+
+## 🚀 5-Minute Setup
+
+### Step 1: Install the SDK
+
+```bash
+npm install @advergic-ads/react-native-sdk
+```
+
+or with Yarn:
+
+```bash
+yarn add @advergic-ads/react-native-sdk
+```
+
+### Step 2: Android Setup (One Line!)
+
+Add your Google Ads Application ID to `android/app/src/main/AndroidManifest.xml`:
+
+```xml
+<application>
+  <meta-data
+    android:name="com.google.android.gms.ads.APPLICATION_ID"
+    android:value="ca-app-pub-xxxxxxxxxxxxxxxx~yyyyyyyyyy" />
+</application>
+```
+
+Get your ID from [AdMob Console](https://admob.google.com).
+
+**That's it!** React Native auto-linking handles the rest.
+
+### Step 3: iOS Setup
+
+The React Native module is auto-linked, but the native `AdvergicSDK` is **not**
+published on the CocoaPods trunk — it ships from Advergic's own podspec. Add
+that one line to your `Podfile` (alongside the iOS 15.0 deployment target),
+then install:
+
+```ruby
+# ios/Podfile
+platform :ios, '15.0'
+
+target 'YourApp' do
+  # ...existing config (use_react_native! etc.)...
+
+  # Required: makes the native Advergic iOS SDK resolvable by CocoaPods.
+  pod 'AdvergicSDK', :podspec => 'https://app.advergic.com/ios/sdk/AdvergicSDK.podspec'
+end
+```
+
+```bash
+cd ios && pod install && cd ..
+```
+
+Once that line is present, CocoaPods resolves `AdvergicReactNative` (auto-linked)
+and its `AdvergicSDK` dependency, and pulls in Google Mobile Ads automatically.
+Prebid is bundled inside the `AdvergicSDK` framework.
+
+> **Why the extra line?** CocoaPods can only resolve a pod's dependencies from
+> the trunk or from sources declared in *your* `Podfile`. Since `AdvergicSDK` is
+> distributed via a hosted podspec rather than the trunk, the consuming app must
+> point CocoaPods at it. The hosted URL always serves the latest SDK version.
+
+> **Note:** iOS supports banner, interstitial, rewarded, and app-open ads.
+> Native ads are currently Android-only.
+
+### Step 4: Initialize in Your App
+
+```tsx
+import React, { useEffect } from "react";
+import Advergic from "@advergic-ads/react-native-sdk";
+
+export default function App() {
+  useEffect(() => {
+    // Initialize the SDK on app launch
+    Advergic.initialize("YOUR_API_KEY").then((initialized) => {
+      if (initialized) {
+        console.log("✓ Advergic SDK ready!");
+      }
+    });
+  }, []);
+
+  return (
+    // Your app content
+  );
+}
+```
+
+### Step 5: Add Your First Banner Ad
+
+```tsx
+import { AdvergicBannerAd } from "@advergic-ads/react-native-sdk";
+
+export default function Home() {
+  return (
+    <View>
+      {/* Your content */}
+      
+      <AdvergicBannerAd
+        adUnitId="/23315275002/home_banner_320x50_ad_unit_id"
+        style={{ width: 320, height: 50, alignSelf: "center" }}
+        onAdLoaded={() => console.log("Ad loaded!")}
+        onAdFailedToLoad={(error) => console.error("Ad failed:", error)}
+      />
+    </View>
+  );
+}
+```
+
+That's it! You now have banner ads running. 🎉
+
+---
+
+## 📦 Ad Formats
+
+The SDK supports 4 ad formats:
+
+### 1. **Banner Ads** ✓ Easiest
+
+Rectangular ads that display inline with your content.
+
+```tsx
+<AdvergicBannerAd
+  adUnitId="/YOUR_NETWORK_ID/YOUR_BANNER_AD_UNIT"
+  style={{ width: 320, height: 50 }}
+/>
+```
+
+**Common sizes:**
+- `320x50` — Standard mobile banner
+- `300x250` — Medium rectangle
+- `320x100` — Large banner
+- `300x600` — Half page
+
+### 2. **Interstitial Ads** — Full Screen
+
+Full-screen ads shown between content (e.g., between game levels, after article read).
+
+```tsx
+import Advergic from "@advergic-ads/react-native-sdk";
+
+// Show when appropriate
+Advergic.showInterstitialAd("/YOUR_NETWORK_ID/YOUR_INTERSTITIAL_AD_UNIT");
+
+// Listen for close
+Advergic.onInterstitialAdClosed(() => {
+  console.log("User closed the ad");
+});
+```
+
+### 3. **Rewarded Ads** — Earn Points
+
+Video ads that reward users for watching (unlock premium, earn coins, etc.).
+
+```tsx
+// Show when user wants premium content
+Advergic.showRewardedAd("/YOUR_NETWORK_ID/YOUR_REWARDED_AD_UNIT");
+
+// Listen for reward grant
+Advergic.onRewardedAdUserEarnedReward(() => {
+  unlockPremiumContent();
+});
+```
+
+### 4. **Native Ads** — Custom Design
+
+Get ad data and render it your own way.
+
+```tsx
+const nativeAd = await Advergic.loadNativeAd("/YOUR_NETWORK_ID/YOUR_NATIVE_AD_UNIT");
+
+return (
+  <View>
+    <Image source={{ uri: nativeAd.mainImage }} />
+    <Text>{nativeAd.title}</Text>
+    <Button title={nativeAd.callToAction} />
+  </View>
+);
+```
+
+---
+
+## 📱 Your First Complete App
+
+Here's a minimal app with both banner and interstitial ads:
+
+```tsx
+import React, { useEffect, useState } from "react";
+import { View, Text, Button, StyleSheet, ScrollView } from "react-native";
+import Advergic, { AdvergicBannerAd } from "@advergic-ads/react-native-sdk";
+
+const API_KEY = "YOUR_API_KEY";
+
+export default function App() {
+  const [initialized, setInitialized] = useState(false);
+
+  useEffect(() => {
+    // Initialize SDK
+    Advergic.initialize(API_KEY).then(setInitialized);
+
+    // Listen for interstitial close
+    const sub = Advergic.onInterstitialAdClosed(() => {
+      console.log("Interstitial closed");
+    });
+
+    return () => sub.remove();
+  }, []);
+
+  const showInterstitial = () => {
+    if (initialized) {
+      Advergic.showInterstitialAd(
+        "/23315275002/start_game_interstitial_ad_unit_id"
+      );
+    }
+  };
+
+  return (
+    <ScrollView style={styles.container}>
+      <Text style={styles.title}>My App</Text>
+
+      {/* Top banner ad */}
+      <AdvergicBannerAd
+        adUnitId="/23315275002/home_banner_320x50_ad_unit_id"
+        style={{ width: 320, height: 50, alignSelf: "center" }}
+      />
+
+      {/* App content */}
+      <Text style={styles.text}>Welcome to your app!</Text>
+
+      <Button
+        title="Show Interstitial Ad"
+        onPress={showInterstitial}
+        disabled={!initialized}
+      />
+
+      {/* Bottom banner ad */}
+      <AdvergicBannerAd
+        adUnitId="/23315275002/home_screen_top_banner_video_300x250_ad_unit_id"
+        style={{ width: 300, height: 250, alignSelf: "center", marginVertical: 20 }}
+      />
+    </ScrollView>
+  );
+}
+
+const styles = StyleSheet.create({
+  container: { flex: 1, padding: 20, backgroundColor: "#f5f5f5" },
+  title: { fontSize: 28, fontWeight: "bold", marginBottom: 20 },
+  text: { fontSize: 16, marginBottom: 20, color: "#333" },
+});
+```
+
+---
+
+## 🔑 Getting Your API Key & Ad Unit IDs
+
+1. Sign up at [app.advergic.com](https://app.advergic.com)
+2. Create a new app
+3. Copy your **API Key** (use in `Advergic.initialize()`)
+4. Go to **Inventory → Ad Units** to create ad units
+5. Copy the **Ad Unit IDs** and use them in your components
+
+---
+
+## 🐛 Troubleshooting
+
+### "Banner is blank"
+- Ensure `Advergic.initialize()` is called before rendering banners
+- Check that the app has internet access
+- Verify the ad unit ID is correct
+- Add `onAdFailedToLoad` callback to see error details
+
+### "Interstitial doesn't show"
+- Make sure you're using the correct ad unit ID (should be an interstitial, not banner)
+- Call `showInterstitialAd()` after the app is initialized
+- Some devices may not have ads available; add error handling
+
+### "Module not found" on Android
+- Run `npm install` again
+- Try `npm start -- --reset-cache` to clear React Native cache
+- Delete `node_modules` and reinstall if still broken
+
+### Debug Mode
+
+Enable verbose logging in Android logcat:
+
+```bash
+adb logcat | grep -E "Advergic|Banner"
+```
+
+---
+
+## 📚 Next Steps
+
+- **Read the full docs**: [README.md](./README.md)
+- **Check examples**: [examples/dramafy/](./examples/dramafy/)
+- **API Reference**: [README.md → API Reference](./README.md#api-reference)
+- **Troubleshooting**: [README.md → Troubleshooting](./README.md#troubleshooting)
+
+---
+
+## 💡 Tips
+
+✅ **Do:**
+- Use fixed pixel dimensions for banner size (not percentages)
+- Initialize SDK early in your app lifecycle
+- Test with your own app before going live
+- Monitor fill rates in the dashboard
+
+❌ **Don't:**
+- Change ad unit IDs frequently (disrupts analytics)
+- Show multiple ads simultaneously in the same location
+- Initialize the SDK multiple times
+
+---
+
+## 🤝 Need Help?
+
+- **Email**: hello@advergic.com

package/android/advergic-bridge/build.gradle

@@ -0,0 +1,58 @@
+plugins {
+    id 'com.android.library'
+    id 'org.jetbrains.kotlin.android'
+}
+
+android {
+    namespace 'com.advergic.reactnative'
+    compileSdk 35
+
+    defaultConfig {
+        minSdk 24
+        targetSdk 35
+    }
+
+    compileOptions {
+        sourceCompatibility JavaVersion.VERSION_17
+        targetCompatibility JavaVersion.VERSION_17
+    }
+}
+
+repositories {
+    flatDir {
+        // Try multiple locations for the AAR
+        dirs file("${projectDir}/libs")
+        dirs file("${projectDir.absolutePath}/../libs")
+        dirs file("${rootDir}/app/libs")
+        dirs file(rootDir).parentFile.absolutePath + "/node_modules/@advergic/advergic-react-native/android/libs"
+    }
+}
+
+dependencies {
+    api(name: 'advergic-sdk', ext: 'aar')
+
+    // React Native
+    compileOnly 'com.facebook.react:react-android'
+    compileOnly 'com.facebook.react:react-native'
+
+    // AndroidX and Lifecycle
+    api 'androidx.lifecycle:lifecycle-livedata-ktx:2.9.0'
+    api 'androidx.lifecycle:lifecycle-runtime-ktx:2.9.0'
+    api 'androidx.room:room-runtime:2.7.0'
+    api 'androidx.room:room-ktx:2.7.0'
+
+    // Google Play Services and Material
+    api 'com.google.android.material:material:1.9.0'
+    api 'com.google.code.gson:gson:2.10.1'
+    api 'com.google.android.gms:play-services-ads:24.6.0'
+    api 'com.google.android.gms:play-services-ads-identifier:18.2.0'
+
+    // Third-party libraries
+    api 'com.applovin:applovin-sdk:13.2.0'
+    api 'com.squareup.retrofit2:retrofit:2.9.0'
+    api 'com.squareup.retrofit2:converter-gson:2.9.0'
+    api 'com.squareup.okhttp3:okhttp:4.11.0'
+    api 'com.github.bumptech.glide:glide:4.15.1'
+    api 'io.opentelemetry:opentelemetry-api:1.42.1'
+    api 'androidx.multidex:multidex:2.0.1'
+}

package/android/advergic-bridge/src/main/java/com/advergic/reactnative/AdvergicBannerViewManager.kt

@@ -0,0 +1,194 @@
+package com.advergic.reactnative
+
+import android.app.Activity
+import android.util.Log
+import android.view.View
+import android.view.ViewTreeObserver
+import android.widget.FrameLayout
+import com.advergic.sdk.core.AdvergicSdk
+import com.advergic.sdk.interfaces.BannerAdCallback
+import com.facebook.react.bridge.Arguments
+import com.facebook.react.bridge.ReadableArray
+import com.facebook.react.bridge.WritableMap
+import com.facebook.react.uimanager.SimpleViewManager
+import com.facebook.react.uimanager.ThemedReactContext
+import com.facebook.react.uimanager.UIManagerHelper
+import com.facebook.react.uimanager.annotations.ReactProp
+import com.facebook.react.uimanager.events.Event
+import com.facebook.react.uimanager.events.RCTEventEmitter
+
+private const val TAG = "AdvergicBanner"
+
+class AdvergicBannerViewManager : SimpleViewManager<FrameLayout>() {
+
+    companion object {
+        const val REACT_CLASS = "AdvergicBannerView"
+        private const val COMMAND_LOAD_AD = "loadAd"
+    }
+
+    override fun getName(): String = REACT_CLASS
+
+    override fun createViewInstance(reactContext: ThemedReactContext): FrameLayout {
+        return AdvergicBannerContainerView(reactContext)
+    }
+
+    @ReactProp(name = "adUnitId")
+    fun setAdUnitId(view: FrameLayout, adUnitId: String?) {
+        if (view is AdvergicBannerContainerView && adUnitId != null) {
+            view.setAdUnitId(adUnitId)
+        }
+    }
+
+    override fun getExportedCustomBubblingEventTypeConstants(): Map<String, Any>? {
+        return mapOf(
+            "onAdLoaded" to mapOf("phasedRegistrationNames" to mapOf("bubbled" to "onAdLoaded")),
+            "onAdFailedToLoad" to mapOf("phasedRegistrationNames" to mapOf("bubbled" to "onAdFailedToLoad")),
+            "onAdClicked" to mapOf("phasedRegistrationNames" to mapOf("bubbled" to "onAdClicked")),
+            "onAdImpression" to mapOf("phasedRegistrationNames" to mapOf("bubbled" to "onAdImpression"))
+        )
+    }
+
+    override fun receiveCommand(view: FrameLayout, commandId: String, args: ReadableArray?) {
+        if (COMMAND_LOAD_AD == commandId && view is AdvergicBannerContainerView) {
+            view.loadAd()
+        }
+    }
+
+    class AdvergicBannerContainerView(private val reactContext: ThemedReactContext) : FrameLayout(reactContext) {
+
+        private var adUnitId: String? = null
+        private var adLoaded = false
+        private var hasLoadedAd = false
+        private var loadRetries = 0
+        private val maxLoadRetries = 10
+
+        fun setAdUnitId(id: String) {
+            adUnitId = id
+            if (!hasLoadedAd) {
+                loadAd()
+            }
+        }
+
+        fun loadAd() {
+            val activity = reactContext.currentActivity
+            Log.d(TAG, "loadAd called - activity=$activity, adUnitId=$adUnitId, viewId=$id")
+
+            if (activity == null || adUnitId == null) {
+                Log.e(TAG, "Cannot load ad: activity=$activity, adUnitId=$adUnitId")
+                return
+            }
+
+            hasLoadedAd = true
+            activity.runOnUiThread {
+                loadAdWithRetry(activity)
+            }
+        }
+
+        private fun loadAdWithRetry(activity: Activity) {
+            try {
+                Log.d(TAG, "Calling showBannerAd for $adUnitId (attempt ${loadRetries + 1})")
+                AdvergicSdk.showBannerAd(activity, adUnitId!!, this, object : BannerAdCallback {
+                        override fun onAdLoaded() {
+                            Log.d(TAG, "Banner ad loaded: $adUnitId")
+                            adLoaded = true
+                            post { forceLayoutPass() }
+                            postDelayed({
+                                applyCreativeSizeFixOnAllChildren()
+                                forceLayoutPass()
+                                sendEvent("onAdLoaded", null)
+                            }, 100)
+                        }
+
+                        override fun onAdFailedToLoad(e: String) {
+                            Log.e(TAG, "Banner ad failed: $adUnitId - $e")
+                            if (e.contains("not initialized", ignoreCase = true) && loadRetries < maxLoadRetries) {
+                                loadRetries++
+                                postDelayed({ loadAdWithRetry(activity) }, 300L * loadRetries)
+                                Log.d(TAG, "Retrying ad load in ${300L * loadRetries}ms")
+                            } else {
+                                sendEvent("onAdFailedToLoad", createErrorMap(e))
+                            }
+                        }
+
+                        override fun onAdClicked() {
+                            Log.d(TAG, "Banner ad clicked: $adUnitId")
+                            sendEvent("onAdClicked", null)
+                        }
+
+                        override fun onAdImpression() {
+                            Log.d(TAG, "Banner ad impression: $adUnitId")
+                            sendEvent("onAdImpression", null)
+                        }
+                    })
+                } catch (e: Exception) {
+                    Log.e(TAG, "Exception calling showBannerAd: ${e.message}", e)
+                    sendEvent("onAdFailedToLoad", createErrorMap(e.message ?: "Unknown error"))
+                }
+        }
+
+        private fun createErrorMap(error: String): WritableMap {
+            val map = Arguments.createMap()
+            map.putString("error", error)
+            return map
+        }
+
+        private inner class BannerAdEvent(
+            val eventNameValue: String,
+            val params: WritableMap?
+        ) : Event<BannerAdEvent>(id) {
+            override fun getEventName() = eventNameValue
+            override fun dispatch(rctEventEmitter: RCTEventEmitter) {
+                rctEventEmitter.receiveEvent(id, eventNameValue, params)
+            }
+        }
+
+        private fun sendEvent(eventName: String, params: WritableMap?) {
+            val eventDispatcher = UIManagerHelper.getEventDispatcher(reactContext)
+            if (eventDispatcher != null) {
+                eventDispatcher.dispatchEvent(BannerAdEvent(eventName, params))
+            }
+        }
+
+        private fun dpToPx(dp: Int): Int {
+            return (dp * resources.displayMetrics.density).toInt()
+        }
+
+        private fun forceLayoutPass() {
+            val w = width
+            val h = height
+            if (w <= 0 || h <= 0) return
+            measure(MeasureSpec.makeMeasureSpec(w, MeasureSpec.EXACTLY),
+                    MeasureSpec.makeMeasureSpec(h, MeasureSpec.EXACTLY))
+            layout(0, 0, w, h)
+        }
+
+        private fun applyCreativeSizeFixOnAllChildren() {
+            for (i in 0 until childCount) {
+                applyCreativeSizeFix(getChildAt(i), 0)
+            }
+        }
+
+        private fun applyCreativeSizeFix(view: View?, attempt: Int) {
+            if (view == null) return
+            if (attempt > 10) return
+
+            val w = view.width
+            val h = view.height
+
+            if (w > 0 && h > dpToPx(10)) {
+                measure(MeasureSpec.makeMeasureSpec(w, MeasureSpec.EXACTLY),
+                        MeasureSpec.makeMeasureSpec(h, MeasureSpec.EXACTLY))
+                layout(0, 0, w, h)
+                return
+            }
+
+            view.viewTreeObserver.addOnPreDrawListener(object : ViewTreeObserver.OnPreDrawListener {
+                override fun onPreDraw(): Boolean {
+                    view.viewTreeObserver.removeOnPreDrawListener(this)
+                    applyCreativeSizeFix(view, attempt + 1)
+                    return true
+                }
+            })
+        }
+    }
+}