C/2/proxy/ads/analysis/effect count
proxy/ads/analysis/effect_count
批量获取推广微博的效果分析数据。
URL
https://c.api.weibo.com/2/proxy/ads/analysis/effect_count.json
支持格式
JSON
HTTP请求方式
GET
是否需要登录
是
关于登录授权,参见 如何登录授权
访问授权限制
请求所有商业接口:
- 50000次/小时/IP;
- 50000次/小时/IP;
请求参数
必选 | 类型及范围 | 说明 | |
---|---|---|---|
source | false | string | 采用OAuth授权方式不需要此参数,其他授权方式为必填参数,数值为应用的AppKey。 |
access_token | false | string | 采用OAuth授权方式为必填参数,其他授权方式不需要此参数,OAuth授权后获得。 |
ids | true | int64 | 需要查询的推广微博的ID列表,以逗号分隔,最多指定50个ID。 |
注意事项
- 当指定的所有微博都不是推广微博时,返回错误信息。当部分指定的微博是推广微博时,则将这部分微博的数据返回;
- 指定的微博一定是当前登录用户发布的微博,才返回数据。如果指定的部分微博是当前登录用户发布的微博,则将这部分微博的数据返回。当所有微博都不是当前登录用户发布的微博时,返回错误信息;
- 需要根据每个指定推广微博的推广方式返回相应数据,如:当推广微博只采用CPE方式推广,则只返回互动数,不返回曝光数;当推广微博只采用CPM方式推广,则只返回曝光数,不返回互动数;当推广微博采用CPE和CPM两种方式推广时,同时返回互动数和曝光数;
返回结果
JSON示例
{ "uid": 1265020392, //当前登录用户ID "effect_counts": [ { "id": 11488058246, //指定的推广微博ID "total_interaction_count": 30000, //所有终端上的互动总数 "total_exposure_count": 60000 //所有终端上的曝光总数 }, { "id": 11488058246, "total_interaction_count": 30000, "total_exposure_count": 60000 }, ... ] } //失败返回 { "request": "/proxy/ads/analysis/effect_count.json", "error_code": XXXXX, "error": "error message." }
关于错误返回值与错误代码,参见 错误代码说明
字段说明
无
其他
- 互动数的统计包括转发、赞、短链点击、收藏、关注的数据,不包括评论;
- 互动数、曝光数统计的是当前推广微博本身一层上的转发、赞、短链点击、收藏、关注、曝光等数据,转发微博上的相关数据不在统计内;