adwhale-sdk-react-native 2.7.204 → 2.7.300

package/android/src/main/java/com/adwhalesdkreactnative/RNAdWhaleMediationAdSettingModule.java

@@ -3,26 +3,40 @@ package com.adwhalesdkreactnative;
 import android.app.Activity;
 import android.util.Log;
 
+import androidx.annotation.NonNull;
 import androidx.annotation.Nullable;
 
+import com.adwhalesdkreactnative.common.RNMethodArgConst;
+import com.adwhalesdkreactnative.common.RNMethodCallConst;
+import com.adwhalesdkreactnative.common.RNMethodResultConst;
 import com.facebook.react.bridge.Arguments;
 import com.facebook.react.bridge.Promise;
 import com.facebook.react.bridge.ReactApplicationContext;
 import com.facebook.react.bridge.ReactMethod;
+import com.facebook.react.bridge.ReadableArray;
+import com.facebook.react.bridge.ReadableType;
 import com.facebook.react.bridge.WritableMap;
 import com.facebook.react.module.annotations.ReactModule;
 
 import net.adwhale.sdk.mediation.ads.AdWhaleMediationAds;
 import net.adwhale.sdk.mediation.ads.AdWhaleMediationOnInitCompleteListener;
 import net.adwhale.sdk.mediation.ads.GdprConsentStatus;
-import net.adwhale.sdk.utils.AdWhaleLog;
-
+import java.util.ArrayList;
 import java.util.HashMap;
+import java.util.List;
 import java.util.Map;
 
 /**
- * 초기화 모듈은 최신 TurboModule을 적용
- * JS <--> 네이티브 호출이 더 빠르고 타입 안정성이 제공되기 때문
+ * 글로벌 SDK 설정 TurboModule.
+ * <p>
+ * Flutter {@code AdWhaleSdkFlutterMethodCallHandler} 와
+ * 동일한 분기·응답 형태를 맞춥니다 ({@link com.adwhalesdkreactnative.common.RNMethodCallConst}).
+ * <p>
+ * 성공 시 맵은 {@link RNMethodArgConst#SEND_STATUS_CODE},
+ * {@link RNMethodArgConst#SEND_MESSAGE} 만 포함합니다 (Flutter {@code twoKeyMap} 와 동일).
+ * TurboModule 메서드명은 codegen 규약상 {@link RNMethodCallConst#INITIALIZE} 입니다
+ * (Flutter MethodChannel {@link RNMethodCallConst#FLUTTER_INIT} 와 문자열은 다름).
+ * Activity 가 없으면 Flutter 와 같이 {@link RNMethodResultConst#NO_ACTIVITY} 로 reject 합니다.
  */
 @ReactModule(name = RNAdWhaleMediationAdSettingModule.REACT_CLASS_NAME)
 public class RNAdWhaleMediationAdSettingModule extends NativeAdwhaleSdkReactNativeSpec {
@@ -33,38 +47,65 @@ public class RNAdWhaleMediationAdSettingModule extends NativeAdwhaleSdkReactNati
   }
 
   @Override
-  public String getName() {
-    return REACT_CLASS_NAME;
-  }
+  public void initialize(final Promise promise) {
+    Log.i(REACT_CLASS_NAME, RNMethodCallConst.INITIALIZE + "()");
+    Activity currentActivity =
+        requireActivity(promise, "Activity is null. Cannot initialize SDK.");
+    if (currentActivity == null) {
+      return;
+    }
 
-  @ReactMethod
-  public void setCoppa(boolean isEnabled) {
-    AdWhaleMediationAds.setCoppa(isEnabled);
-    Log.d(REACT_CLASS_NAME, "COPPA setting applied: " + isEnabled);
+    // Flutter INIT 분기: disposeAllAds() — RN 은 인스턴스 매니저가 없어 생략
+
+    AdWhaleMediationAds.init(currentActivity, new AdWhaleMediationOnInitCompleteListener() {
+      @Override
+      public void onInitComplete(int statusCode, String message) {
+        Log.i(REACT_CLASS_NAME, RNMethodCallConst.ON_INIT_COMPLETE + "(" + statusCode + ", " + message + ")");
+        WritableMap result = Arguments.createMap();
+        result.putInt(RNMethodArgConst.SEND_STATUS_CODE, statusCode);
+        result.putString(RNMethodArgConst.SEND_MESSAGE, message == null ? "" : message);
+        promise.resolve(result);
+      }
+    });
   }
 
   @ReactMethod
   public void requestGdprConsent(final Promise promise) {
-    Activity currentActivity = getCurrentActivity();
+    Activity currentActivity =
+        requireActivity(promise, "Activity is null. Cannot request GDPR consent.");
     if (currentActivity == null) {
-      promise.reject("NO_ACTIVITY", "Current activity is null.");
       return;
     }
     currentActivity.runOnUiThread(() ->
       AdWhaleMediationAds.requestGdprConsent(currentActivity, (isSuccess, message) -> {
         WritableMap result = Arguments.createMap();
-        result.putBoolean("isSuccess", isSuccess);
-        result.putString("message", message);
+        result.putBoolean(RNMethodArgConst.SEND_SUCCESS, isSuccess);
+        result.putString(RNMethodArgConst.SEND_MESSAGE, message == null ? "" : message);
         promise.resolve(result);
       })
     );
   }
 
   @ReactMethod
-  public void getConsentStatus(Promise promise) {
+  public void resetGdprConsentStatus() {
     Activity currentActivity = getCurrentActivity();
+    if (currentActivity != null) {
+      currentActivity.runOnUiThread(() -> AdWhaleMediationAds.resetGdprConsentStatus(currentActivity));
+      Log.d(REACT_CLASS_NAME, "GDPR consent status has been reset.");
+    }
+  }
+
+  @ReactMethod
+  public void setGdpr(boolean consent) {
+    AdWhaleMediationAds.setGdpr(consent);
+    Log.d(REACT_CLASS_NAME, "Personalized Consent set to: " + consent);
+  }
+
+  @ReactMethod
+  public void getConsentStatus(Promise promise) {
+    Activity currentActivity =
+        requireActivity(promise, "Activity is null. Cannot get consent status.");
     if (currentActivity == null) {
-      promise.reject("NO_ACTIVITY", "Current activity is null.");
       return;
     }
 
@@ -73,54 +114,112 @@ public class RNAdWhaleMediationAdSettingModule extends NativeAdwhaleSdkReactNati
     boolean personalizedConsent = AdWhaleMediationAds.getAdwhaleGDPR(currentActivity);
 
     WritableMap statusMap = Arguments.createMap();
-    statusMap.putBoolean("coppa", coppa);
-    statusMap.putString("gdpr", gdpr.name());
-    statusMap.putBoolean("personalizedConsent", personalizedConsent);
+    statusMap.putBoolean(RNMethodArgConst.SEND_COPPA, coppa);
+    statusMap.putString(RNMethodArgConst.SEND_GDPR, gdpr.name());
+    statusMap.putBoolean(RNMethodArgConst.SEND_PERSONALIZED_CONSENT, personalizedConsent);
 
     promise.resolve(statusMap);
   }
 
   @ReactMethod
-  public void resetGdprConsentStatus() {
-    Activity currentActivity = getCurrentActivity();
-    if (currentActivity != null) {
-      currentActivity.runOnUiThread(() -> AdWhaleMediationAds.resetGdprConsentStatus(currentActivity));
-      Log.d(REACT_CLASS_NAME, "GDPR consent status has been reset.");
-    }
+  public void setTagForUnderAgeOfConsent(boolean tag) {
+    int tagIdx = tag ? AdWhaleMediationAds.TAG_FOR_UNDER_AGE_OF_CONSENT_TRUE : AdWhaleMediationAds.TAG_FOR_UNDER_AGE_OF_CONSENT_FALSE;
+    AdWhaleMediationAds.setTagForUnderAgeOfConsent(tagIdx);
+    Log.d(REACT_CLASS_NAME, RNMethodCallConst.SET_TAG_FOR_UNDER_AGE_OF_CONSENT + ": " + tagIdx);
   }
 
   @ReactMethod
-  public void setGdpr(boolean consent) {
-    AdWhaleMediationAds.setGdpr(consent);
-    Log.d(REACT_CLASS_NAME, "Personalized Consent set to: " + consent);
+  public void setMaxAdContentRating(String rating) {
+    if (rating == null || rating.isEmpty()) {
+      AdWhaleMediationAds.setMaxAdContentRating(null);
+    } else {
+      AdWhaleMediationAds.setMaxAdContentRating(mapMaxAdContentRating(rating));
+    }
+    Log.d(REACT_CLASS_NAME, RNMethodCallConst.SET_MAX_AD_CONTENT_RATING + ": " + rating);
   }
 
-  @ReactMethod(isBlockingSynchronousMethod = true)
-  public void initialize(final Promise promise) {
-    Log.i(REACT_CLASS_NAME, ".initialize()");
-    Activity currentActivity = getCurrentActivity();
-    if (currentActivity == null) {
-      WritableMap errorResult = Arguments.createMap();
-      errorResult.putInt("statusCode", -1);
-      errorResult.putString("message", "Unable to initialize AdWhale SDK: No activity available");
-      errorResult.putBoolean("isSuccess", false);
-      promise.resolve(errorResult);
+  @Override
+  public void setTestDeviceIdentifiers(ReadableArray testDeviceIds) {
+    if (testDeviceIds == null || testDeviceIds.size() == 0) {
+      return;
+    }
+    List<String> ids = new ArrayList<>(testDeviceIds.size());
+    for (int i = 0; i < testDeviceIds.size(); i++) {
+      if (testDeviceIds.getType(i) != ReadableType.String) {
+        continue;
+      }
+      String id = testDeviceIds.getString(i);
+      if (id != null) {
+        ids.add(id);
+      }
+    }
+    if (ids.isEmpty()) {
       return;
     }
+    AdWhaleMediationAds.setTestDeviceIdentifiers(ids);
+  }
 
-    AdWhaleLog.setLogLevel(AdWhaleLog.LogLevel.Verbose);
+  @ReactMethod
+  public void showAdInspector(final Promise promise) {
+    Activity currentActivity =
+        requireActivity(promise, "Activity is null. Cannot open Ad Inspector.");
+    if (currentActivity == null) {
+      return;
+    }
 
-    AdWhaleMediationAds.init(currentActivity, new AdWhaleMediationOnInitCompleteListener() {
-      @Override
-      public void onInitComplete(int statusCode, String message) {
-        Log.i(REACT_CLASS_NAME, ".onInitComplete(" + statusCode + ", " + message + ")");
+    // MobileAds.openAdInspector → WebView 초기화는 메인(UI) 스레드에서만 가능
+    currentActivity.runOnUiThread(() ->
+      AdWhaleMediationAds.openAdInspector(currentActivity, (statusCode, message) -> {
+        Log.i(REACT_CLASS_NAME,  RNMethodCallConst.ON_AD_INSPECTOR_CLOSED + "(" + statusCode + ", " + message + ")");
         WritableMap result = Arguments.createMap();
-        result.putInt("statusCode", statusCode);
-        result.putString("message", message);
-        result.putBoolean("isSuccess", statusCode == 100);
+        result.putInt(RNMethodArgConst.SEND_STATUS_CODE, statusCode);
+        result.putString(RNMethodArgConst.SEND_MESSAGE, message == null ? "" : message);
         promise.resolve(result);
-      }
-    });
+      })
+    );
+  }
+
+  @ReactMethod
+  public void setCoppa(boolean isEnabled) {
+    AdWhaleMediationAds.setCoppa(isEnabled);
+    Log.d(REACT_CLASS_NAME, RNMethodCallConst.SET_COPPA + ": " + isEnabled);
+  }
+
+  @ReactMethod
+  public void setAppMuted(boolean isMuted) {
+    AdWhaleMediationAds.setAppMuted(isMuted);
+    Log.d(REACT_CLASS_NAME, RNMethodCallConst.SET_APP_MUTED + ": " + isMuted);
+  }
+
+  @Override
+  public void setAppVolume(double volume) {
+    AdWhaleMediationAds.setAppVolume((float) volume);
+    Log.d(REACT_CLASS_NAME, RNMethodCallConst.SET_APP_VOLUME + ": " + volume);
+  }
+
+  /**
+   * Flutter {@code AdWhaleSdkFlutterMethodCallHandler.requireActivity} 와 동일 —
+   * Activity 가 없으면 {@link RNMethodResultConst#NO_ACTIVITY} 로 reject 하고 null 을 반환합니다.
+   */
+  @Nullable
+  private Activity requireActivity(@NonNull Promise promise, @NonNull String message) {
+    Activity activity = getCurrentActivity();
+    if (activity == null) {
+      promise.reject(RNMethodResultConst.NO_ACTIVITY, message);
+      return null;
+    }
+    return activity;
+  }
+
+  @Nullable
+  private static String mapMaxAdContentRating(@NonNull String rating) {
+    return switch (rating) {
+      case ".general" -> AdWhaleMediationAds.MAX_AD_CONTENT_RATING_G;
+      case ".parentalGuidance" -> AdWhaleMediationAds.MAX_AD_CONTENT_RATING_PG;
+      case ".teen" -> AdWhaleMediationAds.MAX_AD_CONTENT_RATING_T;
+      case ".matureAudience" -> AdWhaleMediationAds.MAX_AD_CONTENT_RATING_MA;
+      default -> null;
+    };
   }
 
   @Nullable

package/android/src/main/java/com/adwhalesdkreactnative/RNAdWhaleMediationAdView.java

@@ -9,6 +9,8 @@ import android.widget.RelativeLayout;
 import androidx.annotation.NonNull;
 import androidx.annotation.Nullable;
 
+import com.adwhalesdkreactnative.common.RNMethodArgConst;
+import com.adwhalesdkreactnative.common.RNMethodCallConst;
 import com.facebook.react.bridge.Arguments;
 import com.facebook.react.bridge.ReactContext;
 import com.facebook.react.bridge.ReadableMap;
@@ -25,6 +27,13 @@ import net.adwhale.sdk.mediation.ads.AdWhaleMediationAdViewListener;
 
 import java.util.Map;
 
+/**
+ * 인라인 배너 {@link AdWhaleMediationAdView}.
+ * <p>
+ * Flutter 의 {@code FlutterBannerAd}(일반 배너)와 동일 SDK 뷰를 쓰지만, 연결 방식은
+ * React Native ViewManager 직접 이벤트입니다. 이벤트 이름은 {@link RNMethodCallConst#ON_AD_LOADED} 등
+ * Flutter {@code FlutterMethodCallConst} 와 동일 문자열입니다.
+ */
 public class RNAdWhaleMediationAdView extends ViewGroupManager<RNWrapperView> {
 
     public static final String REACT_CLASS_NAME = RNAdWhaleMediationAdView.class.getSimpleName();
@@ -50,37 +59,42 @@ public class RNAdWhaleMediationAdView extends ViewGroupManager<RNWrapperView> {
       adWhaleMediationAdView.setAdWhaleMediationAdViewListener(new AdWhaleMediationAdViewListener() {
         @Override
         public void onAdLoaded() {
-          Log.e(REACT_CLASS_NAME, "onAdLoaded()");
+          Log.e(REACT_CLASS_NAME, RNMethodCallConst.ON_AD_LOADED + "()");
           ReactContext context = (ReactContext) wrapperView.getContext();
           if (context != null) {
+            WritableMap params = Arguments.createMap();
+            params.putInt(RNMethodArgConst.RECEIVE_AD_ID, wrapperView.getAdId());
             context.getJSModule(RCTEventEmitter.class)
               .receiveEvent(wrapperView.getId(),
-                "onAdLoaded", null);
+                RNMethodCallConst.ON_AD_LOADED, params);
           }
         }
 
         @Override
         public void onAdLoadFailed(int statusCode, String message) {
-          Log.e(REACT_CLASS_NAME, "onAdLoadFailed(" + statusCode + "," + message + ")");
+          Log.e(REACT_CLASS_NAME, RNMethodCallConst.ON_AD_LOAD_FAILED + "(" + statusCode + "," + message + ")");
           ReactContext context = (ReactContext) wrapperView.getContext();
           if (context != null) {
             WritableMap params = Arguments.createMap();
-            params.putInt("statusCode", statusCode);
-            params.putString("message", message);
+            params.putInt(RNMethodArgConst.RECEIVE_AD_ID, wrapperView.getAdId());
+            params.putInt(RNMethodArgConst.SEND_STATUS_CODE, statusCode);
+            params.putString(RNMethodArgConst.SEND_MESSAGE, message);
             context.getJSModule(RCTEventEmitter.class)
               .receiveEvent(wrapperView.getId(),
-                "onAdLoadFailed", params);
+                RNMethodCallConst.ON_AD_LOAD_FAILED, params);
           }
         }
 
         @Override
         public void onAdClicked() {
-          Log.e(REACT_CLASS_NAME, "onAdClicked()");
+          Log.e(REACT_CLASS_NAME, RNMethodCallConst.ON_AD_CLICKED + "()");
           ReactContext context = (ReactContext) wrapperView.getContext();
           if (context != null) {
+            WritableMap params = Arguments.createMap();
+            params.putInt(RNMethodArgConst.RECEIVE_AD_ID, wrapperView.getAdId());
             context.getJSModule(RCTEventEmitter.class)
               .receiveEvent(wrapperView.getId(),
-                "onAdClicked", null);
+                RNMethodCallConst.ON_AD_CLICKED, params);
           }
         }
       });
@@ -94,7 +108,12 @@ public class RNAdWhaleMediationAdView extends ViewGroupManager<RNWrapperView> {
       return wrapperView;
     }
 
-    @ReactProp(name = "placementUid")
+    @ReactProp(name = RNMethodArgConst.RECEIVE_AD_ID, defaultInt = 0)
+    public void setAdId(RNWrapperView view, int adId) {
+      view.setAdId(adId);
+    }
+
+    @ReactProp(name = RNMethodCallConst.PLACEMENT_UID)
     public void setPlacementUid(RNWrapperView view, String placementUid) {
       AdWhaleMediationAdView adView = getAdWhaleMediationAdView(view);
       if (adView != null) {
@@ -102,7 +121,7 @@ public class RNAdWhaleMediationAdView extends ViewGroupManager<RNWrapperView> {
       }
     }
 
-    @ReactProp(name = "adSize")
+    @ReactProp(name = RNMethodCallConst.AD_SIZE)
     public void setAdSize(RNWrapperView view, String adSizeName) {
       AdWhaleMediationAdView adView = getAdWhaleMediationAdView(view);
       if (adView == null) return;
@@ -125,7 +144,7 @@ public class RNAdWhaleMediationAdView extends ViewGroupManager<RNWrapperView> {
       Log.d(REACT_CLASS_NAME, "Ad size set to: " + adSize.name());
     }
 
-    @ReactProp(name = "adaptiveAnchorWidth", defaultInt = 0)
+    @ReactProp(name = RNMethodArgConst.RECEIVE_ADAPTIVE_ANCHOR_WIDTH, defaultInt = 0)
     public void setAdaptiveAnchorWidth(RNWrapperView view, int width) {
       AdWhaleMediationAdView adView = getAdWhaleMediationAdView(view);
       if (adView != null) {
@@ -134,8 +153,8 @@ public class RNAdWhaleMediationAdView extends ViewGroupManager<RNWrapperView> {
       }
     }
 
-    @ReactProp(name = "loadAd")
-    public void setLoadAd(RNWrapperView view, boolean loadAd) {
+    @ReactProp(name = RNMethodCallConst.LOAD_AD)
+    public void loadAd(RNWrapperView view, boolean loadAd) {
       if (loadAd) {
         AdWhaleMediationAdView adView = getAdWhaleMediationAdView(view);
         if (adView != null) {
@@ -145,32 +164,32 @@ public class RNAdWhaleMediationAdView extends ViewGroupManager<RNWrapperView> {
       }
     }
 
-    @ReactProp(name = "placementName")
+    @ReactProp(name = RNMethodArgConst.RECEIVE_PLACEMENT_NAME)
     public void setPlacementName(RNWrapperView view, String placementName) {
-      Log.e(REACT_CLASS_NAME, "placementName: " + placementName);
+      Log.e(REACT_CLASS_NAME, RNMethodArgConst.RECEIVE_PLACEMENT_NAME + ": " + placementName);
       AdWhaleMediationAdView adView = getAdWhaleMediationAdView(view);
       if (adView != null) {
         adView.setPlacementName(placementName);
       }
     }
 
-    @ReactProp(name = "region")
+    @ReactProp(name = RNMethodArgConst.RECEIVE_REGION)
     public void setRegion(RNWrapperView view, String region) {
-      Log.e(REACT_CLASS_NAME, "region: " + region);
+      Log.e(REACT_CLASS_NAME, RNMethodArgConst.RECEIVE_REGION + ": " + region);
       AdWhaleMediationAdView adView = getAdWhaleMediationAdView(view);
       if (adView != null) {
         adView.setRegion(region);
       }
     }
 
-    @ReactProp(name = "gcoder")
+    @ReactProp(name = RNMethodArgConst.RECEIVE_GCODER)
     public void setGcoder(RNWrapperView view, ReadableMap gcoderMap) {
-      Log.e(REACT_CLASS_NAME, "gcoderMap: " + gcoderMap);
+      Log.e(REACT_CLASS_NAME, RNMethodArgConst.RECEIVE_GCODER + ": " + gcoderMap);
       AdWhaleMediationAdView adView = getAdWhaleMediationAdView(view);
 
       if (adView != null && gcoderMap != null) {
-        double lt = gcoderMap.hasKey("lt") ? gcoderMap.getDouble("lt") : 0.0;
-        double lng = gcoderMap.hasKey("lng") ? gcoderMap.getDouble("lng") : 0.0;
+        double lt = gcoderMap.hasKey(RNMethodArgConst.RECEIVE_LT) ? gcoderMap.getDouble(RNMethodArgConst.RECEIVE_LT) : 0.0;
+        double lng = gcoderMap.hasKey(RNMethodArgConst.RECEIVE_LNG) ? gcoderMap.getDouble(RNMethodArgConst.RECEIVE_LNG) : 0.0;
 
         adView.setGcoder(lt, lng);
       }
@@ -202,12 +221,12 @@ public class RNAdWhaleMediationAdView extends ViewGroupManager<RNWrapperView> {
     public Map<String, Object> getExportedCustomDirectEventTypeConstants() {
       Log.e(REACT_CLASS_NAME, "getExportedCustomDirectEventTypeConstants()");
       return MapBuilder.<String, Object>builder()
-        .put("onAdLoaded",
-          MapBuilder.of("registrationName", "onAdLoaded"))
-        .put("onAdLoadFailed",
-          MapBuilder.of("registrationName", "onAdLoadFailed"))
-        .put("onAdClicked",
-          MapBuilder.of("registrationName", "onAdClicked"))
+        .put(RNMethodCallConst.ON_AD_LOADED,
+          MapBuilder.of(RNMethodArgConst.SEND_REGISTRATION_NAME, RNMethodCallConst.ON_AD_LOADED))
+        .put(RNMethodCallConst.ON_AD_LOAD_FAILED,
+          MapBuilder.of(RNMethodArgConst.SEND_REGISTRATION_NAME, RNMethodCallConst.ON_AD_LOAD_FAILED))
+        .put(RNMethodCallConst.ON_AD_CLICKED,
+          MapBuilder.of(RNMethodArgConst.SEND_REGISTRATION_NAME, RNMethodCallConst.ON_AD_CLICKED))
         .build();
 
     }

package/android/src/main/java/com/adwhalesdkreactnative/RNAdWhaleMediationAppOpenAd.java

@@ -14,6 +14,8 @@ import com.facebook.react.bridge.ReactApplicationContext;
 import com.facebook.react.bridge.ReactContextBaseJavaModule;
 import com.facebook.react.bridge.ReactMethod;
 import com.facebook.react.bridge.ReadableMap;
+import com.facebook.react.bridge.ReadableArray;
+import com.facebook.react.bridge.ReadableType;
 import com.facebook.react.bridge.UiThreadUtil;
 import com.facebook.react.bridge.WritableMap;
 import com.facebook.react.modules.core.DeviceEventManagerModule;
@@ -24,6 +26,11 @@ import net.adwhale.sdk.mediation.ads.AdWhaleMediationAppOpenAdListener;
 public class RNAdWhaleMediationAppOpenAd extends ReactContextBaseJavaModule implements AdWhaleMediationAppOpenAdListener, LifecycleEventListener {
 
   public static final String REACT_CLASS_NAME = RNAdWhaleMediationAppOpenAd.class.getSimpleName();
+
+  // Flutter와 싱크: adId 기반 멀티 인스턴스 지원 (AppOpen은 실사용에선 보통 1개지만 테스트/멀티 지원)
+  private final java.util.Map<Integer, AdWhaleMediationAppOpenAd> adsById = new java.util.HashMap<>();
+  private int lastActiveAdId = 0;
+
   private AdWhaleMediationAppOpenAd adWhaleMediationAppOpenAd;
   private final ReactApplicationContext reactContext;
 
@@ -142,6 +149,86 @@ public class RNAdWhaleMediationAppOpenAd extends ReactContextBaseJavaModule impl
     });
   }
 
+  /**
+   * Flutter MethodChannel과 동일 네이밍:
+   * loadAppOpenAd({adId, placementUid, region, gcoder:[lt,lng], placementName})
+   */
+  @ReactMethod
+  public void loadAppOpenAd(ReadableMap args) {
+    if (args == null) {
+      Log.e(REACT_CLASS_NAME, "loadAppOpenAd args is null");
+      return;
+    }
+    if (!args.hasKey("adId") || args.getType("adId") != ReadableType.Number) {
+      Log.e(REACT_CLASS_NAME, "loadAppOpenAd missing adId (number)");
+      return;
+    }
+    if (!args.hasKey("placementUid") || args.getType("placementUid") != ReadableType.String) {
+      Log.e(REACT_CLASS_NAME, "loadAppOpenAd missing placementUid (string)");
+      return;
+    }
+    final int adId = args.getInt("adId");
+    final String placementUid = args.getString("placementUid");
+
+    UiThreadUtil.runOnUiThread(() -> {
+      if (getCurrentActivity() == null) {
+        WritableMap params = Arguments.createMap();
+        params.putInt("statusCode", -1);
+        params.putString("message", "Activity not available to load ad.");
+        sendEvent("onAppOpenAdFailedToLoad", params);
+        sendAdEvent(adId, "onAppOpenAdLoadFailed", params);
+        return;
+      }
+
+      AdWhaleMediationAppOpenAd old = adsById.remove(adId);
+      if (old != null) {
+        try {
+          old.destroy();
+        } catch (Throwable ignore) {}
+      }
+
+      AdWhaleMediationAppOpenAd ad = new AdWhaleMediationAppOpenAd(getCurrentActivity(), placementUid);
+      ad.setAdWhaleMediationAppOpenAdListener(this);
+
+      try {
+        if (args.hasKey("placementName") && args.getType("placementName") == ReadableType.String) {
+          String pn = args.getString("placementName");
+          if (pn != null && !pn.isEmpty()) ad.setPlacementName(pn);
+        }
+      } catch (Throwable t) {
+        Log.w(REACT_CLASS_NAME, "setPlacementName failed: " + t.getMessage());
+      }
+
+      try {
+        if (args.hasKey("region") && args.getType("region") == ReadableType.String) {
+          String r = args.getString("region");
+          if (r != null && !r.isEmpty()) ad.setRegion(r);
+        }
+      } catch (Throwable t) {
+        Log.w(REACT_CLASS_NAME, "setRegion failed: " + t.getMessage());
+      }
+
+      try {
+        if (args.hasKey("gcoder") && args.getType("gcoder") == ReadableType.Array) {
+          ReadableArray arr = args.getArray("gcoder");
+          if (arr != null && arr.size() >= 2
+              && arr.getType(0) == ReadableType.Number
+              && arr.getType(1) == ReadableType.Number) {
+            double lat = arr.getDouble(0);
+            double lng = arr.getDouble(1);
+            ad.setGcoder(lat, lng);
+          }
+        }
+      } catch (Throwable t) {
+        Log.w(REACT_CLASS_NAME, "setGcoder failed: " + t.getMessage());
+      }
+
+      lastActiveAdId = adId;
+      adsById.put(adId, ad);
+      ad.loadAd();
+    });
+  }
+
   @ReactMethod
   public void showAd() {
     Log.d(REACT_CLASS_NAME, "showAd()");
@@ -158,6 +245,35 @@ public class RNAdWhaleMediationAppOpenAd extends ReactContextBaseJavaModule impl
     });
   }
 
+  /** Flutter 네이밍: showAdWithoutView(adId) */
+  @ReactMethod
+  public void showAdWithoutView(int adId) {
+    AdWhaleMediationAppOpenAd ad = adsById.get(adId);
+    if (ad == null) {
+      Log.e(REACT_CLASS_NAME, "showAdWithoutView: ad not found. adId=" + adId);
+      return;
+    }
+    lastActiveAdId = adId;
+    UiThreadUtil.runOnUiThread(() -> {
+      if (getCurrentActivity() != null) {
+        ad.showAd(getCurrentActivity());
+      }
+    });
+  }
+
+  /** Flutter 네이밍: destroyAd(adId) */
+  @ReactMethod
+  public void destroyAd(int adId) {
+    AdWhaleMediationAppOpenAd ad = adsById.remove(adId);
+    if (ad != null) {
+      try {
+        ad.destroy();
+      } catch (Throwable t) {
+        Log.w(REACT_CLASS_NAME, "destroyAd failed: " + t.getMessage());
+      }
+    }
+  }
+
   private void sendEvent(String eventName, @Nullable WritableMap params) {
     if (reactContext.hasActiveCatalystInstance()) {
       reactContext
@@ -166,10 +282,22 @@ public class RNAdWhaleMediationAppOpenAd extends ReactContextBaseJavaModule impl
     }
   }
 
+  private void sendAdEvent(int adId, @NonNull String eventName, @Nullable WritableMap original) {
+    WritableMap payload = Arguments.createMap();
+    payload.putInt("adId", adId);
+    payload.putString("eventName", eventName);
+    if (original != null) {
+      if (original.hasKey("statusCode")) payload.putInt("statusCode", original.getInt("statusCode"));
+      if (original.hasKey("message")) payload.putString("message", original.getString("message"));
+    }
+    sendEvent("onAdEvent", payload);
+  }
+
   @Override
   public void onAdLoaded() {
     Log.i(REACT_CLASS_NAME, ".onAdLoaded()");
     sendEvent("onAppOpenAdLoaded", null);
+    sendAdEvent(lastActiveAdId, "onAppOpenAdLoaded", null);
   }
 
   @Override
@@ -179,12 +307,14 @@ public class RNAdWhaleMediationAppOpenAd extends ReactContextBaseJavaModule impl
     params.putInt("statusCode", statusCode);
     params.putString("message", message);
     sendEvent("onAppOpenAdFailedToLoad", params);
+    sendAdEvent(lastActiveAdId, "onAppOpenAdLoadFailed", params);
   }
 
   @Override
   public void onAdShowed() {
     Log.i(REACT_CLASS_NAME, ".onAdShowed()");
     sendEvent("onAppOpenAdShowed", null);
+    sendAdEvent(lastActiveAdId, "onAppOpenAdShowed", null);
   }
 
   @Override
@@ -194,22 +324,28 @@ public class RNAdWhaleMediationAppOpenAd extends ReactContextBaseJavaModule impl
     params.putInt("statusCode", statusCode);
     params.putString("message", message);
     sendEvent("onAppOpenAdFailedToShow", params);
+    sendAdEvent(lastActiveAdId, "onAppOpenAdShowFailed", params);
   }
 
   @Override
   public void onAdDismissed() {
     Log.i(REACT_CLASS_NAME, ".onAdDismissed()");
     sendEvent("onAppOpenAdDismissed", null);
+    sendAdEvent(lastActiveAdId, "onAppOpenAdDismissed", null);
     if (adWhaleMediationAppOpenAd != null) {
       adWhaleMediationAppOpenAd.destroy();
       adWhaleMediationAppOpenAd = null;
     }
+    if (adsById.containsKey(lastActiveAdId)) {
+      destroyAd(lastActiveAdId);
+    }
   }
 
   @Override
   public void onAdClicked() {
     Log.i(REACT_CLASS_NAME, ".onAdClicked()");
     sendEvent("onAppOpenAdClicked", null);
+    sendAdEvent(lastActiveAdId, "onAppOpenAdClicked", null);
   }
 
   @ReactMethod