এই নির্দেশিকাটি RTB সমস্যা সমাধানের সংস্থানগুলিকে কভার করে, যা আপনাকে প্রোগ্রাম্যাটিকভাবে রিয়েল-টাইম বিডিং প্রচারাভিযানের মেট্রিক্স অ্যাক্সেস করতে দেয় যা অনুমোদিত ক্রেতাদের UI-তে পাওয়া RTB ব্রেকআউট টুলের মাধ্যমেও প্রকাশ করা হয়। এর মধ্যে রয়েছে bidders.filterSets , bidders.accounts.filterSets , এবং ক্রমানুসারে তাদের অধীনে থাকা সমস্ত সংস্থান৷
RTB সমস্যা সমাধানের সংস্থানগুলি থেকে মেট্রিক্স ব্যবহার করে, আপনি ইম্প্রেশন জেতার মিস করা সুযোগগুলির অন্তর্দৃষ্টি পেতে পারেন যা আপনাকে আপনার রিয়েল-টাইম বিডিং প্রচারাভিযান অপ্টিমাইজ করতে সাহায্য করতে পারে৷
API গঠন এবং শৈলী সামঞ্জস্য
RTB সমস্যা সমাধানের সংস্থানগুলি স্পষ্টভাবে মালিকানা এবং অ্যাক্সেস নির্দেশ করতে, API দ্বারা প্রত্যাবর্তিত ডেটার উপর আরও দানাদার নিয়ন্ত্রণ প্রদান করতে এবং Google API ডিজাইন অনুশীলনের সাথে আরও ভালভাবে সারিবদ্ধ করার জন্য কয়েকটি পরিবর্তন প্রবর্তন করে।
বিডার-স্তর এবং অ্যাকাউন্ট-স্তরের সংস্থান
সম্পদ bidders এবং bidders.accounts উভয় অধীনে গঠন করা হয়. এগুলি আপনাকে নির্দিষ্ট করতে দেয় যে একটি API কল একটি দরদাতাকে লক্ষ্য করে (একটি অভিভাবক অ্যাকাউন্ট হিসাবেও পরিচিত) এবং সমস্ত সংশ্লিষ্ট চাইল্ড অ্যাকাউন্ট, বা স্বতন্ত্র অনুমোদিত ক্রেতা অ্যাকাউন্টগুলিকে লক্ষ্য করে। RTB সমস্যা সমাধানের পরিপ্রেক্ষিতে, bidders.filterSets অধীনে সংগঠিত সংস্থানগুলি প্রদত্ত দরদাতা এবং সমস্ত সংশ্লিষ্ট চাইল্ড অ্যাকাউন্টগুলির জন্য সমষ্টিগত মেট্রিক্স ফিরিয়ে দেবে। বিপরীতে, যারা bidders.accounts.filterSets এর অধীনে তারা শুধুমাত্র নির্দিষ্ট অ্যাকাউন্টের জন্য মেট্রিক্স ফেরত দেবে তা নির্বিশেষে এটি একটি বিডার বা চাইল্ড অ্যাকাউন্ট হোক না কেন।
দ্রষ্টব্য: যে অ্যাকাউন্টগুলি তাদের বিডিং অন্য ক্রেতাকে অর্পণ করে সেগুলি বিডার অ্যাকাউন্ট নয় এবং ফলস্বরূপ বিডার-স্তরের সংস্থানগুলি অ্যাক্সেস করতে পারে না৷ অতিরিক্তভাবে, নন-বিডার অ্যাকাউন্টগুলি অ্যাকাউন্ট-লেভেল impressionMetrics , filteredBidResponses , bidResponseErrors , এবং bidResponsesWithoutBids রিসোর্সে অ্যাক্সেস করতে পারে না৷
অনন্য শনাক্তকারী হিসাবে সম্পদ নাম প্রবর্তন
সম্পদের নামগুলি পূর্ণসংখ্যা বা স্ট্রিং আইডির পরিবর্তে অনন্য শনাক্তকারী হিসাবে ব্যবহৃত হয়। প্রদত্ত রিসোর্স টাইপের একটি নতুন উদাহরণ তৈরি করার সময়, আপনাকে এখন রিসোর্সের URI পাথ ব্যবহার করে পছন্দের রিসোর্স আইডি ব্যবহার করে একটি আপেক্ষিক রিসোর্স নাম উল্লেখ করতে হবে। নীচে RTB সমস্যা সমাধানের সংস্থানগুলির জন্য প্রাসঙ্গিক নামের উদাহরণ রয়েছে:
| সম্পদ | নাম উদাহরণ |
|---|---|
| bidders.filterSets | দরদাতা/12345678/filterSets/fset_1 |
| bidders.accounts.filterSets | দরদাতা/12345678/accounts/87654321/filterSets/fset_2 |
দ্রষ্টব্য: নামে bidders জন্য নির্দিষ্ট রিসোর্স আইডি অবশ্যই একটি দরদাতার অনুমোদিত ক্রেতাদের অ্যাকাউন্ট আইডি হতে হবে। accounts জন্য, রিসোর্স আইডি অবশ্যই দরদাতার অ্যাকাউন্ট আইডি হতে হবে বা এটি দ্বারা পরিচালিত একটি চাইল্ড অ্যাকাউন্ট হতে হবে। আপনি যদি জানেন না কোন অনুমোদিত ক্রেতাদের অ্যাকাউন্টগুলি আপনার Google অ্যাকাউন্টের সাথে যুক্ত, আপনি তাদের সন্ধান করতে accounts.list পদ্ধতি ব্যবহার করতে পারেন৷
ফিল্টার সেট
একটি ফিল্টার সেট হল উপলব্ধ ফিল্টারিং বিকল্পগুলির একটি উপস্থাপনা যা দরদাতা বা অ্যাকাউন্ট স্তরে তৈরি করা যেতে পারে। এটি RTB সমস্যা সমাধানের সংস্থানগুলির তালিকা ফলাফলগুলি ফিল্টার করতে ব্যবহৃত হয় যা আপনার রিয়েল-টাইম বিডিং প্রচারাভিযানের জন্য মেট্রিক্স পুনরুদ্ধার করে৷
মেট্রিক্স পুনরুদ্ধার করার সময় যে ফিল্টারটি প্রয়োগ করা হয় সেটি হল নির্দিষ্ট ফিল্টার সেটের প্রতিটি ফিল্টারের ছেদ। তালিকা ফিল্টার, যেমন platforms , তালিকার প্রতিটি আইটেমের মিলন হিসাবে ব্যাখ্যা করা হয়।
দরদাতা এবং অ্যাকাউন্ট-স্তরের ফিল্টার সেটগুলি স্বতন্ত্র এবং শুধুমাত্র যে স্তরে তারা তৈরি করা হয়েছিল তা থেকে অ্যাক্সেসযোগ্য - সেগুলি তৈরি করতে ব্যবহৃত অ্যাকাউন্ট নির্বিশেষে। একটি বিডার এবং চাইল্ড অ্যাকাউন্ট শেয়ার ফিল্টার সেট অ্যাকাউন্ট লেভেলে তৈরি করা হয়, যেখানে শুধুমাত্র একজন দরদাতা বিডার লেভেলে রিসোর্স অ্যাক্সেস করতে পারে। নিম্নলিখিত সারণীটি সংক্ষিপ্তভাবে বর্ণনা করে যে বিডার এবং চাইল্ড অ্যাকাউন্ট উভয় স্তরে সংস্থানগুলি কীভাবে অ্যাক্সেস করতে পারে:
| bidders.filterSets | bidders.accounts.filterSets | |
|---|---|---|
| বিডার অ্যাকাউন্ট | একটি API কল শুধুমাত্র বিডার-স্তরের ফিল্টার সেটগুলিকে প্রভাবিত করে৷ | একটি API কল শুধুমাত্র অ্যাকাউন্ট-স্তরের ফিল্টার সেটগুলিকে প্রভাবিত করে৷ |
| চাইল্ড অ্যাকাউন্ট | এই API কল একটি ত্রুটি প্রতিক্রিয়া প্রদান করবে। | একটি API কল শুধুমাত্র অ্যাকাউন্ট-স্তরের ফিল্টার সেটগুলিকে প্রভাবিত করে৷ |
একটি ফিল্টার সেট তৈরি করুন
একটি ফিল্টার সেট তৈরি করার সময়, আপনাকে অবশ্যই একটি relativeDateRange , absoluteDateRange , বা realtimeTimeRange হিসাবে একটি সময়সীমা নির্দিষ্ট করতে হবে। মেট্রিক্স পুনরুদ্ধার করার সময়, পুরো সময়সীমার জন্য সমস্ত ডেটা সরবরাহ করার জন্য ডিফল্ট আচরণ। আপনি যদি সময়ের পরিসরে একটি টাইম সিরিজ ব্রেকডাউন পেতে চান, আপনি HOURLY বা DAILY ব্যবধানগুলি নির্দেশ করার জন্য timeSeriesGranularity নির্দিষ্ট করতে পারেন।
আপনার যদি অল্প সময়ের জন্য একটি ফিল্টার সেটের প্রয়োজন হয়, তাহলে আপনি isTransient ক্যোয়ারী প্যারামিটারটিকে true সেট করতে পারেন। এটি নির্দেশ করবে যে ফিল্টার সেটটি ক্ষণস্থায়ী, যার অর্থ এটি অনির্দিষ্টকালের জন্য স্থায়ী হবে না। ক্ষণস্থায়ী ফিল্টার সেটগুলি তাদের তৈরি করার পরে কমপক্ষে এক ঘন্টার জন্য উপলব্ধ থাকবে, তবে শেষ পর্যন্ত মুছে ফেলা হবে। ডিফল্টরূপে, ফিল্টার সেট ক্ষণস্থায়ী হয় না।
দরদাতা-স্তরের উদাহরণ
একটি নতুন বিডার-স্তরের ফিল্টার সেট তৈরি করতে, bidders.filterSets রিসোর্স URI-তে একটি 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 ওকে স্ট্যাটাস কোড দিয়ে সাড়া দেয়। প্রতিক্রিয়া বডিতে তৈরি করা ফিল্টার সেট সংস্থান অন্তর্ভুক্ত থাকবে, যা অনুরোধে জমা দেওয়া ফিল্টার সেটের অনুরূপ হবে।
অ্যাকাউন্ট-স্তরের উদাহরণ
একটি নতুন অ্যাকাউন্ট-স্তরের ফিল্টার সেট তৈরি করতে, bidders.accounts.filterSets রিসোর্স URI-তে একটি POST অনুরোধ পাঠান, যার নিম্নলিখিত বিন্যাস রয়েছে:
https://adexchangebuyer.googleapis.com/v2beta1/bidders/{bidder resource ID}/accounts/{account resource ID}/filterSets দ্রষ্টব্য: accounts জন্য নির্দিষ্ট করা রিসোর্স আইডি যেকোন অনুমোদিত ক্রেতা অ্যাকাউন্টের অ্যাকাউন্ট আইডি হতে পারে যা URI-তে নির্দিষ্ট দরদাতার অ্যাকাউন্টে অ্যাক্সেসযোগ্য, বিডার অ্যাকাউন্ট নিজেই।
এখানে একটি 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 ওকে স্ট্যাটাস কোড দিয়ে সাড়া দেয়। প্রতিক্রিয়া বডিতে তৈরি করা ফিল্টার সেট সংস্থান অন্তর্ভুক্ত থাকবে, যা অনুরোধে জমা দেওয়া ফিল্টার সেটের অনুরূপ হবে।
একটি ফিল্টার সেট পান
প্রাপ্ত পদ্ধতিটি তৈরি করা হয়েছিল একই স্তরে শুধুমাত্র একটি ফিল্টার সেট পেতে পারে। উদাহরণস্বরূপ, একটি বিডার অ্যাকাউন্ট bidders.accounts.filterSets.get ব্যবহার করা উচিত bidders.filterSets.get পদ্ধতির পরিবর্তে অ্যাকাউন্ট স্তরে তৈরি একটি ফিল্টার সেট পুনরুদ্ধার করতে।
দরদাতা-স্তরের
আপনি bidders.filterSets রিসোর্স URI-তে একটি HTTP GET অনুরোধ পাঠিয়ে একটি বিডার-স্তরের ফিল্টার সেট পুনরুদ্ধার করতে পারেন, যার নিম্নলিখিত বিন্যাস রয়েছে:
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 HTTP স্ট্যাটাস কোড এবং পুনরুদ্ধার করা ফিল্টার সেটের সাথে প্রতিক্রিয়া জানায়:
{
"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 রিসোর্স URI-তে HTTP 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 HTTP স্ট্যাটাস কোড এবং পুনরুদ্ধার করা ফিল্টার সেটের সাথে প্রতিক্রিয়া জানায়:
{
"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 রিসোর্স URI-তে একটি HTTP 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 রিসোর্স URI-তে HTTP 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.accounts.filterSets.create এর সাথে bidders.filterSets.delete দিয়ে তৈরি একটি ফিল্টার সেট মুছতে পারে না।
দরদাতা-স্তরের
আপনি bidders.filtersets রিসোর্স URI-তে HTTP 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 রিসোর্স URI-তে HTTP 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প্রতিক্রিয়া
সফল হলে, অনুরোধের বডি খালি থাকবে। নির্দিষ্ট ফিল্টার সেট আর অ্যাক্সেসযোগ্য হবে না।
RTB সমস্যা সমাধানের মেট্রিক্স পুনরুদ্ধার করুন
মেট্রিক্স গ্রহণের জন্য ব্যবহৃত সমস্ত RTB সমস্যা সমাধানের সংস্থান একইভাবে কাজ করে — filterSetName পাথ প্যারামিটারের মাধ্যমে নির্দিষ্ট করা ফিল্টার সেটের জন্য মেট্রিক্স তালিকাভুক্ত করার জন্য তাদের একটি একক পদ্ধতি রয়েছে। নির্দিষ্ট করা ফিল্টার সেটটি নির্ধারণ করবে যে মেট্রিকগুলি অনুসন্ধান করার সময় কোন ফিল্টার এবং সেটিংস প্রয়োগ করা হবে৷ দরদাতা স্তর থেকে এই সংস্থানগুলিকে কল করা বিডার অ্যাকাউন্ট এবং সমস্ত সম্পর্কিত চাইল্ড অ্যাকাউন্ট থেকে সমষ্টিগত মেট্রিক্স ফেরত দেবে, যেখানে অ্যাকাউন্ট স্তর থেকে একটি কল শুধুমাত্র একটি পৃথক অ্যাকাউন্টের জন্য মেট্রিক্স ফেরত দেবে।
বিড মেট্রিক্স
bidMetrics রিসোর্সটি মেট্রিক্স পুনরুদ্ধার করতে ব্যবহৃত হয় যা বিডের সংখ্যায় পরিমাপ করা হয়। উদাহরণস্বরূপ, আপনি একটি নির্দিষ্ট সময়সীমার মধ্যে আপনার মোট বিডের সংখ্যা নির্ধারণ করতে এটি ব্যবহার করতে পারেন এবং এর মধ্যে কতগুলি নিলাম থেকে ফিল্টার করা হয়নি, একটি ইমপ্রেশন জিতেছে ইত্যাদি। মেট্রিক্স সংগ্রহ করতে ব্যবহৃত অন্যান্য RTB সমস্যা সমাধানের সংস্থানগুলির মতো, এটি শুধুমাত্র একটি list পদ্ধতি আছে।
বিডার-স্তরের বিড মেট্রিক্স তালিকাভুক্ত করুন
আপনি bidders.filtersets.bidMetrics রিসোর্স URI-তে HTTP 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 রিসোর্স URI-তে HTTP 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 এর জন্য সারি অন্তর্ভুক্ত করবে না যেখানে সমস্ত মেট্রিক্স শূন্য।