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

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

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

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

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

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

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

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

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

একটি নিলাম চালানোর জন্য পূর্বশর্ত

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

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

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

scoreAd()

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

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

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

• adMetaData , যা ক্রেতা দ্বারা প্রদত্ত বিজ্ঞাপন ক্রিয়েটিভ সম্পর্কে নির্বিচারে মেটাডেটা। এটি একটি JSON সিরিয়ালাইজেবল অবজেক্ট যা বিক্রেতা এবং ক্রেতাদের গঠন সংজ্ঞায়িত এবং সম্মত হতে হবে।
• bid , যা বিডের প্রতিনিধিত্বকারী একটি সংখ্যাসূচক মান।
• auctionConfig , যা নিলাম নির্বাহ করতে ব্যবহৃত নিলাম কনফিগারেশন।
• trustedScoringSignals , যা বিক্রেতার কী/মান সার্ভার থেকে নিলামের সময় পড়া সংকেত। প্ল্যাটফর্ম এই সন্ধানের জন্য প্রার্থীর বিজ্ঞাপনের 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 নিলাম চালান

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

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