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 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 Read(clt *core.SDKClient, accessToken string, req *creative.ReadRequest) (*creative.CreativeDetail, 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)

* 每个计划下程序化创意和自定义创意为二选一，且无法修改 * 程序化创意: 最多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)

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

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 Read

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

Read 创意详细信息

func UpdateStatus

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

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