{"__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\nIntegration questions:\n* Which OpenRTB versions do you support?\n* What is your average response time (our data center is on Houston)?\n* Do you support ATS?\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. Check 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}\n[/block]\n\n[block:api-header]\n{\n  \"type\": \"basic\",\n  \"title\": \"5. Clarification on Bid Responses\"\n}\n[/block]\nBelow you can find additional helpful information on the way MobFox SSP implements specific fields from the RTB spec.\n[block:parameters]\n{\n  \"data\": {\n    \"h-0\": \"Attribute\",\n    \"0-0\": \"**crid** and **iurl**\",\n    \"h-1\": \"Explanation\",\n    \"h-2\": \"11\",\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    \"4-0\": \"**price**\",\n    \"4-1\": \"The price has to be equal to or above the provided floor price.\\n\\nMobFox only supports USD as currency.\",\n    \"5-0\": \"**adid\\ncrid\\niurl\\ncid\\nadomain**\",\n    \"5-1\": \"We **strongly** suggest that **each bid contains** all these fields as otherwise our **demand quality** detection systems might block more broadly than necessary, in the worst case the whole DSP.\"\n  },\n  \"cols\": 2,\n  \"rows\": 6\n}\n[/block]\n\n[block:api-header]\n{\n  \"type\": \"basic\",\n  \"title\": \"6. 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\": \"7. Integration Flow\"\n}\n[/block]\n## 1. 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## 2. 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## 3. Discrepancy Research\nOnce traffic produces data, we will compare key metrics to make sure our numbers match.\n* [DSP Descrepancies](doc:dsp-descrepancies)\n\n## 4. Full Traffic\nIf the results are consistent between our platforms then we can go live full scale by opening up more traffic.","excerpt":"Using the OpenRTB standard","slug":"integrate-an-a-dsp","type":"basic","title":"Integrate as a DSP"}

Integrate as a DSP

Using the OpenRTB standard

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 center is on Houston)? * Do you support ATS? 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. Check 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." } [/block] [block:api-header] { "type": "basic", "title": "5. Clarification on Bid Responses" } [/block] Below you can find additional helpful information on the way MobFox SSP implements specific fields from the RTB spec. [block:parameters] { "data": { "h-0": "Attribute", "0-0": "**crid** and **iurl**", "h-1": "Explanation", "h-2": "11", "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.", "4-0": "**price**", "4-1": "The price has to be equal to or above the provided floor price.\n\nMobFox only supports USD as currency.", "5-0": "**adid\ncrid\niurl\ncid\nadomain**", "5-1": "We **strongly** suggest that **each bid contains** all these fields as otherwise our **demand quality** detection systems might block more broadly than necessary, in the worst case the whole DSP." }, "cols": 2, "rows": 6 } [/block] [block:api-header] { "type": "basic", "title": "6. 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": "7. Integration Flow" } [/block] ## 1. 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. ## 2. 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. ## 3. Discrepancy Research Once traffic produces data, we will compare key metrics to make sure our numbers match. * [DSP Descrepancies](doc:dsp-descrepancies) ## 4. Full Traffic If the results are consistent between our platforms then we can go live full scale by opening up more traffic.