闪投推广单元模块

闪投推广单元对象

闪投推广单元对象定义了闪投单元的所有属性，闪投推广单元的多个接口均引用了其定义，具体使用请参考各接口的使用说明。

闪投单元商品圈选条件

• 类似“商品组”的逻辑，选定“商品目录”和“筛选条件”，来给单元绑定一组商品
• API仅支持商品目录投放，对商品文件和知识库
• 新建单元时，

示例：

{
    "catalogId":10023,
    "ruleProducts":[
        {
            "field":"category",
            "operation":"EQUAL",
            "value":"电脑"
        },
        {
            "field":"brand",
            "operation":"EQUAL",
            "value":"惠普|联想" // 用'|'表示对多个筛选值进行共同筛选
        },
        ...
    ]
    }

商品筛选规则

商品字段筛选关系

闪投定向设置列表

• 闪投单元定向设置列表定义了闪投API所支持的所有定向设置选项，用户推广单元对象的audience字段。列表中每一个字段代表一种定向设置条件，除闪投基础定向外其余定向字段均为可选设置。
• 闪投基础定向：包括闪投通投、闪投意图词定向及闪投长期兴趣定向等几个互斥定向设置。在新建单元时，为必填定向字段，多选一；在修改单元时，闪投基础定向传null表示不修改；传其他的闪投基础定向表示置空当前闪投基础定向，切换到目标闪投基础定向。
• 互斥定向设置：部分定向设置因与其他定向设置存在互斥关系，不能在同一个单元内同时使用。下表中每行的“互斥定向设置”中列出的定向设置与该定向设置为互斥关系。
• 关联定向设置：部分定向设置因与其他定向设置存在关联关系，在同一个单元内使用其中之一时则必须同时使用。下表中每行的“关联定向设置”中列出的定向设置与该定向设置为关联关系。
• 媒体定向说明：目前，闪投单元支持媒体ID的定向和屏蔽、媒体分类的定向和屏蔽、及媒体包的定向等三类媒体定向方式。并且，三类媒体定向之间仅支持单选，即一个单元每次只能设置其中一类媒体定向。在单元编辑时，如果需要修改媒体定向，请将“原媒体定向”设置为不限，再设置“新媒体定向”。若仅仅设置“新媒体定向”，而没主动将“原媒体定向”置为不限，api默认会将“原媒体定向”置为不限（不建议）。此外，待后续闪投媒体定向支持复选时，请注意API文档变更说明。
• 默认值说明： 新建单元时，请求参数重未传的定向设置字段视为”不使用该定向设置“，其对应的默认含义一般为”不限“或”全部“，其默认取值每个定向字段各有不同，请参考各定向设置描述中的说明。 修改单元时，请求参数中未传的定向设置字段视为不修改现有的取值(即：修改单元时，如需将某定向设置从使用改为不使用，请求参数中该字段应当传对应的默认值，而非不传该字段)。如果在新建/修改的请求参数中存在某字段，但取值为该定向的默认值时，则视同为不使用该定向设置。

闪投人群定向

• 闪投人群定向： 闪投定向设置中的一种对象类型的高级定向方式，其中包括"基础人群"、"交集人群"、"排除人群"。
• 闪投商品重定向：目前暂时不支持通过API创建重定向单元，重定向单元编辑时，只要不改变闪投基础定向，则重定向设置依然生效。
• 字段约束： 基础人群、交集人群和排除人群，是设置"闪投自定义人群定向"时必须设置的字段，有效的取值范围为原生账户下人群包ID。最少0个，最多不超过10个。其中，交集人群表示与基础人群取交，因此，但凡设置交集人群，则基础人群必须有效。
• 取值说明： 新建单元时，闪投人群定向可以不设置，闪投人群定向可以与其闪投基础定向同时设置，也可以仅设置闪投人群定向。 修改单元时，传null表示不修改，置空时设置基础人群、交集人群和排除人群为[]。

示例：

{
    "paCrowd":{
        "basic":[1,2,3,...],   // 必填字段，不能为null, 不设置值或清空时设为[].
        "common":[1,2,3,...],  // 必填字段，不能为null, 不设置值或清空时设为[].
        "exclude":[1,2,3,...], // 必填字段，不能为null, 不设置值或清空时设为[].
		}
}

闪投通投定向

• 闪投通投定向： 闪投定向设置中的一种对象类型的高级定向方式，新建单元时，其"互斥定向设置"不能同时设置。
• 字段约束： 通投开关，是设置"闪投通投定向"时必须设置的字段，有效的取值仅为"true"。
• 取值说明： 新建单元时，闪投通投定向可以作为唯一的闪投基础定向进行设置。 修改单元时，若需要修改闪投通投定向，直接设置其互斥定向设置的有效值即可表示取消通投而设置目标定向，否则传nll即可保持不变。

示例:

{
    "premium": {
    	"common": True     // 取值只为‘true’.
  	}
}

闪投意图词定向

• 闪投意图词定向： 闪投定向设置中的一种对象类型的高级定向方式，新建单元时，其"互斥定向设置"不能同时设置。
• 字段约束： 意图词数组，是设置"闪投意图词定向"时必须设置的字段，目前闪投支持4种类型的意图词，其中普通词最多不超过900个，模版词最多不超过50个，行业词包和自定义词包总计不超过50个（自定义词包最多不超过1个）。
• 取值说明： 新建单元时，可以作为唯一的闪投基础定向进行设置。 修改单元时，若需要修改闪投意图词定向，直接设置其互斥定向设置的有效值即可表示取消意图词而设置目标定向，否则传nll即可保持不变。

示例:

{
        "paKeyWords":{
            "showWords":[
                {
                    "showword":"中国",
                    "type":1
                },
                {
                    "showword":"你的${name}",     // 取值: 普通词前缀${xxx}普通词后缀
                    "type":2
                },
                {
                    "showword":"行业词包名称",  // 参考“行业词包名称”
                    "type":3
                },
                {
                    "showword":"自定义词包名称", // 参考“用户在业务端上的自定义词包”
                    "type":4
                }
            ],
          "keywordsExtend": "1",
          "ktFilter": False,
          "autoMatch": True
        }
}

闪投意图词对象