Apps Kit SDK logoApps Kit SDK
文档 · Apps Kit SDK 门户

原生广告模板

在原生广告模板页面,你可以直接在门户中设计原生广告的实际展示布局,无需由应用通过代码提供原生广告布局。这是 SDK 的 showTemplatedNative() 调用在门户端对应的配置功能(Android 上为 AdsManager.showTemplatedNative,iOS 上为 AppsKitSDKAdsManagerIOS.instance.showTemplatedNative):在此为广告占位符配置的模板,就是该 SDK 调用在运行时渲染的布局。应用完全不需要传入布局资源(无需 res/XIB),因为布局设计保存在这里。

模板列表

广告模板页面位于侧边栏中,与品牌和区域组归为一组,以表格形式列出你设计的所有原生广告模板。

1786548205099-Screenshot_2026-08-12_at_8.22.34_PM.png

每一行包含:序号、布局的图片缩略预览、模板名称、元素数量(模板实际使用了多少种可用组件,例如图标、标题、媒体、CTA 等)、状态标签(已发布或草稿)、可排序的创建时间/更新时间,以及操作菜单。搜索框可按名称筛选,筛选、状态和品牌下拉菜单可进一步缩小列表范围,点击全部清除可重置筛选条件。分页沿用门户各处的“显示 X 项,共 Y 项”页脚样式。点击 + 创建模板即可新建模板,或点击已有行,在下文介绍的画布编辑器中打开该模板。

设计模板(画布)

打开新建或已有模板后,都会进入画布编辑器,你可以在这里逐个添加和调整元素,构建布局。

1786548453622-Screenshot_2026-08-12_at_8.27.14_PM.png

  • 元素(左侧面板)— 原生广告可用的组件:图标、标题、广告主、赞助标识、评分、描述、媒体、价格、商店和 CTA 按钮。只有当前已放置在画布上的元素才处于激活状态(列表页的“元素”数量统计的就是这些元素);其余元素在添加前会在面板中保持灰显。这些组件与原生广告对象可提供的内容完全对应:你选择的是要展示广告平台提供的哪些原生广告素材,以及如何展示它们,而不是创建自定义字段。
  • 画布(中间区域)— 按以 dp 为单位的实际尺寸实时预览布局。可通过标签/示例数据切换,预览占位标签或接近真实效果的示例内容;还提供缩放控件、导入 XML选项(导入现有 Android 布局,无需从头构建),以及重置为初始状态功能,用于放弃更改并恢复到模板上次保存的状态。
  • 画布属性(右侧面板)— 包括位置和尺寸(尺寸预设下拉菜单,以及单独的宽度/高度字段,两者均可独立设为固定值、match_parent 或 wrap_content)、外观(以色块和十六进制值表示的背景颜色,以及圆角半径)和内边距(左/上/右/下,每项都有独立的步进控件)。

标题旁的草稿/已上线开关(旁边有铅笔图标,可直接重命名模板)控制模板是否具备分配给广告占位符的资格。处于草稿状态的模板不会在其他位置显示为可用选项。只有实际修改了内容,保存更改按钮才会启用,这与门户其他页面在无更改时禁用保存的行为一致。

配置模板可用范围

在画布编辑器中点击配置,会打开“配置模板可用范围”弹窗。这一步用于让模板真正可供指定应用或品牌使用,与模板设计是两个独立步骤。

1786548681524-Screenshot_2026-08-12_at_8.30.53_PM.png

弹窗采用双栏选择器,结构与广告活动向导的发布步骤相同(即定向步骤中品牌部分的“所有品牌”与指定品牌/应用勾选列表模式):

  • 品牌(左侧)— 可勾选所有品牌总复选框,也可从支持搜索的列表中勾选指定品牌。已选品牌还会以可移除的标签形式显示在列表上方。
  • 应用(右侧)— 根据左侧选中的品牌填充,并按品牌分组。每个品牌组都有独立的**所有应用(含未来新增)**快捷选项,可一次性包含该品牌下当前及未来的所有应用,无需逐个选择;也可以逐一勾选指定应用。已选应用同样会以标签形式显示。

点击完成保存可用范围。只有模板同时处于已上线状态,并在此配置为对某个应用/品牌可用,才能在下文所述的应用配置中,将其选为广告占位符的原生广告模板。

为广告占位符分配模板

返回应用的应用详情 → 广告占位符 → 广告占位符的广告单元表格(见上文“应用详情”部分)。原生广告列的操作方式与插屏广告/横幅广告/激励广告列相同:你可以为每个占位符添加一个或多个广告位,并按优先级排序,以便在失败时依次回退。不过,原生广告列的列标题旁还带有一个模板图标,因为原生广告位除了广告单元,还需要指定布局设计。

1786549032156-Screenshot_2026-08-12_at_8.36.46_PM.png

点击该图标会打开配置原生广告模板弹窗,作用范围为表格中当前显示的所有原生广告占位符(弹窗标题会注明范围,例如“所有原生广告占位符 (10)”)。

1786549069198-Screenshot_2026-08-12_at_8.37.30_PM.png

从对此应用可用的模板中搜索并选择一个模板(参见上文“配置模板可用范围”),然后点击应用模板,即可一次性为整个范围分配模板,无需逐个打开每个占位符的原生广告卡片。应用后,该范围内的任意占位符在运行时调用 showTemplatedNative(),都会使用此模板的设计进行渲染。这一机制将你在此设计的模板与应用中实际展示的原生广告关联起来,就像交叉推广(见上文“应用详情”下的“广告占位符的广告单元”部分)将广告活动与实际投放的广告位关联起来一样。