人群包接口
所有文档

          百度信息流推广API

          人群包接口

          新增人群包

          接口描述

          通过上传人群设备号文件新建人群包,文件中必须包含5000条与类型匹配的条目。账户下自定义人群包上限50。

          接口URL

          http://sem.baidubce.com/v1/feed/cloud/CrowdFeedService/addCrowdFeed

          请求参数说明

          字段名称 类型 描述
          crowdType number 人群类型:1.IDFA 2.IMEI 4.手机号md5 5.IDFA_MD5 6.IMEI_MD5
          crowdName string 自定义人群名
          content string 人群文件,Base64编码后上传设备id的内容(目前最大支持10M)

          响应参数说明

          字段名称 类型 描述
          crowdId number 人群包ID
          crowdName string 人群名

          请求示例

          POST /v1/feed/cloud/CrowdFeedService/addCrowdFeed HTTP/1.1
          Accept-encoding: 'gzip, deflate'
          Host: sem.baidubce.com
          ContentType: application/json
          Authorization: bce-auth-v1/b406c344bb764e00aff7d3b80d9bd87a/2019-06-05T07:34:31Z/1800/host/bb0f820e4499b8b44548388b37a7afed970e965a7a59f79ebac47a99c315a97b(签名有效时间为30分钟,需要替换成自己生成的签名)
          Accept: '*/*'
          {
              "header": {
                  "opUsername": "example",
                  "tgUsername": "example",
                  "bceUser": "example",
                  "opPassword": "example",
                  "tgPassword": "example"
              },
              "body": {
              	"crowdFeedType": {
                      "crowdName": "人群1",
                      "crowdType": 1,
                      "content": "JCODMwNDMKNjk2RjQ1OTEtMkYwNi00OEQxLTlDOUUtRUU3QzkjNENQ=="
                 }
          	}
          }

          响应示例

          {
              "body": {
                  "data": [
                      {
                          "crowdId": 123456,
                          "crowdName": "人群1"
                      }
                  ]
              },
              "header": {
                  "oprs": 1,
                  "failures": [],
                  "succ": 1,
                  "oprtime": 0,
                  "desc": "success",
                  "status": 0
              }
          }

          人群包文件分片上传

          接口描述

          分片上传人群文件,必须按照顺序上传分片,每个分片不大于10M,每个分片大小不一定相同,除了最后一个分片,每个分片至少包含5000行数据。

          请求URL

          http://sem.baidubce.com/v1/feed/cloud/CrowdFeedService/uploadCrowdFileBySlice

          请求参数说明

          字段名称 类型 描述
          fileName string 上传的文件名
          chunks number 分片总数量
          chunk number 分片编号,从0开始
          crowdType number 人群包类型:1.IDFA 2.IMEI 4.手机号md5 5.IDFA_MD5 6.IMEI_MD5
          md5 string 文件的md5,多个分片以md5为标识
          base64Content string 分片的base64字符串

          响应参数说明

          字段名称 类型 描述
          fileId number 文件id,只在最后一个分片返回fileId

          请求示例

          POST /v1/feed/cloud/CrowdFeedService/uploadCrowdFileBySlice HTTP/1.1
          Accept-encoding: 'gzip, deflate'
          Host: sem.baidubce.com
          ContentType: application/json
          Authorization: bce-auth-v1/b406c344bb764e00aff7d3b80d9bd87a/2019-06-05T07:34:31Z/1800/host/bb0f820e4499b8b44548388b37a7afed970e965a7a59f79ebac47a99c315a97b(签名有效时间为30分钟,需要替换成自己生成的签名)
          {
              "header": {
                  "opUsername": "example",
                  "tgUsername": "example",
                  "bceUser": "example",
                  "opPassword": "example",
                  "tgPassword": "example"
              },
              "body": {
          	    "fileName": "demo.txt",
          	    "chunks": 2,
          	    "chunk": 1,
          	    "crowdType": 1,
          	    "md5": "a98dksj20be28865cb8asdfsdf20a2c",
          	    "base64Content": "TNFMDEyQ0UxOEM1CjNEMzJGMkFELUU0NDYtNERGRC1C..."
          	}
          }

          响应示例

          {
              "body": {
                  "data": [
                      {
                          "fileId": 3412632
                      }
                  ]
              },
              "header": {
                  "oprs": 1,
                  "failures": [],
                  "succ": 1,
                  "oprtime": 0,
                  "desc": "success",
                  "status": 0
              }
          }

          通过人群包文件id添加人群包

          接口描述

          通过人群包文件id添加人群包,人群包文件id是由人群包文件分片上传接口返回的

          请求URL

          http://sem.baidubce.com/v1/feed/cloud/CrowdFeedService/addCrowdFeedWithFileId

          请求参数说明

          字段名称 类型 描述
          fileId number 分片上传人群包文件返回的fileId
          crowdType number 人群包类型:1.IDFA 2.IMEI 4.手机号md5 5.IDFA_MD5 6.IMEI_MD5
          crowdName string 人群包名称

          响应参数说明

          字段名称 类型 描述
          crowdId number 人群id
          crowdName string 人群名称

          请求示例

          POST /v1/feed/cloud/CrowdFeedService/addCrowdFeedWithFileId HTTP/1.1
          Accept-encoding: 'gzip, deflate'
          Host: sem.baidubce.com
          ContentType: application/json
          Authorization: bce-auth-v1/b406c344bb764e00aff7d3b80d9bd87a/2019-06-05T07:34:31Z/1800/host/bb0f820e4499b8b44548388b37a7afed970e965a7a59f79ebac47a99c315a97b(签名有效时间为30分钟,需要替换成自己生成的签名)
          {
              "header": {
                  "opUsername": "example",
                  "tgUsername": "example",
                  "bceUser": "example",
                  "opPassword": "example",
                  "tgPassword": "example"
              },
              "body": {
          	    "fileId": 3412632,
          	    "crowdType": 1,
                  "crowdName": "租房人群包"
          	}
          }

          响应示例

          {
              "body": {
                  "data": [
                      {
                          "crowdId": 120102401,
                          "crowdName": "租房人群包"
                      }
                  ]
              },
              "header": {
                  "oprs": 1,
                  "failures": [],
                  "succ": 1,
                  "oprtime": 0,
                  "desc": "success",
                  "status": 0
              }
          }

          查询人群包

          接口描述

          通过人群包id或人群名称查询人群包信息,如果请求参数人群包id集合和人群包名称集合都不传,则查询全部数据。

          接口URL

          http://sem.baidubce.com/v1/feed/cloud/CrowdFeedService/getCrowdFeed

          请求参数说明

          字段名称 类型 描述
          crowdIdList array(number) 人群包id集合,可为空
          crowdNameList array(string) 人群包名称集合,可为空,如果人群包id集合不为空,则忽略该条件

          说明:当前接口兼容旧的请求参数(crowdId、crowdName),后续如果下线会提前通知。

          响应参数说明

          字段名称 类型 描述
          crowdId number 人群id
          crowdName string 人群名称
          crowdTypeDesc string 人群类型描述
          status number 人群状态,1:计算中,2:生效,3:失效
          crowdCount number 预估覆盖人数
          createTime number 创建时间,unix时间戳,单位毫秒
          expireTime number 过期时间,unix时间戳,单位毫秒
          fromUserId number 由谁分享,非分享的人群包不返回此字段
          toUserIds array(number) 已分享给谁

          请求示例

          POST /v1/feed/cloud/CrowdFeedService/getCrowdFeed HTTP/1.1
          Accept-encoding: 'gzip, deflate'
          Host: sem.baidubce.com
          ContentType: application/json
          Authorization: bce-auth-v1/b406c344bb764e00aff7d3b80d9bd87a/2019-06-05T07:34:31Z/1800/host/bb0f820e4499b8b44548388b37a7afed970e965a7a59f79ebac47a99c315a97b(签名有效时间为30分钟,需要替换成自己生成的签名)
          Accept: '*/*'
          {
              "header": {
                  "opUsername": "example",
                  "tgUsername": "example",
                  "bceUser": "example",
                  "opPassword": "example",
                  "tgPassword": "example"
              },
              "body": {
              	"crowdIdList":[1231211], 
              }
          }

          响应示例

          {
              "body": {
                  "data": [
                      {
                          "expireTime": 33070937979000,
                          "createTime": 1535705647000,
                          "status": 2,
                          "crowdTypeDesc": "主题人群包",
                          "crowdId": 1231211,
                          "crowdCount": 10552780,
                          "crowdName": "租房人群包"
                      }
                  ]
              },
              "header": {
                  "oprs": 1,
                  "failures": [],
                  "succ": 1,
                  "oprtime": 0,
                  "desc": "success",
                  "status": 0
              }
          }

          查询人群包关联的推广单元

          接口描述

          根据人群包id查询绑定该人群包的单元id。

          接口URL

          http://sem.baidubce.com/v1/feed/cloud/CrowdFeedService/getBindAdgroup

          请求参数说明

          字段名称 类型 描述
          crowdId number 人群包ID,必填
          crowdName string 人群名,选填

          响应参数说明

          字段名称 类型 描述
          -- Map Map的key为人群包的id,Map的value为关联此人群包的单元的id集合

          请求示例

          POST /v1/feed/cloud/CrowdFeedService/getBindAdgroup HTTP/1.1
          Accept-encoding: 'gzip, deflate'
          Host: sem.baidubce.com
          ContentType: application/json
          Authorization: bce-auth-v1/b406c344bb764e00aff7d3b80d9bd87a/2019-06-05T07:34:31Z/1800/host/bb0f820e4499b8b44548388b37a7afed970e965a7a59f79ebac47a99c315a97b(签名有效时间为30分钟,需要替换成自己生成的签名)
          Accept: '*/*'
          {
              "header": {
                  "opUsername": "example",
                  "tgUsername": "example",
                  "bceUser": "example",
                  "opPassword": "example",
                  "tgPassword": "example"
              },
              "body": {
              	"crowdFeedTypes": [
          			{
          				"crowdId": 123123
          			},
          			{
          			    "crowdId": 123456
          			}
              	]
          	}
          }

          响应示例

          {
              "body": {
                  "data": {
                      {
                          "123123": [11111, 22222]
                      },
          			{
                          "123456": [33333, 44444]
                      }
                  }
              },
              "header": {
                  "oprs": 1,
                  "failures": [],
                  "succ": 1,
                  "oprtime": 0,
                  "desc": "success",
                  "status": 0
              }
          }
          上一篇
          推广单元接口
          下一篇
          意图词包接口