@adstage/react-native-sdk 1.0.0

package/lib/typescript/src/event/AdStageEvent.d.ts

@@ -0,0 +1,426 @@
+/**
+ * AdStage Event 모듈
+ *
+ * 이벤트 트래킹을 담당합니다.
+ * Android AdStageEvent, iOS AdStageEventProtocol, Unity AdStageEvent와 동일한 표준 이벤트를 제공합니다.
+ *
+ * @since 3.0.0
+ */
+import type { TrackEventParams, TrackEventResult, SignUpMethod, PaymentMethod, EcommerceItem, AdPlatform, AdFormat, GameServerInfo, PatchInfo, StockTransactionInfo, AccountOpenInfo, CardApplicationInfo } from '../types';
+/**
+ * AdStage Event 클래스
+ *
+ * @example
+ * ```typescript
+ * // 커스텀 이벤트
+ * await AdStage.event.track('button_click', { buttonId: 'cta_1' });
+ *
+ * // 표준 이벤트
+ * await AdStage.event.trackPurchase({
+ *   value: 29.99,
+ *   currency: 'USD',
+ *   transactionId: 'TX_123'
+ * });
+ * ```
+ */
+export declare class AdStageEvent {
+    /**
+     * 커스텀 이벤트 전송
+     *
+     * @param eventName - 이벤트 이름
+     * @param params - 이벤트 파라미터 (자유 형식)
+     * @returns 전송 결과
+     *
+     * @example
+     * ```typescript
+     * await AdStage.event.track('button_click', {
+     *   buttonId: 'cta_purchase',
+     *   screenName: 'product_detail'
+     * });
+     * ```
+     */
+    static track(eventName: string, params?: TrackEventParams): Promise<TrackEventResult>;
+    /**
+     * 클릭 이벤트
+     */
+    static trackClick(params?: TrackEventParams): Promise<TrackEventResult>;
+    /**
+     * 뷰/노출 이벤트
+     */
+    static trackView(params?: TrackEventParams): Promise<TrackEventResult>;
+    /**
+     * 설치 이벤트 (일반적으로 SDK가 자동 전송)
+     */
+    static trackInstall(params?: TrackEventParams): Promise<TrackEventResult>;
+    /**
+     * 회원가입 완료 이벤트
+     *
+     * @param method - 가입 방법
+     *
+     * @example
+     * ```typescript
+     * await AdStage.event.trackSignUp('google');
+     * ```
+     */
+    static trackSignUp(method?: SignUpMethod): Promise<TrackEventResult>;
+    /**
+     * 회원가입 시작 이벤트
+     */
+    static trackSignUpStart(params?: TrackEventParams): Promise<TrackEventResult>;
+    /**
+     * 로그인 이벤트
+     *
+     * @param method - 로그인 방법
+     */
+    static trackLogin(method?: SignUpMethod): Promise<TrackEventResult>;
+    /**
+     * 로그아웃 이벤트
+     */
+    static trackLogout(params?: TrackEventParams): Promise<TrackEventResult>;
+    /**
+     * 홈 화면 조회 이벤트
+     */
+    static trackHomeView(params?: TrackEventParams): Promise<TrackEventResult>;
+    /**
+     * 상품 목록 조회 이벤트
+     *
+     * @param itemCategory - 상품 카테고리
+     */
+    static trackProductListView(itemCategory?: string): Promise<TrackEventResult>;
+    /**
+     * 검색 결과 조회 이벤트
+     *
+     * @param searchTerm - 검색어
+     */
+    static trackSearchResultView(searchTerm?: string): Promise<TrackEventResult>;
+    /**
+     * 상품 상세 조회 이벤트
+     */
+    static trackProductDetailsView(options?: {
+        itemId?: string;
+        itemName?: string;
+    }): Promise<TrackEventResult>;
+    /**
+     * 화면 조회 이벤트
+     */
+    static trackScreenView(options?: {
+        screenName?: string;
+        screenClass?: string;
+    }): Promise<TrackEventResult>;
+    /**
+     * 장바구니 추가 이벤트
+     */
+    static trackAddToCart(options: {
+        items: EcommerceItem[];
+        value?: number;
+        currency?: string;
+    }): Promise<TrackEventResult>;
+    /**
+     * 장바구니 제거 이벤트
+     */
+    static trackRemoveFromCart(options: {
+        items: EcommerceItem[];
+        value?: number;
+        currency?: string;
+    }): Promise<TrackEventResult>;
+    /**
+     * 결제 시작 이벤트
+     */
+    static trackBeginCheckout(options?: {
+        items?: EcommerceItem[];
+        value?: number;
+        currency?: string;
+        coupon?: string;
+    }): Promise<TrackEventResult>;
+    /**
+     * 결제 정보 추가 이벤트
+     */
+    static trackAddPaymentInfo(options?: {
+        paymentMethod?: PaymentMethod;
+    }): Promise<TrackEventResult>;
+    /**
+     * 구매 완료 이벤트
+     *
+     * @example
+     * ```typescript
+     * await AdStage.event.trackPurchase({
+     *   value: 99000,
+     *   currency: 'KRW',
+     *   transactionId: 'TX_123456',
+     *   items: [
+     *     { itemId: 'SKU_001', itemName: '상품명', price: 99000, quantity: 1 }
+     *   ]
+     * });
+     * ```
+     */
+    static trackPurchase(options: {
+        value: number;
+        currency: string;
+        transactionId?: string;
+        items?: EcommerceItem[];
+        paymentMethod?: PaymentMethod;
+        coupon?: string;
+        shipping?: number;
+        tax?: number;
+    }): Promise<TrackEventResult>;
+    /**
+     * 환불 이벤트
+     */
+    static trackRefund(options: {
+        transactionId: string;
+        value?: number;
+        currency?: string;
+        items?: EcommerceItem[];
+    }): Promise<TrackEventResult>;
+    /**
+     * 레벨업 이벤트
+     */
+    static trackLevelUp(options: {
+        level: number;
+        character?: string;
+    }): Promise<TrackEventResult>;
+    /**
+     * 튜토리얼 시작 이벤트
+     */
+    static trackTutorialBegin(params?: TrackEventParams): Promise<TrackEventResult>;
+    /**
+     * 튜토리얼 완료 이벤트
+     */
+    static trackTutorialComplete(params?: TrackEventParams): Promise<TrackEventResult>;
+    /**
+     * 업적 달성 이벤트
+     */
+    static trackUnlockAchievement(options: {
+        achievementId: string;
+        achievementName?: string;
+    }): Promise<TrackEventResult>;
+    /**
+     * 스테이지 클리어 이벤트
+     */
+    static trackStageClear(options: {
+        stageName: string;
+        stageNumber?: number;
+        score?: number;
+        duration?: number;
+    }): Promise<TrackEventResult>;
+    /**
+     * 가상화폐 획득 이벤트
+     */
+    static trackEarnVirtualCurrency(options: {
+        virtualCurrencyName: string;
+        value: number;
+    }): Promise<TrackEventResult>;
+    /**
+     * 가상화폐 사용 이벤트
+     */
+    static trackSpendVirtualCurrency(options: {
+        virtualCurrencyName: string;
+        value: number;
+        itemName?: string;
+    }): Promise<TrackEventResult>;
+    /**
+     * 공유 이벤트
+     */
+    static trackShare(options: {
+        method: string;
+        contentType?: string;
+        itemId?: string;
+    }): Promise<TrackEventResult>;
+    /**
+     * 앱 평가 이벤트
+     */
+    static trackRate(options: {
+        rating: number;
+        maxRating?: number;
+    }): Promise<TrackEventResult>;
+    /**
+     * 구독 시작 이벤트
+     */
+    static trackSubscribe(options: {
+        subscriptionId: string;
+        value?: number;
+        currency?: string;
+        period?: string;
+    }): Promise<TrackEventResult>;
+    /**
+     * 푸시 알림 클릭 이벤트
+     */
+    static trackNotificationClick(options?: {
+        notificationId?: string;
+        title?: string;
+        body?: string;
+    }): Promise<TrackEventResult>;
+    /**
+     * 앱 최초 실행 이벤트 (Unity: FirstOpenEvent)
+     */
+    static trackFirstOpen(params?: TrackEventParams): Promise<TrackEventResult>;
+    /**
+     * 페이지 조회 이벤트 (Unity: PageViewEvent) - 웹뷰용
+     */
+    static trackPageView(options?: {
+        pageUrl?: string;
+        pageTitle?: string;
+        pagePath?: string;
+        referrer?: string;
+    }): Promise<TrackEventResult>;
+    /**
+     * 위시리스트 추가 이벤트 (Unity: AddToWishlistEvent)
+     */
+    static trackAddToWishlist(options?: {
+        itemId?: string;
+        itemName?: string;
+        value?: number;
+        currency?: string;
+    }): Promise<TrackEventResult>;
+    /**
+     * 체험판 시작 이벤트 (Unity: StartTrialEvent)
+     *
+     * @example
+     * ```typescript
+     * await AdStage.event.trackStartTrial({
+     *   value: 9900.0,
+     *   currency: 'KRW',
+     *   trialDays: 14
+     * });
+     * ```
+     */
+    static trackStartTrial(options?: {
+        value?: number;
+        currency?: string;
+        trialDays?: number;
+    }): Promise<TrackEventResult>;
+    /**
+     * 구독 해지 이벤트 (Unity: UnsubscribeEvent)
+     */
+    static trackUnsubscribe(subscriptionId: string): Promise<TrackEventResult>;
+    /**
+     * 인앱 광고 노출 이벤트 (Unity: AdImpressionEvent)
+     */
+    static trackAdImpression(options?: {
+        adPlatform?: AdPlatform | string;
+        adSource?: string;
+        adFormat?: AdFormat | string;
+        adUnitName?: string;
+        value?: number;
+        currency?: string;
+    }): Promise<TrackEventResult>;
+    /**
+     * 인앱 광고 클릭 이벤트 (Unity: AdClickEvent)
+     */
+    static trackAdClick(options?: {
+        adPlatform?: AdPlatform | string;
+        adSource?: string;
+        adFormat?: AdFormat | string;
+        adUnitName?: string;
+    }): Promise<TrackEventResult>;
+    /**
+     * 게임 플레이 이벤트 (Unity: GamePlayEvent)
+     *
+     * @example
+     * ```typescript
+     * await AdStage.event.trackGamePlay({
+     *   level: 10,
+     *   levelName: "Dragon's Lair",
+     *   character: 'mage',
+     *   contentType: 'dungeon'
+     * });
+     * ```
+     */
+    static trackGamePlay(options?: {
+        level?: number;
+        levelName?: string;
+        character?: string;
+        contentType?: string;
+    }): Promise<TrackEventResult>;
+    /**
+     * 보너스 획득 이벤트 (Unity: AcquireBonusEvent)
+     *
+     * @example
+     * ```typescript
+     * await AdStage.event.trackAcquireBonus({
+     *   contentType: 'reward',
+     *   itemId: 'ITEM_123',
+     *   itemName: 'Gold Chest',
+     *   quantity: 1
+     * });
+     * ```
+     */
+    static trackAcquireBonus(options?: {
+        contentType?: string;
+        itemId?: string;
+        itemName?: string;
+        quantity?: number;
+    }): Promise<TrackEventResult>;
+    /**
+     * 게임 서버 선택 이벤트 (Unity: SelectGameServerEvent)
+     *
+     * @example
+     * ```typescript
+     * await AdStage.event.trackSelectGameServer({
+     *   contentId: 'SERVER_01',
+     *   contentType: 'pvp',
+     *   itemName: 'Asia Server'
+     * });
+     * ```
+     */
+    static trackSelectGameServer(serverInfo: GameServerInfo): Promise<TrackEventResult>;
+    /**
+     * 패치 완료 이벤트 (Unity: CompletePatchEvent)
+     *
+     * @example
+     * ```typescript
+     * await AdStage.event.trackCompletePatch({
+     *   contentId: 'PATCH_2.1.0',
+     *   contentType: 'update'
+     * });
+     * ```
+     */
+    static trackCompletePatch(patchInfo: PatchInfo): Promise<TrackEventResult>;
+    /**
+     * 검색 이벤트 (Unity: SearchEvent)
+     */
+    static trackSearch(searchTerm?: string): Promise<TrackEventResult>;
+    /**
+     * 콘텐츠 선택 이벤트 (Unity: SelectContentEvent)
+     */
+    static trackSelectContent(options?: {
+        contentType?: string;
+        contentId?: string;
+    }): Promise<TrackEventResult>;
+    /**
+     * 좋아요 이벤트 (Unity: LikeEvent)
+     */
+    static trackLike(options?: {
+        contentType?: string;
+        contentId?: string;
+    }): Promise<TrackEventResult>;
+    /**
+     * 일정 등록 이벤트 (Unity: ScheduleEvent)
+     */
+    static trackSchedule(params?: TrackEventParams): Promise<TrackEventResult>;
+    /**
+     * 크레딧 사용 이벤트 (Unity: SpendCreditsEvent)
+     */
+    static trackSpendCredits(options?: {
+        value?: number;
+        contentType?: string;
+        contentId?: string;
+    }): Promise<TrackEventResult>;
+    /**
+     * 주식 매도 이벤트 (Unity: SellStockEvent)
+     */
+    static trackSellStock(transaction: StockTransactionInfo): Promise<TrackEventResult>;
+    /**
+     * 주식 매수 이벤트 (Unity: BuyStockEvent)
+     */
+    static trackBuyStock(transaction: StockTransactionInfo): Promise<TrackEventResult>;
+    /**
+     * 계좌 개설 완료 이벤트 (Unity: CompleteOpenAccountEvent)
+     */
+    static trackCompleteOpenAccount(accountInfo: AccountOpenInfo): Promise<TrackEventResult>;
+    /**
+     * 카드 신청 이벤트 (Unity: ApplyCardEvent)
+     */
+    static trackApplyCard(cardInfo: CardApplicationInfo): Promise<TrackEventResult>;
+}
+//# sourceMappingURL=AdStageEvent.d.ts.map

package/lib/typescript/src/event/AdStageEvent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AdStageEvent.d.ts","sourceRoot":"","sources":["../../../../src/event/AdStageEvent.ts"],"names":[],"mappings":"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"}

package/lib/typescript/src/index.d.ts

@@ -0,0 +1,13 @@
+/**
+ * AdStage React Native SDK
+ *
+ * 광고 어트리뷰션, 딥링크, 프로모션을 위한 통합 SDK
+ *
+ * @since 3.0.0
+ */
+export { AdStage } from './AdStage';
+export { AdStageDeepLink } from './deeplink/AdStageDeepLink';
+export { AdStagePromotion } from './promotion/AdStagePromotion';
+export { AdStageEvent } from './event/AdStageEvent';
+export type { AdStageConfig, DeepLinkData, DeepLinkSource, DeepLinkListener, CreateDeepLinkRequest, CreateDeepLinkResponse, RedirectConfig, PlatformConfig, PromotionListParams, PromotionListResponse, Promotion, PromotionDeepLink, PromotionClickResult, TrackEventParams, TrackEventResult, UserAttributes, SignUpMethod, PaymentMethod, EcommerceItem, AdPlatform, AdFormat, GameServerInfo, PatchInfo, StockTransactionInfo, AccountOpenInfo, CardApplicationInfo, } from './types';
+//# sourceMappingURL=index.d.ts.map

package/lib/typescript/src/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAC7D,OAAO,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AAChE,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAGpD,YAAY,EAEV,aAAa,EAEb,YAAY,EACZ,cAAc,EACd,gBAAgB,EAChB,qBAAqB,EACrB,sBAAsB,EACtB,cAAc,EACd,cAAc,EAEd,mBAAmB,EACnB,qBAAqB,EACrB,SAAS,EACT,iBAAiB,EACjB,oBAAoB,EAEpB,gBAAgB,EAChB,gBAAgB,EAChB,cAAc,EAEd,YAAY,EACZ,aAAa,EACb,aAAa,EAEb,UAAU,EACV,QAAQ,EACR,cAAc,EACd,SAAS,EACT,oBAAoB,EACpB,eAAe,EACf,mBAAmB,GACpB,MAAM,SAAS,CAAC"}

package/lib/typescript/src/promotion/AdStagePromotion.d.ts

@@ -0,0 +1,98 @@
+/**
+ * AdStage Promotion 모듈
+ *
+ * 프로모션 조회, 표시, 클릭 처리를 담당합니다.
+ * Android/iOS PromotionHandler, PromotionManager와 동일한 API를 제공합니다.
+ *
+ * @since 3.0.0
+ */
+import type { PromotionListParams, PromotionListResponse, Promotion, PromotionClickResult } from '../types';
+/**
+ * AdStage Promotion 클래스
+ *
+ * @example
+ * ```typescript
+ * // 프로모션 목록 조회
+ * const response = await AdStage.promotion.getList({
+ *   bannerType: 'NATIVE',
+ *   region: 'KR',
+ *   limit: 10
+ * });
+ *
+ * // 프로모션 클릭 처리
+ * const result = await AdStage.promotion.handleClick(response.promotions[0]);
+ * ```
+ */
+export declare class AdStagePromotion {
+    /**
+     * 프로모션 목록 조회
+     *
+     * @param params - 조회 파라미터
+     * @returns 프로모션 목록 응답
+     *
+     * @example
+     * ```typescript
+     * const response = await AdStage.promotion.getList({
+     *   bannerType: 'NATIVE',          // NATIVE, INTERSTITIAL, REWARDED_VIDEO, POPUP
+     *   region: 'KR',                   // KR, JP, US, SEA, EU, GLOBAL
+     *   deviceType: 'HIGH_END',         // LOW_END, MID_END, HIGH_END
+     *   limit: 10,
+     *   status: 'ACTIVE',
+     *   partner: 'game_company',
+     *   primaryInterest: 'GAMES',
+     *   primaryAgeGroup: '18-24',
+     *   gameGenrePreference: 'RPG',
+     *   playerSpendingTier: 'DOLPHIN',  // F2P, DOLPHIN, WHALE
+     *   playTimePattern: 'EVENING'
+     * });
+     *
+     * console.log('Total:', response.totalItems);
+     * response.promotions.forEach(promo => {
+     *   console.log(`${promo.appName}: ${promo.bannerUrl}`);
+     * });
+     * ```
+     */
+    static getList(params?: PromotionListParams): Promise<PromotionListResponse>;
+    /**
+     * 프로모션 클릭 처리
+     *
+     * 클릭 이벤트를 서버에 전송하고 스토어를 엽니다.
+     *
+     * @param promotion - 클릭할 프로모션
+     * @returns 클릭 처리 결과
+     *
+     * @example
+     * ```typescript
+     * const result = await AdStage.promotion.handleClick(promotion);
+     *
+     * if (result.success) {
+     *   console.log('스토어로 이동:', result.storeUrl);
+     * } else {
+     *   console.error('클릭 처리 실패:', result.error);
+     * }
+     * ```
+     */
+    static handleClick(promotion: Promotion): Promise<PromotionClickResult>;
+    /**
+     * 프로모션 노출 이벤트 전송
+     *
+     * 프로모션이 화면에 표시될 때 호출합니다.
+     *
+     * @param promotion - 노출된 프로모션
+     *
+     * @example
+     * ```typescript
+     * // 프로모션 배너가 화면에 보일 때
+     * AdStage.promotion.trackImpression(promotion);
+     * ```
+     */
+    static trackImpression(promotion: Promotion): Promise<void>;
+    /**
+     * 플랫폼에 맞는 스토어 URL 추출
+     *
+     * @param promotion - 프로모션
+     * @returns 스토어 URL 또는 null
+     */
+    static getStoreUrl(promotion: Promotion): string | null;
+}
+//# sourceMappingURL=AdStagePromotion.d.ts.map

package/lib/typescript/src/promotion/AdStagePromotion.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AdStagePromotion.d.ts","sourceRoot":"","sources":["../../../../src/promotion/AdStagePromotion.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,KAAK,EACV,mBAAmB,EACnB,qBAAqB,EACrB,SAAS,EACT,oBAAoB,EACrB,MAAM,UAAU,CAAC;AAIlB;;;;;;;;;;;;;;;GAeG;AACH,qBAAa,gBAAgB;IAK3B;;;;;;;;;;;;;;;;;;;;;;;;;;;OA2BG;WACU,OAAO,CAClB,MAAM,GAAE,mBAAwB,GAC/B,OAAO,CAAC,qBAAqB,CAAC;IAiBjC;;;;;;;;;;;;;;;;;;OAkBG;WACU,WAAW,CAAC,SAAS,EAAE,SAAS,GAAG,OAAO,CAAC,oBAAoB,CAAC;IAoB7E;;;;;;;;;;;;OAYG;WACU,eAAe,CAAC,SAAS,EAAE,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC;IAWjE;;;;;OAKG;IACH,MAAM,CAAC,WAAW,CAAC,SAAS,EAAE,SAAS,GAAG,MAAM,GAAG,IAAI;CAKxD"}