{"id":"5429beef1163360800ed31fa","name":"Polymorph","subdomain":"antest","versions":[{"_id":"5429beef1163360800ed31fd","releaseDate":"2014-09-29T20:19:59.904Z","is_deprecated":false,"is_hidden":false,"is_beta":false,"is_stable":true,"codename":"","version_clean":"1.0.0","version":"1.0"}],"current_version":{"version_clean":"1.0.0","version":"1.0"},"oauth":{"enabled":false},"api":{"name":"","url":"https://api.adsnative.com","contenttype":"form","auth":"","explorer":false,"proxyEnabled":true,"jwt":false,"authextra":[],"headers":[],"object_definitions":[]},"apiAlt":[{"_id":"57762cbbd44a3e0e00329d68","object_definitions":[],"headers":[],"authextra":[],"jwt":false,"proxyEnabled":true,"explorer":false,"auth":"","contenttype":"form","url":"https://bevo.adsnative.com","name":"bevo"},{"_id":"57aba40454fa780e006c5437","object_definitions":[],"headers":[],"authextra":[{"_id":"57aba479f68f6e1900a8abb6","type":"header","default":"","key":"Authorization: Bearer"}],"jwt":false,"proxyEnabled":true,"explorer":false,"auth":"token","contenttype":"form","url":"https://console.getpolymorph.com/api","name":"Console"},{"_id":"59c57f5ceb1ccd001c8e95ef","object_definitions":[],"headers":[],"authextra":[],"jwt":false,"proxyEnabled":true,"explorer":true,"auth":"","contenttype":"form","url":"","name":"Audience Segments"}],"plan_details":{"name":"Developer Hub","is_active":true,"cost":59,"versions":10000,"custom_domain":true,"custom_pages":true,"whitelabel":false,"errors":false,"password":true,"landing_page":true,"stylesheet":true,"javascript":false,"html":true,"extra_html":false,"admins":true},"intercom":"","intercom_secure_emailonly":false,"flags":{"allow_hub2":false,"hub2":false,"migrationRun":true,"oauth":false,"swagger":false,"correctnewlines":false,"speedyRender":false,"allowXFrame":false,"jwt":false,"hideGoogleAnalytics":false,"stripe":false,"disableDiscuss":false,"newApiExplorer":false,"ssl":false,"autoSslGeneration":true},"asset_base_url":""}

{"_id":"55e8b59ef0f1850d00d24a63","githubsync":"","parentDoc":null,"project":"5429beef1163360800ed31fa","__v":5,"user":"55e74aae73169617001f2e78","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":"5603738d0c78b00d0039af47","project":"5429beef1163360800ed31fa","pages":["561311eb41a9ec0d00a3fdf8","56958542cb14e11700f8a86e","56ad90e50c1cab0d009f658b"],"version":"5429beef1163360800ed31fd","__v":3,"sync":{"url":"","isSync":false},"reference":false,"createdAt":"2015-09-24T03:52:45.801Z","from_sync":false,"order":5,"slug":"exchange","title":"Marketplace"},"updates":[],"next":{"pages":[],"description":""},"createdAt":"2015-09-03T21:03:26.745Z","link_external":false,"link_url":"","sync_unique":"","hidden":false,"api":{"results":{"codes":[]},"settings":"","auth":"required","params":[],"url":""},"isReference":false,"order":3,"body":"**Overview**\n\nTo build an association between Polymorph cookies and DSP cookies, Polymorph provides a simple cookie matching service and hosted match table for clients.\n\n**1. Components**\n\nThe main components of the cookie match are:\n\nPolymorph match URL endpoint (ANcm): https://rudy.adsnative.com/cm.gif\n\nDSP-provided match URL endpoint (DSPcm): https://ads.dsp.com/cookie.gif\nCookie matching is implemented through 302 redirects between ANcm and DSPcm\n\n**2. Parameters**\n\nThe following parameters may be attached to ANcm:\n\n[block:parameters]\n{\n  \"data\": {\n    \"h-0\": \"Parameters\",\n    \"h-1\": \"Description\",\n    \"0-0\": \"dspid (required)\",\n    \"0-1\": \"DSP Identifier - Assigned by Polymorph\",\n    \"1-0\": \"buid (required)\",\n    \"1-1\": \"DSP User Cookie ID\",\n    \"2-0\": \"rurl (optional)\",\n    \"2-1\": \"Redirect URL - only allowed for smode=2\",\n    \"3-0\": \"smode\",\n    \"3-1\": \"Sync Mode (int) \\n\\n1 = Polymorph pings DSPcm to sync. [Default] \\n2 = DSPs initiates cookie syncing and pings ANcm\"\n  },\n  \"cols\": 2,\n  \"rows\": 4\n}\n[/block]\n**3. Sync Modes**\n\nTo provide flexibility for clients, Polymorph cookie matching services can be accessed with two modes:\n\n**SMODE 1** : Default On request from Polymorph publisher sites, Polymorph will ping DSPcm to initiate cookie sync.\n\n  * ANcm will be served on all Polymorph publisher sites. \n  \n  * When a user visits the publisher’s site, Polymorph issues a 302 redirect to the DSPcm. \n  \n  * If there exists a DSP cookie id, the DSP should 302 redirect back to ANcm with the following arguments:\n  \n  dspid - DSP identifier on the Polymorph Marketplace [Provided by Polymorph]\n  buid - DSP’s user cookie id \n  https://rudy.adsnative.com/cm.gif?dspid=1234&buid=HJPK4VSL \n  Polymorph will then serve a 1x1 gif pixel on user’s browser.\n\n**SMODE 2** : When user visits a demand partner’s sites, DSPs can ping ANcm to initiate cookie sync.\n\n* For use when cookie syncing directly from an advertiser websites. \n\n* When a user visits any website that the DSP is tracking users on, the DSP should issue a \n\n302 redirect to ANcm with the:\ndspid\nbuid\nsmode=2\nrurl [optional]: DSP may pass an additional rurl parameter to specify an url-encoded redirect URL that Polymorph will issue when cookie sync is completed. \n\nPolymorph redirect to rurl defined. If no rurl is provided, Polymorph will return a 1x1 transparent pixel to the user’s browser.\n\nFor example:\n[block:code]\n{\n  \"codes\": [\n    {\n      \"code\": \"https://rudy.adsnative.com/cm.gif?smode=2&dspid=1234&buid=HJPK4VSL&rurl=http%3A//ad.dsp.com/match.gif\",\n      \"language\": \"curl\"\n    }\n  ]\n}\n[/block]\n**4. OpenRTB Integration**\n\nCookie sync is used in conjunction with the Polymorph RTB Exchange: The bid request object will contain both the Polymorph User ID, provided in the User.id field, and the matched DSP Cookie ID, provided in the User.buyeruid field.","excerpt":"Here are the specs for Polymorph's Polymorph Cookie Sync","slug":"cookie-sync","type":"basic","title":"Cookie Sync"}

Cookie Sync

Here are the specs for Polymorph's Polymorph Cookie Sync

**Overview** To build an association between Polymorph cookies and DSP cookies, Polymorph provides a simple cookie matching service and hosted match table for clients. **1. Components** The main components of the cookie match are: Polymorph match URL endpoint (ANcm): https://rudy.adsnative.com/cm.gif DSP-provided match URL endpoint (DSPcm): https://ads.dsp.com/cookie.gif Cookie matching is implemented through 302 redirects between ANcm and DSPcm **2. Parameters** The following parameters may be attached to ANcm: [block:parameters] { "data": { "h-0": "Parameters", "h-1": "Description", "0-0": "dspid (required)", "0-1": "DSP Identifier - Assigned by Polymorph", "1-0": "buid (required)", "1-1": "DSP User Cookie ID", "2-0": "rurl (optional)", "2-1": "Redirect URL - only allowed for smode=2", "3-0": "smode", "3-1": "Sync Mode (int) \n\n1 = Polymorph pings DSPcm to sync. [Default] \n2 = DSPs initiates cookie syncing and pings ANcm" }, "cols": 2, "rows": 4 } [/block] **3. Sync Modes** To provide flexibility for clients, Polymorph cookie matching services can be accessed with two modes: **SMODE 1** : Default On request from Polymorph publisher sites, Polymorph will ping DSPcm to initiate cookie sync. * ANcm will be served on all Polymorph publisher sites. * When a user visits the publisher’s site, Polymorph issues a 302 redirect to the DSPcm. * If there exists a DSP cookie id, the DSP should 302 redirect back to ANcm with the following arguments: dspid - DSP identifier on the Polymorph Marketplace [Provided by Polymorph] buid - DSP’s user cookie id https://rudy.adsnative.com/cm.gif?dspid=1234&buid=HJPK4VSL Polymorph will then serve a 1x1 gif pixel on user’s browser. **SMODE 2** : When user visits a demand partner’s sites, DSPs can ping ANcm to initiate cookie sync. * For use when cookie syncing directly from an advertiser websites. * When a user visits any website that the DSP is tracking users on, the DSP should issue a 302 redirect to ANcm with the: dspid buid smode=2 rurl [optional]: DSP may pass an additional rurl parameter to specify an url-encoded redirect URL that Polymorph will issue when cookie sync is completed. Polymorph redirect to rurl defined. If no rurl is provided, Polymorph will return a 1x1 transparent pixel to the user’s browser. For example: [block:code] { "codes": [ { "code": "https://rudy.adsnative.com/cm.gif?smode=2&dspid=1234&buid=HJPK4VSL&rurl=http%3A//ad.dsp.com/match.gif", "language": "curl" } ] } [/block] **4. OpenRTB Integration** Cookie sync is used in conjunction with the Polymorph RTB Exchange: The bid request object will contain both the Polymorph User ID, provided in the User.id field, and the matched DSP Cookie ID, provided in the User.buyeruid field.