初始化项目

This commit is contained in:
2025-12-06 10:38:48 +08:00
parent c9fcfc761e
commit 88a2753211
20 changed files with 2552 additions and 74 deletions

163
model/entity/ad_source.go Normal file
View File

@@ -0,0 +1,163 @@
package entity
import (
"gitee.com/red-future---jilin-g/common/do"
)
const AdSourceCollection = "ad_source"
// AdSource 广告源实体
type AdSource struct {
do.MongoBaseDO `bson:",inline"` // 嵌入基础字段Id, Creator, CreatedAt, Updater, UpdatedAt, TenantId, IsDeleted
// 基本信息
Name string `bson:"name" json:"name"` // 广告源名称
Code string `bson:"code" json:"code"` // 广告源编码,唯一标识
Provider string `bson:"provider" json:"provider"` // 提供商google、facebook、baidu、tencent、self等
Type string `bson:"type" json:"type"` // 类型self(自营)、third_party(第三方)、exchange(广告交易平台)
Description string `bson:"description" json:"description"` // 描述
// 连接配置
Config *AdSourceConfig `bson:"config" json:"config"` // 广告源配置
// API配置
APIEndpoint string `bson:"apiEndpoint" json:"apiEndpoint"` // API端点
APIVersion string `bson:"apiVersion" json:"apiVersion"` // API版本
AuthType string `bson:"authType" json:"authType"` // 认证类型api_key、oauth、basic
AuthConfig map[string]interface{} `bson:"authConfig" json:"authConfig"` // 认证配置
Headers map[string]string `bson:"headers" json:"headers"` // 请求头配置
Timeout int `bson:"timeout" json:"timeout"` // 超时时间(毫秒)
RetryCount int `bson:"retryCount" json:"retryCount"` // 重试次数
// 广告源能力
Capabilities *AdSourceCapabilities `bson:"capabilities" json:"capabilities"` // 广告源能力
// 质量指标
QualityMetrics *AdSourceQualityMetrics `bson:"qualityMetrics" json:"qualityMetrics"` // 质量指标
// 财务设置
PaymentTerms *PaymentTerms `bson:"paymentTerms" json:"paymentTerms"` // 支付条款
// 状态信息
Status string `bson:"status" json:"status"` // 广告源状态active、inactive、maintenance
Health string `bson:"health" json:"health"` // 健康状态healthy、degraded、unhealthy
LastCheckAt int64 `bson:"lastCheckAt" json:"lastCheckAt"` // 最后检查时间
// 统计信息
TotalRequests int64 `bson:"totalRequests" json:"totalRequests"` // 总请求数
SuccessfulRequests int64 `bson:"successfulRequests" json:"successfulRequests"` // 成功请求数
FailedRequests int64 `bson:"failedRequests" json:"failedRequests"` // 失败请求数
AverageResponseTime float64 `bson:"averageResponseTime" json:"averageResponseTime"` // 平均响应时间(毫秒)
FillRate float64 `bson:"fillRate" json:"fillRate"` // 填充率
CTR float64 `bson:"ctr" json:"ctr"` // 点击率
CVR float64 `bson:"cvr" json:"cvr"` // 转化率
// 系统信息
Priority int `bson:"priority" json:"priority"` // 优先级,数值越高优先级越高
}
// AdSourceConfig 广告源配置
type AdSourceConfig struct {
// 基础配置
SupportedFormats []string `bson:"supportedFormats" json:"supportedFormats"` // 支持的广告格式
SupportedSizes []string `bson:"supportedSizes" json:"supportedSizes"` // 支持的尺寸
SupportedDevices []string `bson:"supportedDevices" json:"supportedDevices"` // 支持的设备类型
SupportedOS []string `bson:"supportedOS" json:"supportedOS"` // 支持的操作系统
SupportedCountries []string `bson:"supportedCountries" json:"supportedCountries"` // 支持的国家/地区
// 竞价配置
BiddingType string `bson:"biddingType" json:"biddingType"` // 竞价类型cpm、cpc、cpa、rtb
MinBidAmount int64 `bson:"minBidAmount" json:"minBidAmount"` // 最小出价(分)
MaxBidAmount int64 `bson:"maxBidAmount" json:"maxBidAmount"` // 最大出价(分)
BidIncrement int64 `bson:"bidIncrement" json:"bidIncrement"` // 出价增量(分)
DefaultBidAmount int64 `bson:"defaultBidAmount" json:"defaultBidAmount"` // 默认出价(分)
AutoOptimization bool `bson:"autoOptimization" json:"autoOptimization"` // 是否自动优化
// 定向配置
TargetingSupport *TargetingSupport `bson:"targetingSupport" json:"targetingSupport"` // 定向支持
// 其他配置
MaxAdsPerRequest int `bson:"maxAdsPerRequest" json:"maxAdsPerRequest"` // 单次请求最大广告数量
BrandSafety bool `bson:"brandSafety" json:"brandSafety"` // 品牌安全
Viewability bool `bson:"viewability" json:"viewability"` // 可见性支持
}
// TargetingSupport 定向支持
type TargetingSupport struct {
GeoTargeting bool `bson:"geoTargeting" json:"geoTargeting"` // 地理定向
DemographicTargeting bool `bson:"demographicTargeting" json:"demographicTargeting"` // 人口统计定向
BehavioralTargeting bool `bson:"behavioralTargeting" json:"behavioralTargeting"` // 行为定向
ContextualTargeting bool `bson:"contextualTargeting" json:"contextualTargeting"` // 上下文定向
DeviceTargeting bool `bson:"deviceTargeting" json:"deviceTargeting"` // 设备定向
TimeTargeting bool `bson:"timeTargeting" json:"timeTargeting"` // 时间定向
Retargeting bool `bson:"retargeting" json:"retargeting"` // 重定向
CookieTargeting bool `bson:"cookieTargeting" json:"cookieTargeting"` // Cookie定向
}
// AdSourceCapabilities 广告源能力
type AdSourceCapabilities struct {
// 广告格式
SupportedFormats []AdFormat `bson:"supportedFormats" json:"supportedFormats"` // 支持的广告格式
// 功能特性
RealTimeBidding bool `bson:"realTimeBidding" json:"realTimeBidding"` // 实时竞价
HeaderBidding bool `bson:"headerBidding" json:"headerBidding"` // 标题竞价
ProgrammaticDirect bool `bson:"programmaticDirect" json:"programmaticDirect"` // 程序化直购
PrivateMarketplace bool `bson:"privateMarketplace" json:"privateMarketplace"` // 私有交易市场
// 质量控制
FraudDetection bool `bson:"fraudDetection" json:"fraudDetection"` // 反欺诈检测
BrandSafety bool `bson:"brandSafety" json:"brandSafety"` // 品牌安全
Viewability bool `bson:"viewability" json:"viewability"` // 可见度验证
CreativeApproval bool `bson:"creativeApproval" json:"creativeApproval"` // 创意审核
// 数据能力
AudienceTargeting bool `bson:"audienceTargeting" json:"audienceTargeting"` // 受众定向
ContextualTargeting bool `bson:"contextualTargeting" json:"contextualTargeting"` // 上下文定向
CrossDeviceTargeting bool `bson:"crossDeviceTargeting" json:"crossDeviceTargeting"` // 跨设备定向
}
// AdFormat 广告格式
type AdFormat struct {
Type string `bson:"type" json:"type"` // 格式类型banner、video、native、interstitial等
Name string `bson:"name" json:"name"` // 格式名称
Width int `bson:"width" json:"width"` // 宽度
Height int `bson:"height" json:"height"` // 高度
MimeType string `bson:"mimeType" json:"mimeType"` // MIME类型
}
// AdSourceQualityMetrics 广告源质量指标
type AdSourceQualityMetrics struct {
// 性能指标
AverageResponseTime float64 `bson:"averageResponseTime" json:"averageResponseTime"` // 平均响应时间(毫秒)
SuccessRate float64 `bson:"successRate" json:"successRate"` // 成功率
ErrorRate float64 `bson:"errorRate" json:"errorRate"` // 错误率
Uptime float64 `bson:"uptime" json:"uptime"` // 可用性(百分比)
// 广告质量
CTR float64 `bson:"ctr" json:"ctr"` // 点击率
CVR float64 `bson:"cvr" json:"cvr"` // 转化率
FillRate float64 `bson:"fillRate" json:"fillRate"` // 填充率
ViewabilityRate float64 `bson:"viewabilityRate" json:"viewabilityRate"` // 可见率
BrandSafetyScore float64 `bson:"brandSafetyScore" json:"brandSafetyScore"` // 品牌安全评分
// 财务指标
eCPM int64 `bson:"ecpm" json:"ecpm"` // 有效千次展示成本(分)
eCPC int64 `bson:"ecpc" json:"ecpc"` // 有效点击成本(分)
RevenuePerRequest int64 `bson:"revenuePerRequest" json:"revenuePerRequest"` // 每请求收入(分)
// 时间指标
LastUpdated int64 `bson:"lastUpdated" json:"lastUpdated"` // 最后更新时间
MetricsUpdateWindow int `bson:"metricsUpdateWindow" json:"metricsUpdateWindow"` // 指标更新窗口(分钟)
}
// PaymentTerms 支付条款
type PaymentTerms struct {
BillingModel string `bson:"billingModel" json:"billingModel"` // 计费模式cpm、cpc、cpa、rev_share
PaymentTerms string `bson:"paymentTerms" json:"paymentTerms"` // 支付条款net_30、net_60、net_90
RevShareRate float64 `bson:"revShareRate" json:"revShareRate"` // 收入分成比例(0-1)
MinPayment int64 `bson:"minPayment" json:"minPayment"` // 最小支付金额(分)
Currency string `bson:"currency" json:"currency"` // 货币单位
TaxInclusive bool `bson:"taxInclusive" json:"taxInclusive"` // 是否含税
EarlyPaymentDiscount float64 `bson:"earlyPaymentDiscount" json:"earlyPaymentDiscount"` // 提前付款折扣
}