金袋程序化广告投放接口

 syntax = "proto3";

package jindaiadx;

option csharp_namespace = "JindaiAdx.API";
option java_package = "com.jindai.protobuf.adx.api";
option java_outer_classname = "JindaiAdxApiProto";

syntax = "proto3";

package platform;

option csharp_namespace = "YourNamespace";

message PBAdRequest {
  string request_id = 1;
  string token = 2;
  int32 app_id = 3;
  int32 slot_id = 4;
  int64 time = 5;
  string sign = 6;
  int32 bidfloor = 7;
  string package_name = 8;
  string app_name = 9;
  string app_ver = 10;
  string keyword = 11;
  int32 width = 12;
  int32 height = 13;
  string ip = 14;
  string ipv6 = 15;
  int32 network = 16;
  int32 operator = 17;
  string wifi_ssid = 18;
  string wifi_bssid = 19;
  string user_agent = 20;
  int32 device_type = 21;
  int32 os = 22;
  string os_ver = 23;
  string imei = 24;
  string imeimd5 = 25;
  string android_id = 26;
  string android_idmd5 = 27;
  string mac = 28;
  string macmd5 = 29;
  string idfv = 30;
  string idfvmd5 = 31;
  string idfa = 32;
  string idfamd5 = 33;
  string udid = 34;
  string duid = 35;
  string brand = 36;
  string model = 37;
  double density = 38;
  int32 screen_width = 39;
  int32 screen_height = 40;
  int32 screen_orientation = 41;
  string language = 42;
  int32 gps_type = 43;
  double longitude = 44;
  double latitude = 45;
  int32 sdk_version = 46;
  repeated string packages = 47;
  string imsi = 48;
  string serialno = 49;
  string oaid = 50;
  string oaidmd5 = 51;
  string acid = 52;
  string boot_mark = 53;
  string update_mark = 54;
  string hms_ver = 55;
  string appstore_version = 56;
  string deviceName = 57;
  int32 deviceStartTime = 58;
  string deviceNameMd5 = 59;
  string timeZone = 60;
  int32 ppi = 61;
  string caid = 62;
  string caidmd5 = 63;
  string mac_md5 = 64;
  string bootTime = 65;
  string deviceModel = 66;
  string deviceMachine = 67;
  string paid = 68;
  string caidver = 69;
  int32 cpu_num = 70;
  string inittime = 71;
  int64 deviceMemory = 72;
  int64 deviceHardDisk = 73;
  int64 sysComplingTime = 74;
  int64 sysUpdateTime = 75;
  int32 dpi = 76;
  string boot_time_nanosec = 77;
  string update_time_nanosec = 78;
  string aaid = 79;
  string hms_ag = 80;
  string hms_gaid = 81;
  string adx_id = 83;
  string reqip = 84;
  repeated caid_list caid_list = 85;
}

message caid_list {
  string ca_id = 1;
  string caid_ver = 2;
}


message PBAdResponse {
  bool status = 1;
  string msg = 2;
  repeated Ad ads = 3;
  int32 code = 4;
  int32 nbr = 5;
  int64 cold_end_time = 6;
}

message Ad {
  int64 ad_id = 1;
  int32 type = 2;
  int32 price = 3;
  string creative_id = 4;
  string html = 5;
  int32 width = 6;
  int32 height = 7;
  string title = 8;
  string desc = 9;
  repeated string native_imgs = 10;
  string icon = 11;
  string brand_name = 12;
  int32 close_control = 13;
  int32 min_showtime = 14;
  int32 click_action = 15;
  string link = 16;
  string deeplink = 17;
  string ULink = 99
  ExtendTracking tracking = 18;
  string adx_id = 19;
  Videos videos = 20;
  string app_name = 21;
  string app_ver = 22;
  string package_name = 23;
  string app_icon = 24;
  uint32 app_size = 25;
  string app_developer_name = 26;
  string app_privacy_url = 27;
  string app_permission = 28;
  string app_function_introduction = 29;
  string quickapplink = 30;
  string creativeUniqueId = 31;
}

message ExtendTracking {
  repeated string exposure_tracking = 1;
  repeated string click_tracking = 2;
  repeated string deeplink_evoke = 3;
  repeated string download_start = 4;
  repeated string download_complete = 5;
  repeated string installation_start = 6;
  repeated string installation_complete = 7;
  repeated string activation = 8;
  repeated string deeplink_start = 9;
  repeated string loseNoticeUrls = 10;
  repeated string win_notice_urls = 11;
  repeated string click_area_report_url = 12;
}

message Videos {
  string video_url = 1;
  int32 video_duration = 2;
  bool prefetch = 3;
  repeated string video_loaded_trackers = 4;
  repeated string start_play_trackers = 5;
  repeated string video_play_25 = 6;
  repeated string video_play_50 = 7;
  repeated string video_play_75 = 8;
  repeated string end_play_trackers = 9;
  repeated string video_close = 10;
  repeated string video_skip = 11;
  repeated Playpercentage playpercentages = 12;
  string html = 13;
  repeated string html_exposure_tracking = 14;
  repeated string html_clos_tracking = 15;
  repeated string callback_trackers = 16;
  repeated string error = 17;
  Playtrackers play_trackers = 18;
  string cover_url = 19;
  repeated string play_1_trackers = 20;
  repeated string play_2_trackers = 21;
  repeated string play_3_trackers = 22;
  ExtendAds Ext = 23;
}

message ExtendAds {
  int32 t = 1;
  string ua = 2;
  int32 clk_t = 3;
  int32 render_t = 4;
  int32 render_ac = 5;
  int32 render_as = 6;
  int32 ot = 7;
  string headers = 8;
  string curl = 9;
  string img = 10;
}




// 播放进度追踪
message Playpercentage {
  int32 checkpoint = 1;
  repeated string urls = 2;
}

// 播放跟踪器
message Playtrackers {
  repeated string mute = 1;
  repeated string unmute = 2;
  repeated string play = 3;
  repeated string pause = 4;
  repeated string replay = 5;
  repeated string fullscreen = 6;
  repeated string unfullscreen = 7;
  repeated string upscroll = 8;
  repeated string downscroll = 9;
}

// 广点通下载响应
message GuangdiantongDownloadResponse {
  ResponseData data = 1;
  int32 ret = 2;
  
  message ResponseData {
    string clickid = 1;
    string dstlink = 2;
  }
}


// 网络类型枚举
enum NetworkType {
  NETWORK_UNKNOWN = 0;
  NETWORK_WIFI = 1;
  NETWORK_2G = 2;
  NETWORK_3G = 3;
  NETWORK_4G = 4;
  NETWORK_5G = 5;
}

// 设备类型枚举
enum DeviceType {
  DEVICE_UNKNOWN = 0;
  DEVICE_PHONE = 1;
  DEVICE_PAD = 2;
  DEVICE_PC = 3;
  DEVICE_WAP = 4;
}

// 操作系统枚举
enum OSType {
  OS_ANDROID = 1;
  OS_IOS = 2;
  OS_WAP = 3;
  OS_WINDOWS = 4;
  OS_HARMONY = 5;
}

// 屏幕方向枚举
enum ScreenOrientation {
  ORIENTATION_UNKNOWN = 0;
  ORIENTATION_PORTRAIT = 1;
  ORIENTATION_LANDSCAPE = 2;
}

// GPS类型枚举
enum GPSType {
  GPS_GAODE = 0;
  GPS_BAIDU = 1;
  GPS_TENCENT = 2;
  GPS_GOOGLE = 3;
  GPS_OTHER = 4;
}

// 运营商枚举
enum OperatorType {
  OPERATOR_UNKNOWN = 0;
  OPERATOR_CMCC = 46000;
  OPERATOR_CUCC = 46001;
  OPERATOR_CTCC = 46003;
}

 {
	"token": null,
	"slot_id": 0,
	"time": 0,
	"sign": null,
	"bidfloor": 0,
	"app_ver": null,
	"keyword": null,
	"width": 0,
	"height": 0,
	"ip": null,
	"network": 0,
	"operator": 0,
	"wifi_ssid": null,
	"wifi_bssid": null,
	"user_agent": null,
	"device_type": 0,
	"os": 0,
	"os_ver": null,
	"imei": null,
	"imeimd5": null,
	"android_id": null,
	"android_idmd5": null,
	"mac": null,
	"macmd5": null,
	"idfv": null,
	"idfvmd5": null,
	"idfa": null,
	"idfamd5": null,
	"udid": null,
	"duid": null,
	"brand": null,
	"model": null,
	"density": 0.0,
	"screen_width": 0,
	"screen_height": 0,
	"screen_orientation": 0,
	"language": null,
	"gps_type": 0,
	"longitude": 0.0,
	"latitude": 0.0,
	"sdk_version": 0,
	"packages": null,
	"imsi": null,
	"serialno": null,
	"oaid": null,
	"acid": null,
	"boot_mark": null,
	"update_mark": null,
	"hms_ver": null,
	"appstore_version": null,
	"deviceName": null,
	"deviceStartTime": 0,
	"deviceNameMd5": null,
	"deviceMemory": 0,
	"deviceHardDisk": 0,
	"timeZone": null,
	"sysUpdateTime": 0,
	"ppi": 0,
	"caid": null,
	"mac_md5": null,
	"bootTime": null,
	"deviceModel": null,
	"deviceMachine": null,
	"paid": null,
	"caidver": null,
	"cpu_num": null,
	"sysComplingTime": 0,
	"inittime": null,
	"dpi": 0
}

{
    "status": true,
    "msg": null,
    "ads": [
        {
            "ad_id": 223959669734772736,
            "type": 0,
            "price": 0,
            "tp_price": 0,
            "creative_id": null,
            "html": null,
            "width": 0,
            "height": 0,
            "title": "上淘宝",
            "desc": "逛淘宝",
            "native_imgs": [
                "https://jdossbucket.oss-cn-hangzhou.aliyuncs.com/Img/1.jpg",
                "https://jdossbucket.oss-cn-hangzhou.aliyuncs.com/Img/2.jpg",
                "https://jdossbucket.oss-cn-hangzhou.aliyuncs.com/Img/3.jpg"
            ],
            "icon": null,
            "close_control": 0,
            "min_showtime": 0,
            "click_action": 1,
            "link": "https://jdossbucket.oss-cn-hangzhou.aliyuncs.com/Img/1.jpg",
            "deeplink": "https://jdossbucket.oss-cn-hangzhou.aliyuncs.com/Img/1.jpg",
            "app_name": null,
            "package_name": null,
            "app_icon": null,
            "app_size": 0,
            "tracking": {
                "exposure_tracking": [
                    "http://ad.api.jindaixx.com/api/e?s=RLBQOCLKQyXxHLDr7WtPh7XFoL12Xu7aGFIOGlb3I96bHb%2FXytRmveaQ3tHQafuEbQKAhPqz91esHzVzOf5hfpyUZtXfWKyhHRSHy18VqYbLsTS0ddYu6n29xhxmhuE0xW9h%2BvDpG%2FzhNp0EZ94ljs7qO83QW9BnxAjSDq4jVjEv%2FkxoEwwTN2cl3sF2UTB6gSPmUdLmv2TBZ6q753vHBIHfjag6VOat2NcuTnBMOdrSQ4cj8e46zYuQA43mNkGIINwGMwESr5LbWa9c7mc7tzE4HmfwkPgmwz066%2FgkzCca8M246rl3oHUH4SbhJaNiLX6jD%2F6%2BGjqmZnOkYXbmpI4%2FWu1KVNfErc67G5PlxuvVf2ygtdk6j3s0tJt88CmZzAr6qJtWqGEb9%2F4XJzNC70%2BDbdYpNe9b0am%2FFXX56Gznp%2FX4XbpMz5pwuRCOHdpHFy7I77p%2Bw6LRdld6W%2FvELB6w9dnV045yZe1CDumesiU%3D"
                ],
                "click_tracking": [
                    "http://ad.api.jindaixx.com/api/e?s=RLBQOCLKQyXxHLDr7WtPh7MV72aW6zqCJuSeDzxAWRJee9Xl%2FHYcyIKIU93LLuOx1c4U6Ai4cPe%2BYpIUXfT%2FBjBekPExxmGdC7mTsn58jXISe0RV1iP6gyYPdKYgTr6poWNMLaIW5P8ibz9wnI37tAc2ctV6Jidyzcx%2FjI3PedmHWm%2BrHh7RMpWmKLj1gUOD602uoKud8PwW5V8MBFgFUdQb4snCAw6HL91ObzPpLhFB5kL%2FG%2FzWlR3EMXFPB02D%2FbelzXilYj3zahYLIa5Q3Dl75JT7lD127YyDs0N2aMP0KW38DlU0N1TEFOI4EOuY9P7qAwY%2BtCTAGF%2BFNgOQWnIXTnmSsEmsXSJ58%2F2d2UmcCIewb5qkpIG1fnT0%2F51JknUrAT2zhKDWSpLGdf1SwdPyBctM3Z1ThFc4f%2BUocq%2FfDlDp0vhCOa2XLI%2BcPZkwqZWYKSjQk%2BincPCKpf7IAeFKlqLHx5Q6EElyozYcaug%3D"
                ],
                "deeplink_evoke": [
                    "http://ad.api.jindaixx.com/api/e?s=RLBQOCLKQyXxHLDr7WtPhzNQdba68wyi9yFmEuZsJiYdO5b%2FHpqrNDqi6SQeb2yxP%2Bxmr8Z547Z7QQ21GXJ1Balzg6wIR8JNT0SST8D4qOiTvLBZWchuH4RQ6uTibKGFrJvNMI%2FSW4RUxIsSB6VpVKhRJ%2BuwU1xgqBXXjcckxjRPiW7Oo8D289L7IpT9xAi5HomAm3JwWmg5QsrxurZ90V0lpdk2ckpZ%2Bow2YNRZ2VGROA373dIiOP1%2F1RWmka2fH8n%2FxUmVg%2FYxSVcYC0rxAahIwwTxw2qQKviyPIZ88v3No0hsgOvaKauyIJEXWv1L9KjcKU8e30R6MGKRyg3YNwNjc9FTUSJOG8k%2FFCq2ToHSmORigFyHo%2Ftp%2F73wYcYDL4t1euB9fimR2yAZXG2h7ZgZqMAEXxZVTjSNwwlxkjBszyafiTimO0qxorENL9NlxRWQcf4mlKma1IQ5ghIHMgLsdwOKsFfTbeSG3bXDG%2Fc%3D"
                ],
                "download_start": null,
                "download_complete": null,
                "installation_start": null,
                "installation_complete": null,
                "activation": null,
                "deeplink_start": [
                    "http://ad.api.jindaixx.com/api/e?s=RLBQOCLKQyXxHLDr7WtPh5aeqDnGkvkkren%2B0lCBNUiOosErlKr3Jt%2FPF7dINoFy595PZ58NZesNZZcSLHczRT4bWSVs7pFFp%2ByVze2iFTU0n5wj1FCTJuW7PO4xwOd8uorLwVNojbcbRwDE%2Fn7c%2BjBjU9PR0TM2NJUX%2FRRzsm4FapN1q7QC%2BrFNhpoytNVv1t9on3IZzqlK6NBBfOaZJWyZC%2FSK7pSxKwEnD%2BaneJwuq%2BgvVgZcrRwdGbStd5i4QwAM5KKYo%2FyCDuMrYbzRTExrhvvgkgJ5DR7tkcJE74OfYar1ijhNP6dqne%2BZGtwjwHxHNZoWovuRbJiVhasKn21Rr4HOWlYBNdpa7UY930fA4c4R5RGMzZmUis3JA6o5sjeKvdhNiU3FpHYBWiXqwawDvRVbLEoy5W7brdRtZTNAPIMpcJnMU5XEg0TIqM1MqBnZgMrXo74w6eBRxnXjZyjmbO4yp%2BlcLrn%2F27VCU%2BY%3D"
                ]
            }
        }
    ],
    "code": 0
}

{
    "data":{
        "clickid":"xxxxxxxxxxxxx",
        "dstlink":"http://xxx.com/xxx/xxx.apk"
    },
    "ret":0
}

1. 点击坐标反馈：该接口用于汇川广告在媒体侧产生点击事件时，由媒体回传点击坐标
信息，用于反作弊。
2. 触发条件：如汇川广告在媒体侧产生点击事件，则构造 POST 请求，并使用规定 json
串为 body。
3. 业务流程：
	3.1. 汇川检索在 click_area_report_url 上追加 sid 和 creative_id，并下发给媒体。
	3.2. 汇川广告在媒体侧产生点击事件时，媒体构造 post 请求，body 为 json 串：
		3.2.1. 客户端将 click_area_report_url 中的 sid 和 creative_id 解析后追加到json 串 中的 “sid” 和 “creative_id”
		3.2.2. 追加相应的点击信息到”click_element”，如点击标题等 click_element:title
		3.2.3. json 串 kv 均为字符串形式。
4. 响应中 click_area_report_url 的示例
			
	[https://test.huichuan.sm.cn/redirect/click\_area?sid=12345&creative\_id=456](https://test.huichuan.sm.cn/redirect/click_area?sid=12345&creative_id=456)  
		{  
		“sId” : “必填 string 实际的点击方式 枚举值:  
			0-常规触屏点击，1-滑动点击，2-摇一摇，3-自定义手势，  4-点击或滑动，5-扭一扭，6-擦除触发点击，7-横竖屏转换，  
			仅 sId=0，1，3，4，6 时 需要媒体上报点击坐标”,  
		“width” : “必填 string 实际广告位的宽，单位为像素”,  
		“height” : “必填 string 实际广告位的高，单位为像素”,  
		“down_x” : “必填 string 用户手指按下时的横坐标”,  
		“down_y” : “必填 string 用户手指按下时的纵坐标”,  
		“up_x” : “必填 string 用户手指离开屏幕时的横坐标”,  
		“up_y” : “必填 string 用户手指离开屏幕时的纵坐标”,  
		“click_element” : “string 点击标题 title 信息”,  
		“sid” : “必填 string 媒体端上从 click\_area\_report\_url 中解析的 sid”,  
		“creative\_id” : “必填 string 媒体端上从 click\_area\_report\_url 中解析的 creative\_id”  
		}