H5 SDK 接入指南

接入前准备

请先在媒体控制台完成域名验证，并创建至少一个广告位。每个广告位会分配唯一的 slot_id，SDK 请求需携带该标识。

建议在测试环境先完成 SDK 加载与广告展示联调，确认无 JavaScript 冲突、无遮挡核心交互区域后，再切换至生产流量。

加载 SDK

在页面 <head> 或<body> 末尾引入 FlowAdx SDK 脚本：/sdk/flowadx-sdk.js。脚本由平台统一托管，部署后可通过 HTTPS 访问。

初始化时传入媒体 public_api_key、广告位 slot_id 以及当前页面环境信息（如 app_env=browser）。控制台「站点 SDK」页面会给出完整示例代码。

广告方案说明

广告位身份由方案四元组决定：广告类型（scene_type）、出现时机（timing_id）、场景点（plan_position_id）、样式（style_id）。控制台建位时选定完整方案即可。

插屏：适合翻页、章节结束、关卡切换等自然停顿节点，请控制展示频率，避免影响用户体验。

横幅 / 信息流：适合列表、详情等固定或流式区域；需指定出现时机、场景点与样式（如左图右文）。

视频贴片：适合资讯、视频页。在自有播放器上提供广告层容器，调用 showVideoPreroll。短剧自有播放器不适用这套贴片。

联调与上线建议

上线前请确认页面无恶意弹窗、强制跳转或诱导点击设计，符合广告平台规范。

若广告无法展示，请先在控制台查看请求是否到达、域名是否验证通过、广告位是否处于启用状态。

如需技术支持，请通过「联系我们」页面邮件联系平台团队，并提供媒体 ID、广告位 ID 与问题发生时间。

按场景写页面代码时，请使用文末的接入手册。