Documentation ¶
Overview ¶
Package creative 广告创意
Index ¶
- type AdvancedCreative
- type AdvancedCreativeCreateRequest
- type AdvancedCreativeCreateResponse
- type AdvancedCreativeListRequest
- type AdvancedCreativeListResponse
- type AdvancedCreativeUpdateRequest
- type AdvancedCreativeUpdateResponse
- type BatchUpdateRequest
- type BatchUpdateResponse
- type CreateRequest
- type CreateResponse
- type Creative
- type DisplayInfo
- type ListRequest
- type ListResponse
- type NewExposeTag
- type Photo
- type PreviewRequest
- type SplashPhoto
- type SplashPicture
- type UpdateRequest
- type UpdateResponse
- type UpdateStatusRequest
- type UpdateStatusResponse
Constants ¶
This section is empty.
Variables ¶
This section is empty.
Functions ¶
This section is empty.
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"` // 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"` // 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"` // 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
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
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 string `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
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