একটি একক বিক্রেতার সাথে একটি ব্রাউজার ভিত্তিক নিলাম চালান৷

এই ডকুমেন্টে, আপনি একজন একক বিক্রেতার জন্য সুরক্ষিত দর্শক ডেটা সহ নিলাম পরিচালনার জন্য একটি উচ্চ-স্তরের ওভারভিউ পাবেন, যা সুরক্ষিত দর্শক API-এর বর্তমান পুনরাবৃত্তিতে ব্যবহৃত হয়েছে। একাধিক বিক্রেতাকে জড়িত করে আরও জটিল নিলামের অংশ হিসাবে একজন একক বিক্রেতার সাথে নিলাম সম্পাদন করা যেতে পারে। এই ক্ষেত্রে, একক বিক্রেতার নিলামকে "কম্পোনেন্ট নিলাম" বলা হয়, যা একাধিক বিক্রেতা অংশগ্রহণকারী "শীর্ষ স্তরের নিলাম"-এ বিজ্ঞাপন প্রার্থী প্রদান করতে পারে।

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

একটি সুরক্ষিত দর্শক API বিজ্ঞাপন নিলামের ছয়টি ধাপ

একজন ব্যবহারকারী এমন একটি সাইট পরিদর্শন করেন যেখানে বিজ্ঞাপন দেখানো হয়।
বিক্রেতার কোড navigator.runAdAuction() কার্যকর করে। এটি নির্দিষ্ট করে যে কোন বিজ্ঞাপন স্থান বিক্রয়ের জন্য এবং কারা বিড করতে পারবে। বিক্রেতাদের অবশ্যই একটি স্ক্রিপ্ট অন্তর্ভুক্ত করতে হবে যা প্রতিটি বিডকে স্কোর করে, scoreAd() ।
আমন্ত্রিত ক্রেতার কোডটি একটি বিড, প্রাসঙ্গিক বিজ্ঞাপন সৃজনশীলের জন্য URL এবং অন্যান্য ডেটা তৈরি করতে কার্যকর হয়। বিডিং স্ক্রিপ্টটি ক্রেতার কী/মান পরিষেবা থেকে রিয়েল-টাইম ডেটা, যেমন অবশিষ্ট বিজ্ঞাপন প্রচারণার বাজেটের জন্য অনুসন্ধান করতে পারে।
বিক্রেতার কোড প্রতিটি বিডকে স্কোর করে এবং একজন বিজয়ী নির্বাচন করে। এই লজিক বিডের মান এবং অন্যান্য ডেটা ব্যবহার করে একটি বিডের আকাঙ্ক্ষিততা ফেরত দেয়। যেসব বিজ্ঞাপন প্রাসঙ্গিক বিজয়ীকে ছাড়িয়ে যেতে পারে না, সেগুলি প্রত্যাখ্যান করা হয়। বিক্রেতা রিয়েল-টাইম ডেটার জন্য তাদের নিজস্ব কী/মান পরিষেবা ব্যবহার করতে পারেন।
বিজয়ী বিজ্ঞাপনটি একটি অস্বচ্ছ মান হিসেবে ফেরত পাঠানো হবে, যা একটি বেড়াযুক্ত ফ্রেমে প্রদর্শিত হবে। বিক্রেতা এবং প্রকাশক উভয়ই এই মানটি দেখতে পারবেন না।
নিলামের খবর বিক্রেতা এবং বিজয়ী ক্রেতাদের জানানো হয়।

কোনও ব্যবহারকারী যখন কোনও বিজ্ঞাপন প্রদর্শনকারী পৃষ্ঠায় যান তখন নিলাম হতে পারে। নিলামগুলি সময়ের আগে করা যেতে পারে যাতে বিজ্ঞাপন স্লটটি দৃশ্যমান হওয়ার সাথে সাথে বিজ্ঞাপন সৃজনশীল প্রস্তুত থাকে।

বিক্রেতারা বিজ্ঞাপন নিলাম শুরু করেন, scoreAd() ফাংশন হিসেবে প্রদত্ত কাস্টম লজিক ব্যবহার করে প্রার্থীর বিজ্ঞাপন স্কোর করেন এবং নিলামের ফলাফল নিজেদের এবং বিজয়ী ক্রেতাকে জানানোর জন্য দায়ী। বিক্রেতারা তাদের scoreAd() ফাংশন ব্যবহার করে প্রকাশকের নিয়ম প্রয়োগ করতে এবং বিজ্ঞাপনের মানের জন্য ফিল্টার করতে সক্ষম।

একজন বিক্রেতা উল্লেখ করতে পারেন:

কন্টেন্ট প্রকাশকরা, তাদের ওয়েবসাইটে বিজ্ঞাপনের কন্টেন্ট হোস্ট করার জন্য নিজেরাই কাজ করছেন
সরবরাহ-সাইড প্ল্যাটফর্ম (SSPs), বিজ্ঞাপন প্রকাশকের সাথে কাজ করা এবং অন্যান্য পরিষেবা প্রদান করা
তৃতীয় পক্ষের স্ক্রিপ্ট, যা প্রকাশকদের বিজ্ঞাপন নিলামে অংশগ্রহণের সুযোগ করে দেয়।

নিলাম পরিচালনার পূর্বশর্ত

নিলাম পরিচালনার জন্য একজন বিক্রেতার দুটি জাভাস্ক্রিপ্ট ফাংশন সংজ্ঞায়িত করা প্রয়োজন:

scoreAd() , যা একটি বিজ্ঞাপন প্রার্থীকে স্কোর করে
reportResult() , যা বিক্রেতার কাছে নিলামের ফলাফল রিপোর্ট করার কাজ পরিচালনা করে।

এই স্ক্রিপ্টগুলি বিক্রেতার মালিকানাধীন একটি একক প্রান্ত থেকে পরিবেশন করা প্রয়োজন।

`scoreAd()`

একজন বিক্রেতাকে একটি scoreAd() ফাংশন সংজ্ঞায়িত করতে হবে যা তার মালিকানাধীন একটি এন্ডপয়েন্ট থেকে পরিবেশিত হয়। নিলাম কনফিগারেশনে এন্ডপয়েন্টটি decisionLogicUrl হিসাবে নির্দিষ্ট করা আছে। scoreAd() ফাংশনটিতে নিম্নলিখিত স্বাক্ষর রয়েছে:

scoreAd(
  adMetadata,
  bid,
  auctionConfig,
  trustedScoringSignals,
  browserSignals,
  directFromSellerSignals)

scoreAd() প্যারামিটারগুলি হল:

adMetaData , যা ক্রেতা কর্তৃক প্রদত্ত বিজ্ঞাপন সৃজনশীলতার বিষয়ে ইচ্ছামত মেটাডেটা। এটি একটি JSON সিরিয়ালাইজেবল অবজেক্ট যা বিক্রেতা এবং ক্রেতাদের সংজ্ঞায়িত করতে হবে এবং কাঠামোর উপর একমত হতে হবে।
bid , যা একটি সংখ্যাসূচক মান যা বিডকে প্রতিনিধিত্ব করে।
auctionConfig , যা নিলাম সম্পাদনের জন্য ব্যবহৃত নিলাম কনফিগারেশন।
trustedScoringSignals , যা নিলামের সময় বিক্রেতার Key/Value সার্ভার থেকে পঠিত সংকেত। এই লুকআপের জন্য প্ল্যাটফর্মটি প্রার্থী বিজ্ঞাপনের renderUrl কী হিসেবে ব্যবহার করবে।
browserSignals , যা ব্রাউজার দ্বারা নির্মিত একটি বস্তু, যার মধ্যে ব্রাউজার যা জানে এবং বিক্রেতার নিলাম স্ক্রিপ্ট যা যাচাই করতে চাইতে পারে তার তথ্য অন্তর্ভুক্ত।
directFromSellerSignals হল এমন একটি অবজেক্ট যাতে নিম্নলিখিত ক্ষেত্রগুলি থাকতে পারে: ** sellerSignals : auctionConfig.sellerSignals এর মতো, কিন্তু directFromSellerSignals প্রক্রিয়া ব্যবহার করে পাস করা হয়েছে। ** auctionSignals : auctionConfig.auctionSignals এর মতো, কিন্তু directFromSellerSignals প্রক্রিয়া ব্যবহার করে পাস করা হয়েছে।

নিচে browserSignals এর একটি উদাহরণ দেওয়া হল। মনে রাখবেন যে প্রার্থীর বিজ্ঞাপনের renderUrl এই সংকেতগুলির মাধ্যমে উপলব্ধ:

{ 'topWindowHostname': 'www.example-publisher.com',
  'interestGroupOwner': 'https://www.example-buyer.com',
  'renderURL': 'https://cdn.com/render_url_of_bid',
  'renderSize': {width: 100, height: 200}, /* if specified in the bid */
  'adComponents': ['https://cdn.com/ad_component_of_bid',
                   'https://cdn.com/next_ad_component_of_bid',
                   ...],
  'biddingDurationMsec': 12,
  'bidCurrency': 'USD', /* bidCurrency returned by generateBid, or '???' if none */
  'dataVersion': 1, /* Data-Version value from the trusted scoring signals server's response */
}

`reportResult()`

একজন বিক্রেতাকে একটি reportResult() ফাংশন সংজ্ঞায়িত করতে হবে যা তাদের মালিকানাধীন একটি এন্ডপয়েন্ট থেকে পরিবেশিত হয়। নিলাম কনফিগারেশনে এন্ডপয়েন্টটি decisionLogicUrl হিসাবে নির্দিষ্ট করা আছে। reportResult() ফাংশনটিতে নিম্নলিখিত স্বাক্ষর রয়েছে:

reportResult(auctionConfig, browserSignals) {
  ...
  return signalsForWinner;
}

reportResult() প্যারামিটারগুলি হল:

auctionConfig , যা নিলাম সম্পাদনের জন্য ব্যবহৃত নিলাম কনফিগারেশন।
browserSignals , যা ব্রাউজার দ্বারা নির্মিত একটি অবজেক্ট, যার মধ্যে ব্রাউজার যা জানে এবং বিক্রেতার নিলাম স্ক্রিপ্ট যা যাচাই করতে চাইতে পারে তা অন্তর্ভুক্ত। এটি scoreAds() ফাংশনে পাস করা একই অবজেক্ট।

reportResult() signalsForWinner ফেরত পাঠায়, যা একটি ইচ্ছামত JSON অবজেক্ট যা বিজয়ী ক্রেতার রিপোর্টিং ফাংশনে পাঠানো হয়। এর মধ্যে ক্রেতার রিপোর্টিংয়ের জন্য প্রয়োজনীয় নিলাম সম্পর্কে বিক্রেতা যে কোনও প্রাসঙ্গিক তথ্য সরবরাহ করতে পারে তা অন্তর্ভুক্ত থাকা উচিত।

একটি সুরক্ষিত শ্রোতা API নিলাম চালান

নিলাম পরিচালনা করার জন্য একজন বিক্রেতাকে চারটি প্রধান ধাপ অনুসরণ করতে হবে। মনে রাখবেন যে এই ধাপগুলি ধরে নেয় যে বিক্রেতার কাছে এই নির্দেশিকায় পূর্বে উল্লিখিত প্রয়োজনীয় জাভাস্ক্রিপ্ট ফেরত দেওয়ার জন্য একটি এন্ডপয়েন্ট সেট আপ করা আছে।

নিলাম কনফিগার করুন। এই ধাপে একটি auctionConfig অবজেক্ট তৈরি করা অন্তর্ভুক্ত। এটি বিক্রেতাকে কোন ক্রেতার নিলামে অংশগ্রহণ করা উচিত তা নির্দিষ্ট করতে সক্ষম করে, পাশাপাশি বিড তৈরি বা বিজ্ঞাপন স্কোরিংয়ের সময় প্রাসঙ্গিক হতে পারে এমন কোনও সংকেত প্রদান করে।
পূর্ববর্তী ধাপে তৈরি কনফিগারেশনটি পাস করে navigator.runAdAuction() এ কল করে নিলামটি সম্পাদন করুন। এটি ক্রেতাদের বিড তৈরির, তারপর স্কোর করার শৃঙ্খল শুরু করে। এই ধাপের শেষ ফলাফল হল একটি বিজ্ঞাপন প্রার্থী যা একটি বিজ্ঞাপন প্রদর্শনের জন্য রেন্ডার করা যেতে পারে।
বিজয়ী বিজ্ঞাপনটি একটি বেড়াযুক্ত ফ্রেম বা আইফ্রেমে রেন্ডার করুন ।
নিলামের ফলাফল রিপোর্ট করুন। navigator.sendReportTo() নামে একটি ফাংশন আছে যা রিপোর্টিং শুরু করবে। বিক্রেতা সর্বদা নিলামের ফলাফলের একটি রিপোর্ট পাবেন। শুধুমাত্র নিলামে জয়ী ক্রেতাই একটি রিপোর্ট পাবেন। এটি তাদের সার্ভারে রিপোর্ট করার জন্য এই নির্দেশিকায় পূর্বে বর্ণিত বিক্রেতার reportResult() ব্যবহার করে।