ad

Documentation

Overview

Package ad 广告组相关API

Index

• func Create(clt *core.SDKClient, accessToken string, req *ad.CreateRequest) (uint64, error)
• func Get(clt *core.SDKClient, accessToken string, req *ad.GetRequest) (*ad.GetResponseData, error)
• func Update(clt *core.SDKClient, accessToken string, req *ad.UpdateRequest) (*ad.UpdateResponseData, error)
• func UpdateBid(clt *core.SDKClient, accessToken string, req *ad.UpdateBidRequest) (*ad.UpdateResponseData, error)
• func UpdateBudget(clt *core.SDKClient, accessToken string, req *ad.UpdateBudgetRequest) (*ad.UpdateResponseData, error)
• func UpdateStatus(clt *core.SDKClient, accessToken string, req *ad.UpdateStatusRequest) (*ad.UpdateResponseData, error)

Functions

func Create

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

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

func Get

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

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

func Update

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

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

func UpdateBid

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

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

func UpdateBudget

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

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

func UpdateStatus

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

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