FLEDGE API বিকাশকারী গাইড

এই নিবন্ধটি কার জন্য?

এই পোস্টটি পরীক্ষামূলক সুরক্ষিত শ্রোতা API এর বর্তমান পুনরাবৃত্তির একটি প্রযুক্তিগত রেফারেন্স।

সুরক্ষিত শ্রোতা কি?

Protected Audience API হল একটি গোপনীয়তা স্যান্ডবক্স প্রস্তাবনা যা পুনঃবিপণন এবং কাস্টম শ্রোতাদের ব্যবহারের ক্ষেত্রে পরিবেশন করার জন্য, ডিজাইন করা হয়েছে যাতে এটি সাইট জুড়ে ব্যবহারকারীর ব্রাউজিং আচরণ ট্র্যাক করতে তৃতীয় পক্ষ ব্যবহার করতে না পারে৷ এপিআই ব্রাউজার দ্বারা ডিভাইসে নিলামে সক্ষম করে, ব্যবহারকারী পূর্বে পরিদর্শন করা ওয়েবসাইটগুলির জন্য প্রাসঙ্গিক বিজ্ঞাপন বেছে নিতে।

Protected Audience হল প্রথম পরীক্ষা যা Chromium-এ TURTLEDOVE প্রস্তাবনার পরিবারের মধ্যে প্রয়োগ করা হয়েছে৷

নীচের চিত্রটি FLEDGE জীবনচক্রের একটি ওভারভিউ প্রদান করে:

FLEDGE জীবনচক্রের প্রতিটি পর্যায়ের একটি সংক্ষিপ্ত বিবরণ প্রদান করে দৃষ্টান্ত
FLEDGE জীবনচক্র।

আমি কিভাবে সুরক্ষিত শ্রোতা চেষ্টা করতে পারি?

সুরক্ষিত শ্রোতা ডেমো

বিজ্ঞাপনদাতা এবং প্রকাশক সাইট জুড়ে একটি মৌলিক সুরক্ষিত শ্রোতা স্থাপনের একটি ওয়াকথ্রু protected-audience-demo.web.app এ উপলব্ধ।

ডেমো ভিডিও ব্যাখ্যা করে যে ডেমো কোড কীভাবে কাজ করে এবং কীভাবে সুরক্ষিত দর্শক ডিবাগিংয়ের জন্য Chrome DevTools ব্যবহার করতে হয় তা দেখায়।

একটি সুরক্ষিত অডিয়েন্স অরিজিন ট্রায়ালে অংশ নিন

একটি গোপনীয়তা স্যান্ডবক্স প্রাসঙ্গিকতা এবং পরিমাপ মূল ট্রায়াল ক্রোম বিটা 101.0.4951.26 এবং তার উপরে ডেস্কটপে সুরক্ষিত দর্শক, বিষয় এবং অ্যাট্রিবিউশন রিপোর্টিং API-এর জন্য উপলব্ধ করা হয়েছে৷

অংশ নিতে, একটি অরিজিন ট্রায়াল টোকেনের জন্য নিবন্ধন করুন ৷

একবার আপনি সফলভাবে ট্রায়ালে নথিভুক্ত হয়ে গেলে, আপনি একটি বৈধ ট্রায়াল টোকেন প্রদান করে এমন পৃষ্ঠাগুলিতে সুরক্ষিত শ্রোতা জাভাস্ক্রিপ্ট API ব্যবহার করে দেখতে পারেন: উদাহরণস্বরূপ, ব্রাউজারকে এক বা একাধিক আগ্রহের গোষ্ঠীতে যোগ দিতে বলা এবং তারপর একটি বিজ্ঞাপন নির্বাচন এবং প্রদর্শন করতে একটি বিজ্ঞাপন নিলাম চালানোর জন্য৷

প্রোটেক্টেড অডিয়েন্স ডেমো এন্ড-টু-এন্ড প্রোটেক্টেড অডিয়েন্স ডিপ্লয়মেন্টের একটি মৌলিক উদাহরণ প্রদান করে।

প্রতিটি পৃষ্ঠার জন্য একটি ট্রায়াল টোকেন প্রদান করুন যেখানে আপনি সুরক্ষিত দর্শক API কোড চালাতে চান:

  • <head> এ একটি মেটা ট্যাগ হিসাবে:

    <meta http-equiv="origin-trial" content="TOKEN_GOES_HERE">

  • একটি HTTP শিরোনাম হিসাবে:

    Origin-Trial: TOKEN_GOES_HERE

  • প্রোগ্রামগতভাবে একটি টোকেন প্রদান করে: 

    const otMeta = document.createElement('meta');
otMeta.httpEquiv = 'origin-trial';
otMeta.content = 'TOKEN_GOES_HERE';
document.head.append(otMeta);

একটি আইফ্রেম চলমান সুরক্ষিত শ্রোতা কোড—যেমন একটি navigator.joinAdInterestGroup() কোনো স্বার্থ গোষ্ঠীর মালিকের কল—কে একটি টোকেন প্রদান করতে হবে যা এর মূলের সাথে মেলে।

প্রস্তাবিত প্রথম সুরক্ষিত অডিয়েন্স অরিজিন ট্রায়ালের বিবরণ প্রথম ট্রায়ালের লক্ষ্য সম্পর্কে আরও বিশদ প্রদান করে এবং ব্যাখ্যা করে যে কোন বৈশিষ্ট্যগুলি সমর্থিত।

এই API পরীক্ষা করুন

আপনি ডেস্কটপে Chrome বিটা 101.0.4951.26 এবং তার উপরে একটি একক ব্যবহারকারীর জন্য সুরক্ষিত দর্শক পরীক্ষা করতে পারেন:

  • chrome://settings/adPrivacy অধীনে সমস্ত বিজ্ঞাপন গোপনীয়তা API সক্রিয় করার মাধ্যমে
  • কমান্ড লাইন থেকে পতাকা সেট করে।

আইফ্রেম বা বেড়াযুক্ত ফ্রেমে বিজ্ঞাপন রেন্ডার করুন

কোন পতাকা সেট করা হয়েছে তার উপর নির্ভর করে বিজ্ঞাপনগুলি একটি <iframe> বা একটি <fencedframe> -এ রেন্ডার করা যেতে পারে।

বিজ্ঞাপন রেন্ডার করতে <fencedframe> ব্যবহার করতে:

--enable-features=InterestGroupStorage,AdInterestGroupAPI,Fledge,FencedFrames

বিজ্ঞাপন রেন্ডার করতে <iframe> ব্যবহার করতে:

--enable-features=InterestGroupStorage,AdInterestGroupAPI,Fledge,AllowURNsInIframes --disable-features=FencedFrames

অস্থায়ী ডিবাগ ক্ষতি/জয় রিপোর্টিং পদ্ধতিগুলি সক্ষম করতে BiddingAndScoringDebugReportingAPI পতাকা অন্তর্ভুক্ত করুন৷

ফ্ল্যাগ সহ Chromium চালান কমান্ড লাইন থেকে Chrome এবং অন্যান্য Chromium-ভিত্তিক ব্রাউজার চালানোর সময় পতাকা কিভাবে সেট করতে হয় তা ব্যাখ্যা করে। সুরক্ষিত শ্রোতা পতাকার সম্পূর্ণ তালিকা Chromium কোড অনুসন্ধান থেকে উপলব্ধ।

Chrome এর সর্বশেষ সংস্করণে কোন বৈশিষ্ট্যগুলি সমর্থিত?

সুরক্ষিত শ্রোতা প্রস্তাবের নিম্নলিখিত বৈশিষ্ট্যগুলি পরীক্ষা করার জন্য প্রথম পরীক্ষা হিসাবে Chromium-এ বৈশিষ্ট্য পতাকার পিছনে সুরক্ষিত দর্শক উপলব্ধ করা হচ্ছে:

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

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

সুদ গ্রুপ অনুমতি

Protected Audience-এর বর্তমান বাস্তবায়নে ডিফল্ট হল joinAdInterestGroup() পৃষ্ঠার যেকোনো স্থান থেকে এমনকি ক্রস-ডোমেন আইফ্রেম থেকে কল করার অনুমতি দেওয়া। ভবিষ্যতে, একবার সাইটের মালিকরা তাদের ক্রস-ডোমেন আইফ্রেম অনুমতি নীতিগুলি সামঞ্জস্য করার সময় পেয়ে গেলে, ব্যাখ্যাকারীর বর্ণনা অনুসারে ক্রস-ডোমেন আইফ্রেম থেকে কলগুলিকে অস্বীকৃতি জানানোর পরিকল্পনা।

কী/মূল্য পরিষেবা

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

সুরক্ষিত শ্রোতা কী/মান পরিষেবা কোড এখন একটি গোপনীয়তা স্যান্ডবক্স গিটহাব সংগ্রহস্থলে উপলব্ধ। এই পরিষেবাটি Chrome এবং Android ডেভেলপাররা ব্যবহার করতে পারে৷ স্ট্যাটাস আপডেটের জন্য ঘোষণার ব্লগ পোস্টটি দেখুন। API ব্যাখ্যাকারী এবং বিশ্বাস মডেল ব্যাখ্যাকারী থেকে সুরক্ষিত দর্শক কী/মান পরিষেবা সম্পর্কে আরও জানুন।

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

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

বৈশিষ্ট্য সমর্থন সনাক্ত করুন

API ব্যবহার করার আগে, এটি ব্রাউজার দ্বারা সমর্থিত এবং নথিতে উপলব্ধ কিনা তা পরীক্ষা করুন:

'joinAdInterestGroup' in navigator &&
  document.featurePolicy.allowsFeature('join-ad-interest-group') &&
  document.featurePolicy.allowsFeature('run-ad-auction') ?
  console.log('navigator.joinAdInterestGroup() is supported on this page') :
  console.log('navigator.joinAdInterestGroup() is not supported on this page');

আমি কিভাবে সুরক্ষিত শ্রোতা থেকে অপ্ট আউট করতে পারি?

আপনি সাইটের মালিক হিসাবে বা একজন স্বতন্ত্র ব্যবহারকারী হিসাবে সুরক্ষিত দর্শক API-এ অ্যাক্সেস ব্লক করতে পারেন।

সাইটগুলি কীভাবে অ্যাক্সেস নিয়ন্ত্রণ করতে পারে?

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

দুটি সুরক্ষিত শ্রোতা অনুমতি নীতি রয়েছে যা স্বাধীনভাবে সেট করা যেতে পারে:

  • join-ad-interest-group স্বার্থ গোষ্ঠীতে একটি ব্রাউজার যোগ করার কার্যকারিতা সক্ষম/অক্ষম করে
  • run-ad-auction একটি অন-ডিভাইস নিলাম চালানোর জন্য কার্যকারিতা সক্ষম/অক্ষম করে

একটি HTTP প্রতিক্রিয়া শিরোনামে নিম্নলিখিত অনুমতি নীতি নির্দিষ্ট করে প্রথম পক্ষের প্রেক্ষাপটে সুরক্ষিত শ্রোতা API-তে অ্যাক্সেস সম্পূর্ণরূপে অক্ষম করা যেতে পারে:

Permissions-Policy: join-ad-interest-group=(), run-ad-auction=()

আপনি একটি iframe উপাদানে নিম্নলিখিত allow বৈশিষ্ট্য যোগ করে একটি iframe-এ API-এর ব্যবহার নিষ্ক্রিয় করতে পারেন:

<iframe src="https://example.com" allow="join-ad-interest-group 'none'; run-ad-auction 'none'"></iframe>

প্রস্তাবিত প্রথম সুরক্ষিত অডিয়েন্স অরিজিন ট্রায়াল অনুমতি-নীতি বিভাগ আরও বিশদ প্রদান করে।

ব্যবহারকারী অপ্ট-আউট

একজন ব্যবহারকারী নিম্নলিখিত যেকোনও পদ্ধতি ব্যবহার করে সুরক্ষিত দর্শক API এবং অন্যান্য গোপনীয়তা স্যান্ডবক্স বৈশিষ্ট্যগুলিতে অ্যাক্সেস ব্লক করতে পারেন:

  • Chrome সেটিংসে গোপনীয়তা স্যান্ডবক্স ট্রায়ালগুলি অক্ষম করুন : সেটিংস > নিরাপত্তা এবং গোপনীয়তা > গোপনীয়তা স্যান্ডবক্স । এটি chrome://settings/adPrivacy এও অ্যাক্সেসযোগ্য।
  • Chrome সেটিংসে তৃতীয় পক্ষের কুকি অক্ষম করুন : সেটিংস > নিরাপত্তা এবং গোপনীয়তা ।
  • chrome://settings/cookies থেকে কুকিজ এবং অন্যান্য সাইট ডেটা "ব্লক থার্ড-পার্টি কুকিজ" বা "সব কুকিজ ব্লক করুন"-এ সেট করুন।
  • ছদ্মবেশী মোড ব্যবহার করুন।

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

ডিবাগ সুরক্ষিত অডিয়েন্স ওয়ার্কলেট

Chrome Canary 98.0.4718.0 থেকে, Chrome DevTools-এর মধ্যে সুরক্ষিত অডিয়েন্স ওয়ার্কলেটগুলি ডিবাগ করা সম্ভব৷

প্রথম ধাপ হল উৎস প্যানেলে ইভেন্ট লিসেনার ব্রেকপয়েন্ট প্যানে একটি নতুন বিভাগের মাধ্যমে ব্রেকপয়েন্ট সেট করা।

এর স্ক্রিনশট Chrome Canary-এ DevTools, সোর্স প্যানেলে ইভেন্ট লিসেনার ব্রেকপয়েন্ট প্যান হাইলাইট করছে। বিজ্ঞাপন নিলাম ওয়ার্কলেটের অধীনে বিডার বিডিং ফেজ স্টার্ট নির্বাচন করা হয়েছে।

যখন একটি ব্রেকপয়েন্ট ট্রিগার হয়, ওয়ার্কলেট স্ক্রিপ্টের শীর্ষ-স্তরের প্রথম বিবৃতির আগে এক্সিকিউশন থামানো হয়। আপনি বিডিং/স্কোরিং/রিপোর্টিং ফাংশন নিজেই পেতে নিয়মিত ব্রেকপয়েন্ট বা ধাপ কমান্ড ব্যবহার করতে পারেন।

লাইভ ওয়ার্কলেট স্ক্রিপ্টগুলিও থ্রেড প্যানেলের অধীনে প্রদর্শিত হবে।

এর স্ক্রিনশট ক্রোম ক্যানারিতে DevTools, সোর্স প্যানেলে থ্রেড প্যান হাইলাইট করে, বর্তমান দেখাচ্ছে ওয়ার্কলেট স্ক্রিপ্ট যা পজ করা হয়েছে।

যেহেতু কিছু ওয়ার্কলেট সমান্তরালভাবে চলতে পারে, তাই একাধিক থ্রেড সেখানে "পজড" অবস্থায় শেষ হতে পারে; আপনি থ্রেডের মধ্যে সুইচ করতে থ্রেড তালিকা ব্যবহার করতে পারেন, এবং পুনরায় শুরু করতে বা যথাযথভাবে তাদের আরও ঘনিষ্ঠভাবে পরিদর্শন করতে পারেন।

সুরক্ষিত দর্শক ইভেন্টগুলি পর্যবেক্ষণ করুন

Chrome DevTools-এর অ্যাপ্লিকেশান প্যানেল থেকে, আপনি সুরক্ষিত দর্শকের আগ্রহের গোষ্ঠী এবং নিলাম ইভেন্টগুলি পর্যবেক্ষণ করতে পারেন৷

আপনি যদি প্রোটেক্টেড অডিয়েন্স সক্ষম করা ব্রাউজারে প্রোটেক্টেড অডিয়েন্স ডেমো শপিং সাইটে যান, তাহলে DevTools join ইভেন্ট সম্পর্কে তথ্য প্রদর্শন করবে।

দ ক্রোম ক্যানারিতে DevTools অ্যাপ্লিকেশন প্যানেল, একটি সুরক্ষিত শ্রোতাদের আগ্রহের গোষ্ঠী সম্পর্কে তথ্য দেখাচ্ছে৷ ইভেন্টে যোগদান করুন।

এখন, আপনি যদি প্রোটেক্টেড অডিয়েন্স সক্ষম করা ব্রাউজারে প্রোটেক্টেড অডিয়েন্স ডেমো প্রকাশক সাইটে যান, তাহলে DevTools bid এবং win ইভেন্টগুলি সম্পর্কে তথ্য প্রদর্শন করে৷

দ ক্রোম ক্যানারিতে DevTools অ্যাপ্লিকেশন প্যানেল, সুরক্ষিত শ্রোতা নিলাম বিড সম্পর্কে তথ্য দেখাচ্ছে এবং ইভেন্ট জয়।

কিভাবে সুরক্ষিত শ্রোতা API কাজ করে?

এই উদাহরণে, একজন ব্যবহারকারী একটি কাস্টম বাইক নির্মাতার ওয়েবসাইট ব্রাউজ করেন, তারপরে একটি নিউজ ওয়েবসাইট পরিদর্শন করেন এবং বাইক নির্মাতার কাছ থেকে একটি নতুন বাইকের জন্য একটি বিজ্ঞাপন দেখানো হয়৷

1. একজন ব্যবহারকারী একটি বিজ্ঞাপনদাতার সাইটে যান৷

ইলাস্ট্রেশন দেখাচ্ছে একজন ব্যক্তি তাদের ল্যাপটপে একটি ব্রাউজারে একটি কাস্টম বাইক প্রস্তুতকারকের সাইট পরিদর্শন করছেন৷

কল্পনা করুন যে একজন ব্যবহারকারী একটি কাস্টম বাইক প্রস্তুতকারকের (এই উদাহরণে বিজ্ঞাপনদাতা ) ওয়েবসাইটে যান এবং একটি হস্তনির্মিত স্টিল বাইকের জন্য পণ্যের পৃষ্ঠায় কিছু সময় ব্যয় করেন। এটি বাইক নির্মাতাকে একটি পুনঃবিপণনের সুযোগ প্রদান করে।

2. ব্যবহারকারীর ব্রাউজারকে একটি আগ্রহের গোষ্ঠী যুক্ত করতে বলা হয়৷

একজন ব্যক্তিকে তার ল্যাপটপে একটি ব্রাউজারে একটি সাইট দেখছেন এমন চিত্র। জাভাস্ক্রিপ্ট কোড joinAdInterestGroup() ব্রাউজারে চলছে।

ব্যাখ্যাকারী বিভাগ: ব্রাউজার রেকর্ড ইন্টারেস্ট গ্রুপ

বিজ্ঞাপনদাতার ডিমান্ড-সাইড প্ল্যাটফর্ম (ডিএসপি) (অথবা বিজ্ঞাপনদাতা নিজেই) navigator.joinAdInterestGroup() কে কল করে ব্রাউজারটিকে ব্রাউজারটি যে গ্রুপের সদস্য সেগুলির তালিকায় একটি আগ্রহ গোষ্ঠী যুক্ত করতে বলে৷ এই উদাহরণে, গ্রুপটির নাম দেওয়া হয়েছে custom-bikes , এবং মালিক হল dsp.example । আগ্রহ গ্রুপের মালিক (এই ক্ষেত্রে, DSP) ধাপ 4 এ বর্ণিত বিজ্ঞাপন নিলামে একজন ক্রেতা হবেন। ইন্টারেস্ট গ্রুপের সদস্যতা ব্রাউজার দ্বারা, ব্যবহারকারীর ডিভাইসে সংরক্ষণ করা হয় এবং ব্রাউজার বিক্রেতা বা অন্য কারো সাথে শেয়ার করা হয় না।

joinAdInterestGroup() এর থেকে অনুমতি প্রয়োজন:

  • সাইট পরিদর্শন করা হচ্ছে
  • স্বার্থ গ্রুপের মালিক

উদাহরণস্বরূপ: malicious.example এর অনুমতি ছাড়া dsp.example এর মালিক হিসাবে dsp.example joinAdInterestGroup() কল করা সম্ভব হবে না।

সাইট পরিদর্শন করা হচ্ছে থেকে অনুমতি

একই উত্স : ডিফল্টরূপে, যে সাইটটি পরিদর্শন করা হচ্ছে সেই একই উত্স থেকে, অর্থাৎ বর্তমান পৃষ্ঠার শীর্ষ-স্তরের ফ্রেমের মতো একই উত্স থেকে joinAdInterestGroup() কলগুলির জন্য পরোক্ষভাবে অনুমতি দেওয়া হয়৷ joinAdInterestGroup() কল অক্ষম করতে সাইটগুলি একটি সুরক্ষিত শ্রোতা অনুমতি নীতির শিরোনাম join-ad-interest-group নির্দেশিকা ব্যবহার করতে পারে৷

ক্রস অরিজিন : বর্তমান পৃষ্ঠা থেকে ভিন্ন মূল থেকে joinAdInterestGroup() কল করা শুধুমাত্র তখনই সফল হতে পারে যখন পরিদর্শন করা সাইটটিতে একটি অনুমতি নীতি সেট করা থাকে যা ক্রস-অরিজিন iframes থেকে কলগুলিকে যোগদানের জন্য joinAdInterestGroup() অনুমতি দেয়৷

স্বার্থ গ্রুপ মালিক থেকে অনুমতি

স্বার্থ গোষ্ঠীর মালিকের অনুমতি একটি আইফ্রেম থেকে joinAdInterestGroup() কল করার মাধ্যমে অন্তর্নিহিতভাবে মঞ্জুর করা হয় যেটি আগ্রহ গোষ্ঠীর মালিকের মতই। উদাহরণস্বরূপ, একটি dsp.example iframe dsp.example এর মালিকানাধীন স্বার্থ গোষ্ঠীর জন্য joinAdInterestGroup() কল করতে পারে।

প্রস্তাবটি হল joinAdInterestGroup() মালিকের ডোমেনে একটি পৃষ্ঠা বা iframe-এ চলতে পারে, অথবা একটি .well-known URL-এ একটি তালিকা ব্যবহার করে প্রদত্ত অন্যান্য ডোমেনে অর্পিত হতে পারে৷

navigator.joinAdInterestGroup() ব্যবহার করে

API কীভাবে ব্যবহার করা যেতে পারে তার একটি উদাহরণ এখানে দেওয়া হল:

const interestGroup = {
  owner: 'https://dsp.example',
  name: 'custom-bikes',
  biddingLogicUrl: ...,
  biddingWasmHelperUrl: ...,
  dailyUpdateUrl: ...,
  trustedBiddingSignalsUrl: ...,
  trustedBiddingSignalsKeys: ['key1', 'key2'],
  userBiddingSignals: {...},
  ads: [bikeAd1, bikeAd2, bikeAd3],
  adComponents: [customBike1, customBike2, bikePedal, bikeFrame1, bikeFrame2],
};

navigator.joinAdInterestGroup(interestGroup, 7 * kSecsPerDay);

ফাংশনে পাস করা interestGroup অবজেক্টটি অবশ্যই 50 কিবি সাইজের বেশি হবে না, অন্যথায় কলটি ব্যর্থ হবে। দ্বিতীয় প্যারামিটারটি সুদের গোষ্ঠীর সময়কাল নির্দিষ্ট করে, 30 দিনে সীমাবদ্ধ। পরপর কলগুলি পূর্বে সংরক্ষিত মানগুলিকে ওভাররাইট করে।

সুদ গ্রুপ বৈশিষ্ট্য

সম্পত্তি প্রয়োজন উদাহরণ ভূমিকা
owner প্রয়োজন 'https://dsp.example' স্বার্থ গোষ্ঠীর মালিকের উৎপত্তি।
name প্রয়োজন 'custom-bikes' স্বার্থ গ্রুপের নাম।
biddingLogicUrl ** ঐচ্ছিক* 'https://dsp.example/bid/custom-bikes/bid.js' বিডিং জাভাস্ক্রিপ্ট ওয়ার্কলেটে চালানোর URL।
biddingWasmHelperUrl ** ঐচ্ছিক* 'https://dsp.example/bid/custom-bikes/bid.wasm' biddingLogicUrl থেকে চালিত WebAssembly কোডের URL।
dailyUpdateUrl ** ঐচ্ছিক 'https://dsp.example/bid/custom-bikes/update' ইউআরএল যা আগ্রহ গ্রুপের বৈশিষ্ট্যগুলি আপডেট করতে JSON প্রদান করে। ( আগ্রহী গোষ্ঠী আপডেট করুন দেখুন।)
trustedBiddingSignalsUrl ** ঐচ্ছিক 'https://dsp.example/trusted/bidding-signals' দরদাতার বিশ্বস্ত সার্ভারে মূল-মূল্যের অনুরোধের জন্য ভিত্তি URL।
trustedBiddingSignalsKeys ঐচ্ছিক ['key1', 'key2' ...] কী-মান বিশ্বস্ত সার্ভারে অনুরোধের জন্য কী।
userBiddingSignals ঐচ্ছিক {...} অতিরিক্ত মেটাডেটা মালিক বিডিংয়ের সময় ব্যবহার করতে পারেন।
ads ঐচ্ছিক* [bikeAd1, bikeAd2, bikeAd3] এই আগ্রহ গ্রুপের জন্য রেন্ডার করা হতে পারে যে বিজ্ঞাপন.
adComponents ঐচ্ছিক [customBike1, customBike2, bikePedal, bikeFrame1, bikeFrame2] একাধিক টুকরা দিয়ে তৈরি বিজ্ঞাপনের উপাদান।

* owner এবং name ছাড়া সমস্ত সম্পত্তি ঐচ্ছিক। biddingLogicUrl এবং ads বৈশিষ্ট্য ঐচ্ছিক, কিন্তু একটি নিলামে অংশগ্রহণের জন্য প্রয়োজন৷ এই বৈশিষ্ট্যগুলি ছাড়াই একটি আগ্রহের গোষ্ঠী তৈরি করার ক্ষেত্রে ব্যবহার করা যেতে পারে: উদাহরণস্বরূপ, একটি আগ্রহ গোষ্ঠীর মালিক একটি প্রচারাভিযানের জন্য একটি স্বার্থ গোষ্ঠীতে একটি ব্রাউজার যোগ করতে চাইতে পারেন যা এখনও চলছে না, বা অন্য কিছু ভবিষ্যতে ব্যবহারের জন্য, অথবা তাদের সাময়িকভাবে বিজ্ঞাপনের বাজেট শেষ হয়ে যেতে পারে৷

** biddingLogicUrl , biddingWasmHelperUrl , dailyUpdateUrl এবং trustedBiddingSignalsUrl ইউআরএলগুলির মালিকের মতো একই উত্স থাকতে হবে৷ ads এবং adComponents URL-এ এই ধরনের কোনো সীমাবদ্ধতা নেই।

ইন্টারেস্ট গ্রুপ অ্যাট্রিবিউট আপডেট করুন

dailyUpdateUrl এমন একটি ওয়েব সার্ভার নির্দিষ্ট করে যা JSON সংজ্ঞায়িত করে সুদ গোষ্ঠীর বৈশিষ্ট্য প্রদান করে, যা navigator.joinAdInterestGroup() -এ পাস করা আগ্রহের গ্রুপ অবজেক্টের সাথে সম্পর্কিত। এটি গ্রুপের মালিকের স্বার্থ গ্রুপের বৈশিষ্ট্যগুলিকে পর্যায়ক্রমে আপডেট করার জন্য একটি প্রক্রিয়া প্রদান করে। বর্তমান বাস্তবায়নে , নিম্নলিখিত বৈশিষ্ট্যগুলি পরিবর্তন করা যেতে পারে:

  • biddingLogicUrl
  • biddingWasmHelperUrl
  • trustedBiddingSignalsUrl
  • trustedBiddingSignalsKeys
  • ads
  • priority

JSON-এ নির্দিষ্ট করা নেই এমন কোনও ক্ষেত্র ওভাররাইট করা হবে না—শুধুমাত্র JSON-এ নির্দিষ্ট করা ক্ষেত্রগুলি আপডেট করা হয়—যেখানে navigator.joinAdInterestGroup() কল করলে যে কোনও বিদ্যমান আগ্রহের গোষ্ঠী ওভাররাইট হয়৷

আপডেটগুলি সর্বোত্তম প্রচেষ্টা, এবং নিম্নলিখিত অবস্থার অধীনে ব্যর্থ হতে পারে:

  • নেটওয়ার্ক অনুরোধের সময়সীমা (বর্তমানে 30 সেকেন্ড)
  • অন্যান্য নেটওয়ার্ক ব্যর্থতা।
  • JSON পার্সিং ব্যর্থতা।

আপডেটগুলিও বাতিল করা যেতে পারে যদি আপডেট করতে খুব বেশি সময় ব্যয় করা হয়, যদিও এটি বাতিল (বাকি থাকা) আপডেটগুলিতে সীমাবদ্ধ কোনো হার চাপিয়ে দেয় না। আপডেটগুলি প্রতিদিন সর্বোচ্চ একটি পর্যন্ত রেট-সীমিত। নেটওয়ার্ক ত্রুটির কারণে ব্যর্থ হওয়া আপডেটগুলি এক ঘন্টা পরে পুনরায় চেষ্টা করা হয় এবং ইন্টারনেট থেকে সংযোগ বিচ্ছিন্ন হওয়ার কারণে ব্যর্থ হওয়া আপডেটগুলি পুনরায় সংযোগের সাথে সাথে পুনরায় চেষ্টা করা হয়।

ম্যানুয়াল আপডেট

বর্তমান ফ্রেমের মূলের মালিকানাধীন স্বার্থ গোষ্ঠীর আপডেটগুলি ম্যানুয়ালি navigator.updateAdInterestGroups() এর মাধ্যমে ট্রিগার করা যেতে পারে৷ হার সীমিতকরণ আপডেটগুলিকে ঘন ঘন ঘটতে বাধা দেয়: navigator.updateAdInterestGroups() এ বারবার কল করা রেট সীমা সময়কাল (বর্তমানে এক দিন) অতিক্রান্ত না হওয়া পর্যন্ত কিছু করবে না। একই স্বার্থ গোষ্ঠীর owner এবং name জন্য navigator.joinAdInterestGroup() আবার কল করা হলে হারের সীমা রিসেট হয়ে যায়।

স্বয়ংক্রিয় আপডেট

একটি নিলামের জন্য লোড করা সমস্ত আগ্রহের গোষ্ঠীগুলি একটি নিলাম শেষ হওয়ার পরে স্বয়ংক্রিয়ভাবে আপডেট হয়, ম্যানুয়াল আপডেটের মতো একই হারের সীমা সাপেক্ষে৷ একটি নিলামে অংশগ্রহণকারী অন্তত একটি আগ্রহের গোষ্ঠীর প্রতিটি মালিকের জন্য, এটি এমন যেন navigator.updateAdInterestGroups() একটি আইফ্রেম থেকে কল করা হয়েছে যার মূলটি সেই মালিকের সাথে মেলে৷

একটি আগ্রহ গ্রুপের জন্য বিজ্ঞাপন নির্দিষ্ট করুন

ads এবং adComponents অবজেক্ট একটি বিজ্ঞাপন ক্রিয়েটিভ এবং ঐচ্ছিকভাবে, নির্বিচারে মেটাডেটার জন্য একটি URL অন্তর্ভুক্ত করে যা বিডিংয়ের সময় ব্যবহার করা যেতে পারে। যেমন:

{
  renderUrl: 'https://cdn.example/.../bikeAd1.html',
  metadata: bikeAd1metadata // optional
}

ক্রেতারা কিভাবে বিড করবেন?

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

বিজ্ঞাপন-স্পেস ক্রেতার দ্বারা প্রদত্ত biddingLogicUrl এর স্ক্রিপ্টে অবশ্যই একটি generateBid() ফাংশন অন্তর্ভুক্ত থাকতে হবে। এই ফাংশন প্রতিটি প্রার্থী বিজ্ঞাপনের জন্য একবার বলা হয়. runAdAuction() পৃথকভাবে প্রতিটি বিজ্ঞাপনকে তার সংশ্লিষ্ট বিড এবং মেটাডেটা সহ চেক করে, তারপর বিজ্ঞাপনটিকে একটি সংখ্যাসূচক পছন্দের স্কোর প্রদান করে।

generateBid(interestGroup, auctionSignals, perBuyerSignals,
    trustedBiddingSignals, browserSignals) {
  ...
  return {
    ad: adObject,
    bid: bidValue,
    render: renderUrl,
    adComponents: [adComponentRenderUrl1, ...]
   };
}

generateBid() নিম্নলিখিত আর্গুমেন্ট নেয়:

  • interestGroup
    বস্তুটি বিজ্ঞাপন ক্রেতার দ্বারা joinAdInterestGroup() এ পাস করা হয়েছে। (সুদ গ্রুপ dailyUpdateUrl এর মাধ্যমে আপডেট করা যেতে পারে।)

  • auctionSignals
    বিজ্ঞাপন-স্পেস বিক্রেতার দ্বারা navigator.runAdAuction() -এ পাস করা নিলাম কনফিগার আর্গুমেন্টের একটি সম্পত্তি। এটি পৃষ্ঠার প্রসঙ্গ (যেমন বিজ্ঞাপনের আকার এবং প্রকাশক আইডি), নিলামের ধরন (প্রথম-মূল্য বা দ্বিতীয়-মূল্য) এবং অন্যান্য মেটাডেটা সম্পর্কে তথ্য প্রদান করে।

  • perBuyerSignals
    auctionSignals এর মতো, নিলাম কনফিগারেশন আর্গুমেন্টের একটি সম্পত্তি বিক্রেতার দ্বারা navigator.runAdAuction() এ পাঠানো হয়েছে। এটি পৃষ্ঠা সম্পর্কে ক্রেতার সার্ভার থেকে প্রাসঙ্গিক সংকেত প্রদান করতে পারে, যদি বিক্রেতা একজন SSP হয় যা ক্রেতা সার্ভারের কাছে একটি রিয়েল-টাইম বিডিং কল করে এবং প্রতিক্রিয়াটি পাইপ করে, অথবা যদি প্রকাশক পৃষ্ঠাটি ক্রেতার সার্ভারের সাথে সরাসরি যোগাযোগ করে। যদি তাই হয়, ক্রেতা বিড়ম্বনার বিরুদ্ধে সুরক্ষা হিসাবে generateBid() এর ভিতরে সেই সংকেতগুলির একটি ক্রিপ্টোগ্রাফিক স্বাক্ষর পরীক্ষা করতে চাইতে পারেন।

  • trustedBiddingSignals
    একটি বস্তু যার কীগুলি হল আগ্রহ গোষ্ঠীর জন্য trustedBiddingSignalsKeys এবং যার মান trustedBiddingSignals অনুরোধে ফেরত দেওয়া হয়৷

  • browserSignals
    ব্রাউজার দ্বারা নির্মিত একটি অবজেক্ট, যাতে পৃষ্ঠার প্রসঙ্গ (যেমন বর্তমান পৃষ্ঠার hostname , যা বিক্রেতা অন্যথায় জাল করতে পারে) এবং আগ্রহের গোষ্ঠীর জন্য ডেটা (যেমন ডিভাইসে ফ্রিকোয়েন্সি ক্যাপিংয়ের অনুমতি দেওয়ার জন্য গ্রুপটি পূর্বে কখন একটি নিলাম জিতেছে তার রেকর্ড) সম্পর্কিত তথ্য অন্তর্ভুক্ত থাকতে পারে।

browserSignals অবজেক্টের নিম্নলিখিত বৈশিষ্ট্য রয়েছে: 

{
  topWindowHostname: 'publisher.example',
  seller: 'https://ssp.example',
  joinCount: 3,
  bidCount: 17,
  prevWins: [[time1,ad1],[time2,ad2],...],
  wasmHelper: ... /* WebAssembly.Module object based on interest group's biddingWasmHelperUrl. */
  dataVersion: 1, /* Data-Version value from the buyer's Key/Value service response(s). */
}

একটি bid মান গণনা করতে, generateBid() এর কোড ফাংশনের পরামিতিগুলির বৈশিষ্ট্য ব্যবহার করতে পারে। যেমন: 

function generateBid(interestGroup, auctionSignals, perBuyerSignals,
    trustedBiddingSignals, browserSignals) {
  return {
    ...
    bid: auctionSignals.is_above_the_fold ? perBuyerSignals.atf_value : perBuyerSignals.btf_value,
    ...
  }
}

generateBid() চারটি বৈশিষ্ট্য সহ একটি বস্তু ফেরত দেয়:

  • ad
    বিজ্ঞাপন সম্পর্কে নির্বিচারে মেটাডেটা, যেমন তথ্য বিক্রেতা এই বিড বা বিজ্ঞাপন সৃজনশীল সম্পর্কে জানতে চান। বিক্রেতা](/resources/glossary#ssp) তার নিলাম এবং সিদ্ধান্ত বিজ্ঞাপন সৃজনশীল এই তথ্য ব্যবহার করে. বিক্রেতা তার নিলাম এবং সিদ্ধান্ত যুক্তিতে এই তথ্য ব্যবহার করে।

  • bid
    একটি সংখ্যাসূচক বিড যা নিলামে প্রবেশ করবে। বিক্রেতাকে অবশ্যই বিভিন্ন ক্রেতার কাছ থেকে বিড তুলনা করার অবস্থানে থাকতে হবে, তাই বিডগুলি অবশ্যই বিক্রেতা-নির্বাচিত কিছু ইউনিটে হতে হবে (যেমন "প্রতি হাজারে USD")। যদি বিড শূন্য বা ঋণাত্মক হয়, তাহলে এই স্বার্থ গোষ্ঠীটি বিক্রেতার নিলামে মোটেও অংশগ্রহণ করবে না। এই পদ্ধতির সাহায্যে, ক্রেতা তাদের বিজ্ঞাপনগুলি যেখানে প্রদর্শিত হতে পারে বা নাও হতে পারে তার জন্য বিজ্ঞাপনদাতার যেকোনো নিয়ম বাস্তবায়ন করতে পারে।

  • render
    একটি ইউআরএল, বা ইউআরএলের একটি তালিকা, যেটি সৃজনশীল রেন্ডার করতে ব্যবহার করা হবে যদি এই বিড নিলামে জয়ী হয়। (এপিআই ব্যাখ্যাকারীতে একাধিক টুকরো দিয়ে তৈরি বিজ্ঞাপনগুলি দেখুন।) মানটি আগ্রহের গোষ্ঠীর জন্য সংজ্ঞায়িত বিজ্ঞাপনগুলির একটির renderUrl সাথে মেলে।

  • adComponents
    navigator.joinAdInterestGroup() এ পাস করা স্বার্থ গোষ্ঠীর আর্গুমেন্টের adComponents সম্পত্তি থেকে নেওয়া একাধিক টুকরো দিয়ে তৈরি বিজ্ঞাপনের জন্য 20টি পর্যন্ত উপাদানের ঐচ্ছিক তালিকা।

একটি ব্রাউজারকে একটি আগ্রহের গ্রুপ ছেড়ে যেতে বলছে

স্বার্থ গোষ্ঠীর মালিক একটি ব্রাউজারকে একটি স্বার্থ গোষ্ঠী থেকে সরানোর অনুরোধ করতে পারেন৷ অন্য কথায়, ব্রাউজারটিকে তাদের সদস্যদের তালিকা থেকে আগ্রহের গোষ্ঠীটিকে সরিয়ে দিতে বলা হয়। 

navigator.leaveAdInterestGroup({
  owner: 'https://dsp.example',
  name: 'custom-bikes'
});

যদি কোনও ব্যবহারকারী সেই সাইটে ফিরে আসেন যেটি ব্রাউজারকে একটি আগ্রহের গোষ্ঠী যুক্ত করতে বলেছিল, স্বার্থ গোষ্ঠীর মালিক ব্রাউজারকে আগ্রহের গোষ্ঠী সরানোর অনুরোধ করতে navigator.leaveAdInterestGroup() ফাংশনে কল করতে পারেন৷ একটি বিজ্ঞাপনের কোড তার আগ্রহের গোষ্ঠীর জন্য এই ফাংশনটিকেও কল করতে পারে।

3. ব্যবহারকারী বিজ্ঞাপন স্থান বিক্রি করে এমন একটি সাইট পরিদর্শন করে

একজন ব্যক্তিকে তার ল্যাপটপে একটি ব্রাউজারে একটি নিউজ ওয়েবসাইট পরিদর্শন করার দৃষ্টান্ত। সাইট একটি খালি বিজ্ঞাপন স্লট আছে.

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

4. ব্রাউজারে একটি বিজ্ঞাপন নিলাম চালানো হয়

একজন ব্যক্তিকে তার ল্যাপটপে একটি ব্রাউজারে একটি সংবাদ ওয়েবসাইট দেখছেন এমন চিত্র। একটি বিজ্ঞাপন Protected Audience API ব্যবহার করে নিলাম হচ্ছে।

ব্যাখ্যাকারী বিভাগ: বিক্রেতারা ডিভাইসে নিলাম চালান

বিজ্ঞাপনের নিলাম সম্ভবত প্রকাশকের এসএসপি বা প্রকাশক নিজেই পরিচালনা করবেন। নিলামের উদ্দেশ্য হল বর্তমান পৃষ্ঠায় একটি একক উপলব্ধ বিজ্ঞাপন স্লটের জন্য সবচেয়ে উপযুক্ত বিজ্ঞাপন নির্বাচন করা। নিলামে অ্যাড-স্পেস ক্রেতা এবং কী/মূল্য পরিষেবা থেকে বিক্রেতাদের ডেটা সহ ব্রাউজারটি যে স্বার্থ গোষ্ঠীর সদস্য তা বিবেচনা করে।

বিজ্ঞাপন-স্থান বিক্রেতা navigator.runAdAuction() এ কল করে একটি বিজ্ঞাপন নিলাম শুরু করার জন্য ব্যবহারকারীর ব্রাউজারকে একটি অনুরোধ করে৷

যেমন: 

const auctionConfig = {
  seller: 'https://ssp.example',
  decisionLogicUrl: ...,
  trustedScoringSignalsUrl: ...,
  interestGroupBuyers: ['https://dsp.example', 'https://buyer2.example', ...],
  auctionSignals: {...},
  sellerSignals: {...},
  sellerTimeout: 100,
  perBuyerSignals: {
    'https://dsp.example': {...},
    'https://another-buyer.example': {...},
    ...
  },
  perBuyerTimeouts: {
    'https://dsp.example': 50,
    'https://another-buyer.example': 200,
    '*': 150,
    ...
  },
  componentAuctions: [
    {
      'seller': 'https://some-other-ssp.example',
      'decisionLogicUrl': ...,
      ...
    },
    ...
  ]
};

const auctionResultPromise = navigator.runAdAuction(auctionConfig);

runAdAuction() একটি প্রতিশ্রুতি প্রদান করে যা একটি URN ( urn:uuid:<something> ) কে সমাধান করে যা বিজ্ঞাপন নিলামের ফলাফলকে উপস্থাপন করে। এটি শুধুমাত্র ব্রাউজার দ্বারা ডিকোড করা যেতে পারে যখন রেন্ডারিংয়ের জন্য একটি বেড়াযুক্ত ফ্রেমে পাস করা হয়: প্রকাশক পৃষ্ঠা বিজয়ী বিজ্ঞাপনটি পরিদর্শন করতে পারে না।

decisionLogicUrl স্ক্রিপ্ট প্রতিটি পৃথক বিজ্ঞাপনকে তার সংশ্লিষ্ট বিড এবং মেটাডেটা সহ, একবারে একটি বিবেচনা করে এবং তারপরে এটিকে একটি সংখ্যাসূচক পছন্দের স্কোর বরাদ্দ করে।

auctionConfig বৈশিষ্ট্য

সম্পত্তি প্রয়োজন উদাহরণ ভূমিকা
seller প্রয়োজন 'https://ssp.example' বিক্রেতার উৎপত্তি।
decisionLogicUrl প্রয়োজন 'https://ssp.example/auction-decision-logic.js' নিলাম ওয়ার্কলেট জাভাস্ক্রিপ্টের URL।
trustedScoringSignalsUrl ঐচ্ছিক 'https://ssp.example/scoring-signals' বিক্রেতার বিশ্বস্ত সার্ভারের URL।
interestGroupBuyers* প্রয়োজন ['https://dsp.example', 'https://buyer2.example', ...] নিলামে বিড করতে বলা সমস্ত স্বার্থ গ্রুপ মালিকদের উত্স.
auctionSignals ঐচ্ছিক {...} পৃষ্ঠার প্রসঙ্গ, নিলামের ধরন ইত্যাদি সম্পর্কে বিক্রেতার তথ্য।
sellerSignals ঐচ্ছিক {...} প্রকাশক সেটিংসের উপর ভিত্তি করে তথ্য, একটি প্রাসঙ্গিক বিজ্ঞাপন অনুরোধ করা ইত্যাদি।
sellerTimeout ঐচ্ছিক 100 বিক্রেতার scoreAd() স্ক্রিপ্টের সর্বোচ্চ রানটাইম (ms)।
perBuyerSignals ঐচ্ছিক {'https://dsp.example': {...},
'https://another-buyer.example': {...},
...}		 প্রতিটি নির্দিষ্ট ক্রেতার জন্য তাদের সার্ভার থেকে পৃষ্ঠা সম্পর্কে প্রাসঙ্গিক সংকেত।
perBuyerTimeouts ঐচ্ছিক 50 নির্দিষ্ট ক্রেতার generateBid() স্ক্রিপ্টের সর্বোচ্চ রানটাইম (এমএস)।
componentAuctions ঐচ্ছিক [{'seller': 'https://www.some-other-ssp.com',
'decisionLogicUrl': ..., ...},
...]		 কম্পোনেন্ট নিলামের জন্য অতিরিক্ত কনফিগারেশন।

* বিক্রেতা interestGroupBuyers: '*' সমস্ত স্বার্থ গোষ্ঠীকে বিড করার অনুমতি দিতে। আগ্রহ গ্রুপের মালিকের অন্তর্ভুক্তি ব্যতীত অন্যান্য মানদণ্ডের ভিত্তিতে বিজ্ঞাপনগুলি গ্রহণ বা প্রত্যাখ্যান করা হয়। উদাহরণস্বরূপ, বিক্রেতা তাদের নীতির সাথে সম্মতি নিশ্চিত করতে বিজ্ঞাপন ক্রিয়েটিভ পর্যালোচনা করতে পারেন।

** additionalBids সুরক্ষিত দর্শকের বর্তমান বাস্তবায়নে সমর্থিত নয়৷ আরও তথ্যের জন্য সুরক্ষিত শ্রোতা ব্যাখ্যাকারীর নিলাম অংশগ্রহণকারী বিভাগটি পড়ুন।

কিভাবে বিজ্ঞাপন নির্বাচন করা হয়?

decisionLogicUrl -এ কোড (নিলাম কনফিগারেশন অবজেক্টের একটি সম্পত্তি যা runAdAuction() এ পাস করা হয়েছে) অবশ্যই একটি scoreAd() ফাংশন অন্তর্ভুক্ত করবে। এটি প্রতিটি বিজ্ঞাপনের আকাঙ্খিততা নির্ধারণের জন্য একবার চালানো হয়। 

scoreAd(adMetadata, bid, auctionConfig, trustedScoringSignals, browserSignals) {
  ...
  return desirabilityScoreForThisAd;
}

scoreAd() নিম্নলিখিত আর্গুমেন্ট নেয়:

  • adMetadata
    ক্রেতা দ্বারা প্রদত্ত নির্বিচারে মেটাডেটা।
  • bid
    একটি সংখ্যাসূচক বিড মান।
  • auctionConfig
    নিলাম কনফিগারেশন অবজেক্টটি navigator.runAdAuction() এ পাস করা হয়েছে।
  • trustedScoringSignals
    বিক্রেতার বিশ্বস্ত সার্ভার থেকে নিলামের সময় পুনরুদ্ধার করা মানগুলি, বিজ্ঞাপনের বিক্রেতার মতামতের প্রতিনিধিত্ব করে৷
  • browserSignals
    ব্রাউজার দ্বারা নির্মিত একটি বস্তু, ব্রাউজার জানে এমন তথ্য সহ এবং বিক্রেতার নিলাম স্ক্রিপ্ট যা যাচাই করতে চাইতে পারে: 
{
  topWindowHostname: 'publisher.example',
  interestGroupOwner: 'https://dsp.example',
  renderUrl: 'https://cdn.example/render',
  adComponents: ['https://cdn.com/ad-component-1', ...],
  biddingDurationMsec: 12,
  dataVersion: 1 /* Data-Version value from the seller's Key/Value service response. */
}

একটি নিলাম শুরু হওয়ার আগে, বিক্রেতা উপলব্ধ বিজ্ঞাপন স্লটের জন্য সেরা প্রাসঙ্গিক বিজ্ঞাপনটি খুঁজে পান। এর scoreAd() লজিকের অংশ হল এমন কোন বিজ্ঞাপন প্রত্যাখ্যান করা যা প্রাসঙ্গিক বিজয়ীকে হারাতে পারে না।

5. বিক্রেতা এবং অংশগ্রহণকারী ক্রেতারা কী/মান পরিষেবা থেকে রিয়েলটাইম ডেটা পান

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

ব্যাখ্যাকারী বিভাগ: সুরক্ষিত দর্শক কী/মান পরিষেবা থেকে রিয়েল-টাইম ডেটা আনা ।

একটি বিজ্ঞাপন নিলামের সময়, বিজ্ঞাপন-স্পেস বিক্রেতা নির্দিষ্ট বিজ্ঞাপন ক্রিয়েটিভ সম্পর্কে রিয়েলটাইম ডেটা পেতে পারেন একটি কী/মান পরিষেবার কাছে একটি অনুরোধ করার মাধ্যমে navigator.runAdAuction() এ পাস করা নিলাম কনফিগারেশন আর্গুমেন্টের trustedScoringSignalsUrl প্রপার্টি ব্যবহার করে, এবং সমস্ত ads ক্ষেত্রের adComponents সমস্ত গোষ্ঠীর আগ্রহের renderUrl এর কীগুলির সাথে। নিলাম

একইভাবে, একজন অ্যাড-স্পেস ক্রেতা navigator.joinAdInterestGroup() এ পাস করা স্বার্থ গোষ্ঠীর আর্গুমেন্টের trustedBiddingSignalsUrl এবং trustedBiddingSignalsKeys বৈশিষ্ট্য ব্যবহার করে কী/মান পরিষেবা থেকে রিয়েলটাইম ডেটার অনুরোধ করতে পারেন।

যখন runAdAuction() কল করা হয়, ব্রাউজার প্রতিটি বিজ্ঞাপন ক্রেতার বিশ্বস্ত সার্ভারের কাছে একটি অনুরোধ করে। অনুরোধের URLটি এইরকম দেখতে পারে: 

https://kv-service.example/getvalues?hostname=publisher.example&keys=key1,key2
  • ভিত্তি URL টি আসে trustedBiddingSignalsUrl থেকে।
  • hostname ব্রাউজার দ্বারা প্রদান করা হয়.
  • keys মান trustedBiddingSignalsKeys থেকে নেওয়া হয়েছে।

এই অনুরোধের প্রতিক্রিয়া হল একটি JSON অবজেক্ট যা প্রতিটি কীগুলির জন্য মান প্রদান করে।

6. বিজয়ী বিজ্ঞাপন প্রদর্শিত হয়

একজন ব্যক্তিকে তার ল্যাপটপে একটি ব্রাউজারে একটি সংবাদ ওয়েবসাইট দেখছেন এমন চিত্র। একটি বিজ্ঞাপন একটি বাইকের জন্য (20% ছাড়) প্রদর্শিত হয়—উপরে একটি লক সহ দেখানো হয় যে বিজ্ঞাপনটি একটিতে প্রদর্শিত হয় বেড়াযুক্ত ফ্রেম।

ব্যাখ্যাকারী বিভাগ: ব্রাউজাররা বিজয়ী বিজ্ঞাপন রেন্ডার করে

পূর্বে বর্ণিত হিসাবে: runAdAuction() দ্বারা প্রত্যাবর্তিত প্রতিশ্রুতিটি একটি URN এর সমাধান করে যা রেন্ডারিংয়ের জন্য একটি বেড়াযুক্ত ফ্রেমে পাস করা হয় এবং সাইটটি বিজয়ী বিজ্ঞাপন প্রদর্শন করে।

7. নিলাম ফলাফল রিপোর্ট করা হয়

ব্যাখ্যাকারী বিভাগ: ইভেন্ট-লেভেল রিপোর্টিং (আপাতত)

বিক্রেতা ফলাফল রিপোর্ট

ব্যাখ্যার বিভাগ: রেন্ডার সম্পর্কে বিক্রেতা রিপোর্টিং

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 আর্গুমেন্ট হিসাবে ব্যবহৃত হয়।

বিজয়ী দরদাতা ফলাফল রিপোর্ট

ব্যাখ্যার বিভাগ: রেন্ডার এবং বিজ্ঞাপন ইভেন্টগুলিতে ক্রেতা রিপোর্টিং

বিজয়ী দরদাতার জাভাস্ক্রিপ্ট (যা 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>
}

অস্থায়ী ক্ষতি/উইন রিপোর্টিং বাস্তবায়ন

নিলাম রিপোর্টিংয়ের জন্য ক্রোমে সাময়িকভাবে দুটি পদ্ধতি উপলব্ধ রয়েছে:

  • forDebuggingOnly.reportAdAuctionLoss()
  • forDebuggingOnly.reportAdAuctionWin()

এই পদ্ধতিগুলি প্রতিটি একক যুক্তি নেয়: নিলাম শেষ হওয়ার পরে আনতে একটি ইউআরএল। এগুলিকে বিভিন্ন ইউআরএল যুক্তি সহ scoreAd() এবং generateBid() উভয় ক্ষেত্রেই একাধিকবার বলা যেতে পারে।

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

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

8। একটি বিজ্ঞাপন ক্লিক রিপোর্ট করা হয়

চিত্র প্রদর্শন রিপোর্ট সহ একটি নিউজ ওয়েবসাইটে একটি বেড়া ফ্রেমের অভ্যন্তরে বাইকের জন্য কোনও বিজ্ঞাপনে ক্লিক করা একজন ব্যক্তি ডেটা বিক্রেতা এবং ক্রেতাদের কাছে যাচ্ছেন।

একটি বেড়া ফ্রেমে রেন্ডার করা বিজ্ঞাপনে একটি ক্লিক রিপোর্ট করা হয়। এটি কীভাবে কাজ করতে পারে সে সম্পর্কে আরও জানতে, বেড়া ফ্রেম বিজ্ঞাপনগুলি প্রতিবেদন করুন ।


নীচের চিত্রটি সুরক্ষিত শ্রোতাদের বিজ্ঞাপন নিলামের প্রতিটি পর্যায়ে রূপরেখা দেয়:

সুরক্ষিত শ্রোতাদের বিজ্ঞাপন নিলামের প্রতিটি পর্যায়ে একটি ওভারভিউ সরবরাহ করে চিত্র


সুরক্ষিত শ্রোতা এবং কচ্ছপের মধ্যে পার্থক্য কী?

সুরক্ষিত শ্রোতা হ'ল প্রথম পরীক্ষা যা প্রস্তাবগুলির টার্টলেডোভ পরিবারের মধ্যে ক্রোমিয়ামে প্রয়োগ করা হয়।

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

কচ্ছপের প্রচেষ্টাটি কিছু মূল গোপনীয়তার অগ্রগতি প্রদানের সময় এই ব্যবহারের ক্ষেত্রে সমাধান করার জন্য একটি নতুন এপিআই সরবরাহ করার বিষয়ে:

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

সুরক্ষিত শ্রোতা কচ্ছপের বাইরে বেড়েছে এবং এপিআই ব্যবহার করা হবে এমন বিকাশকারীদের আরও ভালভাবে পরিবেশন করার জন্য পরিবর্তনের জন্য সম্পর্কিত প্রস্তাবগুলির সংগ্রহ:

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

সুরক্ষিত শ্রোতা এখনও কোনও ওয়েবসাইটের বিজ্ঞাপন নেটওয়ার্ককে শেখার থেকে বিরত রাখে না যা কোনও বিজ্ঞাপন দেখায়। আমরা সময়ের সাথে সাথে আরও ব্যক্তিগত হয়ে উঠতে এপিআই সংশোধন করার প্রত্যাশা করি।

কোন ব্রাউজার কনফিগারেশন উপলব্ধ?

ব্যবহারকারীরা chrome://settings/adPrivacy শীর্ষ-স্তরের সেটিং সক্ষম বা অক্ষম করে ক্রোমে গোপনীয়তা স্যান্ডবক্স ট্রায়ালগুলির জন্য তাদের অংশগ্রহণ সামঞ্জস্য করতে পারেন। প্রাথমিক পরীক্ষার সময়, লোকেরা সুরক্ষিত শ্রোতাদের বাইরে যাওয়ার জন্য এই উচ্চ-স্তরের গোপনীয়তা স্যান্ডবক্স সেটিংটি ব্যবহার করতে সক্ষম হবে। ক্রোম ব্যবহারকারীদের তাদের যে ওয়েবসাইটগুলি পরিদর্শন করেছে সেগুলি জুড়ে যুক্ত করা আগ্রহী গোষ্ঠীগুলির তালিকা দেখতে এবং পরিচালনা করার অনুমতি দেওয়ার পরিকল্পনা করে। গোপনীয়তা স্যান্ডবক্স টেকনোলজির মতোই, ব্যবহারকারী সেটিংস ব্যবহারকারী, নিয়ামক এবং অন্যদের প্রতিক্রিয়া সহ বিকশিত হতে পারে।

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

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



জড়িত এবং প্রতিক্রিয়া ভাগ করুন

সমর্থন পান

আপনার বাস্তবায়ন সম্পর্কে, ডেমো সম্পর্কে, বা ডকুমেন্টেশন সম্পর্কে একটি প্রশ্ন জিজ্ঞাসা করতে:

ক্রোমে সুরক্ষিত শ্রোতা এপিআই বাস্তবায়নের সাথে বাগ এবং সমস্যাগুলির জন্য: * এপিআইয়ের জন্য রিপোর্ট করা বিদ্যমান বিষয়গুলি দেখুন । * Crbug.com/new এ একটি নতুন সমস্যা উত্থাপন করুন।

আপডেট পান

আরও জানুন

ছবি আনস্প্ল্যাশে রে হেনেসি ।