闪投推广单元模块
更新时间:2020-08-18
闪投推广单元对象
闪投推广单元对象定义了闪投单元的所有属性,闪投推广单元的多个接口均引用了其定义,具体使用请参考各接口的使用说明。
字段名称 | 类型 | 描述 |
---|---|---|
adgroupFeedId | number | 推广单元ID,定义同原生。 |
campaignFeedId | number | 所属推广计划ID,定义同原生。 |
adgroupFeedName | string | 推广单元名称,定义同原生。 |
ftypes | array(number) | 投放流量,定义同原生。 |
producttypes | array(number) | 投放版位,定义同原生。 |
pause | boolean | 是否暂停推广,定义同原生。 |
status | number | 推广单元状态,定义同原生。 |
number | 闪投商品组ID,另见unitProducts的使用说明。 | |
unitProducts | object | 闪投单元商品圈选条件,请参考闪投单元商品圈选条件。与productSetId等效,且处理优先级大于productSetId。 无论更新还是新建单元时,unitProducts和productSetId必须设置其中一项,且两者同时设置时,仅unitProducts能够生效。 |
audience | object | 闪投单元定向设置。 此字段为对象类型,对象内每个字段表示一种定向设置,每个单元可以设置0至多个定向设置。全部定向字段列表和详细说明请参考闪投定向设置列表。 |
bidtype | number | 优化目标、付费模式。取值范围如下: 1:点击(CPC) 3:转化(oCPX) |
bid | number | 出价,单位为元,可精确到分。定义同原生。 |
ocpc | object | 闪投oCPC设置,定义同原生。 本字段只有当bidtype=3 有效。请参考oCPC设置对象。 注: 暂不支持新建oCPM闪投推广单元 |
闪投单元商品圈选条件
- 类似“商品组”的逻辑,选定“商品目录”和“筛选条件”,来给单元绑定一组商品
- API仅支持商品目录投放,对商品文件和知识库
- 新建单元时,
字段名称 | 类型 | 描述 |
---|---|---|
catalogId | number | 商品目录ID,必填。 |
ruleProducts | array(object) | 商品筛选规则列表,必填。请参考商品筛选规则。 圈选全部目录商品时,设置为[]即可。 |
示例:
{
"catalogId":10023,
"ruleProducts":[
{
"field":"category",
"operation":"EQUAL",
"value":"电脑"
},
{
"field":"brand",
"operation":"EQUAL",
"value":"惠普|联想" // 用'|'表示对多个筛选值进行共同筛选
},
...
]
}
商品筛选规则
字段名称 | 类型 | 描述 |
---|---|---|
field | string | 筛选字段,必填。 例:brand |
operation | string | 筛选关系,必填。请参考商品字段筛选关系。 例:EQUAL。 |
value | string | 筛选范围,必填。如果需要设置多个筛选值时,请用"|"进行分隔。 例:丰田 或 大众|奔驰 。 |
商品字段筛选关系
有效值 | 描述 |
---|---|
GREATER | 大于(>) |
LESS | 小于(<) |
GREATER_EQUAL | 大于等于(>=) |
LESS_EQUAL | 小于等于(<=) |
NOT_EQUAL | 不等于(!=) |
EQUAL | 等于(=) |
NOT_CONTAIN | 不包含(NOT LIKE) |
CONTAIN | 包含(LIKE) |
闪投定向设置列表
- 闪投单元定向设置列表定义了闪投API所支持的所有定向设置选项,用户推广单元对象的audience字段。列表中每一个字段代表一种定向设置条件,除闪投基础定向外其余定向字段均为可选设置。
- 闪投基础定向:包括闪投通投、闪投意图词定向及闪投长期兴趣定向等几个互斥定向设置。在新建单元时,为必填定向字段,多选一;在修改单元时,闪投基础定向传null表示不修改;传其他的闪投基础定向表示置空当前闪投基础定向,切换到目标闪投基础定向。
- 互斥定向设置:部分定向设置因与其他定向设置存在互斥关系,不能在同一个单元内同时使用。下表中每行的“互斥定向设置”中列出的定向设置与该定向设置为互斥关系。
- 关联定向设置:部分定向设置因与其他定向设置存在关联关系,在同一个单元内使用其中之一时则必须同时使用。下表中每行的“关联定向设置”中列出的定向设置与该定向设置为关联关系。
- 媒体定向说明:目前,闪投单元支持媒体ID的定向和屏蔽、媒体分类的定向和屏蔽、及媒体包的定向等三类媒体定向方式。并且,三类媒体定向之间仅支持单选,即一个单元每次只能设置其中一类媒体定向。在单元编辑时,如果需要修改媒体定向,请将“原媒体定向”设置为不限,再设置“新媒体定向”。若仅仅设置“新媒体定向”,而没主动将“原媒体定向”置为不限,api默认会将“原媒体定向”置为不限(不建议)。此外,待后续闪投媒体定向支持复选时,请注意API文档变更说明。
- 默认值说明: 新建单元时,请求参数重未传的定向设置字段视为”不使用该定向设置“,其对应的默认含义一般为”不限“或”全部“,其默认取值每个定向字段各有不同,请参考各定向设置描述中的说明。 修改单元时,请求参数中未传的定向设置字段视为不修改现有的取值(即:修改单元时,如需将某定向设置从使用改为不使用,请求参数中该字段应当传对应的默认值,而非不传该字段)。如果在新建/修改的请求参数中存在某字段,但取值为该定向的默认值时,则视同为不使用该定向设置。
字段名称 | 类型 | 描述 | 互斥定向设置 | 关联定向设置 |
---|---|---|---|---|
premium | string | 闪投通投定向设置,必填。 该字段值为string形式的json数组,元素字段参考闪投通投定向。 示例: "{"common":true}" |
paKeywords interests newInterests |
无 |
paKeywords | string | 闪投意图词定向设置,必填。 该字段值为string形式的json数组,元素字段参考闪投意图词定向。 示例: "{"showWords":[{"showword":"中国","type":1},{"showword":"${name}","type":2},{"showword":"装修","type":3},{"showword":"风景","type":4}],"keywordsExtend":"1","ktFilter":true,"autoMatch":true}" |
premium interests newInterests |
无 |
interests | string | 闪投长期兴趣定向设置,定义同原生,必填。 | premium paKeywords newInterests |
无 |
newInterests | string | 闪投新兴趣定向设置,定义同原生,名单内用户可用。 | preminu paKeywords interests |
无 |
paCrowd | string | 闪投人群定向设置。 该字段值为string形式的json数组,元素字段参考闪投人群定向。 示例: "{"basic":[121,11223],"common":[223,23],"exclude":[321,31223]}" |
无 | 无 |
age | string | 年龄。默认为全部,定义同原生。 | 无 | 无 |
sex | string | 性别。默认为全部,定义同原生。 | 无 | 无 |
education | string | 学历。默认为全部,定义同原生。 | 无 | 无 |
device | string | 平台。默认为全部,定义同原生。 | 无 | 无 |
net | string | 网络。默认为全部,定义同原生。 | 无 | 无 |
region | string | 地域(省市)。默认为不限,定义同原生。 当region为‘具体省市’时,autoRegion必须设置为关闭“智能地域”定向。 |
无 | autoRegion |
autoRegion | string | 智能地域。默认为关闭。 取值范围: "0":关闭; "1":推广省份(当商品组中商品的产品库字段包含attributes.targetProvince时,可用); "2":推广城市(当商品组中商品的产品库字段包含attributes.targetCity时,可用)。 只有region为"不限"时,autoRegion才能设置为开启“智能地域”定向。 |
无 | region |
mediaCategoriesBindType | string | 百青藤媒体分类定向方式,与mediaCategories字段配合使用。默认为不限,定义同原生。 | mediaidsBindType mediaids mediaPackage |
mediaCategories |
mediaCategories | string | 百青藤媒体分类。默认为不限,定义同原生。 | mediaids mediaidsBindType mediaPackage |
mediaCategoriesBindType |
mediaidsBindType | string | 百青藤媒体ID定向方式,与mediaids配合使用。 | mediaCategoriesBindType mediaCategories mediaPackage |
mediaids |
mediaids | string | 百青藤媒体ID。默认为不限,定义同原生。 | mediaCategoriesBindType mediaCategories mediaPackage |
mediaidsBindType |
mediaPackage | string | 百青藤媒体包。默认为不限,不限用“”表示。目前仅支持设置一个媒体包。 | mediaCategoriesBindType mediaCategories mediaidsBindType mediaids |
|
autoExpansion | string | 自动扩量,原isOpenOcpcLab字段,默认为0取值说明: 0 表示关闭自动扩量 1 表示开启自动扩量 |
无 | 无 |
customMediaPackage | string | 自定义媒体包,默认为不限,定义同原生。 | mediaids | mediaidsBindType |
deepLink | Boolean | 媒体包支持调起,仅流量类型为百青藤可用,默认false。 | 无 | 无 |
闪投人群定向
- 闪投人群定向: 闪投定向设置中的一种对象类型的高级定向方式,其中包括"基础人群"、"交集人群"、"排除人群"。
- 闪投商品重定向:目前暂时不支持通过API创建重定向单元,重定向单元编辑时,只要不改变闪投基础定向,则重定向设置依然生效。
- 字段约束: 基础人群、交集人群和排除人群,是设置"闪投自定义人群定向"时必须设置的字段,有效的取值范围为原生账户下人群包ID。最少0个,最多不超过10个。其中,交集人群表示与基础人群取交,因此,但凡设置交集人群,则基础人群必须有效。
- 取值说明:
新建单元时,闪投人群定向可以不设置,闪投人群定向可以与其闪投基础定向同时设置,也可以仅设置闪投人群定向。
修改单元时,传null表示不修改,置空时设置基础人群、交集人群和排除人群为
[]
。
字段名称 | 类型 | 描述 | 互斥定向设置 | 关联定向设置 |
---|---|---|---|---|
basic | array(number) | 基础人群,最多不超过10个。 取值示例:[]或[121, 123, 145, …] |
无 | 无 |
common | array(number) | 交集人群,最多不超过10个。 取值示例:[]或[121, 123, 145, …] |
无 | basic |
exclude | array(number) | 排除人群,最多不超过10个。 取值示例:[]或[121, 123, 145, …] |
无 | 无 |
示例:
{
"paCrowd":{
"basic":[1,2,3,...], // 必填字段,不能为null, 不设置值或清空时设为[].
"common":[1,2,3,...], // 必填字段,不能为null, 不设置值或清空时设为[].
"exclude":[1,2,3,...], // 必填字段,不能为null, 不设置值或清空时设为[].
}
}
闪投通投定向
- 闪投通投定向: 闪投定向设置中的一种对象类型的高级定向方式,新建单元时,其"互斥定向设置"不能同时设置。
- 字段约束: 通投开关,是设置"闪投通投定向"时必须设置的字段,有效的取值仅为"true"。
- 取值说明: 新建单元时,闪投通投定向可以作为唯一的闪投基础定向进行设置。 修改单元时,若需要修改闪投通投定向,直接设置其互斥定向设置的有效值即可表示取消通投而设置目标定向,否则传nll即可保持不变。
字段名称 | 类型 | 描述 | 互斥定向设置 | 关联定向设置 |
---|---|---|---|---|
common | boolean | 闪投通投定向开关,取值只为"True",选择"通投"时必填字段。 | 无 | 无 |
示例:
{
"premium": {
"common": True // 取值只为‘true’.
}
}
闪投意图词定向
- 闪投意图词定向: 闪投定向设置中的一种对象类型的高级定向方式,新建单元时,其"互斥定向设置"不能同时设置。
- 字段约束: 意图词数组,是设置"闪投意图词定向"时必须设置的字段,目前闪投支持4种类型的意图词,其中普通词最多不超过900个,模版词最多不超过50个,行业词包和自定义词包总计不超过50个(自定义词包最多不超过1个)。
- 取值说明: 新建单元时,可以作为唯一的闪投基础定向进行设置。 修改单元时,若需要修改闪投意图词定向,直接设置其互斥定向设置的有效值即可表示取消意图词而设置目标定向,否则传nll即可保持不变。
字段名称 | 类型 | 描述 | 互斥定向设置 | 关联定向设置 |
---|---|---|---|---|
showWords | array(object) | 意图词数组,最多不能超过1000个,选择"意图词定向"时必填字段。每个意图词均为Object类型,参考闪投意图词对象。 | 无 | 无 |
keywordsExtend | string | 用户行为,默认“1”。 取值范围: 1: 全网行为 2: 历史搜索 当意图词数组中,包含行业词包和自定义词包类型的意图词时,用户行为只能设置为“全网行为”。 |
无 | showWords |
ktFilter | boolean | 无效意图词过滤,默认“False”。 当意图词数组中,包含普通意图词时,过滤开关才生效。 |
无 | showWords |
autoMatch | boolean | 属否开启商品优选,默认“智能匹配”,其中“True”表示“智能匹配”。 当意图词数组中,包含行业词包和自定义词包类型的意图词时,用户行为必须开启“智能匹配”。 |
无 | showWords |
示例:
{
"paKeyWords":{
"showWords":[
{
"showword":"中国",
"type":1
},
{
"showword":"你的${name}", // 取值: 普通词前缀${xxx}普通词后缀
"type":2
},
{
"showword":"行业词包名称", // 参考“行业词包名称”
"type":3
},
{
"showword":"自定义词包名称", // 参考“用户在业务端上的自定义词包”
"type":4
}
],
"keywordsExtend": "1",
"ktFilter": False,
"autoMatch": True
}
}
闪投意图词对象
字段名称 | 类型 | 描述 |
---|---|---|
showword | string | 意图词 |
type | number | 意图词类型,默认"1"。 取值范围: 1:普通意图词,最多不能超过900个 2: 模版意图词,最多不能超过50个 3: 行业词包,最多不能超过50个 4: 自定义词包,最多不能超过1个 |