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

动态商品广告

动态商品广告介绍

动态商品广告(简称DPA)是什么?

动态商品广告(以下简称DPA),结合腾讯社交大数据和广告主一方数据,打造多维度商品推荐引擎,实现根据用户特性、行为、兴趣推荐商品,促进用户点击并转化。

DPA用户体验

动态商品广告的使用流程

更多接入流程操作指引请查看商品广告投放指南

商品数据接入

在上传商品数据前,要先创建一个商品目录,将您的商品数据放在这个商品目录中。在创建商品目录时,您要根据自己的业务特征,选择一个合适的商品目录类型。您可使用投放端工具箱中“数据中心”或是在微信广告工具栏里的“商品库管理”里进行商品目录的创建。刚刚创建完的商品目录是空的,里面没有任何商品信息。AMS通过读取您提供的商品数据源文件,来将商品数据写入商品目录。更多关于商品数据接入的指南请查收商品广告投放指南或是商品数据对接技术白皮书

用户行为数据\转化数据接入

动态商品广告依托社交效果广告DMP平台接入您第一方用户行为数据和转化数据。您可使用API进行数据接入,查看API数据接入操作

关联用户行为数据源和商品目录

动态商品广告客户需将用户行为数据源和客户的商品目录相关联,使得用户行为数据分发到正确的商品目录,也使得动态商品广告播放时可以取到关联的商品信息。您可在“商品管理平台”中实现商品数据和行为数据的关联。

制作动态商品模版

您可使用投放端工具箱中的“创意模版制作工具”自行制作模版或者使用我们为您提供的公共模板,具体的使用流程请查看商品广告投放指南中的第五章节模板制作部分。

如何使用API创建动态商品广告

获取商品信息接口

您可调用product_catalogs/get获取商品目录信息,API会返回商品目录可用的推荐方式信息、应用直达选项、以及商品目录基础信息,还可以通过product_items/get接口筛选出的热门商品列表来获取商品ID或是通过product_items_detail/get来查询特定商品的详情信息和审核状态。这些信息会在您创建广告时使用。

获取创意形式的相关信息

广告创意由创意形式组成,创意形式定义了每一个创意包含什么元素,以及元素相关的描述信息,并与广告组的广告版位属性一起,决定了当前创意会在具体哪些位置进行展示。关于创意形式更详细的介绍可以参考创意形式章节。

通过创意形式信息获取接口(adcreative_template/get),您可以针对您想推广的广告版位(site_set)和推广目标类型(product_type)或者动态广告投放能力类型(dynamic_ability_type)查询可投放的创意形式id列表,同时可以获取到创意形式id对应的创意形式介绍、创意形式示意图、创意形式元素信息、创意形式属性信息、创意形式出价类型以及底价信息。

动态商品广告模版相关接口

获取DPA模版

在动态商品广告流程里可以使用模板来制作素材,使用dynamic_ad_templates/get接口获取可用模板,这个接口支持筛选账号下某个特定宽高(这个宽高指的是在投放时的创意形式格标准尺寸,更多信息可以查考商品广告创意形式标准化投放指导手册),具体的宽高应选值可以根据上述第二部分里提到的创意形式信息获取接口(adcreative_template/get)来查询对应要投放的创意形式下的图片元素(image)里的宽高值来获取可用模板。

将DPA模版转化成图片或视频

在选定模板之后,使用该模板id调用dynamic_ad_images/add接口并指定投放模板的使用尺寸,同样的根据创意形式信息获取接口(adcreative_template/get)来查询对应要投放的创意形式下的图片元素(image)里的宽高值来获取,该接口调用时还需要传入商品ID(传入product_source字段),接口调用成功后就可以得到该商品的素材图image_id。同样的,如果是要投放视频DPA,可以使用DPA视频模板生成视频接口dynamic_ad_video/add制作用于投放SDPA广告商品所属的视频(video_id)。

广告组模块

在创建广告组(Adgroup/add)时,如需创建DPA广告,须传入dynamic_ad_spec结构体,在此结构体中,须指定商品目录ID和动态商品广告类型,目前商品推荐方式默认设置为拉新推荐。您可以通过product_catalogs/get接口获取商品目录ID和商品推荐方式。

广告创意模块

在创建广告创意(Adcreative/add)时,如需创建DPA广告创意,须传入dynamic_adcreative_spec结构体,在此结构体中,须指定商品目录ID、商品ID和动态商品广告类型。同时在adcreative_elements中需要填写广告投放用到的素材,如果投放的是图文广告,可以直接传入上述第二部分中已经生成好的素材image_id,而如果投放的是视频广告,可以在选用了视频创意形式之后,将商品视频素材的video_id填入adcreative_elements中即可创建得到adcreative_id。目前只支持投放单商品动态商品广告。

广告创建模块

将上述第三部分和第四部分中得到的adgroup_id和adcreative_id调用ad/add接口即可创建动态商品广告,创建成功后可以得到对应广告的aid。

广告与商品数据报表获取

对于已经投放出来的广告可以使用广告报表接口获取天级别(daily_reports/get)或者小时级别(hourly_reports/get)的报表,而对于商品库商品效果洞察可以使用商品报表获取接口(product_catalogs_reports/get)来得到相关的数据。

部分可投创意形式列表,更多创意形式相关的信息可以通过通过创意形式信息获取接口(adcreative_template/get)或创意形式在线查询工具进行查询得到:

创意形式ID 广告版位 投放端尺寸 是否支持SDPA 是否支持MDPA
711 横板大图16:9 1280×720 支持 支持
712 竖版大图9:16 1080×1920 支持 支持
713 通栏大图7:2 960×274 支持 支持
714 横版小图3:2 480×320 支持 支持
716 横版小图16:9 480×270 支持 支持
715 横版小图4:3 480×360 支持 支持
718 三小图3:2 480×320 支持 支持
719 三小图4:3 480×360 支持 支持
717 方形小图1:1 147×147 支持 支持
484 微信公众号文章中部 960×540 支持 支持
567 微信公众号文章底部 960×334 支持 支持
608 微信小程序 960×334 支持 支持
998 公众号底部优雅大图 960×540 支持 支持
841 朋友圈图文卡片 960×540 支持 不支持
450 朋友圈信息流 800×450 支持 不支持
460 朋友圈视频 640×360 支持 不支持
560 公众号视频 9:16 支持 不支持