广告创意修改

对广告创意关键字段值修改。

请求地址

https://openapi.aiclk.com/openapi/v1/creative/update

所属权限

ads_write

请求方式

POST

Header: Content-Type: application/json

请求参数

URL中携带参数：

字段名	类型	是否必须	描述
account_id	int	是	广告主ID(广告投放平台的userID)

Post body（json）

公共参数

字段名	类型	是否必须	描述
creative_id	int	是	创意ID
creative_name	string	否	创意名称
configure_status	string	否	状态，允许值：ENABLE, PAUSED, DELETED

第三方监测参数

字段名	类型	是否必须	描述	说明
click_feedback_url	string	否	点击监控链接	可填写自定义链接，转化追踪方式为API（APP内转化）时 也可通过API查询接口查询可用的API ID（APP内转化类型）对应的监控链接 多个监控链接之间用英文空格分隔，最多支持填写50个
api_id	int	否	api监控链接的ID	转化追踪方式需要选择API（APP内转化）或API（落地页转化）

应用推广

字段名	类型	是否必须	描述	备注
pkg_name	string	否	安装包名	推广分类选择ANDROID_APP时可传 安卓包名校验规则：必须是字母，字母规则（eg：com.duowan.mobile）
conversion_type	string	否	追踪转化方式	枚举值 默认值：无 允许值：无，API（APP内转化） 应用商城样式须开通白名单才可选
download_url	string	否	APP下载链接	可填写自定义链接。 也可通过APP查询接口查询可用APP ID对应的下载链接。
is_market_link	string	否	跳转厂商应用商店	开启后，用户点击广告将跳转手机厂商应用商店进行下载。枚举值
target_url_h5	string	否	落地页链接	应用推广场景选填。 拉活且投放系统为Android或不限时，download_url、target_url_h5、deep_link三者至少保留一个有效值。 注意可填写自定义链接，也可通过建站查询查询可用建站ID对应的落地页链接（注意：创意仅能使用本账户的建站）
target_type	string	否	建站类型	使用建站时必填。 允许值：鲸鱼建站-WHALE、赤兔建站-CHITU
clk_site_id	int	否	建站ID	使用建站时必填。 通过建站查询接口查询可用建站ID（注意：创意仅能使用本账户的建站）
deep_link	string	否	deeplink链接	1、不能以http或https开头 2、不能出现中文
universal_link	string	否	universal_link链接	当 sub_cate 为 IOS_APP 时可用
app_logo	string	否	APP的logo链接	除应用商城外必填logo数量：1张，比例：1:1，大小 < 200k，支持格式：gif、jpg、png
app_name	string	否	APP名称	除应用商城外必填，1-20个字数
play_duration	string	否	试玩时长	枚举值
title	string	否	标题	标题，样式为小图,大图,组图,视频广告（横版）,视频广告（竖版）,文字链,互动广告时，必填 文字链的标题长度要求最多10字； 互动广告的标题长度要求最多23字； 其余样式的标题长度要求8-23字
second_title	string	否	副标题	副标题，样式为视频广告（横版）,视频广告（竖版）时，必填； 长度要求最多11字
video_title	string	否	激励视频的标题	样式为激励视频（横版）,激励视频（竖版）时，可修改；长度要求最多10字
description	string	否	创意描述（激励视频）	样式为激励视频（横版）,激励视频（竖版）时，可修改； 长度要求8-23字
conversion_target	string	否	转化目标	样式为应用商城且转化追踪方式为API（APP内转化）时，必填； 允许值：激活、注册、自定义后端转化文案 自定义后端转化文案长度要求最多10字
back_end_conversion	string	否	后端转化文案	满足以下条件是，该参数必填： 1.样式为应用商城； 2.账户在应用商城API回传白名单中；3. 转化追踪方式选择API（APP内转化）； 4.转化目标选择后端转化
app_introduction	string	否	应用简介	样式为应用商城时，必填； 长度要求8-15字
app_desc	string	否	内容描述	样式为应用商城时，必填； 长度要求10-100字
text_link_description	string	否	内容描述	样式为文字链时，必填； 长度要求最多16字
text_link_btn	string	否	文字链按钮	样式为文字链时，必填 长度要求最多4字
btn_text	string	否	互动广告按钮文案	样式为互动广告时，必填； 长度要求最多5字
image	[]int	否	图片信息	格式见字段示例
video_id	int	否	视频ID
motivate_video_autoplay	string	否	激励视频plus开关	激励视频播完自动跳转落地页开关。 默认值：关闭。允许值：开启-ENABLE， 关闭-DISABLE

线索收集

字段名	类型	是否必须	描述	备注
pkg_name	string	否	安装包名	推广分类选择ANDROID_APP时可传； 安卓包名校验规则：必须是字母，字母规则（eg：com.duowan.mobile）
conversion_type	string	否	转化追踪方式	枚举值 默认值：无； 允许值：无，JS布码，API（APP内转化），API（落地页转化）
target_url	string	否	落地页链接	1.可填写自定义链接 2.也可通过建站查询查询可用建站ID对应的落地页链接（注意：创意仅能使用本账户的建站）。 3.转化追踪方式为JS布码时，必须使用JS布码查询接口查询可用JS布码ID对应的落地页链接； 4.转化追踪方式为API（落地页转化）时，必须使用API查询查询可用的API ID（落地页转化类型）对应的落地页链接
target_type	string	否	建站类型	使用建站时必填。 允许值：鲸鱼建站-WHALE、赤兔建站-CHITU
clk_site_id	int	否	建站ID	使用建站时必填。 通过建站查询接口查询可用建站ID（注意：创意仅能使用本账户的建站）
js_conversion_id	int	否	Js布码链接ID	转化追踪方式选择JS布码，必填
deep_link	string	否	deeplink链接	1、不能以http或https开头 2、不能出现中文
app_logo	string	否	APP的logo链接	推广分类选择ANDROID_APP，IOS_APP，必填； logo数量：1张，比例：1:1，大小 < 200k，支持格式：gif、jpg、png
app_name	string	否	APP名称	推广分类选择ANDROID_APP，IOS_APP，必填； 1-10个字数
title	string	否	标题	样式为小图,大图,组图,视频广告（横版）,视频广告（竖版）,文字链,互动广告`时，必填； 标题要求： 1.文字链的标题长度要求最多10字； 2.互动广告的标题长度要求最多23字； 3.其余样式的标题长度要求8-23字；
second_title	string	否	副标题	样式为视频广告（横版）,视频广告（竖版）时，必填；长度要求最多11字 <
video_title	string	否	激励视频的标题	样式为激励视频（横版）,激励视频（竖版）时，可修改；长度要求最多10字
description	string	否	创意描述（激励视频）	样式为激励视频（横版）,激励视频（竖版）时，可修改； 长度要求8-23字
text_link_description	string	否	内容描述	样式为文字链时，必填； 长度要求最多16字
text_link_btn	string	否	按钮文案	样式为文字链时，必填 长度要求最多4字
btn_text	string	否	领取按钮文案	样式为互动广告时，必填； 长度要求最多5字
image	[]int	否	图片信息	格式见字段示例
video_id	int	否	视频ID
motivate_video_autoplay	string	否	激励视频plus开关	激励视频播完自动跳转落地页开关。 默认值：关闭。允许值：开启-ENABLE， 关闭-DISABLE

快应用

字段名	类型	是否必须	描述	备注
pkg_name	string	否	快应用包名	快应用包名校验规则：必须是字母，字母规则（eg：com.duowan.mobile）
conversion_type	string	是	转化追踪方式	枚举值 默认值：无； 允许值：无，API（APP内转化），API（落地页转化） 注意：快应用不支持JS布码
target_url	string	否	落地页链接	1.可填写自定义链接 2.也可通过建站查询查询可用建站ID对应的落地页链接（注意：创意仅能使用本账户的建站）。 3.转化追踪方式为API（落地页转化）时必填，并须使用API查询查询可用的API ID（落地页转化类型）对应的落地页链接；其他转化追踪方式选填
target_type	string	否	建站类型	使用建站时必填。 允许值：鲸鱼建站-WHALE、赤兔建站-CHITU
clk_site_id	int	否	建站ID	使用建站时必填。 通过建站查询接口查询可用建站ID（注意：创意仅能使用本账户的建站）
deep_link	string	否	deeplink链接	1、不能以http或https开头 2、不能出现中文 3、除API（落地页转化）外，其他转化追踪方式必填
app_logo	string	否	快应用的logo链接	logo数量：1张，比例：1:1，大小 < 200k，支持格式：gif、jpg、png
app_name	string	否	快应用名称	1-10个字数
title	string	否	标题	样式为小图,大图,组图,视频广告（横版）,视频广告（竖版）,文字链,互动广告`时，必填； 标题要求： 1.文字链的标题长度要求最多10字； 2.互动广告的标题长度要求最多23字； 3.其余样式的标题长度要求8-23字；
second_title	string	否	副标题	样式为视频广告（横版）,视频广告（竖版）时，必填；长度要求最多11字
video_title	string	否	激励视频的标题	样式为激励视频（横版）,激励视频（竖版）时，必填； 长度要求最多10字
description	string	否	创意描述（激励视频）	样式为激励视频（横版）,激励视频（竖版）时，必填。 长度要求8-23字
text_link_description	string	否	内容描述	样式为文字链时，必填； 长度要求最多16字
text_link_btn	string	否	按钮文案	样式为文字链时，必填 长度要求最多4字
btn_text	string	否	领取按钮文案	样式为互动广告时，可填； 长度要求最多5字
image	[]int	是	图片信息	格式见字段示例
video_id	int	否	视频ID	样式为视频广告和激励视频时必填，视频ID可以通过素材列表接口获取
motivate_video_autoplay	string	否	激励视频plus开关	激励视频播完自动跳转落地页开关。 默认值：关闭。允许值：开启-ENABLE， 关闭-DISABLE

微信小程序

字段名	类型	是否必须	描述	备注
type	string	是	创意样式	枚举值 支持以下类型： 小图、大图、组图、视频广告（横版）、视频广告（竖版）、激励视频（横版）、激励视频（竖版）、文字链、互动广告、开屏广告、横幅广告
sub_cate	string	是	推广分类	枚举值 注意：推广分类，允许值：MINI_PROGRAM
pkg_name	string	是	小程序名称	小程序名称
conversion_type	string	否	转化追踪方式	枚举值 默认值：无； 允许值：无，API（APP内转化），API（落地页转化）
mini_url_type	int	否	小程序跳转链路类型	允许值：1-系统生成链路，2-自定义跳转链接
mini_program	object	否	微信小程序相关信息	1.与deep_link互斥 2.格式：{"original_id":"XXXX","path":"XXXX"} 3.mini_url_type=1时，需传original_id；path为唤醒页面
target_type	string	否	建站类型	使用建站时必填。 允许值：鲸鱼建站-WHALE、赤兔建站-CHITU
clk_site_id	int	否	建站ID	使用建站时必填。 通过建站查询接口查询可用建站ID（注意：创意仅能使用本账户的建站）
target_url	string	否	落地页链接	1.可填写自定义链接 2.也可通过建站查询查询可用建站ID对应的落地页链接（注意：创意仅能使用本账户的建站）。 3.转化追踪方式为API（落地页转化）时必填，并须使用API查询查询可用的API ID（落地页转化类型）对应的落地页链接；其他转化追踪方式选填
deep_link	string	否	deeplink链接	1、不能以http或https开头 2、不能出现中文 3.mini_url_type=2且转化追踪方式不为API（落地页转化）时必填
app_logo	string	是	小程序的logo链接	logo数量：1张，尺寸：100x100，大小 < 100k，支持格式：gif、jpg、png
app_name	string	是	小程序名称	1-10个字数
title	string	否	标题	样式为小图,大图,组图,视频广告（横版）,视频广告（竖版）,文字链,互动广告`时，必填； 标题要求： 1.文字链的标题长度要求最多10字； 2.互动广告的标题长度要求最多23字； 3.其余样式的标题长度要求8-23字；
second_title	string	否	副标题	样式为视频广告（横版）,视频广告（竖版）时，必填；长度要求最多11字
video_title	string	否	激励视频的标题	样式为激励视频（横版）,激励视频（竖版）时，必填； 长度要求最多10字
description	string	否	创意描述（激励视频）	样式为激励视频（横版）,激励视频（竖版）时，必填。 长度要求8-23字
text_link_description	string	否	内容描述	样式为文字链时，必填； 长度要求最多16字
text_link_btn	string	否	按钮文案	样式为文字链时，必填 长度要求最多4字
btn_text	string	否	领取按钮文案	样式为互动广告时，可填； 长度要求最多5字
image	[]int	是	图片信息	格式见字段示例
video_id	int	否	视频ID	样式为视频广告和激励视频时必填，视频ID可以通过素材列表接口获取
motivate_style	string	否	激励样式	满足以下条件后，可以填写： 1.开通了激励样式白名单； 2.计划营销目标为拉活； 3.单元付费方式为CPC,oCPX； 4.投放媒体为趣头条； 5.样式为小图,大图,组图,视频广告（横版）,视频广告（竖版）时； 枚举值 默认值：无
motivate_video_autoplay	string	否	激励视频plus开关	激励视频播完自动跳转落地页开关。 默认值：关闭。允许值：开启-ENABLE， 关闭-DISABLE

Body 示例

{
    "creative_id" : 3994457,
    "creative_name" : "修改创意名称",
    "configure_status": "PAUSED"
}

请求示例

curl -X POST \
  'https://openapi.aiclk.com/openapi/v1/creative/update?account_id=1000009' \
  -H 'Content-Type: application/json' \
  -H 'OGW_ACCESS_TOKEN: your_access_token' \
  -d '{"creative_id":3994457,"creative_name":"修改创意名称","configure_status":"PAUSED"}'

返回字段释义

字段名	类型	描述
code	int	返回码
message	string	接口信息
data	object	返回值

返回示例

{
   "code":200,
   "data":null,
   "message":"success"
}