一、代码位新建&编辑路径

• 新建：
• 您可以在「流量变现」-「代码位」页面点击「新建代码位」。

• 创建代码位成功后，将「应用id」-「代码位id」给到您团队中的开发工程师，即可发起广告测试。

• 编辑：
• 您可以在「流量变现」-「代码位」页面点击对应代码位旁边的「编辑」。

二、为代码位配置广告位（新增）

自2026年7月起，平台新增“广告位”绑定能力：创建代码位时，需要先选择代码位所属广告位。广告位用于标识 APP 内一个独立的广告展示场景，平台将基于广告位识别真实广告曝光机会，提升广告流量匹配效率及广告变现收益。

1. 什么是广告位？

• 什么是广告位：
• 简介：广告位全称“物理广告位”（prime_rit），是平台定义的唯一曝光场景标识，指代设备端同一次用户曝光机会对应的一组广告代码位集合。简单来说：APP内一个独立的广告展示场景，即为一个物理广告位。
• 场景案例：假设某APP内包含激励视频、信息流两个独立广告曝光场景（即两个物理广告位）：
• 激励视频场景下创建A、B、C三个广告代码位，用户触发激励视频曝光时，A、B、C代码位发起多次广告请求，共享同一次曝光竞价机会，因此A、B、C三个代码位需统一绑定物理广告位ID1；

• 信息流场景下创建D、E、F三个广告代码位，用户浏览信息流触发曝光时，D、E、F代码位发起多次广告请求，共享同一次曝光竞价机会，因此D、E、F三个代码位需统一绑定物理广告位ID2。

• 为什么要添加广告位：添加广告位可帮助平台准确识别每次广告曝光的真实展示场景，提升广告流量匹配效率与价值预估能力，从而帮助开发者提升整体变现收益。

物理广告位可精准标记每一个曝光场景的流量属性、展示场景，平台算法可基于标准化的物理位数据，精准匹配对应行业、出价、质量的广告主资源，提升流量价值预估能力，让每一次用户流量都能高效变现。

2. 如何添加

• 核心绑定原则：同一曝光场景下的所有代码位，必须绑定同一个物理广告位ID；不同曝光场景的代码位，需绑定不同的物理广告位ID
• 操作步骤：
• 新建代码位-添加广告位信息
• 新建单个代码位：

1. 选择代码位所属应用；
2. 在“广告位”下拉框中选择对应广告位；
3. 若当前广告展示场景尚未创建广告位，点击「新建广告位」；

新建广告位 选择已有广告位

• 批量创建代码位：

1. 进入「流量变现」-「代码位」，点击「批量新建代码位」；
2. 选择所属应用；
3. 在每个待创建代码位的“广告位”配置项中，选择已有广告位或新建广告位；

• 存量代码位-补充广告位信息
• 编辑单个代码位

1. 进入「流量变现」-「代码位」；
2. 找到需补充的代码位，点击「编辑」；
3. 在“广告位”处选择已有广告位或新建广告位，（广告位一旦设定不可修改，请谨慎编辑）
4. 确认后提交保存。

• 批量修改-导入代码位 ID 批量设置（适用于已整理好待修改代码位 ID，或无需先在列表中筛选的场景）

注意：导入的多个代码位将统一关联至同一个广告位，请仅选择属于同一广告展示场景的代码位做修改

1. 进入「流量变现」-「代码位」页面，点击「批量为代码位设置广告位」选择「导入」；
2. 在弹窗内输入或粘贴需修改的代码位 ID；多个代码位 ID 可使用逗号或换行分隔。
3. 点击「添加」，系统将校验代码位是否存在、是否属于同一应用。
4. 确认待修改代码位无误后，点击「选择所属广告位」。
5. 在广告位下拉列表中选择目标广告位；如需关联的广告位尚未创建，可先新建广告位。
6. 点击「确定」提交设置。

p1选择「批量为代码位设置广告位」 p2 选择导入 p3输入/粘贴需修改的代码位 ID p4选择广告位，点击 确定 保存

• 批量修改-勾选代码位批量设置

注意：导入的多个代码位将统一关联至同一个广告位，请仅选择属于同一广告展示场景的代码位做修改

1. 进入「流量变现」-「代码位」页面，点击「批量为代码位设置广告位」
2. 通过应用、代码位名称/ID、代码位类型、代码位状态等筛选条件，定位需要修改的代码位。
3. 勾选需关联至同一广告位的代码位。 点击列表上方的「批量设置广告位」。
4. 在弹窗内确认待修改代码位无误后，选择目标广告位。
5. 点击「确定」提交设置。

p1选择「批量为代码位设置广告位」 p2定位需要修改的代码位 p3勾选需关联至同一广告位代码位 p4选择广告位，点击 确定 保存

三、不同类型代码位的简介&创建步骤

关于期望CPM，可参考流量管理-代码位管理-瀑布流入门文档

1. 创建激励视频

• 简介：通过完整观看激励视频广告，您的用户可以获得应用内奖励，比如虚拟金币、积分等。您可以对不同的激励视频代码位设置不同的奖励，以此实现您的收益最大化目标。

• 历史分成完成结算。（建议作为首选项）
• 创建步骤：

1. 点击「流量变现」-「代码位」-「新增代码位」
2. 选择所属应用、广告位
3. 广告类型选择「激励视频」
4. 设置「屏幕方向」「视频声音」「是否在广告中显示奖励内容」
5. 设置奖励发放是否需要服务器判断
1. 服务器回调是指在用户在看完激励视频后，客户端会向第三方服务器发送一个验证申请，第三方服务器来判断是否给用户奖励，返回给客户端true/false。SDK提供了onRewardVerify接口，boolean rewardVerify 可以获取这个判断。如不使用服务器回调模式，在视频播放完成时boolean rewardVerify 默认返回true。
2. 服务器回调模式并不是必须的，服务器模式只是增加了一次第三方服务器验证判断。具体的奖励的发放是由客户端完成。在不使用服务器回调模式时，视频播放完成后onRewardVerify接口的 boolean rewardVerify 默认返回true。
6. 选择屏蔽规则，并填写代码位名称
7. 点击「提交」，提示创建代码位成功，预计30分钟后生效

2. 创建开屏

• 简介：开屏广告用于用户进入 app 时展示，一般展示时长为 3-5s ，曝光机会大，点击几率高。目前穿山甲提供的开屏广告已经支持静态图片和动态视频两种开屏样式。
• 创建步骤：

1. 点击「流量变现」-「代码位」-「新增代码位」
2. 选择所属应用、广告位
3. 广告类型选择「开屏」
4. 设置「屏幕方向」
5. 选择屏蔽规则，并填写代码位名称
6. 点击「提交」，提示创建代码位成功，预计30分钟后生效

3. 创建Banner

• 简介：Banner广告会占用应用的部分页面，一般在应用的顶部或底部区域。Banner广告可以在您设定刷新时间后自动刷新。也就是说，即使用户停留在同一个屏幕上，他们也能隔一段时间就看到新的Banner广告。
• 创建步骤：

1. 点击「流量变现」-「代码位」-「新增代码位」
2. 选择所属应用、广告位
3. 广告类型选择「Banner」
4. 设置「代码位尺寸」「是否轮播」
5. 选择屏蔽规则，并填写代码位名称
6. 点击「提交」，提示创建代码位成功，预计30分钟后生效生效

4. 创建信息流

• 简介：信息流广告即 app 推荐页/详情页中的原生图文及视频广告，主要特点是精准算法推荐、原生体验对用户干扰低。
• 创建步骤：

1. 点击「流量变现」-「代码位」-「新增代码位」
2. 选择所属应用、广告位
3. 广告类型选择「信息流」
4. 选择素材类型
5. 选择模板
6. 选择屏蔽规则，并填写代码位名称
7. 点击「提交」，提示创建代码位成功，预计30分钟后生效效生效

5. 创建draw信息流

• 简介：draw信息流适用于视频类产品，类似抖音视频的竖版视频信息流，与视频产品完全融为一体。
• 创建步骤：

1. 点击「流量变现」-「代码位」-「新增代码位」
2. 选择所属应用、广告位
3. 广告类型选择「draw信息流」
4. 选择素材类型
5. 选择屏蔽规则，并填写代码位名称
6. 点击「提交」，提示创建代码位成功，预计30分钟后生效

6. 创建新插屏广告

• 简介：穿山甲原插屏广告和全屏视频广告合并为「新插屏广告」，开发者可从开发者平台点击「新插屏广告」并创建代码位，同时可以根据实际应用场景，选择广告铺开大小为全屏/半屏/优选。
• 创建步骤：

1. 点击「流量变现」-「代码位」-「新增代码位」
2. 选择所属应用、广告位
3. 广告类型选择「新插屏广告」
4. 可根据选择广告铺开大小(全屏/半屏/优选)决定接入的广告样式大小（优选将展现模型预估收益最佳的插屏样式，全屏/半屏均有机会展示，该流量场景需同时支持全屏和半屏广告）
5. 选择素材类型（建议优先选择视频+图片，可有效提升CPM）
6. 设置「屏幕方向」「视频声音」
7. 选择屏蔽规则，并填写代码位名称
8. 点击「提交」，提示创建代码位成功，预计30分钟后生效

三、 代码位状态

1. 运行中：即正常计费、产出数据的代码位。
2. 测试：广告请求不计费，且不产出数据；测试和正式状态可以互相切换。
3. 代码位新建后无法删除，如果您需要停止，可将代码位的合作状态关停，关停后不可以请求广告，但当天收益不受影响；可重新启用，启动后将恢复至关闭前的状态，可正常请求广告。
4. 当应用是测试状态时，您只能新建测试状态的代码位，应用转正式后，您可以修改代码位状态为正式。
5. 当代码位被判定为作弊，则会被“异常停止”。

四、 代码位如何关停/开启

代码位关停 / 重启可在「流量变现」-「代码位」-「合作状态」中自行设置。

• 关闭：不可以请求广告，当天收益不受影响。
• 启用：可以正常请求广告，启动后将恢复至关闭前的状态。

提示：代码位三个月内没有广告请求数据或近 30 天没有广告展示数据，系统会自动操作关闭。