From 7ba94e10e4f43274e307c26c4e5918b945f2f607 Mon Sep 17 00:00:00 2001 From: takahiro kaji Date: Tue, 16 Apr 2024 13:41:40 +0900 Subject: [PATCH 1/2] add burl --- version2.en.md | 11 +++++- version2.res-examples.md | 83 ++++++++++++++++++++++++++++++++++++++++ 2 files changed, 93 insertions(+), 1 deletion(-) diff --git a/version2.en.md b/version2.en.md index 0284bb0..f5383e1 100644 --- a/version2.en.md +++ b/version2.en.md @@ -264,7 +264,7 @@ Serialization format: JSON only. 0=no, 1=yes - bidfloor + bidfloorx float Floor price @@ -1469,6 +1469,13 @@ HTTP 204 No Content is expected for no bid. Substituting macros may be included. + + burl + string + + Billing notice URL called by the server if the bid wins the auction and imp records. Auction price macros ( {$AUCTION_PRICE} ) must be included. + + dur integer @@ -1637,6 +1644,7 @@ The following assumptions are made about URLs which serve beacons: adm nurl lurl + burl ${CLICK_URL_ENC} @@ -1695,6 +1703,7 @@ The following assumptions are made about URLs which serve beacons: Yes Yes Yes + Yes ${AUCTION_PRICE_IV} diff --git a/version2.res-examples.md b/version2.res-examples.md index 53f6014..d7b1885 100644 --- a/version2.res-examples.md +++ b/version2.res-examples.md @@ -5,6 +5,7 @@ * [Video/Audio](#videoaudio) * [With dealid](#with-dealid) * [With nurl and lurl](#with-nurl-and-lurl) +* [With_burl](#with-burl) * [With bundle](#with-bundle) * [With SKAdNetwork Response Object](#with-skadnetwork-response-object) @@ -160,6 +161,38 @@ } ``` +### With burl + +```json +{ + "cur": "USD", + "id": "0000fbb5-0000-4218-8551-4ea553000000", + "seatbid": [ + { + "bid": [ + { + "adid": "40734", + "adm": "
\"\"
", + "adomain": [ + "ecnavi.jp" + ], + "cid": "75580", + "crid": "40734", + "h": 250, + "id": "0", + "impid": "00007d85-89e3-41e9-9e09-96e3a5000000", + "language": "ja", + "burl": "https://example.com/?clearing_price=${AUCTION_PRICE}", + "mtype": 1, + "price": 0.014828, + "w": 300 + } + ] + } + ] +} +``` + ### With bundle ```json @@ -191,6 +224,56 @@ } ] } + +{ + "cur": "JPY", + "id": "5b8cd76b-3802-4cf1-a8ab-4e0d18feeaa1.9DA9", + "seatbid": [ + { + "bid": [ + { + "adm": "\"", + "adomain": [ + "amazon.co.jp" + ], + "burl": "https://ghent-gce-jp.bidswitch.net/win_notice/fluct_basic_bid?rid=Oup72PsW-Krd6lCAKjm4g0Il_XegIo_PRDXlWCyTvl6l45rvszIUksoQgrYoObkG3qg6eJ5GcwE2m5L5Bqf8rUhRDH5GLyIjg5O17uvozcObDJj0Cc3jNHR-wqT7VMY7jR1pbxbDB508sc8VR7DoRbksWwlNFWTa_v7gd3F9lddpU_XIozY3wwYbNJx1QV0XnFBQKJ_0x0Qmq9i3-4OUXvew-DB6uLoQ-PL6sub0SnfaTwcAAo8DptOlACHpVFabMN38vacJSLrgh_WQ7KMUyJrRzYnIVtjWTguuh17HUw3Hu2qvQiAkA8ciJi7dak0nccDv6VxYcf0bLWdJ5R8nSyC39_rb1BysnLzyTGEMREPfPx8-Sx6kA8K32WBJBcTX8TIOa3YWoQ_eMwF86SFxY28_0QimyVWnEp1dIvUGsCJVEgrCzDAeFMmAPUxP5P72e3MUPo55-AXivWmgfgKXbxbEPcFGsAiPfn93YtSsrGCnQAdxjVibcMl3XB5rO3ezPQ70NPJpjxW-UinYeR9sE7O6Lk6BDpMMNJtgbHTP8g-0noJAGgItw1dhlonoSr_mjG4S5xek4zbd_cgpBVs9aJMT8SKpfAEMcErZ14604EdnexB4GiFyNPzYouxRWvV_UfklO1jzbAjxpi4IkL0ZlvPDDlp_GV_RUTozV2t2f2hCDNk4HxAFXPFFkDtq4lKXv4YjMlB9CQXuz9i8YmNQqErw37A-2zdhjPOpmoneBf96-0-HzrRGv7k3o5EesKWBsYfLtjJFWNyuDC2lBXTmGFBPYLE5JUFWn5EIbiOPS02bJpBMlsneNVlw27FjY2OZL1MM5NO4wQ9wJi0JTvAEqKRi64lI4O3cPzYBszo2Rs72S3tkjN5Yh5rr3Em4s_z_DUTsB94ocKYOSplmEmyUf_wlmejiuNwKZ1oRT4sOZVcI5S0oGcwavntu64VDvm_CnB9Wdlvh1H0kz5M4siJyOFz2_NHLp3StK3DvjDRSqBmIs557gOMoiII5RH6zy-M3PpkAy4GVov3u_gqyCaBNNMBFIwRKPZh7Vuwe6zbgkVMFKTkI-nsIWB1RaBlvGZMjI5YsjLHBy02-Lv8FrY_fFcoDBxwLNiu4tthnct9Dpyet_19pReCZvRhx1oeKyj7XRhe8D2hyBI1CSW7idRkUib2i0cFHE7FdCjRygWySp_GcsjPu42X1Tzu4T5pyBFA8BID46W0AKool93_CjVNy8-O7cEm958Bne4d7zvHYSLTmgbr7bMQak77NUvOaBp111FOSG0pkQAc&p=${AUCTION_PRICE}&aid=", + "cat": [ + "IAB18-5" + ], + "cid": "591323876757526154", + "crid": "200_591323876757526154", + "h": 250, + "id": "200-4fc0d5d4_5b8cd76b-3802-4cf1-a8ab-4e0d18feeaa1.9DA9-1", + "impid": "8526ede4-253c-406e-a000-120df60b3620", + "iurl": "https://aax-fe-sin.amazon-adsystem.com/e/or/2fdf62ab27c1174e7ef53f260727f8be/impi?cp=1&ci=EAAYACogEQ3h91UgTIHQE3wUs26dwMRl0PrFKa.2DnMz0wIiMLkyBARUETE_&s=300x250", + "price": null, + "w": 300 + }, + { + "adm": "\"", + "adomain": [ + "anuashop.jp" + ], + "burl": "https://ghent-gce-jp.bidswitch.net/win_notice/fluct_basic_bid?rid=monYmizLp9Jg2t6Pysu1zFgO9ZBcpFP5Mt3T1IEhU3zMFEbaNYyObILO18ybYKCgyTbBdpT5sIXZGFtjOepmsq6JkOZYfvvyF6AbSXNCznJGVpWokU5sAmb5d7_LdVwPu91WhMujc0gKvsBLVf_APz8YOXDd-7Tu4ZR4UItITIGVadj6L9C4VufV6E8Vwi3cpQpUlyjkTja9izsWWaenFXvHSn2ww1SmCpIdHvm6pS9IMHYD77ySYL_y0OwlDpg7MVzqAHf_JecQV50jkZ27GlyzEALpk3bpcPbKxUIfkxmALOeThCWyrwIWgE11gEsRBZDTRIB0sVAy9TKGGhd4SV2uprNesl8CFoBBjm8xWQ_zqcGJ99Uxrz85p88xF_fmf_0mVsM44MEsGMNL20TiIiKY6k9p7vHpGIBe5htY1Zb9fF5omxxaKkPyPR-MRZLk3PpKO8Bxc_JP5DoAoyzzEORzzMZ3pRZGvykLp0ha2mtV7z3yVUl-HLM6mNEhDn-9zBRr55jSBKZw2oylz0oBYBmicDiQvocKWOLPKovfIuXWlGZgUXdFBYGqmnzscYUaDuMLNlByHJoXU8O-NWzvCROY2JKtZoRVvNE1pgN8P8z0JmEzNlRZZb1YhS_QK6Wnh_PvQ5WUvDRk0KQs3E376O-NS7OkJbbRiTRApirXA67Kc5mWp8qVOJIauvb2LSA2YKvx1cmMTD6avg-QBuaoUK6xPzArLkgKdEnZG8jSOAd-8xKxlbaPlCDAJfobTJxO8MfFa6xXoeswFjRXh9odLPI_zCTxfddXzfBmytrMErj8b_7_6vfi3ipguT7KN8SuPTDTMggsufIeQHZJAEISnyaLt80GGXLRvMGjFMcolCUB8XpA-jxjbeuMzwQG3eRUuUKUiW9-2C-wjoFNNnHSyQUTdsRL4A9LnLifay8Fn0s4xSkJAAlh185qn7ut3GGoIQF_bzYFJtpQ-h8IPawvYS4_pKK7qCBHvg852gnNr4NvjLDTN9vXnXaTMuokN-FNQ5mhWwCGSV5hwK519bYI6mXJ6uvUvsUShAE5mHLxhAGDKf2wC3G9neXKEj_bIxcbKz-4FGNo_9oeENkmq3m-i6aX1A3W7QegpdikwfNUMH_xsjdQ9cpS5P5P9FSb4Slmt8QcntUvJzwTr4gxal6yS4m_vqRqthKO1l928OLfmqHDfvASvdB8w0kS2Q_yf6nylT560zPU_XQHH6hASL4tBlyFWsaaE12YEu0Kab8e5y2DmX2UaGsYnArR724l9h-RPrgmByQWcw&p=${AUCTION_PRICE}&aid=", + "cat": [ + "IAB18-3" + ], + "cid": "588043668477759050", + "crid": "200_588043668477759050", + "h": 250, + "id": "200-4fc0d5d4_5b8cd76b-3802-4cf1-a8ab-4e0d18feeaa1.9DA9-2", + "impid": "8526ede4-253c-406e-a000-120df60b3620", + "iurl": "https://aax-fe-sin.amazon-adsystem.com/e/or/2fdf62ab27c1174e7ef53f260727f8be/impi?cp=1&ci=EAAYACogJC.NFbAIP0imHaGH.Xui8-ham7QudeXf3oy6OB.qD50yBGIP428_&s=300x250", + "price": null, + "w": 300 + } + ], + "seat": "200" + } + ] +} + + ``` ```json From 430bb0f9a477a6ebe1f787005816acd94320c911 Mon Sep 17 00:00:00 2001 From: takahiro kaji Date: Tue, 16 Apr 2024 13:45:24 +0900 Subject: [PATCH 2/2] . --- version2.en.md | 2 +- version2.res-examples.md | 50 ---------------------------------------- 2 files changed, 1 insertion(+), 51 deletions(-) diff --git a/version2.en.md b/version2.en.md index f5383e1..938eba1 100644 --- a/version2.en.md +++ b/version2.en.md @@ -264,7 +264,7 @@ Serialization format: JSON only. 0=no, 1=yes - bidfloorx + bidfloor float Floor price diff --git a/version2.res-examples.md b/version2.res-examples.md index d7b1885..cc0b29f 100644 --- a/version2.res-examples.md +++ b/version2.res-examples.md @@ -224,56 +224,6 @@ } ] } - -{ - "cur": "JPY", - "id": "5b8cd76b-3802-4cf1-a8ab-4e0d18feeaa1.9DA9", - "seatbid": [ - { - "bid": [ - { - "adm": "\"", - "adomain": [ - "amazon.co.jp" - ], - "burl": "https://ghent-gce-jp.bidswitch.net/win_notice/fluct_basic_bid?rid=Oup72PsW-Krd6lCAKjm4g0Il_XegIo_PRDXlWCyTvl6l45rvszIUksoQgrYoObkG3qg6eJ5GcwE2m5L5Bqf8rUhRDH5GLyIjg5O17uvozcObDJj0Cc3jNHR-wqT7VMY7jR1pbxbDB508sc8VR7DoRbksWwlNFWTa_v7gd3F9lddpU_XIozY3wwYbNJx1QV0XnFBQKJ_0x0Qmq9i3-4OUXvew-DB6uLoQ-PL6sub0SnfaTwcAAo8DptOlACHpVFabMN38vacJSLrgh_WQ7KMUyJrRzYnIVtjWTguuh17HUw3Hu2qvQiAkA8ciJi7dak0nccDv6VxYcf0bLWdJ5R8nSyC39_rb1BysnLzyTGEMREPfPx8-Sx6kA8K32WBJBcTX8TIOa3YWoQ_eMwF86SFxY28_0QimyVWnEp1dIvUGsCJVEgrCzDAeFMmAPUxP5P72e3MUPo55-AXivWmgfgKXbxbEPcFGsAiPfn93YtSsrGCnQAdxjVibcMl3XB5rO3ezPQ70NPJpjxW-UinYeR9sE7O6Lk6BDpMMNJtgbHTP8g-0noJAGgItw1dhlonoSr_mjG4S5xek4zbd_cgpBVs9aJMT8SKpfAEMcErZ14604EdnexB4GiFyNPzYouxRWvV_UfklO1jzbAjxpi4IkL0ZlvPDDlp_GV_RUTozV2t2f2hCDNk4HxAFXPFFkDtq4lKXv4YjMlB9CQXuz9i8YmNQqErw37A-2zdhjPOpmoneBf96-0-HzrRGv7k3o5EesKWBsYfLtjJFWNyuDC2lBXTmGFBPYLE5JUFWn5EIbiOPS02bJpBMlsneNVlw27FjY2OZL1MM5NO4wQ9wJi0JTvAEqKRi64lI4O3cPzYBszo2Rs72S3tkjN5Yh5rr3Em4s_z_DUTsB94ocKYOSplmEmyUf_wlmejiuNwKZ1oRT4sOZVcI5S0oGcwavntu64VDvm_CnB9Wdlvh1H0kz5M4siJyOFz2_NHLp3StK3DvjDRSqBmIs557gOMoiII5RH6zy-M3PpkAy4GVov3u_gqyCaBNNMBFIwRKPZh7Vuwe6zbgkVMFKTkI-nsIWB1RaBlvGZMjI5YsjLHBy02-Lv8FrY_fFcoDBxwLNiu4tthnct9Dpyet_19pReCZvRhx1oeKyj7XRhe8D2hyBI1CSW7idRkUib2i0cFHE7FdCjRygWySp_GcsjPu42X1Tzu4T5pyBFA8BID46W0AKool93_CjVNy8-O7cEm958Bne4d7zvHYSLTmgbr7bMQak77NUvOaBp111FOSG0pkQAc&p=${AUCTION_PRICE}&aid=", - "cat": [ - "IAB18-5" - ], - "cid": "591323876757526154", - "crid": "200_591323876757526154", - "h": 250, - "id": "200-4fc0d5d4_5b8cd76b-3802-4cf1-a8ab-4e0d18feeaa1.9DA9-1", - "impid": "8526ede4-253c-406e-a000-120df60b3620", - "iurl": "https://aax-fe-sin.amazon-adsystem.com/e/or/2fdf62ab27c1174e7ef53f260727f8be/impi?cp=1&ci=EAAYACogEQ3h91UgTIHQE3wUs26dwMRl0PrFKa.2DnMz0wIiMLkyBARUETE_&s=300x250", - "price": null, - "w": 300 - }, - { - "adm": "\"", - "adomain": [ - "anuashop.jp" - ], - "burl": "https://ghent-gce-jp.bidswitch.net/win_notice/fluct_basic_bid?rid=monYmizLp9Jg2t6Pysu1zFgO9ZBcpFP5Mt3T1IEhU3zMFEbaNYyObILO18ybYKCgyTbBdpT5sIXZGFtjOepmsq6JkOZYfvvyF6AbSXNCznJGVpWokU5sAmb5d7_LdVwPu91WhMujc0gKvsBLVf_APz8YOXDd-7Tu4ZR4UItITIGVadj6L9C4VufV6E8Vwi3cpQpUlyjkTja9izsWWaenFXvHSn2ww1SmCpIdHvm6pS9IMHYD77ySYL_y0OwlDpg7MVzqAHf_JecQV50jkZ27GlyzEALpk3bpcPbKxUIfkxmALOeThCWyrwIWgE11gEsRBZDTRIB0sVAy9TKGGhd4SV2uprNesl8CFoBBjm8xWQ_zqcGJ99Uxrz85p88xF_fmf_0mVsM44MEsGMNL20TiIiKY6k9p7vHpGIBe5htY1Zb9fF5omxxaKkPyPR-MRZLk3PpKO8Bxc_JP5DoAoyzzEORzzMZ3pRZGvykLp0ha2mtV7z3yVUl-HLM6mNEhDn-9zBRr55jSBKZw2oylz0oBYBmicDiQvocKWOLPKovfIuXWlGZgUXdFBYGqmnzscYUaDuMLNlByHJoXU8O-NWzvCROY2JKtZoRVvNE1pgN8P8z0JmEzNlRZZb1YhS_QK6Wnh_PvQ5WUvDRk0KQs3E376O-NS7OkJbbRiTRApirXA67Kc5mWp8qVOJIauvb2LSA2YKvx1cmMTD6avg-QBuaoUK6xPzArLkgKdEnZG8jSOAd-8xKxlbaPlCDAJfobTJxO8MfFa6xXoeswFjRXh9odLPI_zCTxfddXzfBmytrMErj8b_7_6vfi3ipguT7KN8SuPTDTMggsufIeQHZJAEISnyaLt80GGXLRvMGjFMcolCUB8XpA-jxjbeuMzwQG3eRUuUKUiW9-2C-wjoFNNnHSyQUTdsRL4A9LnLifay8Fn0s4xSkJAAlh185qn7ut3GGoIQF_bzYFJtpQ-h8IPawvYS4_pKK7qCBHvg852gnNr4NvjLDTN9vXnXaTMuokN-FNQ5mhWwCGSV5hwK519bYI6mXJ6uvUvsUShAE5mHLxhAGDKf2wC3G9neXKEj_bIxcbKz-4FGNo_9oeENkmq3m-i6aX1A3W7QegpdikwfNUMH_xsjdQ9cpS5P5P9FSb4Slmt8QcntUvJzwTr4gxal6yS4m_vqRqthKO1l928OLfmqHDfvASvdB8w0kS2Q_yf6nylT560zPU_XQHH6hASL4tBlyFWsaaE12YEu0Kab8e5y2DmX2UaGsYnArR724l9h-RPrgmByQWcw&p=${AUCTION_PRICE}&aid=", - "cat": [ - "IAB18-3" - ], - "cid": "588043668477759050", - "crid": "200_588043668477759050", - "h": 250, - "id": "200-4fc0d5d4_5b8cd76b-3802-4cf1-a8ab-4e0d18feeaa1.9DA9-2", - "impid": "8526ede4-253c-406e-a000-120df60b3620", - "iurl": "https://aax-fe-sin.amazon-adsystem.com/e/or/2fdf62ab27c1174e7ef53f260727f8be/impi?cp=1&ci=EAAYACogJC.NFbAIP0imHaGH.Xui8-ham7QudeXf3oy6OB.qD50yBGIP428_&s=300x250", - "price": null, - "w": 300 - } - ], - "seat": "200" - } - ] -} - - ``` ```json