একজন বিজ্ঞাপন ক্রেতা (ডিএসপি এবং বিজ্ঞাপনদাতা) হিসাবে, আপনি বিজ্ঞাপনদাতার সাইটে সংজ্ঞায়িত আগ্রহ গোষ্ঠীতে একটি বিজ্ঞাপন লক্ষ্য করতে প্রকাশকের সাইটে একটি সুরক্ষিত দর্শক বিজ্ঞাপন নিলামে অংশগ্রহণ করতে আগ্রহী হতে পারেন৷ সুরক্ষিত শ্রোতা নিলামে অংশগ্রহণ করে, আপনি গোপনীয়তা-সংরক্ষণের উপায়ে অন্যান্য সাইটে আপনার চিহ্নিত গ্রাহকদের কাছে পৌঁছাতে সক্ষম হন।
একটি সুরক্ষিত দর্শক নিলামে, আপনি বিড জেনারেট করার জন্য যুক্তি প্রদান করেন এবং ব্রাউজার সেই যুক্তি ব্যবহার করে বিড গণনা করে। এটি অন্যান্য নিলাম আর্কিটেকচারের বিপরীতে যেখানে আপনি যুক্তি প্রদানের বিপরীতে সরাসরি বিড জমা দেন।
আপনি generateBid()
JavaScript ফাংশনে আপনার বিড জেনারেশন লজিক সরবরাহ করেন এবং ফাইলটি আপনার সার্ভারে হোস্ট করা হয়। আপনি যখন একজন ব্যবহারকারীকে একটি আগ্রহের গোষ্ঠীতে যুক্ত করেন , তখন এই ফাইলের অবস্থানটি একটি biddingLogicUrl
হিসাবে আগ্রহের গ্রুপ কনফিগারে পাঠানো হয়।
নিলামের সময়, ব্রাউজার বিডিং লজিক biddingLogicUrl
ক্ষেত্রে নির্দিষ্ট করা আপনার বিডিং লজিক নিয়ে আসে এবং প্রতিটি স্বার্থ গোষ্ঠীর জন্য আপনার generateBid()
ফাংশনটি একটি নিরাপদ বিচ্ছিন্ন পরিবেশে চালায় যা বাইরের প্রেক্ষাপটের সাথে যোগাযোগে সীমাবদ্ধ। যখন generateBid()
কার্যকর করা হয়, ব্রাউজার আর্গুমেন্ট হিসাবে ফাংশনে সংকেত দেয়। এই সংকেতগুলিতে বিভিন্ন উত্স থেকে বিভিন্ন তথ্য থাকে, যেমন প্রকাশকের প্রথম পক্ষের ডেটা, বিক্রেতার ডেটা, রিয়েল-টাইম ডেটা এবং আরও অনেক কিছু। আপনি বিড গণনা করতে এই সংকেতগুলি ব্যবহার করতে পারেন, এবং মানটি generateBid()
কল থেকে ফেরত দেওয়া হয়। বিডগুলি জমা দেওয়ার পরে, ব্রাউজার বিক্রেতার পছন্দসই স্কোর গণনা করতে প্রতিটি বিডের উপর বিক্রেতার স্কোরিং লজিক চালাবে।
generateBid()
নিম্নলিখিত generateBid()
ফাংশনের আর্গুমেন্ট এবং ফাংশন থেকে ফেরত বিডের গঠন বর্ণনা করে:
generateBid(interestGroup, auctionSignals, perBuyerSignals,
trustedBiddingSignals, browserSignals, directFromSellerSignals) {
return {
ad: adObject,
adCost: optionalAdCost,
bid: bidValue,
bidCurrency: 'USD',
render: {
url: renderURL,
width: renderWidth,
height: renderHeight
},
adComponents: [
{url: adComponent1, width: componentWidth1, height: componentHeight1},
{url: adComponent2, width: componentWidth2, height: componentHeight2},
// ...
],
allowComponentAuction: false,
modelingSignals: 123 // 0-4095 integer (12-bits)
};
}
যুক্তি
generateBid()
নিম্নলিখিত আর্গুমেন্ট নেয়:
যুক্তি | ভূমিকা |
---|---|
| একটি বস্তু বিজ্ঞাপন ক্রেতা দ্বারা পাস. আগ্রহের গোষ্ঠী dailyUpdateUrl দিয়ে আপডেট করা যেতে পারে। |
| বিক্রেতার দ্বারা navigator.runAdAuction() কে পাস করা নিলাম কনফিগার আর্গুমেন্টের একটি সম্পত্তি। এটি পৃষ্ঠার প্রসঙ্গ (যেমন বিজ্ঞাপনের আকার এবং প্রকাশক আইডি), নিলামের ধরন (প্রথম-মূল্য বা দ্বিতীয়-মূল্য) এবং অন্যান্য মেটাডেটা সম্পর্কে তথ্য প্রদান করে। |
| বিক্রেতার দ্বারা পাস করা নিলাম কনফিগার আর্গুমেন্টের একটি সম্পত্তি। এটি পৃষ্ঠা সম্পর্কে ক্রেতার সার্ভার থেকে প্রাসঙ্গিক সংকেত প্রদান করতে পারে, যদি বিক্রেতা একজন SSP হয় যা ক্রেতা সার্ভারের কাছে একটি রিয়েল-টাইম বিডিং কল করে এবং প্রতিক্রিয়াটি পাইপ করে, অথবা যদি প্রকাশক পৃষ্ঠাটি ক্রেতার সার্ভারের সাথে সরাসরি যোগাযোগ করে। যদি তাই হয়, ক্রেতা বিড়ম্বনার বিরুদ্ধে সুরক্ষা হিসাবে generateBid() এর ভিতরে সেই সংকেতগুলির একটি ক্রিপ্টোগ্রাফিক স্বাক্ষর পরীক্ষা করতে চাইতে পারেন। |
| একটি বস্তু যার কীগুলি হল আগ্রহ গোষ্ঠীর জন্য trustedBiddingSignalsKeys এবং যার মান trustedBiddingSignals অনুরোধে ফেরত দেওয়া হয়৷ |
| ব্রাউজার দ্বারা নির্মিত একটি বস্তু, যাতে পৃষ্ঠার প্রসঙ্গের তথ্য অন্তর্ভুক্ত থাকতে পারে (যেমন বর্তমান পৃষ্ঠার hostname , যা বিক্রেতা অন্যথায় জাল করতে পারে) এবং আগ্রহ গোষ্ঠীর জন্য ডেটা (যেমন গ্রুপটি পূর্বে কখন জিতেছিল তার রেকর্ড নিলাম, অন-ডিভাইস ফ্রিকোয়েন্সি ক্যাপিংয়ের অনুমতি দিতে)। |
| যে সিগন্যালগুলি একটি নির্দিষ্ট বিক্রেতার কাছ থেকে আসার গ্যারান্টিযুক্ত, নিলামের বিপরীতে auctionSignals এবং sellerSignals যে কোনও অংশগ্রহণকারীর কাছ থেকে আসতে পারে যেটি runAdAuction চালানো হয় সেই প্রসঙ্গে উপস্থিত থাকে৷ |
ব্রাউজার সংকেত
browserSignals
অবজেক্টের নিম্নলিখিত বৈশিষ্ট্য রয়েছে:
{
topWindowHostname: 'publisher.example',
seller: 'https://ssp.example',
topLevelSeller: 'https://www.top-level-ssp.com',
requestedSize: {width: 100, height: 200}, /* if specified in auction config */
joinCount: 3,
recency: 3600000,
bidCount: 17,
prevWinsMs: [[timeDeltaMs1,ad1],[timeDeltaMs2,ad2],...],
wasmHelper: ...
dataVersion: 1,
adComponentsLimit: 40
}
সম্পত্তি | বর্ণনা |
---|---|
| যেখানে runAdAuction() কল করা হয়েছিল তার হোস্টনাম। |
| যে বিক্রেতার কাছে বিড জমা দেওয়া হয়। একটি উপাদান নিলামে, এই মানটি উপাদান বিক্রেতা। |
| একটি উপাদান নিলামে শীর্ষ-স্তরের বিক্রেতা, এবং শুধুমাত্র একটি উপাদান নিলামে উপস্থিত থাকে। |
| requestedSize সম্পত্তি নিলামের জন্য একটি ফ্রেমের আকারের সুপারিশ করে। বিক্রেতা নিলাম কনফিগারেশনে অনুরোধকৃত আকার সেট করে, এবং মানটি generateBid() এ বিডারদের কাছে উপলব্ধ হয়ে যায়। নিলামের অভ্যন্তরে দরদাতারা বিজ্ঞাপনের জন্য একটি ভিন্ন বিষয়বস্তুর আকার বাছাই করতে পারে এবং সেই ফলস্বরূপ আকারটি উপাদানটির কন্টেইনার আকারের মধ্যে ফিট করার জন্য দৃশ্যত আকারে স্কেল করা হবে৷ |
| joinCount ক্ষেত্রটি হল এই ডিভাইসটি গত 30 দিনে এই আগ্রহের গোষ্ঠীতে যোগদান করার সংখ্যা যখন আগ্রহ গোষ্ঠীটি ক্রমাগত সঞ্চয় করা হয়েছে (অর্থাৎ, ছেড়ে যাওয়ার কারণে ডিভাইসে আগ্রহ গোষ্ঠীর সঞ্চয়স্থানে কোনও ফাঁক নেই বা সদস্যপদ মেয়াদ শেষ)। |
| recency ফিল্ড হল সময়কাল (মিনিটের মধ্যে) যখন এই ডিভাইসটি এই আগ্রহের গোষ্ঠীতে যোগ দিয়েছে তখন থেকে এখন পর্যন্ত৷ |
| যে সুদ গ্রুপ একটি বিড জমা দিয়েছে সংখ্যা. |
| prevWinMs ফিল্ডে আগ্রহ গ্রুপের বিজয়ী বিজ্ঞাপন এবং মিলিসেকেন্ডে তাদের আগের জয়ের সময় রয়েছে। মনে রাখবেন যে এখানে বিজ্ঞাপন অবজেক্টে শুধুমাত্র renderURL এবং মেটাডেটা ক্ষেত্র রয়েছে। |
| একটি WebAssembly. মডিউল অবজেক্ট ইন্টারেস্ট গ্রুপের biddingWasmHelperURL এর উপর ভিত্তি করে। |
| ক্রেতার কী/মান পরিষেবা প্রতিক্রিয়া(গুলি) থেকে ডেটা-সংস্করণের মান। |
| generateBid() বিজ্ঞাপন উপাদানের সর্বাধিক সংখ্যা ফিরে আসতে পারে |
একটি বিড গণনা
একটি বিড মান গণনা করতে, generateBid()
এর কোড ফাংশনের পরামিতিগুলির বৈশিষ্ট্য ব্যবহার করতে পারে।
যেমন:
function generateBid(interestGroup, auctionSignals, perBuyerSignals,
trustedBiddingSignals, browserSignals) {
return {
// ...
bid: auctionSignals.is_above_the_fold ? perBuyerSignals.atf_value : perBuyerSignals.btf_value,
// ...
}
}
একটি বিড ফেরত
generateBid()
নিম্নলিখিত বৈশিষ্ট্য সহ একটি বস্তু ফেরত দেয়:
সম্পত্তি | ভূমিকা |
---|---|
ad | বিজ্ঞাপন সম্পর্কে নির্বিচারে মেটাডেটা, যেমন তথ্য বিক্রেতা এই বিড বা বিজ্ঞাপন সৃজনশীল সম্পর্কে জানতে চান। বিক্রেতা তার নিলাম এবং সিদ্ধান্ত যুক্তিতে এই তথ্য ব্যবহার করে। |
adCost | রিপোর্টিং বিজ্ঞাপনদাতা ক্লিক বা রূপান্তর খরচ generateBid থেকে reportWin পাস করতে ব্যবহৃত একটি সংখ্যাসূচক মান। এই সংখ্যার নির্ভুলতা একটি 8-বিট ম্যান্টিসা এবং 8-বিট সূচকের মধ্যে সীমাবদ্ধ, যে কোনও রাউন্ডিং স্টোকাস্টিকভাবে সঞ্চালিত হয়। |
adComponents | navigator.joinAdInterestGroup() এ পাস করা স্বার্থ গোষ্ঠীর আর্গুমেন্টের adComponents সম্পত্তি থেকে নেওয়া একাধিক টুকরো দিয়ে তৈরি বিজ্ঞাপনের জন্য 20টি পর্যন্ত উপাদানের ঐচ্ছিক তালিকা। |
allowComponentAuction | একটি বুলিয়ান মান নির্দেশ করে যে এই বিডটি একটি উপাদান নিলামে ব্যবহার করা যেতে পারে কিনা। নির্দিষ্ট না থাকলে ডিফল্ট "মিথ্যা"। |
bid | একটি সংখ্যাসূচক বিড যা নিলামে প্রবেশ করবে। বিক্রেতাকে অবশ্যই বিভিন্ন ক্রেতার কাছ থেকে বিড তুলনা করার অবস্থানে থাকতে হবে, তাই বিডগুলি অবশ্যই বিক্রেতা-নির্বাচিত কিছু ইউনিটে হতে হবে (যেমন "প্রতি হাজারে USD")। যদি বিড শূন্য বা ঋণাত্মক হয়, তাহলে এই স্বার্থ গোষ্ঠীটি বিক্রেতার নিলামে মোটেও অংশগ্রহণ করবে না। এই পদ্ধতির সাহায্যে, ক্রেতা তাদের বিজ্ঞাপনগুলি যেখানে প্রদর্শিত হতে পারে বা নাও হতে পারে তার জন্য বিজ্ঞাপনদাতার যেকোনো নিয়ম বাস্তবায়ন করতে পারে। |
bidCurrency | বিডের জন্য মুদ্রা, মুদ্রা-পরীক্ষার জন্য ব্যবহৃত হয়। |
render | এই বিড নিলামে জিতলে সৃজনশীলের বর্ণনা দেয় এমন একটি অভিধান যা রেন্ডার করা উচিত। এর মধ্যে রয়েছে:
|
| একটি 0-4095 পূর্ণসংখ্যা (12-বিট) reportWin() -এ পাস করা হয়েছে, শোরগোল সহ, যেমন নয়েজিং এবং বাকেটিং স্কিমে বর্ণিত হয়েছে। নেতিবাচক, অসীম এবং NaN মানগুলির মতো অবৈধ মানগুলি উপেক্ষা করা হবে এবং পাস করা হবে না৷ শুধুমাত্র সর্বনিম্ন 12 বিট পাস করা হবে.ক্রেতা generateBid() ফাংশনের ভিতরে উপলব্ধ সিগন্যালগুলি ব্যবহার করতে পারেন, যার মধ্যে প্রথম পক্ষের ক্রেতার ডেটা থেকে userBiddingSignals আগ্রহের গ্রুপ তৈরির সময় ক্যাপচার করা হয়, এমএল মডেল প্রশিক্ষণ সক্ষম করার জন্য ক্রেতার উইন রিপোর্টিং ফাংশনে পাস করা কিছু মান অর্জন করতে। |