# npm
npm install @adstage/react-native-sdk
 
# yarn
yarn add @adstage/react-native-sdk

cd ios && pod install

import { AdStage } from '@adstage/react-native-sdk';
 
// 앱 시작 시 초기화
const initializeAdStage = async () => {
  try {
    await AdStage.initialize({
      apiKey: 'your-api-key-here',
      serverUrl: 'https://api.adstage.app', // 선택사항 (기본값: https://api.adstage.app)
    });
    
    console.log('✅ AdStage SDK 초기화 완료');
  } catch (error) {
    console.error('❌ AdStage 초기화 실패:', error);
  }
};

import { AdStage } from '@adstage/react-native-sdk';
 
// 커스텀 이벤트 전송
const result = await AdStage.event.track('button_click', {
  button_id: 'purchase_btn',
  screen_name: 'product_detail',
});
 
if (result.success) {
  console.log('✅ 이벤트 전송 성공');
} else {
  console.error('❌ 이벤트 전송 실패:', result.error);
}

interface TrackEventResult {
  success: boolean;
  eventId?: string;
  error?: string;
}

// 1. 앱 최초 실행
await AdStage.event.trackFirstOpen();
 
// 2. 회원가입 시작
await AdStage.event.trackSignUpStart();
 
// 3. 회원가입 완료 ⭐
//    method 인자에는 가입 방법(email, google, apple, kakao, naver 등)을 전달
await AdStage.event.trackSignUp('email');
 
// 4. 로그인 ⭐
//    method 인자에는 로그인 방법(email, google, apple, kakao, naver 등)을 전달
await AdStage.event.trackLogin('kakao');
 
// 5. 로그아웃
await AdStage.event.trackLogout();

// 1. 홈 화면 조회
await AdStage.event.trackHomeView();
 
// 2. 상품 목록 조회 (인자는 상품 카테고리)
await AdStage.event.trackProductListView('여성의류');
 
// 3. 검색 결과 조회 (인자는 검색어)
await AdStage.event.trackSearchResultView('무선 이어폰');
 
// 4. 상품 상세 조회
await AdStage.event.trackProductDetailsView({
  itemId: 'PROD_123',
  itemName: 'Wireless Earbuds',
});
 
// 5. 페이지 조회 (웹뷰)
await AdStage.event.trackPageView({
  pageUrl: 'https://example.com/products',
  pageTitle: 'Products',
});
 
// 6. 화면 조회 (앱)
await AdStage.event.trackScreenView({
  screenName: 'product_detail',
  screenClass: 'ProductDetailScreen',
});
 
// 7. 콘텐츠 선택
await AdStage.event.trackSelectContent({
  contentType: 'banner',
  contentId: 'BANNER_001',
});

// 1. 장바구니 추가
await AdStage.event.trackAddToCart({
  items: [
    {
      itemId: 'PROD_123',
      itemName: 'Wireless Earbuds',
      price: 99000,
      quantity: 1,
    },
  ],
  value: 99000,
  currency: 'KRW',
});
 
// 2. 장바구니 제거
await AdStage.event.trackRemoveFromCart({
  items: [{ itemId: 'PROD_123', itemName: 'Wireless Earbuds' }],
  value: 99000,
  currency: 'KRW',
});
 
// 3. 위시리스트 추가
await AdStage.event.trackAddToWishlist({
  itemId: 'PROD_456',
  itemName: 'Smart Watch',
  value: 350000,
  currency: 'KRW',
});
 
// 4. 결제 정보 입력
await AdStage.event.trackAddPaymentInfo({
  paymentMethod: 'credit_card',
});
 
// 5. 결제 시작
await AdStage.event.trackBeginCheckout({
  items: [{ itemId: 'PROD_123', itemName: 'Wireless Earbuds' }],
  value: 99000,
  currency: 'KRW',
  coupon: 'SUMMER10',
});
 
// 6. 구매 완료 ⭐⭐⭐
await AdStage.event.trackPurchase({
  value: 129000,
  currency: 'KRW',
  transactionId: 'ORDER_20250105_001',
  tax: 12900,
  shipping: 3000,
  coupon: 'SUMMER2025',
  paymentMethod: 'credit_card',
  items: [
    {
      itemId: 'PROD_123',
      itemName: 'Wireless Earbuds',
      itemCategory: 'electronics',
      price: 126000,
      quantity: 1,
    },
  ],
});
 
// 7. 환불
await AdStage.event.trackRefund({
  transactionId: 'ORDER_20250105_001',
  value: 129000,
  currency: 'KRW',
});

// 1. 튜토리얼 시작
await AdStage.event.trackTutorialBegin({
  tutorial_id: 'intro',
});
 
// 2. 튜토리얼 완료
await AdStage.event.trackTutorialComplete({
  duration_seconds: 120,
});
 
// 3. 레벨업
await AdStage.event.trackLevelUp({
  level: 25,
  character: 'warrior',
});
 
// 4. 업적 달성
await AdStage.event.trackUnlockAchievement({
  achievementId: 'first_win',
  achievementName: '첫 승리',
});
 
// 5. 스테이지 클리어
await AdStage.event.trackStageClear({
  stageName: 'Dragon Lair',
  stageNumber: 10,
  score: 95000,
  duration: 180,
});
 
// 6. 게임 플레이
await AdStage.event.trackGamePlay({
  level: 10,
  levelName: "Dragon's Lair",
  character: 'mage',
  contentType: 'dungeon',
});
 
// 7. 보너스 획득
await AdStage.event.trackAcquireBonus({
  contentType: 'reward',
  itemId: 'ITEM_123',
  itemName: 'Gold Chest',
  quantity: 1,
});
 
// 8. 게임 서버 선택
await AdStage.event.trackSelectGameServer({
  contentId: 'SERVER_01',
  contentType: 'pvp',
  itemName: 'Asia Server',
});

// 1. 가상화폐 획득
await AdStage.event.trackEarnVirtualCurrency({
  virtualCurrencyName: 'gold',
  value: 1000,
});
 
// 2. 가상화폐 사용
await AdStage.event.trackSpendVirtualCurrency({
  virtualCurrencyName: 'gold',
  value: 500,
  itemName: 'Health Potion',
});

// 1. 검색
await AdStage.event.trackSearch('gaming laptop');
 
// 2. 공유
await AdStage.event.trackShare({
  method: 'kakao',
  contentType: 'product',
  itemId: 'PROD_789',
});
 
// 3. 좋아요
await AdStage.event.trackLike({
  contentType: 'post',
  contentId: 'POST_123',
});
 
// 4. 앱 평가
await AdStage.event.trackRate({
  rating: 5,
  maxRating: 5,
});
 
// 5. 일정 등록
await AdStage.event.trackSchedule({
  event_name: 'meeting',
  date: '2025-01-15',
});

// 1. 광고 노출
await AdStage.event.trackAdImpression({
  adPlatform: 'admob',
  adSource: 'admob_banner',
  adFormat: 'banner',
  adUnitName: 'home_banner',
  value: 0.01,
  currency: 'USD',
});
 
// 2. 광고 클릭
await AdStage.event.trackAdClick({
  adPlatform: 'admob',
  adSource: 'admob_interstitial',
  adFormat: 'interstitial',
  adUnitName: 'game_over_ad',
});

// 1. 무료 체험 시작
await AdStage.event.trackStartTrial({
  value: 9900,
  currency: 'KRW',
  trialDays: 14,
});
 
// 2. 구독 시작
await AdStage.event.trackSubscribe({
  subscriptionId: 'premium_monthly',
  value: 9900,
  currency: 'KRW',
  period: 'monthly',
});
 
// 3. 구독 해지
await AdStage.event.trackUnsubscribe('premium_monthly');
 
// 4. 푸시 알림 클릭
await AdStage.event.trackNotificationClick({
  notificationId: 'NOTIF_123',
  title: '할인 이벤트',
  body: '오늘만 50% 할인!',
});

// 1. 주식 매수
await AdStage.event.trackBuyStock({
  itemId: 'AAPL',
  itemName: 'Apple Inc.',
  quantity: 10,
  price: 185.5,
  value: 1855,
  currency: 'USD',
});
 
// 2. 주식 매도
await AdStage.event.trackSellStock({
  itemId: 'AAPL',
  itemName: 'Apple Inc.',
  quantity: 5,
  price: 190.0,
  value: 950,
  currency: 'USD',
});
 
// 3. 계좌 개설 완료
await AdStage.event.trackCompleteOpenAccount({
  contentType: 'savings',
  contentId: 'ACCOUNT_001',
  method: 'online',
});
 
// 4. 카드 신청
await AdStage.event.trackApplyCard({
  contentType: 'credit_card',
  itemName: 'Premium Card',
  itemId: 'CARD_001',
});

// 패치 완료 (게임)
await AdStage.event.trackCompletePatch({
  contentId: 'PATCH_2.1.0',
  contentType: 'update',
});

// 커스텀 이벤트 전송
await AdStage.event.track('custom_event_name', {
  custom_param1: 'value1',
  custom_param2: 123,
  custom_param3: true,
});

// 쿠폰 적용
await AdStage.event.track('apply_coupon', {
  coupon_code: 'SUMMER25',
  discount_amount: 5000,
  discount_type: 'percentage',
});
 
// 친구 초대
await AdStage.event.track('invite_friend', {
  invite_method: 'kakao',
  invite_code: 'ABC123',
});
 
// 리뷰 작성
await AdStage.event.track('write_review', {
  product_id: 'PROD_123',
  rating: 5,
  has_photo: true,
});
 
// 고객센터 문의
await AdStage.event.track('contact_support', {
  inquiry_type: 'refund',
  channel: 'chat',
});

import { AdStage } from '@adstage/react-native-sdk';
 
// 사용자 속성 설정
await AdStage.setUserAttributes({
  gender: 'male',     // 'male' | 'female' | 'other'
  country: 'KR',      // 국가 코드
  city: 'Seoul',      // 도시
  age: '28',          // 나이 (문자열)
  language: 'ko-KR',  // 언어
});
 
// 설정된 사용자 속성 조회
const attributes = await AdStage.getUserAttributes();

interface UserAttributes {
  gender?: string;    // male, female, other
  country?: string;   // 국가 코드: KR, US, JP 등
  city?: string;      // 도시
  age?: string;       // 나이
  language?: string;  // 언어: ko-KR, en-US 등
}

// 로그인 후 사용자 정보 설정
const handleLoginSuccess = async (user: User) => {
  // 사용자 속성 설정
  await AdStage.setUserAttributes({
    country: user.country,
    city: user.city,
    language: user.language,
  });
  
  // 로그인 이벤트 전송 (method 인자는 로그인 방법)
  await AdStage.event.trackLogin('email');
};
 
// 로그아웃 시
const handleLogout = async () => {
  await AdStage.event.trackLogout();
  
  // 사용자 속성 초기화 (선택)
  await AdStage.clearUserAttributes();
};

interface EcommerceItem {
  itemId: string;           // 상품 ID (필수)
  itemName: string;         // 상품명 (필수)
  price?: number;           // 단가
  quantity?: number;        // 수량
  itemCategory?: string;    // 카테고리
  itemBrand?: string;       // 브랜드
}

await AdStage.event.trackPurchase({
  value: 250000,
  currency: 'KRW',
  transactionId: 'ORDER_001',
  items: [
    {
      itemId: 'SKU_001',
      itemName: 'Wireless Earbuds',
      itemCategory: 'Electronics',
      itemBrand: 'TechBrand',
      price: 150000,
      quantity: 1,
    },
    {
      itemId: 'SKU_002',
      itemName: 'Phone Case',
      itemCategory: 'Accessories',
      price: 50000,
      quantity: 2,
    },
  ],
  tax: 25000,
  shipping: 0,
  coupon: 'FREESHIP',
});

// 이벤트 결과 확인
const result = await AdStage.event.track('test_event', {
  debug: true,
});
 
console.log('Event result:', result);
// { success: true, eventId: '...' } 또는 { success: false, error: '에러 메시지' }