抖音资讯

douyinzx

快手广告投放平台API对接:修改广告模块《NO.6》

iseeyu3年前 (2024-03-28)抖音资讯147

修改快手联盟定投广告组

【注】白名单快手账户支持定投联盟广告,修改广告组接口不变,有以下限制:

仅支持部分定向。

请求接口:https://ad.e.kuaishou.com/rest/openapi/v2/ad_unit/update

请求方式:POST

数据格式:JSON

 

请求参数




快手广告投放代理商

字段

类型

是否必填

说明

备注

advertiser_id

long

必填

快手广告主ID

在获取access_token的时候返回

unit_id

long

必填

快手广告组ID


unit_name

string

可选

快手广告组名称

不能修改为空,长度为1-100个字符,组名称不能重复

bid

long

可选

出价

bid_type为CPC/eCPC时该字段必填,单位:厘,不得低于0.2元,不得高于100元,不得高于组预算

cpa_bid

long

可选

出价

bid_type是OCPC时该字段必填,单位:厘,ocpx_action_type为2时,不得低于1元,不得高于3000元;

ocpx_action_type为180时,不得低于5元,不得高于3000元,部分白名单账户不得低于2元;

ocpx_action_type为53时,不得低于5元,不得高于3000元;

不得高于组预算

deep_conversion_bid

long

可选

深度转化目标出价

单位:厘,仅当deep_conversion_type可用且账户满足白名单时选填,出价需大于cpa_bid,小于min{组预算,3000元},不支持从0改为其他值,也不支持从其他值改为0

begin_time

string

可选

投放开始时间

格式为yyyy-MM-dd,需大于等于当前时间

end_time

string

可选

投放结束时间

格式为yyyy-MM-dd,传空字符串表示从今天开始长期投放,传值表示设置开始时间和结束时间,且投放结束时间需大于等于投放开始时间

schedule_time

string

可选

投放时间段

格式为24*7位字符串,且都为0和1,以一个小时为最小粒度,从周一零点开始至周日24点结束;0为不投放,1为投放,不传/全传1/全传0视为全时段投放快手广告!

day_budget

long

可选

单日预算金额

单位:厘,指定0表示预算不限,默认为0;

不小于100元,不超过100000000元,仅支持输入数字;

修改预算不得低于该快手广告组当日花费的120%,与day_budget_schedule不能同时传,不能低于广告组出价

day_budget_schedule

long[]

可选

分日预算

单位:厘,指定0表示预算不限,默认为0;

每天不小于100元,不超过100000000元,仅支持输入数字;

修改预算不得低于该快手信息流广告组当日花费的120%,与day_budget不能同时传,均不能低于该广告组出价

快手广告投放平台API对接:修改广告模块《NO.6》

url

string

可选

投放链接

当快手推广计划类型是5时必填;

长度不超过1000字符;

计划类型是5(收集销售线索):落地页URL

app_id

long

可选

应用ID

当计划类型为2时必填,可通过应用列表接口获取应用ID

show_mode

int

可选

创意展现方式

1 - 轮播

2 - 优选

speed

int

可选

投放方式

1 - 快速投放

2 - 平滑投放

target

struct

可选

定向数据

具体见下方表格


target




快手广告投放代理商

字段

类型

是否必填

说明

备注

region

long[]

可选

地域

传值为[]表示不限;传递上一级ID时,childrenID可以不传;不允许同时传parentID和childrenID;

地域信息可通过地域接口获取;

仅计划的campaign_type为5时,支持设置三级地域(例:山西-大同-左云,左云是三级地域)

age

struct

可选

自定义年龄段

不传值表示不限,传值具体见下方表格;

与ages_range不能同时传

ages_range

int[]

可选

固定年龄段

与age不能同时传;

【0:表示0-11岁】

【12:表示12-17岁】

【18:表示18-23岁】

【24:表示24-30岁】

【31:表示31-40岁】

【41:表示41-49岁】

【50:表示50-100岁】

gender

int

可选

性别

1:女性, 2:男性,0表示不限

platform_os

int

可选

操作系统

1:Android,2:iOS,0表示不限

当计划类型为2(提升应用安装)时该字段可忽略

android_osv

int

可选

Android版本

3:不限,4:4.x+,5:5.x+,6:6.x+,7:7.x+,8:8.x+,9:9.x+,10:10.x+;

当计划类型为2(提升应用安装)时,仅当app_id表示的是Android应用可使用此字段传递版本

ios_osv

int

可选

iOS版本

6:不限,7:7.x+,8:8.x+,9:9.x+,10:10.x+;

当计划类型为2(提升应用安装)时,仅当appId表示的是iOS应用可使用此字段传递版本

network

int

可选

网络环境

1:Wi-Fi,2:移动网络,0:表示不限

device_brand

int[]

可选

设备品牌

传值为[]表示不限;

当platform_os为2(iOS)时,没有设备品牌定向;

1:OPPO,2:VIVO,

3:华为,4:小米,

5:荣耀,6:三星,

7:金立,8:魅族,

9:乐视,10:其他,

11:苹果(只有 platform_os为不限时支持此选项)

device_price

int[]

可选

设备价格

传值为[]表示不限;

1:1500元以下,

2:1501~2000,

3:2001~2500,

4:2501~3000,

5:3001~3500,

6:3501~4000,

7:4001~4500,

8:4501~5000,

9: 5001~5500,

10:5500元以上

app_interest

long[]

可选

APP行为-按分类

id不能重复且必须准确,具体id可通过下方标签接口获取;

仅包含安卓数据,若操作系统定向IOS则无效;

不能同时选择app_ids

app_ids

long[]

可选

APP行为-按APP名称

id不能重复且必须准确,具体id可通过下方应用接口获取,建议不超过10个,否则可能出现报错;

仅包含安卓数据,若操作系统定向IOS则无效;

不能同时选择app_interest

population

long[]

可选

人群包定向

人群包id不能重复且必须准确,具体id可通过人群管理模块的接口获取;

人群包状态必须是已推送状态;

不能和exclude_population的id有交集

exclude_population

long[]

可选

人群包排除

人群包id不能重复且必须准确,具体id可通过人群管理模块的接口获取;

人群包状态必须是已推送状态;

不能和population的id有交集




扫描二维码推送至手机访问。

版权声明:本文由西安泽虎代运营发布,如需转载请注明出处。

转载请注明出处https://0291.com.cn/post/66667.html

相关文章

直播代运营合同避坑:报价、KPI、违约金一次说清

直播代运营合同避坑:报价、KPI、违约金一次说清

去年西安一家女装店老板拿着合同来找我看,就一页纸,上面写着“保证月销30万”。签的时候高高兴兴,三个月后只卖了8万,代运营公司一句“市场环境不好”就撒手不管了。老板想退钱,翻出合同才发现,什么叫销售额、含不含退款、考核多久、数据以谁为准,一个字都没写。这种坑我这两年见了不止十回。 直播代运营合同看...

抖音千川投放怎么投?2026新手起量避坑指南

抖音千川投放怎么投?2026新手起量避坑指南

西安一家做本地餐饮的老张,去年底听人说抖音能拉客,先充了3000块投DOU+。一个月下来,视频播放量是上去了,团购券没卖出几张。后来他才搞清楚,DOU+是给内容加热用的,真正能把团购券卖出去的工具叫巨量千川。2026年,在抖音上做生意的商家基本绕不开这两个东西:DOU+管内容热度,千川管成交转化。...

抖音短视频带货怎么做?2026年挂车出单实操指南

抖音短视频带货怎么做?2026年挂车出单实操指南

直播带货要开播、要人设、要话术,很多西安商家试了两次就放弃了。其实还有一条更轻的路:短视频带货。拍一条视频挂上商品链接,用户刷到直接下单,不用开播,不用连麦,一个人一部手机就能跑。我见过高新一家卖手工辣条的档口,老板就拍后厨炒料,一条视频爆了,挂车链接三天卖了四千多单。我自己也帮几个西安客户跑过这...

抖音矩阵号怎么做?2026年企业多账号布局实操

抖音矩阵号怎么做?2026年企业多账号布局实操

有个西安做门窗的老板跟我抱怨,说一个号发了大半年,播放量卡在一两千上不去,问我是不是号被限流了。我让他去搜搜本地同行,人家三个号轮着发,客户搜「西安封阳台」,翻两屏全是那一家。这不是玄学,就是矩阵。说白了,矩阵不是一个号发十遍,也不是开十个号复制粘贴,而是按客户会搜什么、信什么,把账号分工排好。尤...

抖音蹭热点总翻车?2026年商家追热点的正确姿势

抖音蹭热点总翻车?2026年商家追热点的正确姿势

上周有个做建材的老板问我:热搜上那个话题全网都在拍,我是不是也该跟一条?我反问他,拍完这条视频,客户凭什么找你买瓷砖?他愣了半天没答上来。这就是大多数商家蹭热点的真实状态——看见热点就冲,拍完发现除了播放量,什么都没留下。热点不是不能蹭,是大多数人都蹭错了。我盘过自己服务的客户数据:蹭热点视频的平...

企业抖音蓝V认证2026流程:材料准备与审核避坑

企业抖音蓝V认证2026流程:材料准备与审核避坑

企业号蓝V认证,现在几乎成了西安本地商家做抖音的起手式。不管是餐饮、装修、教育还是批发档口,想挂电话、想开团购、想投DOU+,基本都绕不开这一步。这篇文章把2026年最新的蓝V认证流程、要准备的材料、审核容易挂的地方一次讲清楚。蓝V认证到底有什么用?值不值600块蓝V说白了就是抖音给企业主体做的实...

现在,非常期待与您的又一次邂逅

我们努力让每一部企业宣传片和抖音短视频成为商业大片