campaign

Documentation

Index

• type AddCampaignRequest
  • func (r AddCampaignRequest) Url() string
• type AddCampaignResponse
• type Campaign
• type DeleteCampaignRequest
  • func (r DeleteCampaignRequest) Url() string
• type GetCampaignRequest
  • func (r GetCampaignRequest) Url() string
• type GetCampaignResponse
• type UpdateCampaignRequest
  • func (r UpdateCampaignRequest) Url() string
• type UpdateCampaignResponse

Types

type AddCampaignRequest

type AddCampaignRequest struct {
	// CampaignTypes 新增推广计划物料;集合长度限制：[1, 100]
	CampaignTypes []Campaign `json:"campaignTypes,omitempty"`
	// AdType 投放广告类型;0 - 普通计划;14 - 商品计划;6 - 网址定向计划
	AdType int `json:"adType,omitempty"`
}

AddCampaignRequest 添加计划 API Request

func (AddCampaignRequest) Url

func (r AddCampaignRequest) Url() string

type AddCampaignResponse

type AddCampaignResponse struct {
	Data []Campaign `json:"data,omitempty"`
}

AddCampaignResponse 添加计划 API Response

type Campaign

type Campaign struct {
	// CampaignId 计划ID
	CampaignId int64 `json:"campaignId,omitempty"`
	// CampaignName 计划名称;长度限制：最大30个字节（1个中文按2个字节计算，英文、数字按1个字节计算）
	CampaignName string `json:"campaignName,omitempty"`
	// Budget 计划每日预算;取值范围：[50, Min(10000000, 账户预算)]
	Budget float64 `json:"budget,omitempty"`
	// RegionTarget 计划推广地域
	RegionTarget []int `json:"regionTarget,omitempty"`
	// NegativeKeywords 短语否定关键词列表
	NegativeKeywords []string `json:"negativeKeywords,omitempty"`
	// ExactNegativeKeywords 精确否定关键词列表
	ExactNegativeKeywords []string `json:"exactNegativeKeywords,omitempty"`
	// Schedule 计划推广暂停时段
	Schedule []model.Schedule `json:"schedule,omitempty"`
	// BudgetOfflineTime 预算下线时间;数组元素个数限制：最近有过下线时段的7个自然日的下线和上线时段（这7个自然日中若某日期距当前已超过30天，则不返回）;
	BudgetOfflineTime []model.OfflineTime `json:"budgetOfflineTime,omitempty"`
	// ShowProb 创意展现方式;1 - 优选;2 - 轮替
	ShowProb int `json:"showProb,omitempty"`
	// Pause 暂停状态;true - 暂停;false - 启用
	Pause *bool `json:"pause,omitempty"`
	// Status 计划状态
	Status int `json:"status,omitempty"`
	// PriceRatio 移动出价系数
	PriceRatio float64 `json:"priceRatio,omitempty"`
	// PcPriceRatio 计算机出价系数
	PcPriceRatio float64 `json:"pcPriceRatio,omitempty"`
	// BidPrefer 计划出价类型
	BidPrefer int `json:"bidPrefer,omitempty"`
	// AdType 计划类型
	AdType *int `json:"adType,omitempty"`
	// BusinessPointId 推广业务ID
	BusinessPointId int64 `json:"businessPointId,omitempty"`
	// BusinessPointName 推广业务字面
	BusinessPointName string `json:"businessPointName,omitempty"`
	// SmartRegion 商品计划: 智能地域开关
	SmartRegion *bool `json:"smartRegion,omitempty"`
	// PaDevice 商品计划: 计划的投放设备
	PaDevice *int `json:"paDevice,omitempty"`
	// Os 商品计划: 计划的投放设备平台
	Os []string `json:"os,omitempty"`
	// RegionPriceFactor 分地域出价系数
	RegionPriceFactor []model.RegionPriceFactor `json:"regionPriceFactor,omitempty"`
	// SchedulePriceFactor 分时段出价系数
	SchedulePriceFactor []model.SchedulePriceFactor `json:"schedulePriceFactor,omitempty"`
	// MarketingTargetId 营销目标类型
	MarketingTargetId *int `json:"marketingTargetId,omitempty"`
	// ShopType 电商店铺类型
	ShopType int `json:"shopType,omitempty"`
}

Campaign 推广计划 Status 可选值 21 - 有效 22 - 处于暂停时段 23 - 暂停推广 24 - 计划预算不足 25 - 账户预算不足

PriceRatio 可选值 bidPrefer=1时有效，取值范围：[0, 10]，支持精确到两位小数，默认值为1； bidPrefer=2时，无效字段，getCampaign请求返回默认值1

BidPrefer 可选值 默认值：1 取值范围：枚举值，列表如下 1 - 以计算机出价为基准 2 - 以移动出价为基准

AdType 可选值 默认值：0 取值范围：枚举值，列表如下 0 - 普通计划 14 - 商品计划 6 - 网址定向计划

PaDevice 可选值 默认值：0 取值范围：枚举值，列表如下 0 - 全部 1 - 计算机 2 - 移动

OS 可选值 默认值：全选 取值范围：枚举值，列表如下 IPHONE - 苹果手机 ANDROID - 安卓手机 OTHERS - 其他类型

MarketingTargetId 可选值 0 - 网站链接 1 - 应用推广 2 - 门店推广 4 - 电商店铺推广 5 - 商品目录

ShopType 可选值 1 - 度小店 3 - 第三方店铺 31 - 淘宝（含天猫） 32 - 京东 33 - 拼多多 34 - 苏宁 当营销目标为"电商店铺推广"时必填，其他营销目标不支持

type DeleteCampaignRequest

type DeleteCampaignRequest struct {
	// CampaignIds 计划ID
	CampaignIds []int64 `json:"campaignIds,omitempty"`
}

DeleteCampaignRequest 删除计划 API Request

func (DeleteCampaignRequest) Url

func (r DeleteCampaignRequest) Url() string

type GetCampaignRequest

type GetCampaignRequest struct {
	// CampaignFields 需要查询的计划属性
	CampaignFields []string `json:"campaignFields,omitempty"`
	// CampaignIds 查询推广计划ID集合
	CampaignIds []int64 `json:"campaignIds,omitempty"`
	// MobileExtend 是否获取移动优先计划
	MobileExtend int `json:"mobileExtend,omitempty"`
	// AdType 投放广告类型;0 - 普通计划;14 - 商品计划;6 - 网址定向计划
	AdType int `json:"adType,omitempty"`
}

GetCampaignRequest 查询计划 API Request

func (GetCampaignRequest) Url

func (r GetCampaignRequest) Url() string

type GetCampaignResponse

type GetCampaignResponse struct {
	Data []Campaign `json:"data,omitempty"`
}

GetCampaignResponse 查询计划 API Response

type UpdateCampaignRequest

type UpdateCampaignRequest struct {
	// CampaignTypes 更新推广计划字段;集合长度限制：[1, 100]
	CampaignTypes []Campaign `json:"campaignTypes,omitempty"`
}

UpdateCampaignRequest 更新计划 API Request

func (UpdateCampaignRequest) Url

func (r UpdateCampaignRequest) Url() string

type UpdateCampaignResponse

type UpdateCampaignResponse struct {
	Data []Campaign `json:"data,omitempty"`
}

UpdateCampaignResponse 更新计划 API Response