creative

Documentation

Overview

Package creative 广告创意

Index

• type AdvancedCreative
• type AdvancedCreativeCreateRequest
  • func (r AdvancedCreativeCreateRequest) Encode() []byte
  • func (r AdvancedCreativeCreateRequest) Url() string
• type AdvancedCreativeCreateResponse
• type AdvancedCreativeListRequest
  • func (r AdvancedCreativeListRequest) Encode() []byte
  • func (r AdvancedCreativeListRequest) Url() string
• type AdvancedCreativeListResponse
• type AdvancedCreativeUpdateRequest
  • func (r AdvancedCreativeUpdateRequest) Encode() []byte
  • func (r AdvancedCreativeUpdateRequest) Url() string
• type AdvancedCreativeUpdateResponse
• type BatchUpdateRequest
  • func (r BatchUpdateRequest) Encode() []byte
  • func (r BatchUpdateRequest) Url() string
• type BatchUpdateResponse
• type CreateRequest
  • func (r CreateRequest) Encode() []byte
  • func (r CreateRequest) Url() string
• type CreateResponse
• type Creative
• type DisplayInfo
• type ListRequest
  • func (r ListRequest) Encode() []byte
  • func (r ListRequest) Url() string
• type ListResponse
• type NewExposeTag
• type Photo
• type PreviewRequest
  • func (r PreviewRequest) Encode() []byte
  • func (r PreviewRequest) Url() string
• type SplashPhoto
• type SplashPicture
• type UpdateRequest
  • func (r UpdateRequest) Encode() []byte
  • func (r UpdateRequest) Url() string
• type UpdateResponse
• type UpdateStatusRequest
  • func (r UpdateStatusRequest) Encode() []byte
  • func (r UpdateStatusRequest) Url() string
• type UpdateStatusResponse

Types

type AdvancedCreative

type AdvancedCreative struct {
	// UnitID 广告组 ID
	// 一个组下只能有一个程序化创意，只有这个广告组的 unit_type 为 7 才能创建程序化创意
	UnitID uint64 `json:"unit_id,omitempty"`
	// PackageName 程序化创意名称
	PackageName string `json:"package_name,omitempty"`
	// HorizontalPhotoIDs 横版视频 id list
	HorizontalPhotoIDs []string `json:"horizontal_photo_ids,omitempty"`
	// VerticalPhotoIDs 竖版视频 id list
	VerticalPhotoIDs []string `json:"vertical_photo_ids,omitempty"`
	// CoverImageTokens 封面 image_token
	CoverImageTokens []string `json:"cover_image_tokens,omitempty"`
	// CoverImageURLs 封面链接地址
	CoverImageURLs []string `json:"cover_image_urls,omitempty"`
	// StickerStyles 贴纸样式
	StickerStyles []int `json:"sticker_styles,omitempty"`
	// CoverSlogans 封面 slogans
	CoverSlogans []string `json:"cover_slogans,omitempty"`
	// ActionBar 行动号召按钮
	ActionBar string `json:"action_bar,omitempty"`
	// Captions 作品广告语
	// 每个不超过 30 个字符，英文字符两个算一个字符，最多可传 3 个
	Captions []string `json:"captions,omitempty"`
	// ClickURL 第三方点击检测链接
	// 不能超过 1024 字符 ocpx_action_type 是 180 并且应用没有接入 sdk，监测链接必填； 计划 type 是 2（推广应用安装），ocpx_action_type 是注册（396）、付费（190）、完件（384）、授信（383），并且没有接入 sdk，监测链接必填
	ClickURL string `json:"click_url,omitempty"`
	// ImpressionURL 第三方开始播放监测链接
	ImpressionURL string `json:"impression_url,omitempty"`
	// ActionbarClickURL 第三方 ActionBar 点击监控链接，命中有效触点白名单表示有效触点监测链接（限：快手主站/极速版场景）
	// 部分客户使用 actionbar_click_url 不为空时，click_url 必填，不能超过 1024 字符
	ActionbarClickURL string `json:"actionbar_click_url,omitempty"`
	// PutStatus 程序化创意操作状态
	// 1：投放，2：暂停，3：删除
	PutStatus int `json:"put_status,omitempty"`
	// ViewStatus 程序化创意状态
	// -1：不限，1：计划已暂停，3：计划超预算，5：计划已删除，6：余额不足，11：组审核中，12：组审核未通过，14：已结束，15：组已暂停，17：组超预算，19：未达投放时间，22：不在投放时段，40：创意已删除，41：审核中，42：审核未通过，46：已暂停，52：投放中，53：作品异常，55：部分素材审核通过，56：部分审核失败，62：待送审
	ViewStatus int `json:"view_status,omitempty"`
	// ViewStatusReason 程序化创意状态描述
	ViewStatusReason string `json:"view_status_reason,omitempty"`
	// CreateTime 创建时间
	CreateTime string `json:"create_time,omitempty"`
	// UpdateTime 更新时间
	UpdateTime string `json:"update_time,omitempty"`
	// Creatives 创建后生成的程序化创意 ID
	Creatives []Creative `json:"creatives,omitempty"`
	// PicIDs 图片库图片ID
	PicIDs []string `json:"pic_ids,omitempty"`
	// AppGradeType 审核分级类型
	// 0：默认；1：审核降级(当创意发生降级时，会限制部分流量无法投放)
	AppGradeType int `json:"app_grade_type,omitempty"`
	// PicList 联盟图片（横版/竖版）
	// 联盟图片imageToken
	PicList []string `json:"pic_list,omitempty"`
	// PicURLList 联盟图片url（横版/竖版）
	PicURLList []string `json:"pic_url_list,omitempty"`
	// PhotoList 素材列表
	PhotoList []Photo `json:"photo_list,omitempty"`
	// AdPhotoPlayedT3sURL 第三方有效播放监测链接
	// 白名单功能，且当广告组 scene_id 为 27（开屏） 时不支持该检测链接；与 impression_url 不可同时使用
	AdPhotoPlayedT3sURL string `json:"ad_photo_played_t3s_url,omitempty"`
	// CreativeCategory 创意分类
	// 由创意分类查询接口 获得；必须是叶子结点；与创意标签同时传或同时不传 可通过工具-功能名单-获取创意分类标签白名单客户接口获取是否必填。注：不可传入负值
	CreativeCategory int `json:"creative_category,omitempty"`
	// CreativeTag 创意标签
	// 与创意分类参数，要么都传，要么都不传；且单个创意的创意标签最多 10 个；单个创意标签不能为空且不能超过 10 字符，
	CreativeTag []string `json:"creative_tag,omitempty"`
	// NewExposeTag 广告标签 2 期
	// 按照相关格式传递两个推荐理由 举例{“text”:"工厂直发"},{"text":"限时专享"}
	NewExposeTag []NewExposeTag `json:"new_expose_tag,omitempty"`
	// MaterialIntelligentOptimize 素材智能优化开关
	// 0-关闭，1-开启，不传默认关闭。仅白名单用户可以使用。
	MaterialIntelligentOptimize int `json:"material_intelligent_optimize,omitempty"`
	// OuterLoopNative 是否开启原生
	// 1开启，0关闭，不填则默认为0，投放快手信息流广告时（ad_type=0或默认不填，scene_id包含1优选广告位、6上下滑大屏广告、7双列信息流广告），当campaignType=2提升应用安装、5收集销售线索、7提升应用活跃、19推广快手小程序、30快手号-短剧推广时，可开启原生投放。注：投放快手信息流广告且升级白名单账户必选 outer_loop_native = 1，否则会报错
	OuterLoopNative int `json:"outer_loop_native,omitempty"`
	// KOLUserType 原生达人用户类型
	// 1普通快手号原生，2服务号原生，3聚星达人原生，当outer_loop_native=1时此项必填,当 campaignType=30只能填写1普通快手号
	KOLUserType int `json:"kol_user_type,omitempty"`
	// KOLUserID 原生投放目标达人ID
	// 开启原生场景下必传，即当outer_loop_native=1时此项必填， 计划 campaignType=30 短剧推广时，值为短剧作者ID
	KOLUserID uint64 `json:"kol_user_id,omitempty"`
	// Recommendation plc自定义文案
	// 开启原生时可用
	Recommendation string `json:"recommendation,omitempty"`
	// OpenAccountNative 是否为原生扩量
	// 0：否 1：是
	OpenAccountNative int `json:"open_account_native,omitempty"`
}

AdvancedCreative 程序化创意

type AdvancedCreativeCreateRequest

type AdvancedCreativeCreateRequest struct {
	// AdvertiserID 广告主 ID
	AdvertiserID uint64 `json:"advertiser_id,omitempty"`
	// UnitID 广告组 ID
	// 一个组下只能有一个程序化创意，只有这个广告组的 unit_type 为 7 才能创建程序化创意
	UnitID uint64 `json:"unit_id,omitempty"`
	// PackageName 程序化创意名称
	// 不能为空，1-100 字符
	PackageName string `json:"package_name,omitempty"`
	// StickerStyles 封面贴纸
	// （仅搜索广告支持）如果使用封面贴纸 sticker_Styles 和 cover_slogans 必须同时传值，最多选择 6 个
	StickerStyles []int `json:"sticker_styles,omitempty"`
	// CoverSlogans 封面口号
	// （仅搜索广告支持） 0-14 字符，最多选择 6 个（每个中文和英文字符都算一个字符）
	CoverSlogans []string `json:"cover_slogans,omitempty"`
	// ActionBar 行动号召按钮
	ActionBar string `json:"action_bar,omitempty"`
	// Captions 作品广告语
	// 每个不超过 30 个字符，英文字符两个算一个字符，最多可传 3 个
	Captions []string `json:"captions,omitempty"`
	// ClickURL 第三方点击检测链接
	// 不能超过 1024 字符 ocpx_action_type 是 180 并且应用没有接入 sdk，监测链接必填； 计划 type 是 2（推广应用安装），ocpx_action_type 是注册（396）、付费（190）、完件（384）、授信（383），并且没有接入 sdk，监测链接必填
	ClickURL string `json:"click_url,omitempty"`
	// ImpressionURL 第三方开始播放监测链接
	ImpressionURL string `json:"impression_url,omitempty"`
	// ActionbarClickURL 第三方 ActionBar 点击监控链接，命中有效触点白名单表示有效触点监测链接（限：快手主站/极速版场景）
	// 部分客户使用 actionbar_click_url 不为空时，click_url 必填，不能超过 1024 字符
	ActionbarClickURL string `json:"actionbar_click_url,omitempty"`
	// AdPhotoPlayedT3sURL 第三方有效播放监测链接
	// 白名单功能，且当广告组 scene_id 为 27（开屏） 时不支持该检测链接；与 impression_url 不可同时使用
	AdPhotoPlayedT3sURL string `json:"ad_photo_played_t3s_url,omitempty"`
	// CreativeCategory 创意分类
	// 由创意分类查询接口 获得；必须是叶子结点；与创意标签同时传或同时不传 可通过工具-功能名单-获取创意分类标签白名单客户接口获取是否必填。注：不可传入负值
	CreativeCategory int `json:"creative_category,omitempty"`
	// CreativeTag 创意标签
	// 与创意分类参数，要么都传，要么都不传；且单个创意的创意标签最多 10 个；单个创意标签不能为空且不能超过 10 字符，
	CreativeTag []string `json:"creative_tag,omitempty"`
	// PhotoList 素材列表
	// 新创建程序化创意请使用此参数，最多支持 10 组素材(传递后将忽略 horizontal_photo_ids,vertical_photo_ids,cover_image_tokens，7.15 日后老字段下线)
	PhotoList []Photo `json:"photo_list,omitempty"`
	// PicList 联盟图片（横版/竖版）
	// 需要传入image_token列表，image_token通过上传图片接口获取
	PicList []string `json:"pic_list,omitempty"`
	// NewExposeTag 广告标签 2 期
	// 按照相关格式传递两个推荐理由 举例{“text”:"工厂直发"},{"text":"限时专享"}
	NewExposeTag []NewExposeTag `json:"new_expose_tag,omitempty"`
	// MaterialIntelligentOptimize 素材智能优化开关
	// 0-关闭，1-开启，不传默认关闭。仅白名单用户可以使用。
	MaterialIntelligentOptimize int `json:"material_intelligent_optimize,omitempty"`
	// OuterLoopNative 是否开启原生
	// 1开启，0关闭，不填则默认为0，投放快手信息流广告时（ad_type=0或默认不填，scene_id包含1优选广告位、6上下滑大屏广告、7双列信息流广告），当campaignType=2提升应用安装、5收集销售线索、7提升应用活跃、19推广快手小程序、30快手号-短剧推广时，可开启原生投放。注：投放快手信息流广告且升级白名单账户必选 outer_loop_native = 1，否则会报错
	OuterLoopNative int `json:"outer_loop_native,omitempty"`
	// KOLUserType 原生达人用户类型
	// 1普通快手号原生，2服务号原生，3聚星达人原生，当outer_loop_native=1时此项必填,当 campaignType=30只能填写1普通快手号
	KOLUserType int `json:"kol_user_type,omitempty"`
	// KOLUserID 原生投放目标达人ID
	// 开启原生场景下必传，即当outer_loop_native=1时此项必填， 计划 campaignType=30 短剧推广时，值为短剧作者ID
	KOLUserID uint64 `json:"kol_user_id,omitempty"`
	// Recommendation plc自定义文案
	// 开启原生时可用
	Recommendation string `json:"recommendation,omitempty"`
}

AdvancedCreativeCreateRequest 创建程序化创意 API Request

func (AdvancedCreativeCreateRequest) Encode

func (r AdvancedCreativeCreateRequest) Encode() []byte

Encode implement PostRequest interface

func (AdvancedCreativeCreateRequest) Url

func (r AdvancedCreativeCreateRequest) Url() string

Url implement PostRequest interface

type AdvancedCreativeCreateResponse

type AdvancedCreativeCreateResponse struct {
	// UnitID 广告组 id
	UnitID uint64 `json:"unit_id,omitempty"`
}

AdvancedCreativeCreateResponse 创建程序化创意 API Response

type AdvancedCreativeListRequest

type AdvancedCreativeListRequest struct {
	// AdvertiserID 广告主 ID
	AdvertiserID uint64 `json:"advertiser_id,omitempty"`
	// UnitIDs 广告组 ID 集
	// 不超过一百个
	UnitIDs []uint64 `json:"unit_ids,omitempty"`
	// PackageName 程序化创意包名称
	PackageName string `json:"package_name,omitempty"`
	// Status 程序化创意状态
	// -2：所有（包含已删除）、40：只包含已删除 不传：所有（不包含已删除）
	Status int `json:"status,omitempty"`
	// StartDate 开始时间
	// 与 end_date 同时传或同时不传；过滤筛选条件，格式为"yyyy-MM-dd"，参数值对应 update_time 信息
	StartDate string `json:"start_date,omitempty"`
	// EndDate 结束时间
	// 与 start_date 同时传或同时不传；过滤筛选条件，格式为"yyyy-MM-dd"，参数值对应 update_time 信息
	EndDate string `json:"end_date,omitempty"`
	// TimeFilterType 按创建时间或者更新时间进行筛选
	// 1.如传入此字段时不传"start_date"，与"end_date"字段，则不根据时间筛选。2.传入"start_date"，与"end_date"字段，且此字段为 1 时，按照创建时间进行筛选。3.传入"start_date"，与"end_date"字段，此字段不传，或传值为 0 时，则按照更新时间进行筛选
	TimeFilterType int `json:"time_filter_type,omitempty"`
	// Page 请求的页码数, 默认为 1
	Page int `json:"page,omitempty"`
	// PageSize 请求的每页行数, 默认为 20
	PageSize int `json:"page_size,omitempty"`
	// PutStatusAdvancedCreativeList 创意投放状态
	// 1：投放；2：暂停；3：删除。备注：传了该参数会覆盖status参数筛选，因为二者是相同筛选项
	PutStatusAdvancedCreativeList []int `json:"put_status_list,omitempty"`
}

AdvancedCreativeListRequest 查询程序化创意 API Request

func (AdvancedCreativeListRequest) Encode

func (r AdvancedCreativeListRequest) Encode() []byte

Encode implement PostRequest interface

func (AdvancedCreativeListRequest) Url

func (r AdvancedCreativeListRequest) Url() string

Url implement PostRequest interface

type AdvancedCreativeListResponse

type AdvancedCreativeListResponse struct {
	TotalCount int                `json:"total_count,omitempty"`
	Details    []AdvancedCreative `json:"details,omitempty"`
}

AdvancedCreativeListResponse 查询程序化创意 API Response

type AdvancedCreativeUpdateRequest

type AdvancedCreativeUpdateRequest struct {
	// AdvertiserID 广告主 ID
	AdvertiserID uint64 `json:"advertiser_id,omitempty"`
	// UnitID 广告组 ID
	// 一个组下只能有一个程序化创意，只有这个广告组的 unit_type 为 7 才能创建程序化创意
	UnitID uint64 `json:"unit_id,omitempty"`
	// PackageName 程序化创意名称
	// 不能为空，1-100 字符
	PackageName string `json:"package_name,omitempty"`
	// StickerStyles 封面贴纸
	// （仅搜索广告支持）如果使用封面贴纸 sticker_Styles 和 cover_slogans 必须同时传值，最多选择 6 个
	StickerStyles []int `json:"sticker_styles,omitempty"`
	// CoverSlogans 封面口号
	// （仅搜索广告支持） 0-14 字符，最多选择 6 个（每个中文和英文字符都算一个字符）
	CoverSlogans []string `json:"cover_slogans,omitempty"`
	// ActionBar 行动号召按钮
	ActionBar string `json:"action_bar,omitempty"`
	// Captions 作品广告语
	// 每个不超过 30 个字符，英文字符两个算一个字符，最多可传 3 个
	Captions []string `json:"captions,omitempty"`
	// ClickURL 第三方点击检测链接
	// 不能超过 1024 字符 ocpx_action_type 是 180 并且应用没有接入 sdk，监测链接必填； 计划 type 是 2（推广应用安装），ocpx_action_type 是注册（396）、付费（190）、完件（384）、授信（383），并且没有接入 sdk，监测链接必填
	ClickURL string `json:"click_url,omitempty"`
	// ImpressionURL 第三方开始播放监测链接
	ImpressionURL string `json:"impression_url,omitempty"`
	// ActionbarClickURL 第三方 ActionBar 点击监控链接，命中有效触点白名单表示有效触点监测链接（限：快手主站/极速版场景）
	// 部分客户使用 actionbar_click_url 不为空时，click_url 必填，不能超过 1024 字符
	ActionbarClickURL string `json:"actionbar_click_url,omitempty"`
	// AdPhotoPlayedT3sURL 第三方有效播放监测链接
	// 白名单功能，且当广告组 scene_id 为 27（开屏） 时不支持该检测链接；与 impression_url 不可同时使用
	AdPhotoPlayedT3sURL string `json:"ad_photo_played_t3s_url,omitempty"`
	// CreativeCategory 创意分类
	// 由创意分类查询接口 获得；必须是叶子结点；与创意标签同时传或同时不传 可通过工具-功能名单-获取创意分类标签白名单客户接口获取是否必填。注：不可传入负值
	CreativeCategory int `json:"creative_category,omitempty"`
	// CreativeTag 创意标签
	// 与创意分类参数，要么都传，要么都不传；且单个创意的创意标签最多 10 个；单个创意标签不能为空且不能超过 10 字符，
	CreativeTag []string `json:"creative_tag,omitempty"`
	// PhotoList 素材列表
	// 新创建程序化创意请使用此参数，最多支持 10 组素材(传递后将忽略 horizontal_photo_ids,vertical_photo_ids,cover_image_tokens，7.15 日后老字段下线)
	PhotoList []Photo `json:"photo_list,omitempty"`
	// PicList 联盟图片（横版/竖版）
	// 需要传入image_token列表，image_token通过上传图片接口获取
	PicList []string `json:"pic_list,omitempty"`
	// NewExposeTag 广告标签 2 期
	// 按照相关格式传递两个推荐理由 举例{“text”:"工厂直发"},{"text":"限时专享"}
	NewExposeTag []NewExposeTag `json:"new_expose_tag,omitempty"`
	// MaterialIntelligentOptimize 素材智能优化开关
	// 0-关闭，1-开启，不传默认关闭。仅白名单用户可以使用。
	MaterialIntelligentOptimize *int `json:"material_intelligent_optimize,omitempty"`
}

AdvancedCreativeUpdateRequest 修改程序化创意 API Request

func (AdvancedCreativeUpdateRequest) Encode

func (r AdvancedCreativeUpdateRequest) Encode() []byte

Encode implement PostRequest interface

func (AdvancedCreativeUpdateRequest) Url

func (r AdvancedCreativeUpdateRequest) Url() string

Url implement PostRequest interface

type AdvancedCreativeUpdateResponse

type AdvancedCreativeUpdateResponse struct {
	// UnitID 广告组 id
	UnitID uint64 `json:"unit_id,omitempty"`
}

AdvancedCreativeUpdateResponse 修改程序化创意 API Response

type BatchUpdateRequest

type BatchUpdateRequest struct {
	// AdvertiserID 广告主 ID
	AdvertiserID uint64 `json:"advertiser_id,omitempty"`
	// UnitID 广告组 ID
	UnitID uint64 `json:"unit_id,omitempty"`
	// ClickTrackURL 第三方点击检测链接
	// 仅当广告组 scene_id 为 1、2、6、7、10 时，可选填； 广告组优化目标为激活时，该字段必填（下载类广告投放的应用集成快手 Android SDK 时除外） 使用 Marketing API 创建时，监测链接使用以该文档为准
	ClickTrackURL string `json:"click_track_url,omitempty"`
	// ImpressionURL 第三方开始播放监测链接
	// 广告组优化目标为激活时，该字段必填（下载类广告投放的应用集成快手 Android SDK 时除外） 使用 Marketing API 创建时，监测链接使用以该文档为准
	ImpressionURL string `json:"impression_url,omitempty"`
	// AdPhotoPlayedT3sURL 第三方有效播放监测链接
	// 白名单功能，且当广告组 scene_id 为 27（开屏） 时不支持该检测链接；与 impression_url 不可同时使用
	AdPhotoPlayedT3sURL string `json:"ad_photo_played_t3s_url,omitempty"`
	// ActionbarClickURL 第三方点击按钮监测链接，命中有效触点白名单表示有效触点监测链接（限：快手主站/极速版场景）
	// 1.校验 click_url 必填的广告场景 优选(1)/信息流(2、7)/上下滑（6） 2.优化目标为激活功能必填点击监测链接,但如果安卓应用接入了快手监测 sdk 就不需要填写监测链接了 3.联盟场景检查 click_url 不能为空 4.若广告联盟的转化目标为激活，click_url、actionbar_click_url 和监测 SDK 至少三选一
	ActionbarClickURL string `json:"actionbar_click_url,omitempty"`
	// CreativeCategory 创意分类
	// 由创意分类查询接口 获得；必须是叶子结点；与创意标签同时传或同时不传 可通过工具-功能名单-获取创意分类标签白名单客户接口获取是否必填。注：不可传入负值
	CreativeCategory int `json:"creative_category,omitempty"`
	// CreativeTag 创意标签
	// 与创意分类参数，要么都传，要么都不传；且单个创意的创意标签最多 10 个；单个创意标签不能为空且不能超过 10 字符，
	CreativeTag []string `json:"creative_tag,omitempty"`
	// MaterialIntelligentOptimize 素材智能优化开关
	// 0-关闭，1-开启，不传默认关闭。仅白名单用户可以使用。
	MaterialIntelligentOptimize *int `json:"material_intelligent_optimize,omitempty"`
	// CreativeID 广告创意 ID
	// 上传该字段为更新，不上传则为创建 更新时传入创意 id 不能重复 需要在对应 unit_id 下
	CreativeID uint64 `json:"creative_id,omitempty"`
	// CreativeName 创意名称
	// 长度为 1-100 字符，同一个广告组下名称不能重复
	CreativeName string `json:"creative_name,omitempty"`
	// PhotoID 视频 ID
	PhotoID string `json:"photo_id,omitempty"`
	// ImageToken 封面图片 token
	// 通过上传图片接口获得，不传值则直接使用视频的首帧作为封面图片，自定义封面的图片宽高要与视频宽高一致
	ImageToken string `json:"image_token,omitempty"`
	// DpaTemplateID DPA模板ID
	// creative_material_type = 14 时，必填。通过DPA 模板信息接口取
	DpaTemplateID uint64 `json:"dpa_template_id,omitempty"`
	// ImageTokens 便利贴单图图片创意 token
	// 便利贴/图片/小图图片创意必填，目前只支持一张图片；组图图片创意需要上传 3 张图片，详细要求见附录
	ImageTokens []string `json:"image_tokens,omitempty"`
	// ActionBarText 行动号召按钮文案
	// 根据计划类型进行设置
	ActionBarText string `json:"action_bar_text,omitempty"`
	// Description 广告语
	// 长度为 1-30 字符，不支持换行。 如果要使用动态词包，格式如"[地区]的[男性女性]都喜欢"， 联盟广告和程序化创意不支持动态词包， 词包名可以通过下方动态词包接口获取
	Description string `json:"description,omitempty"`
	// NewExposeTag 广告标签 2 期
	// 按照相关格式传递两个推荐理由 举例{“text”:"工厂直发"},{"text":"限时专享"}
	NewExposeTag []NewExposeTag `json:"new_expose_tag,omitempty"`
	// SplashPhotoIDs 开屏视频 id
	// creative_material_type 为 11 时必填，使用上传视频接口时返回的 photo_id；即素材类型是开屏视频时，必须传入全尺寸的 4 条视频，具体参考素材层级接口
	SplashPhotoIDs []string `json:"splash_photo_ids,omitempty"`
	// SplashImageTokens 开屏图片 token
	// creative_material_type 为 12 时必填，使用上传图片接口时返回的 image_token，素材类型是开屏图片时，必须传入全尺寸的 6 张图片，具体参考素材层级接口
	SplashImageTokens []string `json:"splash_image_tokens,omitempty"`
	// DpaStyleTypes 动态商品卡样式ID
	// 动态商品卡投放必填：14001-区域服务卡
	DpaStyleTypes []int `json:"dpa_style_types,omitempty"`
	// OuterLoopNative 是否开启原生
	// 1开启，0关闭，不填则默认为0，投放快手信息流广告时（ad_type=0或默认不填，scene_id包含1优选广告位、6上下滑大屏广告、7双列信息流广告），当campaignType=2提升应用安装、5收集销售线索、7提升应用活跃、19推广快手小程序、30快手号-短剧推广时，可开启原生投放。注：投放快手信息流广告且升级白名单账户必选 outer_loop_native = 1，否则会报错
	OuterLoopNative *int `json:"outer_loop_native,omitempty"`
	// KOLUserType 原生达人用户类型
	// 1普通快手号原生，2服务号原生，3聚星达人原生，当outer_loop_native=1时此项必填,当 campaignType=30只能填写1普通快手号
	KOLUserType int `json:"kol_user_type,omitempty"`
	// KOLUserID 原生投放目标达人ID
	// 开启原生场景下必传，即当outer_loop_native=1时此项必填， 计划 campaignType=30 短剧推广时，值为短剧作者ID
	KOLUserID uint64 `json:"kol_user_id,omitempty"`
	// Recommendation plc自定义文案
	Recommendation string `json:"recommendation,omitempty"`
}

BatchUpdateRequest 批量修改自定义创意 API Request

func (BatchUpdateRequest) Encode

func (r BatchUpdateRequest) Encode() []byte

Encode implement PostRequest interface

func (BatchUpdateRequest) Url

func (r BatchUpdateRequest) Url() string

Url implement PostRequest interface

type BatchUpdateResponse

type BatchUpdateResponse struct {
	// UpdateCreativeIDs 创意 ID
	UpdateCreativeIDs []uint64 `json:"update_creative_ids,omitempty"`
	// AddCreativeIDs 创意 ID
	AddCreativeIDs []uint64 `json:"add_creative_ids,omitempty"`
}

BatchUpdateResponse 批量修改自定义创意 API Response

type CreateRequest

type CreateRequest struct {
	// AdvertiserID 广告主 ID
	AdvertiserID uint64 `json:"advertiser_id,omitempty"`
	// UnitID 广告组 ID
	UnitID uint64 `json:"unit_id,omitempty"`
	// CreativeName 创意名称
	// 长度为 1-100 字符，同一个广告组下名称不能重复
	CreativeName string `json:"creative_name,omitempty"`
	// PhotoID 视频 ID
	PhotoID string `json:"photo_id,omitempty"`
	// ImageToken 封面图片 token
	// 通过上传图片接口获得，不传值则直接使用视频的首帧作为封面图片，自定义封面的图片宽高要与视频宽高一致
	ImageToken string `json:"image_token,omitempty"`
	// DpaTemplateID DPA模板ID
	// creative_material_type = 14 时，必填。通过DPA 模板信息接口取
	DpaTemplateID uint64 `json:"dpa_template_id,omitempty"`
	// CreativeMaterialType 素材类型
	// 1：竖版视频；2：横版视频；5： 竖版图片（优选/联盟）；6：横版图片(优选/联盟/信息流/快看点)；9：小图(优选/信息流/快看点)；10：组图(优选/信息流/快看点) ；11:开屏视频；12：开屏图片；14：DPA模板（联盟）。搜索广告当前仅支持1、2。直播间直投创意(live_creative_type = 3 或者 (campaign_type = 14 && live_creative_type = 1))时可不传。
	CreativeMaterialType int `json:"creative_material_type,omitempty"`
	// ImageTokens 便利贴单图图片创意 token
	// 便利贴/图片/小图图片创意必填，目前只支持一张图片；组图图片创意需要上传 3 张图片，详细要求见附录
	ImageTokens []string `json:"image_tokens,omitempty"`
	// ActionBarText 行动号召按钮文案
	// 根据计划类型进行设置
	ActionBarText string `json:"action_bar_text,omitempty"`
	// Description 广告语
	// 长度为 1-30 字符，不支持换行。 如果要使用动态词包，格式如"[地区]的[男性女性]都喜欢"， 联盟广告和程序化创意不支持动态词包， 词包名可以通过下方动态词包接口获取
	Description string `json:"description,omitempty"`
	// NewExposeTag 广告标签 2 期
	// 按照相关格式传递两个推荐理由 举例{“text”:"工厂直发"},{"text":"限时专享"}
	NewExposeTag []NewExposeTag `json:"new_expose_tag,omitempty"`
	// ClickTrackURL 第三方点击检测链接
	// 仅当广告组 scene_id 为 1、2、6、7、10 时，可选填； 广告组优化目标为激活时，该字段必填（下载类广告投放的应用集成快手 Android SDK 时除外） 使用 Marketing API 创建时，监测链接使用以该文档为准
	ClickTrackURL string `json:"click_track_url,omitempty"`
	// ImpressionURL 第三方开始播放监测链接
	// 广告组优化目标为激活时，该字段必填（下载类广告投放的应用集成快手 Android SDK 时除外） 使用 Marketing API 创建时，监测链接使用以该文档为准
	ImpressionURL string `json:"impression_url,omitempty"`
	// AdPhotoPlayedT3sURL 第三方有效播放监测链接
	// 白名单功能，且当广告组 scene_id 为 27（开屏） 时不支持该检测链接；与 impression_url 不可同时使用
	AdPhotoPlayedT3sURL string `json:"ad_photo_played_t3s_url,omitempty"`
	// ActionbarClickURL 第三方点击按钮监测链接，命中有效触点白名单表示有效触点监测链接（限：快手主站/极速版场景）
	// 1.校验 click_url 必填的广告场景 优选(1)/信息流(2、7)/上下滑（6） 2.优化目标为激活功能必填点击监测链接,但如果安卓应用接入了快手监测 sdk 就不需要填写监测链接了 3.联盟场景检查 click_url 不能为空 4.若广告联盟的转化目标为激活，click_url、actionbar_click_url 和监测 SDK 至少三选一
	ActionbarClickURL string `json:"actionbar_click_url,omitempty"`
	// CreativeCategory 创意分类
	// 由创意分类查询接口 获得；必须是叶子结点；与创意标签同时传或同时不传 可通过工具-功能名单-获取创意分类标签白名单客户接口获取是否必填。注：不可传入负值
	CreativeCategory int `json:"creative_category,omitempty"`
	// CreativeTag 创意标签
	// 与创意分类参数，要么都传，要么都不传；且单个创意的创意标签最多 10 个；单个创意标签不能为空且不能超过 10 字符，
	CreativeTag []string `json:"creative_tag,omitempty"`
	// LiveCreativeTag 直播类型（粉丝直播推广计划type=16时必填）
	// 3 - 直投直播；4 - 视频引流直播
	LiveCreativeTag int `json:"live_creative_tag,omitempty"`
	// LiveTrackURL 点击监测链接
	// 计划 campaignType=16 粉丝直播推广时可填写
	LiveTrackURL string `json:"live_track_url,omitempty"`
	// DpaStyleTypes 动态商品卡样式
	// 14001-区域服务卡
	DpaStyleTypes []int `json:"dpa_style_types,omitempty"`
	// OuterLoopNative 是否开启原生
	// 1开启，0关闭，不填则默认为0，投放快手信息流广告时（ad_type=0或默认不填，scene_id包含1优选广告位、6上下滑大屏广告、7双列信息流广告），当campaignType=2提升应用安装、5收集销售线索、7提升应用活跃、19推广快手小程序、30快手号-短剧推广时，可开启原生投放。注：投放快手信息流广告且升级白名单账户必选 outer_loop_native = 1，否则会报错
	OuterLoopNative int `json:"outer_loop_native,omitempty"`
	// KOLUserType 原生达人用户类型
	// 1普通快手号原生，2服务号原生，3聚星达人原生，当outer_loop_native=1时此项必填,当 campaignType=30只能填写1普通快手号
	KOLUserType int `json:"kol_user_type,omitempty"`
	// KOLUserID 原生投放目标达人ID
	// 开启原生场景下必传，即当outer_loop_native=1时此项必填， 计划 campaignType=30 短剧推广时，值为短剧作者ID
	KOLUserID uint64 `json:"kol_user_id,omitempty"`
	// Recommendation plc自定义文案
	Recommendation string `json:"recommendation,omitempty"`
	// HigLightFlash 高光创意状态
	// 0：关闭 1：开启
	HighLightFlash int `json:"high_light_flash,omitempty"`
	// SplashPhotoIDs 开屏视频 id
	// creative_material_type 为 11 时必填，使用上传视频接口时返回的 photo_id；即素材类型是开屏视频时，必须传入全尺寸的 4 条视频，具体参考素材层级接口
	SplashPhotoIDs []string `json:"splash_photo_ids,omitempty"`
	// SplashImageTokens 开屏图片 token
	// creative_material_type 为 12 时必填，使用上传图片接口时返回的 image_token，素材类型是开屏图片时，必须传入全尺寸的 6 张图片，具体参考素材层级接口
	SplashImageTokens []string `json:"splash_image_tokens,omitempty"`
	// MaterialIntelligentOptimize 素材智能优化开关
	// 0-关闭，1-开启，不传默认关闭。仅白名单用户可以使用。
	MaterialIntelligentOptimize int `json:"material_intelligent_optimize,omitempty"`
}

CreateRequest 创建自定义创意 API Request

func (CreateRequest) Encode

func (r CreateRequest) Encode() []byte

Encode implement PostRequest interface

func (CreateRequest) Url

func (r CreateRequest) Url() string

Url implement PostRequest interface

type CreateResponse

type CreateResponse struct {
	// CreativeID 创意 ID
	CreativeID uint64 `json:"creative_id,omitempty"`
}

CreateResponse 创建自定义创意 API Response

type Creative

type Creative struct {
	// CampaignID 广告计划 ID
	CampaignID uint64 `json:"campaign_id,omitempty"`
	// UnitID 广告组ID
	UnitID uint64 `json:"unit_id,omitempty"`
	// CreativeID 创意 ID
	CreativeID uint64 `json:"creative_id,omitempty"`
	// CreativeName 创意名称
	CreativeName string `json:"creative_name,omitempty"`
	// CreativeMaterialType 素材类型
	// 1：竖版视频；2：横版视频；5： 竖版图片（优选/联盟）；6：横版图片(优选/联盟/信息流/快看点)；9：小图(优选/信息流/快看点)；10：组图(优选/信息流/快看点) ；11:开屏视频；12：开屏图片；14：DPA模板（联盟）。搜索广告当前仅支持1、2。直播间直投创意(live_creative_type = 3 或者 (campaign_type = 14 && live_creative_type = 1))时可不传。
	CreativeMaterialType int `json:"creative_material_type,omitempty"`
	// CreativeCategory 创意分类
	// 由创意分类查询接口 获得；必须是叶子结点；与创意标签同时传或同时不传 可通过工具-功能名单-获取创意分类标签白名单客户接口获取是否必填。注：不可传入负值
	CreativeCategory int `json:"creative_category,omitempty"`
	// CreativeTag 创意标签
	// 与创意分类参数，要么都传，要么都不传；且单个创意的创意标签最多 10 个；单个创意标签不能为空且不能超过 10 字符，
	CreativeTag []string `json:"creative_tag,omitempty"`
	// PhotoID 视频 ID
	PhotoID string `json:"photo_id,omitempty"`
	// PhtoMD5 视频作品的md5
	PhotoMD5 string `json:"photo_md5,omitempty"`
	// MaterialURL 单图创意 url
	MaterialURL []string `json:"material_url,omitempty"`
	// ImageTokens 单图创意 image_token
	ImageTokens []string `json:"image_tokens,omitempty"`
	// Status 广告创意状态（优先先看这个状态,计算结果）
	// -1：不限，1：计划已暂停，3：计划超预算，6：余额不足，11：组审核中，12：组审核未通过，14：已结束，15：组已暂停，17：组超预算，19：未达投放时间，40：已删除，41：审核中，42：审核未通过，46：已暂停，52：投放中，53：作品异常，54：视频审核通过可投放滑滑场景，55：部分素材审核失败
	Status int `json:"status,omitempty"`
	// PutStatus 投放状态（操作结果）
	// 	1：投放中；2：暂停 3：删除
	PutStatus int `json:"put_status,omitempty"`
	// ReviewDetail 审核拒绝理由
	ReviewDetail string `json:"review_detail,omitempty"`
	// ReviewVideoSnapshot 审核拒绝图片
	// list 里面可以包含多个数据
	ReviewVideoSnapshot []string `json:"review_video_snapshot,omitempty"`
	// CoverURL 封面 URL
	CoverURL string `json:"cover_url,omitempty"`
	// ImageToken 视频封面 token
	// 若创意使用系统自动生成的首帧图片作为封面，该 token 无法复用
	ImageToken string `json:"image_token,omitempty"`
	// CoverWidth 封面图宽度
	CoverWidth int64 `json:"cover_width,omitempty"`
	// CoverHeight 封面图高度
	CoverHeight int64 `json:"cover_height,omitempty"`
	// OverlayBgURL 动态词包原始封面图片 URL
	OverlayBgURL string `json:"overlay_bg_url,omitempty"`
	// OverlayBgImageToken 动态词包原始封面图片 token
	OverlayBgImageToken string `json:"overlay_bg_image_token,omitempty"`
	// StickerTitle 封面广告语标题
	StickerTitle string `json:"sticker_title,omitempty"`
	// OverlayType 贴纸样式类型
	OverlayType string `json:"overlay_type,omitempty"`
	// DisplayInfo 广告展示信息
	DisplayInfo *DisplayInfo `json:"display_info,omitempty"`
	// ShortSlogen 便利贴创意短广告语
	ShortSlogen string `json:"short_slogen,omitempty"`
	// ExposeTag 广告标签
	ExposeTag string `json:"expose_tag,omitempty"`
	// NewExposeTag 广告标签 2 期
	NewExposeTag []NewExposeTag `json:"new_expose_tag,omitempty"`
	// ClickTrackURL 点击监测链接
	ClickTrackURL string `json:"click_track_url,omitempty"`
	// ImpressionURL 第三方开始播放监测链接
	// 广告组优化目标为激活时，该字段必填（下载类广告投放的应用集成快手 Android SDK 时除外） 使用 Marketing API 创建时，监测链接使用以该文档为准
	ImpressionURL string `json:"impression_url,omitempty"`
	// AdPhotoPlayedT3sURL 第三方有效播放监测链接
	// 白名单功能，且当广告组 scene_id 为 27（开屏） 时不支持该检测链接；与 impression_url 不可同时使用
	AdPhotoPlayedT3sURL string `json:"ad_photo_played_t3s_url,omitempty"`
	// ActionbarClickURL 第三方点击按钮监测链接，命中有效触点白名单表示有效触点监测链接（限：快手主站/极速版场景）
	// 1.校验 click_url 必填的广告场景 优选(1)/信息流(2、7)/上下滑（6） 2.优化目标为激活功能必填点击监测链接,但如果安卓应用接入了快手监测 sdk 就不需要填写监测链接了 3.联盟场景检查 click_url 不能为空 4.若广告联盟的转化目标为激活，click_url、actionbar_click_url 和监测 SDK 至少三选一
	ActionbarClickURL string `json:"actionbar_click_url,omitempty"`
	// CreateTime 创建时间
	// 格式样例："2019-06-11 15:17:25"
	CreateTime string `json:"create_time,omitempty"`
	// UpdateTime 最后修改时间
	UpdateTime string `json:"update_time,omitempty"`
	// PicID 图片库图片
	PicID string `json:"pic_id,omitempty"`
	// AppGradeType 审核分级类型
	// 0：默认；1：审核降级(当创意发生降级时，会限制部分流量无法投放)
	AppGradeType int `json:"app_grade_type,omitempty"`
	// SplashPhotos 开屏视频信息
	// creative_material_type 为 11 时
	SplashPhotos []SplashPhoto `json:"splash_photos,omitempty"`
	// LiveCreativeType 粉丝直播推广创意类型
	// 3：直投直播；4：作品引流
	LiveCreativeType int `json:"live_creative_type,omitempty"`
	// SplashPictures 开屏图片
	// creative_material_type 为 12 时
	SplashPictures []SplashPicture `json:"splash_pictures,omitempty"`
	// LiveTrackURL 点击监测链接
	// 计划 campaignType=16 粉丝直播推广时填写
	LiveTrackURL string `json:"live_track_url,omitempty"`
	// AdType 广告计划类型
	// 0:信息流，1:搜索
	AdType int `json:"ad_type,omitempty"`
	// OuterLoopNative 是否开启原生
	// 0关闭，1开启，不填默认为0
	OuterLoopNative int `json:"outer_loop_native,omitempty"`
	// KOLUserType 原生达人用户类型
	// 1普通快手号原生，2服务号原生，3聚星达人原生，当outer_loop_native=1时此项必填,当 campaignType=30只能填写1普通快手号
	KOLUserType int `json:"kol_user_type,omitempty"`
	// KOLUserID 原生投放目标达人ID
	// 开启原生场景下必传，即当outer_loop_native=1时此项必填， 计划 campaignType=30 短剧推广时，值为短剧作者ID
	KOLUserID uint64 `json:"kol_user_id,omitempty"`
	// Recommendation plc自定义文案
	Recommendation string `json:"recommendation,omitempty"`
	// DpaStyleTypes 动态商品卡样式
	DpaStyleTypes []int `json:"dpa_style_types,omitempty"`
	// HigLightFlash 高光创意状态
	// 0：关闭 1：开启
	HighLightFlash int `json:"high_light_flash,omitempty"`
	// MaterialIntelligentOptimize 素材智能优化开关
	// 0-关闭，1-开启，不传默认关闭。仅白名单用户可以使用。
	MaterialIntelligentOptimize int `json:"material_intelligent_optimize,omitempty"`
	// CreativeMode 创意生成模式
	// 0：默认-普通模式 1：AIGC生成
	CreativeMode int `json:"creative_mode,omitempty"`
	// OpenAccountNative 是否为原生扩量
	// 0：否 1：是
	OpenAccountNative int `json:"open_account_native,omitempty"`
}

Creative 自定义创意

type DisplayInfo

type DisplayInfo struct {
	// Description 广告语
	Description string `json:"description,omitempty"`
	// ActionBarText 行动号召按钮文案
	ActionBarText string `json:"action_bar_text,omitempty"`
}

DisplayInfo 广告展示信息

type ListRequest

type ListRequest struct {
	// AdvertiserID 广告主 ID
	AdvertiserID uint64 `json:"advertiser_id,omitempty"`
	// CampaignID 广告计划 ID
	// 过滤筛选条件，若不传或传空则视为无限制条件
	CampaignID uint64 `json:"campaign_id,omitempty"`
	// UnitID 广告组ID
	// 过滤筛选条件，若不传或传空则视为无限制条件
	UnitID uint64 `json:"unit_id,omitempty"`
	// CreativeID 创意 ID
	// 过滤筛选条件，若不传或传空则视为无限制条件
	CreativeID uint64 `json:"creative_id,omitempty"`
	// CreativeName 创意名称
	// 过滤筛选条件，支持模糊搜索 精确查询
	CreativeName string `json:"creative_name,omitempty"`
	// CreativeIDs 广告创意 ID 集
	// 不超过 100 个
	CreativeIDs []uint64 `json:"creative_ids,omitempty"`
	// Status 广告创意状态
	// 过滤筛选条件； -2:不限,40:只包含已删除 不传：所有不包含已删除 其他值无效
	Status int `json:"status,omitempty"`
	// StartDate 开始时间
	// 与 end_date 同时传或同时不传；过滤筛选条件，格式为"yyyy-MM-dd"，参数值对应 update_time 信息
	StartDate string `json:"start_date,omitempty"`
	// EndDate 结束时间
	// 与 start_date 同时传或同时不传；过滤筛选条件，格式为"yyyy-MM-dd"，参数值对应 update_time 信息
	EndDate string `json:"end_date,omitempty"`
	// TimeFilterType 按创建时间或者更新时间进行筛选
	// 1.如传入此字段时不传"start_date"，与"end_date"字段，则不根据时间筛选。2.传入"start_date"，与"end_date"字段，且此字段为 1 时，按照创建时间进行筛选。3.传入"start_date"，与"end_date"字段，此字段不传，或传值为 0 时，则按照更新时间进行筛选
	TimeFilterType int `json:"time_filter_type,omitempty"`
	// Page 请求的页码数, 默认为 1
	Page int `json:"page,omitempty"`
	// PageSize 请求的每页行数, 默认为 20
	PageSize int `json:"page_size,omitempty"`
	// PutStatusList 创意投放状态
	// 1：投放；2：暂停；3：删除。备注：传了该参数会覆盖status参数筛选，因为二者是相同筛选项
	PutStatusList []int `json:"put_status_list,omitempty"`
}

ListRequest 查询自定义创意 API Request

func (ListRequest) Encode

func (r ListRequest) Encode() []byte

Encode implement PostRequest interface

func (ListRequest) Url

func (r ListRequest) Url() string

Url implement PostRequest interface

type ListResponse

type ListResponse struct {
	TotalCount int        `json:"total_count,omitempty"`
	Details    []Creative `json:"details,omitempty"`
}

ListResponse 查询自定义创意 API Response

type NewExposeTag

type NewExposeTag struct {
	// Text 广告标签text
	Text string `json:"text,omitempty"`
	// URL 广告标签url
	URL string `json:"url,omitempty"`
}

NewExposeTag 广告标签 2 期

type Photo

type Photo struct {
	// PhotoID 视频 ID
	PhotoID uint64 `json:"photo_id,omitempty"`
	// CoverImageToken 封面图片 token
	// 通过上传图片接口获得，不传值则直接使用视频的首帧作为封面图片，自定义封面的图片宽高要与视频宽高一致，使用智能抽帧时不需要传递。
	CoverImageToken string `json:"cover_image_token,omitempty"`
	// CreativeMaterialType 素材类型
	// 1：竖版视频 2：横版视频
	CreativeMaterialType int `json:"creative_material_type,omitempty"`
}

Photo 素材

type PreviewRequest

type PreviewRequest struct {
	// AdvertiserID 广告主id
	AdvertiserID uint64 `json:"advertiser_id,omitempty"`
	// UserIDs 快手id; 一次不超过十个
	UserIDs []string `json:"user_ids,omitempty"`
	// CreativeID 创意id; unit_type为4时，必填
	CreativeID uint64 `json:"creative_id,omitempty"`
	// UnitID 组id; unit_type为7时，必填
	UnitID uint64 `json:"unit_id,omitempty"`
	// UnitType 组类型; 4：自定义创意 7：程序化创意2.0
	UnitType int `json:"unit_type,omitempty"`
	// Phones 用户要推送创意到哪个手机号; 原本是传userId，由于允许邮箱开户后，不一定每个userId都有手机号，所以改成传手机号
	Phones []string `json:"phones,omitempty"`
}

PreviewRequest 创意体验 API Request

func (PreviewRequest) Encode

func (r PreviewRequest) Encode() []byte

Encode implement PostRequest interface

func (PreviewRequest) Url

func (r PreviewRequest) Url() string

Url implement PostRequest interface

type SplashPhoto

type SplashPhoto struct {
	// PhotoID 视频ID
	PhotoID string `json:"photo_id,omitempty"`
	// PhotoMD5 视频的md5
	PhotoMD5 string `json:"photo_md5,omitempty"`
	// Width 视频高度
	Width int64 `json:"width,omitempty"`
	// Height 视频宽度
	Height int64 `json:"height,omitempty"`
}

SplashPhoto 开屏视频信息

type SplashPicture

type SplashPicture struct {
	// CoverID 封面ID
	CoverID uint64 `json:"cover_id,omitempty"`
	// CoverURL 封面URL
	CoverURL string `json:"cover_url,omitempty"`
	// Height 图片高度
	Height int64 `json:"height,omitempty"`
	// Width 图片宽度
	Width int64 `json:"width,omitempty"`
}

SplashPicture 开屏图片

type UpdateRequest

type UpdateRequest struct {
	// AdvertiserID 广告主 ID
	AdvertiserID uint64 `json:"advertiser_id,omitempty"`
	// CreativeID 广告创意 ID
	CreativeID uint64 `json:"creative_id,omitempty"`
	// CreativeName 创意名称
	// 长度为 1-100 字符，同一个广告组下名称不能重复
	CreativeName string `json:"creative_name,omitempty"`
	// PhotoID 视频 ID
	PhotoID string `json:"photo_id,omitempty"`
	// ImageToken 封面图片 token
	// 通过上传图片接口获得，不传值则直接使用视频的首帧作为封面图片，自定义封面的图片宽高要与视频宽高一致
	ImageToken string `json:"image_token,omitempty"`
	// DpaTemplateID DPA模板ID
	// creative_material_type = 14 时，必填。通过DPA 模板信息接口取
	DpaTemplateID uint64 `json:"dpa_template_id,omitempty"`
	// ImageTokens 便利贴单图图片创意 token
	// 便利贴/图片/小图图片创意必填，目前只支持一张图片；组图图片创意需要上传 3 张图片，详细要求见附录
	ImageTokens []string `json:"image_tokens,omitempty"`
	// ActionBarText 行动号召按钮文案
	// 根据计划类型进行设置
	ActionBarText string `json:"action_bar_text,omitempty"`
	// Description 广告语
	// 长度为 1-30 字符，不支持换行。 如果要使用动态词包，格式如"[地区]的[男性女性]都喜欢"， 联盟广告和程序化创意不支持动态词包， 词包名可以通过下方动态词包接口获取
	Description string `json:"description,omitempty"`
	// NewExposeTag 广告标签 2 期
	// 按照相关格式传递两个推荐理由 举例{“text”:"工厂直发"},{"text":"限时专享"}
	NewExposeTag []NewExposeTag `json:"new_expose_tag,omitempty"`
	// ClickTrackURL 第三方点击检测链接
	// 仅当广告组 scene_id 为 1、2、6、7、10 时，可选填； 广告组优化目标为激活时，该字段必填（下载类广告投放的应用集成快手 Android SDK 时除外） 使用 Marketing API 创建时，监测链接使用以该文档为准
	ClickTrackURL string `json:"click_track_url,omitempty"`
	// ImpressionURL 第三方开始播放监测链接
	// 广告组优化目标为激活时，该字段必填（下载类广告投放的应用集成快手 Android SDK 时除外） 使用 Marketing API 创建时，监测链接使用以该文档为准
	ImpressionURL string `json:"impression_url,omitempty"`
	// AdPhotoPlayedT3sURL 第三方有效播放监测链接
	// 白名单功能，且当广告组 scene_id 为 27（开屏） 时不支持该检测链接；与 impression_url 不可同时使用
	AdPhotoPlayedT3sURL string `json:"ad_photo_played_t3s_url,omitempty"`
	// ActionbarClickURL 第三方点击按钮监测链接，命中有效触点白名单表示有效触点监测链接（限：快手主站/极速版场景）
	// 1.校验 click_url 必填的广告场景 优选(1)/信息流(2、7)/上下滑（6） 2.优化目标为激活功能必填点击监测链接,但如果安卓应用接入了快手监测 sdk 就不需要填写监测链接了 3.联盟场景检查 click_url 不能为空 4.若广告联盟的转化目标为激活，click_url、actionbar_click_url 和监测 SDK 至少三选一
	ActionbarClickURL string `json:"actionbar_click_url,omitempty"`
	// LiveTrackURL 点击监测链接
	// 计划 campaignType=16 粉丝直播推广时可填写
	LiveTrackURL string `json:"live_track_url,omitempty"`
	// CreativeCategory 创意分类
	// 由创意分类查询接口 获得；必须是叶子结点；与创意标签同时传或同时不传 可通过工具-功能名单-获取创意分类标签白名单客户接口获取是否必填。注：不可传入负值
	CreativeCategory int `json:"creative_category,omitempty"`
	// CreativeTag 创意标签
	// 与创意分类参数，要么都传，要么都不传；且单个创意的创意标签最多 10 个；单个创意标签不能为空且不能超过 10 字符，
	CreativeTag []string `json:"creative_tag,omitempty"`
	// CreativeMaterialType 素材类型
	// 1：竖版视频；2：横版视频；5： 竖版图片（优选/联盟）；6：横版图片(优选/联盟/信息流/快看点)；9：小图(优选/信息流/快看点)；10：组图(优选/信息流/快看点) ；11:开屏视频；12：开屏图片。搜索广告当前仅支持1、2
	CreativeMaterialType int `json:"creative_material_type,omitempty"`
	// SplashPhotoIDs 开屏视频 id
	// creative_material_type 为 11 时必填，使用上传视频接口时返回的 photo_id；即素材类型是开屏视频时，必须传入全尺寸的 4 条视频，具体参考素材层级接口
	SplashPhotoIDs []string `json:"splash_photo_ids,omitempty"`
	// SplashImageTokens 开屏图片 token
	// creative_material_type 为 12 时必填，使用上传图片接口时返回的 image_token，素材类型是开屏图片时，必须传入全尺寸的 6 张图片，具体参考素材层级接口
	SplashImageTokens []string `json:"splash_image_tokens,omitempty"`
	// MaterialIntelligentOptimize 素材智能优化开关
	// 0-关闭，1-开启，不传默认关闭。仅白名单用户可以使用。
	MaterialIntelligentOptimize *int `json:"material_intelligent_optimize,omitempty"`
}

UpdateRequest 修改自定义创意 API Request

func (UpdateRequest) Encode

func (r UpdateRequest) Encode() []byte

Encode implement PostRequest interface

func (UpdateRequest) Url

func (r UpdateRequest) Url() string

Url implement PostRequest interface

type UpdateResponse

type UpdateResponse struct {
	// CreativeID 创意 ID
	CreativeID uint64 `json:"creative_id,omitempty"`
}

UpdateResponse 修改自定义创意 API Response

type UpdateStatusRequest

type UpdateStatusRequest struct {
	// AdvertiserID 广告主ID
	AdvertiserID int64 `json:"advertiser_id,omitempty"`
	// CreativeID 广告创意ID
	CreativeID uint64 `json:"creative_id,omitempty"`
	// CreativeIDs 与原有的creative_id字段可以同时填，也可以只填一个; 1.传入的创意id不得重复，且至少有一个;传入的创意id总数最多20个。2.put_status为3时，会删除所有创意
	CreativeIDs []uint64 `json:"creative_ids,omitempty"`
	// PutStatus 操作码; 1-投放、2-暂停、3-删除，传其他数字非法
	PutStatus int `json:"put_status,omitempty"`
}

UpdateStatusRequest 修改创意状态 API Request

func (UpdateStatusRequest) Encode

func (r UpdateStatusRequest) Encode() []byte

Encode implement PostRequest interface

func (UpdateStatusRequest) Url

func (r UpdateStatusRequest) Url() string

Url implement PostRequest interface

type UpdateStatusResponse

type UpdateStatusResponse struct {
	// CreativeIDs 所有修改状态成功的创意id; 假如接口的入参 creative_id传了值且修改状态成功，则此创意id也会包含在返回值creative_ids里面
	CreativeIDs []uint64 `json:"creative_ids,omitempty"`
}

UpdateStatusResponse 修改创意状态 API Response