主题
用户与内容上下文
提供上下文可改善定向。在 initialize() 之后设置,内容变化时更新;set* 为替换(null 清空),update* 为按字段合并(null / 缺省保持原值)。
NovvyUserContext—— 用户画像,字段全部可选,登录后设置。NovvyContentContext—— 当前剧集。⚠️ 短剧场景是填充前提,需在每次load()/ 挂载前设置正确的 series/episode。
ts
// 用户画像:登录后设置一次,身份变化时再次设置
NovvyAds.setUserContext({
userId: 'user_123',
});
// 内容上下文:每次 load / 挂载广告前设置,确保 series/episode 正确
NovvyAds.setContentContext({
seriesName: '剧名',
episodeNumber: 3,
url: 'https://...',
});
// 增量更新(其余字段保持不变)
NovvyAds.updateUserContext({ userId: 'user_456' });
NovvyAds.updateContentContext({ episodeNumber: 4 });集数用构造参数覆盖:
NovvyScrollAd常在「当前集」预载「下一集」的广告,NovvyInsertAd则是每集一个实例、由竖滑 pager 提前创建,全局上下文里的 episode 都不一定对得上,所以两者构造函数的episodeNumber会覆盖上下文的集数(series / url 仍取自上下文)。详见信息流滑动位、叙事植入。
NovvyUserContext 字段
| 字段 | 类型 | 说明 |
|---|---|---|
userId | string | null | 用户唯一标识 |
NovvyContentContext 字段
| 字段 | 类型 | 说明 |
|---|---|---|
seriesName | string | null | 剧名 |
episodeNumber | number | null | 集号 |
url | string | null | 内容地址(映射原生 SDK 的 url 字段) |