字段

類型

是否必填

說明

備注

advertiser_id

long

必填

快手視頻廣告主ID

在獲取access_token的時候返回

campaign_id

long

必填

快手信息流廣告計劃ID

unit_name

string

必填

快手廣告組名稱

長度為1-100個字符，同一個計劃下的快手短視頻廣告組名稱不能重復

template_id

long

選填

定向模板id

bid_type

int

必填

優化目標出價類型

1: CPM

2: CPC

10:OCPM

4: CPA只有計劃類型為3，url_type=4才支持，而且ocpx_action_type只能為表單提交53)

use_app_market

int

優先從系統應用商店下載

下載模式

允許值：0，1；

1：優先從系統應用商店下載使用，默認0。

僅提升應用安裝計劃類型且選擇的app為安卓才支持。

app_store

string[]

應用商店列表

華為：huawei,

OPPO：oppo

VIVO：vivo

小米：xiaomi

魅族：meizu

錘子：smartisan

只支持計劃類型為 2 且應用是 Android 類型的快手推廣

bid

long

出價

bid_type為CPC/eCPC/CPM時該字段必填，單位：厘，不得低于0.2元，不得高于100元，不得高于組預算

cpa_bid

long

出價

bid_type是OCPM時該字段必填，單位：厘，ocpx_action_type為2時，不得低于1元，不得高于3000元；

ocpx_action_type為180時，不得低于1元，不得高于3000元，

ocpx_action_type為53時，不得低于5元，不得高于3000元；

不得高于組預算

smart_bid

int

優先低成本出價(設置條件)

當 speed 等于 3 時可用

0：手動出價，1：自動出價

1、當 smart_bid 為 1 時，cpa_bid 或 deep_conversion_bid 都不能設置值

2、快享和聯盟不支持優先低成本，直接報錯

3、優先低成本的 bid_type 只支持OCPM

4、優先低成本 必須設置統一預算或分日預算

ocpx_action_type

int

優化目標

bid_type是OCPM時該字段必填

2：行為數（actionBar點擊）

180：激活數

53：表單數

190: 付費

191：首日ROI

324：喚起應用（campaign_type=7+主站+加白）

348：有效線索

383: 授信

384: 完件

394：訂單提交

（計劃類型獲取電商下單，非金牛）

396：注冊（聯盟暫不支持）

634: 預約表單

635: 預約跳轉點擊

715：微信復制優化目標

（campaign_type=5&bid_type=10）

716：多轉化事件(campaign_type=5&bid_type=10&使用魔力建站&線索轉化類組件>=2種)

717：廣告觀看次數（(campaign_type=2&bid_type=10&appi與轉化追蹤工具聯調過或者該快手廣告主的在相應事件的回傳數）

731：廣告觀看5次

732：廣告觀看10次

733：廣告觀看20次

762：直播觀看數;（快手小店直播推廣&商品推廣支持，計劃type=14、13）

773：關鍵行為

774：7日ROI

192：直播推廣ROI；小店直播推廣&商品推廣支持，計劃type=14、13）

403：近似購買（小店直播推廣&商品推廣支持，計劃type=14、13）

72：小店通商品和主頁推廣，轉化目標“漲粉”

392：小店通商品推廣，優化目標“轉化數”，轉化目標“商品訪問”。

395：小店通商品和主頁推廣，轉化目標“訂單支付

需通過接口「rest/openapi/v1/ad_unit/ocpc/conversion_infos」獲取是否可以選擇「激活」、「表單轉化」、「付費」、「授信」、「完件」的優化目標;

deep_conversion_type

int

深度轉化目標

3:付費，7:次日留存，10:完件, 11:授信；13:添加購物車；14:提交訂單；15:購買；44：有效線索；92:深度付費roi（付費-付費roi雙，）

可通過下方深度轉化信息查詢接口獲取當前賬戶可選的深度轉化目標

roi_ratio

double

付費ROI系數

優化目標為「首日ROI」時必填：

ROI系數取值范圍 ( 0,100 ] 最多支持到三位小數（如：0.066）

deep_conversion_bid

long

深度轉化目標出價

單位：厘，僅當deep_conversion_type可用且賬戶滿足白名單時選填，出價需大于cpa_bid，小于min{組預算，3000元}，不得高于組預算，不支持從0改為其他值，也不支持從其他值改為0

scene_id

int[]

必填

資源位置

1：快手優選廣告位；

3：快手視頻播放頁廣告-便利貼廣告（不支持深度轉化目標的優化）；

5：快手聯盟廣告

6：快手上下滑大屏廣告；

7：快手信息流廣告；

3、6、7可多選

unit_type

int

必填

創意制作方式

4: 自定義；5：程序化創意 7：程序化創意2.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不能同時傳，均不能低于組出價

convert_id

int

可選

轉化目標ID

可通過下方【轉化目標查詢接口】獲得，不同計劃類型需要對應各自的轉化目標類型：

提升應用安裝(campaign_type=2) - 安卓：convert_type:3、7 / IOS：convert_type:7

推廣品牌活動(campaign_type=4) / 收集銷售線索(campaign_type=5)：convert_type:1、2

url_type

int

url類型

當計劃類型為3（獲取電商下單）時必填：

1 - 淘寶商品短鏈

2 - 淘寶商品itemID

4 - 金牛電商

web_uri_type

int

url類型

當計劃類型為5（收集銷售線索）&使用建站時必填：需使用魔力建站

不傳默認1，2：落地頁

url

string

投放鏈接

當計劃類型是3/4/5時必填；

長度不超過1000字符；

計劃類型是3（獲取電商下單）：金牛商品ID（必須為數字）

計劃類型是4（推廣品牌活動）：落地頁URL；

計劃類型是5（收集銷售線索）：落地頁URL；

計劃類型是5（收集銷售線索）：建站ID，通過/rest/openapi/v2/lp/page/list獲取

schema_uri

string

可選

調起鏈接

提升應用活躍營銷目標的調起鏈接

app_id

long

應用ID

當計劃類型為2時必填，可通過應用列表接口獲取應用ID

為計劃類型9時且detail_unit_type為0、2時必填

show_mode

int

必填

創意展現方式

1 - 輪播

2 - 優選

speed

int

必填

投放方式

1 - 加速投放

2 - 平滑投放

3-優先低成本（投放時間范圍只可為全天；預算不可為不限或空）

site_type

int

加白

預約快手廣告

1:IOS預約

缺省為不傳或傳0

gift_data

struct

加白

游戲禮包碼

"gift_data": {}，僅支持計劃類型為 2

video_landing_page

Boolean

是否使用落地頁前置功能

true: 使用 false：不使用，

不填使用系統默認值

（只支持雙feed流，推廣品牌活動-落地頁url填寫、獲取電商下單-淘客短鏈url填寫、獲取電商下單-金牛活動頁、獲取銷售線、獲取銷售線索）

auto_target

boolean

選填

智能定向

若開啟智能定向，定向部分僅保留地域+年齡+性別+排除人群+系統緯度的定向，其他定向緯度暫不支持（報錯處理）

true表示開啟，false表示未開啟

smart_cover

boolean

unit_type=7選填

程序化創意2.0智能抽幀

是否開啟智能抽幀

asset_mining

boolean

unit_type=7選填

程序化創意2.0素材挖掘

是否開啟歷史素材挖掘

fiction_id

long

選填

小說ID，僅支持“提升應用安裝”、“收集銷售線索”以及“提高應用活躍”三種計劃類型，且一旦綁定，不可修改

此參數僅是綁定小說，并非自動關聯小說生成的落地頁，如需推廣小說生成的落地頁，請使用小說ID獲取其生成的建站落地頁后將落地頁ID一并傳入即可（落地頁ID傳參與之前建站落地頁ID字段一致）

item_id

long

選填

電商關聯Id (小店通商品推廣，計劃type=13)

1. merchantItemType為0時填寫小店商品id

2. merchantItemType為2時不用填寫，系統補充

merchant_item_put_type

int

選填

快手電商廣告投放類型（小店商品推廣，計劃type=13）

0: 商品

2: 個人主頁

dpa_unit_param

struct

選填

dpa相關商品信息

當計劃類型為sdpa時必填

target

struct

必填

定向數據

具體見下方表格