ad

Documentation

Overview

Package ad 广告计划

Index

• func Create(clt *core.SDKClient, accessToken string, req *ad.CreateRequest) (*ad.CreateResult, error)
• func DetailGet(clt *core.SDKClient, accessToken string, req *ad.DetailGetRequest) (*ad.Ad, error)
• func Get(clt *core.SDKClient, accessToken string, req *ad.GetRequest) (*ad.GetResponseData, error)
• func RejectReason(clt *core.SDKClient, accessToken string, req *ad.RejectReasonRequest) ([]ad.RejectReasonList, error)
• func Update(clt *core.SDKClient, accessToken string, req *ad.UpdateRequest) (*ad.CreateResult, 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) (*ad.CreateResult, error)

Create 创建计划（含创意生成规则） 用于创建一条完整的广告计划，包括投放规则（出价预算）、定向规则、创意（自定义创意/程序化创意） 与非千川的计划创建接口差异点在于，该接口将同时创建创意，即通过本接口可完成完整计划的创建 支持专业版和极速版计划的创建，具体传参要求参见字段描述 短视频带货目前暂不支持创建“计划托管”的广告计划

func DetailGet

func DetailGet(clt *core.SDKClient, accessToken string, req *ad.DetailGetRequest) (*ad.Ad, error)

DetailGet 获取计划详情（含创意信息） 用于获取千川广告账户下创建的单个计划的规则信息（含创意生成规则），以及计划下的创意 注意： 程序化创意在通过审核后才可以获取到

func Get

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

Get 获取账户下计划列表（不含创意） 用于获取千川广告账户下创建的计划列表（不含创意部分） 默认可以拉取全部计划详情，可以通过过滤拉取部分计划

func RejectReason

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

RejectReason 获取计划审核建议 通过此接口用于获取广告计划纬度的审核意见

func Update

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

Update 更新计划（含创意生成规则） 用于更新一条完整的广告计划，包括投放规则（出价预算），定向规则，创意（自定义创意/程序化创意） 与非千川的计划更新接口差异点在于，该接口将同时更新创意，即通过本接口可完成完整计划的更新 目前的更新方式为全量更新，可先通过【获取计划详情】接口获取计划详情内容后，再进行更新 支持专业推广和极速推广计划的更新，具体可参看字段表

func UpdateBid

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

UpdateBid 更新计划出价 用于更新广告计划的出价 bid，一次可以处理10个计划 注意： 修改的出价不能大于当前预算

func UpdateBudget

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

UpdateBudget 更新计划预算 通过此接口用于更新广告计划的预算，一次可以处理10个计划 24小时内修改预算操作，不能超过20次，24小时是指自然天的24小时 单次修改预算幅度不能低于100元（增加或者减少） 修改后预算金额，不能低于当前已消费金额的105%，以整百单位向上取整 可能存在部分计划更新成功的情况，更新失败的计划id及原因将会在返回体中返回

func UpdateStatus

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

UpdateStatus 更新计划状态 通过此接口可对计划做启用/暂停/删除操作，一次可以处理10个计划 对于删除的计划不能再进行状态操作，否则会报错 可能存在部分计划更新成功的情况，更新失败的计划id及原因将会在返回体中返回