{"_id":"5a7a2906c83a6300265483ba","project":"5429beef1163360800ed31fa","version":{"_id":"5429beef1163360800ed31fd","__v":22,"project":"5429beef1163360800ed31fa","createdAt":"2014-09-29T20:19:59.904Z","releaseDate":"2014-09-29T20:19:59.904Z","categories":["5429beef1163360800ed31fe","55e74e1f5d36b32b002563fa","55e7500a73169617001f2e86","55e76b8196131b2f00bf4b72","55e89569cdbb8a350096df9c","55f8935eb089b71700a8364e","55f8a67d3bb4bb0d0022d093","55f9dbefc7ef770d00d9bf6d","5601c21a22ecf60d002b27b3","5601c21ff12aee0d001bb06e","5601c2256c7b610d00280db5","5601c22c22ecf60d002b27b4","5603738d0c78b00d0039af47","5626f70bfcbbc621004ebf52","566f7a1ae144ab0d00e9732f","566f85ca7820960d00c3b93d","56708ce43a32d20d00c45cbf","56708d436995210d003aad8e","5736471abe10a9200030732c","57a82c7aff9bd30e00a6f1c1","591b8500e3992319007190f4","5a3718305c66a60012d960ba"],"is_deprecated":false,"is_hidden":false,"is_beta":false,"is_stable":true,"codename":"","version_clean":"1.0.0","version":"1.0"},"category":{"_id":"55f9dbefc7ef770d00d9bf6d","version":"5429beef1163360800ed31fd","__v":6,"pages":["55f9eec4c7ef770d00d9bf83","55f9fb8daba81f0d00a11566","5601ca6870694e0d00e3c66f","5601cb9b96e0f70d0044b0fd","56157d7af2d81d0d006c895f","5671d738c17bf90d00b95822"],"project":"5429beef1163360800ed31fa","sync":{"url":"","isSync":false},"reference":true,"createdAt":"2015-09-16T21:15:27.664Z","from_sync":false,"order":4,"slug":"publisher-ui-setup","title":"Trafficking and Inventory"},"user":"5625457f23053b2300f596c9","__v":0,"parentDoc":null,"updates":[],"next":{"pages":[],"description":""},"createdAt":"2018-02-06T22:15:34.340Z","link_external":false,"link_url":"","githubsync":"","sync_unique":"","hidden":false,"api":{"results":{"codes":[]},"settings":"","auth":"required","params":[],"url":""},"isReference":true,"order":28,"body":"First please refer to this document to understand concept of PMP in Polymorph - https://dev.getpolymorph.com/docs/understanding-pmp-in-polymorph\n[block:api-header]\n{\n  \"title\": \"Understanding PMP with Rubicon Project and Polymorph\"\n}\n[/block]\nAs you might've already learnt in this [doc](https://dev.getpolymorph.com/docs/understanding-pmp-in-polymorph) that Polymorph sends two different bid requests in case of PMP. One with Deal ID and other for open exchange. Generally, as per OpenRTB specs, SSPs and DSPs can respond with a Deal ID campaign only when that Deal ID is present in the bid request, but Rubicon integration doesn't work that way. Rubicon can respond with a Deal ID campaign for open exchange bid request as well, even though that might not have a Deal ID present in it. Rubicon is not fully compliant with OpenRTB specs in this regard. Because of this Rubicon PMP setup has to be done in a unique way.  In case of Rubicon, the setup of PMP campaign is almost entirely at Rubicon end. You can follow the following steps to setup a PMP campaign in Rubicon and Rubicon will ensure that it returns Deal ID campaign within Polymorph open exchange integration when its eligible and present. \n\nIf the setup of PMP campaign is only done at Rubicon end and not in Polymorph, then unlike other SSPs, your deal id campaign can still flow through Polymorph, but Polymorph will treat Deal ID bid response by Rubicon like any other bid response, so it will compete at priority 10 with rest of the demand partners and will only win if has the highest bid. If you want Polymorph to treat it with the special rules such as particular price or a priority, then you will have to setup that PMP campaign in Polymorph as well. \n[block:api-header]\n{\n  \"title\": \"Setup PMP with Rubicon\"\n}\n[/block]\n\n[block:api-header]\n{\n  \"title\": \"1. Create a Deal in Rubicon\"\n}\n[/block]\nLogin to Rubicon console and under 'Orders / Campaign Management' > 'Deals Management', once you click on 'Add New Deal', you will see following popup. Provide a title to this deal, choose the DSP which you have this deal with, you can leave DSP Referrer field blank and then click on 'Generate Token'. The generated token is what you will have to share with your DSP, since this is the token they will see in their bid requests. \n\nOnce you click on 'Save', you will see a separate 'Deal ID' generated which is 6 digit number, this is the Deal ID you will configure in Polymorph in setup 3 below\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/4ece1f9-Screen_Shot_2018-02-07_at_4.21.17_PM.png\",\n        \"Screen Shot 2018-02-07 at 4.21.17 PM.png\",\n        2172,\n        1446,\n        \"#3a3a3a\"\n      ]\n    }\n  ]\n}\n[/block]\n\n[block:api-header]\n{\n  \"title\": \"2. Setup PMP in Rubicon\"\n}\n[/block]\nNow you need to setup targeting rules for above Deal. Go to 'Inventory Setup' > 'RTB Controls' > 'Private Marketplaces' and click on 'New Rule', you will see following screen,\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/9188575-Screen_Shot_2018-02-07_at_4.35.57_PM.png\",\n        \"Screen Shot 2018-02-07 at 4.35.57 PM.png\",\n        2222,\n        1474,\n        \"#e3e3e3\"\n      ]\n    }\n  ]\n}\n[/block]\nFill in all the targeting rules as applicable and your agreed upon terms for the deal such as priority, floor, price, inventory, etc. and under deals select the deal you added in at step 1 above. This completes your setup on Rubicon side.\n[block:api-header]\n{\n  \"title\": \"3. Setup PMP campaign in Polymorph\"\n}\n[/block]\nSetup the PMP campaign in Polymorph by following these steps - https://dev.getpolymorph.com/v1.0/docs/setup-pmp-campaign and use the Deal ID generated in Rubicon (at step 1).\n[block:api-header]\n{\n  \"title\": \"Reporting\"\n}\n[/block]\nYou can view the deals reporting in Rubicon console under 'Reporting & Insights' > 'Deal Health'. You will see reports as follows,\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/6014bbe-Screen_Shot_2018-02-07_at_4.41.57_PM.png\",\n        \"Screen Shot 2018-02-07 at 4.41.57 PM.png\",\n        2560,\n        1446,\n        \"#f5f6f3\"\n      ]\n    }\n  ]\n}\n[/block]\nYou will notice the reports for each Deal you've setup in Rubicon. It shows the bid request and responses received for each of the deal. In this case, Bid Requests and responses refer to bidding activity from Rubicon to Polymorph. If you see 0 Bid Requests, that means there could be some issue in the setup of the deal above, most likely with the targeting. Either it could be incorrectly targeted or you may not have inventory for the selected targeting. If Bid requests number is > 0, but Bid Responses is 0 thats means there is something wrong with the setup at the DSP you are working with or they might have incorrect Rubicon Deal Token as configured in above step 1.","excerpt":"","slug":"pmp-campaign-setup-with-rubicon","type":"basic","title":"PMP Campaign setup with Rubicon Project"}

PMP Campaign setup with Rubicon Project


First please refer to this document to understand concept of PMP in Polymorph - https://dev.getpolymorph.com/docs/understanding-pmp-in-polymorph [block:api-header] { "title": "Understanding PMP with Rubicon Project and Polymorph" } [/block] As you might've already learnt in this [doc](https://dev.getpolymorph.com/docs/understanding-pmp-in-polymorph) that Polymorph sends two different bid requests in case of PMP. One with Deal ID and other for open exchange. Generally, as per OpenRTB specs, SSPs and DSPs can respond with a Deal ID campaign only when that Deal ID is present in the bid request, but Rubicon integration doesn't work that way. Rubicon can respond with a Deal ID campaign for open exchange bid request as well, even though that might not have a Deal ID present in it. Rubicon is not fully compliant with OpenRTB specs in this regard. Because of this Rubicon PMP setup has to be done in a unique way. In case of Rubicon, the setup of PMP campaign is almost entirely at Rubicon end. You can follow the following steps to setup a PMP campaign in Rubicon and Rubicon will ensure that it returns Deal ID campaign within Polymorph open exchange integration when its eligible and present. If the setup of PMP campaign is only done at Rubicon end and not in Polymorph, then unlike other SSPs, your deal id campaign can still flow through Polymorph, but Polymorph will treat Deal ID bid response by Rubicon like any other bid response, so it will compete at priority 10 with rest of the demand partners and will only win if has the highest bid. If you want Polymorph to treat it with the special rules such as particular price or a priority, then you will have to setup that PMP campaign in Polymorph as well. [block:api-header] { "title": "Setup PMP with Rubicon" } [/block] [block:api-header] { "title": "1. Create a Deal in Rubicon" } [/block] Login to Rubicon console and under 'Orders / Campaign Management' > 'Deals Management', once you click on 'Add New Deal', you will see following popup. Provide a title to this deal, choose the DSP which you have this deal with, you can leave DSP Referrer field blank and then click on 'Generate Token'. The generated token is what you will have to share with your DSP, since this is the token they will see in their bid requests. Once you click on 'Save', you will see a separate 'Deal ID' generated which is 6 digit number, this is the Deal ID you will configure in Polymorph in setup 3 below [block:image] { "images": [ { "image": [ "https://files.readme.io/4ece1f9-Screen_Shot_2018-02-07_at_4.21.17_PM.png", "Screen Shot 2018-02-07 at 4.21.17 PM.png", 2172, 1446, "#3a3a3a" ] } ] } [/block] [block:api-header] { "title": "2. Setup PMP in Rubicon" } [/block] Now you need to setup targeting rules for above Deal. Go to 'Inventory Setup' > 'RTB Controls' > 'Private Marketplaces' and click on 'New Rule', you will see following screen, [block:image] { "images": [ { "image": [ "https://files.readme.io/9188575-Screen_Shot_2018-02-07_at_4.35.57_PM.png", "Screen Shot 2018-02-07 at 4.35.57 PM.png", 2222, 1474, "#e3e3e3" ] } ] } [/block] Fill in all the targeting rules as applicable and your agreed upon terms for the deal such as priority, floor, price, inventory, etc. and under deals select the deal you added in at step 1 above. This completes your setup on Rubicon side. [block:api-header] { "title": "3. Setup PMP campaign in Polymorph" } [/block] Setup the PMP campaign in Polymorph by following these steps - https://dev.getpolymorph.com/v1.0/docs/setup-pmp-campaign and use the Deal ID generated in Rubicon (at step 1). [block:api-header] { "title": "Reporting" } [/block] You can view the deals reporting in Rubicon console under 'Reporting & Insights' > 'Deal Health'. You will see reports as follows, [block:image] { "images": [ { "image": [ "https://files.readme.io/6014bbe-Screen_Shot_2018-02-07_at_4.41.57_PM.png", "Screen Shot 2018-02-07 at 4.41.57 PM.png", 2560, 1446, "#f5f6f3" ] } ] } [/block] You will notice the reports for each Deal you've setup in Rubicon. It shows the bid request and responses received for each of the deal. In this case, Bid Requests and responses refer to bidding activity from Rubicon to Polymorph. If you see 0 Bid Requests, that means there could be some issue in the setup of the deal above, most likely with the targeting. Either it could be incorrectly targeted or you may not have inventory for the selected targeting. If Bid requests number is > 0, but Bid Responses is 0 thats means there is something wrong with the setup at the DSP you are working with or they might have incorrect Rubicon Deal Token as configured in above step 1.