unit

package
v1.1.2 Latest Latest
Warning

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

 Go to latest Published: Aug 28, 2024 License: Apache-2.0 Imports: 3 Imported by: 0

Documentation

Overview

Package unit 广告单元相关

Index

Constants

This section is empty.

Variables

This section is empty.

Functions

This section is empty.

Types

type CreateRequest added in v1.0.8 

type CreateRequest struct {
	// AdvertiserID 广告主ID
	AdvertiserID uint64 `json:"advertiser_id,omitempty"`
	// CampaignID 计划ID
	CampaignID uint64 `json:"campaign_id,omitempty"`
	// UnitName 单元名称
	UnitName string `json:"unit_name,omitempty"`
	// EventBid 出价/目标成本，单位分，自动控制不需要传
	EventBid int64 `json:"event_bid,omitempty"`
	// NoteIDs 标的-笔记id(帮助定向推荐，创意里的笔记会单独填写)非种草人群规模、深度种草人群规模下必填
	NoteIDs []string `json:"note_ids,omitempty"`
	// PromotionTarget 推广标的（笔记1）
	PromotionTarget int `json:"promotion_target,omitempty"`
	// TargetType 定向类型，1-通投,2-智能定向, 3-高级定向
	TargetType enum.UnitTargetType `json:"target_type,omitempty"`
	// TargetConfig 定向配置
	TargetConfig *TargetConfig `json:"target_config,omitempty"`
	// KeywordTargetPeriod 关键词时间周期，单位天，枚举包括 3，7，15，30
	KeywordTargetPeriod int `json:"keyword_target_period,omitempty"`
	// KeywordTargetAction 关键词目标行为
	// 1: 搜索，2: 互动，3: 阅读
	KeywordTargetAction []enum.KeywordTargetAction `json:"keyword_target_action,omitempty"`
	// BusinessTreeName 推广业务信息示例：生活服务>婚纱摄影;美妆个护;母婴>母婴食品>奶粉具体参看/api/open/jg/keyword/industry/taxonomy接口返回词。
	BusinessTreeName string `json:"business_tree_name,omitempty"`
	// SpuNoteInfo spu&笔记标的信息推广目标是种草人群规模、深度种草人群规模下必传。spu只能一个，至少绑定5篇笔记，最多50(api限制)只能选择合作笔记与我的笔记，笔记违规不能选，spu审核不通过也可以选，选择的笔记一定是绑定在该spu上。
	SpuNoteInfo []SpuNoteConfig `json:"spu_note_info,omitempty"`
	// KeywordWithBid 关键词，通过(关键词词包)/api/open/jg/keyword/word/bag/list (智能推词、行业推词、以词推词)/api/open/jg/keyword/common/recommend 接口获取搜索推广-标准投放下必传
	KeywordWithBid []KeywordWithBid `json:"keyword_with_bid,omitempty"`
	// SubstitutedUserID 代投账号b的userId，代投笔记与其他笔记互斥,，需要校验是否有代投账号权限
	SubstitutedUserID string `json:"substituted_user_id,omitempty"`
	// KeywordGenType 单元选词方式：
	// -1:无意义默认值 0:手动选词 1:智能拓词 2:手动+智能
	// 关键词定向且在白名单中才支持
	KeywordGenType int `json:"keyword_gen_type,omitempty"`
	// PageID 落地页ID，聚光落地页下必填
	PageID string `json:"page_id,omitempty"`
	// LandingPageURL 落地页Url，自研落地页下必填
	LandingPageURL string `json:"landing_page_url,omitempty"`
	// UnitExternalPageURL 外链Url，标的是外链落地页时必填
	UnitExternalPageURL string `json:"unit_external_page_url,omitempty"`
	// UnitLandingPageDesc 落地页表单描述
	UnitLandingPageDesc string `json:"unit_landing_page_desc,omitempty"`
	// TargetTemplateID 定向包id
	TargetTemplateID string `json:"target_template_id,omitempty"`
}

CreateRequest 创建单元

func (CreateRequest) Encode added in v1.0.8 

func (r CreateRequest) Encode() []byte

Encode implements PostRequest interface

type CreateResponse added in v1.0.8 

type CreateResponse struct {
	model.BaseResponse
	Data struct {
		// UnitID 单元ID
		UnitID uint64 `json:"unit_id,omitempty"`
	} `json:"data,omitempty"`
}

CreateResponse 创建单元 API Response

type CrowdPackage 

type CrowdPackage struct {
	// Value 人群包id
	Value string `json:"value,omitempty"`
	// Name 人群包名称
	Name string `json:"name,omitempty"`
	// Desc 人群包描述
	Desc string `json:"desc,omitempty"`
	// Type 人群包类型
	// 人群包的类型,特色人群:outside/common,节促人群:timeliness没有type的时候表示是客户自己上传的人群包
	// type: ti, TI潜力转化人群（优化目标是ti人群才可使用，本期不涉及）type: expose, 直播间活跃人群（直播间营销目标才可使用,本期不涉及）
	Type string `json:"type,omitempty"`
	// GroupID 人群包真实ID
	GroupID string `json:"group_id,omitempty"`
	// SyncStatus 同步状态,0:未同步,1:已同步
	// 只用已同步(1)状态的才可用
	SyncStatus int `json:"sync_status,omitempty"`
	// Status 删除可用状态,2:成功,3计算失败:,4:停止更新
	// 只用成功(2)状态的才可用
	Status int `json:"status,omitempty"`
	// DmpPermission
	DmpPermission bool `json:"dmp_permission,omitempty"`
}

CrowdPackage 人群包

type CrowdTarget 

type CrowdTarget struct {
	// CrowdPkg 人群包列表
	CrowdPkg []CrowdPackage `json:"crowd_pkg,omitempty"`
}

CrowdTarget 人群包列表

type CustomizedDendelionCrowd 

type CustomizedDendelionCrowd struct {
	// ActionType 行为类型:imp,read
	ActionType enum.CrowdActionType `json:"action_type,omitempty"`
	// CrowdName 蒲公英定制人群包名称
	CrowdName string `json:"crowd_name,omitempty"`
	// NotIDList 笔记ids
	NoteIDList []string `json:"note_id_list,omitempty"`
	// Channels 流量渠道：ad/nature
	Channels []string `json:"channels,omitempty"`
	// TimePeriod 时间周期，30，90
	TimePeroid int `json:"time_period,omitempty"`
	// CrowdID 蒲公英定制人群包Id
	CrowdID uint64 `json:"crowd_id,omitempty"`
}

type DendelionCrowd 

type DendelionCrowd struct {
	NormalDendelionCrowdList     []NormalDendelionCrowd     `json:"normal_dandelion_crowd_list,omitempty"`
	CustomizedDendelionCrowdList []CustomizedDendelionCrowd `json:"customized_dandelion_crowd_List,omitempty"`
}

DendelionCrowd 蒲公英人群

type EcBehaviorTarget 

type EcBehaviorTarget struct{}

EcBehaviorTarget 电商行为人群

type IndustryInterestTarget 

type IndustryInterestTarget struct {
	// ContentInterest 内容兴趣
	ContentInterest []model.CodeNamePair `json:"content_interest,omitempty"`
	// ShoppingInterest 购物兴趣
	ShoppingInterest []model.CodeNamePair `json:"shopping_interest,omitempty"`
}

IndustryInterestTarget 行业兴趣

type ItemNoteConfig 

type ItemNoteConfig struct {
	// ItemID 商品id
	ItemID string `json:"item_id,omitempty"`
	// NoteIDs 绑定的笔记id
	NoteIDs []string `json:"note_ids,omitempty"`
}

ItemNoteConfig 单元标的信息

type KeywordWithBid 

type KeywordWithBid struct {
	// Keyword 关键词
	Keyword string `json:"keyword,omitempty"`
	// Bid 关键词出价
	Bid int64 `json:"bid,omitempty"`
	// KeywordSource 关键词来源
	// 2：旧通道来源
	// 11：笔记id通道
	// 14：笔记行业通道
	// 15：笔记类目通道
	// 16：笔记图模型通道
	// 18：笔记id-v2通道
	// 20：以词推词核心term通道
	// 21：以词推词queryRewrite通道
	// 25：以词推词ES通道
	// 31：商品id通道
	// 32：商品spu类目通道
	// 35：商品类目通道
	// 36：商品行业通道
	// 50：表单默认通道
	// 51：表单行业通道
	// 57：表单pageId通道
	// 102：在线向量召回通道
	// 103：高相关性通道
	// 110：智投话题通道
	// 113：基础词包通道
	// 120：智投默认通道
	// 131：智投swing通道
	// 211：抢赛道通道
	KeywordSource int `json:"keyword_source,omitempty"`
	// PhraseMatchType 匹配方式
	// 0:精确匹配
	// 1:短语匹配
	// 2:智能匹配
	PhraseMatchType enum.PhraseMatchType `json:"phrase_match_type,omitempty"`
	// FeedBid 搜索追投出价
	FeedBid int64 `json:"feed_bid,omitempty"`
}

KeywordWithBid 选词出价

type ListRequest 

type ListRequest struct {
	// AdvertiserID 广告主id
	AdvertiserID uint64 `json:"advertiser_id,omitempty"`
	// CampaignID 广告计划id
	CampaignID uint64 `json:"campaign_id,omitempty"`
	// UnitIDs 单元id,不超过10个
	UnitIDs []uint64 `json:"unit_ids,omitempty"`
	// Status 投放状态：1：投放中2：暂停
	Status int `json:"status,omitempty"`
	// UnitName 单元名称
	UnitName string `json:"unit_name,omitempty"`
	// StartDate 创建单元开始时间
	StartDate string `json:"start_date,omitempty"`
	// EndDate 创建单元结束时间
	EndDate string `json:"end_date,omitempty"`
	// Page 请求的页码数，默认1
	Page int `json:"page,omitempty"`
	// PageSize 请求的每页行数，默认20
	PageSize int `json:"page_size,omitempty"`
}

ListRequest 获取单元列表 API Request

func (ListRequest) Encode 

func (r ListRequest) Encode() []byte

Encode implement PostRequest interface

type ListResponse 

type ListResponse struct {
	model.BaseResponse
	Data *ListResult `json:"data,omitempty"`
}

ListResponse 获取单元列表 API Response

type ListResult 

type ListResult struct {
	// TotalCount 总数
	TotalCount int `json:"total_count,omitempty"`
	// UnitInfos 单元信息
	UnitInfos []Unit `json:"unit_infos,omitempty"`
}

type LiveRoomActiveTarget 

type LiveRoomActiveTarget struct{}

LiveRoomActiveTarget 直播间活跃人群

type LiveStreamingFanTarget 

type LiveStreamingFanTarget struct{}

LiveStreamingFanTarget 直播人群

type NormalDendelionCrowd 

type NormalDendelionCrowd struct {
	// ActionType 行为类型:imp,read
	ActionType enum.CrowdActionType `json:"action_type,omitempty"`
	// BrandUserID 品牌用户Id
	BrandUserID string `json:"brand_user_id,omitempty"`
	// TimePeriod 时间周期，30，90
	TimePeroid int `json:"time_period,omitempty"`
}

type RecommendTarget 

type RecommendTarget struct {
	// HighPotential 高潜词包
	HighPotential []string `json:"high_potential,omitempty"`
	// InterestHighPotential 关键词兴趣-高潜词包
	InterestHighPotential []string `json:"interest_high_potential,omitempty"`
}

RecommendTarget 推荐定向

type SpuNoteConfig 

type SpuNoteConfig struct {
	// SpuID spuid
	SpuID string `json:"spu_id,omitempty"`
	// NoteIDs 绑定的笔记id
	NoteIDs []string `json:"note_ids,omitempty"`
}

SpuNoteConfig spu&笔记标的信息

type TargetConfig 

type TargetConfig struct {
	// TargetGender 定向性别"0"：男"1"：女"all"：全部
	TargetGender enum.TargetGender `json:"target_gender,omitempty"`
	// TargetAge 定向年龄"18-22""23-27""28-32""32-100""all"
	TargetAge string `json:"target_age,omitempty"`
	// TargetDevice 定向设备"ios""android""all"
	TargetDevice enum.TargetDevice `json:"target_device,omitempty"`
	// TargetCity 城市定向通过/get_available_target_info接口获取例如"北京#天津#衡阳"城市名称以#分割,all 代表全部省市
	TargetCity string `json:"target_city,omitempty"`
	// IndustryInterestTarget 行业兴趣
	IndustryInterestTarget *IndustryInterestTarget `json:"industry_interest_target,omitempty"`
	// CrowdTarget 人群包
	CrowdTarget *CrowdTarget `json:"crowd_target,omitempty"`
	// Keywords 关键词定向["口红","化妆"]
	Keywords []string `json:"keywords,omitempty"`
	// Recommend 推荐定向
	Recommend *RecommendTarget `json:"recommend_target,omitempty"`
	// DendelionCrowd 蒲公英人群
	DendelionCrowd *DendelionCrowd `json:"dendelion_crowd,omitempty"`
	// InterestKeywords 关键词兴趣定向，["口红","化妆"]
	InterestKeywords []string `json:"interest_keywords,omitempty"`
	// KeywordTargetPeriod 关键词时间周期，单位天，枚举包括 3，7，15，30	关键词行为定向选择时必填
	KeywordTargetPeriod int `json:"keyword_target_period,omitempty"`
	// KeywordTargetAction 关键词行为类型，1: 搜索，2: 互动，3: 阅读	关键词行为定向选择时必填
	KeywordTargetAction []enum.KeywordTargetAction `json:"keyword_target_action,omitempty"`
	// IntelligentExpension 智能扩量0：关闭1：开启
	IntelligentExpension int `json:"intelligent_expension,omitempty"`
	// HaveReverseBloggerFanTarget 是否选择反选博主粉丝人群
	HaveReverseBloggerFanTarget bool `json:"have_reverse_blogger_fan_target,omitempty"`
	// HaveReverseBloggerPurchasedTarget 是否选择反选博主购买人群
	HaveReverseBloggerPurchasedTarget bool `json:"have_reverse_blogger_purchased_target,omitempty"`
	// HaveBrandRecognitionGroup 是否选择本品牌认知人群
	HaveBrandRecognitionGroup bool `json:"have_brand_recognition_group,omitempty"`
	// HaveCategoryInterestGroup 是否选择行业种草人群
	HaveCategoryInterestGroup bool `json:"have_category_interest_group,omitempty"`
	// LiveStreamingFanTarget 直播人群
	LiveStreamingFanTarget *LiveStreamingFanTarget `json:"live_streaming_fan_target,omitempty"`
	// LiveRoomActiveTarget 直播间活跃人群
	LiveRoomActiveTarget *LiveRoomActiveTarget `json:"live_room_active_target,omitempty"`
	// EcBehaviorTarget 电商行为人群
	EcBehaviorTarget []EcBehaviorTarget `json:"ec_behavior_target,omitempty"`
}

TargetConfig 定向信息

type Unit 

type Unit struct {
	// ID 单元id
	ID uint64 `json:"id,omitempty"`
	// CampaignID 计划id
	CampaignID uint64 `json:"campaign_id,omitempty"`
	// Name 单元名称
	Name string `json:"name,omitempty"`
	// Enable 投放状态：0：暂停1：投放中
	Enable int `json:"enable,omitempty"`
	// EventBid 出价,单位(分)
	EventBid int64 `json:"event_bid,omitempty"`
	// TargetType 定向类型1-通投,2-智能定向,3-高级定向
	TargetType enum.UnitTargetType `json:"target_type,omitempty"`
	// ItemIDs 商品ID
	ItemIDs []string `json:"item_ids,omitempty"`
	// NoteIDs 笔记ID
	NoteIDs []string `json:"note_ids,omitempty"`
	// LiveUserID 直播用户ID
	LiveUserID string `json:"live_user_id,omitempty"`
	// PageID 落地页ID
	PageID string `json:"page_id,omitempty"`
	// LandingPageURL 	落地页Url
	LandingPageURL string `json:"landing_page_url,omitempty"`
	// UnitExternalPageURL 外链Url
	UnitExternalPageURL string `json:"unit_external_page_url,omitempty"`
	// LandingPageType 落地页链接类型:1-表单,2-外跳链接，0-默认值，无实际意义
	LandingPageType enum.LandingPageType `json:"landing_page_type,omitempty"`
	// TargetPosition 抢占资源1-首位,3-第三位，0-不限位置
	TargetPosition int `json:"target_position,omitempty"`
	// TargetGoal 抢占目标1-点击抢占市场份额，0-默认值，无实际意义
	TargetGoal int `json:"target_goal,omitempty"`
	// WordTagName 词包名称
	WordTagName string `json:"word_tag_name,omitempty"`
	// ProportionGoal 占比目标
	ProportionGoal float64 `json:"proportion_goal,omitempty"`
	// BusinessTreeName 推广业务信息示例：生活服务>婚纱摄影;美妆个护;母婴>母婴食品>奶粉
	BusinessTreeName string `json:"business_tree_name,omitempty"`
	// UnitLandingPageSpec 落地页表单描述
	UnitLandingPageSpec []string `json:"unit_landing_page_spec,omitempty"`
	// KeywordTargetPeriod 关键词定向行为周期，单位天，枚举包括 3，7，15，30
	KeywordTargetPeriod int `json:"keyword_target_period,omitempty"`
	// KeywordTargetAction 关键词定向行为1:搜索,2:互动,3:阅读
	KeywordTargetAction []enum.KeywordTargetAction `json:"keyword_target_action,omitempty"`
	// SubstitutedUserID 代投账号b的userId
	SubstitutedUserID string `json:"substituted_user_id,omitempty"`
	// CreateTime 单元创建时间
	CreateTime string `json:"create_time,omitempty"`
	// UpdateTime 单元修改时间
	UpdateTime string `json:"update_time,omitempty"`
	// ItemNoteInfo 单元标的信息
	ItemNoteInfo []ItemNoteConfig `json:"item_note_info,omitempty"`
	// SpuNoteInfo spu&笔记标的信息
	SpuNoteInfo []SpuNoteConfig `json:"spu_note_info,omitempty"`
	// TargetConfig 定向信息
	TargetConfig *TargetConfig `json:"target_config,omitempty"`
	// KeywordGenType 单元选词方式： -1:无意义默认值 0:手动选词 1:智能拓词 2:手动+智能
	KeywordGenType enum.KeywordGenType `json:"keyword_gen_type,omitempty"`
	// KeywordWithBid 选词出价
	KeywordWithBid []KeywordWithBid `json:"keyword_with_bid,omitempty"`
}

Unit 广告单元

type UpdateRequest added in v1.0.8 

type UpdateRequest struct {
	// AdvertiserID 广告主ID
	AdvertiserID uint64 `json:"advertiser_id,omitempty"`
	// UnitID 单元ID
	UnitID uint64 `json:"unit_id,omitempty"`
	// UnitName 单元名称
	UnitName string `json:"unit_name,omitempty"`
	// EventBid 出价/目标成本，单位分，自动控制不需要传
	EventBid int64 `json:"event_bid,omitempty"`
	// NoteIDs 标的-笔记id(帮助定向推荐，创意里的笔记会单独填写)非种草人群规模、深度种草人群规模下必填
	NoteIDs []string `json:"note_ids,omitempty"`
	// TargetType 定向类型，1-通投,2-智能定向, 3-高级定向
	TargetType enum.UnitTargetType `json:"target_type,omitempty"`
	// TargetConfig 定向配置
	TargetConfig *TargetConfig `json:"target_config,omitempty"`
	// KeywordTargetPeriod 关键词时间周期，单位天，枚举包括 3，7，15，30
	KeywordTargetPeriod int `json:"keyword_target_period,omitempty"`
	// KeywordTargetAction 关键词目标行为
	// 1: 搜索，2: 互动，3: 阅读
	KeywordTargetAction []enum.KeywordTargetAction `json:"keyword_target_action,omitempty"`
	// BusinessTreeName 推广业务信息示例：生活服务>婚纱摄影;美妆个护;母婴>母婴食品>奶粉具体参看/api/open/jg/keyword/industry/taxonomy接口返回词。
	BusinessTreeName string `json:"business_tree_name,omitempty"`
	// SpuNoteInfo spu&笔记标的信息推广目标是种草人群规模、深度种草人群规模下必传。spu只能一个，至少绑定5篇笔记，最多50(api限制)只能选择合作笔记与我的笔记，笔记违规不能选，spu审核不通过也可以选，选择的笔记一定是绑定在该spu上。
	SpuNoteInfo []SpuNoteConfig `json:"spu_note_info,omitempty"`
	// KeywordWithBid 关键词，通过(关键词词包)/api/open/jg/keyword/word/bag/list (智能推词、行业推词、以词推词)/api/open/jg/keyword/common/recommend 接口获取搜索推广-标准投放下必传
	KeywordWithBid []KeywordWithBid `json:"keyword_with_bid,omitempty"`
	// SubstitutedUserID 代投账号b的userId，代投笔记与其他笔记互斥,，需要校验是否有代投账号权限
	SubstitutedUserID string `json:"substituted_user_id,omitempty"`
	// KeywordGenType 单元选词方式：
	// -1:无意义默认值 0:手动选词 1:智能拓词 2:手动+智能
	// 关键词定向且在白名单中才支持
	KeywordGenType *int `json:"keyword_gen_type,omitempty"`
	// PageID 落地页ID，聚光落地页下必填
	PageID string `json:"page_id,omitempty"`
	// LandingPageURL 落地页Url，自研落地页下必填
	LandingPageURL string `json:"landing_page_url,omitempty"`
	// UnitExternalPageURL 外链Url，标的是外链落地页时必填
	UnitExternalPageURL string `json:"unit_external_page_url,omitempty"`
	// UnitLandingPageDesc 落地页表单描述
	UnitLandingPageDesc string `json:"unit_landing_page_desc,omitempty"`
}

UpdateRequest 编辑单元

func (UpdateRequest) Encode added in v1.0.8 

func (r UpdateRequest) Encode() []byte

Encode implements PostRequest interface

type UpdateResponse added in v1.0.8 

type UpdateResponse struct {
	model.BaseResponse
	Data struct {
		// UnitID 单元ID
		UnitID uint64 `json:"unit_id,omitempty"`
	} `json:"data,omitempty"`
}

UpdateResponse 编辑单元 API Response

type UpdateStatusRequest added in v1.0.8 

type UpdateStatusRequest struct {
	// AdvertiserID 广告主ID
	AdvertiserID uint64 `json:"advertiser_id,omitempty"`
	// UnitIDs 单元id，最多20个
	UnitIDs []uint64 `json:"unit_ids,omitempty"`
	// Status 单元状态
	// 状态枚举1：开启2：暂停3：删除
	Status int `json:"status,omitempty"`
}

UpdateStatusRequest 修改单元状态 API Request

func (UpdateStatusRequest) Encode added in v1.0.8 

func (r UpdateStatusRequest) Encode() []byte

Encode implement PostRequest interface

type UpdateStatusResponse added in v1.0.8 

type UpdateStatusResponse struct {
	model.BaseResponse
	Data struct {
		// UnitIDs 单元id
		UnitIDs []uint64 `json:"unit_ids,omitempty"`
	} `json:"data,omitempty"`
}

UpdateStatusResponse 修改单元状态 API Response

Source Files

View all Source files

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL
go.dev uses cookies from Google to deliver and enhance the quality of its services and to analyze traffic. Learn more.