C/2/proxy/ads/analysis/effect count

跳转到: 导航, 搜索
Xuezheng (讨论 | 贡献)
(以“{{Api_desc_business| uri=proxy/ads/analysis/effect_count| desc=批量获取推广微博的效果分析数据。| httpMethod=GET| needAuth=是| rateLimit={{B_rate_lim...”为内容创建页面)

2015年7月9日 (四) 12:00的最后版本

proxy/ads/analysis/effect_count

批量获取推广微博的效果分析数据。

URL

https://c.api.weibo.com/2/proxy/ads/analysis/effect_count.json

支持格式

JSON

HTTP请求方式

GET

是否需要登录


关于登录授权,参见 如何登录授权

访问授权限制


请求所有商业接口:

    • 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."
}

关于错误返回值与错误代码,参见 错误代码说明

字段说明

其他

  • 互动数的统计包括转发、赞、短链点击、收藏、关注的数据,不包括评论;
  • 互动数、曝光数统计的是当前推广微博本身一层上的转发、赞、短链点击、收藏、关注、曝光等数据,转发微博上的相关数据不在统计内;



Language: [[{{{2/uri}}}|中文]]


文档更新时间: 2015-07-09
api评价