关于展位

展位是在客户端页面上用于展示投放广告物料的一块矩形区域。

展位类型

CDP 支持开屏（splash）、弹屏、公告、轮播（banner）、列表、浮标和自定义七种类型的展位。各类型展位的示例如下图所示。

• 开屏（splash）：在 App 冷启动时的全屏区域的展位，开屏展位在 App 范围内全局唯一。
• 弹屏：在 App 中一块宽和高都可控的一块浮层区域的展位。
• 公告：通过消息广播的形式给用户传递相关信息。
• banner：在 App 页面中某一固定位置的矩形区域的展位，支持一个或多个广告位的横向轮播。
• 列表：多则不同的广告内容以列表形式在 App 页面呈现。
• 浮标：在 App 页面中某一固定位置。
• 自定义：自定义的文案类型广告。

展位基本信息

展位有展位名称、展位 ID、有效（缓存）时间等基本信息。

• 展位名称：必填项。最多可输入 30 个字符，不能与已有名称重复。
• 展位 ID：必填项。可以包含字母、数字、下划线（_）、中划线（-），不能与已有展位 ID 重复。
  • 自定义 ID：当展位为 动态配置 展位时，需选择本项，并在 自定义 ID 文本框内填写展位 ID 和页面地址。
    • iOS 页面地址：填写展示展位的 iOS 客户端页面地址。填写页面的 VCName，需联系 App 开发者获取，例如 MPHomeViewController。注意，VCName 必须继承 DTViewController，如不继承，则展位将无法展示。
    • Android 页面地址：填写展示展位的 Android 客户端页面地址。填写页面的 ActivityName，需联系 App 开发者获取，例如 com.mpaas.demo.cdp.DynamicContent1Activity。
    • H5 页面地址：填写展示展位的 H5 页面地址。填写页面的全称路径，需联系 App 开发者获取。可使用 window.location 对象获取 H5 页面的全称路径。
  • 客户端预置 ID：当展位为 客户端预置 展位时，选择本项，并在 客户端预置 ID 文本框内复制填写预置展位的 ID（联系 App 开发者获取）。
  • 启动页开屏展位 ID：当展位为开屏展位时，选择本项。开屏展位 ID 默认为 STARTPAGE，不可修改。一个应用内仅能有一个开屏展位，即如果应用内已有一个开屏展位，您将无法再创建开屏展位。
• 有效（缓存）时间：必填项。指展位的广告加载一次后的缓存保留时长，需结合下载流量的使用和用户体验角度综合考虑设置。可设置的时间范围是 00:00:00 ~ 71:59:59。

展位配置信息

展位可进行展位类型、展位素材类型、展位位置、样式、展位高度、展位宽度和广告位数量的配置。

• 展位类型：在 CDP 中有开屏（splash）、弹屏、公告、banner、列表、浮标和自定义七种展位类型。
• 展位素材类型：必填项。指该展位支持投放的素材种类。部分展位支持调整。

• 展位位置：必填项。指展位在页面上的位置，包括页面顶部浮层、页面顶部、页面底部、列表头部、列表底部、屏幕顶部左侧、屏幕顶部右侧、屏幕中部左侧、屏幕中部右侧、屏幕底部左侧和屏幕底部右侧。部分展位支持调整。

  说明：不同展位类型可配置的位置有所不同，具体参见下面的 展位位置说明表。

  页面顶部浮层	页面顶部	页面底部	列表头部
  展位位于页面顶部，浮于页面布局上方，不会把原布局往下顶，是相对于屏幕的固定位置，展位宽度与页面宽度相同。	展位位于页面顶部，将页面原布局往下顶，是相对于页面的固定位置，展位宽度与页面宽度相同。	展位位于页面底部，将页面原布局往上顶，是相对于页面的固定位置，展位宽度与页面宽度相同。	在列表顶部（第一个广告位上方），将原有列表布局往下顶，是相对于列表的固定位置，展位宽度与列表宽度相同。
  列表底部	屏幕顶部左侧	屏幕中部左侧	屏幕底部左侧
  在列表底部（最后一个广告位下方），将原有列表布局往上顶，是相对于列表的固定位置，展位宽度与列表宽度相同。	仅针对浮标展位。位于屏幕左上角，浮于页面布局上方，不影响页面原布局，是相对屏幕的固定位置。	仅针对浮标展位。位于屏幕左侧上下居中处，浮于页面布局上方，不影响页面原布局，是相对屏幕的固定位置。	仅针对浮标展位。位于屏幕左下角，浮于页面原布局上方，不影响页面原布局，是相对屏幕的固定位置。
  屏幕顶部右侧	屏幕中部右侧	屏幕底部右侧
  位于页面右上角，浮于页面布局上方，不影响页面原布局，是相对屏幕的固定位置。	仅针对浮标展位。位于屏幕右侧上下居中处，浮于页面布局上方，不影响页面原布局，是相对屏幕的固定位置。	仅针对浮标展位。位于屏幕右下角，浮于页面原布局上方，不影响页面原布局，是相对屏幕的固定位置。

• 样式：必填项。即展位的外观样式，包括背景色、前景色、文本色、和控件色。部分展位支持调整。
  • 背景色：展位的背景颜色，默认为 #F8F8F8。
  • 前景色：展位的前景颜色。展位的前景色指展位被点击时所呈现的背景颜色，默认为 #E7E7E5。当展位被点击时，若展位内物料存在跳转地址，则呈现前景色，否则呈现背景色。关于跳转地址的配置，参见 创建活动 > 添加广告投放。
  • 文本色：展位内文本的颜色，默认为 #FF0000。
  • 控件色：展位内的控件（小喇叭）颜色，默认为 #1A1311。
• 展位高度：必填项。即展位的在应用页面中的高度，单位为 px。部分展位支持调整。
• 展位宽度：必填项。即展位的在应用页面中的宽度，单位为 px。部分展位支持调整。
• 广告位数量：必填项。banner 和列表两种展位支持多帧，广告位的数量即展位的帧数。部分展位支持调整。
  

• 单个信息轮播时长：此配置和广告位数量联动。当广告位数量为 1 时，单个信息轮播时长不可配置；当广告位数量不为 1 时，单个信息轮播时长可配置为 1 – 10 的任一整数。

  	开屏（splash）	弹屏	公告	banner	列表	浮标	自定义
  展位类型	√	√	√	√	√	√	√
  展位素材类型	√	√	x	√	√	√	x
  展位位置	默认	默认位置	页面顶部浮层	页面顶部浮层	页面顶部浮层	屏幕顶部左侧	x
  			页面顶部	页面顶部	页面顶部	屏幕顶部右侧
  			页面底部	页面底部	页面底部	屏幕中部左侧
  			列表头部 （仅对 Native 页面生效）	列表头部 （仅对 Native 页面生效）	列表头部 （仅对 Native 页面生效）	屏幕中部右侧
  			列表底部 （仅对 Native 页面生效）	列表底部 （仅对 Native 页面生效）	列表底部 （仅对 Native 页面生效）	屏幕底部左侧
  			-	-	-	屏幕底部右侧
  样式	x	x	√	x	x	x	√
  展位高度	x	√	√	√	√	√	x
  展位宽度	x	√	x	x	x	√	x
  广告位数量	1-10 个	1个	1个	1-10个	1-10个	1个	1个
  单个信息轮播时长	1-10 秒	x	x	1-10 秒	1-10 秒	x	x
  说明： √：支持且必须配置；x：不支持配置；-：表示无内容。

展位支持的素材类型

CDP 支持的展位素材类型如下列表所示。

• 文本：展示内容为纯文本。
• 静态图片：展示内容为静态图片，图片格式支持 .png、.jpg、.jepg。
• Gif 动图：展示内容为 Gif 动图。
• Lottie 动画：展示内容为 Lottie 动图。
• H5 页面：展示内容为在线 H5 页面。

不同展位类型所支持的展位素材类型不同，详见下表。

展位的配置方式

智能投放提供了 动态配置 和 客户端预置 两种展位的配置方式。根据实际业务需求，您可以进行灵活选择。

• 动态配置
  

  采用动态配置展位的方式时，您只需在客户端工程中添加 CDP SDK 后，即可在控制台上创建展位并完成展位的所有属性配置，包括配置展位名称、展位 ID、展位所在页面、展位类型、展位素材类型、展位位置、展位宽度、展位高度和广告位数量。

  动态配置展位支持的展位类型包括弹屏、公告、banner、列表、浮标以及自定义。各类型展位支持的展位位置，参见 展位配置信息表 中的展位位置栏。动态配置仅对展位内容进行设置，不设置展位的位置。动态配置展位不支持展位位置为腰封。

  使用动态展位时，需要注意以下几点：

  • 对于自定义类型展位，需要先在客户端预置展位。该类型的展位比较特殊，适用于部分需要自定义文案的场景。以搜索框为例，在控制台上您可以定义搜索框中的文案内容，但无法设置搜索框的位置和宽高，这些属性需要通过客户端配置。
  • 在 Android 客户端中，页面顶部浮层或页面顶部必须包含 tag 为 h5_titlebar 的 ViewGroup 控件或者布局中包含 antui-build 组件中的 AUTitleBar 控件；列表头部/底部必须包含 ListView 控件。
  • 在 iOS 客户端中，列表头部/底部必须包含 UITableView 控件。

• 客户端预置
  

  采用客户端预置展位的方式时，您需要在客户端工程中添加智能投放 SDK 后，通过代码在客户端工程中预置展位的部分属性配置，包括展位 ID、展位所在页面、展位位置、展位宽度和展位高度，然后在控制台上创建展位并填写在客户端工程中预置好的展位 ID 以最终完成展位的创建。在控制台中您也可以设置展位宽度和展位高度的设置，但这两项配置只有在客户端工程中未进行配置时才会生效。

  客户端预置展位支持的展位类型包括弹屏、公告、banner、列表、浮标以及自定义。可通过客户端配置方式来实现动态展位不支持的展位位置（例如腰封）。

  说明：建议只在客户端工程中预置展位 ID、展位所在页面以及展位位置，只在控制台中配置展位高度，方便灵活调整。

  在不同页面上预置展位的操作方法参见：

  • Android 页面：在 Android 应用中 预置展位。
  • iOS 页面：在 Android 应用中 预置展位。
  • H5 页面：在 H5 页面中 预置展位。