百度信息流推广API

    定向设置列表

    定向设置列表定义了所有可选的定向设置,用于推广单元对象的audience字段。所有字段的值均为string类型。

    互斥定向设置:部分定向设置因与其他某些定向设置存在互斥关系,不能在同一个单元内同时使用。下表中每行的“互斥定向设置”中列出的定向设置与该定向设置为互斥关系。

    关联定向设置:部分定向设置因与其他某些定向设置存在关联关系,在同一个单元内若使用其中之一则必须同时使用。下表中每行的“关联定向设置”中列出的定向设置与该定向设置为关联关系。

    关于默认值的说明:新建单元时,请求参数中未传的定向设置字段视为*不使用该定向设置(,其对应的默认含义一般为“不限”或“全部”,其默认取值每个定向字段各有不同,请参考各定向设置描述中的说明。修改单元时,请求参数中未传的定向设置字段视为(不修改现有的取值((即:修改单元时如需将某定向设置从使用改为不使用,请求参数中该字段应当传对应的默认值,而非不传该字段)。如果在新建/修改单元的请求参数中存在某定向字段,但其取值为默认值时,视同不使用该定向设置。

    字段名称 描述 互斥定向设置 关联定向设置
    age 年龄。默认为全部。
    取值范围:
    原生:
    0:全部
    1:<18
    2:18-24
    3:25-34
    4:35-44
    5:45-54
    6:>54

    闪投:
    0:全部
    1:<18
    2:18-24
    3:25-34
    4:35-44
    5:>44
    如果选择多个年龄段,使用英文逗号分隔。
    sex 性别。默认为全部。
    取值范围:
    0:全部
    1:女
    2:男
    education 学历。默认为全部。
    取值范围:
    0:全部
    1:大学及以上
    2:高中及以下
    3:大专
    如果选择多个年龄段,使用英文逗号分隔。
    region 地域(省市)。默认为不限。
    不限省市用"9999999"表示。如果选择多个省市,使用英文逗号分隔省市ID。
    使用省级ID表示选用该省级行政区下的所有市级行政区。
    请参考地域(省市)列表
    bizArea
    customArea
    interests 2020年8月14日全量下线,请使用newInterests(兴趣2.0)投放
    长期兴趣。默认为不限。
    不限长期兴趣用"0"表示。如果选择多个长期兴趣,使用英文逗号分隔长期兴趣ID。
    长期兴趣分为一级、二级,使用一级长期兴趣ID表示选用该一级长期兴趣下的所有二级长期兴趣。
    请参考长期兴趣列表
    crowd
    excludeCrowd
    newInterests
    intentTag 意图标签。默认为不限。
    该字段值为string形式的json数组,元素字段为:
    "name":意图标签名称
    "industry":意图标签行业
    示例:"[{\"name\":\"名称\",\"industry\":\"行业\"}]"
    使用查询意图标签过滤条件查询意图标签接口可以查询可用的意图标签名称及其行业。
    keywords
    crowd
    excludeCrowd
    intentIntension
    intentIntension 意图标签的意图强弱控制。
    取值范围:
    30:较强
    20:中等
    10:较弱
    intentTag
    keywords 意图词。默认为不限。
    不限意图词用空字符串("")表示。每个意图词不得超过40字节(每个汉字占2个字节),如果使用多个意图词,使用英文逗号分隔。最多不超过2000个。
    intentTag
    crowd
    excludeCrowd
    keywordsExtend
    keywordsExtend 意图词用户行为。
    取值范围:
    1:全网行为
    2:历史搜索
    keywords
    directories 贴吧信息流吧主题。仅当投放流量选择自定义流量且单选贴吧信息流时可用。默认为不限。
    不限吧主题用"0"表示。如果选择多个吧主题,使用英文逗号分隔吧主题ID。
    吧主题分为一级、二级,使用一级吧主题ID表示选用该一级吧主题下的所有二级吧主题。
    请参考贴吧主题列表

    已下线,不影响存量物料投放
    crowd
    excludeCrowd
    articleType 百度信息流文章分类。文章分类仅适用于百度信息流详情页。仅当投放流量选择自定义流量且单选百度信息流,并且投放版位选择不限版位或者选择自定义版位且包含详情页时可用。默认为不限。
    不限文章分类用"0"表示。如果选择多个文章分类,使用英文逗号分隔文章分类ID。
    请参考文章分类列表
    place 场所。默认为不限。
    不限场所用"0"表示。如果选择多个场所,使用英文逗号分隔场所ID。
    场所分为一级、二级,使用一级场所ID表示选用该一级场所下的所有二级场所。
    请参考场所列表
    bizArea
    customArea
    crowd
    excludeCrowd
    bizArea 商圈(选择)。默认为不限。
    不限商圈(选择)用"0"表示。如果选择多个商圈(选择),使用英文逗号分隔商圈或区县ID。
    使用区县级ID表示选用该区县级行政区下的所有商圈。
    商圈和区县ID可用查询商圈、区县接口查询。
    region
    place
    crowd
    excludeCrowd
    customArea 商圈(自定义)。默认为不限。
    该字段值为string形式的json数组,元素字段为:
    "x":坐标经度
    "y":坐标纬度
    "r":半径(单位为公里,取值范围为整数[1,30])
    "locationname":地点名称
    示例:"[{\"x\":116.279853,\"y\":40.049879,\"r\":3,\"locationname\":\"百度科技园\"}]"
    经纬度坐标使用百度经纬度坐标(bd09ll)标准。根据地址查询坐标可使用查询百度经纬度坐标接口。
    region
    place
    crowd
    excludeCrowd
    useractiontype LBS类型。
    取值只能是1和(或)4,用字符串表示,英文逗号分割。
    1:实时地址
    4:历史到访
    place
    customPlace
    bizArea
    customArea
    device 平台。默认为全部。
    取值范围:
    0:全部
    1:iOS
    2:Android
    4:计算机
    3:其他(不影响存量物料投放)
    如果选择多个平台,使用英文逗号分隔。
    当所属计划的推广对象为应用下载(iOS)或应用下载(Android)时,平台定向只能设置为对应的平台。
    net 网络。默认为全部。
    取值范围:
    0:全部
    1:wifi
    2:移动网络
    app APP偏好。默认为不限。
    该字段值为string形式的json数组,元素字段为:
    typeAPP偏好类型,"all"表示不限(此为该字段默认值),"category"表示APP分类,"custom"表示自定义APP。
    list选择的APP分类或自定义APP列表,列表元素为对象,对象有以下属性:
    • "id": APP分类ID或自定义APPID
    • "name": 查询单元时,若APP偏好类型为自定义APP,此字段将返回选择自定义APP名称,新增/修改单元时请求参数无需传此字段。APP偏好类型为APP分类时此字段不用。
    behavior用户行为,需选择1至多种。取值范围:
    • 2:安装
    • 4:排除安装
    其中安装与排除安装不能同时选择。
    示例:"{\"type\":\"category\",\"list\":[{\"id\":12345}],\"behavior\":[2]}"
    APP分类分为一级、二级、三级,使用一级分类ID表示选用该一级分类下的所有二级、三级分类,使用二级分类ID表示选用该二级分类下的所有三级分类。
    APP分类列表请参考APP分类列表
    APPID可用查询APP偏好定向所需的APPID查询。
    crowd 自定义人群(定向人群包)。默认为不限。
    不限自定义人群(包含人群)用""表示。如果选择多个自定义人群(包含人群),使用英文逗号分自定义人群ID。
    使用CrowdFeedService的接口可以创建或查询自定义人群。
    interests
    intentTag
    keywords
    directories
    place
    bizArea
    customArea
    mediaBindType
    excludeCrowd 自定义人群(排除人群包)。上限250个。
    不限自定义人群(排除人群)用""表示。如果选择多个自定义人群(排除人群),使用英文逗号分自定义人群ID。
    使用CrowdFeedService的接口可以创建或查询自定义人群。
    interests
    intentTag
    keywords
    directories
    place
    bizArea
    customArea
    mediaBindType
    mediaBindType 百青藤媒体分类/媒体ID定向方式。百青藤媒体定向仅适用于百青藤媒体。仅当投放流量选择自定义流量且单选百青藤媒体时可用。默认为不限。
    取值范围:
    0:不限
    1:定向媒体分类/ID
    2:屏蔽媒体分类/ID
    选择定向媒体或屏蔽媒体时,需要使用mediaCategories或mediaids指定媒体分类或ID。
    注意:该字段为遗留字段,后续可能会不再支持,请优先使用mediaCategoriesBindType和mediaidsBindType字段。新增或修改单元时如果使用此字段,相当于同时设置后两者的值,并且不允许和后两者在同一请求中同时作为参数。查询单元时可以查询三者中任意字段的值,但如果mediaCategoriesBindType和mediaidsBindType的值不同,则mediaBindType没有意义,将返回任意值,请特别留意。
    crowd
    excludeCrowd
    mediaCategories
    或mediaids
    mediaCategoriesBindType 白名单内支持
    百青藤媒体分类定向方式,与mediaCategories字段配合使用。百青藤媒体定向仅适用于百青藤媒体。仅当投放流量选择自定义流量且单选百青藤时可用。默认为不限。
    取值范围:
    0:不限
    1:定向媒体分类
    2:屏蔽媒体分类
    选择定向媒体分类或屏蔽媒体分类时,需要使用mediaCategories指定媒体分类。
    当选择定向媒体分类时,允许在同一单元中使用屏蔽媒体ID功能(mediaidsBindType=2);其他情况下不允许媒体分类和媒体ID同时使用。
    crowd
    excludeCrowd
    mediaCategories
    mediaCategories 白名单内支持
    百青藤媒体分类。百青藤定向仅适用于百青藤媒体。仅当投放流量选择自定义流量且单选百青藤媒体时可用。默认为不限。
    不限分类用""表示。如果选择多个媒体分类,使用英文逗号分隔媒体分类ID。
    百青藤媒体分类分为一级、二级,使用一级分类ID表示选用该一级分类下的所有二级分类。
    请参考百青藤媒体分类列表
    mediaCategoriesBindType
    mediaidsBindType 百青藤媒体ID定向方式,与mediaids或customMediaPackage字段配合使用。百青藤媒体定向仅适用于百青藤媒体。仅当投放流量选择自定义流量且单选百青藤媒体时可用。默认为不限。
    取值范围:
    0:不限
    1:定向媒体ID
    2:屏蔽媒体ID
    选择定向媒体ID或屏蔽媒体ID时,需要使用mediaids或customMediaPackage指定媒体分类。
    crowd
    excludeCrowd
    mediaids
    customMediaPackage
    mediaPackage 百青藤媒体包。默认为不限。
    不限百青藤媒体媒体包用""表示。如果选择多个百青藤媒体包,使用英文逗号分隔百青藤媒体包ID。最多允许使用10个媒体包ID。
    使用查询百青藤媒体中的媒体包查询接口可以查询可用的媒体包ID。
    crowd
    excludeCrowd
    mediaidsBindType
    mediaCategoriesBindType
    mediaids 百青藤媒体ID。默认为不限。
    不限百青藤媒体ID用""表示。如果选择多个百青藤媒体,使用英文逗号分隔百青藤媒体ID。最多允许使用1000个媒体ID。
    使用查询百青藤媒体接口可以查询可用的媒体ID。
    customMediaPackage mediaidsBindType
    newInterests 新兴趣(兴趣2.0)。默认为不限。
    不限新兴趣用"0"表示。如果选择多个新兴趣,使用英文逗号分隔兴趣ID。
    新兴趣分为一级、二级、三级,使用一级新兴趣ID表示选用该一级新兴趣下的所有二级新兴趣。
    请参考新兴趣列表
    crowd
    excludeCrowd
    interests
    androidVersion Android系统版本定向,默认为不限。
    "0":表示不限Android系统版本 。
    "4": Android系统版本4.x
    "5": Android系统版本5.x
    "6": Android系统版本6.x
    "7": Android系统版本7.x
    "8": Android系统版本8.x
    "9": Android系统版本9.x
    device定向必须为不限或包含Android
    iosVersion iOS系统版本定向,默认为不限。
    "0":表示不限iOS系统版本 。
    "8": iOS系统版本8.x
    "9": iOS系统版本9.x
    "10": iOS系统版本10.x
    "11": iOS系统版本11.x
    "12": iOS系统版本12.x
    "13": iOS系统版本13.x
    device定向必须为不限或包含iOS
    lifeStage 人生阶段,默认为不限。
    "0":不限。
    "1":未婚
    "2":已婚
    "3":孕期
    "4":家有儿女(全部)
    "401":家有儿女(0-3岁)
    "402":家有儿女(3-6岁)
    "403":家有儿女(小学)
    "404":家有儿女(中学)
    使用4相当于同时使用401、402、403、404。
    customMediaPackage 百青藤自定义媒体包。默认为不限。
    不限百青藤自定义媒体包用""表示。如果选择多个百青藤自定义媒体包,使用英文逗号分隔百青藤自定义媒体包ID,并且这些媒体包的类型必须一致。最多允许使用20个百青藤自定义媒体包。
    百青藤自定义媒体包需要与mediaidsBindType配合使用,百青藤自定义媒体包类型为定向时,mediaidsBindType的值必须为1,即选择定向媒体ID,;自定义百青藤媒体包类型为屏蔽时,mediaidsBindType的值必须为2,即选择屏蔽媒体ID
    使用百青藤自定义媒体包接口可以查询可用的百青藤自定义媒体包。
    mediaids mediaidsBindType
    customAge 自定义年龄,默认为不限。
    取值说明:
    用由英文逗号分割的4位数字的字符串表示。
    数字的前两位表示年龄范围的最小值。(最小值必须大于17)
    数字的后两位表示年龄范围的最大值。(最大值大于26小于55,用99表示最大值为56岁及以上)
    中间用英文逗号分割
    为了覆盖更多的受众,仅提供≥10岁间隔自定义年龄范围能力。(最小年龄差>=9)
    不限用"0"表示。
    举例:
    "18,27",表示18到27岁
    "18,55",表示18岁到55岁
    "18,99",表示18岁到56岁及以上
    "0",表示不限
    仅支持网站链接和小程序
    目前为小流量阶段
    age
    autoExpansion 自动扩量,原isOpenOcpcLab字段,默认为0
    取值说明:
    0表示关闭自动扩量。
    1表示开启自动扩量。
    上一篇
    oCPC设置对象
    下一篇
    推广单元接口