웹 SDK 개요 및 설치

AdStage Web SDK 설치 및 초기화 방법을 설명합니다. 광고 표시, 이벤트 추적 등 세부 사용법은 각 기능별 문서를 참고하세요.

🚀 설치

패키지 매니저

pnpm add @adstage/web-sdk

설치 문제 해결

peer dependency 충돌 오류 발생 시:

# 즉시 해결
npm install @adstage/web-sdk --legacy-peer-deps
 
# 또는 .npmrc 파일에 설정 추가
echo "legacy-peer-deps=true" >> .npmrc

CDN (프로토타입 / 정적 페이지)

<script src="https://unpkg.com/@adstage/web-sdk/dist/index.umd.js"></script>

⚙️ 초기화

init() 방식

<script>
  AdStage.init({ 
    apiKey: 'your-api-key',
    debug: true // 개발 환경에서만
  });
</script>

Provider 방식

import { AdStageProvider } from '@adstage/web-sdk';
 
export function App() {
  return (
    <AdStageProvider 
      config={{ 
        apiKey: 'your-api-key',
        debug: process.env.NODE_ENV === 'development'
      }}
    >
      <div>{/* 앱 컴포넌트 */}</div>
    </AdStageProvider>
  );
}

🔧 설정 옵션

옵션	타입	기본값	설명
`apiKey`	`string`	필수	API 키
`debug`	`boolean`	`false`	디버그 모드 활성화

웹 SDK 개요 및 설치

목차