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

获取微信广告关注信息
全部接口
V1.1
loading

所属权限 Ads Insight
请求地址 wechat_ad_followers/get
请求方法 get

全局参数

全局参数是指每一个接口都需要使用到的参数。详情参考,代码案例参考

参数名称 参数类型
access_token 授权令牌,完成 OAuth 2.0 授权后获得,参考授权认证章节
timestamp

当前的时间戳,单位为秒,允许客户端请求最大时间误差为 300 秒。

MarketingAPI 所使用的时间戳,若无特殊说明,均为秒级时间戳

MarketingAPI 所使用的时区为 GMT+8,例如当时间戳为 1494840119 时,表示 2017-05-15 17:21:59

nonce 随机字串标识,不超过 32 个字符,由调用方自行生成,需保证全局唯一性
fields get 接口增加 fields 字段,用于指定返回参数的字段列表,为选填字段。fields 取值范围为 get 接口返回的 list 中的字段。如不填写,则根据默认值进行返回

请求参数

参数仅适用于微信公众平台,暂不支持腾讯广告平台。
标有*的参数为必填项

名称 类型 描述
time_range*
struct 时间范围,
  • 最多支持查询最近 30 天产生的关注数据;
  • 单次查询的最长跨度为 30 天;
  • 该时间表示用户关注公众号的时间;
  • start_time*
    integer 开始时间戳,精确到秒,小于 end_time
    最小值 0,最大值 9999999999
    end_time*
    integer 结束时间戳,精确到秒,大于 start_time
    最小值 0,最大值 9999999999
    page
    integer 搜索页码,默认值:1
    最小值 1,最大值 99999
    page_size
    integer 一页显示的数据条数,默认值:10
    最小值 1,最大值 100

    使用说明

    1. 关注后取关的用户仍然可以查询到关注记录。
    2. 用户重复关注则会有多条关注记录。
    3. 仅支持微信直客身份调用,暂不支持代理商身份调用。

    请求示例

    
    curl -G 'https://api.e.qq.com/v1.1/wechat_ad_followers/get?access_token=<ACCESS_TOKEN>&timestamp=<TIMESTAMP>&nonce=<NONCE>' \
    -d 'time_range={"start_time":1558810018,"end_time":1558840608}' \
    -d 'page=1' \
    -d 'page_size=10' 
    					

    应答字段

    名称 类型 描述
    list
    struct[] 返回信息列表
    openid
    string 用户标识,对当前公众号唯一
    wechat_adgroup_id
    integer 产生该关注的微信广告组 id(待废弃,请使用 adgroup_id 字段)
    wechat_campaign_id
    integer 产生该关注的微信计划 id(待废弃,请使用 campiagn_id 字段)
    wechat_account_id
    string 微信账号 id,即产生该关注的广告的广告主 appid
    wechat_agency_id
    string 微信服务商 id
    campaign_id
    integer 产生该关注的微信计划 id
    adgroup_id
    integer 产生该关注的微信广告组 id
    subscribe_time
    integer 关注时间
    position_type
    enum 微信广告位信息,[枚举详情]
    page_info
    struct 分页配置信息
    page
    integer 搜索页码
    page_size
    integer 一页显示的数据条数
    total_number
    integer 总条数
    total_page
    integer 总页数

    应答示例

    {
        "code": 0,
        "message": "",
        "message_cn": "",
        "data": {
            "list": [
                {
                    "openid": "otFpruJ-XQ0ragpS086GzSGQFwrA",
                    "wechat_adgroup_id": 191578410,
                    "wechat_campaign_id": 0,
                    "wechat_account_id": "wx69618ae091cf",
                    "wechat_agency_id": "",
                    "campaign_id": "<CAMPAIGN_ID>",
                    "adgroup_id": "<ADGROUP_ID>",
                    "subscribe_time": 1573530739,
                    "position_type": "POSITION_TYPE_WECHAT_AD_BOX"
                }
            ],
            "page_info": {
                "page": 1,
                "page_size": 10,
                "total_number": 1,
                "total_page": 1
            }
        }
    }

    可视化调试工具