@apps-in-toss/web-bridge 2.9.2 → 2.10.0

package/dist/index.cjs

@@ -1035,6 +1035,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 +1240,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 +1338,79 @@ function loadAdsSdk() {
   return promise;
 }
 
+// package.json
+var package_default = {
+  name: "@apps-in-toss/web-bridge",
+  type: "module",
+  version: "2.10.0",
+  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 +1447,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 +1522,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 +1704,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 +1777,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" }

package/dist/index.d.cts

@@ -885,6 +885,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 +909,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 +928,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 +941,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 +962,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 +994,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 {

package/dist/index.d.ts

@@ -885,6 +885,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 +909,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 +928,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 +941,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 +962,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 +994,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 {

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.0",
+  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" }

package/package.json

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