广告形式

Documentation Index

Fetch the complete documentation index at: https://docs.kontext.so/llms.txt

Use this file to discover all available pages before exploring further.

每一条 Kontext 广告都由两部分组成：

1. 由 AI 生成的文本——延续助手消息的语气，让广告自然衔接对话，而不是一段生硬的插入。
2. 一段与形式对应的素材——紧跟在文本下方渲染：图片、视频、横幅，或者（插屏的情况下）一个用于打开全屏体验的 CTA 按钮。

四种形式都通过同一个组件挂载（<InlineAd messageId="..." /> 或各平台的等价组件）——SDK 会根据广告服务返回的内容自动选择正确的呈现方式。

​

四种广告形式

​

插屏广告的个性化能力

插屏是我们最进阶的广告形式——我们会使用你在 session 上传入的 Character 对象来驱动前置（pre-roll）与后置（post-roll）的文本与视觉素材，让插屏看起来就像用户正在对话的那个助手的自然延伸。 为了让插屏发挥效果，Character 对象的下列字段是必填的：

• id
• name
• avatarUrl
• greeting

其余字段是有用但可选——只要你有相应数据，传入即可让个性化效果更精准：

• persona —— 角色性格的简要描述。
• tags —— 主题、兴趣、受众信号。
• isNsfw —— 若角色面向成人受众则标记为 true，我们会据此过滤素材。

Character 对象在创建 session 时设置一次（见 会话生命周期），并在该对话中保持固定。各平台的具体字段名见 SDK 页面。

​

形式是如何决定的

你不需要为每条广告选择形式。这一选择由广告服务决定，依据是：

• 你的 <InlineAd> 绑定的 placement code。
• SDK 在 /preload 时上传的对话上下文（消息、character）。
• 拍卖中返回的素材以及它们在哪种形式下表现最好。
• 用户的设备与所在地区。

这样，同一个组件就能在某个位置自动渲染图片广告，在另一个位置渲染视频广告，在合适的时机渲染插屏——你不需要为每种形式各写一套逻辑。

​

你可以调整的部分

你可以为广告组件传入 theme（通常是 "light" 或 "dark"），让广告采用合适的基础配色。在此之外，我们会为每位发布方单独调整广告素材的设计——字体、间距、配色、整体排版——让广告自然融入你的应用，而不是显得格格不入。如果你有具体的视觉要求，可以在 onboarding 时告诉我们，或通过 联系我们 与我们沟通。

​

下一步