creative

Documentation

Overview

Package creative 广告创意模块API

Index

• func Create(clt *core.SDKClient, accessToken string, req *creative.CreateRequest) (*creative.CreateResponseData, error)
• func CustomCreativeCreate(clt *core.SDKClient, accessToken string, ...) (*creative.CustomCreativeCreateResponseData, error)
• func CustomCreativeUpdate(clt *core.SDKClient, accessToken string, ...) (*creative.CustomCreativeCreateResponseData, error)
• func DetailGet(clt *core.SDKClient, accessToken string, req *creative.DetailGetRequest) (*creative.CreativeDetailV2, error)
• func Get(clt *core.SDKClient, accessToken string, req *creative.GetRequest) (*creative.GetResponseData, error)
• func MaterialRead(clt *core.SDKClient, accessToken string, req *creative.MaterialReadRequest) ([]creative.Material, error)
• func ProceduralCreativeCreate(clt *core.SDKClient, accessToken string, ...) error
• func ProceduralCreativeUpdate(clt *core.SDKClient, accessToken string, ...) error
• func Read(clt *core.SDKClient, accessToken string, req *creative.ReadRequest) (*creative.CreativeDetail, error)
• func RejectReason(clt *core.SDKClient, accessToken string, req *creative.RejectReasonRequest) ([]creative.RejectReason, error)
• func Update(clt *core.SDKClient, accessToken string, req *creative.UpdateRequest) (*creative.CreateResponseData, error)
• func UpdateStatus(clt *core.SDKClient, accessToken string, req *creative.UpdateStatusRequest) (*creative.UpdateResponseData, error)

Functions

func Create

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

func CustomCreativeCreate(clt *core.SDKClient, accessToken string, req *creative.CustomCreativeCreateRequest) (*creative.CustomCreativeCreateResponseData, error)

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

func CustomCreativeUpdate

func CustomCreativeUpdate(clt *core.SDKClient, accessToken string, req *creative.CustomCreativeUpdateRequest) (*creative.CustomCreativeCreateResponseData, error)

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

全量更新解释

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

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

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

func DetailGet

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

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

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

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

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

func Update

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

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

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