দর্শক ডেটা আপডেট করুন এবং বিজ্ঞাপনগুলি রিফ্রেশ করুন৷

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

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

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

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

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

API ফাংশন

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

এখানে দর্শকদের ডেটা কীভাবে সংজ্ঞায়িত করতে হয় তার নির্দেশিকা থেকে একটি উদাহরণ দেওয়া হল, যেখানে দেখানো হয়েছে কিভাবে একটি আগ্রহের গোষ্ঠী তৈরি করতে হয় এবং ব্রাউজারকে গোষ্ঠীতে যোগদান করতে বলা হয়।

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);

updateUrl একটি URL প্রদান করে যা আগ্রহ গোষ্ঠীর বৈশিষ্ট্যগুলি আপডেট করার জন্য JSON ফেরত দেয়। এর অবশ্যই owner সাথে একই উৎস থাকতে হবে।

বৈশিষ্ট্য আপডেট করুন

updateUrl একটি ওয়েব সার্ভার নির্দিষ্ট করে যা joinAdInterestGroup() এ পাস করা ইন্টারেস্ট গ্রুপ অবজেক্টের সাথে সম্পর্কিত, ইন্টারেস্ট গ্রুপ প্রোপার্টি সংজ্ঞায়িত করে JSON ফেরত দেয়।

এটি গ্রুপের মালিককে আগ্রহের গোষ্ঠীর বৈশিষ্ট্যগুলি পর্যায়ক্রমে আপডেট করার অনুমতি দেয়। বর্তমান বাস্তবায়নে , নিম্নলিখিত বৈশিষ্ট্যগুলি পরিবর্তন করা যেতে পারে:

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

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

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

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

আপডেটের হার প্রতিদিন সর্বোচ্চ একটির মধ্যে সীমাবদ্ধ।

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

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

বর্তমান ফ্রেমের উৎপত্তিস্থলের মালিকানাধীন আগ্রহ গোষ্ঠীর আপডেটগুলি navigator.updateAdInterestGroups() ব্যবহার করে ম্যানুয়ালি ট্রিগার করা যেতে পারে।

রেট লিমিটিং আপডেটগুলি ঘন ঘন ঘটতে বাধা দেয়: navigator.updateAdInterestGroups() এ বারবার কল করলে রেট লিমিটের সময়কাল (বর্তমানে এক দিন) অতিক্রান্ত না হওয়া পর্যন্ত কিছুই করা হয় না।

একই ইন্টারেস্ট গ্রুপের owner এবং name জন্য navigator.joinAdInterestGroup() আবার কল করা হলে রেট লিমিট রিসেট হয়ে যায়।

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

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

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

সকল সুরক্ষিত শ্রোতা 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.