इस गाइड में आरटीबी की समस्या हल करने वाले संसाधनों के बारे में बताया गया है. इनकी मदद से, उपयोगकर्ताओं को प्रोग्राम के हिसाब से
रीयल-टाइम बिडिंग कैंपेन की मेट्रिक को
RTB ब्रेकआउट टूल
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 के लिए, संसाधन आईडी इनमें से किसी एक का खाता आईडी होना चाहिए
बिड करने वाले व्यक्ति या उसके ज़रिए मैनेज किए जाने वाले चाइल्ड खाते में. अगर आपको नहीं पता कि कौनसे Authorized Buyers,
खाते आपके Google खाते से संबद्ध होते हैं, तो आप
accounts.list तरीके का इस्तेमाल करके, उन्हें ढूंढा जा सकता है.
फ़िल्टर सेट
फ़िल्टर सेट में, उपलब्ध फ़िल्टर के विकल्पों को दिखाया जाता है और बनाया जा सकता है बोली लगाने वाले व्यक्ति या खाता स्तर पर मंज़ूरी देते हैं. इसका इस्तेमाल, आरटीबी की समस्या हल करने के नतीजों की सूची को फ़िल्टर करने के लिए किया जाता है ऐसे संसाधन जो आपके रीयल-टाइम बिडिंग कैंपेन की मेट्रिक फिर से हासिल करते हैं.
मेट्रिक हासिल करते समय लागू किया गया फ़िल्टर, बताए गए फ़िल्टर में मौजूद हर फ़िल्टर के इंटरसेक्शन की तरह होता है
फ़िल्टर सेट. सूची फ़िल्टर, जैसे कि platforms को सूची में मौजूद हर आइटम के संयोजन के रूप में देखा जाता है.
बिड करने वाले और खाता-लेवल के फ़िल्टर सेट अलग-अलग होते हैं. साथ ही, इन्हें सिर्फ़ उस लेवल से ऐक्सेस किया जा सकता है जिसमें वे चाहे किसी भी खाते से बनाई गई हों. बिडिंग करने वाले और चाइल्ड खाते का शेयर फ़िल्टर सेट, खाता लेवल पर बनाए जाते हैं, जबकि बिडिंग करने वाला ही बिडिंग करने वाले के लेवल पर. यहां दी गई टेबल में बताया गया है कि बिडिंग करने वाले और चाइल्ड खाते, संसाधनों को कैसे ऐक्सेस कर सकते हैं दोनों लेवल पर:
| bidders.filterSets | bidders.accounts.filterSets | |
|---|---|---|
| बिड करने वाले का खाता | सिर्फ़ बिडर-लेवल के फ़िल्टर सेट पर असर डालने वाला एपीआई कॉल. | एपीआई कॉल, जो सिर्फ़ खाता-लेवल के फ़िल्टर सेट पर असर डाल रहा है. |
| बच्चे का खाता | इस एपीआई कॉल से आपको गड़बड़ी का मैसेज मिलेगा. | एपीआई कॉल, जो सिर्फ़ खाता-लेवल के फ़िल्टर सेट पर असर डाल रहा है. |
एक फ़िल्टर समूह बनाएं
फ़िल्टर का सेट बनाते समय, आपको समयसीमा को relativeDateRange के तौर पर तय करना होगा,
absoluteDateRange या realtimeTimeRange. मेट्रिक हासिल करते समय,
डिफ़ॉल्ट तरीका, पूरी समयसीमा के लिए दिया गया सारा डेटा होता है. अगर आपको
समय सीमा के हिसाब से टाइम सीरीज़ का ब्रेकडाउन, आपके पास timeSeriesGranularity तय करने का विकल्प है
इसका इस्तेमाल, HOURLY या DAILY इंटरवल दिखाने के लिए किया जाता है.
अगर आपको फ़िल्टर को कुछ ही समय के लिए सेट करना है, तो 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 स्थिति कोड देता है. जवाब के मुख्य हिस्से में, बनाए गए फ़िल्टर सेट संसाधन भी शामिल होंगे. यह संसाधन, अनुरोध में सबमिट किए गए फ़िल्टर सेट जैसा ही होगा.
खाता-लेवल का उदाहरण
एक नया खाता-स्तरीय फ़िल्टर सेट बनाने के लिए, एक POST अनुरोध
bidders.accounts.filterSets संसाधन यूआरआई, जिसका फ़ॉर्मैट यह है:
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.accounts.filterSets.get का इस्तेमाल करना चाहिए
लेवल तय करें.bidders.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.
बिड करने वाले का लेवल
एचटीटीपी GET भेजकर, किसी बिडर के लिए बिडर-लेवल के सभी फ़िल्टर सेट वापस पाए जा सकते हैं
bidders.filtersets संसाधन यूआरआई के लिए अनुरोध भेजें, जिसका फ़ॉर्मैट यह है:
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"
}
]
}
खाता-लेवल
आप एक एचटीटीपी GET भेजकर, किसी खाते के लिए खाता-लेवल के सभी फ़िल्टर सेट वापस पा सकते हैं
bidders.accounts.filtersets संसाधन यूआरआई के लिए अनुरोध भेजें, जिसका फ़ॉर्मैट यह है:
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.accounts.filterSets.create की मदद से बनाए गए फ़िल्टर सेट को नहीं मिटा सकता
bidders.filterSets.delete के साथ.
बिड करने वाले का लेवल
किसी खाते के लिए, बिड करने वाले-लेवल के फ़िल्टर सेट को मिटाया जा सकता है. इसके लिए, आपको एचटीटीपी DELETE अनुरोध भेजना होगा
को bidders.filtersets संसाधन यूआरआई के साथ जोड़ा जाएगा, जिसका फ़ॉर्मैट यह है:
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
अनुरोध स्वीकार होने पर, अनुरोध का मुख्य हिस्सा खाली रहेगा. फ़िल्टर के चुने गए सेट को ऐक्सेस नहीं किया जा सकेगा.
खाता-लेवल
किसी खाते के लिए, खाता-लेवल के फ़िल्टर सेट को मिटाने के लिए, एचटीटीपी DELETE भेजा जा सकता है
bidders.accounts.filtersets संसाधन यूआरआई के लिए अनुरोध भेजें, जिसका फ़ॉर्मैट यह है:
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 तरीका है.
बिडर-लेवल की बिड मेट्रिक की सूची बनाएं
एक एचटीटीपी GET भेजकर, सेट किए गए किसी फ़िल्टर के लिए, बिडर-लेवल की बिड मेट्रिक को सूची में जोड़ा जा सकता है
bidders.filtersets.bidMetrics संसाधन यूआरआई के लिए अनुरोध भेजें, जिसका फ़ॉर्मैट यह है:
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 जहां सभी मेट्रिक शून्य हैं.
खाता-लेवल पर बिडिंग की मेट्रिक की सूची बनाएं
एचटीटीपी GET भेजकर, सेट किए गए किसी फ़िल्टर के लिए, खाता-लेवल की बिड मेट्रिक को सूची में जोड़ा जा सकता है
bidders.accounts.filtersets.bidMetrics संसाधन यूआरआई को अनुरोध भेजें, जिसमें
निम्न प्रारूप:
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 जहां सभी मेट्रिक शून्य हैं.