# Kontext Documentation: Chinese ## Chinese ### 对话广告 #### 入门 - [概述](https://docs.kontext.so/zh/overview.md): 将原生 AI 驱动广告引入你的应用,把它变成稳定的收入引擎。 - [广告主](https://docs.kontext.so/zh/advertisers.md): 通过上下文相关、AI 驱动的原生广告,触达你的理想用户。 - [发布方](https://docs.kontext.so/zh/publishers.md): 将原生 AI 驱动广告引入你的应用,把它变成稳定的收入引擎。 #### 核心概念 - [工作原理](https://docs.kontext.so/zh/concepts/how-it-works.md): 贯穿每一次 Kontext 接入的核心流程:从创建会话到渲染广告。 - [会话生命周期](https://docs.kontext.so/zh/concepts/session.md): Kontext 会话如何创建、喂入消息、监听事件并关闭。 - [ID 与 token](https://docs.kontext.so/zh/concepts/ids-and-tokens.md): publisherToken、placement code、userId、conversationId、IFA、IDFV——每一个是什么、由谁生成、用来做什么。 - [消息](https://docs.kontext.so/zh/concepts/messages.md): SDK 需要每条聊天消息提供哪些信息,以及为什么 ID 必须稳定且唯一。 - [展示广告](https://docs.kontext.so/zh/concepts/displaying-ads.md): 广告位放在哪里、应该绑定哪条 message id,以及最常见的『最新助手消息』模式。 - [广告形式](https://docs.kontext.so/zh/concepts/ad-formats.md): 图片、视频、插屏、横幅——每种广告形式是什么,以及广告服务如何决定下发哪一种。 - [广告引擎](https://docs.kontext.so/zh/concepts/ad-engine.md): Kontext 的广告引擎如何同时调度直签合作伙伴与程序化 DSP 的广告。 - [广告生命周期事件](https://docs.kontext.so/zh/concepts/events.md): SDK 可能发出的全部事件——filled、no-fill、viewed、clicked、render-*、video.*、reward.granted——它们何时触发以及该如何响应。 - [节奏控制](https://docs.kontext.so/zh/concepts/pacing.md): 广告在对话中出现的频率——可以由我们配置节奏,也可以通过 trackOnly 按消息覆盖。 #### 实践指南 - [测试](https://docs.kontext.so/zh/guides/testing.md): 使用开发用的 publisher token 进行无使用限制的接入与测试。 - [调试](https://docs.kontext.so/zh/guides/debugging.md): 用 onEvent 处理广告生命周期事件,用 onDebugEvent 获取详细的内部日志。 - [IFA 与 ATT](https://docs.kontext.so/zh/guides/ifa.md): SDK 如何在 iOS 与 Android 上读取设备广告标识符,以及每个平台所需的一次性配置。 - [SKAdNetwork](https://docs.kontext.so/zh/guides/skadnetwork.md): 在 iOS 上配置 SKAdNetwork 标识符,让 DSP 能够对你的广告进行安装归因。 - [ads.txt 与 app-ads.txt](https://docs.kontext.so/zh/guides/ads-txt.md): 在你的域名下托管 IAB 的"授权卖方"文件,让需求方信任你的流量。 - [TCF 与 CMP](https://docs.kontext.so/zh/guides/tcf-cmp.md): SDK 如何自动从你的 CMP 读取 IAB TCF v2.2 consent,以及通过 regulatory 对象进行手动控制的方式。 - [广告主像素](https://docs.kontext.so/zh/guides/advertiser-pixel.md): 在你的网站上跟踪转化和自定义事件,并将其归因到 Kontext 广告的点击。 - [最佳实践](https://docs.kontext.so/zh/guides/best-practices.md): 上线前的发布方接入自查清单。 #### SDK - [Flutter SDK](https://docs.kontext.so/zh/sdk/flutter.md): 在你的 Flutter iOS / Android 应用中接入 Kontext 广告 SDK。 - [React Native SDK](https://docs.kontext.so/zh/sdk/react-native.md): 在你的 React Native iOS / Android 应用中接入 Kontext 广告 SDK。 - [React SDK](https://docs.kontext.so/zh/sdk/react.md): 在你的 React 应用中接入 Kontext 广告 SDK。 ##### Swift SDK - [Swift SDK](https://docs.kontext.so/zh/sdk/swift.md): 使用 Swift SDK 在你的 iOS 应用中接入 Kontext 广告。 - [安装](https://docs.kontext.so/zh/sdk/swift/installation.md): 把 Swift SDK 加入你的 iOS 项目,并完成 ATT 与 SKAdNetwork 配置。 - [展示第一个广告](https://docs.kontext.so/zh/sdk/swift/first-ad.md): 创建会话、喂入消息、挂载 InlineAdUIView 并订阅事件。 - [API 参考](https://docs.kontext.so/zh/sdk/swift/api.md): Swift SDK 暴露的全部类型与方法。 - [实践指南](https://docs.kontext.so/zh/sdk/swift/guides.md): Swift SDK 接入中常见任务的模式与配方。 - [示例应用](https://docs.kontext.so/zh/sdk/swift/example.md): 用你自己的 publisher token 端到端运行随仓库附带的 UIKit demo。 ##### Kotlin SDK - [Kotlin SDK](https://docs.kontext.so/zh/sdk/kotlin.md): 使用 Kotlin SDK 在你的 Android 应用中接入 Kontext 广告。 - [安装](https://docs.kontext.so/zh/sdk/kotlin/installation.md): 把 Kotlin SDK 加入你的 Android 项目,并完成 GAID 配置。 - [展示第一个广告](https://docs.kontext.so/zh/sdk/kotlin/first-ad.md): 创建会话、喂入消息、挂载 InlineAd 并订阅事件。 - [API 参考](https://docs.kontext.so/zh/sdk/kotlin/api.md): Kotlin SDK 暴露的全部类型与方法。 - [实践指南](https://docs.kontext.so/zh/sdk/kotlin/guides.md): Kotlin SDK 常见集成场景的模式与配方。 - [示例应用](https://docs.kontext.so/zh/sdk/kotlin/example.md): 使用你自己的 publisher token 端到端运行 Compose 示例。 ##### Vue SDK - [Vue SDK](https://docs.kontext.so/zh/sdk/vue.md): 使用 Vue SDK 在你的 Vue 3 应用中接入 Kontext 广告。 - [安装](https://docs.kontext.so/zh/sdk/vue/installation.md): 安装 @kontextso/sdk-vue。 - [展示第一个广告](https://docs.kontext.so/zh/sdk/vue/first-ad.md): 安装 Kontext 插件、喂入消息、挂载 ,并订阅事件。 - [API 参考](https://docs.kontext.so/zh/sdk/vue/api.md): Vue SDK 暴露的插件选项、composable、组件与事件。 - [实践指南](https://docs.kontext.so/zh/sdk/vue/guides.md): Vue SDK 接入中常见任务的模式与配方。 - [示例应用](https://docs.kontext.so/zh/sdk/vue/example.md): 用你自己的 publisher token 端到端运行 Vite + Vue 3 示例。 ##### JavaScript SDK - [JavaScript SDK](https://docs.kontext.so/zh/sdk/js.md): 一个轻量的 JavaScript SDK,可在任意 Web 应用中接入 Kontext 广告。 - [安装](https://docs.kontext.so/zh/sdk/js/installation.md): 通过 npm 安装 @kontextso/sdk-js,或从 CDN 加载。 - [展示第一个广告](https://docs.kontext.so/zh/sdk/js/first-ad.md): 创建会话、喂入消息、挂载广告、订阅事件。 - [API 参考](https://docs.kontext.so/zh/sdk/js/api.md): createSession、Session、Ad,以及完整事件列表。 - [实践指南](https://docs.kontext.so/zh/sdk/js/guides.md): JavaScript SDK 接入中常见任务的模式与配方。 - [示例应用](https://docs.kontext.so/zh/sdk/js/example.md): 用你自己的 publisher token 端到端运行 Vite 示例。 #### 资源 - [更新日志](https://docs.kontext.so/zh/resources/changelog.md): 每个 Kontext SDK 的版本历史。 - [Demo](https://docs.kontext.so/zh/resources/demos.md): 每个 Kontext SDK 都附带的可运行示例应用。 - [合规](https://docs.kontext.so/zh/resources/compliance.md): OMID 认证、IAB Tech Lab 立场、隐私法规与平台政策。 - [联系我们](https://docs.kontext.so/zh/resources/support.md): 联系 Kontext 团队。 ### 视频广告 #### 入门 - [视频广告](https://docs.kontext.so/zh/video/overview.md): 面向短剧及其他视频优先应用的叠加、暂停和线性广告。 #### 核心概念 - [工作原理](https://docs.kontext.so/zh/video/concepts/how-it-works.md): 从请求到最后一个事件:你的应用做什么,SDK 做什么,我们的服务器做什么。 - [广告格式](https://docs.kontext.so/zh/video/concepts/ad-formats.md): 叠加、暂停和线性:每种格式出现在哪里、如何结束。 - [广告生命周期](https://docs.kontext.so/zh/video/concepts/lifecycle.md): 请求、加载或拒绝、展示、结束。SDK 为你持有什么、何时放手,以及你要实现的那一个回调。 - [定向](https://docs.kontext.so/zh/video/concepts/targeting.md): 你告诉 SDK 的关于剧集、观众和同意的信息,以及每个字段为什么能提高填充率和价格。 #### 实践指南 - [测试](https://docs.kontext.so/zh/video/guides/testing.md): 用开发 token 集成和测试,每种格式的测试素材,以及示例应用。 - [调试](https://docs.kontext.so/zh/video/guides/debugging.md): 读取 SDK 的日志、检查它的状态,以及每个错误的含义。 - [IFA 与 ATT](https://docs.kontext.so/zh/video/guides/ifa.md): 视频 SDK 如何读取广告标识符,以及你的应用在 iOS 上需要的一次性设置。 - [SKAdNetwork](https://docs.kontext.so/zh/video/guides/skadnetwork.md): 在 iOS 上配置 SKAdNetwork 标识符,让广告主能够对来自你视频广告的安装进行归因。 - [app-ads.txt](https://docs.kontext.so/zh/video/guides/ads-txt.md): 在你的开发者网站托管 IAB 的"授权卖方"文件,让需求方信任你的流量。 - [TCF 与 CMP](https://docs.kontext.so/zh/video/guides/tcf-cmp.md): 视频 SDK 如何自动从你的 CMP 读取 IAB TCF v2.2 同意,以及如何自行设置同意。 - [最佳实践](https://docs.kontext.so/zh/video/guides/best-practices.md): 视频应用上线前的检查清单:时机、预取、同意、归因,以及能提高填充率的事。 #### SDK ##### Swift 视频 SDK - [Swift 视频 SDK](https://docs.kontext.so/zh/video/sdk/swift.md): 面向短剧及其他视频优先 iOS 应用的叠加、暂停和线性视频广告。 - [安装](https://docs.kontext.so/zh/video/sdk/swift/installation.md): 把视频 SDK 加入你的 iOS 项目,在启动时初始化,并配置 ATT 和 SKAdNetwork。 - [展示第一个广告](https://docs.kontext.so/zh/video/sdk/swift/first-ad.md): 创建视频的广告对象,获取广告,提前加载,并在合适的时刻展示:叠加、暂停或线性。 - [API 参考](https://docs.kontext.so/zh/video/sdk/swift/api.md): Swift 视频 SDK 的每个类型、方法、回调和错误。 - [示例应用](https://docs.kontext.so/zh/video/sdk/swift/example.md): 用你自己的发布方 token 运行内置的 SwiftUI 播放器,每个视频对应一种格式。 ###### 播放器 - [你的播放器](https://docs.kontext.so/zh/video/sdk/swift/players.md): 把你的内容播放器交给 SDK:部分播放器开箱即用,其他播放器实现 ContentPlayer。 - [AVPlayer](https://docs.kontext.so/zh/video/sdk/swift/avplayer.md): 把 AVPlayer 交给 SDK:ads.track(player)。 - [TTSDK 播放器](https://docs.kontext.so/zh/video/sdk/swift/ttsdk.md): 通过 KontextVideoTTSDK 产品把 TTSDK 引擎(TTVideoEngine)交给 SDK。 ###### 界面 - [SwiftUI](https://docs.kontext.so/zh/video/sdk/swift/swiftui.md): 在 SwiftUI 中通过 VideoAdHost 展示视频广告:设置广告即展示,设为 nil 即关闭。 ###### 指南 - [同时加载多个广告](https://docs.kontext.so/zh/video/sdk/swift/guides/several-ads.md): 要同时准备多种格式,并发地请求并加载它们。 - [运行你自己的竞价](https://docs.kontext.so/zh/video/sdk/swift/guides/auction.md): 在广告渲染前把价格与其他广告网络比较,然后加载或拒绝它。 - [处理无填充](https://docs.kontext.so/zh/video/sdk/swift/guides/no-fill.md): 某个格式没有广告时怎么办:原因,以及何时再次请求。 - [让广告避开你的控件](https://docs.kontext.so/zh/video/sdk/swift/guides/insets.md): 叠加广告条位于播放器视图的底部或顶部,暂停广告卡片位于顶部;SDK 把两者都保持在视图的安全区域内。 - [信息流中的广告](https://docs.kontext.so/zh/video/sdk/swift/guides/feeds.md): 在竖向信息流中(分页的 `UICollectionView`、SwiftUI 分页的 `ScrollView` 或 `TabView`),只在当前单元格中展示叠加或暂停广告。 - [下一集](https://docs.kontext.so/zh/video/sdk/swift/guides/next-episode.md): 当前一集播放时创建下一集的 `VideoAds`,预取它的广告,观众离开时销毁当前的。 - [观众是谁](https://docs.kontext.so/zh/video/sdk/swift/guides/viewer.md): 告诉 SDK 你对观众了解的信息:用户、同意,以及绝不能发送的内容。 ##### Kotlin 视频 SDK - [Kotlin 视频 SDK](https://docs.kontext.so/zh/video/sdk/kotlin.md): 面向短剧及其他视频优先 Android 应用的叠加、暂停和线性视频广告。 - [安装](https://docs.kontext.so/zh/video/sdk/kotlin/installation.md): 把视频 SDK 加入你的 Android 项目,在启动时初始化,并了解它在你的 manifest 中添加了什么。 - [展示第一个广告](https://docs.kontext.so/zh/video/sdk/kotlin/first-ad.md): 创建视频的广告对象,获取广告,提前加载,并在合适的时刻展示:叠加、暂停或线性。 - [API 参考](https://docs.kontext.so/zh/video/sdk/kotlin/api.md): Kotlin 视频 SDK 的每个类型、方法、回调和错误。 - [示例应用](https://docs.kontext.so/zh/video/sdk/kotlin/example.md): 用你自己的发布方 token 运行内置的 ExoPlayer 应用,每个视频对应一种格式。 ###### 播放器 - [你的播放器](https://docs.kontext.so/zh/video/sdk/kotlin/players.md): 把你的内容播放器交给 SDK:部分播放器开箱即用,其他播放器实现 ContentPlayer。 - [Media3 播放器](https://docs.kontext.so/zh/video/sdk/kotlin/media3.md): 通过 so.kontext:video-media3 把 Media3 播放器(ExoPlayer、MediaController)交给 SDK。 - [TTSDK 播放器](https://docs.kontext.so/zh/video/sdk/kotlin/ttsdk.md): 通过 so.kontext:video-ttsdk 把 TTSDK 引擎(TTVideoEngine)交给 SDK。 - [腾讯云播放器](https://docs.kontext.so/zh/video/sdk/kotlin/txplayer.md): 通过 so.kontext:video-txplayer 把腾讯云播放器 SDK 的播放器(TXVodPlayer)交给 SDK。 ###### 界面 - [Jetpack Compose](https://docs.kontext.so/zh/video/sdk/kotlin/compose.md): 通过 so.kontext:video-compose 在 Jetpack Compose 中展示视频广告:rememberVideoAds 和 VideoAdHost。 ###### 指南 - [同时加载多个广告](https://docs.kontext.so/zh/video/sdk/kotlin/guides/several-ads.md): 要同时准备多种格式,并发地请求并加载它们。 - [运行你自己的竞价](https://docs.kontext.so/zh/video/sdk/kotlin/guides/auction.md): 在广告渲染前把价格与其他广告网络比较,然后加载或拒绝它。 - [处理无填充](https://docs.kontext.so/zh/video/sdk/kotlin/guides/no-fill.md): 某个格式没有广告时怎么办:原因,以及何时再次请求。 - [让广告避开你的控件](https://docs.kontext.so/zh/video/sdk/kotlin/guides/insets.md): 叠加条幅位于容器的底部或顶部,暂停卡片位于顶部;SDK 让两者都避开与容器重叠的系统栏和屏幕刘海。 - [信息流中的广告](https://docs.kontext.so/zh/video/sdk/kotlin/guides/feeds.md): 在竖向信息流中(`ViewPager2`、分页的 `RecyclerView`、Compose pager),只在当前页面上展示叠加或暂停广告。 - [下一集](https://docs.kontext.so/zh/video/sdk/kotlin/guides/next-episode.md): 当前一集播放时创建下一集的 `VideoAds`,预取它的广告,观众离开时销毁当前的。 - [观众是谁](https://docs.kontext.so/zh/video/sdk/kotlin/guides/viewer.md): 告诉 SDK 你对观众了解的信息:用户、同意,以及绝不能发送的内容。 - [跟随页面的生命周期](https://docs.kontext.so/zh/video/sdk/kotlin/guides/lifecycle.md): 谁持有该集的 VideoAds,何时销毁它:Activity、Fragment、ViewModel 或 Compose。 #### 资源 - [更新日志](https://docs.kontext.so/zh/video/resources/changelog.md): 视频 SDK 的版本历史。 - [Demo](https://docs.kontext.so/zh/video/resources/demos.md): 视频 SDK 的可运行示例应用。 - [合规](https://docs.kontext.so/zh/video/resources/compliance.md): 视频 SDK 的可见性、IAB Tech Lab 标准、隐私法规与平台政策。 - [联系我们](https://docs.kontext.so/zh/video/resources/support.md): 联系 Kontext 团队。