models

package

v0.0.0-...-85f63e2 Latest Latest Go to latest Published: Apr 1, 2021 License: MIT Imports: 2 Imported by: 0

Details

Valid go.mod file

The Go module system was introduced in Go 1.11 and is the official dependency management solution for Go.
Redistributable license

Redistributable licenses place minimal restrictions on how software can be used, modified, and redistributed.
Tagged version

Modules with tagged versions give importers more predictable builds.
Stable version

When a project reaches major version v1 it is considered stable.
Learn more about best practices

Repository

github.com/cuckooemm/oceanengine

Links

Open Source Insights

Documentation ¶

Index ¶

Constants
type AdAdAddReq
type AdAdAddRsp
type AdAdAddRspData
type AdAdGetFiltering
type AdAdGetOpts
type AdAdGetRsp
type AdAdGetRspData
type AdAdGetRspDataList
type AdAge
type AdAudience
type AdBudgetData
type AdBudgetUpdateReq
type AdBudgetUpdateRsp
type AdBudgetUpdateRspData
type AdCampaignAddReq
type AdCampaignAddRsp
type AdCampaignAddRspData
type AdCampaignGetOpts
type AdCampaignGetOptsFiltering
type AdCampaignGetRsp
type AdCampaignGetRspData
type AdCampaignGetRspDataList
type AdConvertType
type AdCreativeAddReq
type AdCreativeAddRsp
type AdCreativeAddRspData
type AdCreativeUnionVideoType
type AdDeepBidType
type AdDeliveryRange
type AdDistrict
type AdDpaProductTarget
type AdDyActionType
type AdGamePackage
type AdGender
type AdPricingType
type AdStatus
type AdStatusUpdateReq
type AdStatusUpdateRsp
type AdStatusUpdateRspData
type AdvancedCreativeType
type AdvertiserBudgetUpdateReq
type AdvertiserBudgetUpdateRsp
type AdvertiserDailyBudgetRsp
type AdvertiserDailyBudgetRspData
type AdvertiserDailyBudgetRspDataList
type AppDownloadModeType
type AppDownloadType
type BudgetAndBid
type BudgetMode
type CampaignStatus
type CommodityAudience
type Creative
type CreativeCommerceCards
type CreativeImageInfo
type CreativeImageMode
type CreativePromotionCard
type CreativeTitleInfo
type DownloadType
type FlowControlMode
type Geolocation
type ImageInfo
type InventoryType
type LandingType
type LearningPhase
type MaterialImageAddReq
type MaterialImageAddRsp
type MaterialImageAddRspData
type MaterialPushReq
type MaterialPushRsp
type MaterialPushRspData
type MaterialPushRspDataFailList
type MaterialVideoAddReq
type MaterialVideoAddRsp
type MaterialVideoAddRspData
type MaterialVideoCoverGetRsp
type MaterialVideoCoverGetRspData
type MaterialVideoCoverList
type MaterialVideoGetFilter
type MaterialVideoGetOpts
type MaterialVideoGetRsp
type MaterialVideoGetRspData
type MaterialVideoGetRspDataList
type PageInfo
type PushFailReason
- func (p PushFailReason) String() string
type ScheduleType
type SmartBidType
type ToolsADStatExtraInfoRsp
type ToolsActionTextGetOpts
type ToolsActionTextGetRsp
type ToolsAdDiagnosisFunnelData
type ToolsAdDiagnosisFunnelDataAttributions
type ToolsAdDiagnosisFunnelDataRank
type ToolsAdDiagnosisFunnelDataRitResult
type ToolsAdDiagnosisRsp
type ToolsAdDiagnosisRspData
type ToolsAdDiagnosisRspDataList
type ToolsAdQualityRsp
type ToolsAdQualityRspData
type ToolsAdQualityRspDataList
type ToolsAdStatExtraInfoRspData
type ToolsIndustryGetOpts
type ToolsIndustryGetRsp
type ToolsIndustryGetRspData
type ToolsIndustryGetRspDataList
type UploadType
type VideoCoverStatus

Constants ¶

View Source

const (
	BudgetModeInfinite BudgetMode = "BUDGET_MODE_INFINITE" // 不限
	BudgetModeDay      BudgetMode = "BUDGET_MODE_DAY"      // 日预算
	BudgetModeTotal    BudgetMode = "BUDGET_MODE_TOTAL"    // 总预算

	AdStatusEnable  AdStatus = "enable"  // 启用计划
	AdStatusDelete  AdStatus = "delete"  // 删除计划
	AdStatusDisable AdStatus = "disable" // 暂停计划

	LandingTypeLink  LandingType = "LINK"  // 	销售线索收集
	LandingTypeApp   LandingType = "APP"   // 	应用推广
	LandingTypeDpa   LandingType = "DPA"   // 	商品目录推广
	LandingTypeGoods LandingType = "GOODS" // 	商品推广（鲁班）
	LandingTypeStore LandingType = "STORE" // 	门店推广
	LandingTypeAweme LandingType = "AWEME" // 	抖音号推广
	LandingTypeShop  LandingType = "SHOP"  // 	电商店铺推广

	CampaignStatusEnable                 CampaignStatus = "CAMPAIGN_STATUS_ENABLE"                   // 	启用
	CampaignStatusDisable                CampaignStatus = "CAMPAIGN_STATUS_DISABLE"                  // 	暂停
	CampaignStatusDelete                 CampaignStatus = "CAMPAIGN_STATUS_DELETE"                   // 	删除
	CampaignStatusAll                    CampaignStatus = "CAMPAIGN_STATUS_ALL"                      // 	所有包含已删除
	CampaignStatusNotDelete              CampaignStatus = "CAMPAIGN_STATUS_NOT_DELETE"               // 	所有不包含已删除（状态过滤默认值）
	CampaignStatusAdvertiserBudgetExceed CampaignStatus = "CAMPAIGN_STATUS_ADVERTISER_BUDGET_EXCEED" // 	超出广告主日预算

	AdDeliveryRangeDefault   AdDeliveryRange = "DEFAULT"   // 默认
	AdDeliveryRangeUnion     AdDeliveryRange = "UNION"     // 只投放到资讯联盟（穿山甲）
	AdDeliveryRangeUniversal AdDeliveryRange = "UNIVERSAL" // UNIVERSAL	通投智选

	AdCreativeUnionVideoOriginal AdCreativeUnionVideoType = "ORIGINAL_VIDEO" // 	原生视频
	AdCreativeUnionVideoRewarded AdCreativeUnionVideoType = "REWARDED_VIDEO" //	激励视频
	AdCreativeUnionVideoSplash   AdCreativeUnionVideoType = "SPLASH_VIDEO"   //	穿山甲开屏

	DownloadTypeUrl         DownloadType = "DOWNLOAD_URL"  // 下载链接
	DownloadTypeQuickAppUrl DownloadType = "QUICK_APP_URL" // 快应用+下载链接
	DownloadTypeExternalUrl DownloadType = "EXTERNAL_URL"  // 快应用+下载链接

	AppDownloadTypeAndroid AppDownloadType = "APP_ANDROID" // 	Android
	AppDownloadTypeIos     AppDownloadType = "APP_IOS"     // iOS

	AppDownloadModeTypeAppStore AppDownloadModeType = "APP_STORE_DELIVERY" // 仅安卓应用下载支持 (应用商店直投），选择后，将优先跳转目标应用对应手机系统应用商店安装详情页，跳转失败则使用下载链接下载。
	AppDownloadModeTypeDefault  AppDownloadModeType = "DEFAULT"            // 当应用下载时，默认default下载

	AdConvertTypeInter            AdConvertType = "AD_CONVERT_TYPE_INTERACTION"               // 当应用下载时，默认default下载
	AdConvertTypeFollow           AdConvertType = "AD_CONVERT_TYPE_FOLLOW_ACTION"             // 账号关注
	AdConvertTypeComment          AdConvertType = "AD_CONVERT_TYPE_COMMENT_ACTION"            // 视频评论
	AdConvertTypeShare            AdConvertType = "AD_CONVERT_TYPE_SHARE_ACTION"              // 分享
	AdConvertTypeClickLandingPage AdConvertType = "AD_CONVERT_TYPE_CLICK_LANDING_PAGE"        // 访问推广详情页
	AdConvertTypeMessage          AdConvertType = "AD_CONVERT_TYPE_MESSAGE_ACTION"            // 私信消息
	AdConvertTypeLiveEnter        AdConvertType = "AD_CONVERT_TYPE_LIVE_ENTER_ACTION"         // 直播间观看
	AdConvertTypeLiveStayTime     AdConvertType = "AD_CONVERT_TYPE_LIVE_STAY_TIME"            // 直播间停留
	AdConvertTypeClickProduct     AdConvertType = "AD_CONVERT_TYPE_LIVE_CLICK_PRODUCT_ACTION" // 直播间查看商品
	AdConvertTypeLiveGift         AdConvertType = "AD_CONVERT_TYPE_LIVE_GIFT_ACTION"          // 直播间打赏
	AdConvertTypeNewFollow        AdConvertType = "AD_CONVERT_TYPE_NEW_FOLLOW_ACTION"         // 粉丝增长

	AdDistrictCity     AdDistrict = "CITY"              // 省市
	AdDistrictCounty   AdDistrict = "COUNTY"            // 区县
	AdDistrictBusiness AdDistrict = "BUSINESS_DISTRICT" // 商圈
	AdDistrictNone     AdDistrict = "NONE"              // 不限

	AdGenderNone   AdGender = "NONE"          // 不限
	AdGenderFemale AdGender = "GENDER_FEMALE" // 女
	AdGenderMale   AdGender = "GENDER_MALE"   // 男

	AdAgeBetween_18_23 AdAge = "AGE_BETWEEN_18_23" // 18-23 岁
	AdAgeBetween_24_30 AdAge = "AGE_BETWEEN_24_30"
	AdAgeBetween_31_40 AdAge = "AGE_BETWEEN_31_40"
	AdAgeBetween_41_49 AdAge = "AGE_BETWEEN_41_49"
	AdAgeAbove_50      AdAge = "AGE_ABOVE_50"

	DyActionTypeFollow  AdDyActionType = "FOLLOWED_USER"  // 已关注用户
	DyActionTypeComment AdDyActionType = "COMMENTED_USER" // 视频互动-已评论用户
	DyActionTypeLiked   AdDyActionType = "LIKED_USER"     // 视频互动-已点赞用户
	DyActionTypeShared  AdDyActionType = "SHARED_USER"    // 视频互动-已分享用户

	AdPricingTypeCPC  AdPricingType = "PRICING_CPC"  // CPC ，出价范围（单位元）:0.2-100，日预算范围（单位元）：大于100，总预算范围：大于最低日预算乘投放天数
	AdPricingTypeCPM  AdPricingType = "PRICING_CPM"  // CPM ，出价范围（单位元）: 4-100，日预算范围（单位元）：大于100，总预算范围：大于最低日预算乘投放天数
	AdPricingTypeOCPC AdPricingType = "PRICING_OCPC" // OCPC（已下线，仅投放范围为穿山甲可用）
	AdPricingTypeOCPM AdPricingType = "PRICING_OCPM" // OCPM，出价范围（单位元）:0.1-10000，日预算范围（单位元）：大于300，总预算范围：大于最低日预算乘投放天数
	AdPricingTypeCPV  AdPricingType = "PRICING_CPV"  // CPV ，出价范围（单位元）:0.07-100，日预算范围（单位元）：大于100，总预算范围：大于最低日预算乘投放天数（CPV广告只支持投放到头条系广告位，不支持投放到视频信息流如西瓜、火山、抖音）
	AdPricingTypeCPA  AdPricingType = "PRICING_CPA"  // CPA

	SmartBidTypeCustom       SmartBidType = "SMART_BID_CUSTOM"       // 	常规投放：控制成本，尽量消耗完预算
	SmartBidTypeConservative SmartBidType = "SMART_BID_CONSERVATIVE" // 	放量投放：接受成本上浮，尽量消耗更多预算

	FlowControlModeFast    FlowControlMode = "FLOW_CONTROL_MODE_FAST"    // 	优先跑量（对应CPC的加速投放）
	FlowControlModeSmooth  FlowControlMode = "FLOW_CONTROL_MODE_SMOOTH"  // 	优先低成本（对应CPC的标准投放）
	FlowControlModeBalance FlowControlMode = "FLOW_CONTROL_MODE_BALANCE" // 	均衡投放（新增字段）

	ScheduleTypeNow      ScheduleType = "SCHEDULE_FROM_NOW"  // 	从今天起长期投放
	ScheduleTypeStartEnd ScheduleType = "SCHEDULE_START_END" // 	设置开始和结束日期

	AdDeepBidTypeDefault            AdDeepBidType = "DEEP_BID_DEFAULT"      // 	无深度优化
	AdDeepBidTypePacing             AdDeepBidType = "DEEP_BID_PACING"       // 自动优化
	AdDeepBidTypeMin                AdDeepBidType = "DEEP_BID_MIN"          // 自定义双出价
	AdDeepBidTypeROICoefficient     AdDeepBidType = "ROI_COEFFICIENT"       // ROI系数
	AdDeepBidTypeROIPacing          AdDeepBidType = "ROI_PACING"            // ROI自动出价
	AdDeepBidTypeMinSecondStage     AdDeepBidType = "MIN_SECOND_STAGE"      // 自定义两阶段
	AdDeepBidTypePacingSecondStage  AdDeepBidType = "PACING_SECOND_STAGE"   // 动态两阶段
	AdDeepBidTypeSmartBid           AdDeepBidType = "SMARTBID"              // 	自动出价
	AdDeepBidTypeAutoMinSecondStage AdDeepBidType = "AUTO_MIN_SECOND_STAGE" // 	自动出价两阶段
	AdDeepBidTypeBidPerAction       AdDeepBidType = "BID_PER_ACTION"        // 	每次付费出价

	InventoryFeed              InventoryType = "INVENTORY_FEED"              // 头条信息流（广告投放）
	InventoryVideoFeed         InventoryType = "INVENTORY_VIDEO_FEED"        // 西瓜信息流（广告投放）
	InventoryHotsoonFeed       InventoryType = "INVENTORY_HOTSOON_FEED"      // 火山信息流（广告投放）
	InventoryAwemeFeed         InventoryType = "INVENTORY_AWEME_FEED"        // 抖音信息流（广告投放）
	InventoryUnionSlot         InventoryType = "INVENTORY_UNION_SLOT"        // 穿山甲（广告投放）
	InventoryUnionBoutiqueGame InventoryType = "UNION_BOUTIQUE_GAME"         // 穿山甲精选休闲游戏（广告投放）
	InventoryUnionSplashSlot   InventoryType = "INVENTORY_UNION_SPLASH_SLOT" // 穿山甲开屏广告（广告投放）
	InventoryAwemeSearch       InventoryType = "INVENTORY_AWEME_SEARCH"      // 搜索广告——抖音位（广告投放）
	InventorySearch            InventoryType = "INVENTORY_SEARCH"            // 搜索广告——头条位（广告投放）
	InventoryUniversal         InventoryType = "INVENTORY_UNIVERSAL"         // 通投智选（广告投放）
	InventoryDeauty            InventoryType = "INVENTORY_BEAUTY"            // 轻颜相机
	InventoryPIPIXIA           InventoryType = "INVENTORY_PIPIXIA"           // 皮皮虾
	InventoryAutomobile        InventoryType = "INVENTORY_AUTOMOBILE"        // 懂车帝
	InventoryStudy             InventoryType = "INVENTORY_STUDY"             // 好好学习
	InventoryFaceU             InventoryType = "INVENTORY_FACE_U"            // faceu

	AttachedCreativeNone           AdvancedCreativeType = "ATTACHED_CREATIVE_NONE"            // 无
	AttachedCreativePhone          AdvancedCreativeType = "ATTACHED_CREATIVE_PHONE"           // 电话拨打
	AttachedCreativeForm           AdvancedCreativeType = "ATTACHED_CREATIVE_FORM"            // 表单收集
	AttachedCreativeCommerceCard   AdvancedCreativeType = "ATTACHED_CREATIVE_COMMERCE_CARD"   // 电商（即落地页）卡片
	AttachedCreativeDownloadCard   AdvancedCreativeType = "ATTACHED_CREATIVE_DOWNLOAD_CARD"   // 商品下载卡片
	AttachedCreativeConsultant     AdvancedCreativeType = "ATTACHED_CREATIVE_CONSULTANT"      // 	在线咨询
	AttachedCreativeCoupon         AdvancedCreativeType = "ATTACHED_CREATIVE_COUPON"          // 	卡券
	AttachedCreativeCard           AdvancedCreativeType = "ATTACHED_CREATIVE_CARD"            // 	图片磁贴
	AttachedCreativeInteract       AdvancedCreativeType = "ATTACHED_CREATIVE_INTERACT"        // 选择磁贴
	AttachedCreativeSmartPhone     AdvancedCreativeType = "ATTACHED_CREATIVE_SMART_PHONE"     // 智能电话
	AttachedCreativeVoteInteract   AdvancedCreativeType = "ATTACHED_CREATIVE_VOTE_INTERACT"   // 投票磁贴
	AttachedCreativeGamePackage    AdvancedCreativeType = "ATTACHED_CREATIVE_GAME_PACKAGE"    // 游戏礼包
	AttachedCreativeCouponInteract AdvancedCreativeType = "ATTACHED_CREATIVE_COUPON_INTERACT" // 优惠券磁贴
	AttachedCreativeGameForm       AdvancedCreativeType = "ATTACHED_CREATIVE_GAME_FORM"       // 游戏表单收集
	AttachedCreativeGameSubscribe  AdvancedCreativeType = "ATTACHED_CREATIVE_GAME_SUBSCRIBE"  // 游戏预约按钮

	UploadByFile UploadType = "UPLOAD_BY_FILE" // 文件
	UploadByUrl  UploadType = "UPLOAD_BY_URL"  // url

	VideoCoverStatusRunning VideoCoverStatus = "RUNNING" // 生成中
	VideoCoverStatusSuccess VideoCoverStatus = "SUCCESS" // 成功
	VideoCoverStatusFailed  VideoCoverStatus = "FAILED"  // 失败

	CreativeImageModeSmall              CreativeImageMode = "CREATIVE_IMAGE_MODE_SMALL"              // 小图，宽高比1.52，大小1.5M以下，下限：456 & 300，上限：1368 & 900
	CreativeImageModeLarge              CreativeImageMode = "CREATIVE_IMAGE_MODE_LARGE"              // 大图，横版大图宽高比1.78，大小1.5M以下，下限：1280 & 720，上限：2560 & 1440
	CreativeImageModeGroup              CreativeImageMode = "CREATIVE_IMAGE_MODE_GROUP"              // 组图，宽高比1.52，大小1.5M以下，下限：456 & 300，上限：1368 & 900
	CreativeImageModeVideo              CreativeImageMode = "CREATIVE_IMAGE_MODE_VIDEO"              // 横版视频，封面图宽高比1.78（下限：1280 & 720，上限：2560 & 1440））,视频资源支持mp4、mpeg、3gp、avi文件格式，宽高比16:9，大小不超过1000M
	CreativeImageModeGif                CreativeImageMode = "CREATIVE_IMAGE_MODE_GIF"                // GIF图,宽高比(690, 388),大小不超过1.5M
	CreativeImageModeLargeVertical      CreativeImageMode = "CREATIVE_IMAGE_MODE_LARGE_VERTICAL"     // 大图竖图，宽高比0.56，大小1.5M以下，下限：720 & 1280，上限：1440 & 2560
	CreativeImageModeVideoVertical      CreativeImageMode = "CREATIVE_IMAGE_MODE_VIDEO_VERTICAL"     // 竖版视频，封面图宽高比0.56（9:16），下限：720 & 1280，上限：1440 & 2560，视频资源支持mp4、mpeg、3gp、avi文件格式，大小不超过100M
	CreativeImageModeSearchAdImage      CreativeImageMode = "TOUTIAO_SEARCH_AD_IMAGE"                // 搜索大图 仅限搜索广告使用，下限：345 & 138，上限：690 & 276
	CreativeImageModeSearchAdSmallImage CreativeImageMode = "SEARCH_AD_SMALL_IMAGE"                  // 搜索小图 仅限搜索广告使用，下限：108 & 72，上限：432 & 288
	CreativeImageModeUnionSplash        CreativeImageMode = "CREATIVE_IMAGE_MODE_UNION_SPLASH"       // 	穿山甲开屏图片 仅限穿山甲开屏使用，下限：1080 & 1920，上限：2160 & 3840，比例0.56
	CreativeImageModeUnionSplashVideo   CreativeImageMode = "CREATIVE_IMAGE_MODE_UNION_SPLASH_VIDEO" // 穿山甲开屏视频 仅限穿山甲开屏使用，宽高比（0.56，9:16）,视频码率≥516kbps,大小≤100M,分辨率≥720*1280,1s<时长<6s
	CreativeImageModeDisplayWindow      CreativeImageMode = "CREATIVE_IMAGE_MODE_DISPLAY_WINDOW"     // 搜索橱窗，宽高比1，下限：109 & 109，上限：109 & 109
	CreativeImageModeTitle              CreativeImageMode = "MATERIAL_IMAGE_MODE_TITLE"              // 标题类型，非创意的素材类型，仅报表接口会区分此素材类型
	CreativeImageModeAwemeLive          CreativeImageMode = "CREATIVE_IMAGE_MODE_AWEME_LIVE"         // 直播画面类型

	LearningPhaseDefault     LearningPhase = "DEFAULT"      // 默认，不在学习期中
	LearningPhaseLearning    LearningPhase = "LEARNING"     // 学习中
	LearningPhaseLearned     LearningPhase = "LEARNED"      // 学习成功
	LearningPhaseLearnFailed LearningPhase = "LEARN_FAILED" // 学习失败

)

Variables ¶

This section is empty.

Functions ¶

This section is empty.

Types ¶

type AdAdAddReq ¶

type AdAdAddReq struct {
	AdvertiserId int64  `json:"advertiser_id,omitempty"` // 广告主ID
	CampaignId   string `json:"campaign_id,omitempty"`   // 广告组ID。注意：广告组ID要求属于广告主ID，且是非删除广告组ID
	Name         string `json:"name,omitempty"`          // 广告计划名称，长度为1-100个字符，其中1个中文字符算2位。名称不可重复，否则会报错
	Operation    string `json:"operation,omitempty"`     // 计划状态 默认值： "enable"开启状态 允许值: "enable"开启,"disable"关闭
	// 投放范围
	DeliveryRange  AdDeliveryRange `json:"delivery_range,omitempty"`   // 投放范围。 默认值: "DEFAULT"  允许值: "DEFAULT"默认, "UNION"穿山甲
	UnionVideoType string          `json:"union_video_type,omitempty"` // 投放形式（穿山甲视频创意类型），当delivery_range为"UNION"时必填
	// 推广目标
	// 推广目的为应用推广（landing_type=APP）时投放目标参数
	DownloadType         DownloadType        `json:"download_type,omitempty"`          // 下载方式 默认值：DOWNLOAD_URL下载链接
	DownloadUrl          string              `json:"download_url,omitempty"`           // 下载链接，当download_type为DOWNLOAD_URL或者QUICK_APP_URL时必填
	QuickAppUrl          string              `json:"quick_app_url,omitempty"`          // 快应用链接，当 download_type 为QUICK_APP_URL时必填
	ExternalUrl          string              `json:"external_url,omitempty"`           // 落地页链接（支持橙子建站落地页和第三方落地页） 当推广目的为APP类型，且download_type为EXTERNAL_URL时必填
	AppType              AppDownloadType     `json:"app_type,omitempty"`               // 下载的应用类型,当download_type为DOWNLOAD_URL时必填
	Package              string              `json:"package,omitempty"`                // 应用包名，当download_type为DOWNLOAD_URL时必填，需要与应用下载链接中包名一致
	DownloadMode         AppDownloadModeType `json:"download_mode,omitempty"`          // 优先从系统应用商店下载（下载模式）允许值：APP_STORE_DELIVERY（仅安卓应用下载支持）、 DEFAULT当应用下载时，默认default下载，可选用APP_STORE_DELIVERY（应用商店直投）
	ConvertId            int64               `json:"convert_id,omitempty"`             // 转化目标， 当出价方式为"OCPM"时必填，当出价方式为"CPC"和"CPM"时非必填。
	OpenUrl              string              `json:"open_url,omitempty"`               // 直达链接(点击唤起APP)
	AdvancedCreativeType string              `json:"advanced_creative_type,omitempty"` // 附加创意类型 (创建后不可修改), 允许值: 游戏礼包码 ATTACHED_CREATIVE_GAME_PACKAGE 推广目的为应用推广类型、下载方式选择下载链接且下载链接为安卓应用下载时才可以设置
	AdGamePackage

	// 推广目的为抖音号推广（landing_type=AWEME）时投放目标参数
	PromotionType string `json:"promotion_type,omitempty"` // 投放内容，允许值： LIVE：直播 AWEME_HOME_PAGE：抖音主页（默认） LANDING_PAGE_LINK：落地页
	AwemeAccount  string `json:"aweme_account,omitempty"`  // 抖音号，可从【获取绑定抖音号】接口获取，默认取绑定的第一个抖音号
	//ExternalUrl     string          `json:"external_url,omitempty"`     // 落地页链接 当推广目的为AWEME类型，且投放内容为落地页（LANDING_PAGE_LINK）时必填
	ExternalActions []AdConvertType `json:"external_actions,omitempty"` // 转化类型列表，目前仅允许填写一个转化目标 出价方式为OCPM、CPA的计划（投放目标为转化量）必填

	// 推广目的为门店推广（landing_type=STORE）时投放目标参数
	StoreProUnit       string  `json:"storepro_unit,omitempty"`        // 投放内容 允许值: "STORE"门店, "STORE_ACTIVITY"活动 目前暂时不支持线下商品类型
	StoreType          string  `json:"store_type,omitempty"`           // 门店类型，（storepro_unit 为 "STORE","STORE_ACTIVITY" 时必填）
	AdvertiserStoreIds []int64 `json:"advertiser_store_ids,omitempty"` // 门店ID列表 （storepro_unit 为 "STORE" 时必填） 最多可选择2000个
	StoreProPackId     int64   `json:"storepro_pack_id,omitempty"`     // 活动ID （storepro_unit 为 "STORE_ACTIVITY" 时必填）

	// 推广目的为商品目录推广（landing_type=DPA）时投放目标参数
	ProductPlatformId int64                `json:"product_platform_id,omitempty"` // 商品目录ID(ID由【DPA商品广告-查询商品库】 得到)
	ProductId         int64                `json:"product_id,omitempty"`          // 商品ID，当广告组商品类型选择SDPA时必填(ID由【DPA商品广告-获取DPA商品库商品列表】 得到，创建后不可修改)
	CategoryType      string               `json:"category_type,omitempty"`       // 商品目录投放范围,当广告组商品类型选择 DPA 多商品时必填 允许值：NONE不限，"CATEGORY"选择分类，"PRODUCT"指定商品
	DpaCategories     []int64              `json:"dpa_categories,omitempty"`      // 分类列表，category_type为"CATEGORY"时必填，由【DPA商品广告-获取DPA分类】 得到 限制个数1~100
	DpaProducts       []int64              `json:"dpa_products,omitempty"`        // 商品列表，category_type为"PRODUCT"时必填，由【DPA商品广告-获取DPA商品库商品列表】 得到 限制个数1~100
	DpaProductTarget  []AdDpaProductTarget `json:"dpa_product_target,omitempty"`  // 自定义筛选条件（商品投放条件）。用于圈定商品投放范围，结合商品库字段搭配判断条件，圈定商品投放范围。

	// 商品目录推广投放目标相关参数：
	DpaAdType           string   `json:"dpa_adtype,omitempty"`             // DPA广告类型，允许值: "DPA_LINK"落地页, "DPA_APP"应用下载
	ParamsType          string   `json:"params_type,omitempty"`            // 链接类型(落地页)，当dpa_adtype为"DPA_LINK"时必填
	DpaExternalUrlField string   `json:"dpa_external_url_field,omitempty"` // 落地页链接字段选择，当params_type为"DPA"时必填
	DpaExternalUrls     []string `json:"dpa_external_urls,omitempty"`      // 落地页链接地址列表，当params_type为"CUSTOM"时必填，目前只能填一个
	//AppType             AppDownloadType `json:"app_type,omitempty"`               // 下载的应用类型,当download_type为DOWNLOAD_URL时必填
	//DownloadUrl         string          `json:"download_url,omitempty"`           // 下载链接，当dpa_adtype为DPA_APP时必填
	//Package             string          `json:"package,omitempty"`                // 应用包名，当download_type为DOWNLOAD_URL时必填，需要与应用下载链接中包名一致
	//ConvertId           int64           `json:"convert_id,omitempty"`             // 转化目标， 当出价方式为"OCPM"时必填，当出价方式为"CPC"和"CPM"时非必填。
	DpaOpenUrlType    string   `json:"dpa_open_url_type,omitempty"`   // 直达链接类型，允许值: "NONE"不启用, "DPA"商品库所含链接, "CUSTOM"自定义链接
	DpaOpenUrlField   string   `json:"dpa_open_url_field,omitempty"`  // 直达链接字段选择，当dpa_open_url_type为"DPA"必填
	DpaOpenUrls       []string `json:"dpa_open_urls,omitempty"`       // 直达链接地址列表，当dpa_open_url_type为"CUSTOM"必填，目前只能填一个
	ExternalUrlParams string   `json:"external_url_params,omitempty"` // 落地页检测参数(DPA推广目的特有,在填写的参数后面添加"=urlencode"(开放平台提供的h5链接地址），其中urlencode(开放平台提供的h5链接地址）替换为商品库中的h5地址encode的结果)

	// 用户定向
	InterestActionMode string `json:"interest_action_mode,omitempty"` // 行为兴趣 允许值："UNLIMITED"不限,"CUSTOM"自定义,"RECOMMEND"系统推荐。
	InterestCategories []int  `json:"interest_categories,omitempty"`  // 兴趣类目词，当interest_action_mode传CUSTOM时有效
	AdAudience

	// 商品定向 仅推广目的为DPA时可用
	CommodityAudience

	// 预算与出价
	BudgetAndBid
}

type AdAdAddRsp ¶

type AdAdAddRsp struct {
	Code      int            `json:"code,omitempty"`
	Message   string         `json:"message,omitempty"`
	Data      AdAdAddRspData `json:"data,omitempty"`
	RequestId string         `json:"request_id,omitempty"`
}

type AdAdAddRspData ¶

type AdAdAddRspData struct {
	AdId int64 `json:"ad_id,omitempty"`
}

type AdAdGetFiltering ¶

type AdAdGetFiltering struct {
	Ids         []int64  `json:"ids,omitempty"`          // 按广告计划ID过滤，范围为1-100
	AdName      string   `json:"ad_name,omitempty"`      // 按广告计划name过滤，长度为1-30个字符
	PricingList []string `json:"pricing_list,omitempty"` // 按出价方式过滤
	Status      string   `json:"status,omitempty"`       // 按计划状态过滤，默认为返回“所有不包含已删除”，如果要返回所有包含已删除有对应枚举表示
	CampaignId  int64    `json:"campaign_id,omitempty"`  //
}

type AdAdGetOpts ¶

type AdAdGetOpts struct {
	Filtering optional.Interface `json:"filtering,omitempty"` // 过滤条件，若此字段不传，或传空则视为无限制条件
	Fields    optional.Interface `json:"fields,omitempty"`    // 查询字段集合, 如果指定, 则返回结果数组中, 每个元素是包含所查询字段的字典
	Page      optional.Int64     `json:"page,omitempty"`      // 当前页码: 1
	PageSize  optional.Int64     `json:"page_size,omitempty"` // 页面大小 默认值: 10， 取值范围：1-1000
}

type AdAdGetRsp ¶

type AdAdGetRsp struct {
	Code      int            `json:"code,omitempty"`
	Message   string         `json:"message,omitempty"`
	Data      AdAdGetRspData `json:"data,omitempty"`
	RequestId string         `json:"request_id,omitempty"`
}

type AdAdGetRspData ¶

type AdAdGetRspData struct {
	List     []AdAdGetRspDataList `json:"list,omitempty"`
	PageInfo PageInfo             `json:"page_info,omitempty"`
}

type AdAdGetRspDataList ¶

type AdAdGetRspDataList struct {
	Id                   int64    `json:"id,omitempty"`                     // 计划ID
	AdId                 int64    `json:"ad_id,omitempty"`                  // 计划ID,返回值同id
	Name                 string   `json:"name,omitempty"`                   // 计划名称
	AdvertiserId         int64    `json:"advertiser_id,omitempty"`          // 广告主ID
	CampaignId           int64    `json:"campaign_id,omitempty"`            // 广告组ID
	ModifyTime           string   `json:"modify_time,omitempty"`            // 计划上次修改时间标识(用于更新计划时提交,服务端判断是否基于最新信息修改)
	AdModifyTime         string   `json:"ad_modify_time,omitempty"`         // 计划上次修改时间
	AdCreateTime         string   `json:"ad_create_time,omitempty"`         // 计划创建时间
	Status               string   `json:"status,omitempty"`                 // 广告计划投放状态,详见【附录-广告计划投放状态】(进入投放之前,优先披露审核状态,此时优先于启用暂停,启用暂停信息以opt_status为准)
	OptStatus            string   `json:"opt_status,omitempty"`             // 广告计划操作状态 允许值: "AD_STATUS_ENABLE","AD_STATUS_DISABLE"
	DeliveryRange        string   `json:"delivery_range,omitempty"`         // 投放范围
	UnionVideoType       string   `json:"union_video_type,omitempty"`       // 投放形式（穿山甲视频创意类型）默认值: ORIGINAL_VIDEO原生 允许值: "ORIGINAL_VIDEO"原生, "REWARDED_VIDEO"激励视频,"SPLASH_VIDEO"开屏
	DownloadType         string   `json:"download_type,omitempty"`          // 应用下载方式，推广目的为APP时有值。返回值：DOWNLOAD_URL下载链接，QUICK_APP_URL快应用+下载链接，EXTERNAL_URL落地页链接
	DownloadUrl          string   `json:"download_url,omitempty"`           // 下载链接，当推广类型为应用推广，且当download_type为DOWNLOAD_URL或者QUICK_APP_URL时有值
	QuickAppUrl          string   `json:"quick_app_url,omitempty"`          // 快应用链接，当推广类型为应用推广，且download_type为QUICK_APP_URL时有值
	ExternalUrl          string   `json:"external_url,omitempty"`           // 落地页链接，投放内容或下载方式为落地页时有值
	AppType              string   `json:"app_type,omitempty"`               // 下载类型，当推广类型为应用推广且download_type为DOWNLOAD_URL或者QUICK_APP_URL时或当推广类型为DPA(商品目录推广)且dpa_adtype为DPA_APP有值
	DownloadMode         string   `json:"download_mode,omitempty"`          // 优先从系统应用商店下载（下载模式） 允许值：APP_STORE_DELIVERY（仅安卓应用下载支持）、 DEFAULT当应用下载时，默认default下载，可选用APP_STORE_DELIVERY（应用商店直投），当为该值时，将优先跳转目标应用对应手机系统应用商店安装详情页，跳转失败则使用下载链接下载。 请确保投放的应用在应用商店内已上架
	ConvertId            string   `json:"convert_id,omitempty"`             // 转化目标，其中convert_id数值较小时为预定义转化，具体枚举可查看【附录-预定义转化类型】
	ExternalActions      []string `json:"external_actions,omitempty"`       // 转化类型，目前当推广类型为抖音时有值，允许值："AD_CONVERT_TYPE_FOLLOW_ACTION", "AD_CONVERT_TYPE_MESSAGE_ACTION", "AD_CONVERT_TYPE_INTERACTION"
	OpenUrl              string   `json:"open_url,omitempty"`               // 直达链接(点击唤起APP)
	AdvancedCreativeType string   `json:"advanced_creative_type,omitempty"` // 附加创意类型 允许值: ATTACHED_CREATIVE_GAME_PACKAGE游戏礼包码,ATTACHED_CREATIVE_GAME_FORM游戏表单收集,ATTACHED_CREATIVE_GAME_SUBSCRIBE游戏预约,ATTACHED_CREATIVE_NONE无 推广目的为应用推广类型、下载方式选择下载链接且下载链接为安卓应用下载时才可以设置

	StoreProUnit        string               `json:"storepro_unit,omitempty"`          // 门店推广-投放内容，当推广目的为STORE(门店推广)时有值。 取值: "STORE"门店, "STORE_ACTIVITY"活动 目前暂时不支持线下商品类型
	StoreType           string               `json:"store_type,omitempty"`             // 门店类型，（storepro_unit 为 "STORE" 时有值。 取值: "STORE_NORMAL"平台通用门店, "STORE_THIRT_PARTY"第三方门店, "STORE_DOUYIN"抖音POI门店
	AdvertiserStoreIds  []int64              `json:"advertiser_store_ids,omitempty"`   // 门店ID列表 （storepro_unit 为 "STORE" 时有值
	StoreProPackId      int64                `json:"storepro_pack_id,omitempty"`       // 活动ID （storepro_unit 为 "STORE_ACTIVITY" 时有值
	ProductPlatformId   int64                `json:"product_platform_id,omitempty"`    // 产品目录ID(ID由查询产品目录接口得到), 当推广目的landing_type为DPA时有值
	ProductId           int64                `json:"product_id,omitempty"`             // 商品id，当推广目的为 DPA 广告组商品类型为 SDPA 时有值
	CategoryType        string               `json:"category_type,omitempty"`          // DPA投放范围，取值：NONE不限，"CATEGORY"选择分类，"PRODUCT"指定商品
	DpaCategories       []int64              `json:"dpa_categories,omitempty"`         // 分类列表，category_type取值范围为CATEGORY时有值
	DpaProducts         []int64              `json:"dpa_products,omitempty"`           // 商品列表，category_type为PRODUCT时有值
	DpaProductTarget    []AdDpaProductTarget `json:"dpa_product_target,omitempty"`     // 自定义筛选条件（商品投放条件）。用于圈定商品投放范围，结合商品库字段搭配判断条件，圈定商品投放范围。
	DpaAdType           []string             `json:"dpa_adtype,omitempty"`             // dpa广告类型，取值范围："DPA_LINK"落地页, "DPA_APP"应用下载
	ParamsType          string               `json:"params_type,omitempty"`            // 链接类型(落地页)，当dpa_adtype为"DPA_LINK"时有值，取值: "DPA"商品库所含链接, "CUSTOM"自定义链接
	DpaExternalUrlField string               `json:"dpa_external_url_field,omitempty"` // 落地页链接字段选择，当params_type为"DPA"时有值
	DpaExternalUrls     []string             `json:"dpa_external_urls,omitempty"`      // 落地页链接地址列表，当params_type为"CUSTOM"时有值
	Package             string               `json:"package,omitempty"`                // 应用包名，当推广类型为应用推广且download_type为DOWNLOAD_URL时或当推广类型为DPA(商品目录推广)且dpa_adtype为DPA_APP有值
	InventoryType       []string             `json:"inventory_type,omitempty"`         // 创意投放位置,详见【附录-投放位置】。创建选择优选广告位时，此字段回会返回对应的优选广告位
	PromotionType       string               `json:"promotion_type,omitempty"`         // 投放内容 GOODS：商品推广 LIVE：直播 AWEME_HOME_PAGE：抖音主页 LANDING_PAGE_LINK：落地页
	AwemeAccount        string               `json:"aweme_account,omitempty"`          // 抖音号
	SubscribeUrl        string               `json:"subscribe_url,omitempty"`          // 	游戏营销场景-预约下载链接
	FormId              int64                `json:"form_id,omitempty"`                // 	游戏营销场景-表单id
	FormIndex           int64                `json:"form_index,omitempty"`             // 	游戏营销场景-表单位置索引
	AppDesc             string               `json:"app_desc,omitempty"`               // 	游戏营销场景-应用描述
	AppIntroduction     string               `json:"app_introduction,omitempty"`       // 	游戏营销场景-应用介绍
	AppThumbnails       []string             `json:"app_thumbnails,omitempty"`         // 	游戏营销场景-应用图片集，返回图片集Id
	DpaOpenUrlType      string               `json:"dpa_open_url_type,omitempty"`      // 直达链接类型，取值: "NONE"不启用, "DPA"商品库所含链接, "CUSTOM"自定义链接 商品库链接对应商品库内调起字段
	DpaOpenUrlField     string               `json:"dpa_open_url_field,omitempty"`     // 直达链接字段选择，当dpa_open_url_type为"DPA"时有值
	DpaOpenUrls         []string             `json:"dpa_open_urls,omitempty"`          // 达链接地址列表，当dpa_open_url_type为"CUSTOM"时有值
	ExternalUrlParams   string               `json:"external_url_params,omitempty"`    // 落地页检测参数(DPA推广目的特有,在填写的参数后面添加"=urlencode(开放平台提供的h5链接地址）"，其中urlencode(开放平台提供的h5链接地址）替换为商品库中的h5地址encode的结果)
	OpenUrlParams       string               `json:"open_url_params,omitempty"`        // 直达链接检测参数(DPA推广目的特有,在“产品库中提取的scheme地址"后面追加填写的参数)
	AdGamePackage
	AdAudience
	CommodityAudience
	BudgetAndBid
}

type AdAge ¶

type AdAge string // 定向 年龄区间

type AdAudience ¶

type AdAudience struct {
	AudiencePackageId         int64            `json:"audience_package_id,omitempty"`          // 定向包ID，定向包ID由【工具-定向包管理-获取定向包】获取 如果同时传定向包ID和自定义用户定向参数时，仅定向包中的定向生效
	District                  AdDistrict       `json:"district,omitempty"`                     // 地域 取值: "CITY"省市, "COUNTY"区县, "BUSINESS_DISTRICT"商圈,"NONE"不限
	City                      []int64          `json:"city,omitempty"`                         // 	地域定向省市或者区县列表
	BusinessIds               []int64          `json:"business_ids,omitempty"`                 // 商圈ID数组
	Geolocation               []Geolocation    `json:"geolocation,omitempty"`                  //  从地图添加(地图位置)
	LocationType              string           `json:"location_type,omitempty"`                // 位置类型 允许值：CURRENT正在该地区的用户，HOME居住在该地区的用户，TRAVEL到该地区旅行的用户，ALL该地区内的所有用户 当city和district有值时必填
	Gender                    AdGender         `json:"gender,omitempty"`                       // 性别
	Age                       []AdAge          `json:"age,omitempty"`                          // 年龄
	RetargetingTagsInclude    []int64          `json:"retargeting_tags_include,omitempty"`     // 定向人群包列表（自定义人群），内容为人群包id
	RetargetingTagsExclude    []int64          `json:"retargeting_tags_exclude,omitempty"`     // 排除人群包列表（自定义人群），内容为人群包id	InterestActionMode        string           `json:"interest_action_mode"`          // 行为兴趣 取值："UNLIMITED"不限,"CUSTOM"自定义,"RECOMMEND"系统推荐。若与自定义人群同时使用，系统推荐("RECOMMEND")不生效 仅推广范围为默认时可填，且不可与老版行为兴趣定向同时填写，否则会报错
	ActionScene               []string         `json:"action_scene,omitempty"`                 // string[]	行为场景，详见【附录-行为场景】，当interest_action_mode传CUSTOM时有效 允许值："E-COMMERCE"电商互动行为, "NEWS"资讯互动行为, "APP"APP推广互动行为
	ActionDays                int              `json:"action_days,omitempty"`                  // 	用户发生行为天数，当interest_action_mode传CUSTOM时有效 允许值：7, 15, 30, 60, 90, 180, 365
	ActionCategories          []int            `json:"action_categories,omitempty"`            // 行为类目词
	ActionWords               []int            `json:"action_words,omitempty"`                 // 行为关键词	InterestCategories        []int64          `json:"interest_categories"`           // 兴趣类目词，当interest_action_mode传CUSTOM时有效
	InterestWords             []int64          `json:"interest_words,omitempty"`               // 兴趣关键词, 传入具体的词id，非兴趣词包id，可以通过词包相关接口或者兴趣关键词word2id接口获取词id，一个计划下最多创建1000个关键词。当interest_action_mode传CUSTOM时有效
	AdTag                     []int64          `json:"ad_tag,omitempty"`                       // （老版行为兴趣）兴趣分类,如果传"空数组"表示不限，如果"数组传0"表示系统推荐,如果按兴趣类型传表示自定义，兴趣类型详见【附件-ad_tag.json】 仅推广范围为穿山甲时可填，且不可与新版行为兴趣定向同时填写，否则会报错
	InterestTags              []int64          `json:"interest_tags,omitempty"`                // （老版行为兴趣）兴趣关键词, 传入具体的词id，非兴趣词包id，可以通过词包相关接口或者兴趣关键词word2id接口获取词id，一个计划下最多创建1000个关键词。 仅推广范围为穿山甲时可填，且不可与新版行为兴趣定向同时填写，否则会报错
	AppBehaviorTarget         string           `json:"app_behavior_target,omitempty"`          // （老版行为兴趣）APP行为 取值：NONE不限，CATEGORY按分类，APP按APP 仅推广范围为穿山甲时可填，且不可与新版行为兴趣定向同时填写，否则会报错
	AppCategory               []int64          `json:"app_category,omitempty"`                 // （老版行为兴趣）APP行为定向——按分类, 详见【附件-app_category.json】（请注意如果投放的是"应用下载-IOS"不支持设置APP行为定向，请勿传值）当app_behavior_target为CATEGORY时返回 仅推广范围为穿山甲时可填，且不可与新版行为兴趣定向同时填写，否则会报错
	AppIds                    []int64          `json:"app_ids,omitempty"`                      // （老版行为兴趣）APP行为定向——按APP（请注意如果投放的是"应用下载-IOS"不支持设置APP行为定向，请勿传值。）可通过【工具-查询工具-查询应用信息】获取。当app_behavior_target为APP时有值 仅推广范围为穿山甲时可填，且不可与新版行为兴趣定向同时填写，否则会报错
	AwemeFanBehaviors         []AdDyActionType `json:"aweme_fan_behaviors,omitempty"`          // 抖音达人互动用户行为类型
	AwemeFanCategories        []int64          `json:"aweme_fan_categories,omitempty"`         // 抖音达人分类ID列表，与aweme_fan_behaviors同时设置才会生效（抖音达人定向）
	AwemeFanAccounts          []int64          `json:"aweme_fan_accounts,omitempty"`           // 抖音达人ID列表，与aweme_fan_behaviors同时设置才会生效（抖音达人定向
	AwemeFansNumbers          []int64          `json:"aweme_fans_numbers,omitempty"`           // （抖音号推广特有）账号粉丝相似人群（添加抖音账号，会将广告投放给对应账号的相似人群粉丝）	FilterAwemeAbnormalActive int64            `json:"filter_aweme_abnormal_active"`  // （抖音号推广特有）过滤高活跃用户 取值：0表示不过滤，1表示过滤
	FilterAwemeAbnormalActive int64            `json:"filter_aweme_abnormal_active,omitempty"` // 抖音号推广特有）过滤高活跃用户 允许值：0表示不过滤，1表示过滤
	FilterAwemeFansCount      int64            `json:"filter_aweme_fans_count,omitempty"`      // 抖音号推广特有）过滤高关注数用户，例如"filter_aweme_fans_count": 1000表示过滤粉丝数在1000以上的用户
	FilterOwnAwemeTans        int64            `json:"filter_own_aweme_fans,omitempty"`        // 抖音号推广特有）过滤自己的粉丝 允许值：0表示不过滤，1表示过滤
	SuperiorPopularityType    string           `json:"superior_popularity_type,omitempty"`     // 媒体定向  对于选择自定义媒体定向流量包，该字段不传，传flow_package或exclude_flow_package字段即可 媒体定向仅支持穿山甲、穿山甲-精选游戏广告位
	FlowPackage               []int64          `json:"flow_package,omitempty"`                 // 定向逻辑 定向逻辑和排除定向逻辑只能选其一
	ExcludeFlowPackage        []int64          `json:"exclude_flow_package,omitempty"`         // 	排除定向逻辑 定向逻辑和排除定向逻辑只能选其一
	Platform                  []string         `json:"platform,omitempty"`                     // 	平台，当下载方式包含下载链接时，平台类型需与选择的下载链接类型对应，当下载方式不包含下载方式的时候，平台可多选。
	AndroidOsv                string           `json:"android_osv,omitempty"`                  // 最低安卓版本，当app_type为"APP_ANDROID"选填,其余情况不填
	IosOsv                    string           `json:"ios_osv,omitempty"`                      // 最低IOS版本，当app_type为"APP_IOS"选填,其余情况不填,
	DeviceType                []string         `json:"device_type,omitempty"`                  // 设备类型。 取值是："MOBILE", "PAD"。缺省表示不限设备类型。穿山甲已经全量，投放范围为默认时需要有白名单权限才可以

	Ac                    []string `json:"ac,omitempty"`                      // 网络类型,允许值: "WIFI", "2G", "3G", "4G"
	Carrier               []string `json:"carrier,omitempty"`                 // 运营商, 允许值: "MOBILE", "UNICOM", "TELCOM"
	HideIfExists          int      `json:"hide_if_exists,omitempty"`          // 过滤已安装，当推广目标为安卓应用下载时可填，0表示不限，1表示过滤，2表示定向。默认为不限
	ConvertedTimeDuration string   `json:"converted_time_duration,omitempty"` // 过滤时间范围
	HideIfConverted       string   `json:"hide_if_converted,omitempty"`       // 过滤已转化用户
	ActivateType          []string `json:"activate_type,omitempty"`           // 新用户(新用户使用头条的时间)
	ArticleCategory       []string `json:"article_category,omitempty"`        // 文章分类 文章分类：只针对投放在详情页位置的广告生效, 不支持人群预估
	DeviceBrand           []string `json:"device_brand,omitempty"`            // 手机品牌
	LaunchPrice           []int64  `json:"launch_price,omitempty"`            // 手机价格,传入价格区间，最高传入11000（表示1w以上）
	AutoExtendEnabled     int64    `json:"auto_extend_enabled,omitempty"`     // 是否启用智能放量。 允许值是：0、1。缺省为 0。 注意点：智能放量不支持受众预估
	AutoExtendTargets     []string `json:"auto_extend_targets,omitempty"`     // 可放开定向。当auto_extend_enabled=1 时选填。详见：【附录-可开放定向】。缺省为全不选。
}

type AdBudgetData ¶

type AdBudgetData struct {
	AdId int64 `json:"ad_id,omitempty"` // 广告计划ID，广告计划id需要属于广告主，且ad_id不能重复，否则会报错！
	// 预算，单位：元。
	// 24小时内修改预算操作，不能超过20次，24小时是指自然天的24小时；
	// 单次修改预算幅度不能低于100元（增加或者减少）;
	// 修改后预算金额，不能低于当前已消费金额的105%，以整百单位向上取整；
	Budget int64 `json:"budget,omitempty"`
}

type AdBudgetUpdateReq ¶

type AdBudgetUpdateReq struct {
	AdvertiserId int64          `json:"advertiser_id,omitempty"`
	Data         []AdBudgetData `json:"data,omitempty"` // 批量修改预算，包含计划ID和预算，list长度限制1～100.
}

type AdBudgetUpdateRsp ¶

type AdBudgetUpdateRsp struct {
	Code      int                   `json:"code,omitempty"`
	Message   string                `json:"message,omitempty"`
	Data      AdBudgetUpdateRspData `json:"data,omitempty"`
	RequestId string                `json:"request_id,omitempty"`
}

type AdBudgetUpdateRspData ¶

type AdBudgetUpdateRspData struct {
	AdIds []int64 `json:"ad_ids,omitempty"`
}

type AdCampaignAddReq ¶

type AdCampaignAddReq struct {
	// 广告主ID
	AdvertiserId int64 `json:"advertiser_id,omitempty"`
	// 广告组名称，长度为1-100个字符，其中1个中文字符算2位
	CampaignName string `json:"campaign_name,omitempty"`
	// 广告组状态  允许值: "enable","disable"默认值：enable开启状态
	Operation string `json:"operation,omitempty"`
	//  广告组预算类型, 允许值: "BUDGET_MODE_INFINITE","BUDGET_MODE_DAY"
	BudgetMode BudgetMode `json:"budget_mode,omitempty"`
	// 广告组预算，取值范围: ≥ 0 当budget_mode为"BUDGET_MODE_DAY"时,必填,且日预算不少于300元
	Budget int64 `json:"budget,omitempty"`
	// 广告组推广目的, (创建后不可修改)
	//    允许值: "LINK","APP","DPA","GOODS","STORE","SHOP","AWEME"
	LandingType LandingType `json:"landing_type,omitempty"`
	// 广告组商品类型 (创建后不可修改)
	// 允许值:
	//    CAMPAIGN_DPA_DEFAULT_NOT: 非 DPA
	//    CAMPAIGN_DPA_SINGLE_DELIVERY:SDPA 单商品推广
	//    CAMPAIGN_DPA_MULTI_DELIVERY: DPA 商品推广
	// 默认值：
	//    推广目的非 DPA 时默认 CAMPAIGN_DPA_DEFAULT_NOT
	//    推广目的为 DPA 时默认 CAMPAIGN_DPA_MULTI_DELIVERY
	DeliveryRelatedNum string `json:"delivery_related_num,omitempty"`
}

广告组添加请求结构

type AdCampaignAddRsp ¶

type AdCampaignAddRsp struct {
	Code      int                  `json:"code,omitempty"`
	Message   string               `json:"message,omitempty"`
	Data      AdCampaignAddRspData `json:"data,omitempty"`
	RequestId string               `json:"request_id,omitempty"`
}

广告组添加响应结构

type AdCampaignAddRspData ¶

type AdCampaignAddRspData struct {
	// 广告组id
	CampaignId int64 `json:"campaign_id,omitempty"`
}

广告组添加响应数据

type AdCampaignGetOpts ¶

type AdCampaignGetOpts struct {
	Filtering optional.Interface `json:"filtering,omitempty"` // 过滤条件，若此字段不传，或传空则视为无限制条件
	Fields    optional.Interface `json:"fields,omitempty"`    // 查询字段集合, 如果指定, 则返回结果数组中, 每个元素是包含所查询字段的字典
	Page      optional.Int64     `json:"page,omitempty"`      // 当前页码: 1
	PageSize  optional.Int64     `json:"page_size,omitempty"` // 页面大小 默认值: 10， 取值范围：1-1000
}

type AdCampaignGetOptsFiltering ¶

type AdCampaignGetOptsFiltering struct {
	Ids                []int64        `json:"ids,omitempty"`                  // 广告组ID过滤，数组，不超过100个
	CampaignName       string         `json:"campaign_name,omitempty"`        // 广告组name过滤，长度为1-30个字符，其中1个中文字符算2位
	LandingType        LandingType    `json:"landing_type,omitempty"`         // 广告组推广目的过滤
	Status             CampaignStatus `json:"status,omitempty"`               // 广告组状态过滤，默认为返回“所有不包含已删除”
	CampaignCreateTime string         `json:"campaign_create_time,omitempty"` // 广告组创建时间，格式yyyy-mm-dd，表示过滤出当天创建的广告组
}

AdCampaignGetOpts 过滤条件

type AdCampaignGetRsp ¶

type AdCampaignGetRsp struct {
	Code      int                  `json:"code,omitempty"`
	Message   string               `json:"message,omitempty"`
	Data      AdCampaignGetRspData `json:"data,omitempty"`
	RequestId string               `json:"request_id,omitempty"`
}

type AdCampaignGetRspData ¶

type AdCampaignGetRspData struct {
	List     []AdCampaignGetRspDataList `json:"list,omitempty"`
	PageInfo PageInfo                   `json:"page_info,omitempty"`
}

type AdCampaignGetRspDataList ¶

type AdCampaignGetRspDataList struct {
	Id                 int64  `json:"id,omitempty"`                   // 广告组ID
	Name               string `json:"name,omitempty"`                 // 广告组名称
	Budget             string `json:"budget,omitempty"`               // 广告组预算
	BudgetMode         string `json:"budget_mode,omitempty"`          // 广告组预算类型
	LandingType        string `json:"landing_type,omitempty"`         // 广告组推广目的
	ModifyTime         string `json:"modify_time,omitempty"`          // 广告组时间戳,用于更新时提交,服务端判断是否基于最新信息修改
	Status             string `json:"status,omitempty"`               // 广告组状态,详见
	CampaignCreateTime string `json:"campaign_create_time,omitempty"` // 广告组创建时间, 格式：yyyy-mm-dd hh:MM:ss
	CampaignModifyTime string `json:"campaign_modify_time,omitempty"` // 广告组修改时间, 格式：yyyy-mm-dd hh:MM:ss
	DeliveryRelatedNum string `json:"delivery_related_num,omitempty"` // 广告组商品类型
	DeliveryMode       string `json:"delivery_mode,omitempty"`        // 投放类型，允许值：MANUAL（手动）、PROCEDURAL（自动，投放管家
}

type AdConvertType ¶

type AdConvertType string

type AdCreativeAddReq ¶

type AdCreativeAddReq struct {
	AdvertiserId int64 `json:"advertiser_id,omitempty"` // 广告主ID
	AdId         int64 `json:"ad_id,omitempty"`         // 广告计划ID，计划ID要属于广告主ID，且非删除计划

	// 投放位置
	InventoryType  []InventoryType `json:"inventory_type,omitempty"`  // 广告位置（按媒体指定位置），详见【附录-投放位置】，具体描述参考广告创意
	SmartInventory int             `json:"smart_inventory,omitempty"` // 优选广告位，0表示不使用优选，1表示使用，使用优选广告位的时候默认忽略inventory_type字段； 注意：该字段与scene_inventory不能同时传
	SceneInventory string          `json:"scene_inventory,omitempty"` // 场景广告位，详见【附录-场景广告位】，使用场景广告位时默认忽略inventory_type字段； 注意：该字段与smart_inventory不能同时传。

	// 制作创意
	// 程序化创意 - 非DPA
	// 程序化创意实际会按照传入的title_list和image_list进行组合，对于效果不好的组合无法通过审核，获取到的都是审核通过的创意
	CreativeMaterialMode string              `json:"creative_material_mode,omitempty"` // 创意方式，当值为"STATIC_ASSEMBLE"表示程序化创意，其他情况不传字段
	ProceduralPackageId  int64               `json:"procedural_package_id,omitempty"`  // 程序化创意包ID，可通过【查询程序化创意包】接口进行查询，程序化创意包与自定义素材（title_list和image_list）不能同时使用，否则会报错 仅支持程序化创意，头条文章、DPA推广类型暂不支持
	IsPresentedVideo     int                 `json:"is_presented_video,omitempty"`     // 自动生成视频素材，利用已上传的图片与视频生成更多优质的短视频素材：1（启用），0（不启用） 默认值: 0
	GenerateDerivedAd    int                 `json:"generate_derived_ad,omitempty"`    // 是否开启衍生计划，衍生计划详情介绍：1（启用），0（不启用） 默认值: 0
	ImageList            []CreativeImageInfo `json:"image_list,omitempty"`             // 素材信息，creative_material_mode为"STATIC_ASSEMBLE"时必填，字段说明见下表。最多包含12张图和10个视频。
	TitleList            []CreativeTitleInfo `json:"title_list,omitempty"`             // 标题信息，creative_material_mode为"STATIC_ASSEMBLE"时必填，字段说明见下表。最多包含10个标题。

	// 基础创意信息
	Source                     string `json:"source,omitempty"`                        // 广告来源，4-20个字符，当推广目的为非应用下载或者应用下载且download_type为"EXTERNAL_URL时"时必填
	IesCoreUserId              string `json:"ies_core_user_id,omitempty"`              // 品牌主页-推广抖音号，当传入此字段时表示开启抖音主页。广告视频将同步到您的主页下，在客户端点击广告头像将进入您的主页。创建后不可修改。
	IsFeedAndFavSee            int    `json:"is_feed_and_fav_see,omitempty"`           // 主页作品列表隐藏广告内容，默认值：0 允选值：0（不隐藏），1（隐藏）
	CreativeAutoGenerateSwitch int    `json:"creative_auto_generate_switch,omitempty"` // 是否开启自动生成素材，delivery_range为UNIVERSAL：通投智选时可填，默认值: 1 允许值: 0：不启用, 1：启用
	AppName                    string `json:"app_name,omitempty"`                      // 应用名，当广告计划的download_type为"DOWNLOAD_URL"时，4到20个字符，必填
	SubTitle                   string `json:"sub_title,omitempty"`                     // APP 副标题。仅推广目标为APP，4到24个字符，填写Android下载链接时可设置
	WebUrl                     string `json:"web_url,omitempty"`                       // Android应用下载详情页（用户点击广告中“立即下载”按钮以外的区域时所到达的页面），当广告计划app_type为"APP_ANDROID"时, 必填
	ActionText                 string `json:"action_text,omitempty"`                   // 行动号召（仅应用下载推广类型有效） 备注：应用下载的行动号召字段使用action_text，门店与销售线索行动号召使用button_text 请求值可从接口【行动号召字段内容获取】进行获取，如果不传参默认为立即下载
	PlayableUrl                string `json:"playable_url,omitempty"`                  // 试玩素材URL，可通过【获取试玩素材列表】进行获取。 只有穿山甲激励视频可以使用试玩素材，同时素材需要审核通过
	IsCommentDisable           int    `json:"is_comment_disable,omitempty"`            // 是否关闭评论，0为开启，1为关闭，默认值：0 允许值: 0, 1

	// 附加创意
	AdvancedCreativeType  AdvancedCreativeType   `json:"advanced_creative_type,omitempty"`  // 附加创意类型
	AdvancedCreativeTitle string                 `json:"advanced_creative_title,omitempty"` // 副标题，最多24个字符
	PhoneNumber           string                 `json:"phone_number,omitempty"`            // 电话号码。当附加创意类型为"ATTACHED_CREATIVE_PHONE"时必填
	ButtonText            string                 `json:"button_text,omitempty"`             // 按钮文本，即行动号召，当附加创意类型非"ATTACHED_CREATIVE_NONE"时填写，请求值可从接口【行动号召字段内容获取】进行获取
	FormUrl               string                 `json:"form_url,omitempty"`                // 表单提交链接。当附加创意类型为"ATTACHED_CREATIVE_FORM"时 必填，必须为今日头条建站地址：【查询已有表单列表】
	PromotionCard         *CreativePromotionCard `json:"promotion_card,omitempty"`

	// 创意分类
	ThirdIndustryId int64    `json:"third_industry_id,omitempty"` // 三级行业ID
	AdKeywords      []string `json:"ad_keywords,omitempty"`       // 创意标签。最多20个标签，且每个标签长度不超过10个字符

	// 监测链接
	TrackUrl                   string `json:"track_url,omitempty"`                      // 展示（监测链接）
	ActionTrackUrl             string `json:"action_track_url,omitempty"`               // 点击（监测链接）（当推广目的为应用下载且创建计划传递了convert_id，系统会自动获取转化中的点击监测链接，且不可修改）
	VideoPlayEffectiveTrackUrl string `json:"video_play_effective_track_url,omitempty"` // 视频有效播放（监测链接），投放范围为穿山甲时暂不支持设置此链接
	VideoPlayDoneTrackUrl      string `json:"video_play_done_track_url,omitempty"`      // 视频播完（监测链接），投放范围为穿山甲时暂不支持设置此链接
	VideoPlayTrackUrl          string `json:"video_play_track_url,omitempty"`           // 视频播放（监测链接），投放范围为穿山甲时暂不支持设置此链接
	TrackUrlSendType           string `json:"track_url_send_type,omitempty"`            // 数据发送方式，不可修改,默认值: SERVER_SEND 允许值: SERVER_SEND(服务器端上传), CLIENT_SEND(客户端上传)

}

type AdCreativeAddRsp ¶

type AdCreativeAddRsp struct {
	Code      int                  `json:"code,omitempty"`
	Message   string               `json:"message,omitempty"`
	Data      AdCreativeAddRspData `json:"data,omitempty"`
	RequestId string               `json:"request_id,omitempty"`
}

type AdCreativeAddRspData ¶

type AdCreativeAddRspData struct {
	AdvertiserId             int64           `json:"advertiser_id,omitempty"`
	AdId                     int64           `json:"ad_id,omitempty"`
	ModifyTime               string          `json:"modify_time,omitempty"`
	InventoryType            []InventoryType `json:"inventory_type,omitempty"`             // 创意投放位置
	SmartInventory           int             `json:"smart_inventory,omitempty"`            // 是否使用优选广告位，
	SceneInventory           string          `json:"scene_inventory,omitempty"`            // 场景广告位
	CreativeMaterialMode     string          `json:"creative_material_mode,omitempty"`     // 创意类型，该字段为STATIC_ASSEMBLE表示程序化创意，其他情况无该字段
	ProceduralPackageId      int64           `json:"procedural_package_id,omitempty"`      // 程序化创意包ID
	ProceduralPackageVersion int64           `json:"procedural_package_version,omitempty"` // 程序化创意包版本
	IsPresentedVideo         int             `json:"is_presented_video,omitempty"`         // 	启用图片生成视频，允许值：0（不启用），1（启用）
	GenerateDerivedAd        int             `json:"generate_derived_ad,omitempty"`        // 是否开启衍生计划，1为开启，0为不开启
	ImageList                []struct {
		ImageMode   string   `json:"image_mode,omitempty"`   // 素材类型
		ImageId     string   `json:"image_id,omitempty"`     // 图片ID，视频封面
		VideoId     string   `json:"video_id,omitempty"`     // 视频ID
		ImageIds    []string `json:"image_ids,omitempty"`    // 图片ID列表
		TemplateIds []int64  `json:"template_ids,omitempty"` // 模版ID列表
	} `json:"image_list"` // 素材信息，程序化创意素材列表。最多包含12张图和6个视频。

	TitleList []struct {
		Title           string  `json:"title,omitempty"`             // 创意标题
		CreativeWordIds []int64 `json:"creative_word_ids,omitempty"` // 动态词包ID，可使用动态词包查询接口查询数据
		DpaDictIds      []int64 `json:"dpa_dict_ids,omitempty"`      // DPA词包ID列表，针对DPA广告
	} `json:"title_list"` // 标题信息，程序化创意标题列表。最多包含10个标题
	Creatives                  []Creative `json:"creatives,omitempty"`                     // 素材信息, 投放位置和创意类型决定素材规格。程序化创意只有在审核通过后才有值
	Source                     string     `json:"source,omitempty"`                        // 广告来源
	IesCoreUserId              string     `json:"ies_core_user_id,omitempty"`              // 广告主绑定的抖音ID
	IsFeedAndFavSee            int        `json:"is_feed_and_fav_see,omitempty"`           // 是否隐藏抖音主页，0：不隐藏，1：隐藏
	CreativeAutoGenerateSwitch int        `json:"creative_auto_generate_switch,omitempty"` // 是否开启自动生成素材，delivery_range为UNIVERSAL：通投智选时返回，0：不启用,1：启用
	AppName                    string     `json:"app_name,omitempty"`                      // 应用名
	SubTitle                   string     `json:"sub_title,omitempty"`                     // 	APP 副标题。
	WebUrl                     string     `json:"web_url,omitempty"`                       // 	Android应用下载详情页
	ActionText                 string     `json:"action_text,omitempty"`                   // 	行动号召
	PlayableUrl                string     `json:"playable_url,omitempty"`                  // 试玩素材URL
	IsCommentDisable           int        `json:"is_comment_disable,omitempty"`            // 是否关闭评论 允许值: 0, 1
	CloseVideoDetail           int        `json:"close_video_detail,omitempty"`            // 是否关闭视频详情页落地页(勾选该选项后,视频详情页中不默认弹出落地页,仅对视频广告生效) 允许值: 0, 1
	CreativeDisplayMode        string     `json:"creative_display_mode,omitempty"`         // 创意展现方式
	AdvancedCreativeType       string     `json:"advanced_creative_type,omitempty"`        // 附加创意类型
	AdvancedCreativeTitle      string     `json:"advanced_creative_title,omitempty"`       // 附加创意副标题
	PhoneNumber                string     `json:"phone_number,omitempty"`                  // 电话号码(当附加创意类型为ATTACHED_CREATIVE_PHONE时返回)
	ButtonText                 string     `json:"button_text,omitempty"`                   // 按钮文本(当附加创意类型不为ATTACHED_CREATIVE_NONE时返回)
	FormUrl                    string     `json:"form_url,omitempty"`                      // 表单提交链接(当附加创意类型为ATTACHED_CREATIVE_FORM时返回)

	CommerceCards              []CreativeCommerceCards `json:"commerce_cards,omitempty"`                 // 电商卡片信息。如果没有启用，那么不返回相关字段。
	ThirdIndustryId            int64                   `json:"third_industry_id,omitempty"`              // 三级行业ID
	AdKeywords                 []string                `json:"ad_keywords,omitempty"`                    // 创意标签
	TrackUrl                   string                  `json:"track_url,omitempty"`                      // 展示（监测链接）
	ActionTrackUrl             string                  `json:"action_track_url,omitempty"`               // 点击（监测链接）
	VideoPlayEffectiveTrackUrl string                  `json:"video_play_effective_track_url,omitempty"` // 视频有效播放（监测链接）
	VideoPlayDoneTrackUrl      string                  `json:"video_play_done_track_url,omitempty"`      // 视频播完（监测链接）
	VideoPlayTrackUrl          string                  `json:"video_play_track_url,omitempty"`           // 视频播放（监测链接）
	TrackUrlSendType           string                  `json:"track_url_send_type,omitempty"`            // 点击监测链接上报方式,默认值: SERVER_SEND 允许值:SERVER_SEND(服务器端上传), CLIENT_SEND(客户端上传)
	PromotionCard              CreativePromotionCard   `json:"promotion_card,omitempty"`                 // 商品推广卡片
}

type AdCreativeUnionVideoType ¶

type AdCreativeUnionVideoType string

type AdDeepBidType ¶

type AdDeepBidType string // 深度优化方式

type AdDeliveryRange ¶

type AdDeliveryRange string

type AdDistrict ¶

type AdDistrict string // 定向 地域

type AdDpaProductTarget ¶

type AdDpaProductTarget struct {
	Title string `json:"title,omitempty"` // 筛选字段
	Rule  string `json:"rule,omitempty"`  // 定向规则，允许值：'=', '!=', '>', '<', '>=', '<=', 'contain', 'exclude', 'notEmpty'
	Type  string `json:"type,omitempty"`  // 字段类型，允许值：'int', 'double', 'long', 'string'
	Value string `json:"value,omitempty"` // 	规则值
}

type AdDyActionType ¶

type AdDyActionType string // 抖音用户行为类型

type AdGamePackage ¶

type AdGamePackage struct {
	GamePackageDesc         string   `json:"game_package_desc,omitempty"`          // 应用描述,最少1字，最多15字
	GamePackageBatchId      int64    `json:"game_package_batch_id,omitempty"`      // 游戏礼包码id，目前仅支持直接发券类型
	GamePackageThumbnailIds []string `json:"game_package_thumbnail_ids,omitempty"` //应用图片集，图片image_id，有且仅有两个，游戏礼包码时有值,可以从 【素材管理-获取图片素材】 接口中获取，建议尺寸 16:9 与game_package_thumbnails同时传入时，以game_package_thumbnail_ids字段为准
}

type AdGender ¶

type AdGender string // 定向 性别

type AdPricingType ¶

type AdPricingType string // 广告出价类型

type AdStatus ¶

type AdStatus string // 广告状态

type AdStatusUpdateReq ¶

type AdStatusUpdateReq struct {
	AdvertiserId int64    `json:"advertiser_id,omitempty"`
	AdIds        []int64  `json:"ad_ids,omitempty"`
	OptStatus    AdStatus `json:"opt_status,omitempty"`
}

type AdStatusUpdateRsp ¶

type AdStatusUpdateRsp struct {
	Code      int                   `json:"code,omitempty"`
	Message   string                `json:"message,omitempty"`
	Data      AdStatusUpdateRspData `json:"data,omitempty"`
	RequestId string                `json:"request_id,omitempty"`
}

type AdStatusUpdateRspData ¶

type AdStatusUpdateRspData struct {
	AdIds []int64 `json:"ad_ids,omitempty"`
}

type AdvancedCreativeType ¶

type AdvancedCreativeType string // 附加创意类型

type AdvertiserBudgetUpdateReq ¶

type AdvertiserBudgetUpdateReq struct {
	AdvertiserId int64      `json:"advertiser_id,omitempty"`
	BudgetMode   BudgetMode `json:"budget_mode,omitempty"`
	Budget       float64    `json:"budget,omitempty"`
}

type AdvertiserBudgetUpdateRsp ¶

type AdvertiserBudgetUpdateRsp struct {
	Code      int    `json:"code,omitempty"`
	Message   string `json:"message,omitempty"`
	RequestId string `json:"request_id,omitempty"`
}

type AdvertiserDailyBudgetRsp ¶

type AdvertiserDailyBudgetRsp struct {
	Code      int                          `json:"code,omitempty"`
	Message   string                       `json:"message,omitempty"`
	Data      AdvertiserDailyBudgetRspData `json:"data,omitempty"`
	RequestId string                       `json:"request_id,omitempty"`
}

type AdvertiserDailyBudgetRspData ¶

type AdvertiserDailyBudgetRspData struct {
	List []AdvertiserDailyBudgetRspDataList `json:"list,omitempty"`
}

type AdvertiserDailyBudgetRspDataList ¶

type AdvertiserDailyBudgetRspDataList struct {
	AdvertiserId int64      `json:"advertiser_id,omitempty"`
	Budget       float64    `json:"budget,omitempty"`
	BudgetMode   BudgetMode `json:"budget_mode,omitempty"`
}

type AppDownloadModeType ¶

type AppDownloadModeType string

type AppDownloadType ¶

type AppDownloadType string

type BudgetAndBid ¶

type BudgetAndBid struct {
	SmartBidType    SmartBidType    `json:"smart_bid_type,omitempty"`    // 投放场景(出价方式) 允许值: 常规投放"SMART_BID_CUSTOM", 放量投放"SMART_BID_CONSERVATIVE" 概念解释：常规投放：控制成本，尽量消耗完预算；放量投放：接受成本上浮，尽量消耗更多预算
	AdjustCpa       int64           `json:"adjust_cpa,omitempty"`        // 是否调整自动出价，意味如果预期成本不在范围内将在此基础上调整，仅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必填  允许值: "0", "1"  默认值: "0"
	FlowControlMode FlowControlMode `json:"flow_control_mode,omitempty"` // 竞价策略(投放方式) 允许值: "FLOW_CONTROL_MODE_FAST"优先跑量（对应CPC的加速投放）, "FLOW_CONTROL_MODE_SMOOTH"优先低成本（对应CPC的标准投放）, "FLOW_CONTROL_MODE_BALANCE"均衡投放（新增字段）
	BudgetMode      BudgetMode      `json:"budget_mode,omitempty"`       // 预算类型(创建后不可修改) 允许值: "BUDGET_MODE_DAY"日预算, "BUDGET_MODE_TOTAL"总预算
	Budget          int64           `json:"budget,omitempty"`            // 预算(出价方式为CPC、CPM、CPV时，不少于100元；出价方式为OCPM、OCPC时，不少于300元；24小时内修改预算操作，不能超过20次，24小时是指自然天的24小时；单次修改预算幅度不能低于100元（增加或者减少）；修改后预算金额，不能低于当前已消费金额的105%，以整百单位向上取整；取值范围: ≥ 0
	ScheduleType    ScheduleType    `json:"schedule_type,omitempty"`     // 投放时间类型 允许值: "SCHEDULE_FROM_NOW"从今天起长期投放, "SCHEDULE_START_END"设置开始和结束日期
	StartTime       string          `json:"start_time,omitempty"`        // 投放起始时间，当schedule_type为"SCHEDULE_START_END"时必填，形式如：2017-01-01 00:00 广告投放起始时间不允许修改
	EndTime         string          `json:"end_time,omitempty"`          // 投放结束时间，当schedule_type为"SCHEDULE_START_END"时必填，形式如：2017-01-01 00:00
	ScheduleTime    string          `json:"schedule_time,omitempty"`     // 投放时段，默认全时段投放，格式是48*7位字符串，且都是0或1。也就是以半个小时为最小粒度，周一至周日每天分为48个区段，0为不投放，1为投放，不传、全传0、全传1均代表全时段投放。 例如：填写"000000000000000000000001111000000000000000000000000000000000000000000001111000000000000000000000000000000000000000000001111000000000000000000000000000000000000000000001111000000000000000000000000000000000000000000001111000000000000000000000000000000000000000000001111000000000000000000000000000000000000000000001111000000000000000000000"，则投放时段为周一到周日的11:30~13:30
	Pricing         AdPricingType   `json:"pricing,omitempty"`           // 付费方式（计划出价类型（目前仅穿山甲类型支持OCPC(具体方式：出价类型传OCPC类型，cpa_bid传值 )） 决定投放目标的类型，比如CPC表示点击量，OCPM表示转化量
	Bid             float64         `json:"bid,omitempty"`               // 点击出价/展示出价，当pricing为"CPC"、"CPM"、"CPA"出价方式时必填 pricing为"CPC"时取值范围：0.2-100元； pricing为"CPM"时取值范围：4-100元; pricing为"CPA"时取值范围：1-1500元; 出价不能大于预算否则会报错
	CpaBid          float64         `json:"cpa_bid,omitempty"`           // 目标转化出价/预期成本， 当pricing为"OCPM"、"OCPC"出价方式时必填 pricing为"OCPC"时取值范围：0.1-10000元； pricing为"OCPM"时取值范围：0.1-10000元； 出价不能大于预算否则会报错
	DeepBidType     AdDeepBidType   `json:"deep_bid_type,omitempty"`     // 深度优化方式 对于每次付费的转化，深度优化类型需要设置为BID_PER_ACTION（每次付费出价） 具体概念见【深度优化方式】  当转化目标中含有深度转化时，该字段必填。 API后期会上线获取可用深度优化方式，请关注上线通知
	DeepCpaBid      float64         `json:"deep_cpabid,omitempty"`       // 深度优化出价，deep_bid_type为"DEEP_BID_MIN"时必填。当对应的转化convert_id，设定深度转化目标时才会有效。
	LubanRoiGoal    float64         `json:"luban_roi_goal,omitempty"`    // 鲁班目标ROI出价策略系数。推广目的为商品推广(GOODS)时可填。当传入该参数时，表示启用鲁班ROI优化，支持范围(0,100]，精度：保留小数点后四位
	RoiGoal         float64         `json:"roi_goal,omitempty"`          // 深度转化ROI系数, 范围(0,5]，精度：保留小数点后四位, deep_bid_type为"ROI_COEFFICIENT"时必填
}

预算与出价相关字段

type BudgetMode ¶

type BudgetMode string

type CampaignStatus ¶

type CampaignStatus string

type CommodityAudience ¶

type CommodityAudience struct {
	DpaLbs               int64       `json:"dpa_lbs,omitempty"`                // 地域匹配-LBS 开启时，根据用户的地理位置信息，给用户投放位于其附近的产品 允许值：0，1（0表示不启用，1表示启用）
	DpaCity              int64       `json:"dpa_city,omitempty"`               // 地域匹配-商品所在城市 开启时，仅将商品投放给位于该商品设置的可投城市的用户 允许值：0，1（0表示不启用，1表示启用）
	DpaProvince          int64       `json:"dpa_province,omitempty"`           //地域匹配-商品所在省份 开启时，将商品仅投放给位于该商品设置的可投省份的用户 允许值：0，1（0表示不启用，1表示启用）
	DpaLocalAudience     int64       `json:"dpa_local_audience,omitempty"`     // DPA行为重定向，0:不启用，1：启用
	IncludeCustomActions interface{} `json:"include_custom_actions,omitempty"` // 包含人群包((DPA推广目的特有,格式举例[{"days": 7, "code": 1001},]， dpa_local_audience为1时必填; day可选范围:1, 7, 14, 28, 60, 90, 120, 180。
	ExcludeCustomActions interface{} `json:"exclude_custom_actions,omitempty"` // 排除人群包((DPA推广目的特有,格式举例{"days": 7, "code": 1002},]，day可选范围: 1, 7, 14, 28, 60, 90, 120, 180。
	DpaRecommendType     int64       `json:"dpa_recommend_type,omitempty"`     // dpa商品重定向推荐类型，dpa_local_audience为1时必填; 允许值：1（基于重定向推荐更多商品(根据重定向商品和行业特点，推荐更多相关商品投放，包含重定向商品），2仅重定向商品（仅根据重定向人群内定义的重定向行为商品进行投放）
}

商品定向仅推广目的为DPA时可用

type Creative ¶

type Creative struct {
	CreativeId           int64    `json:"creative_id,omitempty"`             // 创意ID。当类型为程序化创意时，没有审核通过前，该字段为null
	ImageMode            string   `json:"image_mode,omitempty"`              // 素材类型
	Title                string   `json:"title,omitempty"`                   // 创意标题
	CreativeWordIds      []int64  `json:"creative_word_ids,omitempty"`       // 动态词包ID
	ImageIds             []string `json:"image_ids,omitempty"`               // 图片ID列表，图片素材返回
	ImageId              string   `json:"image_id,omitempty"`                // 图片ID，视频封面，视频素材时返回
	VideoId              string   `json:"video_id,omitempty"`                // 视频ID，视频素材时返回
	DerivePosterCid      int      `json:"derive_poster_cid,omitempty"`       // 是否将视频的封面和标题同步到图片创意，1为开启，0为不开启。视频素材时返回
	ThirdPartyId         string   `json:"third_party_id,omitempty"`          // 创意自定义参数，例如开发者可设定此参数为创意打标签，用于区分使用的素材
	DpaDictIds           []int64  `json:"dpa_dict_ids,omitempty"`            // DPA词包ID列表，针对DPA广告
	TemplateId           int64    `json:"template_id,omitempty"`             // DPA模板ID，针对DPA广告
	TemplateImageId      string   `json:"template_image_id,omitempty"`       // DPA创意实际显示的图片ID，针对DPA广
	DpaTemplate          int64    `json:"dpa_template,omitempty"`            // 是否使用商品库视频模板，针对DPA广告
	DpaVideoTemplateType string   `json:"dpa_video_template_type,omitempty"` // 商品库视频模板生成类型，针对DPA广告
	DpaVideoTaskIds      []string `json:"dpa_video_task_ids,omitempty"`      // 自定义商品库视频模板ID，针对DPA广告
}

type CreativeCommerceCards ¶

type CreativeCommerceCards struct {
	Title                string     `json:"title,omitempty"`                  // 标题
	StartTime            string     `json:"start_time,omitempty"`             // 投放开始时间，形式如：2017-01-01 00:00:00
	EndTime              string     `json:"end_time,omitempty"`               // 投放结束时间，形式如：2017-01-01 00:00:00
	ButtonText           string     `json:"button_text,omitempty"`            // 按钮文案
	Source               string     `json:"source,omitempty"`                 // 广告源（如店铺名称等）
	AdvancedDurationType string     `json:"advanced_duration_type,omitempty"` // 卡片出现时间类型
	AdvancedDuration     int        `json:"advanced_duration,omitempty"`      // 卡片出现时间
	Type                 string     `json:"type,omitempty"`                   // 组件类型
	ExternalUrl          string     `json:"external_url,omitempty"`           // 落地页链接
	ImageInfo            *ImageInfo `json:"image_info,omitempty"`             // 素材信息
}

type CreativeImageInfo ¶

type CreativeImageInfo struct {
	ImageMode CreativeImageMode `json:"image_mode,omitempty"` // 素材类型，必填，注意：程序化创意不支持组图 CREATIVE_IMAGE_MODE_GROUP，其他类型图片都支持，如横版/竖版大图、小图。详见【附录-素材类型】

	ImageId  string   `json:"image_id,omitempty"`  // 图片ID，视频封面，视频素材时填写。可通过【获取图片素材】接口获得
	VideoId  string   `json:"video_id,omitempty"`  // 视频ID，视频素材时填写。可通过【获取视频素材】接口获得
	ImageIds []string `json:"image_ids,omitempty"` // 图片ID列表，非视频素材时填写。图片ID和视频ID可通过【获取图片素材】接口获得。组图类型传3张图，其他图片类型传1张，否则会报错。图片大小不能超过1.5M
}

type CreativeImageMode ¶

type CreativeImageMode string // 媒体素材类型

type CreativePromotionCard ¶

type CreativePromotionCard struct {
	EnableStorePack      bool     `json:"enable_store_pack"`                // 是否使用门店包，true为使用，false为不使用，推广目的非门店推广时会忽略该字段。若选择使用，则卡片标题为{最近门店名称}
	ProductSellingPoints []string `json:"product_selling_points,omitempty"` // 商品卖点
	ProductDescription   string   `json:"product_description,omitempty"`    // 商品描述
	CallToAction         string   `json:"call_to_action,omitempty"`         // 行动号召
	EnablePersonalAction bool     `json:"enable_personal_action,omitempty"` // 是否使用智能优选，true为使用，false为不使用
	ProductImageId       string   `json:"product_image_id,omitempty"`       // 商品图片ID
}

type CreativeTitleInfo ¶

type CreativeTitleInfo struct {
	Title           string  `json:"title,omitempty"`             // 创意标题，如果要使用动态词包，格式：“XXX{词包名}XXX{词包名}XXX”。请注意当您使用动态词包时，需在creative_word_ids字段中按顺序传入词包ID，并且在一个标题中最多使用两个动态词包。长度为5-30个字, 两个英文字符占1位。
	CreativeWordIds []int64 `json:"creative_word_ids,omitempty"` // 动态词包ID，最多支持两个词包。可使用【查询动态创意词包】获得，结合标题中的词包格式您需要填写相同个数与顺序的词包ID，如果实际ID顺序与标题中词包名顺序不一致我们将以词包ID顺序为准
}

type DownloadType ¶

type DownloadType string

type FlowControlMode ¶

type FlowControlMode string // 计划投放速度类型

type Geolocation ¶

type Geolocation struct {
	Radius       int64   `json:"radius,omitempty"`        // 半径
	Name         string  `json:"name,omitempty"`          // 地点名称
	Long         float64 `json:"long,omitempty"`          // 经度
	Lat          float64 `json:"lat,omitempty"`           // 纬度
	City         string  `json:"city,omitempty"`          // 城市名
	StreetNumber string  `json:"street_number,omitempty"` // 街道号
	Street       string  `json:"street,omitempty"`        // 街道名
	District     string  `json:"district,omitempty"`      // 区域
	Province     string  `json:"province,omitempty"`      // 省份名
}

type ImageInfo ¶

type ImageInfo struct {
	Width  string `json:"width,omitempty"`   // 宽度
	Height string `json:"height,omitempty"`  // 高度
	WebUri string `json:"web_uri,omitempty"` // 链接
}

type InventoryType ¶

type InventoryType string // 投放位置

type LandingType ¶

type LandingType string

type LearningPhase ¶

type LearningPhase string // 计划学习期状态

type MaterialImageAddReq ¶

type MaterialImageAddReq struct {
	AdvertiserId   int64      `json:"advertiser_id,omitempty"`   // 广告主ID
	UploadType     UploadType `json:"upload_type,omitempty"`     // 图片上传方式
	ImageSignature string     `json:"image_signature,omitempty"` // 图片的md5值(用于服务端校验) upload_type为UPLOAD_BY_FILE必填
	ImageFile      *os.File   `json:"image_file,omitempty"`      // 图片文件 upload_type为UPLOAD_BY_FILE必填 格式: jpg、jpeg、png、bmp、gif, 大小1.5M内
	ImageUrl       string     `json:"image_url,omitempty"`       // 图片url地址，如http://xxx.xxx upload_type为UPLOAD_BY_URL必填
	Filename       string     `json:"filename,omitempty"`        // 素材的文件名，可自定义素材名，不传择默认取文件名，最长255个字符 注：若同一素材已进行上传，重新上传不会改名
}

type MaterialImageAddRsp ¶

type MaterialImageAddRsp struct {
	Code      int                     `json:"code,omitempty"`
	Message   string                  `json:"message,omitempty"`
	Data      MaterialImageAddRspData `json:"data,omitempty"`
	RequestId string                  `json:"request_id,omitempty"`
}

type MaterialImageAddRspData ¶

type MaterialImageAddRspData struct {
	Id         string `json:"id,omitempty"`          // 图片id
	Size       int64  `json:"size,omitempty"`        // 图片大小
	Width      int64  `json:"width,omitempty"`       // 图片宽度
	Height     int64  `json:"height,omitempty"`      // 图片高度
	Url        string `json:"url,omitempty"`         // 图片预览地址(1小时内有效)
	Format     string `json:"format,omitempty"`      // 图片格式
	Signature  string `json:"signature,omitempty"`   // 图片md5
	MaterialId int64  `json:"material_id,omitempty"` // 素材id，即多合一报表中的素材id，一个素材唯一对应一个素材id
}

type MaterialPushReq ¶

type MaterialPushReq struct {
	AdvertiserId        int64    `json:"advertiser_id,omitempty"`
	TargetAdvertiserIds []int64  `json:"target_advertiser_ids,omitempty"`
	VideoIds            []string `json:"video_ids,omitempty"`
	ImageIds            []string `json:"image_ids,omitempty"`
}

type MaterialPushRsp ¶

type MaterialPushRsp struct {
	Code      int                 `json:"code,omitempty"`
	Message   string              `json:"message,omitempty"`
	Data      MaterialPushRspData `json:"data,omitempty"`
	RequestId string              `json:"request_id,omitempty"`
}

type MaterialPushRspData ¶

type MaterialPushRspData struct {
	FailList []MaterialPushRspDataFailList `json:"fail_list,omitempty"`
}

type MaterialPushRspDataFailList ¶

type MaterialPushRspDataFailList struct {
	VideoId            string         `json:"video_id,omitempty"`
	ImageId            string         `json:"image_id,omitempty"`
	TargetAdvertiserId int64          `json:"target_advertiser_id,omitempty"`
	FailReason         PushFailReason `json:"fail_reason,omitempty"`
}

type MaterialVideoAddReq ¶

type MaterialVideoAddReq struct {
	AdvertiserId   int64    `json:"advertiser_id,omitempty"`   // 广告主ID
	VideoSignature string   `json:"video_signature,omitempty"` // 视频的md5值(用于服务端校验)
	VideoFile      *os.File `json:"video_file,omitempty"`      // 视频文件 允许格式：mp4、mpeg、3gp、avi（10s超时限制）
	Filename       string   `json:"filename,omitempty"`        // 素材的文件名，可自定义素材名，不传择默认取文件名，最长255个字符 注：若同一素材已进行上传，重新上传不会改名
}

type MaterialVideoAddRsp ¶

type MaterialVideoAddRsp struct {
	Code      int                     `json:"code,omitempty"`
	Message   string                  `json:"message,omitempty"`
	Data      MaterialVideoAddRspData `json:"data,omitempty"`
	RequestId string                  `json:"request_id,omitempty"`
}

type MaterialVideoAddRspData ¶

type MaterialVideoAddRspData struct {
	VideoId    string  `json:"video_id,omitempty"`
	Size       int64   `json:"size,omitempty"`
	Width      int64   `json:"width,omitempty"`
	Height     int64   `json:"height,omitempty"`
	VideoUrl   string  `json:"video_url,omitempty"`
	Duration   float64 `json:"duration,omitempty"`
	MaterialId int64   `json:"material_id,omitempty"` // 素材id，即多合一报表中的素材id，一个素材唯一对应一个素材id
}

type MaterialVideoCoverGetRsp ¶

type MaterialVideoCoverGetRsp struct {
	Code      int                          `json:"code,omitempty"`
	Message   string                       `json:"message,omitempty"`
	Data      MaterialVideoCoverGetRspData `json:"data,omitempty"`
	RequestId string                       `json:"request_id,omitempty"`
}

type MaterialVideoCoverGetRspData ¶

type MaterialVideoCoverGetRspData struct {
	Status VideoCoverStatus         `json:"status,omitempty"`
	List   []MaterialVideoCoverList `json:"list,omitempty"`
}

type MaterialVideoCoverList ¶

type MaterialVideoCoverList struct {
	Id     string `json:"id,omitempty"`
	Width  int64  `json:"width,omitempty"`
	Height int64  `json:"height,omitempty"`
	Url    string `json:"url,omitempty"`
}

type MaterialVideoGetFilter ¶

type MaterialVideoGetFilter struct {
	Width       int64    `json:"width,omitempty"`
	Height      int64    `json:"height,omitempty"`
	Ratio       float64  `json:"ratio,omitempty"`
	VideoIds    []string `json:"video_ids,omitempty"`
	MaterialIds []int64  `json:"material_ids,omitempty"`
	Signatures  []string `json:"signatures,omitempty"`
	StartTime   string   `json:"start_time,omitempty"` // 根据视频上传时间进行过滤的起始时间，与end_time搭配使用，格式：yyyy-mm-dd
	EndTime     string   `json:"end_time,omitempty"`
}

type MaterialVideoGetOpts ¶

type MaterialVideoGetOpts struct {
	Filtering optional.Interface `json:"filtering,omitempty"` // 过滤条件，若此字段不传，或传空则视为无限制条件
	Page      optional.Int64     `json:"page,omitempty"`      // 当前页码: 1
	PageSize  optional.Int64     `json:"page_size,omitempty"` // 页面大小 默认值: 10， 取值范围：1-1000
}

type MaterialVideoGetRsp ¶

type MaterialVideoGetRsp struct {
	Code      int                     `json:"code,omitempty"`
	Message   string                  `json:"message,omitempty"`
	Data      MaterialVideoGetRspData `json:"data,omitempty"`
	RequestId string                  `json:"request_id,omitempty"`
}

type MaterialVideoGetRspData ¶

type MaterialVideoGetRspData struct {
	List     []MaterialVideoGetRspDataList `json:"list,omitempty"`
	PageInfo PageInfo                      `json:"page_info,omitempty"`
}

type MaterialVideoGetRspDataList ¶

type MaterialVideoGetRspDataList struct {
	Id         string  `json:"id,omitempty"`
	Size       int64   `json:"size,omitempty"`
	Width      int64   `json:"width,omitempty"`
	Height     int64   `json:"height,omitempty"`
	Url        string  `json:"url,omitempty"`
	Format     string  `json:"format,omitempty"`
	Signature  string  `json:"signature,omitempty"`
	PosterUrl  string  `json:"poster_url,omitempty"` // 视频首帧截图，仅限同主体进行素材预览查看，若非同主体会返回“素材所属主体与开发者主体不一致无法获取URL”，链接1小时过期
	BitRate    int64   `json:"bit_rate,omitempty"`   // 码率，单位bps
	Duration   float64 `json:"duration,omitempty"`   // 视频时长
	MaterialId int64   `json:"material_id,omitempty"`
	Source     string  `json:"source,omitempty"`      // 视频来源
	CreateTime string  `json:"create_time,omitempty"` // 素材的上传时间，格式："yyyy-mm-dd HH:MM:SS"
	Filename   string  `json:"filename,omitempty"`
}

type PageInfo ¶

type PageInfo struct {
	Page        int `json:"page,omitempty"`         // 页数
	PageSize    int `json:"page_size,omitempty"`    // 页面大小
	TotalNumber int `json:"total_number,omitempty"` // 总数
	TotalPage   int `json:"total_page,omitempty"`   // 总页数
}

type PushFailReason ¶

type PushFailReason string

const (
	VideoBindingExisted PushFailReason = "VIDEO_BINDING_EXISTED" // 视频已存在
	ImageBindingExisted PushFailReason = "IMAGE_BINDING_EXISTED" // 图片已存在
)

func (PushFailReason) String ¶

func (p PushFailReason) String() string

type ScheduleType ¶

type ScheduleType string // 投放时间类型

type SmartBidType ¶

type SmartBidType string // 投放场景(出价方式)

type ToolsADStatExtraInfoRsp ¶

type ToolsADStatExtraInfoRsp struct {
	Code      int                           `json:"code,omitempty"`
	Message   string                        `json:"message,omitempty"`
	Data      []ToolsAdStatExtraInfoRspData `json:"data,omitempty"`
	RequestId string                        `json:"request_id,omitempty"`
}

type ToolsActionTextGetOpts ¶

type ToolsActionTextGetOpts struct {
	AdvancedCreativeType optional.String `json:"advanced_creative_type,omitempty"` // 附加创意类型
	Industry             optional.Int64  `json:"industry,omitempty"`               // 广告主行业id
}

type ToolsActionTextGetRsp ¶

type ToolsActionTextGetRsp struct {
	Code      int      `json:"code,omitempty"`
	Message   string   `json:"message,omitempty"`
	Data      []string `json:"data,omitempty"`
	RequestId string   `json:"request_id,omitempty"`
}

type ToolsAdDiagnosisFunnelData ¶

type ToolsAdDiagnosisFunnelData struct {
	Target       ToolsAdDiagnosisFunnelDataRank         `json:"target,omitempty"` // 投放漏斗数据，定向阶段
	Rank         ToolsAdDiagnosisFunnelDataRank         `json:"rank,omitempty"`   // 投放漏斗数据，竞价阶段，字段同target
	Attributions ToolsAdDiagnosisFunnelDataAttributions `json:"attributions,omitempty"`
	RitResult    ToolsAdDiagnosisFunnelDataRitResult    `json:"rit_result,omitempty"` // 分投放位置的诊断结果集，键为广告位(INVENTORY_FEED/INVENTORY_HOTSOON_FEED/INVENTORY_AWEME_FEED/INVENTORY_VIDEO_FEED)，值见下表
}

type ToolsAdDiagnosisFunnelDataAttributions ¶

type ToolsAdDiagnosisFunnelDataAttributions struct {
	Name            string  `json:"name,omitempty"`              // 投放设置名称，eg. 落地页
	Severity        float64 `json:"severity,omitempty"`          // 0~1表示非常好到非常差
	Conclusion      string  `json:"conclusion,omitempty"`        // 诊断结论 eg. 转化率正常
	CardConclusion  string  `json:"card_conclusion,omitempty"`   // 卡片诊断结论 eg.一般
	CellValue       string  `json:"cell_value,omitempty"`        // 诊断计划的投放要素取值 eg. 2.4%
	BenchValue      string  `json:"bench_value,omitempty"`       // 比较对象的投放要素取值 eg. 3.5%
	LandingPageInfo string  `json:"landing_page_info,omitempty"` // 落地页洞察数据 eg. {"data":{"site":{"stats":{"loadTimeRank":0.632539,"loadTime":1691,"bouncedRateRank":1.000000,"bouncedRate":0.500000,"visitTimeRank":0.229752,"visitTime":10139,"exposureRateRank":0.272873,"exposureRate":51.000000}}}}
	FutureStarRates []struct {
		RateList []float64 `json:"rate_list,omitempty"` // 调价比例
		BidList  []float64 `json:"bid_list,omitempty"`  // 建议出价
		CostList []float64 `json:"cost_list,omitempty"` // cost_list为预估展示提升

	} `json:"future_star_rates,omitempty"` // 潜力广告的预估值，非潜力广告取值为空
	ModifyOption string  `json:"modify_option,omitempty"` // 建议采纳按键的操作
	OriginValue  float64 `json:"origin_value,omitempty"`  // 修改项的原始值
	SuggestValue float64 `json:"suggest_value,omitempty"` // 修改项的建议修改值
}

type ToolsAdDiagnosisFunnelDataRank ¶

type ToolsAdDiagnosisFunnelDataRank struct {
	SortRank float64 `json:"sort_rank,omitempty"` // 漏斗通过率排序
	Bench    float64 `json:"bench,omitempty"`     // 标杆漏斗通过率值
	Aim      float64 `json:"aim,omitempty"`       // 该广告计划漏斗通过率值
}

type ToolsAdDiagnosisFunnelDataRitResult ¶

type ToolsAdDiagnosisFunnelDataRitResult struct {
	Severity     float64 `json:"severity,omitempty"`     // 0~1表示非常好到非常差
	Conclusion   string  `json:"conclusion,omitempty"`   // 诊断结论 eg. 转化率正常
	FunnelData   string  `json:"funnel_data,omitempty"`  // 定义同funnel_data
	Attributions string  `json:"attributions,omitempty"` // 定义同attributions
}

type ToolsAdDiagnosisRsp ¶

type ToolsAdDiagnosisRsp struct {
	Code      int                     `json:"code,omitempty"`
	Message   string                  `json:"message,omitempty"`
	Data      ToolsAdDiagnosisRspData `json:"data,omitempty"`
	RequestId string                  `json:"request_id,omitempty"`
}

type ToolsAdDiagnosisRspData ¶

type ToolsAdDiagnosisRspData struct {
	List []ToolsAdDiagnosisRspDataList `json:"list,omitempty"`
}

type ToolsAdDiagnosisRspDataList ¶

type ToolsAdDiagnosisRspDataList struct {
	Id            int64                      `json:"id,omitempty"`              // 兴趣词包id
	Severity      float64                    `json:"severity,omitempty"`        // attributions.severity的均值，0~1表示非常好到非常差
	Conclusion    string                     `json:"conclusion,omitempty"`      // 归因的主要结论。显示在列表页的“诊断结果”
	TimeRange     string                     `json:"time_range,omitempty"`      // 时间范围 eg. 2019-04-09 08:08 ~ 10:08
	TargetQuality string                     `json:"target_quality,omitempty"`  // 广告定向质量度（覆盖度，精准度，蓝海度），eg. {"aud_num": 0.311046511627907, "datetime": "2019-03-02 00:46:54.463356", "precision": 0.3136427566807314, "blueocean": 0.030942334739803123}
	FutureStarTag bool                       `json:"future_star_tag,omitempty"` // 标识是否为潜力广告 true为潜力广告
	Issue         string                     `json:"issue,omitempty"`           // 说明，eg. 该计划今天的展示量环比昨天下降73%
	Reason        string                     `json:"reason,omitempty"`          // 投放问题原因
	Suggest       string                     `json:"suggest,omitempty"`         // 投放建议
	ColdStart     float64                    `json:"cold_start,omitempty"`      // 冷启动预估分数
	SceneTag      string                     `json:"scene_tag,omitempty"`       // 投放问题场景标签 取值："future_star(潜力计划)","drop(掉量计划)"
	ModifyOption  string                     `json:"modify_option,omitempty"`   // 建议采纳按键的操作 取值："一键撤销","修改预算","快速优化","优化落地页","修改出价","修改定向"
	OriginValue   float64                    `json:"origin_value,omitempty"`    // 修改项的原始值
	SuggestValue  float64                    `json:"suggest_value,omitempty"`   // 修改项的建议修改值
	FunnelData    ToolsAdDiagnosisFunnelData `json:"funnel_data,omitempty"`     // 投放漏斗数据

}

type ToolsAdQualityRsp ¶

type ToolsAdQualityRsp struct {
	Code      int                   `json:"code,omitempty"`
	Message   string                `json:"message,omitempty"`
	Data      ToolsAdQualityRspData `json:"data,omitempty"`
	RequestId string                `json:"request_id,omitempty"`
}

type ToolsAdQualityRspData ¶

type ToolsAdQualityRspData struct {
	List []ToolsAdQualityRspDataList `json:"list,omitempty"`
}

type ToolsAdQualityRspDataList ¶

type ToolsAdQualityRspDataList struct {
	AppId        int64   `json:"app_id,omitempty"`        // app的id，可在应用下载广告中使用
	QualityScore float64 `json:"quality_score,omitempty"` // 计划综合质量得分
	CtrScore     float64 `json:"ctr_score,omitempty"`     // 创意质量得分
	WebScore     float64 `json:"web_score,omitempty"`     // 落地页响应得分
	CvrScore     float64 `json:"cvr_score,omitempty"`     // 落地页素材得分
}

type ToolsAdStatExtraInfoRspData ¶

type ToolsAdStatExtraInfoRspData struct {
	AdId          int64         `json:"ad_id,omitempty"`
	LearningPhase LearningPhase `json:"learning_phase,omitempty"`
}

type ToolsIndustryGetOpts ¶

type ToolsIndustryGetOpts struct {
	Level optional.Int    `json:"level,omitempty"` // 只获取某级别数据，1:第一级,2:第二级,3:第三级，默认都返回
	Type  optional.String `json:"type,omitempty"`  // 可选值："ADVERTISER"，"AGENT"，"ADVERTISER"为原有广告3.0行业, "AGENT"为代理商行业获取，代理商行业level都为1
}

type ToolsIndustryGetRsp ¶

type ToolsIndustryGetRsp struct {
	Code      int                     `json:"code,omitempty"`
	Message   string                  `json:"message,omitempty"`
	Data      ToolsIndustryGetRspData `json:"data,omitempty"`
	RequestId string                  `json:"request_id,omitempty"`
}

type ToolsIndustryGetRspData ¶

type ToolsIndustryGetRspData struct {
	List []ToolsIndustryGetRspDataList `json:"list,omitempty"`
}

type ToolsIndustryGetRspDataList ¶

type ToolsIndustryGetRspDataList struct {
	IndustryId         int64  `json:"industry_id,omitempty"`          // 行业ID
	IndustryName       string `json:"industry_name,omitempty"`        // 行业名称
	Level              int    `json:"level,omitempty"`                // 所在级别，1：一级行业、2：二级行业、3：三级行业
	FirstIndustryId    int64  `json:"first_industry_id,omitempty"`    // 该行业的一级行业ID
	FirstIndustryName  string `json:"first_industry_name,omitempty"`  // 该行业的一级行业名称
	SecondIndustryId   int64  `json:"second_industry_id,omitempty"`   // 该行业的二级行业ID
	SecondIndustryName string `json:"second_industry_name,omitempty"` // 该行业的二级行业名称
	ThirdIndustryId    int64  `json:"third_industry_id,omitempty"`    // 该行业的三级行业ID
	ThirdIndustryName  string `json:"third_industry_name,omitempty"`  // 该行业的三级行业名称
}

type UploadType ¶

type UploadType string // 上传方式

type VideoCoverStatus ¶

type VideoCoverStatus string // 封面生成状态

Source Files ¶

View all Source files

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