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

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

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

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

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

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

API ফাংশন

joinAdInterestGroup()

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

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

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

এর মানে হল malicious.example এর পক্ষে dsp.example.com অনুমতি ছাড়া, dsp.example.com এর মালিকানাধীন একটি স্বার্থ গোষ্ঠীর জন্য 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 অবজেক্টটি অবশ্যই 50 কিবি সাইজের বেশি হবে না, অন্যথায় কলটি ব্যর্থ হবে। দ্বিতীয় প্যারামিটারটি সুদের গোষ্ঠীর সময়কাল নির্দিষ্ট করে, 30 দিনে সীমাবদ্ধ। পরপর কলগুলি পূর্বে সংরক্ষিত মানগুলিকে ওভাররাইট করে।

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

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

সম্পত্তি উদাহরণ ভূমিকা
owner https://dsp.example স্বার্থ গোষ্ঠীর মালিকের উৎপত্তি।
name custom-bikes স্বার্থ গ্রুপের নাম।

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

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

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

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

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

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

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

যেমন:

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

leaveAdInterestGroup()

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

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

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

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

প্রায়শই জিজ্ঞাসিত প্রশ্ন

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

ক্রোম মালিক প্রতি 1000টি পর্যন্ত আগ্রহের গোষ্ঠী এবং 1000টি পর্যন্ত স্বার্থ গোষ্ঠীর মালিকদের অনুমতি দেয়৷ এই সীমাগুলি গার্ড রেল হিসাবে বোঝানো হয়, নিয়মিত অপারেশনে আঘাত না করা।

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

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

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

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

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

সমস্ত সুরক্ষিত অডিয়েন্স API রেফারেন্স

API reference guides are available:

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