入门与指南专题介绍帐号管理营销资产广告管理数据洞察人群管理数据接入接口清单
授权认证 帐号管理 营销资产 广告管理 数据洞察 辅助工具 用户行为数据 用户人群数据 用户标签数据 用户属性数据
附录

异步任务

本节将为您介绍如何使用异步任务。

为了便于您更高效的获取广告报表数据,在Marketing API V1.1版本,我们提供了异步任务接口。目前开放的任务类型包括以下几种(点击可查看每种任务具体的文件格式):

异步任务接口目前限制每账号(account_id)限制最多5分钟创建1个任务,多种任务算多个。接口定义详见【async_task模块】,异步任务接口的调用步骤包括:

Step 1:创建异步任务,获取任务id;


curl 'https://api.e.qq.com/v1.1/async_tasks/add?access_token=<ACCESS_TOKEN>&timestamp=<TIMESTAMP>&nonce=<NONCE>' \
-d 'account_id=<ACCOUNT_ID>' \
-d 'task_name=test task name' \
-d 'task_type=TASK_TYPE_AGENCY_AD_HOURLY_REPORT' \
-d 'task_spec={"task_type_agency_ad_hourly_report_spec":{"date":"2018-08-28"}}' 
					

{
    "code": 0,
    "message": "",
    "message_ch": "",
    "data": {
        "task_id": 1024
    }
}

Step 2:根据任务id获取任务的执行状态,如异步任务已经完成,则会返回对应的文件信息;


curl -G 'https://api.e.qq.com/v1.1/async_tasks/get?access_token=<ACCESS_TOKEN>&timestamp=<TIMESTAMP>&nonce=<NONCE>' \
-d 'account_id=<ACCOUNT_ID>' \
-d 'filtering=[{"field":"task_id","operator":"EQUALS","values":["1024"]}]' \
-d 'page=1' \
-d 'page_size=10' 
					

{
    "code": 0,
    "message": "",
    "message_ch": "",
    "data": {
        "list": [
            {
                "task_id": 1024,
                "task_name": "test task name",
                "task_type": "TASK_TYPE_AGENCY_AD_HOURLY_REPORT",
                "status": "TASK_STATUS_COMPLETED",
                "created_time": 1403243242,
                "result": {
                    "code": 0,
                    "message": "",
                    "data": {
                        "file_info_list": [
                            {
                                "file_id": 5,
                                "md5": "79054025255fb1a26e4bc422aef54eb4"
                            }
                        ]
                    }
                }
            }
        ],
        "page_info": {
            "page": 1,
            "page_size": 10,
            "total_number": 1,
            "total_page": 1
        }
    }
}

Step 3:根据任务id以及文件id进行文件下载;


curl -G 'https://dl.e.qq.com/v1.1/async_task_files/get?access_token=<ACCESS_TOKEN>&timestamp=<TIMESTAMP>&nonce=<NONCE>' \
-d 'account_id=<ACCOUNT_ID>' \
-d 'task_id=1024' \
-d 'file_id=<FILE_ID>' 
					

下载的文件中,

【获取广告小时报表】数据列依次是:

名称 类型 描述 指标含义
hour int64 小时段,0 0-23
account_id int64 广告主id
campaign_id int64 推广计划id
adgroup_id int64 广告组id
ad_id int64 广告id
impression int64 曝光量
click int64 点击量
cost int64 消耗 单位为分
like int64 微信朋友圈点赞数 仅对朋友圈广告有效
share int64 微信朋友圈转发量 仅对朋友圈广告有效
comment int64 微信朋友圈评论数 仅对朋友圈广告有效
image_click int64 微信朋友圈图片点击量 仅对朋友圈广告有效
follow int64 微信朋友圈关注量 仅对朋友圈广告有效
app_download int64 APP下载量 仅对APP推广广告有效
app_installation int64 APP安装量 仅对APP推广广告有效
app_activation int64 APP激活量 仅对APP推广广告有效
app_payment_count int64 APP付费行为次数 仅对APP推广广告有效
app_payment_amount int64 APP付费总金额,单位为分 仅对APP推广广告有效
register int64 注册次数
reservation int64 表单预约量
order_placement int64 下单量
mobile_qq_article_read int64 手q购物号文章阅读量 仅对手Q购物号广告有效
 
【API投放的微信朋友圈广告组小时报表】数据列依次是:
名称 类型 描述 指标含义
hour int64 小时 格式YYYYMMDDHH
account_id int64 广告主id
adgroup_id int64 广告组id 广告组id
view_uv int64 曝光人数 观看广告的独立用户数。
total_click_pv int64 总点击次数 用户在广告外层进行点击操作的次数。包括点击图片/视频,及朋友圈广告“文字链、头像、昵称、门店、选择按钮”等所有广告外层区域的点击。
total_click_uv int64 总点击人数 在广告外层进行点击操作的独立用户数。
image_pv int64 图片点击次数 用户点击朋友圈广告外层”图片”位置的总次数。
image_uv int64 图片点击人数 点击朋友圈广告外层”图片”位置的独立用户数。
video_click_pv int64 视频点击次数 用户点击朋友圈广告外层”视频”位置的总次数(包括手动点击播放、点击进入落地页或小视频全屏页)。
video_click_uv int64 视频点击人数 点击朋友圈广告外层”视频”位置的独立用户数。
link_click_pv int64 文字链点击次数 用户点击朋友圈广告外层”文字链”位置的次数。
link_click_uv int64 文字链点击人数 点击广告朋友圈广告外层“文字链”位置的独立用户数。
head_pv int64 头像点击次数 用户点击朋友圈广告外层“公众号头像”位置的总次数。
head_uv int64 头像点击人数 点击朋友圈广告外层“公众号头像”位置的独立用户数。
nick_pv int64 昵称点击次数 用户点击朋友圈广告外层“公众号昵称”位置的总次数。
nick_uv int64 昵称点击人数 点击朋友圈广告外层“公众号昵称”位置的独立用户数。
poi_pv int64 门店点击次数 用户点击朋友圈广告外层“门店”位置的总次数。
poi_uv int64 门店点击人数 用户点击朋友圈广告外层“门店”位置的独立用户数。
canvas_view_pv int64 原生推广页曝光次数 广告原生推广页的曝光次数。
canvas_view_uv int64 原生推广页曝光人数 广告原生推广页的曝光的独立用户数。
canvas_view_pv_rate int64 原生推广页曝光率 用户看到广告后进入原生推广页的百分比。计算逻辑:原生页曝光次数/广告曝光次数。
canvas_view_pv_average int64 原生推广页人均曝光次数 用户浏览原生推广页的平均次数。
canvas_viewtime_average int64 原生推广页人均曝光时长(秒) 用户浏览原生推广页的平均时长。
canvas_button_click_pv int64 原生推广页跳转按钮点击次数 广告原生推广页内跳转按钮点击次数之和。
canvas_button_click_uv int64 原生推广页跳转按钮点击人数 点击原生推广页跳转按钮的独立用户数。
canvas_button_click_pv_cost int64 原生推广页跳转按钮点击成本(分) 产生一个原生推广页跳转按钮点击用户的平均花费。计算逻辑:广告花费/原生推广页跳转按钮点击人数
praise_pv int64 点赞次数 用户在朋友圈广告点赞的总次数。
praise_uv int64 点赞人数 在朋友圈广告点赞的独立用户数。
comment_pv int64 评论次数 用户在朋友圈广告评论的总次数。
comment_uv int64 评论人数 在朋友圈广告评论的独立用户数。
follow_pv int64 公众号关注次数 用户通过广告关注公众号成功的次数。
download_complete_pv int64 APP下载完成次数 用户通过广告下载APP并下载完成的次数。
download_complete_pv_cost int64 APP下载完成成本(分) 产生一次APP下载完成的平均花费。计算逻辑:广告花费/APP下载完成次数。
install_complete_pv int64 APP安装完成次数 用户通过广告下载APP并安装完成的次数。
install_complete_pv_cost int64 APP安装完成成本(分) 产生一次APP安装完成的平均花费。计算逻辑:广告花费/APP安装完成次数。
activated_pv int64 APP激活次数 用户通过广告下载APP并安装完成后,在联网环境下完成激活(指首次打开APP)的次数。
activated_pv_cost int64 APP激活成本(分) 产生一次APP激活的平均花费。计算逻辑:广告花费/APP激活次数。
接入转化跟踪后可统计
app_register_pv int64 APP注册次数 用户通过广告下载APP并安装完成后,在联网环境下完成激活后注册的次数。
app_register_pv_cost int64 APP注册成本(分) 产生一次APP注册的平均花费。计算逻辑:广告花费/APP注册次数。
接入转化跟踪后可统计
app_add_to_car_pv int64 APP加入购物车次数 用户通过广告下载APP并安装完成并激活后,在APP内发起购买而未完成付费的行为次数,如加入购物车、下单。
app_checkout_pv int64 APP付费次数 用户通过广告下载APP并安装完成并激活后,在APP内进行付费的次数。
card_coupon_get_pv int64 卡券领取次数 用户通过广告领取卡券成功的次数。
card_coupon_use_pv int64 卡券使用次数 用户通过广告领取卡券后,使用卡券的次数。
order_pv int64 下单量 用户通过该广告进行商品成交(如下单提交、在线支付)的次数。
order_amount int64 下单金额 广告带来的总订单金额(即销售额)。
order_unit_price int64 下单客单价(分) 下单金额/下单量。
接入转化跟踪后可统计
order_roi float 下单ROI 下单金额/广告花费。
leads_pv int64 销售线索次数 广告带来的用户销售线索数量。
leads_uv int64 销售线索人数 广告带来的用户销售线索数量按用户去重,同一个用户多次提交仅计算一次。
valid_leads_pv int64 有效销售线索量 广告主回拨后确认为有效线索的数目。
valid_leads_pv_cost int64 有效销售线索成本(分) 广告花费/有效销售线索量。
接入转化跟踪后可统计
valid_leads_pv_rate float 有效销售线索率 有效销售线索量/提交销售线索人数。
wechat_registration_pv int64 公众号内注册次数 用户通过关注类广告关注公众号后,在公众号内部产生了广告主定义的注册行为的数量(PV)。
wechat_registration_uv int64 公众号内注册人数 用户通过关注类广告关注公众号后,在公众号内部产生了广告主定义的注册行为的独立用户数(UV)。
wechat_registration_uv_rate float 公众号内注册比例 公众号内注册独立用户数(UV)/公众号关注次数。
wechat_registration_pv_cost int64 公众号内注册成本(分) 广告花费/广告产生的注册行为数量(PV)。
接入转化跟踪后可统计
wechat_registration_roi float 公众号内注册ROI 注册产生的订单金额累计/广告花费。
wechat_leads_pv int64 公众号内填单次数 用户通过关注类广告关注公众号后,在公众号内部产生了广告主定义的填单行为的数量(PV)。
wechat_leads_uv int64 公众号内填单人数 用户通过关注类广告关注公众号后,在公众号内部产生了广告主定义的填单行为的独立用户数(UV)。
wechat_leads_uv_rate float 公众号内填单比例 公众号内填单的独立用户数(UV)/公众号关注次数。
wechat_leads_pv_cost int64 公众号内填单成本(分) 广告花费/广告产生的填单行为数量(PV)。
接入转化跟踪后可统计
wechat_leads_roi float 公众号内填单ROI 填单产生的订单金额累计/广告花费。
wechat_order_pv int64 公众号内下单次数 用户通过关注类广告关注公众号后,在公众号内部产生了广告主定义的下单行为的数量(PV)。
wechat_order_uv int64 公众号内下单人数 用户通过关注类广告关注公众号后,在公众号内部产生了广告主定义的下单行为的独立用户数(UV)。
wechat_order_uv_rate float 公众号内下单比例 公众号内下单独立用户数(UV)/公众号关注次数。
wechat_order_pv_cost int64 公众号内下单成本(分) 广告花费/广告产生的下单行为数量(PV)。
接入转化跟踪后可统计
wechat_order_roi float 公众号内下单ROI 下单产生的订单金额累计/广告花费。
share_pv int64 广告分享次数 用户将广告落地页分享给好友和朋友圈的次数。
share_uv int64 广告分享人数 将广告落地页分享给好友和朋友圈的独立用户数。
nointerest_pv int64 不感兴趣点击次数 用户点击“不感兴趣”的次数。
outer_video_play_pv int64 外层视频播放次数 用户播放朋友圈广告外层”视频”的总次数。
outer_video_play_uv int64 外层视频播放人数 播放朋友圈广告外层”视频”的独立用户数。
canvas_video_play_pv int64 推广页视频播放次数 用户进入推广页后观看视频的总次数(不含H5)。
canvas_video_play_uv int64 推广页视频播放人数 用户进入推广页后观看视频的独立用户数(不含H5)。
 

【获取微信投放平台广告天报表/小时报表】数据列依次是:

名称 类型 描述 指标含义
agency_account_id string 微信服务商帐号id 微信服务商帐号id
advertiser_account_id string 微信广告主帐号id 微信广告主帐号id
wechat_campaign_id int64 微信投放计划id 微信投放计划id
wechat_campaign_name string 微信投放计划名称 微信投放计划名称
wechat_adgroup_id int64 微信广告id 微信广告id
wechat_adgroup_name string 微信广告名称 微信广告名称
adgroup_id int64 广告组id 广告组id
hour int64 时间 时间,格式如:2019032610

仅TASK_TYPE_WECHAT_ADGROUP_HOURLY_REPORT(微信广告组小时报表)返回

promoted_object_type enum 推广目标 你希望通过广告实现的营销目标。
PROMOTED_OBJECT_TYPE_APP_ANDROID //安卓下载类广告
PROMOTED_OBJECT_TYPE_APP_IOS //ios下载类广告
PROMOTED_OBJECT_TYPE_FOLLOW_WECHAT //关注类广告
PROMOTED_OBJECT_TYPE_ARTICLE_WECHAT        //品牌活动推广
PROMOTED_OBJECT_TYPE_LINK_WECHAT //品牌活动推广
PROMOTED_OBJECT_TYPE_CARD_WECHAT  //卡券类广告
PROMOTED_OBJECT_TYPE_LOCAL_ADS_WECHAT //lbs类广告
PROMOTED_OBJECT_TYPE_ECOMMERCE //电商推广类目
PROMOTED_OBJECT_TYPE_LEAD_ADS_WECHAT //表单推广类目
PROMOTED_OBJECT_TYPE_MINI_GAME_WECHAT //小游戏类目
PROMOTED_OBJECT_TYPE_LINK_JD //京东电商推广
PROMOTED_OBJECT_TYPE_COUPON_WECHAT_PAY //微信支付代金券
PROMOTED_OBJECT_TYPE_UNSUPPORTED //暂不支持枚举值
buying_type enum 购买类型 指通过合约或竞价购买。购买类型决定了如何支付广告费用和设置广告目标受众。BUYING_TYPE_CONTRACT //合约广告
BUYING_TYPE_AUCTION //竞价广告
BUYING_TYPE_UNSUPPORTED //暂不支持枚举值
position_id int64 广告位 广告展现的位置。
0, //公众号底部广告
3,  // H5视频贴片
4,  //互选广告
5,  //文中广告位
6,  //邮箱广告
7,  //小程序广告
8,  //小游戏激励视频广告位
9,  //公众号文章中的商品广告位
10, //小程序小游戏插屏广告位
101, //通投场景广告位
999, //朋友圈
begin_time int64 开始时间(时间戳) 广告投放开始时间
end_time int64 结束时间(时间戳) 广告投放结束时间
status enum 状态 广告计划、广告组合、创意目前的投放状态。
AD_STATUS_PENDING      //审核中
AD_STATUS_DENIED       //未通过
AD_STATUS_READY        //待投放
AD_STATUS_NORMAL       //投放中
AD_STATUS_SUSPEND      //暂停投放
AD_STATUS_FINISH       //投放结束
AD_STATUS_CREATING     //创建中
AD_STATUS_CANCEL       //取消投放
AD_STATUS_UNKNOWN      //异常状态
AD_STATUS_COOPERATION_PENDING   //合作确认中
AD_STATUS_COOPERATION_FAIL    //合作未达成
AD_STATUS_HOST_ARTICLE_PREPARING //文章编辑中
AD_STATUS_HOST_ARTICLE_PENDING  //文章待确认
AD_STATUS_TO_LOCK_FLOW        //待锁定
AD_STATUS_LOCK_FLOW_FAIL        //排期失败
AD_STATUS_LOCK_FLOW_SUCCESS     //已锁量待提交
AD_STATUS_LOCK_FLOW_ING         //等待排期结果
AD_STATUS_UNSUPPORTED //暂不支持枚举值
optimization_goal enum 优化目标 预期用户因广告投放产生的操作行动
OPTIMIZATIONGOAL_NONE  //非ocpm老
OPTIMIZATIONGOAL_IMPRESSION  //展示曝光
OPTIMIZATIONGOAL_CLICK  //点击
OPTIMIZATIONGOAL_BRAND_CONVERSION //品牌转化
OPTIMIZATIONGOAL_APP_DOWNLOAD  //android下载
OPTIMIZATIONGOAL_APP_ACTIVATE  //ios激活
OPTIMIZATIONGOAL_FOLLOW  //关注
OPTIMIZATIONGOAL_ECOMMERCE_ORDER //下单
OPTIMIZATIONGOAL_LEADS //收集线索
OPTIMIZATIONGOAL_ECOMMERCE_CART //加入购物
OPTIMIZATIONGOAL_CANVAS_CLICK //外跳
OPTIMIZATIONGOAL_APP_REGISTER //注册
OPTIMIZATIONGOAL_APP_PURCHASE //付费用户
OPTIMIZATIONGOAL_UNSUPPORTED //暂不支持枚举值
bid_action_type enum 出价方式 广告主出价方式选择
BID_ACTION_TYPE_NONE  //兼容老广告
BID_ACTION_TYPE_IMPRESSION  //按曝光出价
BID_ACTION_TYPE_CLICK  //按点击出价
BID_ACTION_TYPE_BRAND_CONVERSION //按品牌转化出价
BID_ACTION_TYPE_APP_DOWNLOAD  //android下载
BID_ACTION_TYPE_APP_ACTIVATE  //ios激活
BID_ACTION_TYPE_FOLLOW  //关注
BID_ACTION_TYPE_ECOMMERCE_ORDER //下单
BID_ACTION_TYPE_LEADS //收集线索
BID_ACTION_TYPE_ECOMMERCE_CART //加入购物
BID_ACTION_TYPE_CANVAS_CLICK //外跳
BID_ACTION_TYPE_APP_REGISTER //注册
BID_ACTION_TYPE_APP_PURCHASE //付费用户
BID_ACTION_TYPE_UNSUPPORTED //暂不支持枚举值
total_budget int64 广告总预算(元) 合约及竞价广告的投放总预算。
bid_average int64 平均出价(元) 广告从上线至今的平均出价。
bid_amount int64 当前出价(元) 您为该广告设置的当前出价
cost int64 花费(元) 广告的花费金额。
view_pv int64 曝光次数 用户观看广告的次数。
view_uv int64 曝光人数 观看广告的独立用户数。
view_pv_average float 人均曝光次数 每个用户观看广告的平均次数。
click_pv int64 点击次数 用户在广告外层进行点击操作的次数。包括点击图片/视频,及朋友圈广告“文字链、头像、昵称、门店、选择按钮”等所有广告外层区域的点击。
click_uv int64 点击人数 在广告外层进行点击操作的独立用户数。
ctr float 点击率 看到广告后执行点击操作的百分比。计算逻辑:广告点击次数/广告曝光次数。
cpc int64 点击均价(元) 一次广告点击的平均花费。计算逻辑:广告花费/广告点击次数。
conversion_click_pv int64 可转化点击次数 可转化点击是指可能产生转化的外层点击次数。对于“公众号推广”的广告,包括外层的公众号头像、公众号昵称、详情页查看、原生推广页查看;
对于其他类型的广告,包括外层的详情页查看和原生推广页查看。
conversion_click_pv_rate float 可转化点击率 用户看到广告后执行可转化点击操作的百分比。计算逻辑:广告可转化点击次数/广告曝光次数。
conversion_click_pv_cost int64 可转化点击成本 一次可转化点击的平均花费。计算逻辑:广告花费/可转化点击次数。
image_pv int64 图片点击次数 用户点击朋友圈广告外层”图片”位置的总次数。
image_uv int64 图片点击人数 点击朋友圈广告外层”图片”位置的独立用户数。
video_click_pv int64 视频点击次数 用户点击朋友圈广告外层”视频”位置的总次数(包括手动点击播放、点击进入落地页或小视频全屏页)。
video_click_uv int64 视频点击人数 点击朋友圈广告外层”视频”位置的独立用户数。
link_click_pv int64 文字链点击次数 用户点击朋友圈广告外层”文字链”位置的次数。
link_click_uv int64 文字链点击人数 点击广告朋友圈广告外层“文字链”位置的独立用户数。
head_pv int64 头像点击次数 用户点击朋友圈广告外层“公众号头像”位置的总次数。
head_uv int64 头像点击人数 点击朋友圈广告外层“公众号头像”位置的独立用户数。
nick_pv int64 昵称点击次数 用户点击朋友圈广告外层“公众号昵称”位置的总次数。
nick_uv int64 昵称点击人数 点击朋友圈广告外层“公众号昵称”位置的独立用户数。
poi_pv int64 门店点击次数 用户点击朋友圈广告外层“门店”位置的总次数。
poi_uv int64 门店点击人数 用户点击朋友圈广告外层“门店”位置的独立用户数。
canvas_view_pv int64 原生推广页曝光次数 广告原生推广页的曝光次数。
canvas_view_uv int64 原生推广页曝光人数 广告原生推广页的曝光的独立用户数。
canvas_view_pv_rate float 原生推广页曝光率 用户看到广告后进入原生推广页的百分比。计算逻辑:原生页曝光次数/广告曝光次数。
canvas_view_pv_average float 原生推广页人均曝光次数 用户浏览原生推广页的平均次数。
canvas_viewtime_average float 原生推广页人均曝光时长(秒) 用户浏览原生推广页的平均时长。
canvas_button_click_pv int64 原生推广页跳转按钮点击次数 广告原生推广页内跳转按钮点击次数之和。
canvas_button_click_uv int64 原生推广页跳转按钮点击人数 点击原生推广页跳转按钮的独立用户数。
canvas_button_click_pv_cost int64 原生推广页跳转按钮点击成本(元) 产生一个原生推广页跳转按钮点击用户的平均花费。计算逻辑:广告花费/原生推广页跳转按钮点击人数
praise_pv int64 点赞次数 用户在朋友圈广告点赞的总次数。
praise_uv int64 点赞人数 在朋友圈广告点赞的独立用户数。
comment_pv int64 评论次数 用户在朋友圈广告评论的总次数。
comment_uv int64 评论人数 在朋友圈广告评论的独立用户数。
conversion int64 转化指标 根据您选择的推广目标,对应的转化指标分别为:
推广公众号:公众号关注次数
推广Android应用:安装完成次数
推广IOS应用:激活次数
推广卡券:卡券领取次数
推广电商:下单量
收集销售线索:提交销售线索人数(2018年11月20日起该指标已切换为提交销售线索人数,在此之前为提交销售线索次数)
推广品牌活动:无转化指标
推广我的门店:无转化指标
部分推广目标需接入转化跟踪后可统计前往查看
cpa int64 转化成本(元) 产生一次广告转化的平均费用。计算逻辑:广告花费/转化指标。
部分推广目标需接入转化跟踪后可统计前往查看
cvr float 转化率 朋友圈:转化指标/可转化点击次数。
公众号:转化指标/点击次数。
接入转化跟踪后可统计前往查看
follow_pv int64 公众号关注次数 用户通过广告关注公众号成功的次数。
download_complete_pv int64 APP下载完成次数 用户通过广告下载APP并下载完成的次数。
download_complete_pv_cost int64 APP下载完成成本(元) 产生一次APP下载完成的平均花费。计算逻辑:广告花费/APP下载完成次数。
install_complete_pv int64 APP安装完成次数 用户通过广告下载APP并安装完成的次数。
install_complete_pv_cost int64 APP安装完成成本(元) 产生一次APP安装完成的平均花费。计算逻辑:广告花费/APP安装完成次数。
activated_pv int64 APP激活次数 用户通过广告下载APP并安装完成后,在联网环境下完成激活(指首次打开APP)的次数。
接入转化跟踪后可统计前往查看
activated_pv_cost int64 APP激活成本(元) 产生一次APP激活的平均花费。计算逻辑:广告花费/APP激活次数。
接入转化跟踪后可统计前往查看
app_register_pv int64 APP注册次数 用户通过广告下载APP并安装完成后,在联网环境下完成激活后注册的次数。
接入转化跟踪后可统计前往查看
app_register_pv_cost int64 APP注册成本(元) 产生一次APP注册的平均花费。计算逻辑:广告花费/APP注册次数。
接入转化跟踪后可统计前往查看
app_add_to_car_pv int64 APP加入购物车次数 用户通过广告下载APP并安装完成并激活后,在APP内发起购买而未完成付费的行为次数,如加入购物车、下单。
接入转化跟踪后可统计前往查看
app_checkout_pv int64 APP付费次数 用户通过广告下载APP并安装完成并激活后,在APP内进行付费的次数。
接入转化跟踪后可统计前往查看
card_coupon_get_pv int64 卡券领取次数 用户通过广告领取卡券成功的次数。
card_coupon_use_pv int64 卡券使用次数 用户通过广告领取卡券后,使用卡券的次数。
order_pv int64 下单量 用户通过该广告进行商品成交(如下单提交、在线支付)的次数。
接入转化跟踪后可统计前往查看
order_amount int64 下单金额 广告带来的总订单金额(即销售额)。
接入转化跟踪后可统计前往查看
order_unit_price int64 下单客单价(元) 下单金额/下单量。
接入转化跟踪后可统计前往查看
order_roi float 下单ROI 下单金额/广告花费。
接入转化跟踪后可统计前往查看
leads_pv int64 销售线索次数 广告带来的用户销售线索数量。
H5推广需接入转化跟踪后可统计前往查看
leads_uv int64 销售线索人数 广告带来的用户销售线索数量按用户去重,同一个用户多次提交仅计算一次。
H5推广需接入转化跟踪后可统计前往查看
valid_leads_pv int64 有效销售线索量 广告主回拨后确认为有效线索的数目。
接入转化跟踪后可统计前往查看
valid_leads_pv_cost int64 有效销售线索成本(元) 广告花费/有效销售线索量。
接入转化跟踪后可统计前往查看
valid_leads_pv_rate float 有效销售线索率 有效销售线索量/提交销售线索人数。
接入转化跟踪后可统计前往查看
wechat_registration_pv int64 公众号内注册次数 用户通过关注类广告关注公众号后,在公众号内部产生了广告主定义的注册行为的数量(PV)。
接入转化跟踪后可统计(公众号接入暂未全量开放) 前往查看
wechat_registration_uv int64 公众号内注册人数 用户通过关注类广告关注公众号后,在公众号内部产生了广告主定义的注册行为的独立用户数(UV)。
接入转化跟踪后可统计(公众号接入暂未全量开放) 前往查看
wechat_registration_uv_rate float 公众号内注册比例 公众号内注册独立用户数(UV)/公众号关注次数。
接入转化跟踪后可统计(公众号接入暂未全量开放) 前往查看
wechat_registration_pv_cost int64 公众号内注册成本(元) 广告花费/广告产生的注册行为数量(PV)。
接入转化跟踪后可统计(公众号接入暂未全量开放) 前往查看
wechat_registration_roi float 公众号内注册ROI 注册产生的订单金额累计/广告花费。
接入转化跟踪后可统计(公众号接入暂未全量开放) 前往查看
wechat_leads_pv int64 公众号内填单次数 用户通过关注类广告关注公众号后,在公众号内部产生了广告主定义的填单行为的数量(PV)。
接入转化跟踪后可统计(公众号接入暂未全量开放) 前往查看
wechat_leads_uv int64 公众号内填单人数 用户通过关注类广告关注公众号后,在公众号内部产生了广告主定义的填单行为的独立用户数(UV)。
接入转化跟踪后可统计(公众号接入暂未全量开放) 前往查看
wechat_leads_uv_rate float 公众号内填单比例 公众号内填单的独立用户数(UV)/公众号关注次数。
接入转化跟踪后可统计(公众号接入暂未全量开放) 前往查看
wechat_leads_pv_cost int64 公众号内填单成本(元) 广告花费/广告产生的填单行为数量(PV)。
接入转化跟踪后可统计(公众号接入暂未全量开放) 前往查看
wechat_leads_roi float 公众号内填单ROI 填单产生的订单金额累计/广告花费。
接入转化跟踪后可统计(公众号接入暂未全量开放) 前往查看
wechat_order_pv int64 公众号内下单次数 用户通过关注类广告关注公众号后,在公众号内部产生了广告主定义的下单行为的数量(PV)。
接入转化跟踪后可统计(公众号接入暂未全量开放) 前往查看
wechat_order_uv int64 公众号内下单人数 用户通过关注类广告关注公众号后,在公众号内部产生了广告主定义的下单行为的独立用户数(UV)。
接入转化跟踪后可统计(公众号接入暂未全量开放) 前往查看
wechat_order_uv_rate float 公众号内下单比例 公众号内下单独立用户数(UV)/公众号关注次数。
接入转化跟踪后可统计(公众号接入暂未全量开放) 前往查看
wechat_order_pv_cost int64 公众号内下单成本(元) 广告花费/广告产生的下单行为数量(PV)。
接入转化跟踪后可统计(公众号接入暂未全量开放) 前往查看
wechat_order_roi float 公众号内下单ROI 下单产生的订单金额累计/广告花费。
接入转化跟踪后可统计(公众号接入暂未全量开放) 前往查看
share_pv int64 广告分享次数 用户将广告落地页分享给好友和朋友圈的次数。
share_uv int64 广告分享人数 将广告落地页分享给好友和朋友圈的独立用户数。
nointerest_pv int64 不感兴趣点击次数 用户点击“不感兴趣”的次数。
outer_video_play_pv int64 外层视频播放次数 用户播放朋友圈广告外层”视频”的总次数。
outer_video_play_uv int64 外层视频播放人数 播放朋友圈广告外层”视频”的独立用户数。
canvas_video_play_pv int64 推广页视频播放次数 用户进入推广页后观看视频的总次数(不含H5)。
canvas_video_play_uv int64 推广页视频播放人数 用户进入推广页后观看视频的独立用户数(不含H5)。

注:字段内容如为空,则表示该字段在该广告位下无意义;字段内容如为“–”,则表示该字段在该广告位下有意义,但无法计算(如分母为0)。

【获取微信广告平台投放的广告数据】数据:

所有数据会通过一份文件进行返回,文件中每条广告数据会以一条JSON的格式进行返回,JSON文件的解析结构见下方:

 

 

 

字段名称 字段类型 字段描述 字段详情
agency_account_id string 微信服务商帐号id
advertiser_account_id string 微信广告主帐号id
wechat_adgroup_id int64 微信广告组id
wechat_adgroup_name string 微信广告组名称
wechat_campaign_id int64 微信推广计划id
wechat_campaign_name string 微信推广计划名称
promoted_object_type enum 推广目标 PROMOTED_OBJECT_TYPE_APP_ANDROID  //安卓下载类广告
PROMOTED_OBJECT_TYPE_APP_IOS  //ios下载类广告
PROMOTED_OBJECT_TYPE_FOLLOW_WECHAT  //关注类广告
PROMOTED_OBJECT_TYPE_ARTICLE_WECHAT//品牌活动推广
PROMOTED_OBJECT_TYPE_LINK_WECHAT  //品牌活动推广
PROMOTED_OBJECT_TYPE_CARD_WECHAT   //卡券类广告
PROMOTED_OBJECT_TYPE_LOCAL_ADS_WECHAT  //lbs类广告
PROMOTED_OBJECT_TYPE_ECOMMERCE  //电商推广类目
PROMOTED_OBJECT_TYPE_LEAD_ADS_WECHAT  //表单推广类目
PROMOTED_OBJECT_TYPE_MINI_GAME_WECHAT  //小游戏类目
PROMOTED_OBJECT_TYPE_LINK_JD  //京东电商推广
PROMOTED_OBJECT_TYPE_COUPON_WECHAT_PAY  //微信支付代金券
PROMOTED_OBJECT_TYPE_UNSUPPORTED //未支持的推广目标
buying_type enum 购买类型 BUYING_TYPE_CONTRACT //合约广告
BUYING_TYPE_AUCTION //竞价广告
BUYING_TYPE_UNSUPPORTED// 未支持的购买类型
position_id int64 广告位 0, //公众号底部广告
3,   // H5视频贴片
4,   //互选广告
5,   //文中广告位
6,   //邮箱广告
7,   //小程序广告
8,   //小游戏激励视频广告位
9,   //公众号文章中的商品广告位
10,  //小程序小游戏插屏广告位
11, //小程序视频广告位
999, //朋友圈
begin_time,end_time int64 开始时间,结束时间(时间戳)
status enum 状态 AD_STATUS_PENDING       //审核中
AD_STATUS_DENIED        //未通过
AD_STATUS_READY         //待投放
AD_STATUS_NORMAL        //投放中
AD_STATUS_SUSPEND       //暂停投放
AD_STATUS_FINISH        //投放结束
AD_STATUS_CREATING      //创建中
AD_STATUS_CANCEL        //取消投放
AD_STATUS_UNKNOWN       //异常状态
AD_STATUS_COOPERATION_PENDING    //合作确认中
AD_STATUS_COOPERATION_FAIL     //合作未达成
AD_STATUS_HOST_ARTICLE_PREPARING //文章编辑中
AD_STATUS_HOST_ARTICLE_PENDING   //文章待确认
AD_STATUS_TO_LOCK_FLOW         //待锁定
AD_STATUS_LOCK_FLOW_FAIL         //排期失败
AD_STATUS_LOCK_FLOW_SUCCESS      //已锁量待提交
AD_STATUS_LOCK_FLOW_ING          //等待排期结果
AD_STATUS_UNSUPPORTED //为支持的广告状态
optimization_goal enum 优化目标 OPTIMIZATIONGOAL_NONE   //非ocpm老
OPTIMIZATIONGOAL_IMPRESSION   //展示曝光
OPTIMIZATIONGOAL_CLICK   //点击
OPTIMIZATIONGOAL_BRAND_CONVERSION //品牌转化
OPTIMIZATIONGOAL_APP_DOWNLOAD   //android下载
OPTIMIZATIONGOAL_APP_ACTIVATE   //ios激活
OPTIMIZATIONGOAL_FOLLOW   //关注
OPTIMIZATIONGOAL_ECOMMERCE_ORDER  //下单
OPTIMIZATIONGOAL_LEADS  //收集线索
OPTIMIZATIONGOAL_ECOMMERCE_CART  //加入购物
OPTIMIZATIONGOAL_CANVAS_CLICK // 外跳
OPTIMIZATIONGOAL_APP_REGISTER  // 注册
OPTIMIZATIONGOAL_APP_PURCHASE  // 付费用户
OPTIMIZATIONGOAL_UNSUPPORTED //未支持的优化目标
bid_action_type enum 出价方式 BID_ACTION_TYPE_NONE   //兼容老广告
BID_ACTION_TYPE_IMPRESSION   //按曝光出价
BID_ACTION_TYPE_CLICK   //按点击出价
BID_ACTION_TYPE_BRAND_CONVERSION //按品牌转化出价
BID_ACTION_TYPE_APP_DOWNLOAD   //android下载
BID_ACTION_TYPE_APP_ACTIVATE   //ios激活
BID_ACTION_TYPE_FOLLOW   //关注
BID_ACTION_TYPE_ECOMMERCE_ORDER  //下单
BID_ACTION_TYPE_LEADS  //收集线索
BID_ACTION_TYPE_ECOMMERCE_CART  //加入购物
BID_ACTION_TYPE_CANVAS_CLICK // 外跳
BID_ACTION_TYPE_APP_REGISTER  // 注册
BID_ACTION_TYPE_APP_PURCHASE  // 付费用户
BID_ACTION_TYPE_UNSUPPORTED// 未支持的出价方式
bid_amount int64 广告出价,单位为分
campaign_created_time int64 广告计划创建时间
adgroup_created_time int64 广告组创建时间
wechat_creative_id int64 微信创意id
creative_name string 创意名称
targeting_spec struct 定向信息 定向详细结构见:元数据附表1,
creative_created_time int64 创意创建时间
adcreative_elements struct 创意元素信息
     image_list string[] 图片素材地址
     short_video_list string[] 短视频素材地址
     title string 标题
     long_video_list string[] 长视频素材地址
     description_list string[] 文案描述
page_type enum 创意外层跳转落地页类型 落地页详细接口见:元数据附表2
page_spec string 创意外层跳转落地页详情
     page_id int64 落地页id
     page_url string 落地页地址
     mini_program_spec string 小程序信息
         mini_program_id string 小程序id
         mini_program_path string 小程序路径

 

元数据附表1

其中定向信息Targeting_spec结构如下:

字段名称 字段类型 字段描述 字段详情
age struct 年龄 ,14-61岁, 61岁代表61岁及以上
     min int64 年龄最小值限制
     max int64 年龄最大值限制
gender enum 性别 MALE 男
FEMAL 女
education enum 用户学历 DOCTOR 博士
MASTER 硕士
BACHELOR 本科
SENIOR 高中
JUNIOR 初中
PRIMARY 小学
JUNIOR_COLLEGE 专科
marital_status enum 婚恋状态 SINGLE 单身
NEWLY_MARRIED 新婚
MARRIED 已婚
PARENTING 育儿
geo_location struct 地理位置定向
geo_location字段内部地理位置信息为取并集关系
geo_location_expand与geo_locations中的地理位置信息为取交集关系
     location_types enum 地点类型 RECENTLY_IN 近期
VISITED_IN 去过
LIVE_IN 常驻
TRAVEL_IN 旅行
     regions integer 地理位置列表 地域信息可通过targeting_tags/get接口获取
     business_districts integer 商圈 id 列表 商圈信息可通过targeting_tags/get接口获取
geo_location_expand 补充地理位置定向,
geo_location_expand字段内部地理位置信息为取交集关系
geo_location_expand与geo_locations中的地理位置信息为取交集关系
     location_types enum 地点类型 RECENTLY_IN 近期
VISITED_IN 去过
LIVE_IN 常驻
TRAVEL_IN 旅行
     regions integer 地理位置列表 地域信息可通过targeting_tags/get接口获取
     business_districts integer 商圈 id 列表 商圈信息可通过targeting_tags/get接口获取
user_os enum 操作系统定向 IOS
ANDROID
device_price enum 设备价格定向 PRICE_1500_LESS,
PRICE_1500_2500,
PRICE_2500_3500,
PRICE_3500_4500,
PRICE_4500_MORE
network_operator enum 运营商定向 CMCC 中国移动
CUC 中国联通
CTC 中国电信
actions enum 包含的行为列表 包含的行为列表
已关注你的公众号:WECHAT_OFFICIAL_ACCOUNT_FOLLOWED
曾领取你的微信卡券:WECHAT_COUPON_OBTAINED,
已安装你的应用:APP_INSTALLED
曾对你的微信广告感兴趣:
WECHAT_AD_LIKE
excluded_actions enum 排除的行为列表 包含的行为列表
已关注你的公众号:WECHAT_OFFICIAL_ACCOUNT_FOLLOWED
曾领取你的微信卡券:WECHAT_COUPON_OBTAINED,
已安装你的应用:APP_INSTALLED
曾对你的微信广告感兴趣:
WECHAT_AD_LIKE
behavior_or_interest struct 行为兴趣定向 定向枚举信息可通过targeting_tags/get接口获取
     interest struct 行为兴趣定向的兴趣部分
               targeting_tags
     behavior struct 行为兴趣定向的行为部分
               targeting_tags string 行为标签列表
               scene enum 行为兴趣定向的行为部分的场景
               time_window enum 行为兴趣定向的行为部分的时间窗 BEHAVIOR_INTEREST_TIME_WINDOW_SEVEN_DAY // 7 天
BEHAVIOR_INTEREST_TIME_WINDOW_FIFTEEN_DAY // 15 天
BEHAVIOR_INTEREST_TIME_WINDOW_THIRTY_DAY //30 天
BEHAVIOR_INTEREST_TIME_WINDOW_THREE_MONTH // 3个月
BEHAVIOR_INTEREST_TIME_WINDOW_SIX_MONTH //6个月
BEHAVIOR_INTEREST_TIME_WINDOW_ONE_YEAR // 1年
               intensity enum 行为兴趣定向的行为部分的强度 BEHAVIOR_INTEREST_INTENSITY_ALL//全部强度
BEHAVIOR_INTEREST_INTENSITY_HIGH //高强度
network_type enum 联网方式定向 WIFI//无线网络
NET_2G//3G 网络
NET_3G//3G 网络
NET_4G//4G 网络
wechat_custom_audience_id string[] 微信定向包id列表
wechat_excluded_custom_audience_id string[] 微信排除定向包id列表

元数据附表2

下表为外层跳转落地页跳转效果对应的落地页信息指标:

外层跳转效果 page_type page_spec 备注
H5外链 PAGE_TYPE_DEFAULT page_url 外链地址
原生推广页 PAGE_TYPE_CANVAS_WECHAT page_id 原生页id
小程序落地页 PAGE_TYPE_MINI_PROGRAM_WECHAT mini_program_spec 小程序id

小程序路径(如果有填写)

备注:本次暂不支持小程序落地页信息返回

小游戏 PAGE_TYPE_MINI_GAME_WECHAT mini_program_spec 小游戏id
公众号文章 PAGE_TYPE_OFFICAL_ACCOUNT_ARTICAL page_url 公众号文章地址
公众号主页 PAGE_TYPE_OFFICAL_ACCOUNT / page_spec为空
客户可在promoted_object_id处取到公众号appid
简版原生页 PAGE_TYPE_SIMPLE_CANVAS_WECHAT page_id 简版原生页id
素材放大效果 / / 素材放大为显示效果,无跳转落地页