推广活动（交叉推广）
推广活动是交叉推广引擎：通过应用详情中介绍的“广告占位符的广告单元 → 交叉推广”映射，你可以在自己的一款应用内推广另一款应用。
推广活动列表
推广活动页面（/campaigns）以表格形式列出你创建的所有推广活动，包含以下列：行号、标题、目标应用（名称和包名分两行显示）、推广活动类型（目前始终为“交叉推广”——类型选择器中虽然存在“广告网络投放”这一概念，但实际上并未提供该选项）、状态和优先级（均以彩色胶囊标签显示，且支持排序）、开始日期、结束日期、创建时间、更新时间（后两项也支持排序），以及操作（编辑和删除）。
你可以按推广活动状态、优先级或定向品牌筛选列表，每项均为动态多选控件。点击铅笔图标编辑推广活动时，会以编辑模式进入下文介绍的向导；删除操作会先要求确认，且无法撤销。
只有当你的套餐仍允许新增交叉推广活动时（canCreateCampaign()），+ 创建按钮才可用。如果已达到套餐的推广活动数量上限，该按钮会被用量提示（“已使用 X/Y 个推广活动”）和指向订阅页面的“🔒 升级”链接替代。
创建或编辑推广活动——分步向导
点击 + 创建（或编辑现有推广活动）会启动分步向导。向导共有五步，而不是四步——编辑现有推广活动时会自动跳过第一步，因此很容易少算一步（推广活动创建后，其类型便无法更改）。整个向导中，每一步都遵循相同的“先暂存、再保存”模式：填写某一步时，你的修改仅保存在该步骤组件的本地状态中。只有点击保存类按钮，且相应 API 调用成功后，数据才会写入向导的共享上下文，并持久化到服务器。如果你在有未保存修改时离开当前页面，系统会显示“你有未保存的更改。确定要离开吗？”确认提示（是，离开 / 留在此页），防止修改丢失。
第 1 步——选择推广活动类型
这里只有一张可选卡片：交叉推广（“向你其他应用的用户推广自己的应用”）。这是唯一实际可用的选项——底层代码中还预留了第二种“广告网络投放”类型供未来使用，但目前无法在界面中选择。点击下一步继续；此步骤本身不会调用服务器，因为直到第 2 步才会创建推广活动。在编辑模式下，会完全跳过此步骤——向导直接从第 2 步开始，现有推广活动的类型已固定。
第 2 步——推广活动设置
此步骤既用于创建推广活动（创建模式下首次保存时），也用于编辑其核心设置（编辑模式下）。字段如下：
- 推广活动状态开关——仅在编辑模式下显示。可在“已启用”和“已暂停”之间切换（无论切换到哪种状态，都会显示确认对话框：“启用推广活动？”/“暂停推广活动？”）。尝试启用推广活动时，系统会在保存前检查该活动是否至少有一个广告素材，且其中至少有一个素材已启用。如果不满足条件，系统会阻止操作，并提示“无法启用推广活动——请先添加至少一个广告素材”或“……至少一个广告素材必须处于启用状态”，开关切换不会生效。
- 推广活动标题——必填文本字段。
- 选择品牌——必选下拉框，列出你的品牌。更改品牌会清空“要推广的应用”中已选的应用，因为应用列表取决于所选品牌。
- 要推广的应用——必选下拉框，根据所选品牌填充；选择品牌前不可用。
- 推广活动优先级——高 / 中 / 低，显示为三个可选的胶囊按钮；默认为“中”。
- 推广活动开始时间——可选择“立即开始”或指定日期。指定日期不能早于今天（以当天日期为准进行检查）；但在编辑模式下，如果未更改原先保存的日期，则会跳过此项检查。
- 推广活动结束时间——可选择“无（不设结束日期）”或指定日期。同样要求日期不能早于今天，并额外检查结束日期是否晚于开始日期。
**启用状态下的字段锁定：**推广活动启用后，将无法再更改品牌、要推广的应用或开始日期/立即开始设置——这些字段会被禁用，并附有简短说明（“……无法在推广活动启用期间更改”）。你仍可更改标题、优先级和结束日期，也可以通过状态开关暂停活动。
点击保存（创建模式下为保存并下一步，编辑模式下为保存）会将标题、目标应用、推广活动类型、优先级、计算后的开始/结束日期，以及编辑模式下的状态发送到服务器。首次创建时，系统会使用响应中已有的展示范围/地区数据（如有）预填第 3 步的初始状态。只有 API 调用成功后，这些数据才会写入向导的共享上下文。
第 3 步——定向设置
定向设置实际上由两个独立部分组成，共用一个步骤和一个保存按钮：展示范围（在哪些品牌/应用中展示此推广活动）和地区（在哪些国家/地区投放）。
展示范围。 通过复选列表选择以下任一方式：
- 所有品牌——一个总控复选框，表示此推广活动可在你拥有的所有品牌和应用中展示，包括以后新增的品牌和应用。
- 指定品牌——从可滚动列表中选择一个或多个品牌，每个品牌下都有各自的应用子列表。对于已选品牌，你可以单独勾选应用，也可以勾选该品牌的“全部（含未来新增）”复选框，以包含该品牌下的所有应用（现有及未来新增），无需逐个选择。
复选列表上方会以标签形式实时汇总“已选品牌”和“已选应用”，便于你一眼查看当前定向范围。
地区。 这是一个带有“全选”快捷操作的国家/地区多选控件，用于限制（或不限制）推广活动的投放国家/地区。如果不设置限制，推广活动将在所有地区投放。此地区选择器特意与本指南后文介绍的具名“地区组”功能分开——它只是针对单个推广活动、不带名称的国家/地区选择，而不是可保存和复用的分组。（如果无法从服务器加载动态国家/地区列表，此处会使用一个较小的备用列表，仅包含 16 个国家/地区。因此，此选择器的备用选项比“地区组”中的更少。）
这两个部分与向导中的其他步骤采用相同的暂存/保存机制：修改会保留在本地，直到你点击“保存”（或“保存并下一步”）。随后，展示范围和地区设置会分别通过各自的 API 调用持久化，成功后才会合并到向导的共享状态中。
第 4 步——广告素材
在这里上传推广活动投放时实际展示的广告素材。
添加新素材。 表格式的“添加新素材”表单支持一次添加一行或多行（点击 + 添加素材链接可新增一个空白行；点击垃圾桶图标可删除一行）。每行包含：
- 图片——点击空白方框上传图片。支持格式：JPEG、PNG、JPG、GIF、WebP；最大文件大小为 10MB。不符合要求的文件会被拒绝，并在对应位置显示具体错误（格式错误，或“最大 10MB（X.XXMB）”，其中显示实际文件大小）。
- 名称——必填文本。
- 目标 URL——必填；必须是有效的
http://或https://URL，输入时会实时校验。 - 广告类型——插屏广告、横幅广告、原生广告、激励广告或开屏广告（appOpen）（与其他位置的广告单元使用相同的五种广告格式）。
点击保存并下一步（创建模式）或保存（编辑模式）后，系统会校验每个非空行，上传各张图片，然后通过 API 创建各个广告素材。只有成功创建的素材才会加入已保存列表；如果有素材保存失败，界面会显示失败数量，你可以重试。在创建模式下，必须至少有一个广告素材才能离开此步骤。
已保存素材列表。 已保存的素材以卡片列表形式显示在新增表单上方。每张卡片包含缩略图（点击可放大）、名称、广告类型、目标 URL、带切换开关的“已启用/未启用”状态标签、编辑（铅笔）按钮和删除（垃圾桶）按钮。
- 如果某个素材是该推广活动中唯一已启用的素材，则无法将其关闭（提示“必须至少保留一个已启用的广告素材”）；其他情况下，都会显示简单的“启用/停用广告素材？”确认提示。
- 点击编辑（铅笔）按钮，会展开该素材的内嵌编辑表单（可编辑名称、图片和目标 URL；广告类型不可更改），并提供独立的保存/取消按钮。
- 删除操作会先提示“此操作无法撤销！”，确认后永久删除该素材。
第 5 步——检查推广活动
此步骤以只读方式汇总第 2–4 步中填写的所有内容：推广活动状态、标题、类型、品牌、要推广的应用、优先级、开始日期、结束日期、单行定向摘要（例如“所有品牌 · 所有应用”，或按品牌列出的明细），以及所选地区（以标签形式显示，或显示“所有地区”），还包括完整的广告素材列表及其缩略图、名称、目标 URL 和广告类型徽标。
仅在创建模式下，此步骤顶部还会显示一个可操作的状态开关（已启用/已暂停）——启用规则与第 2 步相同（如果推广活动没有素材，或没有已启用的素材，系统会拒绝启用，并提示“无法启用推广活动”）。在编辑模式下，状态仅以只读徽标显示——需要通过第 2 步的开关更改状态，不能在这里修改。
点击完成返回推广活动列表。在编辑模式下，会先短暂显示“推广活动已成功保存”的确认提示；在创建模式下，则直接返回，不再额外提示，因为此前每一步都已保存。