Documentation
¶
Overview ¶
Package ad 广告计划相关API models
Index ¶
- type Ad
- func (a Ad) GetActionTrackURL() []string
- func (a Ad) GetAdvertiserID() uint64
- func (a Ad) GetBudget() float64
- func (a Ad) GetCampaignID() uint64
- func (a Ad) GetCpaBid() float64
- func (a Ad) GetDeepCpaBid() float64
- func (a Ad) GetExternalURLs() []string
- func (a Ad) GetID() uint64
- func (a Ad) GetName() string
- func (a Ad) GetOpenURL() string
- func (a Ad) GetOptStatus() enum.AdOptStatus
- func (a Ad) IsProject() bool
- func (a Ad) Version() model.AdVersion
- type AdReject
- type Audience
- type AudienceAction
- type CostProtectStatus
- type CostProtectStatusGetRequest
- type CostProtectStatusGetResponse
- type CreateRequest
- type CreateResponse
- type CreativeReject
- type DpaProductTarget
- type GetFiltering
- type GetRequest
- type GetResponse
- type GetResponseData
- type IAd
- type IListFilter
- type MaterialReject
- type RejectData
- type RejectReason
- type RejectReasonRequest
- type RejectReasonResponse
- type UpdateBidRequest
- type UpdateBidRequestList
- type UpdateBudgetRequest
- type UpdateBudgetRequestList
- type UpdateError
- type UpdateRequest
- type UpdateResponse
- type UpdateResponseData
- type UpdateStatusRequest
- type WithOpenURL
Constants ¶
This section is empty.
Variables ¶
This section is empty.
Functions ¶
This section is empty.
Types ¶
type Ad ¶ added in v1.6.8
type Ad struct {
// ID 计划ID
ID uint64 `json:"id,omitempty"`
// AdID 计划ID,返回值同id
AdID uint64 `json:"ad_id,omitempty"`
// Name 计划名称
Name string `json:"name,omitempty"`
// AdvertiserID 广告主ID
AdvertiserID uint64 `json:"advertiser_id,omitempty"`
// CampaignID 广告组ID
CampaignID uint64 `json:"campaign_id,omitempty"`
// ModifyTime 计划上次修改时间标识(用于更新计划时提交,服务端判断是否基于最新信息修改)
ModifyTime string `json:"modify_time,omitempty"`
// AdModifyTime 计划上次修改时间
AdModifyTime string `json:"ad_modify_time,omitempty"`
// AdCreateTime 计划创建时间
AdCreateTime string `json:"ad_create_time,omitempty"`
// UniqueFk 第三方唯一键,传该值时保证接口重试的幂等性,带有相同unique_fk的请求服务端会视为同一个广告处理。仅在创建接口传入且无法修改,如果创建时传入了已存在的唯一键值,那么会返回该唯一键值所对应的广告计划ID。该值可用于内部系统会生成的唯一ID与头条ID做关联的场景,避免超时重试实际上一次创建请求又成功导致的重复创建问题,通过unique_fk可与内部系统ID实现关联并避免重复创建,可结合实际场景选择使用,广告计划中的unique_fk要求不重复,与广告组中的unique_fk无相关。
UniqueFk string `json:"unique_fk,omitempty"`
// Status 广告计划投放状态; (进入投放之前,优先披露审核状态,此时优先于启用暂停,启用暂停信息以opt_status为准)
Status enum.AdStatus `json:"status,omitempty"`
// LearningPhase 学习期状态; 许值:DEFAULT(默认,不在学习期中)、LEARNING(学习中)、LEARNED(学习成功)、LEARN_FAILED(学习失败);关于学习期,此字段即将废弃关于学习期,此字段即将废弃
LearningPhase enum.LearningPhase `json:"learning_phase,omitempty"`
// OptStatus 广告计划操作状态, 允许值: "AD_STATUS_ENABLE","AD_STATUS_DISABLE"
OptStatus enum.AdOptStatus `json:"opt_status,omitempty"`
// DeliveryRange 投放范围
DeliveryRange enum.AdDeliveryRange `json:"delivery_range,omitempty"`
// UnionVideoType 投放形式(穿山甲视频创意类型);默认值: ORIGINAL_VIDEO原生
UnionVideoType enum.UnionVideoType `json:"union_video_type,omitempty"`
// DownloadUrl 应用下载方式,推广目的为APP时有值。返回值:DOWNLOAD_URL下载链接,QUICK_APP_URL快应用+下载链接,EXTERNAL_URL落地页链接
DownloadUrl string `json:"download_url,omitempty"`
// QuickAppUrl 快应用链接,当推广类型为应用推广,且download_type为QUICK_APP_URL时有值
QuickAppUrl string `json:"quick_app_url,omitempty"`
// ExternalUrl 落地页链接,投放内容或下载方式为落地页时有值
ExternalUrl string `json:"external_url,omitempty"`
// Ulink 直达备用链接,仅支持穿山甲广告位(不支持搜索广告)
Ulink string `json:"ulink,omitempty"`
// TrackUrl 展示(监测链接)
TrackUrl []string `json:"track_url,omitempty"`
// ActionTrackUrl 点击(监测链接)
ActionTrackUrl []string `json:"action_track_url,omitempty"`
// VideoPlayEffectTrackUrl 视频有效播放(监测链接)
VideoPlayEffectTrackUrl []string `json:"video_play_effect_track_url,omitempty"`
// VideoPlayDoneTrackUrl 视频播完(监测链接)
VideoPlayDoneTrackUrl []string `json:"video_play_done_track_url,omitempty"`
// VideoPlayTrackUrl 视频播放(监测链接)
VideoPlayTrackUrl []string `json:"video_play_track_url,omitempty"`
// TrackUrlSendType 数据发送方式; 允许值: SERVER_SEND(服务器端上传), CLIENT_SEND(客户端上传)
TrackUrlSendType string `json:"track_url_send_type,omitempty"`
// DownloadType 应用下载方式,推广目的为APP时有值。返回值:DOWNLOAD_URL下载链接,QUICK_APP_URL快应用+下载链接,EXTERNAL_URL落地页链接
DownloadType enum.DownloadType `json:"download_type,omitempty"`
// AppType 下载类型,当推广类型为应用推广且download_type为DOWNLOAD_URL或者QUICK_APP_URL时或当推广类型为DPA(商品目录推广)且dpa_adtype为DPA_APP有值
AppType string `json:"app_type,omitempty"`
// DonwloadMode 优先从系统应用商店下载(下载模式);允许值:APP_STORE_DELIVERY(仅安卓应用下载支持)、 DEFAULT当应用下载时,默认default下载,可选用APP_STORE_DELIVERY(应用商店直投),当为该值时,将优先跳转目标应用对应手机系统应用商店安装详情页,跳转失败则使用下载链接下载。请确保投放的应用在应用商店内已上架
DownloadMode enum.DownloadMode `json:"download_mode,omitempty"`
// ConvertID 转化目标,其中convert_id数值较小时为预定义转化
ConvertID uint64 `json:"convert_id,omitempty"`
// ExternalAction 转化类型,目前当推广类型为抖音时有值,允许值:"AD_CONVERT_TYPE_FOLLOW_ACTION", "AD_CONVERT_TYPE_MESSAGE_ACTION", "AD_CONVERT_TYPE_INTERACTION"
ExternalAction enum.AdConvertType `json:"external_action,omitempty"`
// ExternalActions 转化类型,目前当推广类型为抖音时有值,允许值:"AD_CONVERT_TYPE_FOLLOW_ACTION", "AD_CONVERT_TYPE_MESSAGE_ACTION", "AD_CONVERT_TYPE_INTERACTION"
ExternalActions []enum.AdConvertType `json:"external_actions,omitempty"`
// DeepExternalAction 深度转化目标
DeepExternalAction enum.DeepExternalAction `json:"deep_external_action,omitempty"`
// FeedDeliverySearch 搜索快投关键词,HAS_OPEN:启用,DISABLE:不启用
FeedDeliverySearch string `json:"feed_delivery_search,omitempty"`
// IntelligentFlowSwitch 智能流量开关,ON:开启,OFF:关闭
IntelligentFlowSwitch enum.OnOff `json:"intelligent_flow_switch,omitempty"`
// OpenUrl 直达链接(点击唤起APP)
OpenUrl string `json:"open_url,omitempty"`
// AdvancedCreativeType 附加创意类型; 允许值: ATTACHED_CREATIVE_GAME_PACKAGE游戏礼包码,ATTACHED_CREATIVE_GAME_FORM游戏表单收集,ATTACHED_CREATIVE_GAME_SUBSCRIBE游戏预约,ATTACHED_CREATIVE_NONE无推广目的为应用推广类型、下载方式选择下载链接且下载链接为安卓应用下载时才可以设置
AdvancedCreativeType enum.AdvancedCreativeType `json:"advanced_creative_type,omitempty"`
// GamePackageDesc 应用描述,最少1字,最多15字
GamePackageDesc string `json:"game_package_desc,omitempty"`
// GamePackageBatchID 游戏礼包码id,目前仅支持直接发券类型
GamePackageBatchID int64 `json:"game_package_batch_id,omitempty"`
// GamePackageThumbnails 应用图片集,图片URL链接,有且仅有两个该字段10.10日下线
GamePackageThumbnails []string `json:"game_package_thumbnails,omitempty"`
// GamePackageThumbnailIDs 应用图片集,图片image_id,有且仅有两个,游戏礼包码时有值,可以从 【素材管理-获取图片素材】 接口中获取,建议尺寸 16:9 与game_package_thumbnails同时传入时,以game_package_thumbnail_ids字段为准
GamePackageThumbnailIDs []string `json:"game_package_thumbnail_ids,omitempty"`
// StoreproUnit 门店推广-投放内容,当推广目的为STORE(门店推广)时有值。取值: "STORE"门店, "STORE_ACTIVITY"活动;目前暂时不支持线下商品类型
StoreproUnit string `json:"storepro_unit,omitempty"`
// StoreType 门店类型,(storepro_unit 为 "STORE" 时有值。取值: "STORE_NORMAL"平台通用门店, "STORE_THIRT_PARTY"第三方门店, "STORE_DOUYIN"抖音POI门店
StoreType string `json:"store_type,omitempty"`
// AdvertiserStoreIDs 门店ID列表 (storepro_unit 为 "STORE" 时有值
AdvertiserStoreIDs []uint64 `json:"advertiser_store_ids,omitempty"`
// StoreproPackID 活动ID (storepro_unit 为 "STORE_ACTIVITY" 时有值
StoreproPackID uint64 `json:"storepro_pack_id,omitempty"`
// ProductPlatformID 产品目录ID(ID由查询产品目录接口得到), 当推广目的landing_type为DPA时有值
ProductPlatformID uint64 `json:"product_platform_id,omitempty"`
// ProductID 商品id,当推广目的为 DPA 广告组商品类型为 SDPA 时有值
ProductID string `json:"product_id,omitempty"`
// AssetID 物件id,当广告组商品类型为 SDPA 且商品库为汽车商品库时有值
AssetID uint64 `json:"asset_id,omitempty"`
// CategoryType DPA投放范围,取值:NONE不限,"CATEGORY"选择分类,"PRODUCT"指定商品
CategoryType string `json:"category_type,omitempty"`
// DpaCategories 分类列表,category_type取值范围为CATEGORY时有值
DpaCategories []uint64 `json:"dpa_categories,omitempty"`
// DpaProducts 商品列表,category_type为PRODUCT时有值
DpaProducts []uint64 `json:"dpa_products,omitempty"`
// DpaProductTarget 自定义筛选条件(商品投放条件)。用于圈定商品投放范围,结合商品库字段搭配判断条件,圈定商品投放范围。
DpaProductTarget []DpaProductTarget `json:"dpa_product_target,omitempty"`
// DpaAdtype dpa广告类型,取值范围:"DPA_LINK"落地页, "DPA_APP"应用下载
DpaAdtype string `json:"dpa_adtype,omitempty"`
// ParamsType 链接类型(落地页),当dpa_adtype为"DPA_LINK"时有值,取值: "DPA"商品库所含链接, "CUSTOM"自定义链接
ParamsType string `json:"params_type,omitempty"`
// DpaExternalUrlField 落地页链接字段选择,当params_type为"DPA"时有值
DpaExternalUrlField string `json:"dpa_external_url_field,omitempty"`
// DpaExternalUrls 落地页链接地址列表,当params_type为"CUSTOM"时有值
DpaExternalUrls []string `json:"dpa_external_urls,omitempty"`
// Package 应用包名,当推广类型为应用推广且download_type为DOWNLOAD_URL时或当推广类型为DPA(商品目录推广)且dpa_adtype为DPA_APP有值
Package string `json:"package,omitempty"`
// InventoryCatalog 广告位大类。 MANUAL首选媒体 SCENE场景广告位,SMART优选广告位,UNIVERSAL通投智选
InventoryCatalog enum.InventoryCatalog `json:"inventory_catalog,omitempty"`
// InventoryType 创意投放位置; 创建选择优选广告位时,此字段回会返回对应的优选广告位
InventoryType []enum.StatInventoryType `json:"inventory_type,omitempty"`
// SmartInventory 优选广告位,NORMAL表示不使用优选,SMART表示使用优选,UNIVERSAL表示通投
SmartInventory string `json:"smart_inventory,omitempty"`
// SceneInventory 首选场景广告位
SceneInventory string `json:"scene_inventory,omitempty"`
// PromotionType 投放内容; GOODS:商品推广;LIVE:直播; AWEME_HOME_PAGE:抖音主页;LANDING_PAGE_LINK:落地页
PromotionType string `json:"promotion_type,omitempty"`
// AwemeAccount 抖音号
AwemeAccount string `json:"aweme_account,omitempty"`
// SubscribeUrl 游戏营销场景-预约下载链接
SubscribeUrl string `json:"subscribe_url,omitempty"`
// FormID 游戏营销场景-表单id
FormID uint64 `json:"form_id,omitempty"`
// FormIndex 游戏营销场景-表单位置索引
FormIndex int `json:"form_index,omitempty"`
// AppDesc 游戏营销场景-应用描述
AppDesc string `json:"app_desc,omitempty"`
// AppIntroduction 游戏营销场景-应用介绍
AppIntroduction string `json:"app_introduction,omitempty"`
// AppThumbnails 游戏营销场景-应用图片集,返回图片集Id
AppThumbnails []string `json:"app_thumbnails,omitempty"`
// DpaOpenUrlType 直达链接类型,取值: "NONE"不启用, "DPA"商品库所含链接, "CUSTOM"自定义链接商品库链接对应商品库内调起字段。
DpaOpenUrlType string `json:"dpa_open_url_type,omitempty"`
// DpaOpenUrlField 直达链接字段选择,当dpa_open_url_type为"DPA"时有值
DpaOpenUrlField string `json:"dpa_open_url_field,omitempty"`
// DpaOpenUrls 直达链接地址列表,当dpa_open_url_type为"CUSTOM"时有值
DpaOpenUrls []string `json:"dpa_open_urls,omitempty"`
// ExternalUrlParams 落地页检测参数(DPA推广目的特有,在填写的参数后面添加"=urlencode(开放平台提供的h5链接地址)",其中urlencode(开放平台提供的h5链接地址)替换为商品库中的h5地址encode的结果)
ExternalUrlParams string `json:"external_url_params,omitempty"`
// OpenUrlParams 直达链接检测参数(DPA推广目的特有,在“产品库中提取的scheme地址"后面追加填写的参数)
OpenUrlParams string `json:"open_url_params,omitempty"`
// Audience 广告受众, 字典类型, 包含下面字段
Audience *Audience `json:"audience,omitempty"`
// AudiencePackageID 定向包ID
AudiencePackageID uint64 `json:"audience_package_id,omitempty"`
// HideIfExists 过滤已安装,当推广目标为安卓应用下载时可填,0表示不限,1表示过滤,2表示定向。默认为不限;默认值:0; 取值: 0, 1, 2。建议促进app活跃度客户使用定向安装功能。选择定向安装时,向已安装客户展示广告;投放时优先获取直达链接,无直达链接时使用应用包名进行投放;如果无直达链接或应用包名,定向安装选项实际不生效;仅对Android链接生效。
HideIfExists enum.HideIfExists `json:"hide_if_exists,omitempty"`
// HideIfConverted 过滤已转化用户
HideIfConverted enum.HideIfConverted `json:"hide_if_converted,omitempty"`
// ConvertedTimeDuration 过滤时间范围
ConvertedTimeDuration enum.ConvertedTimeDuration `json:"converted_time_duration,omitempty"`
// DpaLbs 地域匹配-LBS;开启时,根据用户的地理位置信息,给用户投放位于其附近的产品 ;取值:0,1(0表示不启用,1表示启用)
DpaLbs *int `json:"dpa_lbs,omitempty"`
// DpaCity 地域匹配-商品所在城市;开启时,仅将商品投放给位于该商品设置的可投城市的用户 ;取值:0,1(0表示不启用,1表示启用)
DpaCity *int `json:"dpa_city,omitempty"`
// DpaProvince 地域匹配-商品所在省份;开启时,将商品仅投放给位于该商品设置的可投省份的用户 ;取值:0,1(0表示不启用,1表示启用)
DpaProvince *int `json:"dpa_province,omitempty"`
// DpaLocationAudience DPA行为重定向,0:不启用,1:启用
DpaLocationAudience *int `json:"dap_location_audience,omitempty"`
// AssetIDs 事件管理下资产 id
AssetIDs []uint64 `json:"asset_ids,omitempty"`
// ValueOptimizedType 目标优化类型,0表示行为优化,1表示价值优化
ValueOptimizedType *int `json:"value_optimized_type,omitempty"`
// ValueOptimizedOpen 价值优选,0表示关闭,1表示开启
ValueOptimizedOpen *int `json:"value_optimized_open,omitempty"`
// IncludeCustomActions 包含人群包((DPA推广目的特有,格式举例[{"days": 7, "code": 1001},], dpa_local_audience为1时有值; day可选范围:1, 7, 14, 28, 60, 90, 120, 180。
IncludeCustomActions json.RawMessage `json:"include_custom_actions,omitempty"`
// ExcludeCustomActions 排除人群包((DPA推广目的特有,格式举例{"days": 7, "code": 1002},],day可选范围: 1, 7, 14, 28, 60, 90, 120, 180。
ExcludeCustomActions json.RawMessage `json:"exclude_custom_actions,omitempty"`
// DpaRecommendType dpa商品重定向推荐类型,dpa_local_audience为1时有值;取值:1(基于重定向推荐更多商品(根据重定向商品和行业特点,推荐更多相关商品投放,包含重定向商品),2仅重定向商品(仅根据重定向人群内定义的重定向行为商品进行投放)
DpaRecommendType int `json:"dpa_recommend_type,omitempty"`
// SmartBidType 投放场景(出价方式)
SmartBidType enum.SmartBidType `json:"smart_bid_type,omitempty"`
// AdjustCpa 是否调整自动出价,意味如果预期成本不在范围内将在此基础上调整,仅OCPM支持,当smart_bid_type=SMART_BID_CONSERVATIVE时选填。当smart_bid_type为"SMART_BID_CONSERVATIVE"且adjust_cpa=0时,cpa_bid由系统自动计算;;当smart_bid_type为"SMART_BID_CONSERVATIVE" 且adjust_cpa=1时,cpa_bid必填
AdjustCpa int `json:"adjust_cpa,omitempty"`
// FlowControlMode 竞价策略(投放方式)
FlowControlMode enum.FlowControlMode `json:"flow_control_mode,omitempty"`
// BudgetMode 预算类型(创建后不可修改),
BudgetMode enum.BudgetMode `json:"budget_mode,omitempty"`
// Budget 预算
Budget float64 `json:"budget,omitempty"`
// ScheduleType 投放时间类型
ScheduleType enum.ScheduleType `json:"schedule_type,omitempty"`
// StartTime 投放起始时间,当schedule_type为"SCHEDULE_START_END"时取值,形式如:2017-01-01 00:00
StartTime string `json:"start_time,omitempty"`
// EndTime 投放结束时间,当schedule_type为"SCHEDULE_START_END"时取值,形式如:2017-01-01 00:00
EndTime string `json:"end_time,omitempty"`
// ScheduleTime 投放时段,默认全时段投放,格式是48*7位字符串,且都是0或1。也就是以半个小时为最小粒度,周一至周日每天分为48个区段,0为不投放,1为投放,不传、全传0、全传1均代表全时段投放。
ScheduleTime string `json:"schedule_time,omitempty"`
// Pricing 付费方式(计划出价类型)
Pricing enum.PricingType `json:"pricing,omitempty"`
// Bid 出价
Bid float64 `json:"bid,omitempty"`
// CpaBid 目标转化出价/预期成本, 当pricing为"OCPM"、"OCPC"出价方式时有值
CpaBid float64 `json:"cpa_bid,omitempty"`
// DeepBidType 深度优化方式
DeepBidType enum.DeepBidType `json:"deep_bid_type,omitempty"`
// DeepCpabidid 深度优化出价,deep_bid_type为"DEEP_BID_MIN"时有值。当对应的转化convert_id,设定深度转化目标时才会有效。
DeepCpabidid float64 `json:"deep_cpabidid,omitempty"`
// LubanROiGoal 鲁班目标ROI出价策略系数。推广目的为商品推广(GOODS)时可填。当传入该参数时,表示启用鲁班ROI优化,支持范围(0,100],精度:保留小数点后四位
LubanRoiGoal float64 `json:"luban_roi_goal,omitempty"`
// RoiGoal 深度转化ROI系数, 范围(0,5],精度:保留小数点后四位, deep_bid_type为"ROI_COEFFICIENT"时有值
RoiGoal float64 `json:"roi_goal,omitempty"`
// AutoInheritSwitch 一键继承开关,ON表示开启一键继承,OFF表示关闭一键继承
AutoInheritSwitch string `json:"auto_inherit_switch,omitempty"`
// InheritType 一键继承账户类型,auto_inherit_switch为ON时有意义,INHERIT_FROM_ACCOUNT表示从同账户下的优质计划中继承,INHERIT_FROM_CUSTOMER表示从同账户所在组织下的其他账户的优质计划中继承
InheritType string `json:"inherit_type,omitempty"`
// InheritedAdvertiserID 一键继承的同组织账户id的list,inherit_type等于INHERIT_FROM_CUSTOMER时有意义
InheritedAdvertiserID []uint64 `json:"inherited_advertiser_id,omitempty"`
// DeliveryPhase 计划所处阶段,允许值:FIRST_PHASE第一阶段,SECOND_PHASE第二阶段。当pricing为PRICING_CPC_OCPM时有值
DeliveryPhase string `json:"delivery_phase,omitempty"`
// LauhchTargetType 投放类型,LIVE_CONVERT:直播间转化、APP:应用下载、EXTERNAL:线索收集
LaunchTargetType string `json:"launch_target_type,omitempty"`
// AutoUpdateKeyword 是否开启自动加词,ON 开启、OFF 关闭
AutoUpdateKeyword enum.OnOff `json:"auto_update_keyword,omitempty"`
// LandingPageStayTime 店铺停留时长,单位为毫秒
LandingPageStayTime int64 `json:"landing_page_stay_time,omitempty"`
// TargetCvr 目标转化率
TargetCvr float64 `json:"target_cvr,omitempty"`
}
Ad 广告信息
func (Ad) GetActionTrackURL ¶ added in v1.9.21
func (Ad) GetAdvertiserID ¶ added in v1.9.17
func (Ad) GetCampaignID ¶ added in v1.9.17
func (Ad) GetDeepCpaBid ¶ added in v1.9.17
func (Ad) GetExternalURLs ¶ added in v1.9.21
func (Ad) GetOpenURL ¶ added in v1.9.20
func (Ad) GetOptStatus ¶ added in v1.9.17
func (a Ad) GetOptStatus() enum.AdOptStatus
type AdReject ¶ added in v1.6.39
type AdReject struct {
// AdID 广告计划 id
AdID uint64 `json:"ad_id,omitempty"`
// RejectData 审核建议数据
RejectData []RejectData `json:"reject_data,omitempty"`
}
AdReject 计划维度审核建议
type Audience ¶
type Audience struct {
// District 地域;取值: "CITY"省市, "COUNTY"区县, "BUSINESS_DISTRICT"商圈,"NONE"不限,省市传法:"city": [12],"district": "CITY",区县的传法:"city": [130102],"district": "COUNTY";暂不支持"海外"
District enum.District `json:"district,omitempty"`
// RegionVersion 行政区域版本号。通过[【获取行政信息】]https://open.oceanengine.com/doc/index.html?key=ad&type=api&id=1709606596424718)接口获取; district =REGION/OVERSEA时必填
RegionVersion string `json:"region_version,omitempty"`
// City 地域定向省市或者区县列表(当传递省份ID时,旗下市县ID可省略不传),当district为"CITY"或"COUNTY"时有值
City []uint64 `json:"city,omitempty"`
// BusinessIDs 商圈ID数组,district为"BUSINESS_DISTRICT"时有值
BusinessIDs []uint64 `json:"business_ids,omitempty"`
// Geolocation 从地图添加(地图位置)
Geolocation []model.Geolocation `json:"geolocation,omitempty"`
// LocationType 位置类型;取值:CURRENT正在该地区的用户,HOME居住在该地区的用户,TRAVEL到该地区旅行的用户,ALL该地区内的所有用户;当city和district有值时返回值
LocationType enum.LocationType `json:"location_type,omitempty"`
// Gender 性别
Gender enum.AudienceGender `json:"gender,omitempty"`
// Age 年龄
Age []enum.AudienceAge `json:"age,omitempty"`
// RetargetingTagsInclude 定向人群包列表(自定义人群),内容为人群包id。如果选择"同时定向与排除",需传入retargeting_tags_include和retargeting_tags_exclude
RetargetingTagsInclude []uint64 `json:"retargeting_tags_include,omitempty"`
// RetargetingTagsExclude 排除人群包列表(自定义人群),内容为人群包id。如果选择"同时定向与排除",需传入retargeting_tags_include和retargeting_tags_exclude
RetargetingTagsExclude []uint64 `json:"retargeting_tags_exclude,omitempty"`
// InterestActionMode 行为兴趣;取值:"UNLIMITED"不限,"CUSTOM"自定义,"RECOMMEND"系统推荐。若与自定义人群同时使用,系统推荐("RECOMMEND")不生效;仅推广范围为默认时可填,且不可与老版行为兴趣定向同时填写,否则会报错
InterestActionMode enum.InterestActionMode `json:"interest_action_mode,omitempty"`
// Action 行为内容
Action *AudienceAction `json:"action,omitempty"`
// InterestCategories 兴趣类目词,当interest_action_mode传CUSTOM时有效
InterestCategories []uint64 `json:"interest_categories,omitempty"`
// InterestWords 兴趣关键词, 传入具体的词id,非兴趣词包id,可以通过词包相关接口或者兴趣关键词word2id接口获取词id,一个计划下最多创建1000个关键词。当interest_action_mode传CUSTOM时有效
InterestWords []uint64 `json:"interest_words,omitempty"`
// AdTags (老版行为兴趣)兴趣分类,如果传"空数组"表示不限,如果"数组传0"表示系统推荐,如果按兴趣类型传表示自定义
AdTags []uint64 `json:"ad_tag,omitempty"`
// InterestTags (老版行为兴趣)兴趣关键词, 传入具体的词id,非兴趣词包id,可以通过词包相关接口或者兴趣关键词word2id接口获取词id,一个计划下最多创建1000个关键词。
InterestTags []uint64 `json:"interest_tags,omitempty"`
// AppBehaviorTarget (老版行为兴趣)APP行为; 取值:NONE不限,CATEGORY按分类,APP按APP
AppBehaviorTarget string `json:"app_behavior_target,omitempty"`
// AppCategory 老版行为兴趣)APP行为定向——按分类
AppCategory []uint64 `json:"app_category,omitempty"`
// AppIDs (老版行为兴趣)APP行为定向——按APP(请注意如果投放的是"应用下载-IOS"不支持设置APP行为定向,请勿传值。)可通过【工具-查询工具-查询应用信息】获取。当app_behavior_target为APP时有值
AppIDs []uint64 `json:"app_ids,omitempty"`
// AwemeFanBehavior 抖音达人互动用户行为类型
AwemeFanBehaviors []enum.Behavior `json:"aweme_fan_behaviors,omitempty"`
// AwemeFanTimeScope
AwemeFanTimeScope string `json:"aweme_fan_time_scope,omitempty"`
// AwemeFanCategories 抖音达人分类ID列表,与aweme_fan_behaviors同时设置才会生效(抖音达人定向)
AwemeFanCategories []uint64 `json:"aweme_fan_categories,omitempty"`
// AwemeFanAccounts 抖音达人ID列表,与aweme_fan_behaviors同时设置才会生效(抖音达人定向)
AwemeFanAccounts []uint64 `json:"aweme_fan_accounts,omitempty"`
// AwemeFansNumbers (抖音号推广特有)账号粉丝相似人群(添加抖音账号,会将广告投放给对应账号的相似人群粉丝)
AwemeFansNumbers []int64 `json:"aweme_fans_numbers,omitempty"`
// FilterAwemeAbnormalActive (抖音号推广特有)过滤高活跃用户; 取值:0表示不过滤,1表示过滤
FilterAwemeAbnormalActive int `json:"filter_aweme_abnormal_active,omitempty"`
// FilterAwemeFansCount (抖音号推广特有)过滤高关注数用户,例如"filter_aweme_fans_count": 1000表示过滤粉丝数在1000以上的用户
FilterAwemeFansCount int64 `json:"filter_aweme_fans_count,omitempty"`
// FilterOwnAwemeFans (抖音号推广特有)过滤自己的粉丝; 取值:0表示不过滤,1表示过滤
FilterOwnAwemeFans int `json:"filter_own_aweme_fans,omitempty"`
// SuperiorPopularityType 媒体定向;
SuperiorPopularityType enum.SuperiorPopularityType `json:"superior_popularity_type,omitempty"`
// FlowPackage 定向逻辑
FlowPackage []uint64 `json:"flow_package,omitempty"`
// ExcludeFlowPackage 排除定向逻辑
ExcludeFlowPackage []uint64 `json:"exclude_flow_package,omitempty"`
// Platform 平台,当下载方式包含下载链接时,平台类型需与选择的下载链接类型对应,当下载方式不包含下载方式的时候,平台可多选。为保证投放效果,平台类型定向PC与移动端互斥
Platform []enum.AudiencePlatform `json:"platform,omitempty"`
// AndroidOsv 最低安卓版本,当app_type为"APP_ANDROID"选填,其余情况不填,
AndroidOsv string `json:"android_osv,omitempty"`
// IosOsv 最低IOS版本,当app_type为"APP_IOS"选填,其余情况不填
IosOsv string `json:"ios_osv,omitempty"`
// DeviceType 设备类型;取值是:"MOBILE", "PAD"。缺省表示不限设备类型。穿山甲已经全量,投放范围为默认时需要有白名单权限才可以
DeviceType []string `json:"device_type,omitempty"`
// Ac 网络类型
Ac []string `json:"ac,omitempty"`
// Carrier 运营商
Carrier []enum.Carrier `json:"carrier,omitempty"`
// ActivateType 新用户(新用户使用头条的时间)
ActivateType []enum.ActivateType `json:"activate_type,omitempty"`
// ArticleCategory 文章分类
ArticleCategory []string `json:"article_category,omitempty"`
// DeviceBrand 手机品牌
DeviceBrand []string `json:"device_brand,omitempty"`
// LauchPrice 手机价格,传入价格区间,最高传入11000(表示1w以上);传值示例 "launch_price": [2000, 11000],表示2000元以上;
LaunchPrice []int `json:"launch_price,omitempty"`
// AutoExtendEnabled 是否启用智能放量。取值是:0、1。缺省为 0。
AutoExtendEnabled int `json:"auto_extend_enabled,omitempty"`
// AutoExtendTarget 可放开定向。当auto_extend_enabled=1 时选填。详见:【附录-可开放定向】。缺省为全不选。
AutoExtendTarget []string `json:"auto_extend_targets,omitempty"`
// DpaRtaSwitch RTA重定向选项,值:ON:开启,OFF:关闭
DpaRtaSwitch enum.OnOff `json:"dpa_rta_switch,omitempty"`
// DpaRtaRecommendType RTA推荐逻辑,ONLY:仅RTA推荐商品,MORE:基于RTA推荐更多商品
DpaRtaRecommendType string `json:"dpa_rta_recommend_type,omitempty"`
}
Audience 受众
type AudienceAction ¶ added in v1.3.13
type AudienceAction struct {
// ActionScene 行为场景
ActionScene []enum.ActionScene `json:"action_scene,omitempty"`
// ActionDays 用户发生行为天数,当interest_action_mode传CUSTOM时有效
ActionDays uint `json:"action_days,omitempty"`
// ActionCategories 行为类目词,当interest_action_mode传CUSTOM时有效
ActionCategories []uint64 `json:"action_categories,omitempty"`
// ActionWords 行为关键词,当interest_action_mode传CUSTOM时有效
ActionWords []uint64 `json:"action_words,omitempty"`
}
AudienceAction 行为内容
type CostProtectStatus ¶ added in v1.6.39
type CostProtectStatus struct {
// AdID 计划id
AdID uint64 `json:"ad_id,omitempty"`
// Status 计划成本保障状态
Status string `json:"status,omitempty"`
}
CostProtectStatus guan广告成本保护状态
type CostProtectStatusGetRequest ¶ added in v1.6.39
type CostProtectStatusGetRequest struct {
// AdvertiserID 广告主id
AdvertiserID uint64 `json:"advertiser_id,omitempty"`
// AdIDs 广告计划id,每次最多传入50个
AdIDs []uint64 `json:"ad_ids,omitempty"`
}
CostProtectStatusGetRequest 批量获取计划成本保障状态 API Request
func (CostProtectStatusGetRequest) Encode ¶ added in v1.6.39
func (r CostProtectStatusGetRequest) Encode() string
Encode implement GetRequest interface
type CostProtectStatusGetResponse ¶ added in v1.6.39
type CostProtectStatusGetResponse struct {
model.BaseResponse
// Data json 返回值
Data struct {
// List .
List []CostProtectStatus `json:"list,omitempty"`
} `json:"data,omitempty"`
}
CostProtectStatusGetResponse 批量获取计划成本保障状态 API Response
type CreateRequest ¶ added in v1.3.0
type CreateRequest struct {
// AdvertiserID 广告主ID
AdvertiserID uint64 `json:"advertiser_id,omitempty"`
// CampaignID 广告组ID。注意:广告组ID要求属于广告主ID,且是非删除广告组ID
CampaignID uint64 `json:"campaign_id,omitempty"`
// Name 广告计划名称,长度为1-100个字符,其中1个中文字符算2位
Name string `json:"name,omitempty"`
// Operation 计划状态; 默认值: "enable"开启状态; 允许值: "enable"开启,"disable"关闭
Operation string `json:"operation,omitempty"`
// DeliveryRange 投放范围。详见【附录-广告投放范围】;默认值: "DEFAULT"默认; 允许值: DEFAULT 默认, UNION 穿山甲、UNIVERSAL 通投智选; 对于投放范围的解释可参考【广告计划】
DeliveryRange enum.AdDeliveryRange `json:"delivery_range,omitempty"`
// UnionVideoType 投放形式(穿山甲视频创意类型),当delivery_range为"UNION"时必填。详见【附录-穿山甲视频创意类型】;默认值: ORIGINAL_VIDEO原生; 允许值: ORIGINAL_VIDEO原生, REWARDED_VIDEO激励视频,SPLASH_VIDEO开屏
UnionVideoType enum.UnionVideoType `json:"union_video_type,omitempty"`
// DownloadType 下载方式; 默认值:DOWNLOAD_URL下载链接; 可选值:DOWNLOAD_URL下载链接、EXTERNAL_URL落地页链接
DownloadType enum.DownloadType `json:"download_type,omitempty"`
// DownloadUrl 应用下载方式,推广目的为APP时有值。返回值:DOWNLOAD_URL下载链接,QUICK_APP_URL快应用+下载链接,EXTERNAL_URL落地页链接
DownloadUrl string `json:"download_url,omitempty"`
// ExternalUrl 落地页链接(支持橙子建站落地页);对于转化量为目标的计划如OCPM计划不允许更改,非转化为目标的计划如CPC、CPM计划可更改; 获取橙子建站落地页可参考【橙子建站落地页管理】
ExternalUrl string `json:"external_url,omitempty"`
// AppType 下载类型,当推广类型为应用推广且download_type为DOWNLOAD_URL或者QUICK_APP_URL时或当推广类型为DPA(商品目录推广)且dpa_adtype为DPA_APP有值
AppType string `json:"app_type,omitempty"`
// Package 应用包名,当推广类型为应用推广且download_type为DOWNLOAD_URL时或当推广类型为DPA(商品目录推广)且dpa_adtype为DPA_APP有值
Package string `json:"package,omitempty"`
// DownloadMode 优先从系统应用商店下载(下载模式);允许值:APP_STORE_DELIVERY(仅安卓应用下载支持)、 DEFAULT当应用下载时,默认default下载,可选用APP_STORE_DELIVERY(应用商店直投),选择后,将优先跳转目标应用对应手机系统应用商店安装详情页,跳转失败则使用下载链接下载。;请确保投放的应用在应用商店内已上架;详情请参照【帮助中心】
DownloadMode enum.DownloadMode `json:"download_mode,omitempty"`
// ConvertID 转化目标, 当出价方式为"OCPM"时必填,当出价方式为CPC和CPM时非必填。可通过【工具-转化目标管理-查询计划可用转化id】查询可用id
ConvertID uint64 `json:"convert_id,omitempty"`
// OpenUrl 直达链接(点击唤起APP)直达链接仅支持部分App唤起,点击创意将优先跳转App,再根据投放内容跳转相关链接
OpenUrl string `json:"open_url,omitempty"`
// Ulink 直达备用链接,仅支持穿山甲广告位(不支持搜索广告)
Ulink string `json:"ulink,omitempty"`
// PromotionType 投放内容,允许值:LIVE:直播; AWEME_HOME_PAGE:抖音主页(默认);LANDING_PAGE_LINK:落地页
PromotionType string `json:"promotion_type,omitempty"`
// AwemeAccount 抖音号,可从【获取绑定抖音号】接口获取,默认取绑定的第一个抖音号
AwemeAccount string `json:"aweme_account,omitempty"`
// LandingPageStayTime 店铺停留时长,单位为毫秒,当external_action为AD_CONVERT_TYPE_STAY_TIME时必填
// 允许值:1000、5000、12000、20000、30000、40000、50000、60000
LandingPageStayTime int `json:"landing_page_stay_time,omitempty"`
// InventoryCatalog 广告位大类。允许值 MANUAL首选媒体 SCENE场景广告位,SMART优选广告位,UNIVERSAL通投智选
InventorCatalog enum.InventoryCatalog `json:"inventory_catalog,omitempty"`
// InventoryType 广告投放位置(首选媒体),详见【附录-首选投放位置】,在没有使用smart_inventory的情况下,当前字段必填。
InventoryType []enum.StatInventoryType `json:"inventory_type,omitempty"`
// SmartInventory 优选广告位,允许值NORMAL表示不使用优选,SMART表示使用优选,UNIVERSAL表示通投,使用优选广告位的时候默认忽略inventory_type字段。
// 默认值: NORMAL
SmartInventory string `json:"smart_inventory,omitempty"`
// ExternalAction 预定义转化目标
ExternalAction enum.AdConvertType `json:"external_action,omitempty"`
// ExternalActions 转化类型列表,仅抖音号、销售线索收集推广目的支持该字段
// 可通过【工具-转化目标管理-查询计划可用转化目标】查询可用external_action
ExternalActions []enum.AdConvertType `json:"external_actions,omitempty"`
// DeepExternalAction 深度转化目标,可通过【获取优化目标】接口获取
DeepExternalAction enum.DeepExternalAction `json:"deep_external_action,omitempty"`
// AssetIDs 资产 id,可通过【获取推广内容】接口获取
// 当使用事件管理时必填
// 正常情况下数组限制上限为1个;当landing_type=link时上限为2个
// 若数组长度为2,需保证有一个小程序资产+落地页资产,顺序不强限制
AssetIDs []uint64 `json:"asset_ids,omitempty"`
// TrackURLGroupType 监测链接类型(当推广目的为APP时必填)允许值:TRACK_URL_GROUP_ID 已有链接、 CUSTOM :自定义
TrackURLGroupType string `json:"track_url_group_type,omitempty"`
// TrackURLGroupID 监测链接组ID(当推广目的为APP时,且监测链接类型为TRACK_URL_GROUP_ID 时必填)
TrackURLGroupID uint64 `json:"track_url_group_id,omitempty"`
// ValueOptimizedType 目标优化类型,0表示行为优化,1表示价值优化
// 当前仅支持推广目的为销售线索收集(landing_type=LINK)
// 当选择价值优化时value_optimized_open价值优化必须为开启,会自动设为1,并将 cpa_bid置为0
ValueOptimizedType *int `json:"value_optimized_type,omitempty"`
// ValueOptimizedValue 价值优选,0表示关闭,1表示开启
// 当前仅支持推广目的为销售线索收集(landing_type=LINK)
// 目标优化类型为价值优化时必须开启,会自动设为1,并将cpa_bid置为 0
ValueOptmizedOpen *int `json:"value_optimized_value,omitempty"`
// ProductPlatformID 商品目录ID(ID由【DPA商品广告-查询商品库】 得到)
ProductPlatformID uint64 `json:"product_platform_id,omitempty"`
// ProductID 商品ID,当广告组商品类型选择SDPA时必填(ID由【DPA商品广告-获取DPA商品库商品列表】 得到,创建后不可修改)
ProductID string `json:"product_id,omitempty"`
// AssetID 物件ID,可用场景需同时满足:
// 1. 推广目的为应用推广APP、销售线索收集LINK、电商店铺SHOP中的一种,且广告组商品类型为 SDPA
// 2. 仅在汽车垂直行业下(商品库行业类型对应AUTO_NEW)可以使用且必填,可通过【商品广告-获取投放条件列表】获取,创建后不可修改。
AssetID uint64 `json:"asset_id,omitempty"`
// CategoryType 商品目录投放范围,当广告组商品类型选择 DPA 多商品时可修改;允许值:NONE不限,"CATEGORY"选择分类,"PRODUCT"指定商品
CategoryType string `json:"category_type,omitempty"`
// DpaCategories 分类列表,category_type更新为"CATEGORY"时可修改,由【DPA商品广告-获取DPA分类】 得到限制个数1~100
DpaCategories []uint64 `json:"dpa_categories,omitempty"`
// DpaProducts 商品列表,category_type更新为"PRODUCT"时可修改,由【DPA商品广告-获取DPA商品库商品列表】 得到;限制个数1~100
DpaProducts []uint64 `json:"dpa_products,omitempty"`
// DpaProductTargets 自定义筛选条件(商品投放条件)。用于圈定商品投放范围,结合商品库字段搭配判断条件,圈定商品投放范围。
DpaProductTarget []DpaProductTarget `json:"dpa_product_targets,omitempty"`
// DpaAdtype DPA广告类型,允许值: "DPA_LINK"落地页, "DPA_APP"应用下载
DpaAdtype string `json:"dpa_adtype,omitempty"`
// ParamsType 链接类型(落地页),当dpa_adtype为"DPA_LINK"时有值,取值: "DPA"商品库所含链接, "CUSTOM"自定义链接
ParamsType string `json:"params_type,omitempty"`
// DpaExternalUrlField 落地页链接字段选择,当params_type为"DPA"时有值
DpaExternalUrlField string `json:"dpa_external_url_field,omitempty"`
// DpaExternalUrls 落地页链接地址列表,当params_type为"CUSTOM"时有值
DpaExternalUrls []string `json:"dpa_external_urls,omitempty"`
// DpaOpenUrlType 直达链接类型,取值: "NONE"不启用, "DPA"商品库所含链接, "CUSTOM"自定义链接商品库链接对应商品库内调起字段。
DpaOpenUrlType string `json:"dpa_open_url_type,omitempty"`
// DpaOpenUrlField 直达链接字段选择,当dpa_open_url_type为"DPA"时有值
DpaOpenUrlField string `json:"dpa_open_url_field,omitempty"`
// DpaOpenUrls 直达链接地址列表,当dpa_open_url_type为"CUSTOM"时有值
DpaOpenUrls []string `json:"dpa_open_urls,omitempty"`
// ExternalUrlParams 落地页检测参数(DPA推广目的特有,在填写的参数后面添加"=urlencode(开放平台提供的h5链接地址)",其中urlencode(开放平台提供的h5链接地址)替换为商品库中的h5地址encode的结果)
ExternalUrlParams string `json:"external_url_params,omitempty"`
// OpenUrlParams 直达链接检测参数(DPA推广目的特有,在“产品库中提取的scheme地址"后面追加填写的参数)
OpenUrlParams string `json:"open_url_params,omitempty"`
// FeedDeliverySearch 搜索快投关键词,HAS_OPEN:启用,DISABLE:不启用
FeedDeliverySearch string `json:"feed_delivery_search,omitempty"`
// IntelligentFlowSwitch 智能流量开关,ON:开启,OFF:关闭
IntelligentFlowSwitch enum.OnOff `json:"intelligent_flow_switch,omitempty"`
// AudiencePackageID 定向包ID
AudiencePackageID uint64 `json:"audience_package_id,omitempty"`
// District 地域;取值: "CITY"省市, "COUNTY"区县, "BUSINESS_DISTRICT"商圈,"NONE"不限,省市传法:"city": [12],"district": "CITY",区县的传法:"city": [130102],"district": "COUNTY";暂不支持"海外"
District enum.District `json:"district,omitempty"`
// RegionVersion 行政区域版本号。通过[【获取行政信息】]https://open.oceanengine.com/doc/index.html?key=ad&type=api&id=1709606596424718)接口获取; district =REGION/OVERSEA时必填
RegionVersion string `json:"region_version,omitempty"`
// City 地域定向省市或者区县列表(当传递省份ID时,旗下市县ID可省略不传),当district为"CITY"或"COUNTY"时有值
City []uint64 `json:"city,omitempty"`
// BusinessIDs 商圈ID数组,district为"BUSINESS_DISTRICT"时有值
BusinessIDs []uint64 `json:"business_ids,omitempty"`
// Geolocation 从地图添加(地图位置)
Geolocation []model.Geolocation `json:"geolocation,omitempty"`
// LocationType 位置类型;取值:CURRENT正在该地区的用户,HOME居住在该地区的用户,TRAVEL到该地区旅行的用户,ALL该地区内的所有用户;当city和district有值时返回值
LocationType enum.LocationType `json:"location_type,omitempty"`
// Gender 性别
Gender enum.AudienceGender `json:"gender,omitempty"`
// Age 年龄
Age []enum.AudienceAge `json:"age,omitempty"`
// Carreer 职业选项,详见【附录-职业】
Career []enum.Carrier `json:"career,omitempty"`
// RetargetingTagsInclude 定向人群包列表(自定义人群),内容为人群包id。如果选择"同时定向与排除",需传入retargeting_tags_include和retargeting_tags_exclude
RetargetingTagsInclude []uint64 `json:"retargeting_tags_include,omitempty"`
// RetargetingTagsExclude 排除人群包列表(自定义人群),内容为人群包id。如果选择"同时定向与排除",需传入retargeting_tags_include和retargeting_tags_exclude
RetargetingTagsExclude []uint64 `json:"retargeting_tags_exclude,omitempty"`
// InterestActionMode 行为兴趣;取值:"UNLIMITED"不限,"CUSTOM"自定义,"RECOMMEND"系统推荐。若与自定义人群同时使用,系统推荐("RECOMMEND")不生效;仅推广范围为默认时可填,且不可与老版行为兴趣定向同时填写,否则会报错
InterestActionMode enum.InterestActionMode `json:"interest_action_mode,omitempty"`
// ActionScene 行为场景
ActionScene []enum.ActionScene `json:"action_scene,omitempty"`
// ActionDays 用户发生行为天数,当interest_action_mode传CUSTOM时有效
ActionDays uint `json:"action_days,omitempty"`
// ActionCategories 行为类目词,当interest_action_mode传CUSTOM时有效
ActionCategories []uint64 `json:"action_categories,omitempty"`
// ActionWords 行为关键词,当interest_action_mode传CUSTOM时有效
ActionWords []uint64 `json:"action_words,omitempty"`
// InterestCategories 兴趣类目词,当interest_action_mode传CUSTOM时有效
InterestCategories []uint64 `json:"Interest_categories,omitempty"`
// InterestWords 兴趣关键词, 传入具体的词id,非兴趣词包id,可以通过词包相关接口或者兴趣关键词word2id接口获取词id,一个计划下最多创建1000个关键词。当interest_action_mode传CUSTOM时有效
InterestWords []uint64 `json:"interest_words,omitempty"`
// AwemeFanBehaviors 抖音达人互动用户行为类型
AwemeFanBehaviors []enum.Behavior `json:"aweme_fan_behaviors,omitempty"`
// AwemeFanTimeScope
AwemeFanTimeScope string `json:"aweme_fan_time_scope,omitempty"`
// AwemeFanCategories 抖音达人分类ID列表,与aweme_fan_behaviors同时设置才会生效(抖音达人定向)
AwemeFanCategories []uint64 `json:"aweme_fan_categories,omitempty"`
// AwemeFanAccounts 抖音达人ID列表,与aweme_fan_behaviors同时设置才会生效(抖音达人定向)
AwemeFanAccounts []uint64 `json:"aweme_fan_accounts,omitempty"`
// FilterAwemeAbnormalActive (抖音号推广特有)过滤高活跃用户; 取值:0表示不过滤,1表示过滤
FilterAwemeAbnormalActive *int `json:"filter_aweme_abnormal_active,omitempty"`
// FilterAwemeFansCount (抖音号推广特有)过滤高关注数用户,例如"filter_aweme_fans_count": 1000表示过滤粉丝数在1000以上的用户
FilterAwemeFansCount *int64 `json:"filter_aweme_fans_count,omitempty"`
// FilterOwnAwemeFans (抖音号推广特有)过滤自己的粉丝; 取值:0表示不过滤,1表示过滤
FilterOwnAwemeFans *int `json:"filter_own_aweme_fans,omitempty"`
// SuperiorPopularityType 媒体定向;
SuperiorPopularityType enum.SuperiorPopularityType `json:"superior_popularity_type,omitempty"`
// FlowPackage 定向逻辑
FlowPackage []uint64 `json:"flow_package,omitempty"`
// ExcludeFlowPackage 排除定向逻辑
ExcludeFlowPackage []uint64 `json:"exclude_flow_package,omitempty"`
// Platform 平台,当下载方式包含下载链接时,平台类型需与选择的下载链接类型对应,当下载方式不包含下载方式的时候,平台可多选。为保证投放效果,平台类型定向PC与移动端互斥
Platform []enum.AudiencePlatform `json:"platform,omitempty"`
// AndroidOsv 最低安卓版本,当app_type为"APP_ANDROID"选填,其余情况不填,
AndroidOsv string `json:"android_osv,omitempty"`
// IosOsv 最低IOS版本,当app_type为"APP_IOS"选填,其余情况不填
IosOsv string `json:"ios_osv,omitempty"`
// DeviceType 设备类型;取值是:"MOBILE", "PAD"。缺省表示不限设备类型。穿山甲已经全量,投放范围为默认时需要有白名单权限才可以
DeviceType []string `json:"device_type,omitempty"`
// Ac 网络类型
Ac []string `json:"ac,omitempty"`
// Carrier 运营商
Carrier []enum.Carrier `json:"carrier,omitempty"`
// HideIfExists 过滤已安装,当推广目标为安卓应用下载时可填,0表示不限,1表示过滤,2表示定向。默认为不限;默认值:0; 取值: 0, 1, 2。建议促进app活跃度客户使用定向安装功能。选择定向安装时,向已安装客户展示广告;投放时优先获取直达链接,无直达链接时使用应用包名进行投放;如果无直达链接或应用包名,定向安装选项实际不生效;仅对Android链接生效。
HideIfExists int `json:"hide_if_exists,omitempty"`
// HideIfConverted 过滤已转化用户
HideIfConverted enum.HideIfConverted `json:"hide_if_converted,omitempty"`
// ConvertedTimeDuration 过滤时间范围
ConvertedTimeDuration enum.ConvertedTimeDuration `json:"converted_time_duration,omitempty"`
// ActivateType 新用户(新用户使用头条的时间)
ActivateType []enum.ActivateType `json:"activate_type,omitempty"`
// ArticleCategory 文章分类
ArticleCategory []string `json:"article_category,omitempty"`
// DeviceBrand 手机品牌
DeviceBrand []string `json:"device_brand,omitempty"`
// LauchPrice 手机价格,传入价格区间,最高传入11000(表示1w以上);传值示例 "launch_price": [2000, 11000],表示2000元以上;
LaunchPrice []int `json:"launch_price,omitempty"`
// AutoExtendEnabled 是否启用智能放量。取值是:0、1。缺省为 0。
AutoExtendEnabled int `json:"auto_extend_enabled,omitempty"`
// AutoExtendTarget 可放开定向。当auto_extend_enabled=1 时选填。详见:【附录-可开放定向】。缺省为全不选。
AutoExtendTarget []string `json:"auto_extend_targets,omitempty"`
// DpaLbs 地域匹配-LBS;开启时,根据用户的地理位置信息,给用户投放位于其附近的产品 ;取值:0,1(0表示不启用,1表示启用)
DpaLbs *int `json:"dpa_lbs,omitempty"`
// DpaCity 地域匹配-商品所在城市;开启时,仅将商品投放给位于该商品设置的可投城市的用户 ;取值:0,1(0表示不启用,1表示启用)
DpaCity *int `json:"dpa_city,omitempty"`
// DpaProvince 地域匹配-商品所在省份;开启时,将商品仅投放给位于该商品设置的可投省份的用户 ;取值:0,1(0表示不启用,1表示启用)
DpaProvince *int `json:"dpa_province,omitempty"`
// DpaLocationAudience DPA行为重定向,0:不启用,1:启用
DpaLocationAudience *int `json:"dap_location_audience,omitempty"`
// IncludeCustomActions 包含人群包((DPA推广目的特有,格式举例[{"days": 7, "code": 1001},], dpa_local_audience为1时有值; day可选范围:1, 7, 14, 28, 60, 90, 120, 180。
IncludeCustomActions interface{} `json:"include_custom_actions,omitempty"`
// ExcludeCustomActions 排除人群包((DPA推广目的特有,格式举例{"days": 7, "code": 1002},],day可选范围: 1, 7, 14, 28, 60, 90, 120, 180。
ExcludeCustomActions interface{} `json:"exclude_custom_actions,omitempty"`
// DpaRecommendType dpa商品重定向推荐类型,dpa_local_audience为1时有值;取值:1(基于重定向推荐更多商品(根据重定向商品和行业特点,推荐更多相关商品投放,包含重定向商品),2仅重定向商品(仅根据重定向人群内定义的重定向行为商品进行投放)
DpaRecommendType int `json:"dpa_recommend_type,omitempty"`
// DpaRtaSwitch RTA重定向选项,值:ON:开启,OFF:关闭
DpaRtaSwitch enum.OnOff `json:"dpa_rta_switch,omitempty"`
// DpaRtaRecommendType RTA推荐逻辑,ONLY:仅RTA推荐商品,MORE:基于RTA推荐更多商品
DpaRtaRecommendType string `json:"dpa_rta_recommend_type,omitempty"`
// SmartBidType 投放场景(出价方式),详见【附录-自动出价类型】;允许值: 常规投放"SMART_BID_CUSTOM", 放量投放"SMART_BID_CONSERVATIVE"; 概念解释:常规投放:控制成本,尽量消耗完预算;放量投放:接受成本上浮,尽量消耗更多预算
SmartBidType enum.SmartBidType `json:"smart_bid_type,omitempty"`
// AdjustCpa 是否调整自动出价,意味如果预期成本不在范围内将在此基础上调整,仅OCPM支持,当smart_bid_type=SMART_BID_CONSERVATIVE时选填。当smart_bid_type为"SMART_BID_CONSERVATIVE"且adjust_cpa=0时,cpa_bid由系统自动计算;;当smart_bid_type为"SMART_BID_CONSERVATIVE" 且adjust_cpa=1时,cpa_bid必填
AdjustCpa int `json:"adjust_cpa,omitempty"`
// FlowControlMode 竞价策略(投放方式)
FlowControlMode enum.FlowControlMode `json:"flow_control_mode,omitempty"`
// BudgetMode 预算类型(创建后不可修改), 详见【附录-预算类型】;允许值: "BUDGET_MODE_DAY"日预算, "BUDGET_MODE_TOTAL"总预算
BudgetMode enum.BudgetMode `json:"budget_mode,omitempty"`
// Budget 预算
Budget float64 `json:"budget,omitempty"`
// ScheduleType 投放时间类型
ScheduleType enum.ScheduleType `json:"schedule_type,omitempty"`
// StartTime 投放起始时间,当schedule_type为"SCHEDULE_START_END"时取值,形式如:2017-01-01 00:00
StartTime string `json:"start_time,omitempty"`
// EndTime 投放结束时间,当schedule_type为"SCHEDULE_START_END"时取值,形式如:2017-01-01 00:00
EndTime string `json:"end_time,omitempty"`
// ScheduleTime 投放时段,默认全时段投放,格式是48*7位字符串,且都是0或1。也就是以半个小时为最小粒度,周一至周日每天分为48个区段,0为不投放,1为投放,不传、全传0、全传1均代表全时段投放。
ScheduleTime string `json:"schedule_time,omitempty"`
// Pricing 付费方式(计划出价类型), 详见【附录-计划出价类型】(目前仅穿山甲类型支持OCPC(具体方式:出价类型传OCPC类型,cpa_bid传值 )); 决定投放目标的类型,比如CPC表示点击量,OCPM表示转化量
Pricing enum.PricingType `json:"pricing,omitempty"`
// Bid 出价
Bid float64 `json:"bid,omitempty"`
// CpaBid 目标转化出价/预期成本, 当pricing为"OCPM"、"OCPC"出价方式时有值
CpaBid float64 `json:"cpa_bid,omitempty"`
// DeepBidType 深度优化方式,允许值详见【附录-深度优化方式】,对于每次付费的转化,深度优化类型需要设置为BID_PER_ACTION(每次付费出价)具体概念见【深度优化方式】;当转化目标中含有深度转化时,该字段必填。获取方式见【查询深度优化方式】
DeepBidType enum.DeepBidType `json:"deep_bid_type,omitempty"`
// DeepCpabidid 深度优化出价,deep_bid_type为"DEEP_BID_MIN"时有值。当对应的转化convert_id,设定深度转化目标时才会有效。
DeepCpabidid float64 `json:"deep_cpabidid,omitempty"`
// LubanROiGoal 鲁班目标ROI出价策略系数。推广目的为商品推广(GOODS)时可填。当传入该参数时,表示启用鲁班ROI优化,支持范围(0,100],精度:保留小数点后四位
LubanRoiGoal float64 `json:"luban_roi_goal,omitempty"`
// RoiGoal 深度转化ROI系数, 范围(0,5],精度:保留小数点后四位, deep_bid_type为"ROI_COEFFICIENT"时有值
RoiGoal float64 `json:"roi_goal,omitempty"`
// TargetCvr 目标转化率,转化率优化仅支持电商店铺推广,且付费方式为OCPC或OCPM
// 允许值:0~100,0表示关闭转化率优化
TargetCvr float64 `json:"target_cvr,omitempty"`
// AutoInheritSwitch 一键继承开关,ON表示开启一键继承,OFF表示关闭一键继承
AutoInheritSwitch string `json:"auto_inherit_switch,omitempty"`
// InheritType 一键继承账户类型,auto_inherit_switch为ON时有意义,INHERIT_FROM_ACCOUNT表示从同账户下的优质计划中继承,INHERIT_FROM_CUSTOMER表示从同账户所在组织下的其他账户的优质计划中继承
InheritType string `json:"inherit_type,omitempty"`
// InheritedAdvertiserID 一键继承的同组织账户id的list,inherit_type等于INHERIT_FROM_CUSTOMER时有意义
InheritedAdvertiserID []uint64 `json:"inherited_advertiser_id,omitempty"`
// TrackURL 展示(监测链接)
TrackURL *[]string `json:"track_url,omitempty"`
// ActionTrackURL 点击(监测链接)只允许传入1个(当推广目的为应用下载且创建计划传递了convert_id,系统会自动获取转化中的点击监测链接)
ActionTrackURL *[]string `json:"action_track_url,omitempty"`
// VideoPlayEffectiveTrackURL 视频有效播放(监测链接),只允许传入1个,投放范围为穿山甲时暂不支持设置此链接
VideoPlayEffectiveTrackURL *[]string `json:"video_play_effective_track_url,omitempty"`
// VideoPlayDoneTrackURL 视频播完(监测链接),只允许传入1个,投放范围为穿山甲时暂不支持设置此链接
VideoPlayDoneTrackURL *[]string `json:"video_play_done_track_url,omitempty"`
// VideoPlayTrackURL 视频播放(监测链接),只允许传入1个,投放范围为穿山甲时暂不支持设置此链接
VideoPlayTrackURL *[]string `json:"video_play_track_url,omitempty"`
// TrackURLSendType 数据发送方式,不可修改,默认值: SERVER_SEND
// 允许值: SERVER_SEND(服务器端上传), CLIENT_SEND(客户端上传)
// 客户端上传是指由客户端直接上报给监测平台的服务器, 只有白名单用户才可使用CLIENT_SEND(客户端上传), 如果需要开通请找对接的销售、运营
TrackURLSendType string `json:"track_url_send_type,omitempty"`
// AutoUpdateKeyword 是否开启自动加词,ON 开启、OFF 关闭
AutoUpdateKeyword enum.OnOff `json:"auto_update_keyword,omitempty"`
}
CreateRequest 创建计划 API Request
func (CreateRequest) Encode ¶ added in v1.3.0
func (r CreateRequest) Encode() []byte
Encode implement PostRequest interface
type CreateResponse ¶ added in v1.3.0
type CreateResponse struct {
model.BaseResponse
// Data json返回值
Data struct {
// AdID 广告ID
AdID uint64 `json:"ad_id,omitempty"`
} `json:"data,omitempty"`
}
CreateResponse 创建广告计划 API Response
type CreativeReject ¶ added in v1.6.39
type CreativeReject struct {
// CreativeID 创意 id
CreativeID uint64 `json:"creative_id,omitempty"`
// RejectData 审核建议数据
RejectData []RejectData `json:"reject_data,omitempty"`
// MaterialReject 自定义创意的素材维度审核建议。字段和下面程序化创意素材维度审核建议完全相同。
MaterialReject []MaterialReject `json:"material_reject,omitempty"`
}
CreativeReject 创意维度审核建议
type DpaProductTarget ¶
type DpaProductTarget struct {
// Title 筛选字段
Title string `json:"title,omitempty"`
// Rule 定向规则,允许值:'=', '!=', '>', '<', '>=', '<=', 'contain', 'exclude', 'notEmpty
Rule string `json:"rule,omitempty"`
// Type 字段类型,允许值:'int', 'double', 'long', 'string'
Type string `json:"type,omitempty"`
// Value 规则值
Value string `json:"value,omitempty"`
}
DpaProductTarget 商品投放条件
type GetFiltering ¶
type GetFiltering struct {
// IDs 按广告计划ID过滤,范围为1-100
IDs []uint64 `json:"ids,omitempty"`
// AdName 按广告计划name过滤,长度为1-30个字符
AdName string `json:"ad_name,omitempty"`
// PricingList 按出价方式过滤
PricingList enum.PricingType `json:"pricing_list,omitempty"`
// Status 按计划状态过滤,默认为返回“所有不包含已删除”,如果要返回所有包含已删除有对应枚举表示
Status enum.AdStatus `json:"status,omitempty"`
// AdCreateTime 广告计划创建时间,格式"yyyy-mm-dd",表示过滤出当天创建的广告计划
AdCreateTime string `json:"ad_create_time,omitempty"`
// AdModifyTime 广告计划更新时间,格式"yyyy-mm-dd",表示过滤出当天更新的广告计划
AdModifyTime string `json:"ad_modify_time,omitempty"`
}
GetFiltering 过滤条件
func (GetFiltering) GetCreateTime ¶ added in v1.9.19
func (f GetFiltering) GetCreateTime() string
func (GetFiltering) GetIDs ¶ added in v1.9.19
func (f GetFiltering) GetIDs() []uint64
func (GetFiltering) GetModifyTime ¶ added in v1.9.19
func (f GetFiltering) GetModifyTime() string
func (GetFiltering) GetName ¶ added in v1.9.19
func (f GetFiltering) GetName() string
type GetRequest ¶
type GetRequest struct {
// AdvertiserID 广告主ID
AdvertiserID uint64 `json:"advertiser_id,omitempty"`
// Filtering 过滤条件
Filtering *GetFiltering `json:"filtering,omitempty"`
// Fields 查询字段集合, 如果指定, 则返回结果数组中, 每个元素是包含所查询字段的字典允许值: "id", "name", "budget", "budget_mode", "status", "opt_status","open_url", "modify_time", "start_time", "end_time", "bid","advertiser_id", "pricing", "flow_control_mode", "download_url", quick_app_url, "inventory_type", "schedule_type", "app_type", "cpa_bid","cpa_skip_first_phrase", "audience", "external_url", "package","campaign_id", "ad_modify_time", "ad_create_time","audit_reject_reason", "retargeting_type", "retargeting_tags","convert_id", "interest_tags", "hide_if_converted","external_actions", "device_type","auto_extend_enabled", "auto_extend_targets", "dpa_lbs", "dpa_city", "dpa_province", "dpa_recommend_type", "roi_goal","subscribe_url","form_id","form_index","app_desc","app_thumbnails"
Fields []string `json:"fields,omitempty"`
// Page 页数默认值: 1,page必须大于0
Page int `json:"page,omitempty"`
// PageSize 页面大小默认值:10,page_size范围为1-1000
PageSize int `json:"page_size,omitempty"`
}
GetRequest 获取广告计划 API Request
func (GetRequest) Encode ¶
func (r GetRequest) Encode() string
Encode implement GetRequest interface
type GetResponse ¶
type GetResponse struct {
model.BaseResponse
// Data json返回值
Data *GetResponseData `json:"data,omitempty"`
}
GetResponse 获取广告计划 API Response
type GetResponseData ¶
type GetResponseData struct {
// List 广告数组
List []Ad `json:"list,omitempty"`
// PageInfo 分页信息
PageInfo *model.PageInfo `json:"page_info,omitempty"`
}
GetResponseData json返回值
type IListFilter ¶ added in v1.9.19
type MaterialReject ¶ added in v1.6.39
type MaterialReject struct {
// Title 标题
Title string `json:"title,omitempty"`
// ImageID 图片 id
ImageID []string `json:"image_id,omitempty"`
// VideoID 视频 id
VideoID string `json:"video_id,omitempty"`
// RejectReason 审核建议
RejectReason string `json:"reject_reason,omitempty"`
}
MaterialReject 创意的素材维度审核建议
type RejectData ¶ added in v1.6.39
type RejectData struct {
// RejectItem 审核项
RejectItem string `json:"reject_item,omitempty"`
// RejectReason 审核建议
RejectReason string `json:"reject_reason,omitempty"`
}
RejectData 审核建议数据
type RejectReason ¶ added in v1.6.39
type RejectReason struct {
// AdReject 计划维度审核建议
AdReject *AdReject `json:"ad_reject,omitempty"`
// CreativeReject 创意维度审核建议
CreativeReject []CreativeReject `json:"creative_reject,omitempty"`
// MaterialReject 程序化创意的素材维度审核建议
MaterialReject []MaterialReject `json:"material_reject,omitempty"`
// IsProcedualAd 1 表示程序化创意,0 表示自定义创意
IsProcedualAd int `json:"is_procedual_ad,omitempty"`
}
RejectReason 计划审核意见
type RejectReasonRequest ¶ added in v1.6.39
type RejectReasonRequest struct {
// AdvertiserID 广告主ID
AdvertiserID uint64 `json:"advertiser_id,omitempty"`
// AdIDs 广告计划 ID,最多传10个广告计划ID
AdIDs []uint64 `json:"ad_ids,omitempty"`
}
RejectReasonRequest 获取计划审核建议 API Request
func (RejectReasonRequest) Encode ¶ added in v1.6.39
func (r RejectReasonRequest) Encode() string
Encode implement GetRequest interface
type RejectReasonResponse ¶ added in v1.6.39
type RejectReasonResponse struct {
model.BaseResponse
Data struct {
List []RejectReason `json:"list,omitempty"`
} `json:"data,omitempty"`
}
RejectReasonResponse 获取计划审核建议 API Response
type UpdateBidRequest ¶
type UpdateBidRequest struct {
// AdvertiserID 广告主ID
AdvertiserID uint64 `json:"advertiser_id,omitempty"`
// Data 批量修改,包含计划id和出价
Data []UpdateBidRequestList `json:"data,omitempty"`
}
UpdateBidRequest 更新计划出价 API Request
func (UpdateBidRequest) Encode ¶
func (r UpdateBidRequest) Encode() []byte
Encode implement PostRequest interface
type UpdateBidRequestList ¶
type UpdateBidRequestList struct {
// AdID 广告计划ID,广告计划ID需要属于广告主
AdID uint64 `json:"ad_id,omitempty"`
// Bid 出价,单位“元”,精度:两位小数。
Bid float64 `json:"bid,omitempty"`
}
UpdateBidRequestList 修改信息
type UpdateBudgetRequest ¶
type UpdateBudgetRequest struct {
// AdvertiserID 广告主ID
AdvertiserID uint64 `json:"advertiser_id,omitempty"`
// Data 批量修改,包含计划id和出价
Data []UpdateBudgetRequestList `json:"data,omitempty"`
}
UpdateBudgetRequest 更新计划预算 API Request
func (UpdateBudgetRequest) Encode ¶
func (r UpdateBudgetRequest) Encode() []byte
Encode implement PostRequest interface
type UpdateBudgetRequestList ¶
type UpdateBudgetRequestList struct {
// AdID 广告计划ID,广告计划ID需要属于广告主
AdID uint64 `json:"ad_id,omitempty"`
// Budget 预算,单位“元”,精度:两位小数。
Budget float64 `json:"budget,omitempty"`
}
UpdateBudgetRequestList 修改信息
type UpdateError ¶ added in v1.2.3
type UpdateError struct {
// AdID 广告计划ID
AdID uint64 `json:"ad_id,omitempty"`
// ErrorMessage 错误信息
ErrorMessage string `json:"error_message"`
}
UpdateError 更新失败的广告计划
func (UpdateError) Error ¶ added in v1.17.6
func (r UpdateError) Error() string
Error implement error interface
type UpdateRequest ¶ added in v1.2.12
type UpdateRequest struct {
// AdvertiserID 广告主ID
AdvertiserID uint64 `json:"advertiser_id,omitempty"`
// AdID 广告计划ID,广告计划id需要属于广告主,且ad_id不能重复,否则会报错!
AdID uint64 `json:"ad_id,omitempty"`
// Name 广告计划名称,长度为1-100个字符,其中1个中文字符算2位
Name string `json:"name,omitempty"`
// DownloadMode 优先从系统应用商店下载(下载模式),当下载方式为下载链接时,可修改。允许值:APP_STORE_DELIVERY(仅安卓应用下载支持)、 DEFAULT当应用下载时,默认default下载,可选用APP_STORE_DELIVERY(应用商店直投),选择后,将优先跳转目标应用对应手机系统应用商店安装详情页,跳转失败则使用下载链接下载。
DownloadMode enum.DownloadMode `json:"download_mode,omitempty"`
// OpenUrl 直达链接(点击唤起APP)直达链接仅支持部分App唤起,点击创意将优先跳转App,再根据投放内容跳转相关链接
OpenUrl *string `json:"open_url,omitempty"`
// Ulink 直达备用链接,仅支持穿山甲广告位(不支持搜索广告)
Ulink *string `json:"ulink,omitempty"`
// ExternalUrl 落地页链接(支持橙子建站落地页);对于转化量为目标的计划如OCPM计划不允许更改,非转化为目标的计划如CPC、CPM计划可更改; 获取橙子建站落地页可参考【橙子建站落地页管理】
ExternalUrl string `json:"external_url,omitempty"`
// CategoryType 商品目录投放范围,当广告组商品类型选择 DPA 多商品时可修改;允许值:NONE不限,"CATEGORY"选择分类,"PRODUCT"指定商品
CategoryType string `json:"category_type,omitempty"`
// DpaCategories 分类列表,category_type更新为"CATEGORY"时可修改,由【DPA商品广告-获取DPA分类】 得到限制个数1~100
DpaCategories *[]uint64 `json:"dpa_categories,omitempty"`
// DpaProducts 商品列表,category_type更新为"PRODUCT"时可修改,由【DPA商品广告-获取DPA商品库商品列表】 得到;限制个数1~100
DpaProducts *[]uint64 `json:"dpa_products,omitempty"`
// DpaProductTargets 自定义筛选条件(商品投放条件)。用于圈定商品投放范围,结合商品库字段搭配判断条件,圈定商品投放范围。
DpaProductTarget *[]DpaProductTarget `json:"dpa_product_targets,omitempty"`
// ParamsType 链接类型(落地页),当dpa_adtype为"DPA_LINK"时有值,取值: "DPA"商品库所含链接, "CUSTOM"自定义链接
ParamsType string `json:"params_type,omitempty"`
// DpaExternalUrlField 落地页链接字段选择,当params_type为"DPA"时有值
DpaExternalUrlField string `json:"dpa_external_url_field,omitempty"`
// DpaExternalUrls 落地页链接地址列表,当params_type为"CUSTOM"时有值
DpaExternalUrls *[]string `json:"dpa_external_urls,omitempty"`
// AppType 下载类型,当推广类型为应用推广且download_type为DOWNLOAD_URL或者QUICK_APP_URL时或当推广类型为DPA(商品目录推广)且dpa_adtype为DPA_APP有值
AppType string `json:"app_type,omitempty"`
// DownloadUrl 应用下载方式,推广目的为APP时有值。返回值:DOWNLOAD_URL下载链接,QUICK_APP_URL快应用+下载链接,EXTERNAL_URL落地页链接
DownloadUrl string `json:"download_url,omitempty"`
// Package 应用包名,当推广类型为应用推广且download_type为DOWNLOAD_URL时或当推广类型为DPA(商品目录推广)且dpa_adtype为DPA_APP有值
Package string `json:"package,omitempty"`
// DpaOpenUrlType 直达链接类型,取值: "NONE"不启用, "DPA"商品库所含链接, "CUSTOM"自定义链接商品库链接对应商品库内调起字段。
DpaOpenUrlType string `json:"dpa_open_url_type,omitempty"`
// DpaOpenUrlField 直达链接字段选择,当dpa_open_url_type为"DPA"时有值
DpaOpenUrlField string `json:"dpa_open_url_field,omitempty"`
// DpaOpenUrls 直达链接地址列表,当dpa_open_url_type为"CUSTOM"时有值
DpaOpenUrls *[]string `json:"dpa_open_urls,omitempty"`
// ExternalUrlParams 落地页检测参数(DPA推广目的特有,在填写的参数后面添加"=urlencode(开放平台提供的h5链接地址)",其中urlencode(开放平台提供的h5链接地址)替换为商品库中的h5地址encode的结果)
ExternalUrlParams string `json:"external_url_params,omitempty"`
// OpenUrlParams 直达链接检测参数(DPA推广目的特有,在“产品库中提取的scheme地址"后面追加填写的参数)
OpenUrlParams string `json:"open_url_params,omitempty"`
// FeedDeliverySearch 搜索快投关键词,HAS_OPEN:启用,DISABLE:不启用
FeedDeliverySearch string `json:"feed_delivery_search,omitempty"`
// IntelligentFlowSwitch 智能流量开关,ON:开启,OFF:关闭
IntelligentFlowSwitch enum.OnOff `json:"intelligent_flow_switch,omitempty"`
// AudiencePackageID 定向包ID
AudiencePackageID uint64 `json:"audience_package_id,omitempty"`
// District 地域;取值: "CITY"省市, "COUNTY"区县, "BUSINESS_DISTRICT"商圈,"NONE"不限,省市传法:"city": [12],"district": "CITY",区县的传法:"city": [130102],"district": "COUNTY";暂不支持"海外"
District enum.District `json:"district,omitempty"`
// RegionVersion 行政区域版本号。通过[【获取行政信息】]https://open.oceanengine.com/doc/index.html?key=ad&type=api&id=1709606596424718)接口获取; district =REGION/OVERSEA时必填
RegionVersion string `json:"region_version,omitempty"`
// City 地域定向省市或者区县列表(当传递省份ID时,旗下市县ID可省略不传),当district为"CITY"或"COUNTY"时有值
City *[]uint64 `json:"city,omitempty"`
// BusinessIDs 商圈ID数组,district为"BUSINESS_DISTRICT"时有值
BusinessIDs *[]uint64 `json:"business_ids,omitempty"`
// Geolocation 从地图添加(地图位置)
Geolocation *[]model.Geolocation `json:"geolocation,omitempty"`
// LocationType 位置类型;取值:CURRENT正在该地区的用户,HOME居住在该地区的用户,TRAVEL到该地区旅行的用户,ALL该地区内的所有用户;当city和district有值时返回值
LocationType enum.LocationType `json:"location_type,omitempty"`
// Gender 性别
Gender enum.AudienceGender `json:"gender,omitempty"`
// Age 年龄
Age *[]enum.AudienceAge `json:"age,omitempty"`
// Carreer 职业选项,详见【附录-职业】
Career *[]string `json:"career,omitempty"`
// RetargetingTagsInclude 定向人群包列表(自定义人群),内容为人群包id。如果选择"同时定向与排除",需传入retargeting_tags_include和retargeting_tags_exclude
RetargetingTagsInclude *[]uint64 `json:"retargeting_tags_include,omitempty"`
// RetargetingTagsExclude 排除人群包列表(自定义人群),内容为人群包id。如果选择"同时定向与排除",需传入retargeting_tags_include和retargeting_tags_exclude
RetargetingTagsExclude *[]uint64 `json:"retargeting_tags_exclude,omitempty"`
// InterestActionMode 行为兴趣;取值:"UNLIMITED"不限,"CUSTOM"自定义,"RECOMMEND"系统推荐。若与自定义人群同时使用,系统推荐("RECOMMEND")不生效;仅推广范围为默认时可填,且不可与老版行为兴趣定向同时填写,否则会报错
InterestActionMode enum.InterestActionMode `json:"interest_action_mode,omitempty"`
// ActionScene 行为场景
ActionScene *[]enum.ActionScene `json:"action_scene,omitempty"`
// ActionDays 用户发生行为天数,当interest_action_mode传CUSTOM时有效
ActionDays uint `json:"action_days,omitempty"`
// ActionCategories 行为类目词,当interest_action_mode传CUSTOM时有效
ActionCategories *[]uint64 `json:"action_categories,omitempty"`
// ActionWords 行为关键词,当interest_action_mode传CUSTOM时有效
ActionWords *[]uint64 `json:"action_words,omitempty"`
// InterestCategories 兴趣类目词,当interest_action_mode传CUSTOM时有效
InterestCategories *[]uint64 `json:"interest_categories,omitempty"`
// InterestWords 兴趣关键词, 传入具体的词id,非兴趣词包id,可以通过词包相关接口或者兴趣关键词word2id接口获取词id,一个计划下最多创建1000个关键词。当interest_action_mode传CUSTOM时有效
InterestWords *[]uint64 `json:"interest_words,omitempty"`
// AwemeFanBehaviors 抖音达人互动用户行为类型
AwemeFanBehaviors *[]enum.Behavior `json:"aweme_fan_behaviors,omitempty"`
// AwemeFanTimeScope
AwemeFanTimeScope string `json:"aweme_fan_time_scope,omitempty"`
// AwemeFanCategories 抖音达人分类ID列表,与aweme_fan_behaviors同时设置才会生效(抖音达人定向)
AwemeFanCategories *[]uint64 `json:"aweme_fan_categories,omitempty"`
// AwemeFanAccounts 抖音达人ID列表,与aweme_fan_behaviors同时设置才会生效(抖音达人定向)
AwemeFanAccounts *[]uint64 `json:"aweme_fan_accounts,omitempty"`
// FilterAwemeAbnormalActive (抖音号推广特有)过滤高活跃用户; 取值:0表示不过滤,1表示过滤
FilterAwemeAbnormalActive *int `json:"filter_aweme_abnormal_active,omitempty"`
// FilterAwemeFansCount (抖音号推广特有)过滤高关注数用户,例如"filter_aweme_fans_count": 1000表示过滤粉丝数在1000以上的用户
FilterAwemeFansCount *int64 `json:"filter_aweme_fans_count,omitempty"`
// FilterOwnAwemeFans (抖音号推广特有)过滤自己的粉丝; 取值:0表示不过滤,1表示过滤
FilterOwnAwemeFans *int `json:"filter_own_aweme_fans,omitempty"`
// SuperiorPopularityType 媒体定向;
SuperiorPopularityType enum.SuperiorPopularityType `json:"superior_popularity_type,omitempty"`
// FlowPackage 定向逻辑
FlowPackage *[]uint64 `json:"flow_package,omitempty"`
// ExcludeFlowPackage 排除定向逻辑
ExcludeFlowPackage *[]uint64 `json:"exclude_flow_package,omitempty"`
// Platform 平台,当下载方式包含下载链接时,平台类型需与选择的下载链接类型对应,当下载方式不包含下载方式的时候,平台可多选。为保证投放效果,平台类型定向PC与移动端互斥
Platform *[]enum.AudiencePlatform `json:"platform,omitempty"`
// AndroidOsv 最低安卓版本,当app_type为"APP_ANDROID"选填,其余情况不填,
AndroidOsv string `json:"android_osv,omitempty"`
// IosOsv 最低IOS版本,当app_type为"APP_IOS"选填,其余情况不填
IosOsv string `json:"ios_osv,omitempty"`
// DeviceType 设备类型;取值是:"MOBILE", "PAD"。缺省表示不限设备类型。穿山甲已经全量,投放范围为默认时需要有白名单权限才可以
DeviceType *[]string `json:"device_type,omitempty"`
// Ac 网络类型
Ac *[]string `json:"ac,omitempty"`
// Carrier 运营商
Carrier *[]enum.Carrier `json:"carrier,omitempty"`
// HideIfExists 过滤已安装,当推广目标为安卓应用下载时可填,0表示不限,1表示过滤,2表示定向。默认为不限;默认值:0; 取值: 0, 1, 2。建议促进app活跃度客户使用定向安装功能。选择定向安装时,向已安装客户展示广告;投放时优先获取直达链接,无直达链接时使用应用包名进行投放;如果无直达链接或应用包名,定向安装选项实际不生效;仅对Android链接生效。
HideIfExists *int `json:"hide_if_exists,omitempty"`
// HideIfConverted 过滤已转化用户
HideIfConverted enum.HideIfConverted `json:"hide_if_converted,omitempty"`
// ConvertedTimeDuration 过滤时间范围
ConvertedTimeDuration enum.ConvertedTimeDuration `json:"converted_time_duration,omitempty"`
// ActivateType 新用户(新用户使用头条的时间)
ActivateType *[]enum.ActivateType `json:"activate_type,omitempty"`
// ArticleCategory 文章分类
ArticleCategory *[]string `json:"article_category,omitempty"`
// DeviceBrand 手机品牌
DeviceBrand *[]string `json:"device_brand,omitempty"`
// LauchPrice 手机价格,传入价格区间,最高传入11000(表示1w以上);传值示例 "launch_price": [2000, 11000],表示2000元以上;
LaunchPrice *[]int `json:"launch_price,omitempty"`
// AutoExtendEnabled 是否启用智能放量。取值是:0、1。缺省为 0。
AutoExtendEnabled *int `json:"auto_extend_enabled,omitempty"`
// AutoExtendTarget 可放开定向。当auto_extend_enabled=1 时选填。详见:【附录-可开放定向】。缺省为全不选。
AutoExtendTarget *[]string `json:"auto_extend_targets,omitempty"`
// DpaLbs 地域匹配-LBS;开启时,根据用户的地理位置信息,给用户投放位于其附近的产品 ;取值:0,1(0表示不启用,1表示启用)
DpaLbs *int `json:"dpa_lbs,omitempty"`
// DpaCity 地域匹配-商品所在城市;开启时,仅将商品投放给位于该商品设置的可投城市的用户 ;取值:0,1(0表示不启用,1表示启用)
DpaCity *int `json:"dpa_city,omitempty"`
// DpaProvince 地域匹配-商品所在省份;开启时,将商品仅投放给位于该商品设置的可投省份的用户 ;取值:0,1(0表示不启用,1表示启用)
DpaProvince *int `json:"dpa_province,omitempty"`
// DpaLocationAudience DPA行为重定向,0:不启用,1:启用
DpaLocationAudience *int `json:"dap_location_audience,omitempty"`
// IncludeCustomActions 包含人群包((DPA推广目的特有,格式举例[{"days": 7, "code": 1001},], dpa_local_audience为1时有值; day可选范围:1, 7, 14, 28, 60, 90, 120, 180。
IncludeCustomActions json.RawMessage `json:"include_custom_actions,omitempty"`
// ExcludeCustomActions 排除人群包((DPA推广目的特有,格式举例{"days": 7, "code": 1002},],day可选范围: 1, 7, 14, 28, 60, 90, 120, 180。
ExcludeCustomActions json.RawMessage `json:"exclude_custom_actions,omitempty"`
// DpaRecommendType dpa商品重定向推荐类型,dpa_local_audience为1时有值;取值:1(基于重定向推荐更多商品(根据重定向商品和行业特点,推荐更多相关商品投放,包含重定向商品),2仅重定向商品(仅根据重定向人群内定义的重定向行为商品进行投放)
DpaRecommendType int `json:"dpa_recommend_type,omitempty"`
// AdjustCpa 是否调整自动出价,意味如果预期成本不在范围内将在此基础上调整,仅OCPM支持,当smart_bid_type=SMART_BID_CONSERVATIVE时选填。当smart_bid_type为"SMART_BID_CONSERVATIVE"且adjust_cpa=0时,cpa_bid由系统自动计算;;当smart_bid_type为"SMART_BID_CONSERVATIVE" 且adjust_cpa=1时,cpa_bid必填
AdjustCpa *int `json:"adjust_cpa,omitempty"`
// FlowControlMode 竞价策略(投放方式)
FlowControlMode enum.FlowControlMode `json:"flow_control_mode,omitempty"`
// Budget 预算
Budget float64 `json:"budget,omitempty"`
// ScheduleType 投放时间类型
ScheduleType enum.ScheduleType `json:"schedule_type,omitempty"`
// StartTime 投放起始时间,当schedule_type为"SCHEDULE_START_END"时取值,形式如:2017-01-01 00:00
StartTime string `json:"start_time,omitempty"`
// EndTime 投放结束时间,当schedule_type为"SCHEDULE_START_END"时取值,形式如:2017-01-01 00:00
EndTime string `json:"end_time,omitempty"`
// ScheduleTime 投放时段,默认全时段投放,格式是48*7位字符串,且都是0或1。也就是以半个小时为最小粒度,周一至周日每天分为48个区段,0为不投放,1为投放,不传、全传0、全传1均代表全时段投放。
ScheduleTime string `json:"schedule_time,omitempty"`
// Bid 出价
Bid float64 `json:"bid,omitempty"`
// CpaBid 目标转化出价/预期成本, 当pricing为"OCPM"、"OCPC"出价方式时有值
CpaBid float64 `json:"cpa_bid,omitempty"`
// DeepCpabidid 深度优化出价,deep_bid_type为"DEEP_BID_MIN"时有值。当对应的转化convert_id,设定深度转化目标时才会有效。
DeepCpabidid float64 `json:"deep_cpabidid,omitempty"`
// LubanROiGoal 鲁班目标ROI出价策略系数。推广目的为商品推广(GOODS)时可填。当传入该参数时,表示启用鲁班ROI优化,支持范围(0,100],精度:保留小数点后四位
LubanRoiGoal float64 `json:"luban_roi_goal,omitempty"`
// RoiGoal 深度转化ROI系数, 范围(0,5],精度:保留小数点后四位, deep_bid_type为"ROI_COEFFICIENT"时有值
RoiGoal float64 `json:"roi_goal,omitempty"`
// TargetCvr 目标转化率,转化率优化仅支持电商店铺推广,且付费方式为OCPC或OCPM; 允许值:0~100,0表示关闭转化率优化
TargetCvr float64 `json:"target_cvr,omitempty"`
// TrackURL 展示(监测链接)
TrackURL *[]string `json:"track_url,omitempty"`
// ActionTrackURL 点击(监测链接)只允许传入1个(当推广目的为应用下载且创建计划传递了convert_id,系统会自动获取转化中的点击监测链接)
ActionTrackURL *[]string `json:"action_track_url,omitempty"`
// VideoPlayEffectiveTrackURL 视频有效播放(监测链接),只允许传入1个,投放范围为穿山甲时暂不支持设置此链接
VideoPlayEffectiveTrackURL *[]string `json:"video_play_effective_track_url,omitempty"`
// VideoPlayDoneTrackURL 视频播完(监测链接),只允许传入1个,投放范围为穿山甲时暂不支持设置此链接
VideoPlayDoneTrackURL *[]string `json:"video_play_done_track_url,omitempty"`
// VideoPlayTrackURL 视频播放(监测链接),只允许传入1个,投放范围为穿山甲时暂不支持设置此链接
VideoPlayTrackURL *[]string `json:"video_play_track_url,omitempty"`
// AutoUpdateKeyword 否开启自动加词,允许值:ON(开启)、OFF(关闭)
AutoUpdateKeyword enum.OnOff `json:"auto_update_keyword,omitempty"`
}
UpdateRequest 更新计划 API Request
func (UpdateRequest) Encode ¶ added in v1.2.12
func (r UpdateRequest) Encode() []byte
Encode implement PostRequest interface
type UpdateResponse ¶ added in v1.2.3
type UpdateResponse struct {
model.BaseResponse
// Data json返回值
Data *UpdateResponseData `json:"data,omitempty"`
}
UpdateResponse 更新计划API Response
type UpdateResponseData ¶ added in v1.2.3
type UpdateResponseData struct {
// AdID 广告计划ID
AdID uint64 `json:"ad_id,omitempty"`
// NeedAudit 此次修改是否触发进入待审状态(1表示进入待审状态,0表示不进入待审状态)
NeedAudit int `json:"need_audit,omitempty"`
// AdIDs 广告计划ID集合
AdIDs []uint64 `json:"ad_ids,omitempty"`
// Errors 更新失败的广告计划列表
Errors []UpdateError `json:"errors,omitempty"`
}
UpdateResponseData json返回值
type UpdateStatusRequest ¶
type UpdateStatusRequest struct {
// AdvertiserID 广告主ID
AdvertiserID uint64 `json:"advertiser_id,omitempty"`
// AdIDs 计划ID集合,限制1~100. 广告计划id需属于广告主
AdIDs []uint64 `json:"ad_ids,omitempty"`
// OptStatus 操作, "enable"表示启用, "delete"表示删除, "disable"表示暂停;允许值: "enable", "delete", "disable",; 对于删除的广告组不可进行任何操作,否则会报错哈
OptStatus string `json:"opt_status,omitempty"`
}
UpdateStatusRequest 更新计划状态 API Request
func (UpdateStatusRequest) Encode ¶
func (r UpdateStatusRequest) Encode() []byte
Encode implement PostRequest interface