@adstage/web-sdk 2.3.6 → 2.4.0

package/src/react/AdStageProvider.tsx

@@ -1,117 +0,0 @@
-/**
- * AdStage SDK - React Provider
- * React 애플리케이션에서 AdStage SDK를 쉽게 사용할 수 있도록 하는 Provider 컴포넌트
- */
-
-import React, { createContext, useContext, useEffect, useState, ReactNode } from 'react';
-import AdStage from '../core/AdStage';
-import { AdStageConfig } from '../types/config';
-
-interface AdStageContextType {
-  isInitialized: boolean;
-  config: AdStageConfig | null;
-  initialize: (config: AdStageConfig) => void;
-  reset: () => void;
-  error: string | null;
-}
-
-const AdStageContext = createContext<AdStageContextType | null>(null);
-
-interface AdStageProviderProps {
-  children: ReactNode;
-  /**
-   * 자동 초기화를 위한 설정 (선택사항)
-   * 제공되면 Provider 마운트 시 자동으로 초기화됩니다.
-   */
-  config?: AdStageConfig;
-}
-
-export function AdStageProvider({ children, config }: AdStageProviderProps) {
-  const [isInitialized, setIsInitialized] = useState(false);
-  const [currentConfig, setCurrentConfig] = useState<AdStageConfig | null>(null);
-  const [error, setError] = useState<string | null>(null);
-
-  const initialize = (newConfig: AdStageConfig) => {
-    try {
-      setError(null);
-      
-      // 기존 인스턴스가 있으면 리셋
-      if (isInitialized) {
-        AdStage.reset();
-      }
-
-      AdStage.init(newConfig);
-
-      setCurrentConfig(newConfig);
-      setIsInitialized(true);
-      
-      if (newConfig.debug) {
-        console.log('✅ AdStage SDK initialized successfully via React Provider');
-      }
-    } catch (err) {
-      const errorMessage = err instanceof Error ? err.message : 'Unknown error';
-      setError(errorMessage);
-      console.error('❌ AdStage SDK initialization failed:', err);
-      setIsInitialized(false);
-      setCurrentConfig(null);
-    }
-  };
-
-  const reset = () => {
-    try {
-      AdStage.reset();
-      setIsInitialized(false);
-      setCurrentConfig(null);
-      setError(null);
-    } catch (err) {
-      console.error('❌ AdStage SDK reset failed:', err);
-    }
-  };
-
-  // 자동 초기화
-  useEffect(() => {
-    if (config && !isInitialized) {
-      initialize(config);
-    }
-  }, [config, isInitialized]);
-
-  const contextValue: AdStageContextType = {
-    isInitialized,
-    config: currentConfig,
-    initialize,
-    reset,
-    error
-  };
-
-  return (
-    <AdStageContext.Provider value={contextValue}>
-      {children}
-    </AdStageContext.Provider>
-  );
-}
-
-/**
- * AdStage Context Hook
- * AdStageProvider 내에서 SDK 상태에 접근할 수 있습니다.
- */
-export function useAdStage(): AdStageContextType {
-  const context = useContext(AdStageContext);
-  if (!context) {
-    throw new Error('useAdStage must be used within an AdStageProvider');
-  }
-  return context;
-}
-
-/**
- * AdStage SDK Hook
- * 초기화된 AdStage 인스턴스에 직접 접근할 수 있습니다.
- */
-export function useAdStageSDK() {
-  const { isInitialized } = useAdStage();
-  
-  if (!isInitialized) {
-    throw new Error('AdStage SDK is not initialized. Please call initialize() first or provide config to AdStageProvider.');
-  }
-  
-  return AdStage;
-}

package/src/react/index.ts

@@ -1,11 +0,0 @@
-/**
- * AdStage Web SDK - React Integration
- * React 애플리케이션을 위한 컴포넌트와 훅들
- */
-
-export { AdStageProvider, useAdStage, useAdStageSDK } from './AdStageProvider';
-
-// 타입들도 재export
-export type { AdStageConfig, ModuleName, BaseModule } from '../types/config';
-export type { AdOptions } from '../modules/ads/AdsModule';
-export type { AdType, AdEventType, Advertisement, AdSlot } from '../types/advertisement';

package/src/renderers/base-renderer.ts

@@ -108,24 +108,18 @@ export abstract class BaseAdRenderer implements AdRenderer {
   protected getImageStyles(slot?: AdSlot): Record<string, string> {
     const styles: Record<string, string> = {
       display: 'block',
-      'object-position': 'center', // 🎯 이미지 항상 중앙 정렬
+      'max-width': '100%',
+      height: 'auto',
     };
     
-    // 사용자가 컨테이너 크기를 지정했는지 확인
+    // 사용자가 컨테이너 크기를 지정한 경우에만 크기 제한
     const parsedWidth = this.parseSizeValue(slot?.width);
     const parsedHeight = this.parseSizeValue(slot?.height);
-    const hasUserDefinedSize = parsedWidth || parsedHeight;
     
-    if (hasUserDefinedSize) {
-      // 🎯 사용자가 크기를 지정한 경우: 컨테이너에 꽉 차도록 설정
+    if (parsedWidth && parsedHeight) {
       styles.width = '100%';
       styles.height = '100%';
-      styles['object-fit'] = 'cover'; // 컨테이너에 꽉 찬 상태로 비율 유지
-      styles['object-position'] = 'center';
-    } else {
-      // 사용자가 크기를 지정하지 않은 경우: 원본 이미지 크기 유지
-      styles['max-width'] = '100%';
-      styles.height = 'auto';
+      styles['object-fit'] = 'cover';
     }
     
     return styles;

package/src/types/advertisement.ts

@@ -16,8 +16,15 @@ export enum Platform {
 
 // 광고 이벤트 타입
 export enum AdEventType {
-  VIEWABLE = 'VIEWABLE',
+  IMPRESSION = 'IMPRESSION',
   CLICK = 'CLICK',
+  HOVER = 'HOVER',
+  VIEWABLE = 'VIEWABLE',
+  VIEWABLE_IMPRESSION = 'VIEWABLE_IMPRESSION',
+  COMPLETED = 'COMPLETED',
+  VIDEO_START = 'VIDEO_START',
+  VIDEO_COMPLETE = 'VIDEO_COMPLETE',
+  ERROR = 'ERROR',
 }
 
 // 디바이스 타입
@@ -72,7 +79,7 @@ export interface ViewabilityMetrics {
   isViewable: boolean;
   visibilityRatio: number;
   duration: number;
-  viewables: number;
+  impressions: number;
   attentionTime: number;
   scrollDepth: number;
   completionRate: number;
@@ -164,7 +171,7 @@ export interface AdSlot {
   config?: AdSlotConfig;
   advertisement?: Advertisement;
   isViewable?: boolean;
-  viewableSent?: boolean;
+  impressionSent?: boolean;
   loadTime?: number;
   renderTime?: number;
   events?: AdEvent[];
@@ -178,7 +185,13 @@ export interface AdSlot {
 
 // 광고 성과 지표
 export interface AdAnalytics {
-  viewables: number;
+  impressions: number;
   clicks: number;
+  hovers: number;
+  viewableImpressions: number;
+  errors: number;
   ctr: number; // Click Through Rate
+  viewabilityRate: number;
+  averageViewTime: number;
+  totalViewTime: number;
 }

package/src/types/api.ts

@@ -76,9 +76,13 @@ export interface AnalyticsRequest {
 
 // 광고 분석 응답
 export interface AnalyticsResponse {
-  viewables: number;
+  impressions: number;
   clicks: number;
+  hovers: number;
+  viewableImpressions: number;
+  errors: number;
   ctr: number;
+  viewabilityRate: number;
   breakdown?: Record<string, AdAnalytics>;
 }