সুরক্ষিত শ্রোতা API নিলাম প্রতিবেদন তৈরি করতে বিক্রেতা এবং ক্রেতা গাইড।
এই নিবন্ধটি সুরক্ষিত শ্রোতা API নিলাম জয়ের জন্য প্রতিবেদন তৈরি করার জন্য একটি প্রযুক্তিগত রেফারেন্স, যেমনটি পরীক্ষামূলক সুরক্ষিত দর্শক API-এর বর্তমান পুনরাবৃত্তিতে ব্যবহৃত হয়।
প্রোটেক্টেড অডিয়েন্স API-এর সম্পূর্ণ জীবনচক্রের জন্য বিকাশকারীর নির্দেশিকা পড়ুন, এবং ইভেন্ট-লেভেল রিপোর্টিং (অস্থায়ী) এর গভীর আলোচনার জন্য সুরক্ষিত দর্শক API ব্যাখ্যাকারীকে পড়ুন।
ডেভেলপার না? Protected Audience API API ওভারভিউ পড়ুন।
সুরক্ষিত শ্রোতা API রিপোর্ট কি?
দুটি উপলব্ধ সুরক্ষিত শ্রোতা API রিপোর্ট আছে:
- বিক্রেতার প্রতিবেদন : বিজ্ঞাপন নিলাম বিজয়ী বিক্রেতাকে অবহিত করে।
- ক্রেতা রিপোর্ট : শুধুমাত্র বিজয়ী ক্রেতাদের জন্য উপলব্ধ, তারা একটি নিলাম জিতেছে তা জানতে।
দীর্ঘমেয়াদী পরিকল্পনা হল ব্রাউজারকে ব্যক্তিগত একত্রীকরণ API API এর সাথে বিক্রেতা এবং ক্রেতাদের জন্য নিলামের ফলাফল রিপোর্ট করার অনুমতি দেওয়া। একটি অস্থায়ী ইভেন্ট-লেভেল রিপোর্টিং প্রক্রিয়া হিসাবে, বিক্রেতার জন্য কোডটি reportResult() বাস্তবায়ন করে এবং বিজয়ী দরদাতার জন্য reportWin() sendReportTo() ফাংশনকে কল করতে পারে। এটি একটি একক যুক্তি নেয়: একটি স্ট্রিং একটি URL উপস্থাপন করে যা নিলাম শেষ হওয়ার পরে আনা হয়, যা রিপোর্ট করার জন্য ইভেন্ট-স্তরের তথ্য এনকোড করে৷
API ফাংশন
বিক্রেতা: reportResult()
বিক্রেতার জাভাস্ক্রিপ্ট decisionLogicUrl (যা scoreAd() প্রদান করে) নিলামের ফলাফলের রিপোর্ট করার জন্য একটি reportResult() ফাংশন অন্তর্ভুক্ত করতে পারে।
reportResult(auctionConfig, browserSignals) {
...
return signalsForWinner;
}
এই ফাংশনে পাস করা আর্গুমেন্ট হল:
auctionConfig
নিলাম কনফিগারেশন অবজেক্টটি navigator.runAdAuction() এ পাস করা হয়েছে।
browserSignals
নিলাম সম্পর্কে তথ্য প্রদান করে ব্রাউজার দ্বারা নির্মিত একটি বস্তু। যেমন:
{
'topWindowHostname': 'publisher.example',
'interestGroupOwner': 'https://dsp.example',
'renderUrl': 'https://cdn.example/url-of-winning-creative.wbn',
'bid': <bidValue>,
'desirability': <winningAdScore>
}
এই ফাংশনের রিটার্ন মান বিজয়ী দরদাতার reportWin() ফাংশনের জন্য sellerSignals আর্গুমেন্ট হিসাবে ব্যবহৃত হয়।
ক্রেতা: reportWin()
বিজয়ী দরদাতার জাভাস্ক্রিপ্ট (যা generateBid() প্রদান করে) নিলামের ফলাফল রিপোর্ট করার জন্য একটি reportWin() ফাংশন অন্তর্ভুক্ত করতে পারে।
reportWin(auctionSignals, perBuyerSignals, sellerSignals, browserSignals) {
...
}
এই ফাংশনে পাস করা আর্গুমেন্ট হল:
auctionSignals এবং perBuyerSignals
বিজয়ী দরদাতার জন্য একই মান generateBid() এ পাস করা হয়েছে।
sellerSignals
reportResult() এর রিটার্ন মান, যা বিক্রেতাকে ক্রেতার কাছে তথ্য দেওয়ার সুযোগ দেয়।
browserSignals
নিলাম সম্পর্কে তথ্য প্রদান করে ব্রাউজার দ্বারা নির্মিত একটি বস্তু। যেমন:
{
'topWindowHostname': 'publisher.example',
'seller': 'https://ssp.example',
'interestGroupOwner': 'https://dsp.example',
'interestGroupName': 'custom-bikes',
'renderUrl': 'https://cdn.example/winning-creative.wbn',
'bid': <bidValue>
}
অস্থায়ী প্রতিবেদন বাস্তবায়ন
নিলাম প্রতিবেদনের জন্য Chrome এ সাময়িকভাবে দুটি পদ্ধতি উপলব্ধ রয়েছে:
-
forDebuggingOnly.reportAdAuctionLoss() -
forDebuggingOnly.reportAdAuctionWin()
এই পদ্ধতিগুলির প্রতিটি একটি একক যুক্তি নেয়: নিলাম শেষ হওয়ার পরে একটি URL আনার জন্য৷ বিভিন্ন ইউআরএল আর্গুমেন্ট সহ scoreAd() এবং generateBid() উভয় ক্ষেত্রেই তাদের একাধিকবার বলা যেতে পারে।
ক্রোম শুধুমাত্র ডিবাগ ক্ষতি/জয় রিপোর্ট পাঠায় যখন একটি নিলাম সম্পূর্ণ হয়। যদি একটি নিলাম বাতিল করা হয় (উদাহরণস্বরূপ, একটি নতুন নেভিগেশনের কারণে) কোনো প্রতিবেদন তৈরি করা হবে না।
আপনি যখন chrome://settings/adPrivacy এর অধীনে সমস্ত বিজ্ঞাপন গোপনীয়তা API সক্ষম করেন তখন এই পদ্ধতিগুলি Chrome-এ ডিফল্টরূপে উপলব্ধ থাকে। আপনি যদি Protected Audience API সক্ষম করতে কমান্ড লাইন পতাকা সহ Chrome চালান, তাহলে আপনাকে BiddingAndScoringDebugReportingAPI ফ্ল্যাগ অন্তর্ভুক্ত করে পদ্ধতিগুলিকে স্পষ্টভাবে সক্ষম করতে হবে৷ পতাকা সক্ষম না হলে, পদ্ধতিগুলি এখনও উপলব্ধ থাকবে কিন্তু কিছুই করবেন না।
সমস্ত সুরক্ষিত শ্রোতা API API রেফারেন্স
API reference guides are available:
- Developer guide for the Protected Audience API.
- Ad buyer guide to Protected Audience interest groups and bid generation.
- Ad seller guide to Protected Audience ad auctions.
- Guide to reporting auction results
- Best practices for Protected Audience ad auction latency
- Troubleshoot Protected Audience
The Protected Audience API explainer also provides detail about feature support and constraints.
What's next?
We want to engage in conversations with you to ensure we build an API that works for everyone.
Discuss the API
Like other Privacy Sandbox APIs, this API is documented and discussed publicly.
Experiment with the API
You can experiment and participate in conversation about the Protected Audience API.