Skip to content

用户与内容上下文 ​

提供上下文可改善定向。在 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 字段 ​

字段类型说明
userIdstring | null用户唯一标识

NovvyContentContext 字段 ​

字段类型说明
seriesNamestring | null剧名
episodeNumbernumber | null集号
urlstring | null内容地址(映射原生 SDK 的 url 字段)

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