শ্রোতা ডেটা সংজ্ঞায়িত করুন

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

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

সুরক্ষিত শ্রোতা API আগ্রহ গোষ্ঠী

একটি সুরক্ষিত শ্রোতা API আগ্রহ গোষ্ঠী এমন একদল লোককে প্রতিনিধিত্ব করে যাদের একটি সাধারণ আগ্রহ রয়েছে, যা একটি পুনঃবিপণন তালিকার সাথে সম্পর্কিত। প্রতিটি সুরক্ষিত শ্রোতা API আগ্রহ গোষ্ঠীর একজন মালিক থাকে।

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

API ফাংশন

joinAdInterestGroup()

বিজ্ঞাপনদাতার ডিমান্ড-সাইড প্ল্যাটফর্ম (DSP) অথবা বিজ্ঞাপনদাতা নিজেই navigator.joinAdInterestGroup() কে কল করে ব্রাউজারকে ব্রাউজারের সদস্য তালিকায় একটি আগ্রহের গোষ্ঠী যোগ করতে বলে।

joinAdInterestGroup() এর কলিং প্রসঙ্গের উৎপত্তি অবশ্যই আগ্রহ গোষ্ঠীর মালিকের উৎপত্তির সাথে মিলবে, তাই joinAdInterestGroup() একটি iframe (উদাহরণস্বরূপ, একটি DSP থেকে) থেকে কল করতে হবে যদি না আগ্রহ গোষ্ঠীর মালিকের উৎপত্তি বর্তমান নথির উৎপত্তির সাথে মেলে (উদাহরণস্বরূপ, নিজস্ব আগ্রহ গোষ্ঠী সহ একটি ওয়েবসাইট)।

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

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

এর অর্থ হল, dsp.example.com অনুমতি না দিয়ে, dsp.example.com এর মালিকানাধীন একটি ইন্টারেস্ট গ্রুপের জন্য malicious.example এর পক্ষে joinAdInterestGroup() কল করা সম্ভব নয়।

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

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

ব্যবহারের উদাহরণ

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

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

navigator.joinAdInterestGroup(interestGroup, 7 * kSecsPerDay);

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

প্রয়োজনীয় বৈশিষ্ট্য

স্বার্থ গোষ্ঠীর জন্য শুধুমাত্র প্রয়োজনীয় বৈশিষ্ট্য হল owner এবং name :

ঐচ্ছিক বৈশিষ্ট্য

বাকি বৈশিষ্ট্যগুলি ঐচ্ছিক:

biddingLogicUrl ^{১ , ২}

উদাহরণ: https://dsp.example/bid/custom-bikes/bid.js

ভূমিকা: ওয়ার্কলেটে জাভাস্ক্রিপ্ট চালানোর জন্য বিড করার URL।

biddingWasmHelperUrl ^{১ , ২}

উদাহরণ: https://dsp.example/bid/custom-bikes/bid.wasm

ভূমিকা: biddingLogicUrl থেকে চালিত WebAssembly কোডের URL।

updateUrl ^২

উদাহরণ: https://dsp.example/bid/custom-bikes/update

ভূমিকা: URL যা আগ্রহ গোষ্ঠীর বৈশিষ্ট্যগুলি আপডেট করার জন্য JSON ফেরত দেয়। ( দর্শকদের ডেটা আপডেট করুন এবং বিজ্ঞাপনগুলি রিফ্রেশ করুন দেখুন।)

trustedBiddingSignalsUrl ^২

উদাহরণ: https://dsp.example/trusted/bidding-signals

ভূমিকা: দরদাতার বিশ্বস্ত কী/মান পরিষেবার কাছে কী-মান অনুরোধের জন্য বেস URL।

trustedBiddingSignalsKeys

উদাহরণ: ['key1', 'key2' ...]

ভূমিকা: বিশ্বস্ত কী/মান পরিষেবার কী-মান অনুরোধের জন্য কী।

userBiddingSignals

উদাহরণ: {...}

ভূমিকা: বিডিংয়ের সময় মালিক অতিরিক্ত মেটাডেটা ব্যবহার করতে পারেন।

ads ^১

উদাহরণ: [bikeAd1, bikeAd2, bikeAd3]

ভূমিকা: এই আগ্রহের গোষ্ঠীর জন্য রেন্ডার করা হতে পারে এমন বিজ্ঞাপন।

adComponents

উদাহরণ: [customBike1, customBike2, bikePedal, bikeFrame1, bikeFrame2]

ভূমিকা: একাধিক অংশের সমন্বয়ে গঠিত বিজ্ঞাপনের উপাদান।

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

² Protected Audience API-এর বর্তমান বাস্তবায়নে, biddingLogicUrl , biddingWasmHelperUrl , updateUrl , এবং trustedBiddingSignalsUrl মালিকের মতো একই উৎস থাকতে হবে। এটি দীর্ঘমেয়াদী সীমাবদ্ধতা নাও হতে পারে, এবং ads এবং adComponents URL-গুলিতে এমন কোনও সীমাবদ্ধতা নেই।

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

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

উদাহরণস্বরূপ:

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

leaveAdInterestGroup()

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

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

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

একটি বিজ্ঞাপনের কোড তার আগ্রহের গোষ্ঠীর জন্যও এই ফাংশনটিকে কল করতে পারে।

সচরাচর জিজ্ঞাস্য

একজন একক ব্যবহারকারীর জন্য প্রতিটি গ্রুপের মালিকের সর্বোচ্চ আগ্রহের গোষ্ঠীর সংখ্যা কত?

Chrome প্রতিটি মালিকের জন্য সর্বোচ্চ ১০০০টি ইন্টারেস্ট গ্রুপ এবং সর্বোচ্চ ১০০০টি ইন্টারেস্ট গ্রুপ মালিকের অনুমতি দেয়। এই সীমাগুলি গার্ড রেল হিসেবে তৈরি, নিয়মিত অপারেশনে আঘাত করার জন্য নয়।

𝑘-anon থ্রেশহোল্ড পূরণকারী আগ্রহের গোষ্ঠীর বিজ্ঞাপনগুলিকে আমি কীভাবে সর্বাধিক করতে পারি?

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

কৌশলগত দৃষ্টিকোণ থেকে, আপনি নিম্নলিখিত বিষয়গুলি বিবেচনা করতে পারেন:

• নতুন বিজ্ঞাপন দেখানো শুরু করার জন্য, আপনি যদি এটি দেখাতে চান তবেই এটি দিয়ে বিড করা শুরু করুন। এর জন্য আপনাকে অতিরিক্ত কিছু করতে হবে না।
• নতুন বিজ্ঞাপনগুলি 𝑘-anon না হলে আপনি একটি ফলব্যাক বিজ্ঞাপন ব্যবহার করতে পারেন। আপনার ফলব্যাক বিজ্ঞাপনটি 𝑘-anon না হওয়ার ঝুঁকি রয়েছে, তাই আপনি কখনও কখনও প্রথমেই ফলব্যাক বিজ্ঞাপন দিয়ে বিড করার কথা বিবেচনা করতে পারেন। সম্ভবত এটি 1% সময় করুন, উদাহরণস্বরূপ, যদি এটি একটি ভাল স্তর হয় যাতে আপনি নিশ্চিত করতে পারেন যে ফলব্যাকটি থ্রেশহোল্ডের উপরে থাকবে।

সাম্প্রতিককালে অন্যান্য উপায়ে কাজ করার বিষয়ে আলোচনা হয়েছে, তাই যদি আপনার কাছে এমন কোনও ব্যবহারের ক্ষেত্রে থাকে যার জন্য এই প্রক্রিয়াটি সমস্যা তৈরি করতে পারে, তাহলে API কীভাবে উন্নত করা যেতে পারে সে সম্পর্কে জনসাধারণের সাথে আলোচনা চালিয়ে যান।

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

API reference guides are available:

• Developer guide for the Protected Audience API.
• Ad buyer guide to Protected Audience interest groups and bid generation.
• Ad seller guide to Protected Audience ad auctions.
• Guide to reporting auction results
• Best practices for Protected Audience ad auction latency
• Troubleshoot Protected Audience

The Protected Audience API explainer also provides detail about feature support and constraints.