天下联程序化广告投放接口

syntax = "proto3";
package showtx.bidding;

message BidRequest {
  string sdk_version = 1;
  string id = 2;
  repeated Imp imps = 3;
  Site site = 4;
  App app = 5;
  Content content = 6;
  Device device = 7;
  User user = 8;
  bool is_test = 9;
  bool is_ping = 10;
  bool is_preview = 11;
  int32 adx_type = 12;
  bool https_required = 13;
  string extend_info = 14;
  int32 max_bid_time = 15;
  repeated string media_exp_ids = 17;

  message Imp {
    string imp_id = 1;
    string pid = 2;
    string publisher_id = 3;
    int32 resource_type = 4;
    repeated int32 creative_types = 5;
    int32 refresh_num = 6;
    int32 screen_num = 7;
    int32 position = 8;
    int32 width = 9;
    int32 height = 10;
    Video video = 11;
    int32 max_ad_num = 12;
    int32 min_cpm_price = 13;
    int32 min_cpc_price = 14;
    bool impression_repeatable = 15;
    repeated Template templates = 16;
    repeated Deal deals = 17;
    string campaign_date = 18;
    repeated int32 open_types = 19;
    repeated PricingType pricing_type = 20;
    repeated ProposedCreative proposed_creatives = 21;
    repeated ItemInfo item_infos = 22;
    ExcludedInfo excluded_info = 23;
    repeated int32 download_types = 24;
    int32 title_len = 25;
    string s_imp_id = 52;

    message Video {
      int32 videoad_start_delay = 1;
      int32 videoad_section_start_delay = 2;
      int32 min_ad_duration = 3;
      int32 max_ad_duration = 4;
    }
    message Template {
      uint64 id = 1;
      repeated string required_fields = 2;
      repeated string optional_fields = 3;
      repeated Attribute attributes = 4;
      message Attribute {
        string name = 1;
        string value = 2;
      }
    }
    message Deal {
      uint64 deal_id = 1;
      DealType deal_type = 2;
      repeated uint64 adv_ids = 3;
      int32 price = 4;
      bool impression_repeatable = 5;
      enum DealType {
        UNKNOWN = 0;
        PRIVATE_AUCTION = 1;
        PREFERRED_DEAL = 2;
        DIRECT_BUY = 3;
      }
    }
    message ProposedCreative {
      string crid = 1;
    }
    message ItemInfo {
      repeated string item_id = 1;
      string seller_id = 2;
    }
    message ExcludedInfo {
      repeated string publisher_filter_ids = 1;
      repeated string creative_ids = 2;
      repeated string excluded_click_through_urls = 3;
      repeated uint64 adv_ids = 4;
      repeated uint64 ad_category = 5;
      repeated uint64 streamer_ids = 6;
      repeated uint64 item_ids = 7;
    }
  }

  message Site {
    string name = 1;
    string page = 2;
    string ref = 3;
    repeated int32 category = 4;
  }
  message App {
    string media_id = 1;
    string name = 2;
    string package_name = 3;
    string version = 4;
    repeated int32 category = 5;
    string app_id = 6;
    int32 version_code = 7;
  }
  message Content {
    string title = 1;
    int32 duration = 2;
    repeated string keywords = 3;
    string query_term = 4;
    repeated string query_suggestion = 5;
    string program_id = 6;
    string video_id = 7;
    repeated string producer_id = 8;
    repeated int32 category = 9;
    string view_session_id = 10;
  }
  message Device {
    string ip = 1;
    string user_agent = 2;
    int32 device_type = 3;
    int32 os = 4;
    string osv = 5;
    string make = 6;
    string model = 7;
    int32 carrier = 8;
    int32 connection_type = 9;
    int32 screen_width = 10;
    int32 screen_height = 11;
    Geo geo = 12;
    repeated string installed_pkgs = 13;
    string media_device_id = 14;
    string idfa = 15;
    string oaid = 16;
    string android_id = 17;
    string uuid = 18;
    string mac = 19;
    string imei_md5 = 20;
    string idfa_md5 = 21;
    string oaid_md5 = 22;
    string mac_md5 = 23;
    repeated CAID caids = 24;
    string open_udid = 25;
    string cookie_id = 26;
    string imei = 27;
    string ver_code_of_ag = 28;
    string ver_code_of_hms = 29;
    string boot_mark = 30;
    string update_mark = 31;
    string device_birth_time = 32;
    string boot_time_sec = 33;
    string os_update_time_sec = 34;
    string rom_version = 35;
    int32 ppi = 36;
    bool wx_installed = 37;
    string paid = 38;
    string hwv = 39;
    int32 memory = 40;
    int32 disk = 41;
    string device_name = 42;
    string device_name_md5 = 43;
    string sys_memory = 44;
    string sys_disk_size = 45;
    message Geo {
      string lon = 1;
      string lat = 2;
      string country_code = 3;
      string province_code = 4;
      string city_code = 5;
      string district_code = 6;
    }
    message CAID {
      string ver = 1;
      string caid = 2;
    }
  }
  message User {
    int32 age = 1;
    int32 gender = 2;
    int32 marriage = 3;
    int32 school = 4;
    repeated uint64 category = 5;
    repeated uint64 dmp_ids = 6;
    repeated float embedding = 7;
    string user_id = 8;
  }
}

message BidResponse {
  int32 code = 1;
  string id = 2;
  repeated SeatBid seat_bids = 3;
  int32 cache_duration = 4;
  UserInfo user_info = 5;
  string extend_info = 6;

  message SeatBid {
    string imp_id = 1;
    repeated Bid bids = 2;
  }
  message Bid {
    CreativeData creative = 3;
    Monitor monitor = 4;
    PricingType pricing_type = 5;
    int32 max_cpm_price = 6;
    int32 max_cpc_price = 7;
    uint64 deal_id = 8;
    uint64 adv_id = 9;
    string campaign_date = 10;
    BidType bid_type = 11;
    string network_guid = 13;
    string extend_data = 14;
    string platform_name = 55;
    enum BidType {
      NORMAL = 0;
      DEFAULT = 1;
      MARKET = 2;
    }
  }
  message CreativeData {
    string id = 1;
    int32 type = 2;
    string title = 3;
    string description = 4;
    string action_text = 5;
    repeated ImageData images = 6;
    repeated VideoData videos = 7;
    string html_snippet = 8;
    AppInfo app = 9;
    Landing landing = 10;
    string adv_name = 11;
    string adv_logo = 12;
    int32 sub_type = 13;
    TemplateData template_data = 14;
    TemplateData sub_template_data = 15;

    message ImageData {
      int32 type = 1;
      int32 width = 2;
      int32 height = 3;
      string url = 4;
      string md5 = 5;
    }
    message VideoData {
      int32 type = 1;
      int32 width = 2;
      int32 height = 3;
      int32 duration = 4;
      string url = 5;
      string md5 = 6;
      ImageData cover_img = 7;
    }
    message TemplateData {
      uint64 template_id = 1;
      repeated Field fields = 2;
      message Field {
        string name = 1;
        string value = 2;
      }
    }
  }
  message Landing {
    string landing_url = 1;
    string deeplink_uri = 2;
    string universal_link = 3;
    string app_schema_ids = 4;
    int32 open_type = 5;
    repeated string click_area = 6;
    MiniApp mini_app = 7;
    message MiniApp {
      int32 host_app = 1;
      string app_id = 2;
      string path = 3;
      string query = 4;
      string program_id = 5;
    }
  }
  message Monitor {
    repeated string imp_tracking_url = 1;
    repeated string click_tracking_url = 2;
    repeated string dp_tracking_url = 3;
    repeated string dp_success_tracking_url = 4;
    repeated string dp_fail_tracking_url = 5;
    repeated string download_start_url = 6;
    repeated string download_complete_url = 7;
    repeated string install_start_url = 8;
    repeated string install_complete_url = 9;
    repeated string install_open_url = 10;
    repeated EventTrack event_tracks = 15;
    string win_notice_url = 16;
    string loss_notice_url = 17;
    message EventTrack {
      int32 type = 1;
      repeated string url = 2;
      int32 time = 3;
      int32 send_type = 4;
    }
  }
  message AppInfo {
    string app_name = 1;
    string package_name = 2;
    string download_url = 3;
    int32 download_type = 4;
    string app_store_id = 5;
    int32 size = 6;
    string ver = 7;
    string per_url = 8;
    string pri_url = 9;
    string intro_url = 10;
    string publisher = 11;
  }
  message UserInfo {
    string user_id = 1;
  }
}

enum PricingType {
  PRICING_CPM = 0;
  PRICING_CPC = 1;
}

{
  "id": "req-202608280001",
  "imps": [
    {
      "imp_id": "1",
      "pid": "slot_10001",
      "publisher_id": "media_10001",
      "resource_type": 2,
      "creative_types": [1, 2],
      "width": 640,
      "height": 320,
      "min_cpm_price": 100,
      "max_ad_num": 1,
      "open_types": [1, 2, 3],
      "pricing_type": [0]
    }
  ],
  "app": {
    "media_id": "media_10001",
    "name": "Demo App",
    "package_name": "com.demo.app",
    "version": "1.0.0"
  },
  "device": {
    "ip": "127.0.0.1",
    "user_agent": "Mozilla/5.0",
    "device_type": 0,
    "os": 3,
    "osv": "14",
    "make": "HUAWEI",
    "model": "demo",
    "oaid": "oaid-example",
    "connection_type": 1
  },
  "max_bid_time": 300
}

{
  "code": 0,
  "id": "req-202608280001",
  "seat_bids": [
    {
      "imp_id": "1",
      "bids": [
        {
          "pricing_type": 0,
          "max_cpm_price": 120,
          "creative": {
            "id": "cr_10001",
            "type": 2,
            "title": "广告标题",
            "description": "广告描述",
            "action_text": "立即查看",
            "images": [
              {
                "type": 0,
                "width": 640,
                "height": 320,
                "url": "https://example.com/image.jpg"
              }
            ],
            "landing": {
              "landing_url": "https://example.com/landing",
              "open_type": 1
            }
          },
          "monitor": {
            "imp_tracking_url": ["https://track.example.com/imp?price=__WIN_PRICE__"],
            "click_tracking_url": ["https://track.example.com/click"]
          }
        }
      ]
    }
  ]
}