একটি সুরক্ষিত শ্রোতা 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
এমন একটি ওয়েব সার্ভারকে নির্দিষ্ট করে যা JSON সংজ্ঞায়িত করে সুদ গোষ্ঠীর বৈশিষ্ট্য প্রদান করে, যা joinAdInterestGroup()
এ পাস করা আগ্রহ গোষ্ঠীর বস্তুর সাথে সম্পর্কিত।
এটি গ্রুপের মালিককে পর্যায়ক্রমে আগ্রহ গ্রুপের বৈশিষ্ট্যগুলি আপডেট করার অনুমতি দেয়। বর্তমান বাস্তবায়নে , নিম্নলিখিত বৈশিষ্ট্যগুলি পরিবর্তন করা যেতে পারে:
-
biddingLogicUrl
-
biddingWasmHelperUrl
-
trustedBiddingSignalsUrl
-
trustedBiddingSignalsKeys
-
ads
-
priority
JSON-এ নির্দিষ্ট করা নেই এমন কোনো ক্ষেত্র ওভাররাইট করা হবে না—শুধু JSON-এ নির্দিষ্ট করা ক্ষেত্রগুলি আপডেট করা হবে—যেখানে navigator.joinAdInterestGroup()
কল করলে যে কোনো বিদ্যমান আগ্রহের গোষ্ঠী ওভাররাইট হয়।
আপডেটগুলি সর্বোত্তম প্রচেষ্টা, এবং নিম্নলিখিত অবস্থার অধীনে ব্যর্থ হতে পারে:
- নেটওয়ার্ক অনুরোধের সময়সীমা (বর্তমানে 30 সেকেন্ড)
- অন্যান্য নেটওয়ার্ক ব্যর্থতা।
- 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.