online-sales-sdk/README.md

OnlineSales.ai Web Tag SDK 封装，适用于 Vue/React 项目，纯JS实现

# online-sales-sdk

## 简介

OnlineSales.ai Web Tag SDK 封装，适用于 Vue/React 项目，纯JS实现，自动加载官方 osmos 脚本，API 友好。

## 安装

```bash
npm install online-sales-sdk
# 或
yarn add online-sales-sdk
```

## 使用方法

```js
import getOnlineSalesSDK from 'online-sales-sdk';

// 初始化
const sdk = getOnlineSalesSDK();
await sdk.initialize({
  clientId: 10090003,
  productAdsHost: "d.o-s.io",
  displayAdsHost: "d-ba.o-s.io"
});

// 获取广告
sdk.fetchDisplayAds({
  cliUbid: "user_123",
  pageType: "CATEGORY",
  adUnit: ["HEADER_BANNER", "SIDEBAR_AD"],
  productCount: 2
}).then(data => {
  console.log('广告数据', data);
});
```

## 支持方法

- initialize(options)
- updateOptions(options)
- fetchDisplayAds(params)
- fetchPLAProductPageAds(params)
- fetchPLASearchPageAds(params)
- fetchPLACategoryPageAd(params)
- fetchPLATPAPageAd(params)
- fetchPLAPurchasePageAd(params)
- fetchPLAHomePageAd(params)
- fetchPLACustomPageAd(params)

## 兼容性

- 支持 Vue、React 等主流前端框架
- 仅浏览器环境可用

## License

MIT