接口文档SDK业务专题开发者工具

微信原生推广页使用指引

什么是微信原生推广页

原生推广页支持丰富微信原生功能组件、全屏的沉浸式浏览体验,投放微信朋友圈、微信公众号与小程序流量时可选择的落地页类型。它可保证用户在微信客户端的良好浏览体验,对广告转化效果有着非常重要的积极影响,(查看投放流程原生页介绍

如何通过Api创建原生推广页

创建原理:
由于原生页结构层级较多、以及本身的特殊性,API创建需要基于现有原生页模板进行创建,所以第一步需要在投放端创建原生页模板,从投放端(ad.qq.com)进行 可视化创建原生页后,通过API进行获取并修改保存为新的推广页;

  1. 通过投放端进行创建后的原生页可以在推广页列表进行查看、管理;
    undefined
  2. 使用wechat_pages/get(获取微信原生页列表接口 针对对应账号下原生页推广页进行获取;

    请求示例:

    https://developers.e.qq.com/docs/api/business_assets/wechat_pages/wechat_pages_get?version=1.3&_preview=1#wu4b1

    接口获取 应答示例:

    https://developers.e.qq.com/docs/api/business_assets/wechat_pages/wechat_pages_get?version=1.3&_preview=1#stydq

    3、原生页组件对应关系介绍

page_elements_spec_list结构,包含了全部支持的组件,组件素材内容,组件的同步顺序与原生页的展示顺序一致,即第一个同步组件为顶部展示元素

element_type enum 原生页中组件类型,[枚举详情]
image_spec struct 图片组件元素
video_spec struct 视频组件元素
text_spec struct 文本组件元素
button_spec struct 按钮组件元素
form_spec struct 表单组件元素
element_shelf struct 图文复合组件
element_float struct 悬浮组件

4、使用 wechat_pages/add(创建微信落地页)接口进行修改组件内容,进行创建新的原生推广页

请求参数: https://developers.e.qq.com/docs/api/business_assets/wechat_pages/wechat_pages_add?version=1.3&_preview=1#wu4b1
接口获取 应答示例: https://developers.e.qq.com/docs/api/business_assets/wechat_pages/wechat_pages_add?version=1.3&_preview=1#stydq

举例: 现在基于步骤2中原生页(假设id=AA)创建一个新的原生页,调用接口 wechat_pages/add接口需要重点注意:

  1. 参数page_template_id=AA
  2. page_elements_spec_list内容为基于第2步中拉取接口返回的组件列表,修改元素信息,比如换组件图片id列表(image_spec/image_id_list)后得到。重点注意:这里不可增减组件,不可修改组件类型,只能修改现有组件内容(图片信息,视频信息,文本信息……)

    小贴士:

    如何获取原生页里素材详情:通过wechat_pages/get 获取到 原生页的image_spec.image_id_list, 有了图片id,再通过 images/get接口获取 图片的详情(图片的url、长宽、大小等信息)。

  • 使用原生推广页创建广告

    投放朋友圈规格时使用原生推广页示例

  1. 通用广告创建流程

    https://developers.e.qq.com/docs/start/procedures?version=1.3&_preview=1

  2. 原生页支持使用流量范围

    微信朋友圈、微信公众号小程序站点支持原生推广页落地页(创建朋友圈广告指引);

  3. 创建adcreative(广告创意)时使用原生推广页

  • 涉及接口:adcreatives/add(创建广告创意)、adcreatives/update(更新广告创意)、adcreatives/get(获取广告创意)
需要字段名称 使用描述
page_type 原生推广页落地页类型为:PAGE_TYPE_CANVAS_WECHAT
page_spec/page_id 落地页信息,需要填写原生页ID
page_spec/override_canvas_head_option 原生推广页顶部素材和广告创意素材之间的替换关系,(仅在朋友圈广告使用原生推广页情况下有效),[枚举详情]

枚举列表:{

  • OPTION_CANVAS_OVERRIDE_CREATIVE 不替换,要求原生推广页顶部素材和广告创意素材 md5 一致;

  • OPTION_CREATIVE_OVERRIDE_CANVAS 广告创意素材替换原生推广页顶部素材 ,

  • OPTION_KEEP_DIFFERENT 自定义广告创意素材,和原生推广页顶部素材保持两者不同,(仅支持朋友圈非常规创意形式)

    } | |
    | | link_page_type

    link_name_type

    link_page_spec | | 朋友圈文字链(行动按钮)使用方式

    https://developers.e.qq.com/docs/guide/ads/moments_pages?version=1.3&_preview=1 | |

  • 功能特点介绍:原生推广页支持「引用外层素材」 顶部组件

    当含有「引用外层素材」组件的原生页,可以被朋友圈全部创意形式拉取使用(推广目标一致情况下),不在受原生页顶部素材格式、尺寸的限制,即同一个原生落地页可以被全部朋友圈规格使用,减少重复创建、提升原生页使用效率;
    undefined
    Marketing API接口:

  1. 涉及接口:adcreatives/add、adcreatives/update、adcreatives/get
  2. 涉及字段:override_canvas_head_option(替换关系),使用OPTION_CREATIVE_OVERRIDE_CANVAS(广告创意素材替换原生推广页顶部素材)
  3. 使用方式:当原生推广页类型(canvas_type,如下图所示)为CANVAS_TYPE_COMMON_PAGE时,override_canvas_head_option必须传OPTION_CREATIVE_OVERRIDE_CANVAS,该原生页在播放时顶部组件自动引用创意素材(包括图片,视频),没有朋友圈创意尺寸、图片视频类型限制
    undefined