騰訊AMS-ADX協議—-RTB前貼片PDBPD適用
專題首頁> 教程> 騰訊廣告實時交易平臺 >騰訊AMS-ADX協議—-RTB前貼片PDBPD適用
// Copyright (c) 2018 Tencent Inc.

syntax = "proto2";

package gdt.rtb_contract;

option java_outer_classname = "RtbContractProtos";

message Request {
  message Impression {
    optional string id = 1;                     // 曝光機會的唯一ID,需要在回復時回帶給adx
    optional string tagid = 2;                  // 廣告位ID
    optional float bidfloor = 3;                // 曝光底價,單位:千次曝光分 (僅rtb)
    optional string tradecode = 7;              // 該廣告位的限制行業編碼列表 (僅rtb)
    optional string dealid = 9;                 // 主選訂單id,通過本id查詢本次曝光機會對應的排期/客戶/廣告位/播放形式/價格等全部信息

    repeated string dealids = 16;               // 本次曝光機會的備選訂單id,在主選訂單回退的情況下,要求必須按次序依次處理備選訂單列表,直至選擇其中一個或全部處理完成后回退(信息流專用)
    repeated int32 creative_specs = 19 [packed=true];   // 支持的素材規格列表,取值見《AMS-RTB廣告位及流量簡介.xlsx 》(僅rtb)
    repeated uint32 display_ids = 20 [packed=true];     // 對應的播放形式ID,RTB時為所有支持的播放形式,PDB/PD時為主備選訂單對應的播放形式
  }

  message Device {
    optional string ip = 1;                     // 用戶設備ip
    optional string ua = 2;                     // user-agent
    optional string idfa = 4;                   // IDFA, 加密情況見idfa_enc,默認不加密,僅ios設備填寫本字段
    optional uint32 idfa_enc = 5;               // 表示idfa是否加密: 0: 明文,1 :MD5(idfa)轉大寫, 2:SHA1
    optional string openudid = 6;               // Openudid, 默認不加密,用戶設備如果為ios或android,本字段會填寫原始openudid,否則為空
    optional uint32 carrier = 7;                // 運營商標識,生成規則是MCC+MNC,見 https://en.wikipedia.org/wiki/Mobile_country_code#China_-_CN
    optional string os = 10;                    // 設備操作系統,如"iPhone.OS.9.3.2" "Android 5.0.2"
    optional uint32 connection_type = 13;       // 連接類型,0:未知; 1:以太網; 2:Wifi; 3:移動數據-未知; 4:2G; 5:3G; 6:4G
    optional string mac = 15;                   // 加密后的mac, MD5(MAC)轉大寫, 加密前先進行格式轉換(去除分隔符‘:’->轉大寫),僅android設備會填寫本字段,否則為空
    optional string imei = 16;                  // 加密后的imei, MD5(imei)轉大寫, 對原始值加密,僅android設備會填寫本字段,否則為空
    optional string androidid = 17;             // 加密后的androidid, MD5(androidid)轉大寫, 對原始值加密,僅android設備會填寫本字段,否則為空
  }
  message User {  
    optional string id = 1;                     // cookieMapping后騰訊側用戶標識, 不推薦使用(pc專用)
    optional string buyerid = 2;                // cookieMapping后dsp側的用戶標識(pc專用)
  }

  optional string id = 1;                       // 本次次請求的請求id,dsp需要在回復時在Response.id字段中填寫該字段,帶回給adx
  optional Device device = 4;                   // 設備信息,通過本結構可獲取用戶的設備id
  optional User user = 5;                       // 用戶信息
  repeated Impression impression = 6;           // 曝光機會,一次請求包含多個曝光機會,要求必須處理一次請求的所有曝光機會

}

message Response {
  message CreativeDetails {
    message MaterialInfo {
      optional string content = 1;              // 如果是format為txt,則content為utf-8編碼的字符串;其他format為文件url 
      optional string format = 2;               // 素材的格式,文件后綴名,全小寫如:jpg,swf,txt(表示文字鏈) 
    }
    message AppInfo {
      optional string deep_link = 1;            // 應用直達scheme
      optional string app_name = 2;             // app name for android
      optional string pkg_name = 3;             // app的包名
    }
    repeated MaterialInfo materials = 1;        // 創意中每個素材的具體信息 
    optional AppInfo app_info = 2;              // 應用直達和下載的信息 【高級功能】
    repeated string monitorurl = 3;             // 第三方曝光監測URL,最多3個
    repeated string click_monitor_urls = 4;     // 第三方點擊監測URL,最多3個
    optional string click_url = 5;              // 點擊落地頁
  }

  message Bid {
    optional string id = 1;                     // dsp自己標識一次曝光機會的id(可不填)
    optional string impid = 2;                  // 必填,標識曝光ID(設置為對應Request.Impression.id)
    optional float price = 3;                   // dsp對本次曝光的出價,單位千次曝光分 (僅rtb)
    optional string adid = 4;                   // 外部DSP平臺的廣告創意ID,跟素材上傳api中的dsp_order_id相同
    optional string ext = 7;                    // 替換曝光監測和點擊落地頁和點擊檢測中的宏${EXT}。(必須base64編碼,單個宏不超過512字節,整個URL總長不超過768字節) (可不填)
    optional string ext2 = 10;                  // 替換曝光監測、點擊落地頁和點擊監測中的宏${EXT2}。(長度及編碼要求同ext) (可不填)
    repeated string disp_exts = 11;             // 只替換曝光監測的宏, repeated字段最多3個,分別替換這三個宏${DISPLAY_EXT1}${DISPLAY_EXT2}${DISPLAY_EXT3},(長度及編碼要求同ext)(可不填)
    repeated string click_exts = 12;            // click monitor exts ${CLICK_EXT1/2/3} 最多3個 (長度及編碼要求同ext)(可不填)
    optional string ext3 = 13;                  // 替換曝光監測、點擊落地頁和點擊監測中的宏${EXT3} (長度及編碼要求同ext)(可不填)
    optional string dealid = 16;                // 指定選中的訂單id,如果為空,則默認為Request中的主選訂單(dealid)
    optional CreativeDetails creative_details = 99;   // 實時創意信息 【高級功能】
  }

  message SeatBid {
    repeated Bid bid = 1;                       // 與request中的impression對應,可以對多個impression回復參與競價,也可以對其中一部分回復參與競價
  }

  optional string id = 1;                       // dsp必須填寫Request.id字段中的內容,即使放棄本次曝光機會也必須回復本字段
  optional string bidid = 2;                    // dsp方自己標識本次請求的請求id(可不填)
  repeated SeatBid seatbid = 3;                 // 回復參與競價信息,目前只支持將回復結果設置在seatbid[0];
}


雷竞技电竞