Skip to content

初始化 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 对象):

参数类型说明
appIdstring必填,应用标识
endpointstring必填,广告服务地址
apiKeystring必填,密钥,随请求发送用于鉴权
userContextNovvyUserContext | null可选,初始化时带入的用户定向上下文(等价于随后调用 setUserContext),见用户与内容上下文

返回值:Promise<boolean>。true = 初始化成功;false = 初始化失败或平台调用出错(内部已捕获异常,不会 reject)。

initialize() 可再次调用(如登录/登出后)以刷新配置,原生 SDK 幂等处理重复初始化。凭证变化时可再次调用。

本文档仅供技术对接使用,请勿外传。