字段

類型

是否必填

說明

備注

advertiser_id

long

必填

快手廣告主ID

在獲取access_token的時候返回

unit_id

long

必填

快手信息流廣告組ID

creative_name

string

必填

創(chuàng)意名稱

長度為1-100字符，同一個快手短視頻廣告組下名稱不能重復(fù)

photo_id

string

可選

視頻ID

image_token

string

可選

封面圖片token

通過上傳圖片接口獲得，不傳值則直接使用視頻的首幀作為封面圖片，自定義封面的圖片寬高要與視頻寬高一致

creative_material_type

int

必填

素材類型

1：豎版視頻

2：橫版視頻

4：便利貼單圖圖片創(chuàng)意

5：豎版圖片

6：橫版圖片

image_tokens

string[]

便利貼單圖圖片創(chuàng)意token

便利貼創(chuàng)意和聯(lián)盟圖片創(chuàng)意必填，目前只支持一張圖片，詳細要求見附錄

action_bar_text

string

必填

行動號召按鈕文案

根據(jù)計劃類型進行設(shè)置，詳情見附錄

description

string

必填

快手信息流廣告語

長度為1-30字符，不支持換行。

如果要使用動態(tài)詞包，格式如"[地區(qū)]的[男性女性]都喜歡"，

聯(lián)盟廣告和程序化創(chuàng)意不支持動態(tài)詞包，

詞包名可以通過下方動態(tài)詞包接口獲取

short_slogan

string

快手便利貼創(chuàng)意短廣告語

長度為1-8字符，便利貼創(chuàng)意必填參數(shù)

sticker_title

string

封面廣告語標題

不超過14字符，

如果要使用動態(tài)詞包，格式如"[地區(qū)]的[男性女性]都喜歡"，

快手后貼片廣告不支持動態(tài)詞包，

詞包名可以通過下方動態(tài)詞包接口獲取，

sticker_title和overlay_type需同時為空值或同時非空

overlay_type

string

貼紙樣式類型

貼紙樣式可以通過查詢下方貼紙掩飾接口獲取，

sticker_title和overlay_type需同時為空值或同時非空

expose_tag

string

非必填

快手廣告標簽

從 /expose_tags/list 接口獲取，從下方9獲取

更新的時候如果要將快手廣告標簽設(shè)置為 「暫不選擇」，傳空字符串即可，只支持計劃類型為 2

new_expose_tag

string[]

非必填

快手廣告標簽2期

與老的expose_tag兼容, 逐漸將老的expose_tag替換掉。可以按照相關(guān)格式傳遞兩個推薦理由

舉例[{“text”:""},{"text":""}]

site_id

long

安卓下載中間頁ID

可從下方「獲取已發(fā)布的下載頁」接口獲取（老建站6.30下線）

或通過「rest/openapi/v2/lp/page/list」獲取新建站落地頁（魔力建站"view_comps":[7]）

1.僅支持下載類廣告

2.廣告組選擇的應(yīng)用類型要為安卓

3.下載頁對應(yīng)的app_id要與廣告組選擇的app_id一致

click_track_url

string

第三方點擊檢測鏈接

僅當廣告組scene_id為1、2、6、7時，可選填；

快手廣告組優(yōu)化目標為激活時，該字段必填（下載類快手廣告投放的應(yīng)用集成快手Android SDK時除外）

使用Marketing API創(chuàng)建時，監(jiān)測鏈接使用以該文檔為準

impression_url

string

第三方開始播放監(jiān)測鏈接

僅當廣告組scene_id為3時，可選填；

廣告組優(yōu)化目標為激活時，該字段必填（下載類快手廣告投放的應(yīng)用集成快手Android SDK時除外）

使用Marketing API創(chuàng)建時，監(jiān)測鏈接使用以該文檔為準

ad_photo_played_t3s_url

string

第三方有效播放監(jiān)測鏈接

僅歷史個別賬戶使用且當快手廣告組scene_id為3時可選，與impression_url不可同時使用

actionbar_click_url

string

可選

第三方點擊按鈕監(jiān)測鏈接

1.校驗click_url必填的快手廣告場景 優(yōu)選(1)/快手信息流廣告(2、7)/上下滑（6）

2.優(yōu)化目標為激活功能必填點擊監(jiān)測鏈接,但如果安卓應(yīng)用接入了快手監(jiān)測sdk就不需要填寫監(jiān)測鏈接了

3.聯(lián)盟場景檢查click_url不能為空

4.若廣告聯(lián)盟的轉(zhuǎn)化目標為激活，click_url、actionbar_click_url和監(jiān)測SDK至少三選一

creative_category

int

金融，教育，游戲，小說

如上行業(yè)必填

創(chuàng)意分類

由創(chuàng)意分類查詢接口

獲得；必須是葉子結(jié)點；與創(chuàng)意標簽同時傳或同時不傳

必填快手賬戶可通過接口3.17——接口獲取是否必填

creative_tag

List<String>

選創(chuàng)意分類 必填

創(chuàng)意標簽

與創(chuàng)意分類參數(shù)，要么都傳，要么都不傳；且單個創(chuàng)意的創(chuàng)意標簽最多10個；單個創(chuàng)意標簽不能為空且不能超過10字符

live_creative_type

int

選填

快手直播類型（快手小店直播推廣類型，計劃type=14）

1 - 快手直投直播

2 - 快手視頻引流直播