creative

package
v1.9.16 Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: Dec 28, 2022 License: Apache-2.0 Imports: 2 Imported by: 0

Documentation

Overview

Package creative 广告创意模块API

Index

Constants

This section is empty.

Variables

This section is empty.

Functions

func Create added in v1.5.0

func Create(clt *core.SDKClient, accessToken string, req *creative.CreateRequest) (*creative.CreateResponseData, error)

Create 创建广告创意 此接口用于创建广告创意,对于搜索广告的创建可参照【搜索广告投放】

创意包括了首选投放位置、基础创意、创意分类、监测链接等信息,对于其中的概念解释可以参考:【广告创意】 创意创建涉及了多个资产管理:素材管理、落地页管理等,开发者需要提前根据开放接口构建这些资产功能,以免创建计划卡住 不同首选投放位置支持素材类型不同,具体可参考:【广告位与素材类型支持关系】 如果创建创意遇到问题,可参考 常见问题

* 每个计划下程序化创意和自定义创意为二选一,且无法修改 * 程序化创意: 最多10个标题、12个图片素材和10个视频素材;如果创建的是程序化创意(程序化创意实际会按照传入的title_list和image_list进行组合,对于效果不好的组合无法通过审核,获取到的都是审核通过的创意),只有在审核之后才会获取到创意数据与创意id * 自定义创意限制计划不能超过10个创意 * 每日最多创建500个创意(自定义创意+程序化创意) * 素材类型:不同广告位要求素材类型不同,其中每一种【素材类型】都有自己的规格,请传入符合要求的素材,否则会报错 * 其中视频的时长需要>=4s,否则会报错 * 监测链接:当在计划纬度设置了转化id,如果在创建创意时不传监测链接,会自动获取转化id里监测链接;如果在创建(更新)创意时传入对应的监测链接,会取传入的监测链接,但是对于应用下载推广,即便主动传入点击监测链接,也会取转化id监测链接 * 对于不打算传的字段,不要传“”或者null,传了会校验 * 如果计划ID下已有创意信息,需要使用update_v2接口进行修改或者新增创意素材,否则会报错

func CustomCreativeCreate added in v1.5.0

新版接口新增落地页,小程序等相关入参 下线推广卡片,附加创意等相关字段,替换为创意组件形式传入 投放位置与监测链接变更为计划接口传入 每个广告主每日最多创建500个创意(自定义创意+程序化创意) 其中视频的时长需要>=4s,否则会报错 对于不打算传的字段,不要传“”或者null,传了会校验 如果计划ID下已有创意信息,需要使用update_v2接口进行修改或者新增创意素材,否则会报错

func CustomCreativeUpdate added in v1.5.0

CustomCreativeUpdate 修改自定义创意 当计划下有创意时,需要通过此接口进行全量更新与创建创意(可以先通过创意详细信息接口获取全部信息在进行更新)

全量更新解释

全量更新即为最新一次更新将覆盖前一次的所有信息,例如:如果已有三个创意A、B、C,更新提交了创意B、C、D,则意味着覆盖删除创意A,新增了D,保留(或修改)了B、C 对于新建的创意,不需要上传创意ID,会生成新的创意ID;对于您希望保留的创意,不要忘记上传创意ID,否则将被覆盖 新版营销链路广告创意差异点

新版接口新增落地页,小程序等相关入参 下线推广卡片,附加创意等相关字段,替换为创意组件形式传入 投放位置与监测链接变更为计划接口传入 触发审核场景

在修改用户端可见的内容包括标题、图片/视频、来源、附加创意、落地页链接等时会触发审核; 对于广告位的修改有以下情况也会触发审核:①选择了网盟广告位然后增加头条广告位;②选择了头条广告位然后增加抖音广告位;这两种情况都会触发审核。其他情况比如选了头条广告位再增加火山、西瓜不会触发审核。 每个计划下程序化创意和自定义创意为二选一,且无法修改 每日最多创建500个创意(自定义创意+程序化创意) 其中视频的时长需要>=4s,否则会报错 对于不打算传的字段,不要传“”或者null,传了会校验 注意字段默认值,如果更新时候未传入带有默认值的字段,将以默认值为准

func DetailGet added in v1.8.17

func DetailGet(clt *core.SDKClient, accessToken string, req *creative.DetailGetRequest) (*creative.CreativeDetailV2, error)

DetailGet 创意详细信息(新)

func Get

func Get(clt *core.SDKClient, accessToken string, req *creative.GetRequest) (*creative.GetResponseData, error)

Get 获取创意列表

func MaterialRead

func MaterialRead(clt *core.SDKClient, accessToken string, req *creative.MaterialReadRequest) ([]creative.Material, error)

MaterialRead 创意素材信息

func ProceduralCreativeCreate added in v1.6.9

func ProceduralCreativeCreate(clt *core.SDKClient, accessToken string, req *creative.ProceduralCreativeCreateRequest) error

ProceduralCreativeCreate 创建程序化创意(营销链路) 此接口用于创建程序化广告创意

创意包括了基础创意、创意素材、创意分类等信息,对于其中的概念解释可以参考:【广告创意】 创意创建涉及了多个资产管理:素材管理、落地页管理等;开发者需要提前根据开放接口构建这些资产功能,以免创建计划卡住 新版营销链路广告创意差异点

新版接口新增落地页,小程序等相关入参 下线推广卡片,附加创意等相关字段,替换为创意组件形式传入 投放位置与监测链接变更为计划接口传入 每个计划下程序化创意和自定义创意为二选一,且无法修改 程序化创意(程序化创意实际会按照传入的title_list和image_list进行组合,对于效果不好的组合无法通过审核,获取到的都是审核通过的创意),只有在审核之后才会获取到创意数据与创意id 每个广告主每日最多创建500个创意(自定义创意+程序化创意) 其中视频的时长需要>=4s,否则会报错 对于不打算传的字段,不要传“”或者null,传了会校验 如果计划ID下已有创意信息,需要使用update_v2接口进行修改或者新增创意素材,否则会报错

func ProceduralCreativeUpdate added in v1.6.9

func ProceduralCreativeUpdate(clt *core.SDKClient, accessToken string, req *creative.ProceduralCreativeUpdateRequest) error

ProceduralCreativeUpdate 修改程序化创意(营销链路) 此接口用于全量更新广告程序化创意: 当计划下有创意时,需要通过此接口进行全量更新与创建创意(可以先通过创意详细信息接口获取全部信息在进行更新)

全量更新解释

全量更新即为最新一次更新将覆盖前一次的所有信息,例如:如果已有三个创意A、B、C,更新提交了创意B、C、D,则意味着覆盖删除创意A,新增了D,保留(或修改)了B、C 对于新建的创意,不需要上传创意ID,会生成新的创意ID;对于您希望保留的创意,不要忘记上传创意ID,否则将被覆盖 新版营销链路广告创意差异点

新版接口新增落地页,小程序等相关入参 下线推广卡片,附加创意等相关字段,替换为创意组件形式传入 投放位置与监测链接变更为计划接口传入 触发审核场景

在修改用户端可见的内容包括标题、图片/视频、来源、附加创意、落地页链接等时会触发审核; 对于广告位的修改有以下情况也会触发审核:①选择了网盟广告位然后增加头条广告位;②选择了头条广告位然后增加抖音广告位;这两种情况都会触发审核。其他情况比如选了头条广告位再增加火山、西瓜不会触发审核。 每个计划下程序化创意和自定义创意为二选一,且无法修改 每日最多创建500个创意(自定义创意+程序化创意) 其中视频的时长需要>=4s,否则会报错 对于不打算传的字段,不要传“”或者null,传了会校验 注意字段默认值,如果更新时候未传入带有默认值的字段,将以默认值为准

func Read

func Read(clt *core.SDKClient, accessToken string, req *creative.ReadRequest) (*creative.CreativeDetail, error)

Read 创意详细信息

func RejectReason added in v1.6.9

func RejectReason(clt *core.SDKClient, accessToken string, req *creative.RejectReasonRequest) ([]creative.RejectReason, error)

RejectReason 获取创意审核建议 此接口用于获取创意审核建议; 所有的程序化创意都是审核通过的; 如果获取创意遇到问题,可通过 常见问题 来解决

func Update added in v1.6.1

func Update(clt *core.SDKClient, accessToken string, req *creative.UpdateRequest) (*creative.CreateResponseData, error)

Update 修改创意信息 此接口用于全量更新广告创意:当计划下有创意时,需要通过此接口进行全量更新与创建创意(可以先通过创意详细信息接口获取全部信息在进行更新) 创意包括了首选位置、基础创意、创意分类、监测链接等信息,对于其中的概念解释可以参考:【广告创意】 如果创建创意遇到问题,可通过 常见问题 来解决; 如果计划ID下已有创意信息,需要使用update_v2接口进行修改或者新增创意素材,否则会报错 全量更新解释: 全量更新即为最新一次更新将覆盖前一次的所有信息,例如:如果已有三个创意A、B、C,更新提交了创意B、C、D,则意味着覆盖删除创意A,新增了D,保留(或修改)了B、C; 对于新建的创意,不需要上传创意ID,会生成新的创意ID;对于您希望保留的创意,不要忘记上传创意ID,否则将被覆盖; 注意: 每个计划下程序化创意和自定义创意为二选一,且无法修改; 程序化创意: 最多10个标题、12个图片素材和10个视频素材;如果创建的是程序化创意(程序化创意实际会按照传入的title_list和image_list进行组合,对于效果不好的组合无法通过审核,获取到的都是审核通过的创意),只有在审核之后才会获取到创意数据与创意id; 自定义创意限制计划下不能超过10个创意,且每日最多创建500个自定义创意。 素材类型:不同广告未要求素材类型不同,其中每一种素材类型都有自己的规格,请传入符合要求的素材,否则会报错! 其中视频的时长需要>=4s,否则会报错! 监测链接:当在计划纬度设置了转化id,如果在创建创意时不传监测链接,会自动获取转化id里监测链接;如果在创建(更新)创意时传入对应的监测链接,会取传入的监测链接,但是对于应用下载推广,即便主动传入点击监测链接,也会取转化id监测链接; 创建之后:素材类型、附加创意类型、品牌主页、数据发送方式不能进行修改; 对于不打算传的字段,不要传“”或者null,传了会校验!!! 触发审核 在修改用户端可见的内容包括标题、图片/视频、来源、附加创意、落地页链接等时会触发审核; 对于广告位的修改有以下情况也会触发审核:①选择了网盟广告位然后增加头条广告位;②选择了头条广告位然后增加抖音广告位;这两种情况都会触发审核。其他情况比如选了头条广告位再增加火山、西瓜不会触发审核。;

func UpdateStatus added in v1.5.0

func UpdateStatus(clt *core.SDKClient, accessToken string, req *creative.UpdateStatusRequest) (*creative.UpdateResponseData, error)

UpdateStatus 更新创意状态 不可以操作已删除创意的状态,且程序化创意不能进行单独操作,需要从计划纬度进行操作 本接口为批量更新接口,调用结果针对单个创意存在部分成功部分失败场景,请避免根据应答code字段直接判断创意状态更新的结果

Types

This section is empty.

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL