इस गाइड में, आरटीबी से जुड़ी समस्या हल करने वाले संसाधनों के बारे में बताया गया है. इनकी मदद से, रीयल-टाइम बिडिंग वाले कैंपेन की मेट्रिक को प्रोग्राम के हिसाब से ऐक्सेस किया जा सकता है. ये मेट्रिक, Authorized Buyers यूज़र इंटरफ़ेस (यूआई) में मिलने वाले आरटीबी ब्रेकआउट टूल की मदद से भी दिखाई जाती हैं. इनमें bidders.filterSets
, bidders.accounts.filterSets
, और
इनके तहत आने वाले सभी रिसॉर्स शामिल हैं.
आरटीबी समस्या को हल करने वाले संसाधनों की मेट्रिक का इस्तेमाल करके, इंप्रेशन पाने के उन अवसरों के बारे में अहम जानकारी हासिल की जा सकती है जिन्हें आपने नहीं देखा है. इससे आपको रीयल-टाइम बिडिंग वाले कैंपेन को ऑप्टिमाइज़ करने में मदद मिल सकती है.
एपीआई स्ट्रक्चर और स्टाइल में किए गए बदलाव
आरटीबी की समस्या हल करने वाले संसाधनों में कुछ बदलाव किए गए हैं. इनमें मालिकाना हक और ऐक्सेस के बारे में साफ़ तौर पर बताया गया है. साथ ही, एपीआई से लौटाए गए डेटा पर ज़्यादा कंट्रोल मिलता है और Google API डिज़ाइन के तरीकों के साथ बेहतर तरीके से अलाइन किया गया है.
बिडर-लेवल और खाता-लेवल के संसाधन
संसाधन को bidders
और bidders.accounts
, दोनों के हिसाब से बनाया गया है. इनकी मदद से,
यह तय किया जा सकता है कि कोई एपीआई कॉल, बिड करने वाले (जिसे पैरंट खाता भी कहा जाता है) और इससे जुड़े सभी चाइल्ड खातों को टारगेट कर रहा है या व्यक्तिगत Authorized Buyers खाते. आरटीबी समस्या को हल करने के लिए, bidders.filterSets
के तहत बनाए गए संसाधन, बिड करने वाले व्यक्ति और उससे जुड़े सभी चाइल्ड खातों के लिए एग्रीगेट की गई मेट्रिक दिखाएंगे. वहीं दूसरी ओर,
bidders.accounts.filterSets
से कम उम्र वाले उपयोगकर्ता, सिर्फ़ तय किए गए खाते के लिए मेट्रिक दिखाएंगे.
भले ही, वह बिड करने वाला हो या चाइल्ड खाता.
ध्यान दें: जिन खातों से बिडिंग का ऐक्सेस किसी अन्य खरीदार को मिलता है वे बिड करने वाले खाते नहीं होते. इसलिए, इनकी वजह से बिडर-लेवल के संसाधनों को ऐक्सेस नहीं किया जा सकता. इसके अलावा, बिड न करने वाले खाते, खाता-लेवल के impressionMetrics
, filteredBidResponses
, bidResponseErrors
, और
bidResponsesWithoutBids
संसाधनों को ऐक्सेस नहीं कर सकते.
पेश हैं संसाधनों के नाम, यूनीक आइडेंटिफ़ायर के तौर पर
संसाधन के नाम का इस्तेमाल, पूर्णांक या स्ट्रिंग आईडी के बजाय, यूनीक आइडेंटिफ़ायर के तौर पर किया जाता है. किसी दिए गए रिसॉर्स टाइप का नया इंस्टेंस बनाते समय, अब आपको एक रिलेटिव रिसॉर्स का नाम बताना होगा. इसके लिए, आपको संसाधन के यूआरआई पाथ के बाद, पसंदीदा रिसॉर्स आईडी का इस्तेमाल करना होगा. आरटीबी समस्या हल करने वाले संसाधनों के लिए, काम के नामों के उदाहरण यहां दिए गए हैं:
संसाधन | नाम का उदाहरण |
---|---|
bidders.filterSets | bidders/12345678/filterSets/fset_1 |
bidders.accounts.filterSets | bidders/12345678/accounts/87654321/filterSets/fset_2 |
ध्यान दें: नाम में bidders
के लिए दिया गया रिसॉर्स आईडी, बिड करने वाले के
Authorized Buyers खाता आईडी होना चाहिए. accounts
के लिए, रिसॉर्स आईडी
बिड करने वाले या उससे मैनेज होने वाले किसी चाइल्ड खाते का खाता आईडी होना चाहिए. अगर आपको नहीं पता कि आपके Google खाते से कौनसे Authorized Buyers
खाते जुड़े हैं, तो उन्हें ढूंढने के लिए
accounts.list तरीके का इस्तेमाल किया जा सकता है.
फ़िल्टर के सेट
फ़िल्टर सेट, उपलब्ध फ़िल्टर करने के विकल्पों को दिखाता है. इन्हें बिडिंग करने वाले या खाता लेवल पर बनाया जा सकता है. इसका इस्तेमाल, आरटीबी की समस्या हल करने वाले संसाधनों की सूची के नतीजों को फ़िल्टर करने के लिए किया जाता है. ये वे संसाधन होते हैं जो रीयल-टाइम बिडिंग वाले कैंपेन की मेट्रिक हासिल करते हैं.
मेट्रिक को फिर से पाने के दौरान लागू किया गया फ़िल्टर, तय किए गए फ़िल्टर सेट में मौजूद हर फ़िल्टर का इंटरसेक्शन होता है. सूची के फ़िल्टर, जैसे कि platforms
को सूची के हर आइटम के यूनियन के तौर पर देखा जाता है.
बिडिंग करने वाले और खाता-लेवल के फ़िल्टर सेट अलग-अलग होते हैं और उन्हें सिर्फ़ उसी लेवल से ऐक्सेस किया जा सकता है जिस लेवल पर उन्हें बनाया गया था. इससे कोई फ़र्क़ नहीं पड़ता कि उन्हें बनाने के लिए किस खाते का इस्तेमाल किया गया है. बिड करने वाला और चाइल्ड खाता शेयर वाले फ़िल्टर सेट, जिन्हें खाता लेवल पर बनाया जाता है. वहीं, बिड करने वाला व्यक्ति ही बिडर के लेवल पर संसाधनों को ऐक्सेस कर सकता है. इस टेबल में बताया गया है कि बिड करने वाले और चाइल्ड खाते, किस तरह से किसी भी लेवल पर संसाधनों को ऐक्सेस कर सकते हैं:
bidders.filterSets | bidders.accounts.filterSets | |
---|---|---|
बिड करने वाले का खाता | सिर्फ़ बिडर-लेवल के फ़िल्टर के सेट पर असर डालने वाली एपीआई कॉल. | सिर्फ़ खाता-लेवल के फ़िल्टर के सेट पर असर डालने वाली एपीआई कॉल. |
चाइल्ड खाता | यह एपीआई कॉल, गड़बड़ी का जवाब देगा. | सिर्फ़ खाता-लेवल के फ़िल्टर के सेट पर असर डालने वाली एपीआई कॉल. |
फ़िल्टर का सेट बनाएं
फ़िल्टर सेट बनाते समय, आपको relativeDateRange
, absoluteDateRange
या realtimeTimeRange
के तौर पर समयसीमा तय करनी होगी. मेट्रिक को फिर से पाने का डिफ़ॉल्ट तरीका, पूरी समयसीमा के लिए दिया गया सारा डेटा है. अगर आपको किसी समयसीमा के दौरान टाइम सीरीज़ का ब्रेकडाउन देखना है, तो HOURLY
या DAILY
इंटरवल दिखाने के लिए timeSeriesGranularity
तय करें.
अगर आपको सिर्फ़ कुछ समय के लिए फ़िल्टर सेट करने की ज़रूरत है, तो isTransient
क्वेरी पैरामीटर को true
पर सेट किया जा सकता है. इससे पता चलेगा कि फ़िल्टर सेट कुछ समय के लिए है. इसका मतलब है कि यह हमेशा के लिए नहीं बना रहेगा. अस्थायी फ़िल्टर सेट, बनने के बाद कम से कम एक घंटे तक उपलब्ध रहेंगे, लेकिन बाद में उन्हें मिटा दिया जाएगा. डिफ़ॉल्ट रूप से, फ़िल्टर सेट अस्थायी नहीं होते हैं.
बिडर-लेवल के हिसाब से उदाहरण
बिडर-लेवल का नया फ़िल्टर सेट बनाने के लिए, bidders.filterSets
रिसॉर्स यूआरआई को POST
अनुरोध भेजें, जिसका फ़ॉर्मैट नीचे दिया गया है:
https://adexchangebuyer.googleapis.com/v2beta1/bidders/{bidder resource ID}/filterSets
चेतावनी: बिडिंग लेवल के फ़िल्टर के सेट, क्रिएटिव या डील आईडी के आधार पर फ़िल्टर नहीं कर सकते. अगर आपने बिडर-लेवल का फ़िल्टर सेट बनाते समय ये फ़िल्टर इस्तेमाल किए हैं, तो आपको गड़बड़ी वाला जवाब मिलेगा.
अनुरोध करेंयहां POST
अनुरोध का एक उदाहरण दिया गया है, जो बिडर-लेवल का एक नया फ़िल्टर सेट बनाता है, जो ज़्यादा समय तक नहीं होता है:
POST https://adexchangebuyer.googleapis.com/v2beta1/bidders/12345678/filterSets Authorization: Bearer access token here Content-Type: application/json { "name": "bidders/12345678/filterSets/bidder-fs", "format": "DISPLAY", "environment": "APP", "platforms": ["TABLET", "MOBILE"], "absoluteDateRange": { "startDate": { "month": 11, "day": 26, "year": 2017 }, "endDate": { "month": 12, "day": 3, "year": 2017 } }, "timeSeriesGranularity": "DAILY" }जवाब
अगर अनुरोध पूरा हो जाता है, तो सर्वर जवाब में 200 OK का स्टेटस कोड दिखाता है. रिस्पॉन्स के मुख्य हिस्से में, बनाया गया फ़िल्टर सेट रिसॉर्स शामिल होगा, जो अनुरोध में सबमिट किए गए फ़िल्टर सेट जैसा होगा.
खाते के लेवल का उदाहरण
खाता-लेवल का एक नया फ़िल्टर सेट बनाने के लिए, bidders.accounts.filterSets
रिसॉर्स यूआरआई को POST
अनुरोध भेजें, जिसका फ़ॉर्मैट नीचे दिया गया है:
https://adexchangebuyer.googleapis.com/v2beta1/bidders/{bidder resource ID}/accounts/{account resource ID}/filterSets
ध्यान दें: accounts
के लिए दिया गया संसाधन आईडी, किसी भी Authorized Buyers खाते का खाता आईडी हो सकता है जिसे यूआरआई में तय किए गए, बिड करने वाले के खाते से ऐक्सेस किया जा सकता है. इसमें, बिड करने वाले का खाता भी शामिल है.
यहां POST
अनुरोध का एक उदाहरण दिया गया है, जो खाता-लेवल का एक नया फ़िल्टर सेट बनाता है, जो अस्थायी हो जाता है:
POST https://adexchangebuyer.googleapis.com/v2beta1/bidders/12345678/accounts/87654321/filterSets Authorization: Bearer access token here Content-Type: application/json { "name": "bidders/12345678/accounts/87654321/filterSets/account-fs", "format": "VIDEO", "environment": "WEB", "platforms": ["DESKTOP"], "absoluteDateRange": { "startDate": { "month": 11, "day": 26, "year": 2017 }, "endDate": { "month": 12, "day": 3, "year": 2017 } }, "timeSeriesGranularity": "DAILY" }जवाब
अगर अनुरोध पूरा हो जाता है, तो सर्वर जवाब में 200 OK का स्टेटस कोड दिखाता है. रिस्पॉन्स के मुख्य हिस्से में बनाया गया फ़िल्टर सेट रिसॉर्स शामिल होगा, जो अनुरोध में सबमिट किए गए फ़िल्टर सेट से मिलता-जुलता होगा.
फ़िल्टर का सेट पाएं
'पाएं' तरीके से, सिर्फ़ उसी लेवल पर फ़िल्टर सेट लिया जा सकता है जिसे बनाया गया था. उदाहरण के लिए, बिडिंग करने वाले
खाते को bidders.filterSets.get
तरीके के बजाय, खाता लेवल पर बनाए गए फ़िल्टर सेट को
फिर से पाने के लिए, bidders.accounts.filterSets.get
का इस्तेमाल करना चाहिए.
बिडर-लेवल
bidders.filterSets
रिसॉर्स यूआरआई को एचटीटीपी जीईटी अनुरोध भेजकर, बिडर-लेवल के किसी फ़िल्टर को फिर से सेट किया जा सकता है, जिसका फ़ॉर्मैट यहां दिया गया है:
GET https://adexchangebuyer.googleapis.com/v2beta1/bidders/{bidder resource ID}/filterSets/{filter set resource ID}अनुरोध करें
यहां एक उदाहरण दिया गया है:
GET https://adexchangebuyer.googleapis.com/v2beta1/bidders/12345678/filterSets/bidder-fsजवाब
अगर अनुरोध पूरा हो जाता है, तो सर्वर एक 200 OK
एचटीटीपी स्टेटस कोड और वापस मिले फ़िल्टर सेट के साथ जवाब देता है:
{ "name": "bidders/12345678/filterSets/bidder-fs", "format": "DISPLAY", "environment": "APP", "platforms": ["TABLET", "MOBILE"], "absoluteDateRange": { "startDate": { "month": 11, "day": 26, "year": 2017 }, "endDate": { "month": 12, "day": 3, "year": 2017 } }, "timeSeriesGranularity": "DAILY" }
खाता-लेवल
खाते के लेवल पर सेट किए गए फ़िल्टर को फिर से पाने के लिए, bidders.accounts.filterSets
रिसॉर्स यूआरआई को एचटीटीपी GET
अनुरोध भेजा जा सकता है, जिसका फ़ॉर्मैट नीचे दिया गया है:
GET https://adexchangebuyer.googleapis.com/v2beta1/bidders/{bidder resource ID}/accounts/{account resource ID}/filterSets/{filter set resource ID}अनुरोध करें
यहां एक उदाहरण दिया गया है:
GET https://adexchangebuyer.googleapis.com/v2beta1/bidders/12345678/accounts/87654321/filterSets/account-fsजवाब
अगर अनुरोध पूरा हो जाता है, तो सर्वर एक 200 OK
एचटीटीपी स्टेटस कोड और वापस मिले फ़िल्टर सेट के साथ जवाब देता है:
{ "name": "bidders/12345678/accounts/87654321/filterSets/account-fs", "format": "VIDEO", "environment": "WEB", "platforms": ["DESKTOP"], "absoluteDateRange": { "startDate": { "month": 11, "day": 26, "year": 2017 }, "endDate": { "month": 12, "day": 3, "year": 2017 } }, "timeSeriesGranularity": "DAILY" }
फ़िल्टर के सेट की सूची बनाएं
सूची वाला तरीका सिर्फ़ उस फ़िल्टर सेट को दिखाएगा जिसे उस लेवल से ऐक्सेस किया जा सकता है जिसे कॉल किया जा रहा है.
उदाहरण के लिए, बिडिंग करने वाले खाते को bidders.filterSets.list
को कॉल करने पर,
bidders.accounts.filterSets.create
से बनाए गए फ़िल्टर सेट नहीं दिखेंगे.
बिडर-लेवल
किसी बिड करने वाले के लिए, बिड करने वाले के लेवल के सभी फ़िल्टर सेट वापस पाए जा सकते हैं. इसके लिए, आपको bidders.filtersets
रिसॉर्स यूआरआई को एचटीटीपी GET
अनुरोध भेजना होगा, जिसका फ़ॉर्मैट इस तरह है:
GET https://adexchangebuyer.googleapis.com/v2beta1/bidders/{bidder resource ID}/filterSetsअनुरोध करें
यहां एक उदाहरण दिया गया है, जिसमें 12345678 खाता आईडी वाले बिडर के लिए, बिडर-लेवल के सभी फ़िल्टर के सेट लिस्ट किए गए हैं:
GET https://adexchangebuyer.googleapis.com/v2beta1/bidders/12345678/filterSetsजवाब
{ "filterSets": [{ "filterSetId": "99994", "name": "bidders/12345678/filterSets/test-b-1", "relativeDateRange": { "durationDays": 30 } }, { "realtimeTimeRange": { "startTimeStamp": "2017-11-15T12:30:30.072831583Z" }, "filterSetId": "99995", "name": "bidders/12345678/filterSets/test-b-2", "timeSeriesGranularity": "HOURLY" }, { "absoluteDateRange": { "endDate": { "day": 12, "month": 3, "year": 2017 }, "startDate": { "day": 26, "month": 11, "year": 2017 } }, "filterSetId": "99996", "name": "bidders/12345678/filterSets/bidder-fs", "timeSeriesGranularity": "DAILY", "platforms": ["TABLET", "MOBILE"], "environment": "APP", "format": "DISPLAY" } ] }
खाता-लेवल
किसी खाते के लिए खाता-लेवल के सभी फ़िल्टर सेट को वापस लाया जा सकता है. इसके लिए, आपको bidders.accounts.filtersets
रिसॉर्स यूआरआई को एचटीटीपी GET
अनुरोध भेजना होगा, जिसका फ़ॉर्मैट इस तरह है:
GET https://adexchangebuyer.googleapis.com/v2beta1/bidders/{bidder resource ID}/accounts/{account resource ID}/filterSetsअनुरोध करें
यहां एक उदाहरण दिया गया है, जिसमें 87654321 का खाता आईडी वाले चाइल्ड खाते के लिए, खाता-लेवल के सभी फ़िल्टर सेट लिस्ट किए गए हैं:
GET https://adexchangebuyer.googleapis.com/v2beta1/bidders/12345678/accounts/87654321/filterSetsजवाब
{ "filterSets": [{ "realtimeTimeRange": { "startTimeStamp": "2017-11-19T04:24:43.252893487Z" }, "filterSetId": "99997", "name": "bidders/12345678/accounts/87654321/filterSets/test-a-1", "timeSeriesGranularity": "DAILY" }, { "absoluteDateRange": { "endDate": { "day": 3, "month": 12, "year": 2017 }, "startDate": { "day": 26, "month": 11, "year": 2017 } }, "filterSetId": "99998", "name": "bidders/12345678/accounts/87654321/filterSets/account-fs", "timeSeriesGranularity": "DAILY", "platforms": ["DESKTOP"], "environment": "WEB", "format": "VIDEO" } ] }
फ़िल्टर सेट को मिटाना
delete
तरीके का इस्तेमाल करके, ऐसे किसी भी फ़िल्टर सेट को हटाया जा सकता है जिसकी अब ज़रूरत नहीं है. यह सिर्फ़ उस लेवल से ऐक्सेस किए जा सकने वाले फ़िल्टर सेट को हटा सकता है जिसे कहा जा रहा है.
उदाहरण के लिए, बिडिंग करने वाला कोई खाता, bidders.filterSets.delete
की मदद से bidders.accounts.filterSets.create
की मदद से बनाए गए फ़िल्टर सेट को नहीं मिटा सकता.
बिडर-लेवल
किसी खाते के लिए सेट किए गए बिडर-लेवल के फ़िल्टर को मिटाने के लिए, bidders.filtersets
रिसॉर्स यूआरआई को
एचटीटीपी DELETE
अनुरोध भेजा जा सकता है. इस अनुरोध का फ़ॉर्मैट इस तरह है:
DELETE https://adexchangebuyer.googleapis.com/v2beta1/bidders/{bidder resource ID}/filterSets/{filter set resource ID}अनुरोध करें
यहां बिडर-लेवल के फ़िल्टर सेट को मिटाने का एक उदाहरण दिया गया है:
DELETE https://adexchangebuyer.googleapis.com/v2beta1/bidders/12345678/filterSets/test-b-2जवाब
अनुरोध स्वीकार करने पर, अनुरोध का मुख्य हिस्सा खाली रहेगा. चुने गए फ़िल्टर सेट को अब ऐक्सेस नहीं किया जा सकता.
खाता-लेवल
किसी खाते के लिए सेट किए गए खाता-लेवल के फ़िल्टर को मिटाया जा सकता है. इसके लिए, आपको bidders.accounts.filtersets
रिसॉर्स यूआरआई को एचटीटीपी DELETE
अनुरोध भेजना होगा, जिसका फ़ॉर्मैट इस तरह है:
DELETE https://adexchangebuyer.googleapis.com/v2beta1/bidders/{bidder resource ID}/accounts/{account resource ID}/filterSets/{filter set resource ID}अनुरोध करें
यहां खाता-लेवल के फ़िल्टर सेट को मिटाने का एक उदाहरण दिया गया है:
DELETE https://adexchangebuyer.googleapis.com/v2beta1/bidders/12345678/accounts/87654321/filterSets/test-a-1जवाब
अनुरोध स्वीकार करने पर, अनुरोध का मुख्य हिस्सा खाली रहेगा. चुने गए फ़िल्टर सेट को अब ऐक्सेस नहीं किया जा सकता.
आरटीबी की समस्या हल करने वाली मेट्रिक वापस पाना
मेट्रिक पाने के लिए इस्तेमाल किए जाने वाले, आरटीबी की समस्या हल करने वाले सभी संसाधन एक ही तरह से काम करते हैं.
उनमें filterSetName
पाथ पैरामीटर के ज़रिए बताए गए फ़िल्टर सेट की मेट्रिक की सूची बनाने का
एक ही तरीका होता है. फ़िल्टर सेट से यह तय होगा कि मेट्रिक के लिए क्वेरी करते समय कौनसे फ़िल्टर और सेटिंग
लागू की जाएंगी. बिडर के लेवल से इन संसाधनों को कॉल करने पर, बिड करने वाले के खाते और उससे जुड़े सभी चाइल्ड खातों की एग्रीगेट की गई मेट्रिक दिखेंगी. वहीं, खाता लेवल पर आने वाले कॉल के नतीजे
सिर्फ़ व्यक्तिगत खाते की मेट्रिक दिखाएंगे.
बिड मेट्रिक
bidMetrics
रिसॉर्स का इस्तेमाल, उन मेट्रिक को फिर से पाने के लिए किया जाता है जिन्हें
बिड की संख्या में मेज़र किया जाता है. उदाहरण के लिए, इसका इस्तेमाल किसी समयसीमा के लिए लगाई गई बिड की कुल संख्या जानने के लिए किया जा सकता है. साथ ही, यह पता लगाने के लिए भी इसका इस्तेमाल किया जा सकता है कि उनमें से कितनों को नीलामी से फ़िल्टर नहीं किया गया, इंप्रेशन मिले वगैरह. मेट्रिक इकट्ठा करने के लिए इस्तेमाल किए जाने वाले, आरटीबी की समस्या हल करने वाले दूसरे सभी संसाधनों की तरह, इसमें सिर्फ़ list
तरीका है.
बिडर-लेवल की बिड मेट्रिक की सूची बनाएं
किसी फ़िल्टर सेट के लिए, बिड करने वाले के लेवल की बिड मेट्रिक की सूची बनाई जा सकती है. इसके लिए, आपको bidders.filtersets.bidMetrics
रिसॉर्स यूआरआई को एचटीटीपी GET
अनुरोध भेजना होगा, जिसका फ़ॉर्मैट इस तरह है:
GET https://adexchangebuyer.googleapis.com/v2beta1/bidders/{bidder resource ID}/filterSets/{filter set resource ID}/bidMetricsअनुरोध करें
बिडर-लेवल की बिड मेट्रिक की लिस्टिंग का उदाहरण यहां दिया गया है:
GET https://adexchangebuyer.googleapis.com/v2beta1/bidders/12345678/filterSets/bidder-fs/bidMetricsजवाब
अगर अनुरोध पूरा हो जाता है, तो सर्वर 200 OK
स्टेटस कोड के साथ जवाब देता है. साथ ही, जवाब में, तय किए गए डाइमेंशन और जानकारी के स्तर के लिए मेट्रिक की पंक्तियां होती हैं.
{ "bidMetricsRows": [{ "bids": { "value": "6160" }, "bidsInAuction": { "value": "5698" }, "billedImpressions": { "value": "1196" }, "impressionsWon": { "value": "2920" }, "measurableImpressions": { "value": "1160" }, "rowDimensions": { "timeInterval": { "endTime": "2017-11-29T08:00:00Z", "startTime": "2017-11-28T08:00:00Z" } }, "viewableImpressions": { "value": "683" } }, { "bids": { "value": "104288" }, "bidsInAuction": { "value": "94016" }, "billedImpressions": { "value": "99" }, "impressionsWon": { "value": "125" }, "measurableImpressions": { "value": "94" }, "rowDimensions": { "timeInterval": { "endTime": "2017-11-30T08:00:00Z", "startTime": "2017-11-29T08:00:00Z" } }, "viewableImpressions": { "value": "87" } }, { "bids": { "value": "3999" }, "bidsInAuction": { "value": "3631" }, "billedImpressions": { "value": "618" }, "impressionsWon": { "value": "1819" }, "measurableImpressions": { "value": "604" }, "rowDimensions": { "timeInterval": { "endTime": "2017-12-01T08:00:00Z", "startTime": "2017-11-30T08:00:00Z" } }, "viewableImpressions": { "value": "369" } }, { "bids": { "value": "15" }, "bidsInAuction": { "value": "3" }, "billedImpressions": {}, "impressionsWon": { "value": "3" }, "measurableImpressions": {}, "rowDimensions": { "timeInterval": { "endTime": "2017-12-02T08:00:00Z", "startTime": "2017-12-01T08:00:00Z" } }, "viewableImpressions": {} } ] }
ध्यान दें: अगर किसी मेट्रिक के लिए फ़ील्ड को 0 पर सेट किया जाता है, तो जवाब के तौर पर वह फ़ील्ड नहीं दिखेगा.
ऊपर दी गई खाली billedImpressions
और measurableImpressions
मेट्रिक से पता चलता है कि इनके लिए वैल्यू और वैरियंस, दोनों की वैल्यू 0 पर सेट है.
चेतावनी: जवाब में डेटा के किसी भी ब्रेकडाउन के लिए, अगर जवाब में
कम से कम एक नॉन-ज़ीरो मेट्रिक शामिल न हो, तो जवाब में पंक्तियां शामिल नहीं की जाएंगी. उदाहरण के लिए, जब
timeSeriesGranularity
दिया गया हो, तो रिस्पॉन्स में फ़िल्टर सेट की तय समयसीमा के दौरान, किसी भी
timeInterval
के लिए लाइनें शामिल नहीं की जाएंगी. ऐसा तब होगा, जब सभी मेट्रिक शून्य हों.
खाता-लेवल की बिड मेट्रिक की सूची बनाएं
किसी फ़िल्टर सेट के लिए, खाता-लेवल की बिड मेट्रिक को लिस्ट किया जा सकता है. इसके लिए, आपको bidders.accounts.filtersets.bidMetrics
रिसॉर्स यूआरआई को एचटीटीपी GET
अनुरोध भेजना होगा, जिसका फ़ॉर्मैट इस तरह है:
GET https://adexchangebuyer.googleapis.com/v2beta1/bidders/{bidder resource ID}/accounts/{account resource ID}/filterSets/{filter set resource ID}/bidMetricsअनुरोध करें
खाता-लेवल पर बिड मेट्रिक की लिस्टिंग का उदाहरण यहां दिया गया है:
GET https://adexchangebuyer.googleapis.com/v2beta1/bidders/12345678/accounts/87654321/filterSets/account-fs/bidMetricsजवाब
अगर अनुरोध पूरा हो जाता है, तो सर्वर 200 OK
स्टेटस कोड के साथ जवाब देता है. साथ ही, जवाब में, तय किए गए डाइमेंशन और जानकारी के स्तर के लिए मेट्रिक की पंक्तियां होती हैं.
{ "bidMetricsRows": [{ "bids": { "value": "1748" }, "bidsInAuction": { "value": "1421" }, "billedImpressions": { "value": "301" }, "impressionsWon": { "value": "915" }, "measurableImpressions": { "value": "298" }, "rowDimensions": { "timeInterval": { "endTime": "2017-12-01T08:00:00Z", "startTime": "2017-11-30T08:00:00Z" } }, "viewableImpressions": { "value": "172" } }, { "bids": { "value": "6" }, "bidsInAuction": { "value": "2" }, "billedImpressions": {}, "impressionsWon": { "value": "1" }, "measurableImpressions": {}, "rowDimensions": { "timeInterval": { "endTime": "2017-12-02T08:00:00Z", "startTime": "2017-12-01T08:00:00Z" } }, "viewableImpressions": {} } ] }
ध्यान दें: अगर किसी मेट्रिक के लिए फ़ील्ड को 0 पर सेट किया जाता है, तो जवाब के तौर पर वह फ़ील्ड नहीं दिखेगा. ऊपर दी गई
खाली billedImpressions
और measurableImpressions
मेट्रिक से पता चलता है कि
इनके लिए वैल्यू और वैरियंस, दोनों 0 पर सेट हैं.
चेतावनी: जवाब में डेटा के किसी भी ब्रेकडाउन के लिए, अगर जवाब में
कम से कम एक नॉन-ज़ीरो मेट्रिक शामिल न हो, तो जवाब में पंक्तियां शामिल नहीं की जाएंगी. उदाहरण के लिए, जब
timeSeriesGranularity
दिया गया हो, तो रिस्पॉन्स में फ़िल्टर सेट की तय समयसीमा के दौरान, किसी भी
timeInterval
के लिए लाइनें शामिल नहीं की जाएंगी. ऐसा तब होगा, जब सभी मेट्रिक शून्य हों.