ad

Documentation

Overview

Package ad 广告组相关API

Index

• func CostProtectStatusGet(ctx context.Context, clt *core.SDKClient, accessToken string, ...) ([]ad.CostProtectStatus, error)
• func Create(ctx context.Context, clt *core.SDKClient, accessToken string, ...) (uint64, error)
• func Get(ctx context.Context, clt *core.SDKClient, accessToken string, ...) (*ad.GetResponseData, error)
• func RejectReason(ctx context.Context, clt *core.SDKClient, accessToken string, ...) ([]ad.RejectReason, error)
• func Update(ctx context.Context, clt *core.SDKClient, accessToken string, ...) (*ad.UpdateResponseData, error)
• func UpdateBid(ctx context.Context, clt *core.SDKClient, accessToken string, ...) (*ad.UpdateResponseData, error)
• func UpdateBudget(ctx context.Context, clt *core.SDKClient, accessToken string, ...) (*ad.UpdateResponseData, error)
• func UpdateStatus(ctx context.Context, clt *core.SDKClient, accessToken string, ...) (*ad.UpdateResponseData, error)

Functions

func CostProtectStatusGet

func CostProtectStatusGet(ctx context.Context, clt *core.SDKClient, accessToken string, req *ad.CostProtectStatusGetRequest) ([]ad.CostProtectStatus, error)

CostProtectStatusGet 批量获取计划成本保障状态 获取成本保障状态及时同步广告主计划投放状态，可以获取计划是否处于保障中，满足赔付规则 接口支持批量查询 赔付状态： 成本保障生效中：表示您的计划处于赔付的时间范围，且没有做出影响赔付的操作（每天修改广告计划出价或定向中任意一个的次数超过2次），可以放心投放 成本保障已失效：表示在赔付的时间范围内，您每天修改广告计划出价或定向中任意一个的次数超过了2次，已经不是赔付的候选计划，系统也不会计算赔付金额 成本保障计算中：计划开始投放后的第5-7个自然日，系统正在对候选赔付计划，计算是否赔付以及赔付金额 成本保障已到账：该计划在投放期间，满足自动赔付规则，赔付已到账，可在站内信看到到账通知 成本保障已结束：在系统计算后超成本幅度或转化数未达到赔付标准 若广告主存在异常作弊行为，平台有权拒绝赔付并追回已赔付款项 不适用于 ROI 出价、每次付费出价、自动出价、投放管家的广告计划 赔付金额和实际消耗有关，总实际消耗中不包括使用「一键起量」工具期间产生的消耗

func Create

func Create(ctx context.Context, clt *core.SDKClient, accessToken string, req *ad.CreateRequest) (uint64, error)

Create 创建广告计划 计划包括了计划名称、投放范围、投放目标、用户定向、预算与出价，对于其中的概念解释可以参考：【广告计划】 计划创建涉及了多个资产管理：应用管理、落地页管理、转化目标管理、定向包管理、DMP人群管理等；开发者需要提前根据开放接口构建这些资产功能，以免创建计划卡住 新版营销链路广告计划差异点 新版计划中去除投放内容中落地页信息（旧版计划中在计划维度） 新版计划中新增广告位信息（旧版计划中在创意维度） 新版计划中增加监测链接内容（旧版计划中在创意维度）

func Get

func Get(ctx context.Context, clt *core.SDKClient, accessToken string, req *ad.GetRequest) (*ad.GetResponseData, error)

Get 获取广告计划 此接口用于获取广告计划列表的信息； 如果创建计划时未设置对应的字段，返回的字段值会是null 支持filtering过滤，可按广告计划ID、出价方式、广计划状态进行过滤筛选 默认不获取删除的计划，如果要获取删除的计划，可在filtering中传入对应的status值； 对于搜索广告计划信息获取参见【搜索广告投放】

func RejectReason

func RejectReason(ctx context.Context, clt *core.SDKClient, accessToken string, req *ad.RejectReasonRequest) ([]ad.RejectReason, error)

RejectReason 获取计划审核建议

func Update

func Update(ctx context.Context, clt *core.SDKClient, accessToken string, req *ad.UpdateRequest) (*ad.UpdateResponseData, error)

Update 更新计划 计划包括了计划名称、投放范围、投放目标、用户定向、预算与出价，对于其中的概念解释可以参考：【广告计划】 未展示的字段，表示不可以进行修改（修改时注意字段的描述）

func UpdateBid

func UpdateBid(ctx context.Context, clt *core.SDKClient, accessToken string, req *ad.UpdateBidRequest) (*ad.UpdateResponseData, error)

UpdateBid 更新计划出价 通过此接口用于更新广告计划的出价 bid， 暂不支持更新深度出价 一次可以处理100个计划； 修改的出价不能大于当前预算； 修改计划出价时可以参考：【建议出价】

func UpdateBudget

func UpdateBudget(ctx context.Context, clt *core.SDKClient, accessToken string, req *ad.UpdateBudgetRequest) (*ad.UpdateResponseData, error)

UpdateBudget 更新计划预算 通过此接口用于更新广告计划的预算； 一次可以处理100个计划 24小时内修改预算操作，不能超过20次，24小时是指自然天的24小时； 单次修改预算幅度不能低于100元（增加或者减少）； 修改后预算金额，不能低于当前已消费金额的105%，以整百单位向上取整；

func UpdateStatus

func UpdateStatus(ctx context.Context, clt *core.SDKClient, accessToken string, req *ad.UpdateStatusRequest) (*ad.UpdateResponseData, error)

UpdateStatus 更新计划状态 通过此接口可对计划做启用/暂停/删除操作； 一次可以处理100个计划 对于删除的计划不能再进行状态操作，否则会报错！ 如果有一个计划有问题，全部计划修改都不会成功！请确保传入的计划属于此广告主以及处于非删除状态。