Skip to content

用户与内容上下文 ​

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

  • NovvyUserContext —— 用户画像,字段全部可选,登录后设置。
  • NovvyContentContext —— 当前剧集。⚠️ 短剧场景是填充前提,需在每次 load() / attach() 前设置正确的 series/episode,否则 .noFill。
swift
// 用户上下文:登录后设置一次,身份变化时再次设置
NovvySDK.shared.setUserContext(
    NovvyUserContext(userId: "user_123")
)

// 内容上下文:每次 load/attach 广告前设置,确保 series/episode 正确
NovvySDK.shared.setContentContext(
    NovvyContentContext(seriesName: "剧名", episodeNumber: 3, url: "https://...")
)

// 增量更新(其余字段保持不变)
NovvySDK.shared.updateUserContext(userId: "user_456")
NovvySDK.shared.updateContentContext(episodeNumber: 4)

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

NovvyUserContext 字段 ​

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

NovvyContentContext 字段 ​

seriesName / episodeNumber / url(均可空)。

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