@apps-in-toss/web-bridge 2.9.3 → 2.10.1

package/dist/bridge.d.ts

@@ -36,6 +36,7 @@ export * from './getIsTossLoginIntegratedService';
 export * from './getServerTime';
 export * from './getConsentedUserData';
 export * from './requestReview';
+export * from './getDeclaredAgeRange';
 export * from './getLocale';
 export * from './getSchemeUri';
 export * from './getPlatformOS';

package/dist/bridge.js

@@ -1 +1 @@
-import{createAsyncBridge,createConstantBridge,createEventBridge}from"@apps-in-toss/bridge-core";var createEvents=function(){return{emit:function emit(event,args){for(var callbacks=this.events[event]||[],i=0,length=callbacks.length;i<length;i++){callbacks[i](args)}},events:{},on:function on(event,cb){var _this=this;var _this_events,_event;((_this_events=this.events)[_event=event]||(_this_events[_event]=[])).push(cb);return function(){var _this_events_event;_this.events[event]=(_this_events_event=_this.events[event])===null||_this_events_event===void 0?void 0:_this_events_event.filter(function(i){return cb!==i})}}}};if(typeof window!=="undefined"){window.__GRANITE_NATIVE_EMITTER=createEvents()}export var closeView=createAsyncBridge("closeView");export var generateHapticFeedback=createAsyncBridge("generateHapticFeedback");export var share=createAsyncBridge("share");export var setSecureScreen=createAsyncBridge("setSecureScreen");export var setScreenAwakeMode=createAsyncBridge("setScreenAwakeMode");export var getNetworkStatus=createAsyncBridge("getNetworkStatus");export var setIosSwipeGestureEnabled=createAsyncBridge("setIosSwipeGestureEnabled");export var openURL=createAsyncBridge("openURL");export var openPermissionDialog=createAsyncBridge("openPermissionDialog");export var getPermission=createAsyncBridge("getPermission");export var requestPermission=createAsyncBridge("requestPermission");export var setClipboardText=createConstantBridge("setClipboardText");export var getClipboardText=createConstantBridge("getClipboardText");export var fetchContacts=createConstantBridge("fetchContacts");export var fetchAlbumPhotos=createConstantBridge("fetchAlbumPhotos");export var getCurrentLocation=createConstantBridge("getCurrentLocation");export var openCamera=createConstantBridge("openCamera");export var appLogin=createAsyncBridge("appLogin");export var getAnonymousKey=createAsyncBridge("getAnonymousKey");export var eventLog=createAsyncBridge("eventLog");export var getTossShareLink=createAsyncBridge("getTossShareLink");export var setDeviceOrientation=createAsyncBridge("setDeviceOrientation");export var checkoutPayment=createAsyncBridge("checkoutPayment");export var requestTossPayPaysBilling=createAsyncBridge("requestTossPayPaysBilling");export var saveBase64Data=createAsyncBridge("saveBase64Data");export var openPDFViewer=createAsyncBridge("openPDFViewer");export var fetchAlbumItems=createAsyncBridge("fetchAlbumItems");export var appsInTossSignTossCert=createAsyncBridge("appsInTossSignTossCert");export var getGameCenterGameProfile=createAsyncBridge("getGameCenterGameProfile");export var openGameCenterLeaderboard=createAsyncBridge("openGameCenterLeaderboard");export var submitGameCenterLeaderBoardScore=createAsyncBridge("submitGameCenterLeaderBoardScore");export var getUserKeyForGame=createAsyncBridge("getUserKeyForGame");export var grantPromotionReward=createAsyncBridge("grantPromotionReward");export var grantPromotionRewardForGame=createAsyncBridge("grantPromotionRewardForGame");export var getIsTossLoginIntegratedService=createAsyncBridge("getIsTossLoginIntegratedService");export var getServerTime=createAsyncBridge("getServerTime");export var getConsentedUserData=createAsyncBridge("getConsentedUserData");export var requestReview=createAsyncBridge("requestReview");export var getLocale=createConstantBridge("getLocale");export var getSchemeUri=createConstantBridge("getSchemeUri");export var getPlatformOS=createConstantBridge("getPlatformOS");export var getOperationalEnvironment=createConstantBridge("getOperationalEnvironment");export var getTossAppVersion=createConstantBridge("getTossAppVersion");export var getDeviceId=createConstantBridge("getDeviceId");export var getGroupId=createConstantBridge("getGroupId");export var contactsViral=createEventBridge("contactsViral");export var startUpdateLocation=createEventBridge("startUpdateLocation");export var onVisibilityChangedByTransparentServiceWeb=createEventBridge("onVisibilityChangedByTransparentServiceWeb");
+import{createAsyncBridge,createConstantBridge,createEventBridge}from"@apps-in-toss/bridge-core";var createEvents=function(){return{emit:function emit(event,args){for(var callbacks=this.events[event]||[],i=0,length=callbacks.length;i<length;i++){callbacks[i](args)}},events:{},on:function on(event,cb){var _this=this;var _this_events,_event;((_this_events=this.events)[_event=event]||(_this_events[_event]=[])).push(cb);return function(){var _this_events_event;_this.events[event]=(_this_events_event=_this.events[event])===null||_this_events_event===void 0?void 0:_this_events_event.filter(function(i){return cb!==i})}}}};if(typeof window!=="undefined"){window.__GRANITE_NATIVE_EMITTER=createEvents()}export var closeView=createAsyncBridge("closeView");export var generateHapticFeedback=createAsyncBridge("generateHapticFeedback");export var share=createAsyncBridge("share");export var setSecureScreen=createAsyncBridge("setSecureScreen");export var setScreenAwakeMode=createAsyncBridge("setScreenAwakeMode");export var getNetworkStatus=createAsyncBridge("getNetworkStatus");export var setIosSwipeGestureEnabled=createAsyncBridge("setIosSwipeGestureEnabled");export var openURL=createAsyncBridge("openURL");export var openPermissionDialog=createAsyncBridge("openPermissionDialog");export var getPermission=createAsyncBridge("getPermission");export var requestPermission=createAsyncBridge("requestPermission");export var setClipboardText=createConstantBridge("setClipboardText");export var getClipboardText=createConstantBridge("getClipboardText");export var fetchContacts=createConstantBridge("fetchContacts");export var fetchAlbumPhotos=createConstantBridge("fetchAlbumPhotos");export var getCurrentLocation=createConstantBridge("getCurrentLocation");export var openCamera=createConstantBridge("openCamera");export var appLogin=createAsyncBridge("appLogin");export var getAnonymousKey=createAsyncBridge("getAnonymousKey");export var eventLog=createAsyncBridge("eventLog");export var getTossShareLink=createAsyncBridge("getTossShareLink");export var setDeviceOrientation=createAsyncBridge("setDeviceOrientation");export var checkoutPayment=createAsyncBridge("checkoutPayment");export var requestTossPayPaysBilling=createAsyncBridge("requestTossPayPaysBilling");export var saveBase64Data=createAsyncBridge("saveBase64Data");export var openPDFViewer=createAsyncBridge("openPDFViewer");export var fetchAlbumItems=createAsyncBridge("fetchAlbumItems");export var appsInTossSignTossCert=createAsyncBridge("appsInTossSignTossCert");export var getGameCenterGameProfile=createAsyncBridge("getGameCenterGameProfile");export var openGameCenterLeaderboard=createAsyncBridge("openGameCenterLeaderboard");export var submitGameCenterLeaderBoardScore=createAsyncBridge("submitGameCenterLeaderBoardScore");export var getUserKeyForGame=createAsyncBridge("getUserKeyForGame");export var grantPromotionReward=createAsyncBridge("grantPromotionReward");export var grantPromotionRewardForGame=createAsyncBridge("grantPromotionRewardForGame");export var getIsTossLoginIntegratedService=createAsyncBridge("getIsTossLoginIntegratedService");export var getServerTime=createAsyncBridge("getServerTime");export var getConsentedUserData=createAsyncBridge("getConsentedUserData");export var requestReview=createAsyncBridge("requestReview");export var getDeclaredAgeRange=createAsyncBridge("getDeclaredAgeRange");export var getLocale=createConstantBridge("getLocale");export var getSchemeUri=createConstantBridge("getSchemeUri");export var getPlatformOS=createConstantBridge("getPlatformOS");export var getOperationalEnvironment=createConstantBridge("getOperationalEnvironment");export var getTossAppVersion=createConstantBridge("getTossAppVersion");export var getDeviceId=createConstantBridge("getDeviceId");export var getGroupId=createConstantBridge("getGroupId");export var contactsViral=createEventBridge("contactsViral");export var startUpdateLocation=createEventBridge("startUpdateLocation");export var onVisibilityChangedByTransparentServiceWeb=createEventBridge("onVisibilityChangedByTransparentServiceWeb");

package/dist/getDeclaredAgeRange.d.ts

@@ -0,0 +1,17 @@
+export interface DeclaredAgeRange {
+	status: "SHARING" | "DECLINED_SHARING" | "UNSUPPORTED_OS" | "NOT_AVAILABLE" | "INVALID_REQUEST" | "FAILED";
+	lowerBound?: number;
+	upperBound?: number;
+	ageRangeDeclaration?: string;
+	activeParentalControls: string[];
+	isEligibleForAgeFeatures?: boolean;
+	errorCode?: string;
+}
+export declare function getDeclaredAgeRange(params: {
+	ageGates: number[];
+}): Promise<DeclaredAgeRange>;
+export declare namespace getDeclaredAgeRange {
+	var isSupported: () => boolean;
+}
+
+export {};

package/dist/index.cjs

@@ -37,6 +37,7 @@ __export(index_exports, {
   getAppsInTossGlobals: () => getAppsInTossGlobals,
   getClipboardText: () => getClipboardText,
   getCurrentLocation: () => getCurrentLocation,
+  getDeclaredAgeRange: () => getDeclaredAgeRange,
   getSafeAreaInsets: () => getSafeAreaInsets,
   getServerTime: () => getServerTime,
   graniteEvent: () => graniteEvent,
@@ -1035,6 +1036,197 @@ function resetAttachedBannerRegistry() {
   attachedBannerRegistry = /* @__PURE__ */ new WeakMap();
 }
 
+// src/toss-ad/constants.ts
+var ERROR_CODES = {
+  NETWORK_ERROR: 1001,
+  INVALID_REQUEST: 1002,
+  NO_AD: 1003,
+  ERROR: 1004,
+  INVALID_SPACE: 1005,
+  SDK_NOT_INITIALIZED: 1007,
+  HTTP_TIMEOUT: 1008,
+  EXECUTION_FAIL: 1009,
+  INTERRUPTED: 1010,
+  FAIL: 1011,
+  BLOCKED: 1012,
+  TIMEOUT: 1013,
+  LIMITED_AD: 1014,
+  CONSENT_REQUIRED: 1015,
+  TEST_MODE: 1016,
+  INTERNAL_ERROR: 1017
+};
+var NON_ERROR_STATUSES = /* @__PURE__ */ new Set(["OK", "TEST_MODE", "NO_AD"]);
+var API_RESULT_ERROR_CODE_MAP = {
+  HTTP_TIMEOUT: ERROR_CODES.HTTP_TIMEOUT,
+  NETWORK_ERROR: ERROR_CODES.NETWORK_ERROR,
+  EXECUTION_FAIL: ERROR_CODES.EXECUTION_FAIL,
+  INTERRUPTED: ERROR_CODES.INTERRUPTED,
+  INTERNAL_ERROR: ERROR_CODES.ERROR,
+  FAIL: ERROR_CODES.FAIL
+};
+var AD_STATUS_ERROR_CODE_MAP = {
+  BLOCKED: ERROR_CODES.BLOCKED,
+  ERROR: ERROR_CODES.ERROR,
+  TIMEOUT: ERROR_CODES.TIMEOUT,
+  INVALID_SPACE: ERROR_CODES.INVALID_SPACE,
+  INVALID_REQUEST: ERROR_CODES.INVALID_REQUEST,
+  LIMITED_AD: ERROR_CODES.LIMITED_AD,
+  CONSENT_REQUIRED: ERROR_CODES.CONSENT_REQUIRED
+};
+
+// src/toss-ad/tossAdEventLog.ts
+var tossAdEventLog = createAsyncBridge("tossAdEventLog");
+
+// src/toss-ad/errorTracking.ts
+var BANNER_ERROR_LOG_NAME = "display_ads_all::error__banner";
+function logBannerErrorToAppLog(info) {
+  void tossAdEventLog({
+    log_name: BANNER_ERROR_LOG_NAME,
+    log_type: "debug",
+    params: {
+      error_code: info.errorCode,
+      error_message: info.errorMessage,
+      ad_group_id: info.adGroupId,
+      mediation_id: info.mediationId,
+      event_context_token: info.eventContextToken
+    }
+  }).catch(() => {
+  });
+}
+function trackBannerError(info) {
+  if (info.endpointError) {
+    void fetch(info.endpointError, {
+      method: "POST",
+      headers: { "Content-Type": "application/json" },
+      body: JSON.stringify({
+        eventContextToken: info.eventContextToken,
+        mediationId: info.mediationId,
+        errorCode: info.errorCode,
+        errorMessage: info.errorMessage
+      })
+      // POST 실패(CORS·네트워크) → 앱로그 fallback (endpoint와 같은 채널이라 함께 막히는 경우 대비).
+    }).catch(() => logBannerErrorToAppLog(info));
+    return;
+  }
+  logBannerErrorToAppLog(info);
+}
+function trackResponseError(response, adGroupId, context) {
+  if (response.resultType !== "SUCCESS") {
+    trackBannerError({
+      adGroupId,
+      errorCode: API_RESULT_ERROR_CODE_MAP[response.resultType] ?? ERROR_CODES.INTERNAL_ERROR,
+      errorMessage: response.error?.reason ?? response.resultType
+    });
+    return;
+  }
+  const success = response.success;
+  if (!success || NON_ERROR_STATUSES.has(String(success.status))) {
+    return;
+  }
+  trackBannerError({
+    adGroupId,
+    errorCode: AD_STATUS_ERROR_CODE_MAP[String(success.status)] ?? ERROR_CODES.INTERNAL_ERROR,
+    mediationId: context.mediationId,
+    eventContextToken: context.eventContextToken,
+    errorMessage: `Ad response status: ${success.status}`,
+    endpointError: context.errorEndpoint
+  });
+}
+
+// src/toss-ad/eventTracking.ts
+async function handleTrackingRequest(request) {
+  if (request.type === "EVENT_TRACKING") {
+    await sendEventTracking(request);
+  }
+}
+async function sendEventTracking(request) {
+  if (request.urls.length === 0) {
+    return;
+  }
+  const body = JSON.stringify({ type: request.eventName, data: request.eventPayload });
+  const headers = { "Content-Type": "application/json" };
+  if (request.requestId) {
+    headers["X-Toss-RequestId"] = request.requestId;
+  }
+  const settled = await Promise.allSettled(
+    request.urls.map(
+      (url) => fetch(url, { method: "POST", headers, body }).then((response) => {
+        if (!response.ok) {
+          throw new Error(`HTTP ${response.status}`);
+        }
+      })
+    )
+  );
+  const failedCount = settled.filter((result) => result.status === "rejected").length;
+  if (failedCount === 0) {
+    return;
+  }
+  trackBannerError({
+    adGroupId: request.adGroupId,
+    errorCode: ERROR_CODES.NETWORK_ERROR,
+    errorMessage: `EVENT_TRACKING failed: ${request.eventName} (${failedCount}/${request.urls.length})`,
+    mediationId: request.mediationId || void 0,
+    eventContextToken: request.eventContextToken || void 0,
+    endpointError: request.errorEndpoint
+  });
+}
+
+// src/toss-ad/fetchAppsInTossAdSchema.ts
+var APPS_IN_TOSS_AD_SPEC_VERSION = "1.4.1";
+var FETCH_APPS_IN_TOSS_AD_DEVICE_MACRO = "{{device}}";
+var TOSS_APP_BUNDLE_IDS = {
+  ios: "com.vivarepublica.cash",
+  android: "viva.republica.toss"
+};
+function resolveTossAppBundleId(os) {
+  return TOSS_APP_BUNDLE_IDS[os];
+}
+
+// src/toss-ad/normalize.ts
+var LIST_BANNER_STYLE_ID = "1";
+var NATIVE_IMAGE_STYLE_ID = "2";
+var AVAILABLE_STYLE_IDS = [LIST_BANNER_STYLE_ID, NATIVE_IMAGE_STYLE_ID];
+var SUPPORTED_STYLE_IDS = new Set(AVAILABLE_STYLE_IDS);
+function normalizeAdResponse(adResponse) {
+  const ads = Array.isArray(adResponse.ads) ? adResponse.ads.filter((ad) => SUPPORTED_STYLE_IDS.has(String(ad.styleId))) : [];
+  return {
+    requestId: adResponse.requestId ?? "",
+    // SDK가 event 트래킹 위임(onTrackingRequest) 시 응답 top-level에서 읽어 실어 보낸다.
+    // 떼어내면 SDK가 토큰을 못 보고, event 트래킹 실패 시 endpoint.error에서 토큰이 빠진다.
+    eventContextToken: adResponse.eventContextToken,
+    status: adResponse.status ?? "OK",
+    ads,
+    ext: adResponse.ext
+  };
+}
+function normalizeApiResponse(raw) {
+  if (isApiResponse(raw)) {
+    if (raw.resultType !== "SUCCESS") {
+      return raw;
+    }
+    if (!raw.success) {
+      return {
+        resultType: "FAIL",
+        error: { reason: "fetchTossAd returned SUCCESS without payload" }
+      };
+    }
+    return { ...raw, success: normalizeAdResponse(raw.success) };
+  }
+  if (isAdResponse(raw)) {
+    return {
+      resultType: "SUCCESS",
+      success: normalizeAdResponse(raw)
+    };
+  }
+  return { resultType: "FAIL", error: { reason: "Invalid response from fetchTossAd" } };
+}
+function isApiResponse(payload) {
+  return Boolean(payload && typeof payload === "object" && "resultType" in payload);
+}
+function isAdResponse(payload) {
+  return Boolean(payload && typeof payload === "object" && "ads" in payload);
+}
+
 // src/toss-ad/opener.ts
 var openURL = createAsyncBridge("openURL");
 function openUrlOpener(url) {
@@ -1049,8 +1241,49 @@ function supertossWeb(uri) {
   return `supertoss://web?url=${encodeURIComponent(uri)}&external=true`;
 }
 
+// src/toss-ad/resultTracking.ts
+async function fireResultTracking(response, adGroupId, ctx) {
+  const status = response.success?.status;
+  if (response.resultType !== "SUCCESS" || status !== "OK" && status !== "TEST_MODE") {
+    return;
+  }
+  if (ctx.resultEndpoint == null || ctx.mediationId == null) {
+    return;
+  }
+  const body = {
+    mediationId: ctx.mediationId,
+    spaceUnitId: adGroupId,
+    requestId: response.success?.requestId ?? "",
+    eventContextToken: ctx.eventContextToken,
+    winnerSource: "TOSS",
+    content: null,
+    adUnitId: ctx.adUnitId ?? null,
+    placementId: ctx.placementId ?? null,
+    tossFailed: null
+  };
+  try {
+    const res = await fetch(ctx.resultEndpoint, {
+      method: "POST",
+      headers: { "Content-Type": "application/json" },
+      body: JSON.stringify(body)
+    });
+    if (!res.ok) {
+      throw new Error(`HTTP ${res.status}`);
+    }
+  } catch (error) {
+    trackBannerError({
+      adGroupId,
+      errorCode: ERROR_CODES.NETWORK_ERROR,
+      errorMessage: `RESULT_TRACKING failed: ${error instanceof Error ? error.message : String(error)}`,
+      mediationId: ctx.mediationId,
+      eventContextToken: ctx.eventContextToken,
+      endpointError: ctx.errorEndpoint
+    });
+  }
+}
+
 // src/toss-ad/scriptLoader.ts
-var DEFAULT_SDK_URL = "https://static.toss.im/ads/sdk/toss-ads-space-kit-1.3.0.js";
+var DEFAULT_SDK_URL = "https://static.toss.im/ads/sdk/toss-ads-space-kit-3.1.0.js";
 var DEFAULT_TIMEOUT_MS = 15e3;
 var pendingLoad = null;
 function getAdsSdk() {
@@ -1106,12 +1339,79 @@ function loadAdsSdk() {
   return promise;
 }
 
+// package.json
+var package_default = {
+  name: "@apps-in-toss/web-bridge",
+  type: "module",
+  version: "2.10.1",
+  description: "Web Bridge for Apps In Toss",
+  scripts: {
+    typecheck: "tsc --noEmit",
+    lint: "eslint .",
+    build: "tsup"
+  },
+  main: "./dist/index.cjs",
+  module: "./dist/index.js",
+  types: "./dist/index.d.ts",
+  exports: {
+    ".": {
+      import: {
+        types: "./dist/index.d.ts",
+        default: "./dist/index.js"
+      },
+      require: {
+        types: "./dist/index.d.cts",
+        default: "./dist/index.cjs"
+      }
+    }
+  },
+  files: [
+    "dist"
+  ],
+  dependencies: {
+    "@apps-in-toss/types": "workspace:*"
+  },
+  devDependencies: {
+    "@apps-in-toss/bridge-core": "workspace:*",
+    "@apps-in-toss/native-modules": "workspace:^",
+    "@swc/core": "^1.12.7",
+    picocolors: "^1.1.1",
+    "ts-morph": "^26.0.0",
+    tsup: "^8.5.0",
+    typescript: "5.8.3",
+    vitest: "^3.1.2"
+  }
+};
+
+// src/toss-ad/sdkVersion.ts
+var SDK_VERSION = package_default.version;
+
+// src/toss-ad/trackingContext.ts
+function nonEmptyString(value) {
+  return typeof value === "string" && value.length > 0 ? value : void 0;
+}
+function extractAdTrackingContext(response) {
+  const mediation = response?.ext?.mediation;
+  return {
+    mediationId: nonEmptyString(mediation?.mediationId),
+    eventContextToken: nonEmptyString(response?.eventContextToken),
+    resultEndpoint: nonEmptyString(mediation?.endpoint?.result),
+    errorEndpoint: nonEmptyString(mediation?.endpoint?.error),
+    adUnitId: nonEmptyString(mediation?.admob?.adUnitId),
+    placementId: typeof mediation?.admob?.placementId === "number" ? mediation.admob.placementId : void 0
+  };
+}
+
 // src/toss-ad/index.ts
 var fetchTossAd = Object.assign(createEventBridge("fetchTossAd"), {
   isSupported: createConstantBridge("fetchTossAd_isSupported")
 });
-var tossAdEventLog = createAsyncBridge("tossAdEventLog");
-var SUPPORTED_STYLE_IDS = /* @__PURE__ */ new Set(["1", "2"]);
+var fetchAppsInTossAd = Object.assign(createEventBridge("fetchAppsInTossAd"), {
+  isSupported: createConstantBridge("fetchAppsInTossAd_isSupported")
+});
+var getPlatformOS = createConstantBridge("getPlatformOS");
+var getTossAppVersion = createConstantBridge("getTossAppVersion");
+var WEB_SDK_ID = "108";
 var INVALID_AD_GROUP_ID_ERROR_MESSAGE = "\uC798\uBABB\uB41C \uC694\uCCAD\uC774\uC5D0\uC694. \uD544\uC694\uD55C \uAC12\uC774 \uBE44\uC5B4 \uC788\uC5B4\uC694.";
 function normalizeAdGroupId(adGroupId) {
   return adGroupId.trim();
@@ -1148,62 +1448,56 @@ function fetchTossAdPromise(options) {
     });
   });
 }
-function normalizeAdResponse(adResponse) {
-  const ads = Array.isArray(adResponse.ads) ? adResponse.ads.filter((ad) => SUPPORTED_STYLE_IDS.has(String(ad.styleId))) : [];
-  return {
-    requestId: adResponse.requestId ?? "",
-    status: adResponse.status ?? "OK",
-    ads,
-    ext: adResponse.ext
-  };
+function getSubBundle() {
+  return globalThis.__granite?.app?.name ?? "";
 }
-function normalizeApiResponse(raw) {
-  if (isApiResponse(raw)) {
-    if (raw.resultType !== "SUCCESS") {
-      return raw;
-    }
-    if (!raw.success) {
-      return {
-        resultType: "FAIL",
-        error: { reason: "fetchTossAd returned SUCCESS without payload" }
-      };
+function fetchAppsInTossAdPromise(spaceUnitId) {
+  const platformOS = getPlatformOS();
+  const tossAppVersion = getTossAppVersion();
+  const body = {
+    specVersion: APPS_IN_TOSS_AD_SPEC_VERSION,
+    platform: "WEB",
+    spaceUnitId,
+    sdkVersion: SDK_VERSION,
+    availableStyleIds: AVAILABLE_STYLE_IDS,
+    // device는 매크로키만 보내고 native가 실제 device로 치환한다.
+    device: FETCH_APPS_IN_TOSS_AD_DEVICE_MACRO,
+    app: {
+      version: tossAppVersion,
+      bundle: resolveTossAppBundleId(platformOS),
+      subBundle: getSubBundle()
     }
-    return { ...raw, success: normalizeAdResponse(raw.success) };
-  }
-  if (isAdResponse(raw)) {
-    return {
-      resultType: "SUCCESS",
-      success: normalizeAdResponse(raw)
-    };
-  }
-  return { resultType: "FAIL", error: { reason: "Invalid response from fetchTossAd" } };
-}
-function isApiResponse(payload) {
-  return Boolean(payload && typeof payload === "object" && "resultType" in payload);
-}
-function isAdResponse(payload) {
-  return Boolean(payload && typeof payload === "object" && "ads" in payload);
+  };
+  return new Promise((resolve, reject) => {
+    fetchAppsInTossAd({ options: body, onEvent: resolve, onError: reject });
+  });
 }
 function createCustomAdFetcher() {
   return async (_endpoint, request) => {
     const spaceUnitId = normalizeAdGroupId(request.spaceUnitId);
     if (spaceUnitId.length === 0) {
+      trackBannerError({
+        adGroupId: spaceUnitId,
+        errorCode: ERROR_CODES.INVALID_SPACE,
+        errorMessage: INVALID_AD_GROUP_ID_ERROR_MESSAGE
+      });
       return createInvalidAdGroupIdResponse();
     }
     try {
-      const raw = await fetchTossAdPromise({
+      const raw = fetchAppsInTossAd.isSupported() ? await fetchAppsInTossAdPromise(spaceUnitId) : await fetchTossAdPromise({
         adGroupId: spaceUnitId,
-        sdkId: "108",
-        availableStyleIds: ["1", "2"]
+        sdkId: WEB_SDK_ID,
+        availableStyleIds: AVAILABLE_STYLE_IDS
       });
-      return normalizeApiResponse(raw);
+      const response = normalizeApiResponse(raw);
+      const trackingContext = extractAdTrackingContext(response.success);
+      trackResponseError(response, spaceUnitId, trackingContext);
+      void fireResultTracking(response, spaceUnitId, trackingContext);
+      return response;
     } catch (error) {
-      return {
-        resultType: "FAIL",
-        error: {
-          reason: error instanceof Error ? error.message : "Unknown fetchTossAd error"
-        }
-      };
+      const reason = error instanceof Error ? error.message : "Unknown fetchTossAd error";
+      trackBannerError({ adGroupId: spaceUnitId, errorCode: ERROR_CODES.NETWORK_ERROR, errorMessage: reason });
+      return { resultType: "FAIL", error: { reason } };
     }
   };
 }
@@ -1229,7 +1523,12 @@ function initialize(options) {
       return;
     }
     const customAdFetcher = createCustomAdFetcher();
-    const config = { environment: "live", customAdFetcher, opener: openUrlOpener };
+    const config = {
+      environment: "live",
+      customAdFetcher,
+      opener: openUrlOpener,
+      onTrackingRequest: handleTrackingRequest
+    };
     sdk.init(config);
   });
   pendingLoad2 = initPromise;
@@ -1406,7 +1705,7 @@ function attachBanner(adGroupId, target, options = {}) {
           autoLoad: true,
           theme: theme === "auto" ? void 0 : theme,
           renderPadding: (styleId) => {
-            if (styleId === "1") {
+            if (styleId === LIST_BANNER_STYLE_ID) {
               return DEFAULT_ATTACH_PADDING_BANNER;
             }
             return DEFAULT_ATTACH_PADDING_NATIVE_IMAGE;
@@ -1479,6 +1778,8 @@ function wrapCallbacks(adGroupId, callbacks) {
       });
       callbacks.onAdImpression?.(mapEvent(payload));
     },
+    // 에러 트래킹은 응답을 소유한 createCustomAdFetcher가 담당한다. 콜백은 publisher 전달만.
+    // 응답 수신 후 에러의 mediationId는 SDK(ads-sdk/web)가 error에 실어주므로 그대로 전달한다.
     onAdFailedToRender: (payload) => callbacks.onAdFailedToRender?.({
       ...mapEvent(payload),
       error: payload?.error ?? { code: 0, message: "UNKNOWN" }
@@ -1532,6 +1833,14 @@ function requestNotificationAgreement(params) {
   return unregisterCallbacks;
 }
 
+// src/getDeclaredAgeRange.ts
+var getDeclaredAgeRange = Object.assign(
+  createAsyncBridge("getDeclaredAgeRange"),
+  {
+    isSupported: createConstantBridge("getDeclaredAgeRange_isSupported")
+  }
+);
+
 // src/index.ts
 __reExport(index_exports, require("@apps-in-toss/types"), module.exports);
 // Annotate the CommonJS export names for ESM import in node:
@@ -1551,6 +1860,7 @@ __reExport(index_exports, require("@apps-in-toss/types"), module.exports);
   getAppsInTossGlobals,
   getClipboardText,
   getCurrentLocation,
+  getDeclaredAgeRange,
   getSafeAreaInsets,
   getServerTime,
   graniteEvent,

package/dist/index.d.cts

@@ -3,6 +3,7 @@ export * from '@apps-in-toss/bridge-core';
 import * as _apps_in_toss_types from '@apps-in-toss/types';
 import { LoadAdMobEvent, LoadAdMobOptions, ShowAdMobEvent, ShowAdMobOptions, IsAdMobLoadedOptions, FetchAlbumPhotos, FetchContacts, GetCurrentLocation, OpenCamera, SetClipboardText, GetClipboardText, StartUpdateLocationEventParams, LoadFullScreenAdEvent, LoadFullScreenAdOptions, ShowFullScreenAdEvent, ShowFullScreenAdOptions } from '@apps-in-toss/types';
 export * from '@apps-in-toss/types';
+import { DeclaredAgeRange } from '@apps-in-toss/native-modules/async-bridges';
 
 /**
  * @public
@@ -885,6 +886,22 @@ interface RuntimeInfo {
     safeAreaInsets?: SafeAreaInsets;
 }
 type AdOpener = (url: string, target?: string, features?: string) => void;
+/** SDK가 `onTrackingRequest`로 위임하는 트래킹 요청. ads-sdk/web의 동형 계약. */
+interface TrackingRequestBase {
+    adGroupId: string;
+    requestId?: string;
+    creativeId?: string;
+    mediationId?: string;
+    eventContextToken?: string;
+    errorEndpoint?: string;
+}
+interface EventTrackingRequest extends TrackingRequestBase {
+    type: 'EVENT_TRACKING';
+    eventName: string;
+    urls: string[];
+    eventPayload: string;
+}
+type TrackingRequest = EventTrackingRequest;
 interface AdConfig {
     environment: Environment;
     apiEndpoint?: string;
@@ -893,6 +910,11 @@ interface AdConfig {
     runtimeInfo?: RuntimeInfo;
     opener?: AdOpener;
     customAdFetcher?: CustomAdFetcher;
+    /**
+     * 트래킹 전송 위임(SDK 3.1.0+). 지정 시 SDK는 직접 전송하지 않고 이 콜백에 위임한다.
+     * fire-and-forget이며 실패 관측은 사용측 책임. 현재 위임 대상은 EVENT_TRACKING이다.
+     */
+    onTrackingRequest?: (request: TrackingRequest) => void | Promise<void>;
 }
 interface AdRequest {
     spaceUnitId: string;
@@ -907,6 +929,7 @@ interface AdRequest {
 type AdResponseStatus = 'OK' | 'NO_AD' | 'BLOCKED' | 'ERROR' | 'TIMEOUT' | 'INVALID_SPACE' | 'INVALID_REQUEST' | 'LIMITED_AD' | 'CONSENT_REQUIRED' | 'TEST_MODE';
 interface AdResponse {
     requestId?: string;
+    eventContextToken?: string;
     status?: AdResponseStatus;
     ads: Ad[];
     ext?: AdResponseExt;
@@ -919,6 +942,19 @@ interface Ad {
     eventPayload?: string;
     requestId?: string;
 }
+interface TossAdsMediation {
+    mediationId: string;
+    priority: Array<'TOSS' | 'ADMOB'>;
+    admob: {
+        adUnitId: string;
+        placementId: number;
+    } | null;
+    endpoint?: {
+        result?: string;
+        exposure?: string;
+        error?: string;
+    };
+}
 interface AdResponseExt {
     skippableOffsetSeconds?: number;
     reward?: {
@@ -927,6 +963,7 @@ interface AdResponseExt {
     };
     isAdBadgeEnabled?: boolean;
     refetchSeconds?: number | null;
+    mediation?: TossAdsMediation;
 }
 interface ApiResponse<T> {
     resultType: 'SUCCESS' | 'HTTP_TIMEOUT' | 'NETWORK_ERROR' | 'EXECUTION_FAIL' | 'INTERRUPTED' | 'INTERNAL_ERROR' | 'FAIL';
@@ -958,10 +995,12 @@ interface BannerSlotErrorPayload {
     slotId: string;
     adGroupId: string;
     adMetadata: Record<string, never>;
+    /** `mediationId`는 `/api-web/v3/benefit-ads/display-ad/ads` 응답 수신 후 발생한 에러에만 포함된다. */
     error: {
         code: number;
         message: string;
         domain?: string;
+        mediationId?: string;
     };
 }
 interface BannerSlotCallbacks {
@@ -1095,4 +1134,10 @@ interface RequestNotificationAgreementOptions {
  */
 declare function requestNotificationAgreement(params: RequestNotificationAgreementOptions): () => void;
 
-export { type AddAccessoryButtonOptions, type AppsInTossEvent, type AppsInTossGlobals, type CompletedOrRefundedOrdersResult, type ConsumableProductListItem, type CreateSubscriptionPurchaseOrderOptions, GoogleAdMob, type GraniteEvent, IAP, type IapCreateOneTimePurchaseOrderOptions, type IapProductListItem, type IapSubscriptionInfoResponse, type IapSubscriptionInfoResult, type NonConsumableProductListItem, type NotificationAgreementResult, type RequestNotificationAgreementOptions, SafeAreaInsets$1 as SafeAreaInsets, Storage, type SubscriptionProductListItem, type TdsEvent, TossAds, type AttachBannerOptions as TossAdsAttachBannerOptions, type AttachBannerResult as TossAdsAttachBannerResult, type AttachOptions as TossAdsAttachOptions, type BannerSlotCallbacks as TossAdsBannerSlotCallbacks, type BannerSlotErrorPayload as TossAdsBannerSlotErrorPayload, type BannerSlotEventPayload as TossAdsBannerSlotEventPayload, type InitializeOptions as TossAdsInitializeOptions, appsInTossEvent, env, fetchAlbumPhotos, fetchContacts, getAppsInTossGlobals, getClipboardText, getCurrentLocation, getSafeAreaInsets, getServerTime, graniteEvent, isMinVersionSupported, loadFullScreenAd, openCamera, partner, requestNotificationAgreement, requestReview, setClipboardText, showFullScreenAd, startUpdateLocation, tdsEvent };
+declare const getDeclaredAgeRange: ((args_0: {
+    ageGates: number[];
+}) => Promise<DeclaredAgeRange>) & {
+    isSupported: () => boolean;
+};
+
+export { type AddAccessoryButtonOptions, type AppsInTossEvent, type AppsInTossGlobals, type CompletedOrRefundedOrdersResult, type ConsumableProductListItem, type CreateSubscriptionPurchaseOrderOptions, GoogleAdMob, type GraniteEvent, IAP, type IapCreateOneTimePurchaseOrderOptions, type IapProductListItem, type IapSubscriptionInfoResponse, type IapSubscriptionInfoResult, type NonConsumableProductListItem, type NotificationAgreementResult, type RequestNotificationAgreementOptions, SafeAreaInsets$1 as SafeAreaInsets, Storage, type SubscriptionProductListItem, type TdsEvent, TossAds, type AttachBannerOptions as TossAdsAttachBannerOptions, type AttachBannerResult as TossAdsAttachBannerResult, type AttachOptions as TossAdsAttachOptions, type BannerSlotCallbacks as TossAdsBannerSlotCallbacks, type BannerSlotErrorPayload as TossAdsBannerSlotErrorPayload, type BannerSlotEventPayload as TossAdsBannerSlotEventPayload, type InitializeOptions as TossAdsInitializeOptions, appsInTossEvent, env, fetchAlbumPhotos, fetchContacts, getAppsInTossGlobals, getClipboardText, getCurrentLocation, getDeclaredAgeRange, getSafeAreaInsets, getServerTime, graniteEvent, isMinVersionSupported, loadFullScreenAd, openCamera, partner, requestNotificationAgreement, requestReview, setClipboardText, showFullScreenAd, startUpdateLocation, tdsEvent };

package/dist/index.d.ts

@@ -3,6 +3,7 @@ export * from '@apps-in-toss/bridge-core';
 import * as _apps_in_toss_types from '@apps-in-toss/types';
 import { LoadAdMobEvent, LoadAdMobOptions, ShowAdMobEvent, ShowAdMobOptions, IsAdMobLoadedOptions, FetchAlbumPhotos, FetchContacts, GetCurrentLocation, OpenCamera, SetClipboardText, GetClipboardText, StartUpdateLocationEventParams, LoadFullScreenAdEvent, LoadFullScreenAdOptions, ShowFullScreenAdEvent, ShowFullScreenAdOptions } from '@apps-in-toss/types';
 export * from '@apps-in-toss/types';
+import { DeclaredAgeRange } from '@apps-in-toss/native-modules/async-bridges';
 
 /**
  * @public
@@ -885,6 +886,22 @@ interface RuntimeInfo {
     safeAreaInsets?: SafeAreaInsets;
 }
 type AdOpener = (url: string, target?: string, features?: string) => void;
+/** SDK가 `onTrackingRequest`로 위임하는 트래킹 요청. ads-sdk/web의 동형 계약. */
+interface TrackingRequestBase {
+    adGroupId: string;
+    requestId?: string;
+    creativeId?: string;
+    mediationId?: string;
+    eventContextToken?: string;
+    errorEndpoint?: string;
+}
+interface EventTrackingRequest extends TrackingRequestBase {
+    type: 'EVENT_TRACKING';
+    eventName: string;
+    urls: string[];
+    eventPayload: string;
+}
+type TrackingRequest = EventTrackingRequest;
 interface AdConfig {
     environment: Environment;
     apiEndpoint?: string;
@@ -893,6 +910,11 @@ interface AdConfig {
     runtimeInfo?: RuntimeInfo;
     opener?: AdOpener;
     customAdFetcher?: CustomAdFetcher;
+    /**
+     * 트래킹 전송 위임(SDK 3.1.0+). 지정 시 SDK는 직접 전송하지 않고 이 콜백에 위임한다.
+     * fire-and-forget이며 실패 관측은 사용측 책임. 현재 위임 대상은 EVENT_TRACKING이다.
+     */
+    onTrackingRequest?: (request: TrackingRequest) => void | Promise<void>;
 }
 interface AdRequest {
     spaceUnitId: string;
@@ -907,6 +929,7 @@ interface AdRequest {
 type AdResponseStatus = 'OK' | 'NO_AD' | 'BLOCKED' | 'ERROR' | 'TIMEOUT' | 'INVALID_SPACE' | 'INVALID_REQUEST' | 'LIMITED_AD' | 'CONSENT_REQUIRED' | 'TEST_MODE';
 interface AdResponse {
     requestId?: string;
+    eventContextToken?: string;
     status?: AdResponseStatus;
     ads: Ad[];
     ext?: AdResponseExt;
@@ -919,6 +942,19 @@ interface Ad {
     eventPayload?: string;
     requestId?: string;
 }
+interface TossAdsMediation {
+    mediationId: string;
+    priority: Array<'TOSS' | 'ADMOB'>;
+    admob: {
+        adUnitId: string;
+        placementId: number;
+    } | null;
+    endpoint?: {
+        result?: string;
+        exposure?: string;
+        error?: string;
+    };
+}
 interface AdResponseExt {
     skippableOffsetSeconds?: number;
     reward?: {
@@ -927,6 +963,7 @@ interface AdResponseExt {
     };
     isAdBadgeEnabled?: boolean;
     refetchSeconds?: number | null;
+    mediation?: TossAdsMediation;
 }
 interface ApiResponse<T> {
     resultType: 'SUCCESS' | 'HTTP_TIMEOUT' | 'NETWORK_ERROR' | 'EXECUTION_FAIL' | 'INTERRUPTED' | 'INTERNAL_ERROR' | 'FAIL';
@@ -958,10 +995,12 @@ interface BannerSlotErrorPayload {
     slotId: string;
     adGroupId: string;
     adMetadata: Record<string, never>;
+    /** `mediationId`는 `/api-web/v3/benefit-ads/display-ad/ads` 응답 수신 후 발생한 에러에만 포함된다. */
     error: {
         code: number;
         message: string;
         domain?: string;
+        mediationId?: string;
     };
 }
 interface BannerSlotCallbacks {
@@ -1095,4 +1134,10 @@ interface RequestNotificationAgreementOptions {
  */
 declare function requestNotificationAgreement(params: RequestNotificationAgreementOptions): () => void;
 
-export { type AddAccessoryButtonOptions, type AppsInTossEvent, type AppsInTossGlobals, type CompletedOrRefundedOrdersResult, type ConsumableProductListItem, type CreateSubscriptionPurchaseOrderOptions, GoogleAdMob, type GraniteEvent, IAP, type IapCreateOneTimePurchaseOrderOptions, type IapProductListItem, type IapSubscriptionInfoResponse, type IapSubscriptionInfoResult, type NonConsumableProductListItem, type NotificationAgreementResult, type RequestNotificationAgreementOptions, SafeAreaInsets$1 as SafeAreaInsets, Storage, type SubscriptionProductListItem, type TdsEvent, TossAds, type AttachBannerOptions as TossAdsAttachBannerOptions, type AttachBannerResult as TossAdsAttachBannerResult, type AttachOptions as TossAdsAttachOptions, type BannerSlotCallbacks as TossAdsBannerSlotCallbacks, type BannerSlotErrorPayload as TossAdsBannerSlotErrorPayload, type BannerSlotEventPayload as TossAdsBannerSlotEventPayload, type InitializeOptions as TossAdsInitializeOptions, appsInTossEvent, env, fetchAlbumPhotos, fetchContacts, getAppsInTossGlobals, getClipboardText, getCurrentLocation, getSafeAreaInsets, getServerTime, graniteEvent, isMinVersionSupported, loadFullScreenAd, openCamera, partner, requestNotificationAgreement, requestReview, setClipboardText, showFullScreenAd, startUpdateLocation, tdsEvent };
+declare const getDeclaredAgeRange: ((args_0: {
+    ageGates: number[];
+}) => Promise<DeclaredAgeRange>) & {
+    isSupported: () => boolean;
+};
+
+export { type AddAccessoryButtonOptions, type AppsInTossEvent, type AppsInTossGlobals, type CompletedOrRefundedOrdersResult, type ConsumableProductListItem, type CreateSubscriptionPurchaseOrderOptions, GoogleAdMob, type GraniteEvent, IAP, type IapCreateOneTimePurchaseOrderOptions, type IapProductListItem, type IapSubscriptionInfoResponse, type IapSubscriptionInfoResult, type NonConsumableProductListItem, type NotificationAgreementResult, type RequestNotificationAgreementOptions, SafeAreaInsets$1 as SafeAreaInsets, Storage, type SubscriptionProductListItem, type TdsEvent, TossAds, type AttachBannerOptions as TossAdsAttachBannerOptions, type AttachBannerResult as TossAdsAttachBannerResult, type AttachOptions as TossAdsAttachOptions, type BannerSlotCallbacks as TossAdsBannerSlotCallbacks, type BannerSlotErrorPayload as TossAdsBannerSlotErrorPayload, type BannerSlotEventPayload as TossAdsBannerSlotEventPayload, type InitializeOptions as TossAdsInitializeOptions, appsInTossEvent, env, fetchAlbumPhotos, fetchContacts, getAppsInTossGlobals, getClipboardText, getCurrentLocation, getDeclaredAgeRange, getSafeAreaInsets, getServerTime, graniteEvent, isMinVersionSupported, loadFullScreenAd, openCamera, partner, requestNotificationAgreement, requestReview, setClipboardText, showFullScreenAd, startUpdateLocation, tdsEvent };

package/dist/index.js

@@ -986,6 +986,197 @@ function resetAttachedBannerRegistry() {
   attachedBannerRegistry = /* @__PURE__ */ new WeakMap();
 }
 
+// src/toss-ad/constants.ts
+var ERROR_CODES = {
+  NETWORK_ERROR: 1001,
+  INVALID_REQUEST: 1002,
+  NO_AD: 1003,
+  ERROR: 1004,
+  INVALID_SPACE: 1005,
+  SDK_NOT_INITIALIZED: 1007,
+  HTTP_TIMEOUT: 1008,
+  EXECUTION_FAIL: 1009,
+  INTERRUPTED: 1010,
+  FAIL: 1011,
+  BLOCKED: 1012,
+  TIMEOUT: 1013,
+  LIMITED_AD: 1014,
+  CONSENT_REQUIRED: 1015,
+  TEST_MODE: 1016,
+  INTERNAL_ERROR: 1017
+};
+var NON_ERROR_STATUSES = /* @__PURE__ */ new Set(["OK", "TEST_MODE", "NO_AD"]);
+var API_RESULT_ERROR_CODE_MAP = {
+  HTTP_TIMEOUT: ERROR_CODES.HTTP_TIMEOUT,
+  NETWORK_ERROR: ERROR_CODES.NETWORK_ERROR,
+  EXECUTION_FAIL: ERROR_CODES.EXECUTION_FAIL,
+  INTERRUPTED: ERROR_CODES.INTERRUPTED,
+  INTERNAL_ERROR: ERROR_CODES.ERROR,
+  FAIL: ERROR_CODES.FAIL
+};
+var AD_STATUS_ERROR_CODE_MAP = {
+  BLOCKED: ERROR_CODES.BLOCKED,
+  ERROR: ERROR_CODES.ERROR,
+  TIMEOUT: ERROR_CODES.TIMEOUT,
+  INVALID_SPACE: ERROR_CODES.INVALID_SPACE,
+  INVALID_REQUEST: ERROR_CODES.INVALID_REQUEST,
+  LIMITED_AD: ERROR_CODES.LIMITED_AD,
+  CONSENT_REQUIRED: ERROR_CODES.CONSENT_REQUIRED
+};
+
+// src/toss-ad/tossAdEventLog.ts
+var tossAdEventLog = createAsyncBridge("tossAdEventLog");
+
+// src/toss-ad/errorTracking.ts
+var BANNER_ERROR_LOG_NAME = "display_ads_all::error__banner";
+function logBannerErrorToAppLog(info) {
+  void tossAdEventLog({
+    log_name: BANNER_ERROR_LOG_NAME,
+    log_type: "debug",
+    params: {
+      error_code: info.errorCode,
+      error_message: info.errorMessage,
+      ad_group_id: info.adGroupId,
+      mediation_id: info.mediationId,
+      event_context_token: info.eventContextToken
+    }
+  }).catch(() => {
+  });
+}
+function trackBannerError(info) {
+  if (info.endpointError) {
+    void fetch(info.endpointError, {
+      method: "POST",
+      headers: { "Content-Type": "application/json" },
+      body: JSON.stringify({
+        eventContextToken: info.eventContextToken,
+        mediationId: info.mediationId,
+        errorCode: info.errorCode,
+        errorMessage: info.errorMessage
+      })
+      // POST 실패(CORS·네트워크) → 앱로그 fallback (endpoint와 같은 채널이라 함께 막히는 경우 대비).
+    }).catch(() => logBannerErrorToAppLog(info));
+    return;
+  }
+  logBannerErrorToAppLog(info);
+}
+function trackResponseError(response, adGroupId, context) {
+  if (response.resultType !== "SUCCESS") {
+    trackBannerError({
+      adGroupId,
+      errorCode: API_RESULT_ERROR_CODE_MAP[response.resultType] ?? ERROR_CODES.INTERNAL_ERROR,
+      errorMessage: response.error?.reason ?? response.resultType
+    });
+    return;
+  }
+  const success = response.success;
+  if (!success || NON_ERROR_STATUSES.has(String(success.status))) {
+    return;
+  }
+  trackBannerError({
+    adGroupId,
+    errorCode: AD_STATUS_ERROR_CODE_MAP[String(success.status)] ?? ERROR_CODES.INTERNAL_ERROR,
+    mediationId: context.mediationId,
+    eventContextToken: context.eventContextToken,
+    errorMessage: `Ad response status: ${success.status}`,
+    endpointError: context.errorEndpoint
+  });
+}
+
+// src/toss-ad/eventTracking.ts
+async function handleTrackingRequest(request) {
+  if (request.type === "EVENT_TRACKING") {
+    await sendEventTracking(request);
+  }
+}
+async function sendEventTracking(request) {
+  if (request.urls.length === 0) {
+    return;
+  }
+  const body = JSON.stringify({ type: request.eventName, data: request.eventPayload });
+  const headers = { "Content-Type": "application/json" };
+  if (request.requestId) {
+    headers["X-Toss-RequestId"] = request.requestId;
+  }
+  const settled = await Promise.allSettled(
+    request.urls.map(
+      (url) => fetch(url, { method: "POST", headers, body }).then((response) => {
+        if (!response.ok) {
+          throw new Error(`HTTP ${response.status}`);
+        }
+      })
+    )
+  );
+  const failedCount = settled.filter((result) => result.status === "rejected").length;
+  if (failedCount === 0) {
+    return;
+  }
+  trackBannerError({
+    adGroupId: request.adGroupId,
+    errorCode: ERROR_CODES.NETWORK_ERROR,
+    errorMessage: `EVENT_TRACKING failed: ${request.eventName} (${failedCount}/${request.urls.length})`,
+    mediationId: request.mediationId || void 0,
+    eventContextToken: request.eventContextToken || void 0,
+    endpointError: request.errorEndpoint
+  });
+}
+
+// src/toss-ad/fetchAppsInTossAdSchema.ts
+var APPS_IN_TOSS_AD_SPEC_VERSION = "1.4.1";
+var FETCH_APPS_IN_TOSS_AD_DEVICE_MACRO = "{{device}}";
+var TOSS_APP_BUNDLE_IDS = {
+  ios: "com.vivarepublica.cash",
+  android: "viva.republica.toss"
+};
+function resolveTossAppBundleId(os) {
+  return TOSS_APP_BUNDLE_IDS[os];
+}
+
+// src/toss-ad/normalize.ts
+var LIST_BANNER_STYLE_ID = "1";
+var NATIVE_IMAGE_STYLE_ID = "2";
+var AVAILABLE_STYLE_IDS = [LIST_BANNER_STYLE_ID, NATIVE_IMAGE_STYLE_ID];
+var SUPPORTED_STYLE_IDS = new Set(AVAILABLE_STYLE_IDS);
+function normalizeAdResponse(adResponse) {
+  const ads = Array.isArray(adResponse.ads) ? adResponse.ads.filter((ad) => SUPPORTED_STYLE_IDS.has(String(ad.styleId))) : [];
+  return {
+    requestId: adResponse.requestId ?? "",
+    // SDK가 event 트래킹 위임(onTrackingRequest) 시 응답 top-level에서 읽어 실어 보낸다.
+    // 떼어내면 SDK가 토큰을 못 보고, event 트래킹 실패 시 endpoint.error에서 토큰이 빠진다.
+    eventContextToken: adResponse.eventContextToken,
+    status: adResponse.status ?? "OK",
+    ads,
+    ext: adResponse.ext
+  };
+}
+function normalizeApiResponse(raw) {
+  if (isApiResponse(raw)) {
+    if (raw.resultType !== "SUCCESS") {
+      return raw;
+    }
+    if (!raw.success) {
+      return {
+        resultType: "FAIL",
+        error: { reason: "fetchTossAd returned SUCCESS without payload" }
+      };
+    }
+    return { ...raw, success: normalizeAdResponse(raw.success) };
+  }
+  if (isAdResponse(raw)) {
+    return {
+      resultType: "SUCCESS",
+      success: normalizeAdResponse(raw)
+    };
+  }
+  return { resultType: "FAIL", error: { reason: "Invalid response from fetchTossAd" } };
+}
+function isApiResponse(payload) {
+  return Boolean(payload && typeof payload === "object" && "resultType" in payload);
+}
+function isAdResponse(payload) {
+  return Boolean(payload && typeof payload === "object" && "ads" in payload);
+}
+
 // src/toss-ad/opener.ts
 var openURL = createAsyncBridge("openURL");
 function openUrlOpener(url) {
@@ -1000,8 +1191,49 @@ function supertossWeb(uri) {
   return `supertoss://web?url=${encodeURIComponent(uri)}&external=true`;
 }
 
+// src/toss-ad/resultTracking.ts
+async function fireResultTracking(response, adGroupId, ctx) {
+  const status = response.success?.status;
+  if (response.resultType !== "SUCCESS" || status !== "OK" && status !== "TEST_MODE") {
+    return;
+  }
+  if (ctx.resultEndpoint == null || ctx.mediationId == null) {
+    return;
+  }
+  const body = {
+    mediationId: ctx.mediationId,
+    spaceUnitId: adGroupId,
+    requestId: response.success?.requestId ?? "",
+    eventContextToken: ctx.eventContextToken,
+    winnerSource: "TOSS",
+    content: null,
+    adUnitId: ctx.adUnitId ?? null,
+    placementId: ctx.placementId ?? null,
+    tossFailed: null
+  };
+  try {
+    const res = await fetch(ctx.resultEndpoint, {
+      method: "POST",
+      headers: { "Content-Type": "application/json" },
+      body: JSON.stringify(body)
+    });
+    if (!res.ok) {
+      throw new Error(`HTTP ${res.status}`);
+    }
+  } catch (error) {
+    trackBannerError({
+      adGroupId,
+      errorCode: ERROR_CODES.NETWORK_ERROR,
+      errorMessage: `RESULT_TRACKING failed: ${error instanceof Error ? error.message : String(error)}`,
+      mediationId: ctx.mediationId,
+      eventContextToken: ctx.eventContextToken,
+      endpointError: ctx.errorEndpoint
+    });
+  }
+}
+
 // src/toss-ad/scriptLoader.ts
-var DEFAULT_SDK_URL = "https://static.toss.im/ads/sdk/toss-ads-space-kit-1.3.0.js";
+var DEFAULT_SDK_URL = "https://static.toss.im/ads/sdk/toss-ads-space-kit-3.1.0.js";
 var DEFAULT_TIMEOUT_MS = 15e3;
 var pendingLoad = null;
 function getAdsSdk() {
@@ -1057,12 +1289,79 @@ function loadAdsSdk() {
   return promise;
 }
 
+// package.json
+var package_default = {
+  name: "@apps-in-toss/web-bridge",
+  type: "module",
+  version: "2.10.1",
+  description: "Web Bridge for Apps In Toss",
+  scripts: {
+    typecheck: "tsc --noEmit",
+    lint: "eslint .",
+    build: "tsup"
+  },
+  main: "./dist/index.cjs",
+  module: "./dist/index.js",
+  types: "./dist/index.d.ts",
+  exports: {
+    ".": {
+      import: {
+        types: "./dist/index.d.ts",
+        default: "./dist/index.js"
+      },
+      require: {
+        types: "./dist/index.d.cts",
+        default: "./dist/index.cjs"
+      }
+    }
+  },
+  files: [
+    "dist"
+  ],
+  dependencies: {
+    "@apps-in-toss/types": "workspace:*"
+  },
+  devDependencies: {
+    "@apps-in-toss/bridge-core": "workspace:*",
+    "@apps-in-toss/native-modules": "workspace:^",
+    "@swc/core": "^1.12.7",
+    picocolors: "^1.1.1",
+    "ts-morph": "^26.0.0",
+    tsup: "^8.5.0",
+    typescript: "5.8.3",
+    vitest: "^3.1.2"
+  }
+};
+
+// src/toss-ad/sdkVersion.ts
+var SDK_VERSION = package_default.version;
+
+// src/toss-ad/trackingContext.ts
+function nonEmptyString(value) {
+  return typeof value === "string" && value.length > 0 ? value : void 0;
+}
+function extractAdTrackingContext(response) {
+  const mediation = response?.ext?.mediation;
+  return {
+    mediationId: nonEmptyString(mediation?.mediationId),
+    eventContextToken: nonEmptyString(response?.eventContextToken),
+    resultEndpoint: nonEmptyString(mediation?.endpoint?.result),
+    errorEndpoint: nonEmptyString(mediation?.endpoint?.error),
+    adUnitId: nonEmptyString(mediation?.admob?.adUnitId),
+    placementId: typeof mediation?.admob?.placementId === "number" ? mediation.admob.placementId : void 0
+  };
+}
+
 // src/toss-ad/index.ts
 var fetchTossAd = Object.assign(createEventBridge("fetchTossAd"), {
   isSupported: createConstantBridge("fetchTossAd_isSupported")
 });
-var tossAdEventLog = createAsyncBridge("tossAdEventLog");
-var SUPPORTED_STYLE_IDS = /* @__PURE__ */ new Set(["1", "2"]);
+var fetchAppsInTossAd = Object.assign(createEventBridge("fetchAppsInTossAd"), {
+  isSupported: createConstantBridge("fetchAppsInTossAd_isSupported")
+});
+var getPlatformOS = createConstantBridge("getPlatformOS");
+var getTossAppVersion = createConstantBridge("getTossAppVersion");
+var WEB_SDK_ID = "108";
 var INVALID_AD_GROUP_ID_ERROR_MESSAGE = "\uC798\uBABB\uB41C \uC694\uCCAD\uC774\uC5D0\uC694. \uD544\uC694\uD55C \uAC12\uC774 \uBE44\uC5B4 \uC788\uC5B4\uC694.";
 function normalizeAdGroupId(adGroupId) {
   return adGroupId.trim();
@@ -1099,62 +1398,56 @@ function fetchTossAdPromise(options) {
     });
   });
 }
-function normalizeAdResponse(adResponse) {
-  const ads = Array.isArray(adResponse.ads) ? adResponse.ads.filter((ad) => SUPPORTED_STYLE_IDS.has(String(ad.styleId))) : [];
-  return {
-    requestId: adResponse.requestId ?? "",
-    status: adResponse.status ?? "OK",
-    ads,
-    ext: adResponse.ext
-  };
+function getSubBundle() {
+  return globalThis.__granite?.app?.name ?? "";
 }
-function normalizeApiResponse(raw) {
-  if (isApiResponse(raw)) {
-    if (raw.resultType !== "SUCCESS") {
-      return raw;
-    }
-    if (!raw.success) {
-      return {
-        resultType: "FAIL",
-        error: { reason: "fetchTossAd returned SUCCESS without payload" }
-      };
+function fetchAppsInTossAdPromise(spaceUnitId) {
+  const platformOS = getPlatformOS();
+  const tossAppVersion = getTossAppVersion();
+  const body = {
+    specVersion: APPS_IN_TOSS_AD_SPEC_VERSION,
+    platform: "WEB",
+    spaceUnitId,
+    sdkVersion: SDK_VERSION,
+    availableStyleIds: AVAILABLE_STYLE_IDS,
+    // device는 매크로키만 보내고 native가 실제 device로 치환한다.
+    device: FETCH_APPS_IN_TOSS_AD_DEVICE_MACRO,
+    app: {
+      version: tossAppVersion,
+      bundle: resolveTossAppBundleId(platformOS),
+      subBundle: getSubBundle()
     }
-    return { ...raw, success: normalizeAdResponse(raw.success) };
-  }
-  if (isAdResponse(raw)) {
-    return {
-      resultType: "SUCCESS",
-      success: normalizeAdResponse(raw)
-    };
-  }
-  return { resultType: "FAIL", error: { reason: "Invalid response from fetchTossAd" } };
-}
-function isApiResponse(payload) {
-  return Boolean(payload && typeof payload === "object" && "resultType" in payload);
-}
-function isAdResponse(payload) {
-  return Boolean(payload && typeof payload === "object" && "ads" in payload);
+  };
+  return new Promise((resolve, reject) => {
+    fetchAppsInTossAd({ options: body, onEvent: resolve, onError: reject });
+  });
 }
 function createCustomAdFetcher() {
   return async (_endpoint, request) => {
     const spaceUnitId = normalizeAdGroupId(request.spaceUnitId);
     if (spaceUnitId.length === 0) {
+      trackBannerError({
+        adGroupId: spaceUnitId,
+        errorCode: ERROR_CODES.INVALID_SPACE,
+        errorMessage: INVALID_AD_GROUP_ID_ERROR_MESSAGE
+      });
       return createInvalidAdGroupIdResponse();
     }
     try {
-      const raw = await fetchTossAdPromise({
+      const raw = fetchAppsInTossAd.isSupported() ? await fetchAppsInTossAdPromise(spaceUnitId) : await fetchTossAdPromise({
         adGroupId: spaceUnitId,
-        sdkId: "108",
-        availableStyleIds: ["1", "2"]
+        sdkId: WEB_SDK_ID,
+        availableStyleIds: AVAILABLE_STYLE_IDS
       });
-      return normalizeApiResponse(raw);
+      const response = normalizeApiResponse(raw);
+      const trackingContext = extractAdTrackingContext(response.success);
+      trackResponseError(response, spaceUnitId, trackingContext);
+      void fireResultTracking(response, spaceUnitId, trackingContext);
+      return response;
     } catch (error) {
-      return {
-        resultType: "FAIL",
-        error: {
-          reason: error instanceof Error ? error.message : "Unknown fetchTossAd error"
-        }
-      };
+      const reason = error instanceof Error ? error.message : "Unknown fetchTossAd error";
+      trackBannerError({ adGroupId: spaceUnitId, errorCode: ERROR_CODES.NETWORK_ERROR, errorMessage: reason });
+      return { resultType: "FAIL", error: { reason } };
     }
   };
 }
@@ -1180,7 +1473,12 @@ function initialize(options) {
       return;
     }
     const customAdFetcher = createCustomAdFetcher();
-    const config = { environment: "live", customAdFetcher, opener: openUrlOpener };
+    const config = {
+      environment: "live",
+      customAdFetcher,
+      opener: openUrlOpener,
+      onTrackingRequest: handleTrackingRequest
+    };
     sdk.init(config);
   });
   pendingLoad2 = initPromise;
@@ -1357,7 +1655,7 @@ function attachBanner(adGroupId, target, options = {}) {
           autoLoad: true,
           theme: theme === "auto" ? void 0 : theme,
           renderPadding: (styleId) => {
-            if (styleId === "1") {
+            if (styleId === LIST_BANNER_STYLE_ID) {
               return DEFAULT_ATTACH_PADDING_BANNER;
             }
             return DEFAULT_ATTACH_PADDING_NATIVE_IMAGE;
@@ -1430,6 +1728,8 @@ function wrapCallbacks(adGroupId, callbacks) {
       });
       callbacks.onAdImpression?.(mapEvent(payload));
     },
+    // 에러 트래킹은 응답을 소유한 createCustomAdFetcher가 담당한다. 콜백은 publisher 전달만.
+    // 응답 수신 후 에러의 mediationId는 SDK(ads-sdk/web)가 error에 실어주므로 그대로 전달한다.
     onAdFailedToRender: (payload) => callbacks.onAdFailedToRender?.({
       ...mapEvent(payload),
       error: payload?.error ?? { code: 0, message: "UNKNOWN" }
@@ -1483,6 +1783,14 @@ function requestNotificationAgreement(params) {
   return unregisterCallbacks;
 }
 
+// src/getDeclaredAgeRange.ts
+var getDeclaredAgeRange = Object.assign(
+  createAsyncBridge("getDeclaredAgeRange"),
+  {
+    isSupported: createConstantBridge("getDeclaredAgeRange_isSupported")
+  }
+);
+
 // src/index.ts
 export * from "@apps-in-toss/types";
 export {
@@ -1501,6 +1809,7 @@ export {
   getAppsInTossGlobals,
   getClipboardText,
   getCurrentLocation,
+  getDeclaredAgeRange,
   getSafeAreaInsets,
   getServerTime,
   graniteEvent,

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@apps-in-toss/web-bridge",
   "type": "module",
-  "version": "2.9.3",
+  "version": "2.10.1",
   "description": "Web Bridge for Apps In Toss",
   "scripts": {
     "typecheck": "tsc --noEmit",
@@ -27,11 +27,11 @@
     "dist"
   ],
   "dependencies": {
-    "@apps-in-toss/types": "2.9.3"
+    "@apps-in-toss/types": "2.10.1"
   },
   "devDependencies": {
-    "@apps-in-toss/bridge-core": "2.9.3",
-    "@apps-in-toss/native-modules": "^2.9.3",
+    "@apps-in-toss/bridge-core": "2.10.1",
+    "@apps-in-toss/native-modules": "^2.10.1",
     "@swc/core": "^1.12.7",
     "picocolors": "^1.1.1",
     "ts-morph": "^26.0.0",