主题
用户与内容上下文
提供上下文可改善定向。在 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 字段
| 字段 | 类型 | 说明 |
|---|---|---|
userId | String? | 用户唯一标识 |
NovvyContentContext 字段
| 字段 | 类型 | 说明 |
|---|---|---|
seriesName | String? | 剧名 |
episodeNumber | int? | 集号 |
url | String? | 内容地址(映射原生 SDK 的 url 字段) |