主题
初始化 SDK
在 App 启动时尽早初始化一次。必须在创建任何广告之前完成。
初始化是 Promise 式(对齐 RN 惯用法):initialize() 返回 Promise<boolean>,true 表示成功(UA/IDFA 预热结束)。可在参数中通过可选的 userContext 直接带入用户定向上下文(等价于紧接着调用 setUserContext)。
App 启动
↓
await NovvyAds.initialize({ appId, endpoint, apiKey, userContext? })
↓
返回 true / false // 初始化完成(UA/IDFA 预热后)
↓
NovvyAds.setContentContext(...) // 短剧场景:每次 load/挂载前设置ts
const ok = await NovvyAds.initialize({
appId: 'your_app_id',
endpoint: 'https://bid.novvy.ai',
apiKey: 'your_api_key',
userContext: { userId: 'user_123' }, // 可选:用户定向上下文,也可初始化后再设置
});
if (!ok) {
console.warn('Novvy 初始化失败');
}参数说明
NovvyAds.initialize 参数(单一 options 对象):
| 参数 | 类型 | 说明 |
|---|---|---|
appId | string | 必填,应用标识 |
endpoint | string | 必填,广告服务地址 |
apiKey | string | 必填,密钥,随请求发送用于鉴权 |
userContext | NovvyUserContext | null | 可选,初始化时带入的用户定向上下文(等价于随后调用 setUserContext),见用户与内容上下文 |
返回值:Promise<boolean>。true = 初始化成功;false = 初始化失败或平台调用出错(内部已捕获异常,不会 reject)。
initialize()可再次调用(如登录/登出后)以刷新配置,原生 SDK 幂等处理重复初始化。凭证变化时可再次调用。