> ## 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. # API 参考 > React SDK 暴露的 Props、hook、组件与事件。 ## `` props 你的 publisher token。在用户整个生命周期内保持不变的唯一标识（用于再营销与奖励广告）。用户邮箱。对话的唯一 ID。本次对话启用的 placement code。默认为 `['inlineAd']`。本次对话使用的 character 对象。角色的唯一 ID。角色名称。角色头像 URL。标识该角色是否面向成人受众。角色的问候语。角色性格的简要描述。描述角色的标签。本次对话的合规对象。请求是否受 GDPR 约束。（0 = 否，1 = 是，null = 未知） IAB 透明度与同意框架（TCF）的 consent 字符串。请求是否受 COPPA 约束。（0 = 否，1 = 是，null = 未知） Global Privacy Platform (GPP) consent 字符串。本次请求适用的 GPP section ID 列表。美国隐私法规（如 CCPA、LSPA）相关的消费者信号。发布方提供的用户分群标识（用于 A/B 测试）。事件发生时的回调。详见下方"支持的事件"章节。 SDK 内部诊断事件的回调。接收 `(name, data?)`——在接入期间排查 preload / session 行为时很有用。默认关闭。 ## `useAds()` hook 返回 `addMessage`，一个总是路由到当前会话的转发函数。如果 `` 切换了会话（例如 `publisherToken` 改变），下一次调用会自动指向新的会话。 `(message: Message, options?: AddMessageOptions) => void` —— 向 SDK 注册一条新消息。下一次预加载会被自动安排。 `AddMessageOptions` 目前提供一个开关：当为 `true` 时，preload 请求仍会发出（用于分析），但本条消息不会展示广告。可用于在不丢失追踪数据的前提下抑制广告。 ## `Message` 结构消息的唯一 ID。消息角色（`user` 或 `assistant`）。消息文本。消息创建时间戳。 ## `` props 本广告所属消息的唯一 ID。 Onboarding 时提供的 placement code。默认为 `'inlineAd'`。广告主题，例如 `light` 或 `dark`。 render-prop 形式的包装函数，允许你用自己的 DOM 结构包裹广告 iframe。函数接收已渲染的广告作为 React 节点： ```tsx theme={null}

{ad}

} /> ``` ## `` `` 内部已经被一个 `ErrorBoundary` 包裹，确保广告出错不会拖垮宿主应用。该组件同样被导出，方便你用它包裹自己的逻辑： ```tsx theme={null} import { ErrorBoundary } from '@kontextso/sdk-react' ``` ## 支持的事件 ### `ad.clicked` 用户点击了广告。广告 ID。生成的广告内容。消息 ID。点击跳转的 URL。广告形式。用户点击的素材区域（例如 `'cta'`、`'banner'`）。 ### `ad.viewed` 用户已查看广告。广告 ID。生成的广告内容。消息 ID。广告形式。广告收入（美元计的 eCPM）。 ### `ad.filled` 有可投放的广告。广告 ID。与该广告匹配的 placement code。广告收入（美元计的 eCPM）。 ### `ad.no-fill` 没有可投放的广告。指示广告被跳过原因的代码。 ### `ad.render-started` 在第一个 token 到达之前触发。广告 ID。 ### `ad.render-completed` 在最后一个 token 到达之后触发。广告 ID。 ### `ad.error` 出现错误时触发。错误信息。错误代码。 ### `video.started` 视频开始播放时触发。广告 ID。 ### `video.completed` 视频播放完成时触发。广告 ID。 ### `reward.granted` 激励广告向用户发放奖励时触发。广告 ID。