इस पेज पर, Bid Manager API के बंद हो चुके वर्शन की जानकारी दी गई है.
सभी रिलीज़ के लिए हमारे मुख्य रिलीज़ नोट पेज पर जाएं लाइव वर्शन.
15 अप्रैल, 2021
नई सुविधाएं
रिलीज़ किया गया Bid Manager API v1.1.
v1.1
एसडीएफ़ और लाइन आइटम की सेवाएं बंद हो रही हैं
SDF और लाइन आइटम सेवाएं अब बंद हो गई हैं.
ऐसे उपयोगकर्ता जो स्ट्रक्चर्ड डेटा डाउनलोड करना चाहते हैं फ़ाइलें या लाइन आइटम मैनेज करने के लिए, आपको ये काम करने होंगे इसके बजाय, Google Display &Video 360 के ज़रिए Video 360 API.
पहले से मालूम समस्याएं
कोई नहीं.
6 अगस्त, 2020
नई सुविधाएं
v1.1
पाथ और पाथ एट्रिब्यूशन रिपोर्ट
TYPE_PATH
और TYPE_PATH_ATTRIBUTION
report
types
अब लाइव हैं.
इसमें, params.options.pathQueryOptions
का नया फ़ील्ड जोड़ना शामिल है
(जिसमें pathFilters
और channelGrouping
फ़ील्ड शामिल हैं) से
query
और
report
संसाधन.
नया Filters
जोड़ा गया:
FILTER_CHANNEL_GROUPING
FILTER_EVENT_TYPE
FILTER_PATH_EVENT_INDEX
FILTER_PATH_PATTERN_ID
नया Metrics
जोड़ा गया:
METRIC_ACTIVITY_REVENUE
METRIC_CONVERTING_PATHS
METRIC_EXPOSURE_CONVERSION_RATE
METRIC_LAST_TOUCH_CLICK_THROUGH_CONVERSIONS
METRIC_LAST_TOUCH_TOTAL_CONVERSIONS
METRIC_LAST_TOUCH_VIEW_THROUGH_CONVERSIONS
METRIC_PATH_CONVERSION_RATE
METRIC_PROVISIONAL_IMPRESSIONS
METRIC_TOTAL_EXPOSURES
METRIC_TOTAL_PATHS
पहले से मालूम समस्याएं
कोई नहीं.
20 मार्च, 2020
नई सुविधाएं
v1.1
एसिंक्रोनस क्वेरी चलाना
Queries.createquery
और
अभी Queries.runquery
तरीका इस्तेमाल करें
इसकी मदद से, एसिंक्रोनस तरीके से क्वेरी चलाई जा सकती हैं.
इसमें नया पैरामीटर asynchronous
देखें:
createquery
और
ज़्यादा जानकारी के लिए, runquery
पर जाएं.
पहले से मालूम समस्याएं
कोई नहीं.
14 जनवरी, 2020
नई सुविधाएं
v1.1
क्वेरी शेड्यूल के शुरू होने का समय
अभी Queries.createquery
तरीका इस्तेमाल करें
की मदद से यह तय किया जा सकता है कि क्वेरी चलाने के शेड्यूल के शुरू होने की तारीख क्या है.
नया फ़ील्ड देखें
इसके लिए schedule.startTimeMs
:
देखें.
पहले से मालूम समस्याएं
कोई नहीं.
8 जनवरी, 2020
नई सुविधाएं
v1.1
टारगेट की गई ऑडियंस की सूचियों के डेटा को टॉगल करें
अभी Queries.createquery
तरीका इस्तेमाल करें
की मदद से यह तय किया जा सकता है कि क्या ऑडियंस की सूची का डेटा सिर्फ़
इंसर्शन ऑर्डर या लाइन आइटम.
नया फ़ील्ड देखें
params.options.includeOnlyTargetedUserLists
देखें.
पहले से मालूम समस्याएं
कोई नहीं.
19 नवंबर, 2019
नई सुविधाएं
v1.1
कॉलम मैपिंग रिपोर्ट करने के लिए वन-टू-वन फ़िल्टर
कई रिपोर्ट कॉलम पर मैप किए गए फ़िल्टर अब सिंगल पर मैप किए जाते हैं कॉलम.
उदाहरण के लिए, वर्शन 1 में, FILTER_ADVERTISER
फ़िल्टर को शामिल करने से रिपोर्ट मिलती है
"विज्ञापन देने वाले" कॉलम के साथ "विज्ञापन देने वाले का आईडी" शामिल करें. वर्शन 1.1 में, सभी
रिपोर्ट कॉलम में अपने फ़िल्टर होते हैं. उदाहरण के लिए, एक नया फ़िल्टर
FILTER_ADVERTISER_NAME
, "विज्ञापन देने वाले" पर मैप करता है. "विज्ञापन देने वाले व्यक्ति या कंपनी", दोनों को पाने के लिए
आईडी" और "विज्ञापन देने वाला" रिपोर्ट के कॉलम में, दोनों फ़िल्टर FILTER_ADVERTISER
और
FILTER_ADVERTISER_NAME
को इसमें शामिल करना होगा
Queries.createquery
अनुरोध.
सीधे तौर पर कहें, तो createquery
अनुरोध:
{
...
"params": {
...
"groupBys": ["FILTER_ADVERTISER"],
"metrics": ["METRIC_IMPRESSIONS"],
...
}
...
}
v1 में इन हेडर के साथ एक रिपोर्ट फ़ाइल जनरेट करता है:
Advertiser,Advertiser ID,Advertiser Status,Advertiser Integration Code,Impressions
और v1.1 में ये हेडर शामिल हैं:
Advertiser,Impressions
रिपोर्ट के कॉलम तैयार करने के लिए, इस v1 कोड का इस्तेमाल किया गया है:
List<String> groupBys = new ArrayList<>();
groupBys.add("FILTER_ADVERTISER");
List<String> metrics = new ArrayList<>();
metrics.add("METRIC_IMPRESSIONS");
com.google.api.services.doubleclickbidmanager.model.Parameters createQueryParameters =
new com.google.api.services.doubleclickbidmanager.model.Parameters()
.setGroupBys(groupBys)
.setMetrics(metrics);
v1.1 (नोट फ़िल्टर) में दिए गए विकल्पों की तरह से इसे बदलना होगा क्रम से लगाएं):
List<String> groupBys = new ArrayList<>();
groupBys.add("FILTER_ADVERTISER_NAME");
groupBys.add("FILTER_ADVERTISER");
groupBys.add("FILTER_ADVERTISER_INTEGRATION_STATUS");
groupBys.add("FILTER_ADVERTISER_INTEGRATION_CODE");
List<String> metrics = new ArrayList<>();
metrics.add("METRIC_IMPRESSIONS");
com.google.api.services.doubleclickbidmanager.model.Parameters createQueryParameters =
new com.google.api.services.doubleclickbidmanager.model.Parameters()
.setGroupBys(groupBys)
.setMetrics(metrics);
मूल फ़िल्टर | जोड़े गए फ़िल्टर |
---|---|
FILTER_ADVERTISER
|
FILTER_ADVERTISER_NAME FILTER_ADVERTISER_INTEGRATION_CODE FILTER_ADVERTISER_INTEGRATION_STATUS |
FILTER_AD_POSITION |
FILTER_AD_POSITION_NAME |
FILTER_CARRIER |
FILTER_CARRIER_NAME |
FILTER_CHANNEL_ID |
FILTER_CHANNEL_NAME |
FILTER_CITY |
FILTER_CITY_NAME |
FILTER_COMPANION_CREATIVE_ID |
FILTER_COMPANION_CREATIVE_NAME |
FILTER_DMA |
FILTER_DMA_NAME |
FILTER_INSERTION_ORDER |
FILTER_INSERTION_ORDER_NAME |
FILTER_PARTNER |
FILTER_PARTNER_NAME FILTER_PARTNER_STATUS |
FILTER_REGION |
FILTER_REGION_NAME |
FILTER_TRUEVIEW_DMA |
FILTER_TRUEVIEW_DMA_NAME |
FILTER_TRUEVIEW_IAR_REGION |
FILTER_TRUEVIEW_IAR_REGION_NAME |
FILTER_USER_LIST_FIRST_PARTY |
FILTER_USER_LIST_FIRST_PARTY_NAME |
FILTER_USER_LIST_THIRD_PARTY |
FILTER_USER_LIST_THIRD_PARTY_NAME |
पेज पर नंबर डालना
वर्शन 1.1 में, तरीकों में पेज नंबर जोड़ने की सुविधा जोड़ी गई है
Queries.listqueries
और
Reports.listreports
.
वर्शन 1.1 में, इन कंपनियों से मिलने वाले नतीजों की संख्या
मेथड, जोड़े गए नए पैरामीटर के बराबर होता है
pageSize
(यह डिफ़ॉल्ट रूप से काम करती है
100
). जवाबों में एक नया जोड़ा गया
nextPageToken
फ़ील्ड
का इस्तेमाल नतीजों के अगले सेट को वापस पाने के लिए किया जा सकता है. अगर नतीजे मिलते हैं, तो यह फ़ील्ड खाली होता है
खत्म हो चुके हैं.
किसी खास क्वेरी से जुड़ी सभी रिपोर्ट को फिर से पाने के लिए, नीचे दिया गया v1 कोड:
public class GetReports {
public List<Report> getReports(DoubleClickBidManager service, long queryId) throws IOException {
ListReportsResponse reportListResponse = service.reports().listreports(queryId).execute();
return reportListResponse.getReports();
}
}
करने के लिए v1.1 में दिए गए बदलाव की तरह करना होगा सभी रिपोर्ट हासिल करना जारी रखें:
public class GetReports {
public List<Report> getReports(DoubleClickBidManager service, long queryId) throws IOException {
ListReportsResponse reportListResponse = service.reports().listreports(queryId).execute();
List<Report> reports = new ArrayList<>(reportListResponse.getReports());
while (reportListResponse.getNextPageToken() != null
&& reportListResponse.getNextPageToken().length() > 0) {
// Get next set, or page, of results.
reportListResponse =
service
.reports()
.listreports(queryId)
.setPageToken(reportListResponse.getNextPageToken())
.execute();
reports.addAll(reportListResponse.getReports());
}
return reports;
}
}
Queries.listqueries
और देखें
Reports.listreports
तरीका
दस्तावेज़ देखें.
पहले से मालूम समस्याएं
कोई नहीं.