teads-react-native 6.0.2

package/android/src/main/java/tv/teads/reactnative/TeadsPlacementContainer.java

@@ -0,0 +1,327 @@
+package tv.teads.reactnative;
+
+import android.annotation.SuppressLint;
+import android.graphics.Rect;
+import android.net.Uri;
+import android.util.Log;
+import android.view.View;
+import android.view.ViewGroup;
+import android.view.ViewTreeObserver;
+import android.widget.FrameLayout;
+
+import androidx.annotation.NonNull;
+import androidx.annotation.Nullable;
+
+import com.facebook.react.bridge.Arguments;
+import com.facebook.react.bridge.ReactContext;
+import com.facebook.react.bridge.ReadableMap;
+import com.facebook.react.bridge.WritableMap;
+import com.facebook.react.modules.core.DeviceEventManagerModule;
+import com.facebook.react.uimanager.ThemedReactContext;
+import com.facebook.react.views.view.ReactViewGroup;
+
+import java.util.Map;
+
+import tv.teads.sdk.AdRatio;
+import tv.teads.sdk.TeadsSDK;
+import tv.teads.sdk.combinedsdk.TeadsAdPlacementEventName;
+import tv.teads.sdk.combinedsdk.adplacement.TeadsAdPlacementFeed;
+import tv.teads.sdk.combinedsdk.adplacement.TeadsAdPlacementMedia;
+import tv.teads.sdk.combinedsdk.adplacement.config.TeadsAdPlacementFeedConfig;
+import tv.teads.sdk.combinedsdk.adplacement.config.TeadsAdPlacementMediaConfig;
+import tv.teads.sdk.combinedsdk.adplacement.interfaces.TeadsAdPlacementEventsDelegate;
+import tv.teads.sdk.combinedsdk.adplacement.interfaces.core.TeadsAdPlacement;
+import tv.teads.sdk.framework.WrapperFrameworkInfo;
+
+
+@SuppressLint("ViewConstructor")
+public class TeadsPlacementContainer extends ReactViewGroup implements TeadsAdPlacementEventsDelegate {
+    /**
+     * this class has two main functions:
+     *  1. connect the React Native native view interface with the Teads ad view
+     *  2. implement event handling and propagating the events up to RN
+     **/
+
+    TeadsAdPlacementFeed teadsAdPlacementFeed;
+    TeadsAdPlacementMedia teadsAdPlacementMedia;
+    FrameLayout widgetLayout;
+    ReactContext context;
+    String widgetId;
+    String pid;
+    Uri articleUrl;
+    int widgetRandomId;
+    boolean isTeadsVideoPlacement = false;
+    private volatile boolean isCleanedUp = false;
+
+    private final WritableMap initParams = Arguments.createMap();
+
+    public TeadsPlacementContainer(ReactContext context) {
+        super(context);
+        this.context = context;
+        setBackgroundColor(android.graphics.Color.TRANSPARENT);
+        configureComponent();
+    }
+
+    private void configureComponent() {
+        this.setLayoutParams(new ViewGroup.LayoutParams(
+                ViewGroup.LayoutParams.MATCH_PARENT,
+                ViewGroup.LayoutParams.MATCH_PARENT
+        ));
+    }
+
+    public void initialize(ReadableMap args) {
+        this.isTeadsVideoPlacement = args.hasKey("pid");
+        Log.i("TeadsFeedContainer", "inside initialize(): " + (isTeadsVideoPlacement ? "Teads Video Placement" : "Teads Feed Placement"));
+        if (!this.isTeadsVideoPlacement && teadsAdPlacementFeed == null) {
+            initializeTeadsFeedPlacement(args);
+        } else if (this.isTeadsVideoPlacement && teadsAdPlacementMedia == null) {
+            initializeTeadsVideoPlacement(args);
+        } else {
+            Log.d("TeadsFeedContainer", "Widget already exists — skipping creation");
+        }
+    }
+
+    private void initializeTeadsFeedPlacement(ReadableMap args) {
+        if (teadsAdPlacementFeed == null) {
+            Log.i("TeadsFeedContainer", "Initializing Feed placement with params: " + args.toString());
+            this.widgetId = args.getString("widgetId");
+            int widgetIndex = args.getInt("widgetIndex");
+            this.widgetRandomId = args.getInt("widgetRandomId");
+            String articleUrlString = args.getString("articleUrl");
+            this.articleUrl = Uri.parse(articleUrlString);
+            String installationKey = args.getString("partnerKey");
+            boolean darkMode = args.hasKey("darkMode") && args.getBoolean("darkMode");
+            String extId = args.hasKey("extId") ? args.getString("extId") : null;
+            String extSecondaryId = args.hasKey("extSecondaryId") ? args.getString("extSecondaryId") : null;
+            String pubImpId = args.hasKey("pubImpId") ? args.getString("pubImpId") : null;
+            String RN_packageVersion = args.getString("packageVersion");
+
+            initTeadsSDK(installationKey);
+            TeadsAdPlacementFeedConfig feedConfig = new TeadsAdPlacementFeedConfig(
+              this.articleUrl,
+              this.widgetId,
+              installationKey,
+              widgetIndex, // TODO: currently 2 widgets on the same page can work only if widgetIndex is 0 for both (that's a bug in the SDK)
+              null,              // userId
+              darkMode,             // darkMode
+              false,             // testDisplay
+              extId,              // extId
+              extSecondaryId,              // extSecondaryId
+              pubImpId               // obPubImpl
+            );
+            teadsAdPlacementFeed = new TeadsAdPlacementFeed(context, feedConfig,this);
+            this.widgetLayout = teadsAdPlacementFeed.loadAd();
+            commonSetupLayout();
+        }
+    }
+
+    private void initializeTeadsVideoPlacement(ReadableMap args) {
+        if (teadsAdPlacementMedia == null) {
+          try {
+            Log.i("TeadsFeedContainer", "Initializing Video placement widget with params: " + args.toString());
+            this.pid = args.getString("pid");
+            this.widgetRandomId = args.getInt("widgetRandomId");
+            String articleUrlString = args.getString("articleUrl");
+            this.articleUrl = Uri.parse(articleUrlString);
+            String installationKey = args.getString("partnerKey");
+            String RN_packageVersion = args.getString("packageVersion");
+
+            // TeadsSDK.INSTANCE.setTestMode(true);
+            TeadsSDK.INSTANCE.setWrapperFrameworkInfo(WrapperFrameworkInfo.reactNative(RN_packageVersion));
+
+            TeadsAdPlacementMediaConfig mediaConfig = new TeadsAdPlacementMediaConfig(
+              Integer.parseInt(this.pid), // test video ad placement ID
+              this.articleUrl,
+              false
+            );
+            teadsAdPlacementMedia = new TeadsAdPlacementMedia(context, mediaConfig, this);
+            this.widgetLayout = teadsAdPlacementMedia.loadAd();
+            commonSetupLayout();
+          } catch (Exception e) {
+            Log.e("TeadsFeedContainer", "Exception in initializeTeadsVideoPlacement: " + e.getLocalizedMessage());
+          }
+        }
+    }
+
+    private void commonSetupLayout() {
+        this.widgetLayout.setLayoutParams(new ViewGroup.LayoutParams(
+                LayoutParams.MATCH_PARENT,
+                ViewGroup.LayoutParams.WRAP_CONTENT
+        ));
+        
+        post(() -> {
+            addView(this.widgetLayout);
+            this.widgetLayout.requestLayout();
+            requestLayout();
+        });
+    }
+
+    private void initTeadsSDK(String installationKey) {
+      try {
+        TeadsSDK.INSTANCE.configure(this.context.getApplicationContext(), installationKey);
+        if (BuildConfig.DEBUG) {
+          TeadsSDK.INSTANCE.setTestMode(true);
+        }
+      } catch (Exception e) {
+        Log.e("TeadsFeedContainer", "Error configuring TeadsSDK: " + e.getMessage());
+      }
+    }
+
+    public void emitEvent(String eventName, ReadableMap params) {
+        context.getJSModule(DeviceEventManagerModule.RCTDeviceEventEmitter.class)
+                .emit(eventName, params);
+    }
+
+    @Override
+    protected void onLayout(boolean changed, int l, int t, int r, int b) {
+        // Layout the child view
+        if (this.widgetLayout != null) {
+          this.widgetLayout.layout(0, 0, getWidth(), getHeight());
+        }
+    }
+
+    @Override
+    protected void onMeasure(int widthMeasureSpec, int heightMeasureSpec) {
+        super.onMeasure(widthMeasureSpec, heightMeasureSpec);
+        if (this.widgetLayout != null) {
+          this.widgetLayout.measure(widthMeasureSpec, heightMeasureSpec);
+        }
+    }
+
+    @Override
+    public void requestLayout() {
+        super.requestLayout();
+        post(() -> {
+            measure(
+                    MeasureSpec.makeMeasureSpec(getWidth(), MeasureSpec.EXACTLY),
+                    MeasureSpec.makeMeasureSpec(getHeight(), MeasureSpec.EXACTLY)
+            );
+            layout(getLeft(), getTop(), getRight(), getBottom());
+        });
+    }
+
+    public void toggleDarkMode(boolean darkMode) {
+        if (this.teadsAdPlacementFeed != null) {
+          this.teadsAdPlacementFeed.toggleDarkMode(darkMode);
+        } else {
+            Log.w("TeadsFeedContainer", "Widget is not initialized, cannot toggle dark mode");
+        }
+    }
+
+    public WritableMap getInitParams() {
+        return initParams;
+    }
+
+    /**
+     * Clean up resources when the view is detached from the window
+     */
+    @Override
+    protected void onDetachedFromWindow() {
+        super.onDetachedFromWindow();
+        Log.d("TeadsFeedContainer", "onDetachedFromWindow() - widgetRandomId: " + widgetRandomId);
+        cleanup();
+    }
+    
+    @Override
+    protected void onWindowVisibilityChanged(int visibility) {
+        super.onWindowVisibilityChanged(visibility);
+        // When the window becomes invisible (GONE or INVISIBLE), the SDK should stop visibility checks
+        Log.d("TeadsFeedContainer", "onWindowVisibilityChanged() - visibility: " + visibility + ", widgetRandomId: " + widgetRandomId);
+    }
+    
+    
+    @Override
+    protected void onAttachedToWindow() {
+        super.onAttachedToWindow();
+        Log.d("TeadsFeedContainer", "onAttachedToWindow() - widgetRandomId: " + widgetRandomId);
+        if (widgetLayout != null) {
+            widgetLayout.requestLayout();
+        }
+    }
+
+    /**
+     * Clean up TeadsSDK placements and resources
+     */
+    public void cleanup() {
+        Log.d("TeadsFeedContainer", "cleanup() called - widgetRandomId: " + widgetRandomId);
+        isCleanedUp = true;
+        
+        // Clean up SDK placements first (this stops internal polling/visibility tracking)
+        if (teadsAdPlacementMedia != null) {
+            teadsAdPlacementMedia.clean();
+            teadsAdPlacementMedia = null;
+        }
+        if (teadsAdPlacementFeed != null) {
+            // TeadsAdPlacementFeed doesn't have a clean() method
+            teadsAdPlacementFeed = null;
+        }
+        
+        // Remove the widget layout to break SDK's internal references
+        if (widgetLayout != null) {
+            widgetLayout.removeAllViews();
+            removeView(widgetLayout);
+            widgetLayout = null;
+        }
+        
+        // Remove all child views from this container
+        removeAllViews();
+        
+        widgetRandomId = -1;
+        widgetId = null;
+        pid = null;
+        articleUrl = null;
+    }
+
+  @Override
+  public void onPlacementEvent(@NonNull TeadsAdPlacement<?, ?> teadsAdPlacement, @NonNull TeadsAdPlacementEventName teadsAdPlacementEventName, @Nullable Map<String, ?> map) {
+    // Guard against events after cleanup
+    if (isCleanedUp) {
+      Log.d("TeadsFeedContainer", "Ignoring event after cleanup: " + teadsAdPlacementEventName.name());
+      return;
+    }
+    if (teadsAdPlacementEventName == TeadsAdPlacementEventName.CLICKED) {
+      Log.d("TeadsFeedContainer", "Teads Ad Placement Clicked - widgetId: " + widgetId);
+      WritableMap params = Arguments.createMap();
+      String url = map != null && map.get("url") instanceof String ? (String) map.get("url") : "";
+      emitClickEvent("onRecClick", url);
+    } else if (teadsAdPlacementEventName == TeadsAdPlacementEventName.CLICKED_ORGANIC) {
+      Log.d("TeadsFeedContainer", "Teads Ad Placement Clicked Organic - widgetId: " + widgetId);
+      WritableMap params = Arguments.createMap();
+      String url = map != null && map.get("url") instanceof String ? (String) map.get("url") : "";
+      // prepare JS parameters to send with the event
+      emitClickEvent("onOrganicClick", url);
+    } else if (teadsAdPlacementEventName == TeadsAdPlacementEventName.HEIGHT_UPDATED) {
+      Log.d("TeadsFeedContainer", "Teads Ad Placement Height Updated; map: " + (map != null ? map.toString() : "null"));
+      int newHeight = 0;
+      if (map != null && map.get("adRatio") instanceof AdRatio) {
+        AdRatio adRatio = (AdRatio) map.get("adRatio");
+        int widthDP = (int)(this.widgetLayout.getWidth() / getResources().getDisplayMetrics().density);
+        newHeight = adRatio.calculateHeight(widthDP);
+        Log.d("TeadsFeedContainer", "Teads Ad Placement Height Updated - ad ratio: calculateHeight: " + newHeight + ", width: " + widthDP + ", widgetId: " + widgetId);
+      }
+      if (map != null && map.get("height") instanceof Integer) {
+        newHeight = (Integer) map.get("height");
+        Log.d("TeadsFeedContainer", "Teads Ad Placement Height Updated - new height: " + newHeight + ", widgetId: " + widgetId);
+      }
+      if (newHeight > 0) {
+        WritableMap params = Arguments.createMap();
+        params.putString("widgetId", widgetId);
+        params.putInt("widgetRandomId", widgetRandomId);
+        params.putInt("height", newHeight);
+        emitEvent("didChangeHeight", params);
+      }
+    } else {
+      Log.d("TeadsFeedContainer", "Teads Ad Placement Event: " + teadsAdPlacementEventName.name() + ", params: " + (map != null ? map.toString() : "null"));
+    }
+
+  }
+
+  private void emitClickEvent(String eventName, String clickUrl) {
+    WritableMap params = Arguments.createMap();
+    params.putString("widgetId", widgetId);
+    params.putInt("widgetRandomId", widgetRandomId);
+    params.putString("url", clickUrl);
+    emitEvent(eventName, params);
+  }
+}
+

package/android/src/main/java/tv/teads/reactnative/Utils.java

@@ -0,0 +1,65 @@
+package tv.teads.reactnative;
+
+import com.facebook.react.bridge.Arguments;
+import com.facebook.react.bridge.WritableArray;
+import com.facebook.react.bridge.WritableMap;
+import com.google.gson.Gson;
+import com.google.gson.reflect.TypeToken;
+
+import org.json.JSONObject;
+
+import java.util.List;
+import java.util.Map;
+
+public class Utils {
+    public static WritableMap convertJsonObjectToWritableMap(JSONObject jsonObject) {
+        Gson gson = new Gson();
+        Map<String, Object> map = gson.fromJson(jsonObject.toString(), new TypeToken<Map<String, Object>>(){}.getType());
+        return convertMapToWritableMap(map);
+    }
+    private static WritableMap convertMapToWritableMap(Map<String, Object> map) {
+        WritableMap writableMap = Arguments.createMap();
+        for (Map.Entry<String, Object> entry : map.entrySet()) {
+            String key = entry.getKey();
+            Object value = entry.getValue();
+            if (value instanceof Boolean) {
+                writableMap.putBoolean(key, (Boolean) value);
+            } else if (value instanceof Integer) {
+                writableMap.putInt(key, (Integer) value);
+            } else if (value instanceof Double) {
+                writableMap.putDouble(key, (Double) value);
+            } else if (value instanceof String) {
+                writableMap.putString(key, (String) value);
+            } else if (value instanceof Map) {
+                writableMap.putMap(key, convertMapToWritableMap((Map<String, Object>) value));
+            } else if (value instanceof List) {
+                writableMap.putArray(key, convertListToWritableArray((List) value));
+            } else if (value == null) {
+                writableMap.putNull(key);
+            }
+        }
+        return writableMap;
+    }
+
+    private static WritableArray convertListToWritableArray(List list) {
+        WritableArray writableArray = Arguments.createArray();
+        for (Object item : list) {
+            if (item instanceof Boolean) {
+                writableArray.pushBoolean((Boolean) item);
+            } else if (item instanceof Integer) {
+                writableArray.pushInt((Integer) item);
+            } else if (item instanceof Double) {
+                writableArray.pushDouble((Double) item);
+            } else if (item instanceof String) {
+                writableArray.pushString((String) item);
+            } else if (item instanceof Map) {
+                writableArray.pushMap(convertMapToWritableMap((Map<String, Object>) item));
+            } else if (item instanceof List<?>) {
+                writableArray.pushArray(convertListToWritableArray((List) item));
+            } else if (item == null) {
+                writableArray.pushNull();
+            }
+        }
+        return writableArray;
+    }
+}

package/ios/RCTTeadsAdPlacementFeed.h

@@ -0,0 +1,22 @@
+//
+//  RCTTeadsAdPlacementFeed.h
+//  TeadsReactNative
+//
+//  Created by Ofek Cohen on 03/04/2025.
+//
+
+#import <UIKit/UIKit.h>
+#import <React/RCTViewComponentView.h>
+#import <React/RCTComponent.h>
+
+
+NS_ASSUME_NONNULL_BEGIN
+
+@interface RCTTeadsAdPlacementFeed : RCTViewComponentView
+
+// You would declare native methods you'd want to access from the view here
+
+@end
+
+NS_ASSUME_NONNULL_END
+

package/ios/RCTTeadsAdPlacementFeed.mm

@@ -0,0 +1,114 @@
+//
+//  RCTTeadsAdPlacementFeed.mm
+//  TeadsReactNative
+//
+//  Created by Ofek Cohen on 03/04/2025.
+//
+
+#import "RCTTeadsAdPlacementFeed.h"
+#import "RCTAppDelegate.h"
+#import <WebKit/WebKit.h>
+#import "TeadsSDK/TeadsSDK-Swift.h"
+
+#import "TeadsReactNative-Swift.h" // auto-generated file that enables the Objective-C code to use the Swift code.
+
+#import "generated/RNTeadsReactNativeViewSpec/ComponentDescriptors.h"
+#import "generated/RNTeadsReactNativeViewSpec/EventEmitters.h"
+#import "generated/RNTeadsReactNativeViewSpec/Props.h"
+#import "generated/RNTeadsReactNativeViewSpec/RCTComponentViewHelpers.h"
+
+using namespace facebook::react;
+
+@interface RCTTeadsAdPlacementFeed ()
+@end
+
+@implementation RCTTeadsAdPlacementFeed {
+  TeadsAdContainer *widgetView;
+  BOOL _initialPropsSet;
+}
+
+
+- (instancetype)init {
+  if (self = [super init]) {
+    _initialPropsSet = NO;
+  }
+  return self;
+}
+
+- (void)prepareForRecycle {
+  [super prepareForRecycle];
+  // Reset state for view recycling - cleanup the widget container
+  if (widgetView != nil) {
+    [(TeadsAdContainer *)widgetView cleanup];
+    [widgetView removeFromSuperview];
+    widgetView = nil;
+  }
+  _initialPropsSet = NO;
+}
+
+
+- (void)layoutSubviews {
+  [super layoutSubviews];
+  widgetView.frame = self.bounds;
+}
+
+
+- (void)updateProps:(Props::Shared const &)props oldProps:(Props::Shared const &)oldProps
+{
+  const auto &newViewProps = *std::static_pointer_cast<const TeadsAdPlacementFeedProps>(props);
+
+  NSString *widgetId = [NSString stringWithCString:newViewProps.widgetId.c_str() encoding:NSUTF8StringEncoding];
+  NSInteger widgetRandomId = newViewProps.widgetRandomId;
+  NSInteger widgetIndex = newViewProps.widgetIndex;
+  NSString *url = [NSString stringWithCString:newViewProps.url.c_str() encoding:NSUTF8StringEncoding];
+  NSString *installationKey = [NSString stringWithCString:newViewProps.installationKey.c_str() encoding:NSUTF8StringEncoding];
+  NSString *packageVersion = [NSString stringWithCString:newViewProps.packageVersion.c_str() encoding:NSUTF8StringEncoding];
+  NSString *extId = newViewProps.extId.empty() ? nil : [NSString stringWithCString:newViewProps.extId.c_str() encoding:NSUTF8StringEncoding];
+  NSString *extSecondaryId = newViewProps.extSecondaryId.empty() ? nil : [NSString stringWithCString:newViewProps.extSecondaryId.c_str() encoding:NSUTF8StringEncoding];
+  NSString *userId = newViewProps.userId.empty() ? nil : [NSString stringWithCString:newViewProps.userId.c_str() encoding:NSUTF8StringEncoding];
+  NSString *pubImpId = newViewProps.pubImpId.empty() ? nil : [NSString stringWithCString:newViewProps.pubImpId.c_str() encoding:NSUTF8StringEncoding];
+  BOOL darkMode = newViewProps.darkMode;
+
+
+  if (widgetView == nil) {
+    widgetView = [[TeadsAdContainer alloc] initWithFrame:self.bounds];
+    widgetView.autoresizingMask = UIViewAutoresizingFlexibleWidth | UIViewAutoresizingFlexibleHeight;
+    [self addSubview:widgetView];
+  }
+  
+
+  // call configure with widget props only once, prevents rerendering
+  if (!_initialPropsSet) {
+    _initialPropsSet = YES;
+    [(TeadsAdContainer *)widgetView configureWithWidgetId:widgetId
+                                            widgetRandomId:widgetRandomId
+                                               widgetIndex:widgetIndex
+                                                       url:url
+                                           installationKey:installationKey
+                                            packageVersion:packageVersion
+                                                     extId:extId
+                                            extSecondaryId:extSecondaryId
+                                                    userId:userId
+                                                  pubImpId:pubImpId
+                                                  darkMode:darkMode];
+  }
+  else if (oldProps != nullptr) {
+    const auto &oldViewProps = *std::static_pointer_cast<const TeadsAdPlacementFeedProps>(oldProps);
+    if (newViewProps.darkMode != oldViewProps.darkMode) {
+      [(TeadsAdContainer *)widgetView toggleDarkMode:newViewProps.darkMode];
+    }
+  }
+
+  [super updateProps:props oldProps:oldProps];
+}
+
+
++ (ComponentDescriptorProvider)componentDescriptorProvider
+{
+  return concreteComponentDescriptorProvider<TeadsAdPlacementFeedComponentDescriptor>();
+}
+
+
+
+@end
+

package/ios/RCTTeadsAdPlacementMedia.h

@@ -0,0 +1,23 @@
+//
+//  RCTTeadsAdPlacementMedia.h
+//  TeadsReactNative
+//
+//  Created by Oded Regev on 10/11/2025.
+//
+
+#import <UIKit/UIKit.h>
+#import <React/RCTViewComponentView.h>
+#import <React/RCTComponent.h>
+//#import <OutbrainSDK/OutbrainSDK.h>
+
+
+NS_ASSUME_NONNULL_BEGIN
+
+@interface RCTTeadsAdPlacementMedia : RCTViewComponentView
+
+// You would declare native methods you'd want to access from the view here
+
+@end
+
+NS_ASSUME_NONNULL_END
+

package/ios/RCTTeadsAdPlacementMedia.mm

@@ -0,0 +1,91 @@
+//
+//  RCTTeadsAdPlacementMedia.mm
+//  TeadsReactNative
+//
+//  Created by Ofek Cohen on 03/04/2025.
+//
+
+#import "RCTTeadsAdPlacementMedia.h"
+#import "RCTAppDelegate.h"
+#import <WebKit/WebKit.h>
+#import "TeadsSDK/TeadsSDK-Swift.h"
+
+#import "TeadsReactNative-Swift.h" // auto-generated file that enables the Objective-C code to use the Swift code.
+
+#import "generated/RNTeadsReactNativeViewSpec/ComponentDescriptors.h"
+#import "generated/RNTeadsReactNativeViewSpec/EventEmitters.h"
+#import "generated/RNTeadsReactNativeViewSpec/Props.h"
+#import "generated/RNTeadsReactNativeViewSpec/RCTComponentViewHelpers.h"
+
+using namespace facebook::react;
+
+@interface RCTTeadsAdPlacementMedia ()
+@end
+
+@implementation RCTTeadsAdPlacementMedia {
+  TeadsAdContainer *widgetView;
+  BOOL _initialPropsSet;
+}
+
+
+- (instancetype)init {
+  if (self = [super init]) {
+    _initialPropsSet = NO;
+  }
+  return self;
+}
+
+- (void)prepareForRecycle {
+  [super prepareForRecycle];
+  // Reset state for view recycling - cleanup the widget container
+  if (widgetView != nil) {
+    [(TeadsAdContainer *)widgetView cleanup];
+    [widgetView removeFromSuperview];
+    widgetView = nil;
+  }
+  _initialPropsSet = NO;
+}
+
+
+- (void)layoutSubviews {
+  [super layoutSubviews];
+  widgetView.frame = self.bounds;
+}
+
+
+- (void)updateProps:(Props::Shared const &)props oldProps:(Props::Shared const &)oldProps
+{
+  const auto &newViewProps = *std::static_pointer_cast<const TeadsAdPlacementMediaProps>(props);
+  const auto &oldViewProps = *std::static_pointer_cast<const TeadsAdPlacementMediaProps>(oldProps);
+  
+  NSString *pid = [NSString stringWithCString:newViewProps.pid.c_str() encoding:NSUTF8StringEncoding];
+  NSInteger widgetRandomId = newViewProps.widgetRandomId;
+  NSString *url = [NSString stringWithCString:newViewProps.url.c_str() encoding:NSUTF8StringEncoding];
+  NSString *installationKey = [NSString stringWithCString:newViewProps.installationKey.c_str() encoding:NSUTF8StringEncoding];
+  NSString *packageVersion = [NSString stringWithCString:newViewProps.packageVersion.c_str() encoding:NSUTF8StringEncoding];
+  
+
+  if (widgetView == nil) {
+    widgetView = [[TeadsAdContainer alloc] initWithFrame:self.bounds];
+    widgetView.autoresizingMask = UIViewAutoresizingFlexibleWidth | UIViewAutoresizingFlexibleHeight;
+    [self addSubview:widgetView];
+  }
+  
+  // call configure with widget props only once, prevents rerendering
+  if (!_initialPropsSet) {
+    _initialPropsSet = YES;
+    [(TeadsAdContainer *)widgetView configureWithPid:pid widgetRandomId:widgetRandomId url:url installationKey:installationKey packageVersion:packageVersion];
+  }
+  
+  [super updateProps:props oldProps:oldProps];
+}
+
+
++ (ComponentDescriptorProvider)componentDescriptorProvider
+{
+  return concreteComponentDescriptorProvider<TeadsAdPlacementMediaComponentDescriptor>();
+}
+
+
+
+@end