{"__v":62,"_id":"564629170c30fb2100ba3833","category":{"__v":1,"_id":"56858d693703ed1700e420b2","pages":["5685a6b93703ed1700e420d4"],"project":"564621e00c30fb2100ba3814","version":"564621e10c30fb2100ba3817","sync":{"url":"","isSync":false},"reference":false,"createdAt":"2015-12-31T20:17:45.077Z","from_sync":false,"order":2,"slug":"dsp-resources","title":"DSP Resources"},"parentDoc":null,"project":"564621e00c30fb2100ba3814","user":"564621d275c83f0d00e9d52d","version":{"__v":14,"_id":"564621e10c30fb2100ba3817","project":"564621e00c30fb2100ba3814","createdAt":"2015-11-13T17:46:09.275Z","releaseDate":"2015-11-13T17:46:09.275Z","categories":["564621e10c30fb2100ba3818","564624cf0c30fb2100ba3822","564628d69f3f550d00fa3db6","564dafeeda00e82b00ed601d","564daff8fc36dc3700882b95","564db0ccda00e82b00ed601f","564dcf87d3320b0d0028ca10","5661a6e436398e0d00f79566","568585153703ed1700e420b0","56858767d96a760d00545da6","56858d693703ed1700e420b2","56858d8d22c41b0d00e4666c","56859e9c009a8d0d00797130","5685a6453703ed1700e420d3"],"is_deprecated":false,"is_hidden":false,"is_beta":false,"is_stable":true,"codename":"","version_clean":"1.0.0","version":"1.0"},"updates":[],"next":{"pages":[],"description":""},"createdAt":"2015-11-13T18:16:55.658Z","link_external":false,"link_url":"","githubsync":"","sync_unique":"","hidden":false,"api":{"results":{"codes":[]},"settings":"","auth":"required","params":[],"url":""},"isReference":false,"order":2,"body":"Welcome to our platform. We'd love to integrate with you. Please get in touch at <sales:::at:::mobfox.com>.\n\nThe MobFox SSP supports RTB 2.0, 2.1, 2.2 and 2.3. Please find bid request examples below.\n[block:api-header]\n{\n  \"type\": \"basic\",\n  \"title\": \"1. Get in Touch\"\n}\n[/block]\nGet in touch with us at <sales@mobfox.com>.\n\n**Integration questions:**\n* Which OpenRTB versions do you support?\n* What is your average response time (our data centers are in North Virginia and in Tokyo)?\n* Do you support ATS?\n* Are you sending [all parameters we require](doc:integrate-an-a-dsp#rtb-bid-response-attributes-explained)?\n\nWe will send you our contract to sign and then send it back for us to counter sign. This is important to get started.\n[block:api-header]\n{\n  \"type\": \"basic\",\n  \"title\": \"2. Credit Application\"\n}\n[/block]\nCredit Application needs to be in place before we go live.\n[block:api-header]\n{\n  \"type\": \"basic\",\n  \"title\": \"3. Create Account\"\n}\n[/block]\nCreate an account on our platform using the following link, http://www.mobfox.com/signup.\n\nSend us the account details (email) once registered. Alternatively you can send the email address to use, we can create an account for you.\n[block:api-header]\n{\n  \"type\": \"basic\",\n  \"title\": \"4. Test with our Bid Request Samples\"\n}\n[/block]\nMobFox SSP currently supports **RTB 2.0, 2.1, 2.2 and 2.3**. We recommend integrating on the most recent version. All ad types are supported on all supported RTB versions (banner, video, native).\n[block:code]\n{\n  \"codes\": [\n    {\n      \"code\": \"{\\n   \\\"ext\\\":{\\n      \\\"udi\\\":{\\n         \\\"idfa\\\":\\\"1976F519-26D0-4428-9891-3133253A453F\\\"\\n      }\\n   },\\n   \\\"cur\\\":[\\n      \\\"USD\\\"\\n   ],\\n   \\\"site\\\":{\\n      \\\"name\\\":\\\"MobFox Official TestID - Banners\\\",\\n      \\\"publisher\\\":{\\n         \\\"id\\\":\\\"14566\\\"\\n      },\\n      \\\"id\\\":\\\"21237\\\",\\n      \\\"page\\\":\\\"http://www.mobfox.com\\\",\\n      \\\"domain\\\":\\\"http://www.mobfox.com\\\",\\n      \\\"cat\\\":[\\n         \\\"IAB1\\\"\\n      ]\\n   },\\n   \\\"at\\\":2,\\n   \\\"tmax\\\":300,\\n   \\\"bcat\\\":[\\n      \\\"IAB26\\\",\\n      \\\"IAB25\\\",\\n      \\\"IAB24\\\"\\n   ],\\n   \\\"id\\\":\\\"B93F3DF68A816CECC8EF191921E9F27F\\\",\\n   \\\"imp\\\":[\\n      {\\n         \\\"ext\\\":{\\n            \\\"brandsafe\\\":0\\n         },\\n         \\\"displaymanager\\\":\\\"third_party_sdk\\\",\\n         \\\"displaymanagerver\\\":\\\"0\\\",\\n         \\\"bidfloor\\\":1.333333,\\n         \\\"banner\\\":{\\n            \\\"battr\\\":[\\n               8,\\n               10\\n            ],\\n            \\\"topframe\\\":0,\\n            \\\"pos\\\":0,\\n            \\\"w\\\":320,\\n            \\\"btype\\\":[\\n               4\\n            ],\\n            \\\"h\\\":50,\\n            \\\"wmax\\\":320,\\n            \\\"id\\\":\\\"1\\\",\\n            \\\"hmax\\\":50\\n         },\\n         \\\"bidfloorcur\\\":\\\"USD\\\",\\n         \\\"id\\\":\\\"1\\\",\\n         \\\"secure\\\":0,\\n         \\\"instl\\\":0\\n      }\\n   ],\\n   \\\"device\\\":{\\n      \\\"os\\\":\\\"iOS\\\",\\n      \\\"ifa\\\":\\\"1976F519-26D0-4428-9891-3133253A453F\\\",\\n      \\\"ip\\\":\\\"69.197.148.18\\\",\\n      \\\"js\\\":1,\\n      \\\"dnt\\\":0,\\n      \\\"ua\\\":\\\"Mozilla/5.0 (iPhone; CPU iPhone OS 8_0 like Mac OS X) AppleWebKit/600.1.3 (KHTML, like Gecko) Version/8.0 Mobile/12A4345d Safari/600.1.4\\\",\\n      \\\"devicetype\\\":1,\\n      \\\"geo\\\":{\\n         \\\"country\\\":\\\"USA\\\",\\n         \\\"lon\\\":12.12,\\n         \\\"type\\\":1,\\n         \\\"lat\\\":280.12\\n      },\\n      \\\"dpidmd5\\\":\\\"2D20AF98F011570F75A9606D41D9B300\\\",\\n      \\\"osv\\\":\\\"8.0\\\",\\n      \\\"model\\\":\\\"iPhone\\\",\\n      \\\"connectiontype\\\":2,\\n      \\\"make\\\":\\\"Apple\\\",\\n      \\\"dpidsha1\\\":\\\"7EBF6FABAB3B9CACC5BC087F8EAE55D84586705E\\\"\\n   },\\n   \\\"user\\\":{\\n      \\\"gender\\\":\\\"M\\\",\\n      \\\"yob\\\":1982,\\n      \\\"id\\\":\\\"b87f835ca3d57db03f21c4e11c077a93\\\"\\n   }\\n}\",\n      \"language\": \"json\",\n      \"name\": \"RTB 2.2 Banner iOS Site\"\n    },\n    {\n      \"code\": \"{\\n  \\\"ext\\\": {\\n    \\\"udi\\\": {\\n      \\\"idfa\\\": \\\"1976F519-26D0-4428-9891-3133253A453F\\\"\\n    }\\n  },\\n  \\\"cur\\\": [\\n    \\\"USD\\\"\\n  ],\\n\\t\\\"app\\\": {  \\n      \\\"storeurl\\\":\\\"https://itunes.apple.com/en/app/angry-birds/id343200656?mt=8\\\",\\n      \\\"domain\\\":\\\"rovio.com\\\",\\n      \\\"cat\\\":[  \\n         \\\"IAB1\\\"\\n      ],\\n      \\\"name\\\":\\\"Angry Birds\\\",\\n      \\\"publisher\\\":{  \\n         \\\"id\\\":\\\"37880\\\"\\n      },\\n      \\\"id\\\":\\\"77656\\\",\\n      \\\"bundle\\\":\\\"343200656\\\"\\n  },\\n  \\\"at\\\": 2,\\n  \\\"tmax\\\": 300,\\n  \\\"bcat\\\": [\\n    \\\"IAB26\\\",\\n    \\\"IAB25\\\",\\n    \\\"IAB24\\\"\\n  ],\\n  \\\"id\\\": \\\"9BD484B4590AA2E726B61C18C05B7704\\\",\\n  \\\"imp\\\": [\\n    {\\n      \\\"ext\\\": {\\n        \\\"brandsafe\\\": 0,\\n        \\\"strictbannersize\\\": 1\\n      },\\n      \\\"displaymanager\\\": \\\"third_party_sdk\\\",\\n      \\\"displaymanagerver\\\": \\\"0\\\",\\n      \\\"bidfloor\\\": 1,\\n      \\\"banner\\\": {\\n        \\\"battr\\\": [\\n          8,\\n          10\\n        ],\\n        \\\"topframe\\\": 0,\\n        \\\"pos\\\": 7,\\n        \\\"w\\\": 320,\\n        \\\"btype\\\": [\\n          4\\n        ],\\n        \\\"h\\\": 480,\\n        \\\"id\\\": \\\"1\\\"\\n      },\\n      \\\"bidfloorcur\\\": \\\"USD\\\",\\n      \\\"id\\\": \\\"1\\\",\\n      \\\"secure\\\": 0,\\n      \\\"instl\\\": 1\\n    }\\n  ],\\n  \\\"device\\\": {\\n    \\\"os\\\": \\\"iOS\\\",\\n    \\\"ifa\\\": \\\"1976F519-26D0-4428-9891-3133253A453F\\\",\\n    \\\"ip\\\": \\\"69.197.148.18\\\",\\n    \\\"js\\\": 1,\\n    \\\"dnt\\\": 0,\\n    \\\"ua\\\": \\\"Mozilla/5.0 (iPhone; CPU iPhone OS 8_0 like Mac OS X) AppleWebKit/600.1.3 (KHTML, like Gecko) Version/8.0 Mobile/12A4345d Safari/600.1.4\\\",\\n    \\\"devicetype\\\": 1,\\n    \\\"geo\\\": {\\n      \\\"country\\\": \\\"USA\\\",\\n      \\\"lon\\\": 12.12,\\n      \\\"type\\\": 1,\\n      \\\"lat\\\": 280.12\\n    },\\n    \\\"dpidmd5\\\": \\\"2D20AF98F011570F75A9606D41D9B300\\\",\\n    \\\"osv\\\": \\\"8.0\\\",\\n    \\\"model\\\": \\\"iPhone\\\",\\n    \\\"connectiontype\\\": 2,\\n    \\\"make\\\": \\\"Apple\\\",\\n    \\\"dpidsha1\\\": \\\"7EBF6FABAB3B9CACC5BC087F8EAE55D84586705E\\\"\\n  },\\n  \\\"user\\\": {\\n    \\\"gender\\\": \\\"M\\\",\\n    \\\"yob\\\": 1982,\\n    \\\"id\\\": \\\"b87f835ca3d57db03f21c4e11c077a93\\\"\\n  }\\n}\",\n      \"language\": \"json\",\n      \"name\": \"RTB 2.2 Banner Interstitial iOS App\"\n    },\n    {\n      \"code\": \"{\\n  \\\"ext\\\": {\\n    \\\"udi\\\": {\\n      \\\"gaid\\\": \\\"c6292267-56ad-4326-965d-deef6fcd5er9\\\"\\n    }\\n  },\\n  \\\"cur\\\": [\\n    \\\"USD\\\"\\n  ],\\n   \\\"app\\\": {  \\n      \\\"storeurl\\\":\\\"https://play.google.com/store/apps/details?id=com.rovio.angrybirds&hl=en\\\",\\n      \\\"domain\\\":\\\"rovio.com\\\",\\n      \\\"cat\\\":[  \\n         \\\"IAB1\\\"\\n      ],\\n      \\\"name\\\":\\\"Angry Birds\\\",\\n      \\\"publisher\\\":{  \\n         \\\"id\\\":\\\"328801\\\"\\n      },\\n      \\\"id\\\":\\\"12323\\\",\\n      \\\"bundle\\\":\\\"com.rovio.angrybirds\\\"\\n  },\\n  \\\"at\\\": 2,\\n  \\\"tmax\\\": 300,\\n  \\\"bcat\\\": [\\n    \\\"IAB26\\\",\\n    \\\"IAB25\\\",\\n    \\\"IAB24\\\"\\n  ],\\n  \\\"id\\\": \\\"790E3A41A2FE29611C2A5EB97B300324\\\",\\n  \\\"imp\\\": [\\n    {\\n      \\\"ext\\\": {\\n        \\\"brandsafe\\\": 0\\n      },\\n      \\\"displaymanager\\\": \\\"third_party_sdk\\\",\\n      \\\"displaymanagerver\\\": \\\"0\\\",\\n      \\\"bidfloor\\\": 1.333333,\\n      \\\"bidfloorcur\\\": \\\"USD\\\",\\n      \\\"id\\\": \\\"1\\\",\\n      \\\"video\\\": {\\n        \\\"boxingallowed\\\": 1,\\n        \\\"battr\\\": [\\n          8,\\n          10\\n        ],\\n        \\\"maxextended\\\": 0,\\n        \\\"linearity\\\": 1,\\n        \\\"minbitrate\\\": 250,\\n        \\\"h\\\": 480,\\n        \\\"playbackmethod\\\": [\\n          2\\n        ],\\n        \\\"minduration\\\": 5,\\n        \\\"mimes\\\": [\\n          \\\"video/mp4\\\"\\n        ],\\n        \\\"maxbitrate\\\": 2500,\\n        \\\"sequence\\\": 1,\\n        \\\"protocol\\\": 3,\\n        \\\"maxduration\\\": 60,\\n        \\\"pos\\\": 7,\\n        \\\"w\\\": 320,\\n        \\\"startdelay\\\": 0,\\n        \\\"protocols\\\": [\\n          1,\\n          2,\\n          3,\\n          4,\\n          5,\\n          6\\n        ]\\n      },\\n      \\\"secure\\\": 0,\\n      \\\"instl\\\": 1\\n    }\\n  ],\\n  \\\"device\\\": {\\n    \\\"os\\\": \\\"Android\\\",\\n    \\\"ip\\\": \\\"69.197.148.18\\\",\\n    \\\"js\\\": 1,\\n    \\\"dnt\\\": 0,\\n    \\\"ua\\\": \\\"Mozilla/5.0 (Linux; Android 4.4.2; Nexus 4 Build/KOT49H) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/31.0.1650.59 Mobile Safari/537.36\\\",\\n    \\\"devicetype\\\": 1,\\n    \\\"geo\\\": {\\n      \\\"country\\\": \\\"USA\\\",\\n      \\\"lon\\\": 12.12,\\n      \\\"type\\\": 1,\\n      \\\"lat\\\": 280.12\\n    },\\n    \\\"dpidmd5\\\": \\\"D7F8F90BD898B8040498A9DDAF11616D\\\",\\n    \\\"osv\\\": \\\"4.4\\\",\\n    \\\"model\\\": \\\"Nexus 4\\\",\\n    \\\"connectiontype\\\": 2,\\n    \\\"make\\\": \\\"Google\\\",\\n    \\\"dpidsha1\\\": \\\"91CB6F5820FAED91DA01D6D7D387E4D9241A7D3E\\\"\\n  },\\n  \\\"user\\\": {\\n    \\\"gender\\\": \\\"M\\\",\\n    \\\"yob\\\": 1982,\\n    \\\"id\\\": \\\"ec289fed708d6926164411ea67d7710b\\\"\\n  }\\n}\",\n      \"language\": \"json\",\n      \"name\": \"RTB 2.2 Video Android App\"\n    },\n    {\n      \"code\": \"{\\n  \\\"ext\\\": {\\n    \\\"udi\\\": {\\n      \\\"idfa\\\": \\\"1976F519-26D0-4428-9891-3133253A453F\\\"\\n    }\\n  },\\n  \\\"cur\\\": [\\n    \\\"USD\\\"\\n  ],\\n\\t\\\"app\\\": {  \\n      \\\"storeurl\\\":\\\"https://itunes.apple.com/en/app/angry-birds/id343200656?mt=8\\\",\\n      \\\"domain\\\":\\\"rovio.com\\\",\\n      \\\"cat\\\":[  \\n         \\\"IAB1\\\"\\n      ],\\n      \\\"name\\\":\\\"Angry Birds\\\",\\n      \\\"publisher\\\":{  \\n         \\\"id\\\":\\\"37880\\\"\\n      },\\n      \\\"id\\\":\\\"77656\\\",\\n      \\\"bundle\\\":\\\"343200656\\\"\\n  },\\n  \\\"at\\\": 2,\\n  \\\"tmax\\\": 300,\\n  \\\"bcat\\\": [\\n    \\\"IAB26\\\",\\n    \\\"IAB25\\\",\\n    \\\"IAB24\\\"\\n  ],\\n  \\\"id\\\": \\\"613373C43DA027EB582E6878CDFC28F7\\\",\\n  \\\"imp\\\": [\\n    {\\n      \\\"ext\\\": {\\n        \\\"brandsafe\\\": 0,\\n        \\\"mraid\\\": 2\\n      },\\n      \\\"displaymanager\\\": \\\"third_party_sdk\\\",\\n      \\\"displaymanagerver\\\": \\\"0\\\",\\n      \\\"bidfloor\\\": 1.333333,\\n      \\\"banner\\\": {\\n        \\\"battr\\\": [\\n          8,\\n          10\\n        ],\\n        \\\"topframe\\\": 0,\\n        \\\"pos\\\": 0,\\n        \\\"w\\\": 320,\\n        \\\"btype\\\": [\\n          4\\n        ],\\n        \\\"h\\\": 50,\\n        \\\"wmax\\\": 320,\\n        \\\"id\\\": \\\"1\\\",\\n        \\\"api\\\": [\\n          3,\\n          5\\n        ],\\n        \\\"hmax\\\": 50\\n      },\\n      \\\"bidfloorcur\\\": \\\"USD\\\",\\n      \\\"id\\\": \\\"1\\\",\\n      \\\"secure\\\": 0,\\n      \\\"instl\\\": 0\\n    }\\n  ],\\n  \\\"device\\\": {\\n    \\\"os\\\": \\\"iOS\\\",\\n    \\\"ifa\\\": \\\"1976F519-26D0-4428-9891-3133253A453F\\\",\\n    \\\"ip\\\": \\\"69.197.148.18\\\",\\n    \\\"js\\\": 1,\\n    \\\"dnt\\\": 0,\\n    \\\"ua\\\": \\\"Mozilla/5.0 (iPhone; CPU iPhone OS 8_0 like Mac OS X) AppleWebKit/600.1.3 (KHTML, like Gecko) Version/8.0 Mobile/12A4345d Safari/600.1.4\\\",\\n    \\\"devicetype\\\": 1,\\n    \\\"geo\\\": {\\n      \\\"country\\\": \\\"USA\\\",\\n      \\\"lon\\\": 12.12,\\n      \\\"type\\\": 1,\\n      \\\"lat\\\": 280.12\\n    },\\n    \\\"dpidmd5\\\": \\\"2D20AF98F011570F75A9606D41D9B300\\\",\\n    \\\"osv\\\": \\\"8.0\\\",\\n    \\\"model\\\": \\\"iPhone\\\",\\n    \\\"connectiontype\\\": 2,\\n    \\\"make\\\": \\\"Apple\\\",\\n    \\\"dpidsha1\\\": \\\"7EBF6FABAB3B9CACC5BC087F8EAE55D84586705E\\\"\\n  },\\n  \\\"user\\\": {\\n    \\\"gender\\\": \\\"M\\\",\\n    \\\"yob\\\": 1982,\\n    \\\"id\\\": \\\"b87f835ca3d57db03f21c4e11c077a93\\\"\\n  }\\n}\",\n      \"language\": \"json\",\n      \"name\": \"RTB 2.2 MRAID iOS App\"\n    },\n    {\n      \"code\": \"{\\n   \\\"ext\\\":{\\n      \\\"udi\\\":{\\n         \\\"idfa\\\":\\\"1976F519-26D0-4428-9891-3133253A453F\\\"\\n      }\\n   },\\n   \\\"cur\\\":[\\n      \\\"USD\\\"\\n   ],\\n   \\\"site\\\":{\\n      \\\"name\\\":\\\"MobFox Official TestID - Banners\\\",\\n      \\\"publisher\\\":{\\n         \\\"id\\\":\\\"14566\\\"\\n      },\\n      \\\"id\\\":\\\"21237\\\",\\n      \\\"page\\\":\\\"http://www.mobfox.com\\\",\\n      \\\"domain\\\":\\\"http://www.mobfox.com\\\",\\n      \\\"cat\\\":[\\n         \\\"IAB1\\\"\\n      ]\\n   },\\n   \\\"at\\\":2,\\n   \\\"tmax\\\":300,\\n   \\\"bcat\\\":[\\n      \\\"IAB26\\\",\\n      \\\"IAB25\\\",\\n      \\\"IAB24\\\"\\n   ],\\n   \\\"id\\\":\\\"5841A8C549C99EF7A3730ECF6A900287\\\",\\n   \\\"imp\\\":[\\n      {\\n         \\\"ext\\\":{\\n            \\\"brandsafe\\\":0\\n         },\\n         \\\"native\\\":{\\n            \\\"request\\\":\\\"{\\\\\\\"native\\\\\\\":{\\\\\\\"ver\\\\\\\":\\\\\\\"1.1\\\\\\\",\\\\\\\"layout\\\\\\\":2,\\\\\\\"adunit\\\\\\\":1,\\\\\\\"assets\\\\\\\":[{\\\\\\\"id\\\\\\\":1,\\\\\\\"img\\\\\\\":{\\\\\\\"hmin\\\\\\\":100,\\\\\\\"type\\\\\\\":1,\\\\\\\"wmin\\\\\\\":100},\\\\\\\"required\\\\\\\":0},{\\\\\\\"id\\\\\\\":2,\\\\\\\"img\\\\\\\":{\\\\\\\"hmin\\\\\\\":600,\\\\\\\"type\\\\\\\":3,\\\\\\\"wmin\\\\\\\":1000},\\\\\\\"required\\\\\\\":1},{\\\\\\\"id\\\\\\\":3,\\\\\\\"title\\\\\\\":{\\\\\\\"len\\\\\\\":50},\\\\\\\"required\\\\\\\":1},{\\\\\\\"id\\\\\\\":4,\\\\\\\"data\\\\\\\":{\\\\\\\"len\\\\\\\":100,\\\\\\\"type\\\\\\\":2},\\\\\\\"required\\\\\\\":1},{\\\\\\\"id\\\\\\\":5,\\\\\\\"data\\\\\\\":{\\\\\\\"type\\\\\\\":3},\\\\\\\"required\\\\\\\":0},{\\\\\\\"id\\\\\\\":6,\\\\\\\"data\\\\\\\":{\\\\\\\"len\\\\\\\":20,\\\\\\\"type\\\\\\\":12},\\\\\\\"required\\\\\\\":0},{\\\\\\\"id\\\\\\\":7,\\\\\\\"data\\\\\\\":{\\\\\\\"len\\\\\\\":25,\\\\\\\"type\\\\\\\":1},\\\\\\\"required\\\\\\\":0}],\\\\\\\"context\\\\\\\":1,\\\\\\\"plcmttype\\\\\\\":2}}\\\",\\n            \\\"ver\\\":\\\"1.1\\\",\\n            \\\"battr\\\":[\\n               8,\\n               10\\n            ]\\n         },\\n         \\\"displaymanager\\\":\\\"third_party_sdk\\\",\\n         \\\"displaymanagerver\\\":\\\"0\\\",\\n         \\\"bidfloor\\\":1.333333,\\n         \\\"bidfloorcur\\\":\\\"USD\\\",\\n         \\\"id\\\":\\\"1\\\",\\n         \\\"secure\\\":0,\\n         \\\"instl\\\":0\\n      }\\n   ],\\n   \\\"device\\\":{\\n      \\\"os\\\":\\\"iOS\\\",\\n      \\\"ifa\\\":\\\"1976F519-26D0-4428-9891-3133253A453F\\\",\\n      \\\"ip\\\":\\\"212.232.28.94\\\",\\n      \\\"js\\\":1,\\n      \\\"dnt\\\":0,\\n      \\\"ua\\\":\\\"Mozilla/5.0 (iPhone; CPU iPhone OS 8_0 like Mac OS X) AppleWebKit/600.1.3 (KHTML, like Gecko) Version/8.0 Mobile/12A4345d Safari/600.1.4\\\",\\n      \\\"devicetype\\\":4,\\n      \\\"geo\\\":{\\n         \\\"country\\\":\\\"AUT\\\",\\n         \\\"lon\\\":12.12,\\n         \\\"type\\\":1,\\n         \\\"lat\\\":80.12\\n      },\\n      \\\"dpidmd5\\\":\\\"2D20AF98F011570F75A9606D41D9B300\\\",\\n      \\\"osv\\\":\\\"8.0\\\",\\n      \\\"model\\\":\\\"iPhone\\\",\\n      \\\"connectiontype\\\":2,\\n      \\\"make\\\":\\\"Apple\\\",\\n      \\\"dpidsha1\\\":\\\"7EBF6FABAB3B9CACC5BC087F8EAE55D84586705E\\\"\\n   },\\n   \\\"user\\\":{\\n      \\\"gender\\\":\\\"M\\\",\\n      \\\"yob\\\":1982,\\n      \\\"id\\\":\\\"c6292267-56ad-4326-965d-deef6fcd5er9\\\"\\n   }\\n}\",\n      \"language\": \"json\",\n      \"name\": \"RTB 2.3 Native iOS App\"\n    },\n    {\n      \"code\": \"{\\n   \\\"ext\\\":{\\n      \\\"udi\\\":{\\n         \\\"idfa\\\":\\\"1976F519-26D0-4428-9891-3133253A453F\\\"\\n      }\\n   },\\n   \\\"cur\\\":[\\n      \\\"USD\\\"\\n   ],\\n   \\\"site\\\":{\\n      \\\"name\\\":\\\"MobFox Official TestID - Banners\\\",\\n      \\\"publisher\\\":{\\n         \\\"id\\\":\\\"14566\\\"\\n      },\\n      \\\"id\\\":\\\"21237\\\",\\n      \\\"page\\\":\\\"http://www.mobfox.com\\\",\\n      \\\"domain\\\":\\\"http://www.mobfox.com\\\",\\n      \\\"cat\\\":[\\n         \\\"IAB1\\\"\\n      ]\\n   },\\n   \\\"at\\\":2,\\n   \\\"tmax\\\":300,\\n   \\\"bcat\\\":[\\n      \\\"IAB26\\\",\\n      \\\"IAB25\\\",\\n      \\\"IAB24\\\"\\n   ],\\n   \\\"id\\\":\\\"B93F3DF68A816CECC8EF191921E9F27F\\\",\\n   \\\"imp\\\":[\\n      {\\n         \\\"ext\\\":{\\n            \\\"brandsafe\\\":0\\n         },\\n         \\\"pmp\\\":{\\n            \\\"private_auction\\\":0,\\n            \\\"deals\\\":[\\n               {\\n                  \\\"id\\\":\\\"abc123def\\\",\\n                  \\\"at\\\":2,\\n                  \\\"bidfloor\\\":2.0,\\n                  \\\"bidfloorcur\\\":\\\"USD\\\"\\n               }\\n            ]\\n         },\\n         \\\"displaymanager\\\":\\\"third_party_sdk\\\",\\n         \\\"displaymanagerver\\\":\\\"0\\\",\\n         \\\"bidfloor\\\":1.333333,\\n         \\\"banner\\\":{\\n            \\\"battr\\\":[\\n               8,\\n               10\\n            ],\\n            \\\"topframe\\\":0,\\n            \\\"pos\\\":0,\\n            \\\"w\\\":320,\\n            \\\"btype\\\":[\\n               4\\n            ],\\n            \\\"h\\\":50,\\n            \\\"wmax\\\":320,\\n            \\\"id\\\":\\\"1\\\",\\n            \\\"hmax\\\":50\\n         },\\n         \\\"bidfloorcur\\\":\\\"USD\\\",\\n         \\\"id\\\":\\\"1\\\",\\n         \\\"secure\\\":0,\\n         \\\"instl\\\":0\\n      }\\n   ],\\n   \\\"device\\\":{\\n      \\\"os\\\":\\\"iOS\\\",\\n      \\\"ifa\\\":\\\"1976F519-26D0-4428-9891-3133253A453F\\\",\\n      \\\"ip\\\":\\\"69.197.148.18\\\",\\n      \\\"js\\\":1,\\n      \\\"dnt\\\":0,\\n      \\\"ua\\\":\\\"Mozilla/5.0 (iPhone; CPU iPhone OS 8_0 like Mac OS X) AppleWebKit/600.1.3 (KHTML, like Gecko) Version/8.0 Mobile/12A4345d Safari/600.1.4\\\",\\n      \\\"devicetype\\\":1,\\n      \\\"geo\\\":{\\n         \\\"country\\\":\\\"USA\\\",\\n         \\\"lon\\\":12.12,\\n         \\\"type\\\":1,\\n         \\\"lat\\\":280.12\\n      },\\n      \\\"dpidmd5\\\":\\\"2D20AF98F011570F75A9606D41D9B300\\\",\\n      \\\"osv\\\":\\\"8.0\\\",\\n      \\\"model\\\":\\\"iPhone\\\",\\n      \\\"connectiontype\\\":2,\\n      \\\"make\\\":\\\"Apple\\\",\\n      \\\"dpidsha1\\\":\\\"7EBF6FABAB3B9CACC5BC087F8EAE55D84586705E\\\"\\n   },\\n   \\\"user\\\":{\\n      \\\"gender\\\":\\\"M\\\",\\n      \\\"yob\\\":1982,\\n      \\\"id\\\":\\\"b87f835ca3d57db03f21c4e11c077a93\\\"\\n   }\\n}\",\n      \"language\": \"json\",\n      \"name\": \"RTB 2.3 Banner iOS Site + PMP Deal\"\n    }\n  ]\n}\n[/block]\n\n[block:callout]\n{\n  \"type\": \"danger\",\n  \"title\": \"Starting with 1st January 2017 MobFox will discard bids/ads with no secure markup\",\n  \"body\": \"Apple is making a push to secure HTTP connections from within their app environment by introducing and enforcing Apple's ATS (Application Transport Security) protocol.\\nStarting 1st January all **updated apps** need to support and use **https URLs** when making HTTP requests.\\n\\nFor more on this topic visit our [secure ads](doc:demand-side-secure-ads) page.\"\n}\n[/block]\n\n[block:callout]\n{\n  \"type\": \"info\",\n  \"title\": \"More on RTB native ads\",\n  \"body\": \"For detailed specifications on our RTB Native Ad integration please visit this page: [Native Ad Details](doc:native-ad-details)\"\n}\n[/block]\n\n[block:callout]\n{\n  \"type\": \"warning\",\n  \"title\": \"MobFox does not support multiple bids in one response\",\n  \"body\": \"If multiple bids are sent, MobFox will validate only the first one.\\n\\nOur PMP feature will send you multiple bid offers/bids in the bid request and supports multiple bids in your bid response.\"\n}\n[/block]\n\n[block:api-header]\n{\n  \"title\": \"5. MobFox SSP sends low QPS traffic for testing\"\n}\n[/block]\nWe will send you some test traffic and compare numbers.\n[block:api-header]\n{\n  \"type\": \"basic\",\n  \"title\": \"RTB Bid Response Attributes Explained\"\n}\n[/block]\nMobFox SSP requires some RTB parameters to be populated in your bid response to ensure quality of our platform.\n\nBelow you'll find parameters explained and which ones are required.\n[block:parameters]\n{\n  \"data\": {\n    \"h-0\": \"Attribute\",\n    \"0-0\": \"**crid** and **iurl**\",\n    \"h-1\": \"Explanation\",\n    \"h-2\": \"Required\",\n    \"1-0\": \"**iurl**\",\n    \"2-0\": \"**nurl**\",\n    \"2-1\": \"We are calling the **nurl** when our SSP receives an impression, NOT after the auction when the DSP wins. We will change this behaviour in Q4 2016 to call the **nurl** right after the DSP wins the auction.\\n\\nMake sure you are not discarding our **nurl** call based on the **user agent** we are sending when making the request. We are using **CURL** for this call which means our **user agent** will be a curl one.\",\n    \"0-1\": \"We expect **crid** and **iurl** to have a **1to1 relationship**.\\n\\nEach **crid** should have one and only one **iurl**, which should preview the creative and only this creative.\",\n    \"1-1\": \"Should be accessible over **long timespans** (1 week).\\n\\n**Cache busting** is not allowed here as MobFox cannot cache the URL anymore for better user experience.\",\n    \"3-0\": \"**adomain**\",\n    \"3-1\": \"While RTB specifies this as an array, MobFox is only considering the 1st entry in that array for post validation purposes.\",\n    \"5-0\": \"**price**\",\n    \"5-1\": \"The price has to be equal to or above the provided bid request floor price.\\n\\nMobFox supports only USD as currency.\",\n    \"4-0\": \"**bid.w\\nbid.h**\",\n    \"4-1\": \"We will validate bid width and height according to the requested sizes. If they don't match we will discard your bid.\\n\\nIf no values are provided, we will discard your bid.\",\n    \"0-2\": \"Yes\",\n    \"1-2\": \"Yes\",\n    \"2-2\": \"Yes\",\n    \"3-2\": \"Yes\",\n    \"4-2\": \"Yes\",\n    \"5-2\": \"Yes\"\n  },\n  \"cols\": 3,\n  \"rows\": 6\n}\n[/block]\n\n[block:api-header]\n{\n  \"type\": \"basic\",\n  \"title\": \"Impressions and Clicks\"\n}\n[/block]\nMobFox SSP will find and replace the click URL in ads to track clicks.\n\nOnce the user clicks on an ad, he will be redirected to MobFox SSP, which will then redirect to the original click URL.\n\nMobFox **counts impressions and clicks within 60min** of being served to the publisher for all ad types. As a DSP please ensure that the validity of nURL, impression & clicks trackers is at least 60 min. This will help reduce any discrepancies between the SSP and DSP activity.\n[block:api-header]\n{\n  \"type\": \"basic\",\n  \"title\": \"Useful Information\"\n}\n[/block]\n## MobFox SSP Endpoint\nOur SSP is located in multiple physical locations: [Multi-located SSP](doc:multi-located-ssp#available-mobfox-ssp-locations)\n\nPlease provide the **URLs of your endpoints** and state where they are physically located. MobFox will measure your latency from each data center and set you up in all date centers from which latency is good enough for productive use.\n\nMobFox endpoints for latency tests: [Multi-located SSP](doc:multi-located-ssp#available-mobfox-ssp-locations)\n\nMobFox does not provide IPs for whitelisting as MobFox server setup is hosted in a cloud environment and the IPs are changing constantly.\n\n## Latency\nWe will send traffic from a small country to test latency and generate numbers for discrepancy testing.\nWe prefer testing in a small geography like Austria, Switzerland, Denmark etc.\nMobFox SSP gives demand sources **300ms** (roundtrip time on bid request) to respond but it can vary. The actual roundtrip time is provided in the bid request's **tmax** parameter.\n\n## Discrepancy Research\nOnce traffic produces data, we will compare key metrics to make sure our numbers match.\n* [DSP Descrepancies](doc:dsp-descrepancies)","excerpt":"MobFox sends you traffic via OpenRTB","slug":"integrate-an-a-dsp","type":"basic","title":"Integrate as a DSP"}

Integrate as a DSP

MobFox sends you traffic via OpenRTB

Welcome to our platform. We'd love to integrate with you. Please get in touch at <sales@mobfox.com>. The MobFox SSP supports RTB 2.0, 2.1, 2.2 and 2.3. Please find bid request examples below. [block:api-header] { "type": "basic", "title": "1. Get in Touch" } [/block] Get in touch with us at <sales@mobfox.com>. **Integration questions:** * Which OpenRTB versions do you support? * What is your average response time (our data centers are in North Virginia and in Tokyo)? * Do you support ATS? * Are you sending [all parameters we require](doc:integrate-an-a-dsp#rtb-bid-response-attributes-explained)? We will send you our contract to sign and then send it back for us to counter sign. This is important to get started. [block:api-header] { "type": "basic", "title": "2. Credit Application" } [/block] Credit Application needs to be in place before we go live. [block:api-header] { "type": "basic", "title": "3. Create Account" } [/block] Create an account on our platform using the following link, http://www.mobfox.com/signup. Send us the account details (email) once registered. Alternatively you can send the email address to use, we can create an account for you. [block:api-header] { "type": "basic", "title": "4. Test with our Bid Request Samples" } [/block] MobFox SSP currently supports **RTB 2.0, 2.1, 2.2 and 2.3**. We recommend integrating on the most recent version. All ad types are supported on all supported RTB versions (banner, video, native). [block:code] { "codes": [ { "code": "{\n \"ext\":{\n \"udi\":{\n \"idfa\":\"1976F519-26D0-4428-9891-3133253A453F\"\n }\n },\n \"cur\":[\n \"USD\"\n ],\n \"site\":{\n \"name\":\"MobFox Official TestID - Banners\",\n \"publisher\":{\n \"id\":\"14566\"\n },\n \"id\":\"21237\",\n \"page\":\"http://www.mobfox.com\",\n \"domain\":\"http://www.mobfox.com\",\n \"cat\":[\n \"IAB1\"\n ]\n },\n \"at\":2,\n \"tmax\":300,\n \"bcat\":[\n \"IAB26\",\n \"IAB25\",\n \"IAB24\"\n ],\n \"id\":\"B93F3DF68A816CECC8EF191921E9F27F\",\n \"imp\":[\n {\n \"ext\":{\n \"brandsafe\":0\n },\n \"displaymanager\":\"third_party_sdk\",\n \"displaymanagerver\":\"0\",\n \"bidfloor\":1.333333,\n \"banner\":{\n \"battr\":[\n 8,\n 10\n ],\n \"topframe\":0,\n \"pos\":0,\n \"w\":320,\n \"btype\":[\n 4\n ],\n \"h\":50,\n \"wmax\":320,\n \"id\":\"1\",\n \"hmax\":50\n },\n \"bidfloorcur\":\"USD\",\n \"id\":\"1\",\n \"secure\":0,\n \"instl\":0\n }\n ],\n \"device\":{\n \"os\":\"iOS\",\n \"ifa\":\"1976F519-26D0-4428-9891-3133253A453F\",\n \"ip\":\"69.197.148.18\",\n \"js\":1,\n \"dnt\":0,\n \"ua\":\"Mozilla/5.0 (iPhone; CPU iPhone OS 8_0 like Mac OS X) AppleWebKit/600.1.3 (KHTML, like Gecko) Version/8.0 Mobile/12A4345d Safari/600.1.4\",\n \"devicetype\":1,\n \"geo\":{\n \"country\":\"USA\",\n \"lon\":12.12,\n \"type\":1,\n \"lat\":280.12\n },\n \"dpidmd5\":\"2D20AF98F011570F75A9606D41D9B300\",\n \"osv\":\"8.0\",\n \"model\":\"iPhone\",\n \"connectiontype\":2,\n \"make\":\"Apple\",\n \"dpidsha1\":\"7EBF6FABAB3B9CACC5BC087F8EAE55D84586705E\"\n },\n \"user\":{\n \"gender\":\"M\",\n \"yob\":1982,\n \"id\":\"b87f835ca3d57db03f21c4e11c077a93\"\n }\n}", "language": "json", "name": "RTB 2.2 Banner iOS Site" }, { "code": "{\n  \"ext\": {\n    \"udi\": {\n      \"idfa\": \"1976F519-26D0-4428-9891-3133253A453F\"\n    }\n  },\n  \"cur\": [\n    \"USD\"\n  ],\n\t\"app\": { \n \"storeurl\":\"https://itunes.apple.com/en/app/angry-birds/id343200656?mt=8\",\n \"domain\":\"rovio.com\",\n \"cat\":[ \n \"IAB1\"\n ],\n \"name\":\"Angry Birds\",\n \"publisher\":{ \n \"id\":\"37880\"\n },\n \"id\":\"77656\",\n \"bundle\":\"343200656\"\n },\n  \"at\": 2,\n  \"tmax\": 300,\n  \"bcat\": [\n    \"IAB26\",\n    \"IAB25\",\n    \"IAB24\"\n  ],\n  \"id\": \"9BD484B4590AA2E726B61C18C05B7704\",\n  \"imp\": [\n    {\n      \"ext\": {\n        \"brandsafe\": 0,\n        \"strictbannersize\": 1\n      },\n      \"displaymanager\": \"third_party_sdk\",\n      \"displaymanagerver\": \"0\",\n      \"bidfloor\": 1,\n      \"banner\": {\n        \"battr\": [\n          8,\n          10\n        ],\n        \"topframe\": 0,\n        \"pos\": 7,\n        \"w\": 320,\n        \"btype\": [\n          4\n        ],\n        \"h\": 480,\n        \"id\": \"1\"\n      },\n      \"bidfloorcur\": \"USD\",\n      \"id\": \"1\",\n      \"secure\": 0,\n      \"instl\": 1\n    }\n  ],\n  \"device\": {\n    \"os\": \"iOS\",\n    \"ifa\": \"1976F519-26D0-4428-9891-3133253A453F\",\n    \"ip\": \"69.197.148.18\",\n    \"js\": 1,\n    \"dnt\": 0,\n    \"ua\": \"Mozilla/5.0 (iPhone; CPU iPhone OS 8_0 like Mac OS X) AppleWebKit/600.1.3 (KHTML, like Gecko) Version/8.0 Mobile/12A4345d Safari/600.1.4\",\n    \"devicetype\": 1,\n    \"geo\": {\n      \"country\": \"USA\",\n      \"lon\": 12.12,\n      \"type\": 1,\n      \"lat\": 280.12\n    },\n    \"dpidmd5\": \"2D20AF98F011570F75A9606D41D9B300\",\n    \"osv\": \"8.0\",\n    \"model\": \"iPhone\",\n    \"connectiontype\": 2,\n    \"make\": \"Apple\",\n    \"dpidsha1\": \"7EBF6FABAB3B9CACC5BC087F8EAE55D84586705E\"\n  },\n  \"user\": {\n    \"gender\": \"M\",\n    \"yob\": 1982,\n    \"id\": \"b87f835ca3d57db03f21c4e11c077a93\"\n  }\n}", "language": "json", "name": "RTB 2.2 Banner Interstitial iOS App" }, { "code": "{\n  \"ext\": {\n    \"udi\": {\n      \"gaid\": \"c6292267-56ad-4326-965d-deef6fcd5er9\"\n    }\n  },\n  \"cur\": [\n    \"USD\"\n  ],\n \"app\": { \n \"storeurl\":\"https://play.google.com/store/apps/details?id=com.rovio.angrybirds&hl=en\",\n \"domain\":\"rovio.com\",\n \"cat\":[ \n \"IAB1\"\n ],\n \"name\":\"Angry Birds\",\n \"publisher\":{ \n \"id\":\"328801\"\n },\n \"id\":\"12323\",\n \"bundle\":\"com.rovio.angrybirds\"\n },\n  \"at\": 2,\n  \"tmax\": 300,\n  \"bcat\": [\n    \"IAB26\",\n    \"IAB25\",\n    \"IAB24\"\n  ],\n  \"id\": \"790E3A41A2FE29611C2A5EB97B300324\",\n  \"imp\": [\n    {\n      \"ext\": {\n        \"brandsafe\": 0\n      },\n      \"displaymanager\": \"third_party_sdk\",\n      \"displaymanagerver\": \"0\",\n      \"bidfloor\": 1.333333,\n      \"bidfloorcur\": \"USD\",\n      \"id\": \"1\",\n      \"video\": {\n        \"boxingallowed\": 1,\n        \"battr\": [\n          8,\n          10\n        ],\n        \"maxextended\": 0,\n        \"linearity\": 1,\n        \"minbitrate\": 250,\n        \"h\": 480,\n        \"playbackmethod\": [\n          2\n        ],\n        \"minduration\": 5,\n        \"mimes\": [\n          \"video/mp4\"\n        ],\n        \"maxbitrate\": 2500,\n        \"sequence\": 1,\n        \"protocol\": 3,\n        \"maxduration\": 60,\n        \"pos\": 7,\n        \"w\": 320,\n        \"startdelay\": 0,\n        \"protocols\": [\n          1,\n          2,\n          3,\n          4,\n          5,\n          6\n        ]\n      },\n      \"secure\": 0,\n      \"instl\": 1\n    }\n  ],\n  \"device\": {\n    \"os\": \"Android\",\n    \"ip\": \"69.197.148.18\",\n    \"js\": 1,\n    \"dnt\": 0,\n    \"ua\": \"Mozilla/5.0 (Linux; Android 4.4.2; Nexus 4 Build/KOT49H) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/31.0.1650.59 Mobile Safari/537.36\",\n    \"devicetype\": 1,\n    \"geo\": {\n      \"country\": \"USA\",\n      \"lon\": 12.12,\n      \"type\": 1,\n      \"lat\": 280.12\n    },\n    \"dpidmd5\": \"D7F8F90BD898B8040498A9DDAF11616D\",\n    \"osv\": \"4.4\",\n    \"model\": \"Nexus 4\",\n    \"connectiontype\": 2,\n    \"make\": \"Google\",\n    \"dpidsha1\": \"91CB6F5820FAED91DA01D6D7D387E4D9241A7D3E\"\n  },\n  \"user\": {\n    \"gender\": \"M\",\n    \"yob\": 1982,\n    \"id\": \"ec289fed708d6926164411ea67d7710b\"\n  }\n}", "language": "json", "name": "RTB 2.2 Video Android App" }, { "code": "{\n  \"ext\": {\n    \"udi\": {\n      \"idfa\": \"1976F519-26D0-4428-9891-3133253A453F\"\n    }\n  },\n  \"cur\": [\n    \"USD\"\n  ],\n\t\"app\": { \n \"storeurl\":\"https://itunes.apple.com/en/app/angry-birds/id343200656?mt=8\",\n \"domain\":\"rovio.com\",\n \"cat\":[ \n \"IAB1\"\n ],\n \"name\":\"Angry Birds\",\n \"publisher\":{ \n \"id\":\"37880\"\n },\n \"id\":\"77656\",\n \"bundle\":\"343200656\"\n },\n  \"at\": 2,\n  \"tmax\": 300,\n  \"bcat\": [\n    \"IAB26\",\n    \"IAB25\",\n    \"IAB24\"\n  ],\n  \"id\": \"613373C43DA027EB582E6878CDFC28F7\",\n  \"imp\": [\n    {\n      \"ext\": {\n        \"brandsafe\": 0,\n        \"mraid\": 2\n      },\n      \"displaymanager\": \"third_party_sdk\",\n      \"displaymanagerver\": \"0\",\n      \"bidfloor\": 1.333333,\n      \"banner\": {\n        \"battr\": [\n          8,\n          10\n        ],\n        \"topframe\": 0,\n        \"pos\": 0,\n        \"w\": 320,\n        \"btype\": [\n          4\n        ],\n        \"h\": 50,\n        \"wmax\": 320,\n        \"id\": \"1\",\n        \"api\": [\n          3,\n          5\n        ],\n        \"hmax\": 50\n      },\n      \"bidfloorcur\": \"USD\",\n      \"id\": \"1\",\n      \"secure\": 0,\n      \"instl\": 0\n    }\n  ],\n  \"device\": {\n    \"os\": \"iOS\",\n    \"ifa\": \"1976F519-26D0-4428-9891-3133253A453F\",\n    \"ip\": \"69.197.148.18\",\n    \"js\": 1,\n    \"dnt\": 0,\n    \"ua\": \"Mozilla/5.0 (iPhone; CPU iPhone OS 8_0 like Mac OS X) AppleWebKit/600.1.3 (KHTML, like Gecko) Version/8.0 Mobile/12A4345d Safari/600.1.4\",\n    \"devicetype\": 1,\n    \"geo\": {\n      \"country\": \"USA\",\n      \"lon\": 12.12,\n      \"type\": 1,\n      \"lat\": 280.12\n    },\n    \"dpidmd5\": \"2D20AF98F011570F75A9606D41D9B300\",\n    \"osv\": \"8.0\",\n    \"model\": \"iPhone\",\n    \"connectiontype\": 2,\n    \"make\": \"Apple\",\n    \"dpidsha1\": \"7EBF6FABAB3B9CACC5BC087F8EAE55D84586705E\"\n  },\n  \"user\": {\n    \"gender\": \"M\",\n    \"yob\": 1982,\n    \"id\": \"b87f835ca3d57db03f21c4e11c077a93\"\n  }\n}", "language": "json", "name": "RTB 2.2 MRAID iOS App" }, { "code": "{\n \"ext\":{\n \"udi\":{\n \"idfa\":\"1976F519-26D0-4428-9891-3133253A453F\"\n }\n },\n \"cur\":[\n \"USD\"\n ],\n \"site\":{\n \"name\":\"MobFox Official TestID - Banners\",\n \"publisher\":{\n \"id\":\"14566\"\n },\n \"id\":\"21237\",\n \"page\":\"http://www.mobfox.com\",\n \"domain\":\"http://www.mobfox.com\",\n \"cat\":[\n \"IAB1\"\n ]\n },\n \"at\":2,\n \"tmax\":300,\n \"bcat\":[\n \"IAB26\",\n \"IAB25\",\n \"IAB24\"\n ],\n \"id\":\"5841A8C549C99EF7A3730ECF6A900287\",\n \"imp\":[\n {\n \"ext\":{\n \"brandsafe\":0\n },\n \"native\":{\n \"request\":\"{\\\"native\\\":{\\\"ver\\\":\\\"1.1\\\",\\\"layout\\\":2,\\\"adunit\\\":1,\\\"assets\\\":[{\\\"id\\\":1,\\\"img\\\":{\\\"hmin\\\":100,\\\"type\\\":1,\\\"wmin\\\":100},\\\"required\\\":0},{\\\"id\\\":2,\\\"img\\\":{\\\"hmin\\\":600,\\\"type\\\":3,\\\"wmin\\\":1000},\\\"required\\\":1},{\\\"id\\\":3,\\\"title\\\":{\\\"len\\\":50},\\\"required\\\":1},{\\\"id\\\":4,\\\"data\\\":{\\\"len\\\":100,\\\"type\\\":2},\\\"required\\\":1},{\\\"id\\\":5,\\\"data\\\":{\\\"type\\\":3},\\\"required\\\":0},{\\\"id\\\":6,\\\"data\\\":{\\\"len\\\":20,\\\"type\\\":12},\\\"required\\\":0},{\\\"id\\\":7,\\\"data\\\":{\\\"len\\\":25,\\\"type\\\":1},\\\"required\\\":0}],\\\"context\\\":1,\\\"plcmttype\\\":2}}\",\n \"ver\":\"1.1\",\n \"battr\":[\n 8,\n 10\n ]\n },\n \"displaymanager\":\"third_party_sdk\",\n \"displaymanagerver\":\"0\",\n \"bidfloor\":1.333333,\n \"bidfloorcur\":\"USD\",\n \"id\":\"1\",\n \"secure\":0,\n \"instl\":0\n }\n ],\n \"device\":{\n \"os\":\"iOS\",\n \"ifa\":\"1976F519-26D0-4428-9891-3133253A453F\",\n \"ip\":\"212.232.28.94\",\n \"js\":1,\n \"dnt\":0,\n \"ua\":\"Mozilla/5.0 (iPhone; CPU iPhone OS 8_0 like Mac OS X) AppleWebKit/600.1.3 (KHTML, like Gecko) Version/8.0 Mobile/12A4345d Safari/600.1.4\",\n \"devicetype\":4,\n \"geo\":{\n \"country\":\"AUT\",\n \"lon\":12.12,\n \"type\":1,\n \"lat\":80.12\n },\n \"dpidmd5\":\"2D20AF98F011570F75A9606D41D9B300\",\n \"osv\":\"8.0\",\n \"model\":\"iPhone\",\n \"connectiontype\":2,\n \"make\":\"Apple\",\n \"dpidsha1\":\"7EBF6FABAB3B9CACC5BC087F8EAE55D84586705E\"\n },\n \"user\":{\n \"gender\":\"M\",\n \"yob\":1982,\n \"id\":\"c6292267-56ad-4326-965d-deef6fcd5er9\"\n }\n}", "language": "json", "name": "RTB 2.3 Native iOS App" }, { "code": "{\n \"ext\":{\n \"udi\":{\n \"idfa\":\"1976F519-26D0-4428-9891-3133253A453F\"\n }\n },\n \"cur\":[\n \"USD\"\n ],\n \"site\":{\n \"name\":\"MobFox Official TestID - Banners\",\n \"publisher\":{\n \"id\":\"14566\"\n },\n \"id\":\"21237\",\n \"page\":\"http://www.mobfox.com\",\n \"domain\":\"http://www.mobfox.com\",\n \"cat\":[\n \"IAB1\"\n ]\n },\n \"at\":2,\n \"tmax\":300,\n \"bcat\":[\n \"IAB26\",\n \"IAB25\",\n \"IAB24\"\n ],\n \"id\":\"B93F3DF68A816CECC8EF191921E9F27F\",\n \"imp\":[\n {\n \"ext\":{\n \"brandsafe\":0\n },\n \"pmp\":{\n \"private_auction\":0,\n \"deals\":[\n {\n \"id\":\"abc123def\",\n \"at\":2,\n \"bidfloor\":2.0,\n \"bidfloorcur\":\"USD\"\n }\n ]\n },\n \"displaymanager\":\"third_party_sdk\",\n \"displaymanagerver\":\"0\",\n \"bidfloor\":1.333333,\n \"banner\":{\n \"battr\":[\n 8,\n 10\n ],\n \"topframe\":0,\n \"pos\":0,\n \"w\":320,\n \"btype\":[\n 4\n ],\n \"h\":50,\n \"wmax\":320,\n \"id\":\"1\",\n \"hmax\":50\n },\n \"bidfloorcur\":\"USD\",\n \"id\":\"1\",\n \"secure\":0,\n \"instl\":0\n }\n ],\n \"device\":{\n \"os\":\"iOS\",\n \"ifa\":\"1976F519-26D0-4428-9891-3133253A453F\",\n \"ip\":\"69.197.148.18\",\n \"js\":1,\n \"dnt\":0,\n \"ua\":\"Mozilla/5.0 (iPhone; CPU iPhone OS 8_0 like Mac OS X) AppleWebKit/600.1.3 (KHTML, like Gecko) Version/8.0 Mobile/12A4345d Safari/600.1.4\",\n \"devicetype\":1,\n \"geo\":{\n \"country\":\"USA\",\n \"lon\":12.12,\n \"type\":1,\n \"lat\":280.12\n },\n \"dpidmd5\":\"2D20AF98F011570F75A9606D41D9B300\",\n \"osv\":\"8.0\",\n \"model\":\"iPhone\",\n \"connectiontype\":2,\n \"make\":\"Apple\",\n \"dpidsha1\":\"7EBF6FABAB3B9CACC5BC087F8EAE55D84586705E\"\n },\n \"user\":{\n \"gender\":\"M\",\n \"yob\":1982,\n \"id\":\"b87f835ca3d57db03f21c4e11c077a93\"\n }\n}", "language": "json", "name": "RTB 2.3 Banner iOS Site + PMP Deal" } ] } [/block] [block:callout] { "type": "danger", "title": "Starting with 1st January 2017 MobFox will discard bids/ads with no secure markup", "body": "Apple is making a push to secure HTTP connections from within their app environment by introducing and enforcing Apple's ATS (Application Transport Security) protocol.\nStarting 1st January all **updated apps** need to support and use **https URLs** when making HTTP requests.\n\nFor more on this topic visit our [secure ads](doc:demand-side-secure-ads) page." } [/block] [block:callout] { "type": "info", "title": "More on RTB native ads", "body": "For detailed specifications on our RTB Native Ad integration please visit this page: [Native Ad Details](doc:native-ad-details)" } [/block] [block:callout] { "type": "warning", "title": "MobFox does not support multiple bids in one response", "body": "If multiple bids are sent, MobFox will validate only the first one.\n\nOur PMP feature will send you multiple bid offers/bids in the bid request and supports multiple bids in your bid response." } [/block] [block:api-header] { "title": "5. MobFox SSP sends low QPS traffic for testing" } [/block] We will send you some test traffic and compare numbers. [block:api-header] { "type": "basic", "title": "RTB Bid Response Attributes Explained" } [/block] MobFox SSP requires some RTB parameters to be populated in your bid response to ensure quality of our platform. Below you'll find parameters explained and which ones are required. [block:parameters] { "data": { "h-0": "Attribute", "0-0": "**crid** and **iurl**", "h-1": "Explanation", "h-2": "Required", "1-0": "**iurl**", "2-0": "**nurl**", "2-1": "We are calling the **nurl** when our SSP receives an impression, NOT after the auction when the DSP wins. We will change this behaviour in Q4 2016 to call the **nurl** right after the DSP wins the auction.\n\nMake sure you are not discarding our **nurl** call based on the **user agent** we are sending when making the request. We are using **CURL** for this call which means our **user agent** will be a curl one.", "0-1": "We expect **crid** and **iurl** to have a **1to1 relationship**.\n\nEach **crid** should have one and only one **iurl**, which should preview the creative and only this creative.", "1-1": "Should be accessible over **long timespans** (1 week).\n\n**Cache busting** is not allowed here as MobFox cannot cache the URL anymore for better user experience.", "3-0": "**adomain**", "3-1": "While RTB specifies this as an array, MobFox is only considering the 1st entry in that array for post validation purposes.", "5-0": "**price**", "5-1": "The price has to be equal to or above the provided bid request floor price.\n\nMobFox supports only USD as currency.", "4-0": "**bid.w\nbid.h**", "4-1": "We will validate bid width and height according to the requested sizes. If they don't match we will discard your bid.\n\nIf no values are provided, we will discard your bid.", "0-2": "Yes", "1-2": "Yes", "2-2": "Yes", "3-2": "Yes", "4-2": "Yes", "5-2": "Yes" }, "cols": 3, "rows": 6 } [/block] [block:api-header] { "type": "basic", "title": "Impressions and Clicks" } [/block] MobFox SSP will find and replace the click URL in ads to track clicks. Once the user clicks on an ad, he will be redirected to MobFox SSP, which will then redirect to the original click URL. MobFox **counts impressions and clicks within 60min** of being served to the publisher for all ad types. As a DSP please ensure that the validity of nURL, impression & clicks trackers is at least 60 min. This will help reduce any discrepancies between the SSP and DSP activity. [block:api-header] { "type": "basic", "title": "Useful Information" } [/block] ## MobFox SSP Endpoint Our SSP is located in multiple physical locations: [Multi-located SSP](doc:multi-located-ssp#available-mobfox-ssp-locations) Please provide the **URLs of your endpoints** and state where they are physically located. MobFox will measure your latency from each data center and set you up in all date centers from which latency is good enough for productive use. MobFox endpoints for latency tests: [Multi-located SSP](doc:multi-located-ssp#available-mobfox-ssp-locations) MobFox does not provide IPs for whitelisting as MobFox server setup is hosted in a cloud environment and the IPs are changing constantly. ## Latency We will send traffic from a small country to test latency and generate numbers for discrepancy testing. We prefer testing in a small geography like Austria, Switzerland, Denmark etc. MobFox SSP gives demand sources **300ms** (roundtrip time on bid request) to respond but it can vary. The actual roundtrip time is provided in the bid request's **tmax** parameter. ## Discrepancy Research Once traffic produces data, we will compare key metrics to make sure our numbers match. * [DSP Descrepancies](doc:dsp-descrepancies)