Web 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`	啟用偵錯模式

Web SDK 概覽與安裝

目錄