异步任务

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

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

QQ账号生成的token获取广告小时报表
QQ账号生成的token获取API投放的微信朋友圈广告组小时报表
MP账号生成的token获取微信广告平台投放的广告组天报表
MP账号生成的token获取微信广告平台投放的广告组小时报表
MP账号生成的token获取微信广告平台投放的广告数据

异步任务接口目前限制每账号（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_cn": "",
    "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_cn": "",
    "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	float	下单金额	广告带来的总订单金额（即销售额）。
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		平均出价（元）	广告从上线至今的平均出价。
bid_amount		当前出价（元）	您为该广告设置的当前出价
cost	float	花费（元）	广告的花费金额。
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	float	可转化点击成本	一次可转化点击的平均花费。计算逻辑：广告花费/可转化点击次数。
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	float	原生推广页跳转按钮点击成本（元）	产生一个原生推广页跳转按钮点击用户的平均花费。计算逻辑：广告花费/原生推广页跳转按钮点击人数
praise_pv	int64	点赞次数	用户在朋友圈广告点赞的总次数。
praise_uv	int64	点赞人数	在朋友圈广告点赞的独立用户数。
comment_pv	int64	评论次数	用户在朋友圈广告评论的总次数。
comment_uv	int64	评论人数	在朋友圈广告评论的独立用户数。
conversion	int64	转化指标	根据您选择的推广目标，对应的转化指标分别为：推广公众号：公众号关注次数推广Android应用：安装完成次数推广IOS应用：激活次数推广卡券：卡券领取次数推广电商：下单量收集销售线索：提交销售线索人数（2018年11月20日起该指标已切换为提交销售线索人数，在此之前为提交销售线索次数）推广品牌活动：无转化指标推广我的门店：无转化指标部分推广目标需接入转化跟踪后可统计前往查看
cpa	float	转化成本（元）	产生一次广告转化的平均费用。计算逻辑：广告花费/转化指标。部分推广目标需接入转化跟踪后可统计前往查看
cvr	float	转化率	朋友圈：转化指标/可转化点击次数。公众号：转化指标/点击次数。接入转化跟踪后可统计前往查看
follow_pv	int64	公众号关注次数	用户通过广告关注公众号成功的次数。
download_complete_pv	int64	APP下载完成次数	用户通过广告下载APP并下载完成的次数。
download_complete_pv_cost	float	APP下载完成成本（元）	产生一次APP下载完成的平均花费。计算逻辑：广告花费/APP下载完成次数。
install_complete_pv	int64	APP安装完成次数	用户通过广告下载APP并安装完成的次数。
install_complete_pv_cost	float	APP安装完成成本（元）	产生一次APP安装完成的平均花费。计算逻辑：广告花费/APP安装完成次数。
activated_pv	int64	APP激活次数	用户通过广告下载APP并安装完成后，在联网环境下完成激活（指首次打开APP）的次数。接入转化跟踪后可统计前往查看
activated_pv_cost	float	APP激活成本（元）	产生一次APP激活的平均花费。计算逻辑：广告花费/APP激活次数。接入转化跟踪后可统计前往查看
app_register_pv	int64	APP注册次数	用户通过广告下载APP并安装完成后，在联网环境下完成激活后注册的次数。接入转化跟踪后可统计前往查看
app_register_pv_cost	float	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	float	下单金额	广告带来的总订单金额（即销售额）。接入转化跟踪后可统计前往查看
order_unit_price	int64	下单客单价（元）	下单金额/下单量。接入转化跟踪后可统计前往查看
order_roi	float	下单ROI	下单金额/广告花费。接入转化跟踪后可统计前往查看
leads_pv	int64	销售线索次数	广告带来的用户销售线索数量。 H5推广需接入转化跟踪后可统计前往查看
leads_uv	int64	销售线索人数	广告带来的用户销售线索数量按用户去重，同一个用户多次提交仅计算一次。 H5推广需接入转化跟踪后可统计前往查看
valid_leads_pv	int64	有效销售线索量	广告主回拨后确认为有效线索的数目。接入转化跟踪后可统计前往查看
valid_leads_pv_cost	float	有效销售线索成本（元）	广告花费/有效销售线索量。接入转化跟踪后可统计前往查看
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	float	公众号内注册成本（元）	广告花费/广告产生的注册行为数量（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	float	公众号内填单成本（元）	广告花费/广告产生的填单行为数量（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	float	公众号内下单成本（元）	广告花费/广告产生的下单行为数量（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）。
cpa_day_diff	float	当日成本偏差	反映广告今日的实际成本与目标成本直接的差异，移动鼠标至偏差可展开具体详情注：该项成本相关数据按小时更新，与实时更新的「转化目标成本」数据存在出入属于正常情况
bill_second_bid_avg	float	平均深度出价（元）	广告从上线至今的平均深度出价。
auto_compensate_money	float	赔付金额	智能优化成本保障政策下，广告超成本时的赔付金额
ecpm	float	千次曝光成本	平均每千次曝光的花费
special_h5_exp_pv	int	指定页面曝光人数	用户通过广告进入跳转向指定页面曝光的独立用户数。
special_h5_exp_cost	float	指定页面曝光成本（元）	广告花费/指定页面曝光人数。
conv_index	int	转化目标量	「转化目标」的具体数量，代表该广告的转化效果量级。不同类型广告的「转化目标」定义不同
conv_index_cpa	float	转化目标成本(元)	广告产生一次转化目标的平均费用。计算逻辑：广告花费/转化目标量。不同类型广告，「转化目标」的定义不同，点击查看”https://ad.weixin.qq.com/guide/1230″
conv_index_cvr	float	目标转化率	朋友圈：转化目标量/可转化点击次数。公众号：转化目标量/点击次数。该指标于19/8/30升级发布，覆盖了更多类型的广告
view_app_page_dedup_pv	int	关键页面访问人数	点击广告原生落地页的APP跳转按钮，并到达APP内关键页面的独立用户数。接入转化跟踪后可统计
install_complete_rate	float	APP安装完成率	一次点击到APP安装完成的转化率
app_act_rate	float	APP激活率	一次点击到APP激活的转化率
app_purchase_amount	float	APP付费金额（元）	用户通过广告下载APP并安装完成激活后，在APP 内进行付费的金额。接入转化跟踪后可统计
app_purchase_first_pv	int	APP首次付费人数	30天内在APP内进行首次付费的独立用户数。接入转化跟踪后可统计
app_purchase_first_cost	float	APP首次付费成本（元）	产生一个首次付费用户的平均花费。计算逻辑：广告花费/APP首次付费人数。接入转化跟踪后可统计
start_app_pv	int	APP次留人数	用户通过广告下载APP完成激活，次日再次打开APP的独立用户数。接入转化跟踪后可统计
start_app_cost	float	APP次留成本（元）	产生一个APP次留人数的平均花费。计算逻辑：广告花费/APP次留人数。接入转化跟踪后可统计
app_withdraw_deposits_dedup_pv	int	APP内提现人数	在APP内完成提现的独立用户数。接入转化跟踪后可统计
app_page_apply_dedup_pv	int	APP进件人数	在APP内完整提交贷款申请资料的独立用户数。接入转化跟踪后可统计
app_pre_credit_dedup_pv	int	APP预授信人数	在APP内完整提交贷款申请资料，通过放款方的资质审核，但暂未通过身份验证的独立用户数。接入转化跟踪后可统计
app_credit_dedup_pv	int	APP授信人数	在APP内完整提交贷款申请资料，通过放款方的资质审核和身份验证的独立用户数。接入转化跟踪后可统计
order_first_day_pv	int	首日新增下单量	广告推广获取的用户，点击广告当日，带来的下单次数。接入转化跟踪后可统计
order_cost	float	下单成本（次数）	产生一次下单的成本
order_rate	float	下单率	一次点击到下单的转化率
order_first_day_amount	float	首日新增下单金额	广告推广获取的用户，点击广告当日，带来的总订单金额（即销售额）。接入转化跟踪后可统计
sign_in_dedup_pv	int	签收次数	签收从广告主处购买的商品的次数。接入转化跟踪后可统计
add_to_wishlist_pv	int	加收藏次数	用户将广告主商品加入收藏的次数。接入转化跟踪后可统计
view_commodity_page_dedup_pv	int	商品详情页浏览人数	浏览广告主商品详情页的独立用户数。接入转化跟踪后可统计
quest_reservation_pv_cost	float	销售线索成本（次数）	提交一个销售线索的成本
quest_reservation_pv_rate	float	销售线索转化率（次数）	一次点击到提交一个销售线索的转化率
quest_reservation_uv_cost	float	销售线索成本（人数）	提交一个销售线索用户的成本
quest_reservation_uv_rate	float	销售线索转化率（人数）	一次点击到产生一个销售线索用户的转化率
leads_purchase_first_pv	int	付费销售线索人数	付费销售线索的独立用户数
leads_purchase_first_cost	float	付费销售线索成本	产生一个提交了有效销售线索用户的成本
leads_purchase_first_rate	float	付费销售线索转化率	一次点击到产生一个提交了付费销售线索用户的转化率
online_consult_dedup_pv	int	在线咨询人数	点击在线咨询按钮有实际咨询的独立用户数
online_valid_consult_dedup_pv	int	有效在线咨询人数	广告主在云智服营销后台确认为有效咨询的独立用户数
phone_call_dedup_pv	int	电话拨打人数	通过高级电话组件打出电话的独立用户数。
valid_phone_dedup_pv	int	有效电话拨打人数	点击智能电话组件确认外呼后，符合以下两种情况至少其一的独立用户数：①电话接通且通话时长≥10s；②广告主在线索管理平台手动标记为潜在客户、高意向客户或已成单。
potential_customer_phone_dedup_pv	int	电话潜在客户人数	点击智能电话组件确认外呼后，广告主在线索管理平台手动标记为潜在客户、高意向客户或已成单的独立用户数。
page_register_dedup_pv	int	网页注册人数	在网页内完成注册的独立用户数。接入转化跟踪后可统计
web_page_apply_dedup_pv	int	网页进件人数	在网页内完整提交贷款申请资料的独立用户数。接入转化跟踪后可统计
web_credit_dedup_pv	int	网页授信人数	在网页内完整提交贷款申请资料，通过放款方的资质审核和身份验证的独立用户数。接入转化跟踪后可统计
add_wechat_work_staff_dedup_pv	int	加企业微信客服人数	添加企业微信好友成功的独立用户数。
weapp_reg_pv	int	小游戏注册人数	通过广告首次登录小游戏的独立用户数。（19/7/20日-0点之后，该指标数据源已切换为平台数据，不再需要通过api回传数据。20号之前的数据，依然为客户自主回传的数据）。
weapp_reg_cost	float	小游戏注册成本（人数）	产生一个小游戏注册人数的成本
weapp_reg_rate	float	小游戏注册率	一次点击到小游戏注册的转化率
income_from_minigame_reg_arpu	float	首日新增广告ARPU	广告获取用户，在注册当日产生的平均广告变现收入。注：该指标天更新，可以查看昨天及以前的数据
weapp_start_pv	int	小游戏次留人数	通过广告首次登录小游戏，并在第二天再次登录的独立用户数。接入转化跟踪后可统计 https://ad.weixin.qq.com/guide/455
weapp_purchase_pv	int	小游戏付费次数	通过广告进入小游戏并完成付费的次数。接入转化跟踪后可统计https://ad.weixin.qq.com/guide/455
weapp_purchase_amount	float	小游戏付费金额（元）	通过广告进入小游戏并完成付费的金额。接入转化跟踪后可统计https://ad.weixin.qq.com/guide/455
follow_cost	float	公众号关注成本（次数）	产生一次公众号关注的成本
follow_rate	float	公众号关注率	一次点击到公众号关注的转化率
reg_att_value	float	公众号内注册订单金额（元）	用户通过关注类广告关注公众号后，在公众号内部产生了广告主定义的订单行为的订单金额（即销售额）。接入转化跟踪后可统计(公众号接入暂未全量开放)
reservation_att_value	float	公众号内填单金额（元）	用户通过关注类广告关注公众号后，在公众号内部产生了广告主定义的填单行为的订单金额（即销售额）。接入转化跟踪后可统计(公众号接入暂未全量开放)
order_first_day_att_pv	int	首日公众号内下单次数	广告推广获取的用户，在关注公众号当日，在公众号内部产生了广告主定义的下单行为数量（PV）。接入转化跟踪后可统计
order_att_value	float	公众号内下单金额（元）	用户通过关注类广告关注公众号后，在公众号内部产生了广告主定义的下单行为的订单金额（即销售额）。接入转化跟踪后可统计(公众号接入暂未全量开放)
order_first_day_att_value	float	首日公众号内下单金额（元）	广告推广获取的用户，在关注公众号当日，在公众号内部产生了广告主定义的下单行为订单金额（即销售额）。接入转化跟踪后可统计
consult_att_pv	int	公众号内发消息人数	用户关注公众号后，在公众号对话框内发送消息的独立用户数
reading_att_pv	int	阅读粉丝量	近3日新增的粉丝中产生阅读行为的用户数。
wechat_page_apply_dedup_pv	int	公众号内进件人数	在公众号内完整提交贷款申请资料的独立用户数。接入转化跟踪后可统计
wechat_credit_dedup_pv	int	公众号内授信人数	在公众号内完整提交贷款申请资料，并通过放款方的资质审核的独立用户数。接入转化跟踪后可统计
card_get_cost	float	卡券领取成本（次数）	产生一次卡券领取的成本
card_get_rate	float	卡券领取率	一次点击到卡券领取的转化率
promotion_claim_offer_pv	int	自定义卡券领取次数	用户领取广告主自主设定的卡券的次数。接入转化跟踪后可统计

注：字段内容如为空，则表示该字段在该广告位下无意义；字段内容如为“–”，则表示该字段在该广告位下有意义，但无法计算（如分母为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 //未支持的优化目标 OPTIMIZATIONGOAL_TELEPHONE_CONSULTATION//电话拨打 OPTIMIZATIONGOAL_PROMOTION_CLAIM_OFFER//领券 OPTIMIZATIONGOAL_PROMOTION_VIEW_KEY_PAGE//关键页面访问 OPTIMIZATIONGOAL_PROMOTION_CLICK_KEY_PAGE//公众号内注册 OPTIMIZATIONGOAL_PAGE_EFFECTIVE_ONLINE_CONSULT//有效在线咨询 OPTIMIZATIONGOAL_PAGE_EFFECTIVE_PHONE_CALL//进件 OPTIMIZATIONGOAL_CREDIT//授信 OPTIMIZATIONGOAL_VIEW_COMMODITY_PAGE//商品详情页浏览 OPTIMIZATIONGOAL_PAGE_SCAN_CODE//加企业微信客服 OPTIMIZATIONGOAL_MOBILE_APP_AD_INCOME//广告变现
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	小程序路径
link_page_type	enum	文字链跳转落地页类型	落地页详细类型见：元数据附表2
link_page_spec	string	文字链跳转落地页详情
page_id	int64	落地页id
page_url	string	落地页地址
mini_program_spec	string	小程序信息
mini_program_id	string	小程序id
mini_program_path	string	小程序路径
second_bid	float	当前深度出价	竞价广告深度智能优化，当前的深度出价

元数据附表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
素材放大效果	/	/	素材放大为显示效果，无跳转落地页

首页

开发文档

最新动态

腾讯广告

异步任务

请求示例

应答示例

请求示例

应答示例

请求示例