Skip to content

用户与内容上下文 ​

提供上下文可改善定向。在 initialize() 之后设置,内容变化时更新;set* 为替换(null 清空),update* 为按字段合并(null 保持原值)。

  • NovvyUserContext —— 用户画像,字段全部可选,登录后设置。
  • NovvyContentContext —— 当前剧集。⚠️ 短剧场景是填充前提,需在每次 load() / 挂载前设置正确的 series/episode。
dart
// 用户画像:登录后设置一次,身份变化时再次设置
NovvyAds.setUserContext(
  NovvyUserContext(userId: 'user_123'),
);

// 内容上下文:每次 load / 挂载广告前设置,确保 series/episode 正确
NovvyAds.setContentContext(
  NovvyContentContext(
    seriesName: '剧名',
    episodeNumber: 3,
    url: 'https://...',
  ),
);

// 增量更新(其余字段保持不变)
NovvyAds.updateUserContext(NovvyUserContext(userId: 'user_456'));
NovvyAds.updateContentContext(NovvyContentContext(episodeNumber: 4));

集数用构造参数覆盖:NovvyScrollAd 常在「当前集」预载「下一集」的广告,NovvyInsertAd 则是每集一个实例、由翻页容器提前创建,全局上下文里的 episode 都不一定对得上,所以两者的构造参数 episodeNumber 会覆盖上下文的集数(series / url 仍取自上下文)。详见信息流滑动位、叙事植入。

NovvyUserContext 字段 ​

字段类型说明
userIdString?用户唯一标识

NovvyContentContext 字段 ​

字段类型说明
seriesNameString?剧名
episodeNumberint?集号
urlString?内容地址(映射原生 SDK 的 url 字段)

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