একটি বিজ্ঞাপন রেন্ডার করুন

যখন একটি সুরক্ষিত শ্রোতা নিলাম একটি বিজ্ঞাপন প্রার্থীকে ফেরত দেয়, তখন এটি একটি অস্বচ্ছ URN হিসাবে ফেরত দেওয়া যেতে পারে, যা একটি iframe এ একটি বিজ্ঞাপন রেন্ডার করতে ব্যবহৃত হয়, অথবা একটি FencedFrameConfig যা একটি বেড়াযুক্ত ফ্রেমে বিজ্ঞাপন রেন্ডার করতে ব্যবহৃত হয়৷

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

বেড়া ফ্রেম কি?

একটি বেড়াযুক্ত ফ্রেম ( <fencedframe> ) হল একটি iframe অনুরূপ এমবেডেড সামগ্রীর জন্য একটি HTML উপাদান। iframe s এর বিপরীতে, একটি বেড়াযুক্ত ফ্রেম তার এম্বেডিং প্রসঙ্গের সাথে যোগাযোগকে সীমাবদ্ধ করে যাতে ফ্রেমটিকে এম্বেডিং প্রসঙ্গের সাথে ভাগ না করে ক্রস-সাইট ডেটাতে অ্যাক্সেসের অনুমতি দেয়। একইভাবে, এম্বেডিং প্রেক্ষাপটে কোনো প্রথম-পক্ষের ডেটা বেড়াযুক্ত ফ্রেমের সাথে ভাগ করা যাবে না।

উদাহরণস্বরূপ, news.example বলুন (এম্বেডিং প্রসঙ্গ) একটি বেড়াযুক্ত ফ্রেমে shoes.example থেকে একটি বিজ্ঞাপন এম্বেড করে। news.example shoes.example বিজ্ঞাপন থেকে ডেটা বের করতে পারে না এবং shoes.example news.example থেকে প্রথম পক্ষের ডেটা শিখতে পারে না।

কিভাবে বেড়া ফ্রেম কাজ করে?

বেড়াযুক্ত ফ্রেমগুলি নেভিগেশনের জন্য FencedFrameConfig অবজেক্ট ব্যবহার করে। এই বস্তুটি একটি সুরক্ষিত দর্শক নিলাম থেকে ফেরত দেওয়া যেতে পারে। তারপর, কনফিগার অবজেক্টটি বেড়াযুক্ত ফ্রেম উপাদানের config বৈশিষ্ট্য হিসাবে সেট করা হয়। এটি একটি iframe থেকে পৃথক যেখানে একটি URL বা অস্বচ্ছ URN src অ্যাট্রিবিউটে বরাদ্দ করা হয়। FencedFrameConfig অবজেক্টের একটি শুধুমাত্র পঠনযোগ্য url বৈশিষ্ট্য আছে; যাইহোক, যেহেতু বর্তমান ব্যবহারের ক্ষেত্রে অভ্যন্তরীণ সম্পদের প্রকৃত URL লুকানো প্রয়োজন, এই বৈশিষ্ট্যটি পড়ার সময় স্ট্রিং অস্বচ্ছ করে দেয়।

একটি বেড়াযুক্ত ফ্রেম তার এমবেডারের সাথে যোগাযোগ করতে postMessage ব্যবহার করতে পারে না। যাইহোক, একটি বেড়াযুক্ত ফ্রেম বেড়াযুক্ত ফ্রেমের ভিতরে iframe এর সাথে postMessage ব্যবহার করতে পারে।

বেড়াযুক্ত ফ্রেমগুলি প্রকাশকের থেকে অন্য উপায়ে আলাদা করা হবে৷ প্রকাশকের একটি বেড়াযুক্ত ফ্রেমের ভিতরে DOM-এ অ্যাক্সেস থাকবে না এবং বেড়াযুক্ত ফ্রেম প্রকাশকের DOM-এ অ্যাক্সেস করতে পারবে না৷ আরও, name এর মতো গুণাবলী, যা প্রকাশকের দ্বারা যে কোনও মান সেট করা এবং পর্যবেক্ষণ করা যেতে পারে, বেড়াযুক্ত ফ্রেমে উপলব্ধ নয়৷

বেড়াযুক্ত ফ্রেমগুলি একটি শীর্ষ-স্তরের ব্রাউজিং প্রসঙ্গের মতো আচরণ করে (যেমন একটি ব্রাউজার ট্যাব)। যদিও নির্দিষ্ট ব্যবহারের ক্ষেত্রে একটি বেড়াযুক্ত ফ্রেম (যেমন opaque-ads ) ক্রস-সাইট ডেটা (যেমন একটি সুরক্ষিত অডিয়েন্স API ইন্টারেস্ট গ্রুপ) ধারণ করতে পারে, ফ্রেমটি বিভাজনবিহীন স্টোরেজ বা কুকিজ অ্যাক্সেস করতে পারে না। একটি opaque-ads বেড়াযুক্ত ফ্রেম একটি অনন্য, ননস-ভিত্তিক কুকি এবং স্টোরেজ পার্টিশন অ্যাক্সেস করতে পারে।

বেড়াযুক্ত ফ্রেমের বৈশিষ্ট্য ব্যাখ্যাকারীতে আরও বিশদ বিবরণ দেওয়া হয়েছে।

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

একটি FencedFrameConfig একটি সুরক্ষিত শ্রোতা নিলাম থেকে ফেরত দেওয়া হয়, শর্ত থাকে যে AuctionConfig এর resolveToConfig প্যারামিটারটি সত্য হিসাবে সেট করা হয়েছে:

const frameConfig = await navigator.runAdAuction({
  // ...auction configuration
  resolveToConfig: true
});

একবার আপনি কনফিগারেশনটি পেয়ে গেলে, কনফিগার দ্বারা উপস্থাপিত সংস্থানে ফ্রেমটি নেভিগেট করতে আপনি এটিকে একটি বেড়াযুক্ত ফ্রেমের config বৈশিষ্ট্যে বরাদ্দ করতে পারেন। Chrome এর পূর্ববর্তী সংস্করণগুলি resolveToConfig বৈশিষ্ট্যকে সমর্থন করে না, তাই আপনাকে অবশ্যই নিশ্চিত করতে হবে যে নেভিগেট করার আগে একটি FencedFrameConfig এ প্রতিশ্রুতি সমাধান হয়েছে:

if (window.FencedFrameConfig && frameConfig instanceof FencedFrameConfig) {
  const frame = document.createElement('fencedframe');
  frame.config = frameConfig;
}

একটি আইফ্রেমে একটি বিজ্ঞাপন রেন্ডার করুন

যদি AuctionConfig স্পষ্টভাবে resolveToConfig সেট না করে বা এটি মিথ্যাতে সেট করা থাকে, তাহলে runAdAuction() একটি অস্বচ্ছ URN প্রদান করে। এই URN বিজ্ঞাপন রেন্ডার করার জন্য একটি iframe এর src হিসাবে সেট করা যেতে পারে।