সুরক্ষিত শ্রোতা API নিলাম ফলাফলের উপর প্রতিবেদন করুন

সুরক্ষিত শ্রোতা API নিলাম প্রতিবেদন তৈরি করার জন্য বিক্রেতা এবং ক্রেতা নির্দেশিকা।

এই নিবন্ধটি প্রোটেক্টেড অডিয়েন্স API নিলাম জয়ের জন্য রিপোর্ট তৈরির জন্য একটি প্রযুক্তিগত রেফারেন্স, যেমনটি পরীক্ষামূলক প্রোটেক্টেড অডিয়েন্স API-এর বর্তমান পুনরাবৃত্তিতে ব্যবহৃত হয়েছে।

প্রোটেক্টেড অডিয়েন্স API-এর সম্পূর্ণ জীবনচক্রের জন্য ডেভেলপার গাইডটি পড়ুন এবং ইভেন্ট-লেভেল রিপোর্টিং (অস্থায়ী) সম্পর্কে গভীর আলোচনার জন্য প্রোটেক্টেড অডিয়েন্স API ব্যাখ্যাকারীটি দেখুন।

ডেভেলপার নন? Protected Audience API API ওভারভিউ দেখুন।

সুরক্ষিত শ্রোতা API কী রিপোর্ট করে?

দুটি সুরক্ষিত শ্রোতা API রিপোর্ট উপলব্ধ রয়েছে:

  • বিক্রেতা রিপোর্ট : বিজ্ঞাপন নিলাম বিজয়ীর নাম বিক্রেতাকে অবহিত করে।
  • ক্রেতার প্রতিবেদন : শুধুমাত্র বিজয়ী ক্রেতাদের জন্য উপলব্ধ, তারা জানতে পারবেন যে তারা নিলাম জিতেছেন।

দীর্ঘমেয়াদী পরিকল্পনা হল ব্রাউজারকে Private Aggregation 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() উভয় ক্ষেত্রেই একাধিকবার কল করা যেতে পারে, বিভিন্ন URL আর্গুমেন্ট সহ।

নিলাম সম্পূর্ণ হওয়ার পরই Chrome শুধুমাত্র ডিবাগ ক্ষতি/জয় রিপোর্ট পাঠায়। যদি নিলাম বাতিল করা হয় (উদাহরণস্বরূপ, নতুন নেভিগেশনের কারণে), তাহলে কোনও রিপোর্ট তৈরি হবে না।

chrome://settings/adPrivacy এর অধীনে সমস্ত বিজ্ঞাপন গোপনীয়তা API সক্ষম করলে Chrome-এ এই পদ্ধতিগুলি ডিফল্টরূপে উপলব্ধ থাকে। যদি আপনি Protected Audience API সক্ষম করার জন্য কমান্ড লাইন ফ্ল্যাগ সহ Chrome চালাচ্ছেন, তাহলে আপনাকে BiddingAndScoringDebugReportingAPI ফ্ল্যাগ অন্তর্ভুক্ত করে পদ্ধতিগুলি স্পষ্টভাবে সক্ষম করতে হবে। যদি ফ্ল্যাগটি সক্ষম না থাকে, তাহলে পদ্ধতিগুলি এখনও উপলব্ধ থাকবে কিন্তু কিছুই করবে না।

সকল সুরক্ষিত শ্রোতা API API রেফারেন্স

API রেফারেন্স গাইড উপলব্ধ:

সুরক্ষিত শ্রোতা API ব্যাখ্যাকারী বৈশিষ্ট্য সমর্থন এবং সীমাবদ্ধতা সম্পর্কে বিশদ প্রদান করে।

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.