新义 SSP API 接口 2.0 协议

syntax = "proto3";
option go_package = "./;xyssp";
package xyssp;

message BidRequest {
  // 请求 id, 每个请求唯一
  string id = 1;
  // 协议版本, 当前协议版本 2.0.0
  string version = 2;
  // Ad 数组，目前只支持传一个 Ad 对象
  repeated Ad ads = 3;
  // App 对象
  App app = 4;
  // Device 对象
  Device device = 5;
  // User 对象
  User user = 6;
  // 是否需要 https 链接, 默认不需要
  bool need_https = 7;
  message Ad {
    // 广告位 token
    string ad_unit_token = 1;
    // 广告位宽度
    int64 width = 2;
    // 广告位高度
    int64 height = 3;
    // 底价, 单位为分
    double floor_price = 4;
    // 是否支持将 html 广告放在 webview 里面展示, 默认不支持
    bool support_js = 5;
  }
  message App {
    // 应用名
    string name = 1;
    // 应用包名
    string bundle = 2;
    // 应用版本
    string version = 3;
    // -1: 不支持 deeplink
    // 0: 在浏览器打开的目标页面中触发 deeplink (默认)
    // 1: 表示可在广告页面触发 deeplink, 失败则打开 target_url
    int64 deeplink_mode = 4;
  }
  enum DeviceType {
    UNKNOWN = 0; //未知
    PHONE = 1;   //手机
    PAD = 2;     //平板
    TV = 3;      //电视
    PC = 4;      //电脑
  }
  message Device {
    // IP 地址
    string ip = 1;
    // IPv6 地址
    string ipv6 = 2;
    // WebView User-Agent
    string user_agent = 3;
    // 生产厂商，例如:"Samsung"
    string make = 4;
    // 手机品牌，例如:"MI4"
    string brand = 5;
    // 手机型号
    string model = 6;
    // 操作系统，取值范围: "android", "ios"
    string os = 7;
    // 操作系统版本
    string os_version = 8;
    // 网络连接类型，取值范围: "wifi", "2g", "3g", "4g", "5g"
    string connection_type = 9;
    // 屏幕方向，取值范围: "landscape", "portrait"
    string orientation = 10;
    // 移动网络运营商，取值范围: "46000", "46002", "46001", "46003"
    // 46000: 中国移动
    // 46002: 中国移动
    // 46001: 中国联通
    // 46003: 中国电信
    string plmn = 11;
    // Mac 地址
    string mac = 12;
    // Mac 地址的 md5 值
    string mac_md5 = 13;
    // 系统语言
    string language = 14;
    // 屏幕宽度, 单位: 像素
    int64 screen_width = 15;
    // 屏幕高度, 单位: 像素
    int64 screen_height = 16;
    // 屏幕像素密度
    int64 screen_dpi = 17;
    // 屏幕物理像素密度
    double screen_pxratio = 18;
    // 地理位置经度
    double geo_longitude = 19;
    // 地理位置纬度
    double geo_latitude = 20;
    // 用户设备安装包名列表, 用逗号分隔
    string installed_apps = 21;
    // 用户设备类型
    DeviceType device_type = 22;
    // 无线网 SSID
    string ssid = 23;
    // WIFI 路由器 Mac 地址
    string wifi_mac = 24;
    // 设备 IMEI，不传会影响填充，CDMA 手机请传 MEID 码
    string imei = 25;
    // 设备 IMEI 的 MD5 值，IMEI 获取不到时请传这个字段
    string imei_md5 = 26;
    // Android ID
    string android_id = 27;
    // Android ID 的 md5 值
    string android_id_md5 = 28;
    // 设备 IMSI
    string imsi = 29;
    // Android 广告 ID
    string android_advertising_id = 30;
    // 匿名设备标识符 OAID
    // 对于 Android 设备，当 oaid 不填时，imei(或 imei_md5) 和 android_id(或
    // android_id_md5) 必填
    string oaid = 31;
    // OAID 的 md5 值
    string oaid_md5 = 32;
    // 手机 ROM 的版本号（例如 MIUI 11.0.6, EMUI 10.1 等)
    string rom_version = 33;
    // 系统编译时间（时间戳）
    int64 sys_compiling_time = 34;
    // IDFA, 不传会影响填充
    string idfa = 35;
    // IDFA 的 md5 值，IDFA 获取不到时请传这个字段
    string idfa_md5 = 36;
    // IDFV
    string idfv = 37;
    // 中广协推出的 iOS 设备 ID，支持同时传两个版本
    string caid = 38;
    // CAID 的 md5 值
    string caid_md5 = 39;
    // CAID 的版本号
    string caid_version = 40;
    string caid2 = 41;
    string caid2_md5 = 42;
    string caid2_version = 43;
    string openudid = 44;
    string boot_mark = 45;
    string update_mark = 46;
    // 拼多多设备指纹
    string paid = 47;
    // 设备启动时间
    string device_startup_time = 48;
    // 系统更新时间
    string system_update_time = 49;
    // 系统初始化时间
    string system_init_time = 50;
  }
  message User {
    // 年龄
    int64 age = 1;
    // 性别，取值范围："男", "女", "未知"
    string gender = 2;
    // 用户感兴趣关键字
    repeated string keywords = 3;
  }
}

message BidResponse {
  // 回填 Request 中的 id
  string id = 1;
  // Ad 对象数组，目前只支持返回一个 Ad 对象
  repeated Ad ads = 2;
  message Ad {
    // 广告宽度
    int64 width = 1;
    // 广告高度
    int64 height = 2;
    // 广告 ID
    string ad_id = 3;
    // 素材 ID
    string creative_id = 4;
    // 广告价格, 单位 分
    double price = 5;

    // 标题
    string title = 6;
    // 副标题
    string subtitle = 7;
    // 描述
    string description = 8;
    // 广告主名称
    string advertiser_name = 9;
    // 按钮文字
    string button_text = 10;
    // 图片数组
    repeated Image images = 11;
    // 图标
    Image icon = 12;
    // Logo
    Image logo = 13;
    // 视频
    Video video = 14;
    // 视频封面图
    Image video_cover = 15;
    // html 代码片段, 在 webview 中加载
    string html_snippet = 16;
    // html 代码地址, 在 webview 中加载
    string html_url = 17;

    // 广告动作类型
    // 1: 在应用内用 webview 打开 target_url
    // 2: 在系统浏览器打开 target_url
    // 6: 下载应用
    // 7: 打开 deeplink_url
    // 8: 打开小程序
    int64 action = 18;
    // 目标地址, 里面的宏需要替换
    string target_url = 19;
    // 下载应用包名
    string download_app_bundle = 20;
    // 下载应用名称
    string download_app_name = 21;
    // 下载应用版本
    string download_app_version = 22;
    // 下载应用大小, 单位 Bytes
    int64 download_app_size = 23;
    // 下载应用描述
    string download_app_desc = 24;
    // 下载应用隐私协议地址
    string privacy_url = 25;
    // 下载应用权限列表地址
    string permission_url = 26;
    // 小程序原始id
    string mini_program_id = 27;
    // 小程序页面路径
    string mini_program_path = 28;
    // Deeplink 或 Universal Link，里面的宏需要替换
    string deeplink_url = 29;

    // 竞价获胜上报地址
    string win_notice_tracker = 30;
    // 曝光上报地址, 里面的宏需要替换
    repeated string impression_trackers = 31;
    // 点击上报地址, 里面的宏需要替换
    repeated string click_trackers = 32;
    // 应用下载开始上报地址, 里面的宏需要替换
    repeated string download_begin_trackers = 33;
    // 应用下载完成上报地址, 里面的宏需要替换
    repeated string download_ended_trackers = 34;
    // 应用下载完成上报地址, 里面的宏需要替换
    repeated string install_ended_trackers = 35;
    // 视频播放开始上报地址, 里面的宏需要替换
    repeated string video_play_begin_trackers = 36;
    // 视频播放中止上报地址, 里面的宏需要替换
    repeated string video_play_break_trackers = 37;
    // 视频播放结束上报地址, 里面的宏需要替换
    repeated string video_play_ended_trackers = 38;
    // deeplink 唤醒时，发现应用没有安装的上报地址
    repeated string deeplink_app_not_installed_trackers = 39;
    // deeplink 唤醒时，发现应用有安装的上报地址
    repeated string deeplink_app_installed_trackers = 40;
    // deeplink 唤醒时，应用有安装, 但唤起失败的上报地址
    repeated string deeplink_app_invoke_failed_trackers = 41;
    // deeplink 唤醒时，应用唤起成功的上报地址
    repeated string deeplink_app_invoke_success_trackers = 42;
    // 汇川预算 点击坐标打点（具体细节，参考文档）
    string click_area_report_url = 43;
  }
  message Image {
    // 图片地址
    string url = 1;
    // 图片宽度
    int64 width = 2;
    // 图片高度
    int64 height = 3;
  }
  message Video {
    // 视频地址
    string url = 1;
    // 视频时长, 单位 秒
    int64 duration = 2;
  }
}