ad

package
v1.16.3 Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: Jul 12, 2023 License: Apache-2.0 Imports: 2 Imported by: 0

Documentation

Overview

Package ad 广告计划

Index

Constants

This section is empty.

Variables

This section is empty.

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 EstimateEffect added in v1.16.0

func EstimateEffect(clt *core.SDKClient, accessToken string, req *ad.EstimateEffectRequest) (*ad.EstimateEffectResult, error)

EstimateEffect 获取预估效果接口 推直播间-日常销售-通投-托管-放量投放场景获取预估效果

func Get

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

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

func KeywordCheck added in v1.16.0

func KeywordCheck(clt *core.SDKClient, accessToken string, req *ad.KeywordCheckRequest) (*ad.KeywordCheckData, error)

KeywordCheck 关键词合规校验 用于确认创建搜索广告之前提供关键词合规校验及违规提醒

func KeywordsGet added in v1.16.0

func KeywordsGet(clt *core.SDKClient, accessToken string, req *ad.KeywordsGetRequest) (*ad.KeywordsGetResult, error)

KeywordsGet 获取计划的搜索关键词

func KeywordsUpdate added in v1.16.0

func KeywordsUpdate(clt *core.SDKClient, accessToken string, req *ad.KeywordsUpdateRequest) error

KeywordsUpdate 更新关键词 用于更新搜索计划关键词

func LqAdGet added in v1.16.0

func LqAdGet(clt *core.SDKClient, accessToken string, req *ad.LqAdGetRequest) ([]uint64, error)

LqAdGet 获取低效计划列表 用于获取千川广告账户下的低效计划列表 注意: 低效计划一定是在投计划;关停或删除后,将不再是低效计划 创意重复度高或低活跃的计划,都有可能是低效计划。具体定义待平台后续公布 请勿使用定时任务高频轮询;建议实现“低效计划暂停/清理”功能,由前端触发调用该接口

func PrivatewordsGet added in v1.16.0

func PrivatewordsGet(clt *core.SDKClient, accessToken string, req *ad.PrivatewordsGetRequest) (*ad.PrivateWords, error)

PrivatewordsGet 获取否定词列表

func PrivatewordsUpdate added in v1.16.0

func PrivatewordsUpdate(clt *core.SDKClient, accessToken string, req *ad.PrivatewordsUpdateRequest) (*ad.PrivatewordsUpdateResult, error)

PrivatewordsUpdate 全量更新否定词 用于全量更新搜索计划否定词

func RecommendKeywordsGet added in v1.16.0

func RecommendKeywordsGet(clt *core.SDKClient, accessToken string, req *ad.RecommendKeywordsGetRequest) (*ad.RecommendKeywordsGetResult, error)

RecommendKeywordsGet 获取系统推荐的搜索关键词 获取巨量千川广告账户下,系统推荐的搜索关键词,以用于创编搜索广告

func RejectReason

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

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

func RoiGoalUpdate added in v1.16.0

func RoiGoalUpdate(clt *core.SDKClient, accessToken string, req *ad.RoiGoalUpdateRequest) ([]ad.RoiGoalUpdateResult, error)

RoiGoalUpdate 更新计划的支付ROI目标 此接口用于批量更新广告计划的支付ROI目标

func SuggestBid added in v1.16.0

func SuggestBid(clt *core.SDKClient, accessToken string, req *ad.SuggestBidRequest) (*ad.SuggestBidResult, error)

SuggestBid 获取非ROI目标建议出价 支持通过该接口获取非ROI目标建议出价

func SuggestBudget added in v1.16.0

func SuggestBudget(clt *core.SDKClient, accessToken string, req *ad.SuggestBudgetRequest) (*ad.SuggestBudgetResult, error)

SuggestBudget 获取建议预算接口

func SuggestRoiGoal added in v1.16.0

func SuggestRoiGoal(clt *core.SDKClient, accessToken string, req *ad.SuggestRoiGoalRequest) (*ad.SuggestRoiResult, error)

SuggestRoiGoal 获取支付ROI目标建议

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及原因将会在返回体中返回

Types

This section is empty.

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL