সুরক্ষিত দর্শক (পূর্বে FLEDGE নামে পরিচিত) পরিমাপ প্রদানকারীদের জন্য ইন্টিগ্রেশন গাইড

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

Protected Audience API-এ, যখন একটি রিমার্কেটিং বিজ্ঞাপন নিলামে জয়লাভ করে, তখন বিজ্ঞাপনটির রেন্ডার URL রেন্ডারিংয়ের জন্য একটি বেড়াযুক্ত ফ্রেমে পাঠানো হবে। একটি বেড়াযুক্ত ফ্রেম হল একটি প্রস্তাবিত এইচটিএমএল উপাদান এমবেড করা বিষয়বস্তুর জন্য, একটি iframe অনুরূপ। আইফ্রেমের বিপরীতে, একটি বেড়াযুক্ত ফ্রেম এটির এম্বেডিং প্রসঙ্গের সাথে যোগাযোগকে সীমাবদ্ধ করে যাতে ফ্রেমটিকে এম্বেডিং প্রসঙ্গের সাথে ভাগ না করে ক্রস-সাইট ডেটাতে অ্যাক্সেসের অনুমতি দেয়। আরো বিস্তারিত জানার জন্য, বেড়াযুক্ত ফ্রেম ব্যবহার কেস ব্যাখ্যাকারী পড়ুন।

Display & Video 360 ইম্প্রেশন এবং ক্লিক ট্র্যাকিংয়ের জন্য পরিমাপ প্রদানকারীর জন্য ম্যাক্রোগুলির একটি তালিকা সমর্থন করে। প্রাসঙ্গিক এবং নিলাম সংকেতের অভাবের কারণে এই ম্যাক্রোগুলির শুধুমাত্র একটি ছোট উপসেট সৃজনশীল রেন্ডারিংয়ের অংশ হিসাবে প্রতিস্থাপন করা যেতে পারে। উদাহরণস্বরূপ, ${PUBLISHER_ID} পরিমাপ প্রদানকারীর ট্যাগের পরিবর্তন ছাড়াই ভেঙে যাবে।

এই নির্দেশিকাটি বিজ্ঞাপন পরিমাপ অংশীদারদের জন্য ডিজাইন করা হয়েছে যারা Display & Video 360 ব্যবহার করে এমন বিজ্ঞাপনদাতাদের ইভেন্ট ট্র্যাক করে ।

তালিকাভুক্তি

আগস্ট 2023 থেকে শুরু করে, পরিমাপ প্রদানকারীদের সুরক্ষিত শ্রোতা এপিআই-এ ফেন্সড ফ্রেম রিপোর্টিং API ব্যবহার করতে নিজেদের নিবন্ধন করতে নীচের পদক্ষেপগুলি অনুসরণ করতে হতে পারে।

কিভাবে এবং কাদের নথিভুক্ত করতে হবে তার বিশদ বিবরণ

মিশ্রণ

পরিমাপ প্রদানকারী ইম্প্রেশন ট্যাগ

সেটআপ নির্দেশাবলী:

• Display & Video 360
• ক্যাম্পেইন ম্যানেজার 360

স্ক্রিপ্ট ট্যাগ	উদাহরণ <script src='https://tracking.com/a.js'>xxx</script> দায়িত্ব: পরিমাপ প্রদানকারীরা ইম্প্রেশন ট্র্যাকিংয়ের জন্য reportEvent API ব্যবহার করতে স্ক্রিপ্ট ট্যাগ আপডেট করতে (নীচে নির্দেশিকা দেখুন)।
Img ট্যাগ	উদাহরণ <img src='https://tracking.com/'> দায়িত্ব: ইমপ্রেশন ট্র্যাকিংয়ের জন্য reportEvent API ব্যবহার করতে img src ট্যাগ আপডেট করতে Display & Video 360।

রিপোর্ট ইভেন্ট API

এপিআই শুধুমাত্র পোস্ট-রেন্ডারিং ট্র্যাকিংয়ের জন্য ব্যবহার করার প্রস্তাব করা হয়েছিল। API-এ দুটি অংশ রয়েছে: registerAdMacro এবং reportEvent ।

• ডিসপ্লে ও ভিডিও 360 reportWin registerAdMacro ফাংশনের মালিক। রেন্ডারিং কলের আগে ফাংশনটি ব্রাউজারে ম্যাক্রো কী-মান জোড়া নিবন্ধন করবে।
• ট্যাগের প্রকারের উপর নির্ভর করে, Display & Video 360 বা পরিমাপ প্রদানকারীরা reportEvent API ব্যবহার করার জন্য 3PAT ট্যাগের পরিবর্তনের মালিক।

reportEvent শুধুমাত্র 1 ইনপুট 'destinationURL' নেয়, যা পরিমাপ প্রদানকারী সার্ভারের দিকে নির্দেশ করে। এতে Display & Video 360 সহায়তা কেন্দ্রে তালিকাভুক্ত যেকোনো ম্যাক্রো থাকতে পারে। উদাহরণ স্বরূপ:

window.fence.reportEvent({
  'destinationURL': 'https://adtech.example/impression?cid=555&pub_id=${PUBLISHER_ID}&site=${SOURCE_URL_ENC}&t=123'
});

যখন Chrome ফাংশনে URL পিং ফায়ার করে, তখন এটি নিবন্ধিত ম্যাক্রোগুলি সন্ধান করবে এবং https://adtech.example এ HTTP GET অনুরোধ পাঠানোর আগে তাদের মান দিয়ে প্রতিস্থাপন করবে।

স্ক্রিপ্ট ট্যাগ আপডেট করার পদক্ষেপ

বিদ্যমান সৃজনশীল ট্যাগগুলিতে কোন পরিবর্তন হবে না। Display & Video 360 এখনও সৃজনশীল পেলোডের অংশ হিসাবে পরিমাপ প্রদানকারীর ট্যাগগুলি পরিবর্তন ছাড়াই রেন্ডার করে৷ যখন পরিমাপ প্রদানকারীরা সুরক্ষিত শ্রোতা API প্রসঙ্গ থেকে ইমপ্রেশন পিংস পায়, তখন তাদের ইমপ্রেশন ট্র্যাকিংয়ের জন্য নীচের পদক্ষেপগুলি অনুসরণ করতে হবে:

1. ইম্প্রেশন পিংস গ্রহণ করার জন্য একটি পরিমাপ প্রদানকারী ইমপ্রেশন URL প্রস্তুত করুন। উদাহরণ স্বরূপ:

   https://adtech.example/impression?cid=555&pub_id=${PUBLISHER_ID}&site=${SOURCE_URL_ENC}&t=123
   

2. Protected Audience API থেকে একটি স্ক্রিপ্টে সাড়া দেওয়ার সময় reportEvent JS যোগ করুন। উদাহরণ স্বরূপ:

   window.fence.reportEvent({
     'destinationURL': 'https://adtech.example/impression?cid=555&pub_id=${PUBLISHER_ID}&site=${SOURCE_URL_ENC}&t=123'
   });
   

3. ধাপ 1 এ কনফিগার করা ইমপ্রেশন URL থেকে পিং পাওয়ার সময় লগ ইমপ্রেশন করুন।

পরিমাপ প্রদানকারী ক্লিক ট্যাগ

বিদ্যমান পরিমাপ প্রদানকারী ক্লিক ট্যাগ সুরক্ষিত দর্শক ইম্প্রেশনের জন্য কাজ করা চালিয়ে যাবে। Display & Video 360 Fenced Frames Ads Reporting API এর reserved.top_navigation বীকন ব্যবহার করবে ক্লিক রেজিস্টার করতে এবং সমস্ত পরিমাপ প্রদানকারী ক্লিক ট্র্যাকারকে পুনঃনির্দেশ হিসাবে চেইন করবে। আরও বিশদ বিবরণের জন্য, বেড়াযুক্ত ফ্রেম বিজ্ঞাপন রিপোর্টিং API-এর জন্য Chrome এর ডকুমেন্টেশন পড়ুন।