रिलीज़ टिप्पणियां

इस पेज पर, Google Bid Manager API के रिलीज़ नोट दिए गए हैं.

एपीआई का नया वर्शन: v2

1 मार्च, 2025

नई सुविधाएं

ज्ञात समस्याएं

Display & Video 360 के सहायता केंद्र में पहले ही बताया गया था कि YouTube TrueView इन्वेंट्री की उपलब्धता की रिपोर्ट और उससे जुड़े डाइमेंशन बंद किए जाएंगे.

v2

• नीचे दी गई वैल्यू का इस्तेमाल बंद कर दिया गया है:

  Enum	वैल्यू
  ReportType	INVENTORY_AVAILABILITY

• इन फ़िल्टर को बंद कर दिया गया है:

  वैल्यू फ़िल्टर करें

  FILTER_DETAILED_DEMOGRAPHICS FILTER_DETAILED_DEMOGRAPHICS_ID FILTER_HOUSEHOLD_INCOME FILTER_LIFE_EVENT FILTER_REMARKETING_LIST FILTER_TRUEVIEW_IAR_AGE FILTER_TRUEVIEW_IAR_CATEGORY FILTER_TRUEVIEW_IAR_CITY FILTER_TRUEVIEW_IAR_COUNTRY FILTER_TRUEVIEW_IAR_COUNTRY_NAME FILTER_TRUEVIEW_IAR_GENDER FILTER_TRUEVIEW_IAR_INTEREST FILTER_TRUEVIEW_IAR_LANGUAGE FILTER_TRUEVIEW_IAR_PARENTAL_STATUS FILTER_TRUEVIEW_IAR_REGION_NAME FILTER_TRUEVIEW_IAR_REMARKETING_LIST FILTER_TRUEVIEW_IAR_TIME_OF_DAY FILTER_TRUEVIEW_IAR_YOUTUBE_CHANNEL FILTER_TRUEVIEW_IAR_YOUTUBE_VIDEO FILTER_TRUEVIEW_IAR_ZIPCODE FILTER_YOUTUBE_CHANNEL FILTER_YOUTUBE_VIDEO

• इन मेट्रिक का इस्तेमाल बंद कर दिया गया है:

  मेट्रिक की वैल्यू
  METRIC_POTENTIAL_VIEWS METRIC_TEA_TRUEVIEW_IMPRESSIONS METRIC_TEA_TRUEVIEW_UNIQUE_COOKIES

20 नवंबर, 2024

नई सुविधाएं

FILTER_UNIQUE_REACH_SAMPLE_SIZE_ID लॉन्च किया गया. इससे, इन प्रीफ़िक्स वाली मेट्रिक के लिए, कम भरोसेमंद डेटा शामिल किया जा सकता है:

• METRIC_UNIQUE_REACH_
• METRIC_VIRTUAL_PEOPLE_DUPLICATE_
• METRIC_VIRTUAL_PEOPLE_EXCLUSIVE_
• METRIC_VIRTUAL_PEOPLE_OVERLAP_

इस फ़िल्टर का इस्तेमाल करते समय, काम की कोई एक मेट्रिक शामिल करनी होगी.

लॉन्च होने के बाद, जिन क्वेरी में यह फ़िल्टर शामिल नहीं होगा उनमें डिफ़ॉल्ट रूप से, सिर्फ़ भरोसेमंद डेटा शामिल किया जाएगा. 4 फ़रवरी, 2025 और उसके बाद, जिन क्वेरी में यह फ़िल्टर शामिल नहीं होगा उनमें डिफ़ॉल्ट रूप से कम भरोसेमंद डेटा शामिल होगा.

v2

• ये फ़िल्टर जोड़े गए हैं:

  फ़िल्टर टाइप	उपलब्ध वैल्यू
  FILTER_UNIQUE_REACH_SAMPLE_SIZE_ID	0: कम भरोसे वाला डेटा शामिल करें. (4 फ़रवरी, 2025 के बाद डिफ़ॉल्ट रूप से) 1: सिर्फ़ भरोसेमंद डेटा शामिल करें. (4 फ़रवरी, 2025 से पहले डिफ़ॉल्ट)

1 अक्टूबर, 2024

नई सुविधाएं

कोई नहीं.

ज्ञात समस्याएं

v2

अनाम इन्वेंट्री मॉडलिंग (एआईएम) रिपोर्टिंग डाइमेंशन की सुविधा बंद होना

FILTER_ANONYMOUS_INVENTORY_MODELING डाइमेंशन, सूर्यास्त है.

params.groupBy में, बंद होने की तारीख की वैल्यू का इस्तेमाल करके Query रिसॉर्स बनाने या चलाने पर, 400 गड़बड़ी का मैसेज दिखता है.

डीएसटी/आरओसी (रेगुलेटरी ऑपरेटिंग कॉस्ट) और कुल मीडिया लागत वाली मेट्रिक, YOUTUBE रिपोर्ट के साथ काम नहीं करतीं.

YOUTUBE रिपोर्ट में, अब इन मेट्रिक वैल्यू का इस्तेमाल नहीं किया जा सकता:

• METRIC_TOTAL_MEDIACOST_ADVERTISER
• METRIC_TOTAL_MEDIACOST_ECPAPC_ADVERTISER
• METRIC_TOTAL_MEDIACOST_ECPAPC_PARTNER
• METRIC_TOTAL_MEDIACOST_ECPAPC_USD
• METRIC_TOTAL_MEDIACOST_ECPAPV_ADVERTISER
• METRIC_TOTAL_MEDIACOST_ECPAPV_PARTNER
• METRIC_TOTAL_MEDIACOST_ECPAPV_USD
• METRIC_TOTAL_MEDIACOST_ECPA_ADVERTISER
• METRIC_TOTAL_MEDIACOST_ECPA_PARTNER
• METRIC_TOTAL_MEDIACOST_ECPA_USD
• METRIC_TOTAL_MEDIACOST_ECPCV_ADVERTISER
• METRIC_TOTAL_MEDIACOST_ECPCV_PARTNER
• METRIC_TOTAL_MEDIACOST_ECPCV_USD
• METRIC_TOTAL_MEDIACOST_ECPC_ADVERTISER
• METRIC_TOTAL_MEDIACOST_ECPC_PARTNER
• METRIC_TOTAL_MEDIACOST_ECPC_USD
• METRIC_TOTAL_MEDIACOST_ECPM_ADVERTISER
• METRIC_TOTAL_MEDIACOST_ECPM_PARTNER
• METRIC_TOTAL_MEDIACOST_ECPM_USD
• METRIC_TOTAL_MEDIACOST_PARTNER
• METRIC_TOTAL_MEDIACOST_USD
• METRIC_TOTAL_MEDIACOST_VIEWABLE_ECPM_ADVERTISER
• METRIC_TOTAL_MEDIACOST_VIEWABLE_ECPM_PARTNER
• METRIC_TOTAL_MEDIACOST_VIEWABLE_ECPM_USD
• METRIC_FEE32_ADVERTISER
• METRIC_FEE32_PARTNER
• METRIC_FEE32_USD

YOUTUBE के params.type और params.metrics में काम की मेट्रिक वैल्यू वाले Query संसाधन बनाकर या चलाकर, 400 गड़बड़ी का मैसेज मिलता है.

1 मई, 2024

नई सुविधाएं

कोई नहीं.

ज्ञात समस्याएं

v2

पूरे पाथ और पाथ एट्रिब्यूशन रिपोर्ट की सुविधा बंद होना

पूरा पाथ और पाथ एट्रिब्यूशन रिपोर्ट बंद कर दी गई हैं. इस तरह के Query और Report रिसॉर्स को पाने या बनाने पर गड़बड़ी होती है.

ReportType की ये वैल्यू अब इस्तेमाल नहीं की जा सकतीं:

• FULL_PATH
• PATH_ATTRIBUTION

Options ऑब्जेक्ट का pathQueryOptions फ़ील्ड भी बंद कर दिया गया है.

28 फ़रवरी, 2024

नई सुविधाएं

कोई नहीं.

ज्ञात समस्याएं

v2

क्रॉस-डिवाइस कन्वर्ज़न मेट्रिक की वैल्यू बंद होना

क्रॉस-डिवाइस कन्वर्ज़न मेट्रिक बंद कर दी गई हैं. Bid Manager API की ये मेट्रिक वैल्यू शामिल हैं:

• METRIC_CM360_POST_CLICK_REVENUE_CROSS_ENVIRONMENT
• METRIC_CM360_POST_VIEW_REVENUE_CROSS_ENVIRONMENT
• METRIC_POST_CLICK_CONVERSIONS_CROSS_ENVIRONMENT
• METRIC_POST_VIEW_CONVERSIONS_CROSS_ENVIRONMENT
• METRIC_TOTAL_CONVERSIONS_CROSS_ENVIRONMENT

6 जुलाई, 2022

नई सुविधाएं

Bid Manager API v2 रिलीज़ किया गया.

एपीआई के स्ट्रक्चर में बदलाव किए गए हैं. इनमें, सेवा के एंडपॉइंट को अपडेट करना और सेवाओं और तरीकों का नाम बदलना शामिल है.

ज़रूरत के मुताबिक फ़ील्ड हटाकर, मौजूदा फ़ील्ड को फिर से व्यवस्थित करके, और फ़ील्ड टाइप बदलकर, क्वेरी और रिपोर्ट संसाधनों को काफ़ी अपडेट किया गया है. इसमें, सामान्य "नेस्ट किए गए ऑब्जेक्ट" की परिभाषा के बजाय, नाम वाले ऑब्जेक्ट का इस्तेमाल करने के लिए फ़ील्ड टाइप बदलना शामिल है.

ज़रूरी है कि ad-hoc क्वेरी बनाने के बाद, उन्हें अपने-आप चलने के बजाय, queries.run तरीके का इस्तेमाल करके चलाया जाए.

queries.run क्वेरी पैरामीटर asynchronous को synchronous से बदला गया.

इन बदलावों की मदद से, रिपोर्ट को आसानी से वापस पाया जा सकता है:

• queries.reports.get का तरीका जोड़ा गया.
• queries.reports.list में orderBy क्वेरी पैरामीटर जोड़ा गया.
• queries.run रिस्पॉन्स बॉडी को खाली ऑब्जेक्ट से, जनरेट किए गए Report रिसॉर्स के इंस्टेंस में अपडेट करना.

एपीआई से मिलने वाले गड़बड़ी के मैसेज को अपडेट किया गया है, ताकि वे ज़्यादा सटीक हों और समस्या को ठीक करने के सुझाव दे सकें.

v1.1 से v2 पर माइग्रेट करने के लिए, v2 माइग्रेशन गाइड में दिए गए निर्देशों का पालन करें.

v2

• सेवा का एंडपॉइंट बदल गया है:

  v1 सेवा एंडपॉइंट	v2 सेवा एंडपॉइंट
  https://www.googleapis.com/doubleclickbidmanager	https://doubleclickbidmanager.googleapis.com

• सेवाओं के नाम इस तरह बदले गए हैं:

  v1 सेवा	v2 सेवा
  क्वेरी	क्वेरी
  रिपोर्ट	queries.reports

• तरीकों के नाम इस तरह बदले गए हैं:

  v1 तरीका	v2 तरीका
  Queries.createquery	queries.create
  Queries.deletequery	queries.delete
  Queries.getquery	queries.get
  Queries.listqueries	queries.list
  Queries.runquery	queries.run
  Reports.listreports	queries.reports.list

• ये तरीके जोड़े गए हैं:

  सेवा	तरीका(तरीके)
  queries.reports	get

• इन तरीकों में रिस्पॉन्स का नया मुख्य हिस्सा होता है:

  तरीका	जवाब का नया मुख्य हिस्सा
  queries.run	शिकायत करें

• ये फ़ील्ड हटा दिए गए हैं:

  संसाधन	फ़ील्ड
  queries.list रिस्पॉन्स बॉडी	तरह
  queries.reports.list रिस्पॉन्स बॉडी	तरह
  क्वेरी	तरह reportDataEndTimeMs reportDataStartTimeMs timezoneCode
  RunQueryRequest	reportDataEndTimeMs reportDataStartTimeMs timezoneCode

• इन फ़ील्ड के ऑब्जेक्ट टाइप को इनमें बदल दिया गया है:

  संसाधन	फ़ील्ड	ऑब्जेक्ट टाइप
  क्वेरी	metadata params शेड्यूल	QueryMetadata पैरामीटर QuerySchedule
  शिकायत करें	key metadata params	ReportKey ReportMetadata पैरामीटर
  RunQueryRequest	dataRange	DataRange

• यहां दिए गए तरीके के क्वेरी पैरामीटर जोड़े गए हैं:

  तरीका	क्वेरी पैरामीटर
  queries.list	orderBy
  queries.reports.list	orderBy
  queries.run	सिंक्रोनस

• इन तरीकों के क्वेरी पैरामीटर हटा दिए गए हैं:

  तरीका	क्वेरी पैरामीटर
  queries.create	एसिंक्रोनस
  queries.run	एसिंक्रोनस

• फ़िल्टर की ये वैल्यू जोड़ी गई हैं:

  फ़िल्टर की वैल्यू
  FILTER_INVENTORY_MEDIA_COST_TYPE
  FILTER_TARGETING_EXPANSION

• फ़िल्टर की ये वैल्यू हटा दी गई हैं:

  फ़िल्टर की वैल्यू
  FILTER_TRUEVIEW_IAR_REGION

• मेट्रिक की ये वैल्यू जोड़ी गई हैं:

  मीट्रिक मान
  METRIC_STORE_VISIT_VIEW_THROUGH_CONVERSIONS
  METRIC_UNIQUE_REACH_AVERAGE_VIEWABLE_IMPRESSION_FREQUENCY
  METRIC_UNIQUE_REACH_IMPRESSION_REACH_ADDED_WITH_CROSS_STACK_FCAP
  METRIC_UNIQUE_REACH_IMPRESSION_REACH_ADDED_WITH_PG_FMGMT
  METRIC_UNIQUE_REACH_INCREMENTAL_CLICK_REACH
  METRIC_UNIQUE_REACH_INCREMENTAL_IMPRESSION_REACH
  METRIC_UNIQUE_REACH_INCREMENTAL_TOTAL_REACH
  METRIC_UNIQUE_REACH_INCREMENTAL_VIEWABLE_IMPRESSION_REACH
  METRIC_UNIQUE_REACH_VIEWABLE_IMPRESSION_REACH

ज्ञात समस्याएं

कोई नहीं.

पिछली रिलीज़

बंद किए जा रहे वर्शन के लिए, Bid Manager API की पिछली रिलीज़ के बारे में पढ़ने के लिए, हमारे संग्रहित रिलीज़ नोट देखें.