package top.opendsp.proto

Get desktop application:
View/edit binary Protocol Buffers messages

• rpc bid (BidRequest, BidResponse)

  services.proto:13

  message BidRequest

  rtb.proto:18

  竞价请求对象

  • optional string id = 1

    竞价请求id, 由adx自动生成

  • repeated BidRequest.Imp imp = 2

  • optional BidRequest.Site site = 3

    站点对象, 网站流量使用

  • optional BidRequest.App app = 4

    移动应用，移动app流量使用

  • optional BidRequest.Device device = 5

    设备对象

  • optional BidRequest.User user = 6

    用户对象

  • optional bool test = 7

  • optional AuctionType at = 8

    竞价方式：1-一价；2-二价

  • map<string, string> ext = 9

    扩展字段

  message BidResponse

  rtb.proto:145

  • optional string id = 1

    竞价请求id, 和BidRequest的id保持一致

  • repeated BidResponse.SeatBid seatbid = 2

    针对单个广告位的竞价响应

  • optional string bidid = 3

    dsp生成的竞价响应id

• optional uint32 ad_group_id = 1

• optional uint32 campaign_id = 2

• optional DeliveryMode delivery_mode = 3

• optional PromotionType promotion_type = 4

• optional string landing_url = 5

• optional BiddingMethod bidding_method = 6

• optional string bundle = 7

• optional AdGroup.TimeTarget target_time = 12

  optional AgesTarget target_ages = 11; //年龄段定向

• optional AdGroup.RegionTarget target_region = 14

  optional GenderTarget target_gender = 13;

• optional AdGroup.GeoLocationTarget target_geo_location = 13

• optional AdGroup.OsTarget target_os = 15

  操作系统定向

• optional AdGroup.OsvTarget target_osv = 16

  操作系统版本定向

• optional AdGroup.AdxTarget target_adx = 20

• optional AdGroup.MediaTarget target_media = 17

  媒体定向

• optional AdGroup.DeviceTypeTarget target_deviceType = 18

  设备类型定向

• optional AdGroup.ConnectionTypeTarget target_connectionType = 19

• optional string deal_id = 28

• repeated string imp_trackers = 29

• repeated string clk_trackers = 30

• optional double bid_price = 31

• optional FreqCapping freq_capping = 33

• map<string, string> ext = 50

Used in: AdGroup

• optional string adx_id = 1

Used in: AdGroup

• optional ConnectionType connection_type = 1

Used in: AdGroup

• optional DeviceType device_type = 1

Used in: AdGroup

• optional string lat = 1

• optional string lon = 2

• optional uint32 radius = 3

Used in: AdGroup

• repeated string media_uuid = 1

Used in: AdGroup

• optional OsType os = 1

Used in: AdGroup

• optional string low_osv = 1

• optional string high_osv = 2

Used in: AdGroup

• repeated uint32 region_code = 1

Used in: AdGroup

• optional uint64 begin_time = 1

• optional uint64 end_time = 2

• optional uint64 time_slots = 3

  投放时间段

• optional uint32 advertiser_id = 1

• optional uint32 agency_id = 2

• optional uint32 industry_id = 3

  optional uint32 status = 4; optional double bid_weight = 5; //出价系数 optional double cost_weight = 6; //计费系数

Used in: BidRequest

• UNKNOWN_AUCTION = 0

• SECOND_PRICE = 1

• FIRST_PRICE = 2

Used in: BidRequest

• optional string id = 1

  appid, 由Ad-Exchange定义

• optional string bundle = 2

  应用包名，对安卓是应用包名，如：com.iqiyi，ios为appstore id

• repeated string cat = 3

  App分类列表

• optional string ver = 4

  App版本

• optional Content content = 6

  App内容相关

• optional string keywords = 7

  app关键字，多个关键字逗号分隔

Used in: App, Site

• optional string id = 1

• optional string title = 2

• optional string keywords = 3

设备对象

Used in: BidRequest

• optional string ua = 1

  设备ua

• optional Geo geo = 2

  地理位置对象

• optional string ip = 3

  设备ip

• optional string ipv6 = 4

  ipv6地址

• optional DeviceType devicetype = 5

  设备类型, 参考设备类型定义

• optional string make = 6

  设备制造商

• optional string model = 7

  设备型号, 如：iPhone

• optional string os = 8

  操作系统，如：ios/Android

• optional string osv = 9

  操作系统版本

• optional string carrier = 10

  运营商

• optional ConnectionType connectiontype = 11

  网络连接类型

• optional string ifa = 12

  明文设备码，如安卓的imei或ios的idfa

• optional string didmd5 = 13

  md5设备码

• optional string mac = 14

  mac地址明文

• optional string macmd5 = 15

  md5 mac地址

Used in: Device

• optional float lat = 1

  纬度

• optional float lon = 2

  经度

• optional string country = 3

  国家编码

• optional string region = 4

  地区编码

• optional string city = 5

  城市编码

• optional uint32 region_code = 6

  6位地域码

  6位地域码

Used in: BidRequest

• optional string id = 1

• oneof ad

  • Imp.Banner banner = 2

    Banner广告

  • Imp.Video video = 3

    视频广告

  • Imp.Native native = 4

    原生/信息流广告

• optional Imp.Pmp pmp = 6

  私有竞价相关定义

• optional string tagid = 7

  媒体广告位id，由Ad-Exchange定义

• optional float bidfloor = 8

  媒体广告位底价

• optional string bidfloorcur = 9

• optional bool is_native_ad = 12

  是否原生广告，原生广告dsp平台可以根据tagid来进行匹配

图片广告位请求定义

Used in: Imp

• optional uint32 w = 1

  banner广告位宽

• optional uint32 h = 2

  banner广告位高

• optional uint32 pos = 3

  广告位置

Used in: Imp

• optional string tagid = 1

  原生广告的交易平台广告位id

私有竞价定义

Used in: Imp

• repeated Pmp.Deal deals = 1

Used in: Pmp

• string id = 1

  私有化交易id

视频广告位请求定义

Used in: Imp

• optional uint32 minduration = 2

  视频最小时长

• optional uint32 maxduration = 3

  视频最大时长

• optional uint32 w = 4

  视频宽

• optional uint32 h = 5

  视频高

站点对象定义

Used in: BidRequest

• optional string id = 1

  站点id

• optional string name = 2

  站点名称

• optional string domain = 3

  站点域名

• repeated string cat = 4

  站点分类

• optional Content content = 8

  网站内容

• optional string keywords = 9

  网站关键字，多个关键字逗号分隔

Used in: BidRequest

• optional string id = 1

  Ad-Exchange用户标识

Used in: BidResponse

• repeated SeatBid.Bid bid = 1

  同一个广告位的多个出价

• optional string seat = 2

  广告位名称

Used in: SeatBid

• optional string id = 1

  dsp平台参与出价id

• optional string impid = 2

  曝光id, 关联竞价请求中Imp中id

• optional float price = 3

  广告出价, 单位是分

• optional string crid = 4

  dsp平台创意id

• optional string dealid = 5

  请求pmp dealid

• repeated string imptrackers = 6

  曝光跟踪地址

• repeated string clktrackers = 7

  点击跟踪地址

出价方式

Used in: AdGroup

• UNKNOWN_BIDDING = 0

• CPC = 1

• CPM = 2

• CPA = 3

• OCPM = 4

• OCPC = 5

• optional uint32 campaign_id = 1

• optional uint32 advertiser_id = 2

• optional uint64 budget = 6

  optional uint32 status = 3; repeated string clk_trackers = 4; repeated string imp_trackers = 5;

• UNKNOWN_CARRIER = 0

• MOBILE = 1

  移动

• UNICOM = 2

  联通

• TELECOM = 3

  电信

Used in: AdGroup.ConnectionTypeTarget, BidRequest.Device

• UNKNOWN_CONNECTION_TYPE = 0

• ETHERNET = 1

• WIFI = 2

• CELL_2G = 3

• CELL_3G = 4

• CELL_4G = 5

• CELL_5G = 6

• optional uint32 creative_id = 1

• optional uint32 ad_group_id = 2

• optional CreativeType creative_type = 4

  创意类型

• optional string creative_url = 5

广告创意类型：图片/视频/音频/原生

Used in: Creative

• UNKNOWN_CREATIVE_TYPE = 0

• BANNER = 1

• VIDEO = 2

• AUDIO = 3

• NATIVE = 4

• REWARD_VIDEO = 5

投放方式：匀速/加速

Used in: AdGroup

• UNKNOWN_DELIVERY = 0

• SMOOTH_DELIVERY = 1

• SPEED_DELIVERY = 2

Used in: AdGroup.DeviceTypeTarget, BidRequest.Device

• UNKNOWN_DEVICE_TYPE = 0

• PHONE = 1

• TABLET = 2

• CONNECTED_TV = 3

• PC = 4

频次控制模型定义

Used in: AdGroup

• optional uint32 frequency = 1

  频次

• optional TimeWindow time_window = 2

  时间窗口

opendsp枚举定义

Used in: AdGroup.OsTarget

• UNKNOWN_OS = 0

• IOS = 1

• ANDROID = 2

• HARMONYOS = 3

推广类型

Used in: AdGroup

• UNKNOWN_PROMOTION = 0

• WEBSITE = 1

• ANDROID_APP = 2

• IOS_APP = 3

Used in: FreqCapping

• UNKNOWN_TIME_WINDOW = 0

• DAY = 1

• WEEK = 2

• MONTH = 3