সুরক্ষিত দর্শক API নিলাম প্রতিবেদন

সুরক্ষিত শ্রোতা API নিলাম ডেটা এবং ফলাফল পরিমাপ করুন

এই প্রবন্ধে, আপনি আপনার সার্ভারে Protected Audience API নিলাম ডেটা রিপোর্ট করার জন্য উপলব্ধ বিভিন্ন প্রক্রিয়ার একটি উচ্চ-স্তরের ওভারভিউ পাবেন, সেই সাথে বিকল্প সমাধান প্রস্তুত না হওয়া পর্যন্ত মাইগ্রেশনের সময় আপনার ব্যবহারের জন্য বর্তমানে উপলব্ধ ট্রানজিশন প্রক্রিয়াগুলিও পাবেন।

বিজ্ঞাপন নিলাম থেকে সংগ্রহ করা গুরুত্বপূর্ণ মেট্রিক্সের প্রতিবেদন করার জন্য, Protected Audience API নিম্নলিখিতগুলির সাথে কাজ করে:

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

সুরক্ষিত দর্শক API রিপোর্টিং ওভারভিউ

তিনটি প্রধান সময়কাল আছে যেখানে Protected Audience API নিলাম প্রবাহ থেকে ডেটা আপনার সার্ভারে রিপোর্ট করা যেতে পারে: প্রকাশক সাইট থেকে নিলাম কার্যকর করার সময় নিলামের সময়, প্রকাশক সাইটে বিজ্ঞাপনটি একটি বেড়াযুক্ত ফ্রেম বা আইফ্রেমে রেন্ডার করার সময় রেন্ডার করার সময় এবং ব্যবহারকারী যখন অন্য কোনও সাইটে কিছু পদক্ষেপ নেয় যা নিলামের সাথে সম্পর্কিত হতে পারে তখন রূপান্তরের সময়।

নিলামের সময়, আপনি রিপোর্টিং ওয়ার্কলেট ব্যবহার করে নিলামের ডেটা রিপোর্ট করতে পারেন। রেন্ডারের সময়, আপনি একটি আইফ্রেম বা একটি বেড়াযুক্ত ফ্রেম থেকে এনগেজমেন্ট ডেটা রিপোর্ট করতে পারেন। রূপান্তরের সময়, আপনি অ্যাট্রিবিউশন রিপোর্টিং API ব্যবহার করে গন্তব্য পৃষ্ঠা থেকে অ্যাট্রিবিউশন ডেটা রিপোর্ট করতে পারেন।

অবস্থানগুলি রিপোর্ট করা হচ্ছে

নিলামের মধ্যে, ক্রেতারা generateBid() এবং reportWin() ওয়ার্কলেটে উপলব্ধ সংকেতগুলি রিপোর্ট করতে সক্ষম হন এবং বিক্রেতারা scoreAd() এবং reportResult() এ উপলব্ধ সংকেতগুলি রিপোর্ট করতে সক্ষম হন। নিলামের বাইরে, ক্রেতা এবং বিক্রেতারা বিজ্ঞাপনটি রেন্ডার করা একটি ফ্রেম এবং যে সাইট থেকে রূপান্তর করা হয়েছিল সেখান থেকে ডেটা রিপোর্ট করতে পারেন।

তালিকাভুক্ত প্রতিটি সময়কালে, ক্রেতা এবং বিক্রেতারা নিলাম সংকেত, ইভেন্ট-স্তরের ডেটা এবং রূপান্তর ডেটার মতো ডেটা রিপোর্ট করার জন্য উপলব্ধ বিভিন্ন রিপোর্টিং API-তে অ্যাক্সেস পাবেন।

একটি সুরক্ষিত দর্শক API নিলামের মধ্যে উপলব্ধ ডেটা

নিলামের সময় একটি সুরক্ষিত শ্রোতা API ওয়ার্কলেট থেকে নিম্নলিখিত তথ্যগুলি রিপোর্ট করার জন্য উপলব্ধ।

সংকেত

সিগন্যাল হল নিলামের প্রাসঙ্গিক তথ্য, ব্যবহারকারীর তথ্য, রিয়েল-টাইম তথ্য এবং ব্রাউজার তথ্য যা ক্রেতা এবং বিক্রেতাদের কাছে একটি ওয়ার্কলেটের মধ্যে উপলব্ধ, যাতে তারা একটি বিড তৈরি করতে, একটি বিজ্ঞাপন স্কোর করতে এবং নিলামের ফলাফল রিপোর্ট করতে পারে।

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

অন্যান্য উপলব্ধ তথ্য

• নিলামে জয়-পরাজয়ের তথ্যের সাথে সম্পর্কিত ফলাফলের তথ্য যেমন জয়ের দর মূল্য এবং দর প্রত্যাখ্যানের কারণ।
• পারফরম্যান্স ডেটা যাতে ল্যাটেন্সি তথ্য থাকে, যেমন বিডিং ওয়ার্কলেট আনতে এবং কার্যকর করতে কত সময় লেগেছে।

সুরক্ষিত দর্শক API নিলামের বাইরে উপলব্ধ ডেটা

সুরক্ষিত শ্রোতা API নিলামের বাইরে, দুটি সময়কাল থাকে যেখানে ডেটা রিপোর্ট করার জন্য উপলব্ধ থাকে।

রেন্ডারের সময়, যখন প্রকাশক সাইটে বিজ্ঞাপনটি রেন্ডার করা হয়, তখন iframe বা fenced ফ্রেমের ভেতরের ইভেন্ট-লেভেল ডেটা Protected Audience API নিলাম ডেটার সাথে যুক্ত করা যেতে পারে এবং আপনার সার্ভারে রিপোর্ট করা যেতে পারে। উদাহরণস্বরূপ ইভেন্ট-লেভেল ডেটার মধ্যে বিজ্ঞাপনের ছাপ, ক্লিকথ্রু, হোভার এবং ফ্রেমের ভেতরে ঘটে যাওয়া অন্য যেকোনো ইভেন্ট অন্তর্ভুক্ত থাকে।

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

ইভেন্ট-স্তরের প্রতিবেদন

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

sendReportTo() এর মাধ্যমে ইভেন্ট-স্তরের নিলাম জয়ের রিপোর্টিং

একটি Protected Audience নিলামের মধ্যে ইভেন্ট-স্তরের ডেটা রিপোর্ট করার জন্য উপলব্ধ একটি প্রক্রিয়া হল sendReportTo() function নিলাম জয়ের সময় ব্যবহার করা হয়। ফাংশনটি ক্রেতা এবং বিক্রেতার রিপোর্টিং ওয়ার্কলেটে উপলব্ধ এবং বিজ্ঞাপন রেন্ডারিং শুরু হলে ব্রাউজার সরবরাহকৃত URL স্ট্রিংয়ে একটি GET অনুরোধ করে। আপনি URL এর কোয়েরি প্যারামিটার হিসাবে আপনার ওয়ার্কলেটে উপলব্ধ যেকোনো সংকেত এনকোড করতে পারেন।

উদাহরণস্বরূপ, একজন ক্রেতা বিলিং উদ্দেশ্যে reportWin() ওয়ার্কলেট থেকে বিজয়ী বিডের পরিমাণ রিপোর্ট করতে পারেন:

// Buyer reporting worklet
function reportWin(auctionSignals, perBuyerSignals, sellerSignals, browserSignals, directFromSellerSignals) {
  sendReportTo(`https://buyer-reporting-server.example/reporting?bid=${browserSignals.bid}`);
}

sendReportTo() ফাংশনটি reportResult() থেকে কল করলে বিক্রেতার জন্য একটি win রিপোর্ট তৈরি করতে এবং reportWin() থেকে কল করলে ক্রেতার জন্য একটি win রিপোর্ট তৈরি করতে ব্যবহার করা যেতে পারে। sendReportTo() ফাংশনটি কমপক্ষে 2026 সাল পর্যন্ত উপলব্ধ থাকবে,

বাগদানের প্রতিবেদন

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

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

বেড়াযুক্ত ফ্রেম এবং আইফ্রেমের জন্য বিজ্ঞাপন প্রতিবেদন API

ফেন্সড ফ্রেম এবং আইফ্রেমের জন্য বিজ্ঞাপন প্রতিবেদন API আপনাকে একটি সুরক্ষিত দর্শক নিলামের মধ্যে থাকা সংকেতের সাথে একটি বিজ্ঞাপন ফ্রেম থেকে ব্যবহারকারীর ইভেন্ট-স্তরের ডেটা সংযুক্ত করার একটি প্রক্রিয়া প্রদান করে।

একটি Protected Audience API রিপোর্টিং ওয়ার্কলেটে, আপনি registerAdBeacon() ফাংশনের সাথে একটি বিজ্ঞাপন বীকন নিবন্ধন করতে পারেন এবং কোয়েরি প্যারামিটার হিসাবে যোগ করা সংকেতগুলি দিয়ে আপনার রিপোর্টিং URL এ পাস করতে পারেন। আপনি রিপোর্টিং URL এর সাথে সংযুক্ত করতে চান এমন কাস্টম ইভেন্টটিও নির্দিষ্ট করতে পারেন। তারপর, পরবর্তী সময়ে যখন বিজ্ঞাপনটি একটি ফেন্সড ফ্রেমে রেন্ডার করা হয়, তখন আপনি window.fence.reportEvent() ফাংশনটি কল করে কাস্টম ইভেন্টটি ট্রিগার করতে পারেন। ফেন্সড ফ্রেমের মধ্যে উপলব্ধ ডেটা পেলোড হিসাবে যোগ করা যেতে পারে।

registerAdBeacon() ফাংশনটি শুধুমাত্র রিপোর্টিং ফাংশনে উপলব্ধ, এবং ক্রেতার বিডিং লজিক এবং বিক্রেতার স্কোরিং লজিকে উপলব্ধ নয়।

নিম্নলিখিত উদাহরণে, একটি ক্যাম্পেইন আইডি ক্লিক স্থানাঙ্ক সহ একটি ইভেন্ট-স্তরের পেলোডের সাথে যুক্ত করা হয়েছে:

// Protected Audience API buyer win reporting worklet
function reportWin(auctionSignals) {
  const { campaignId } = auctionSignals

  registerAdBeacon({
    click: `https://buyer-server.example/report/click?campaignId=${campaignId}`
  })
}

// Protected Audience API seller reporting worklet
function reportResult(auctionConfig) {
  const { campaignId } = auctionConfig.auctionSignals;

  registerAdBeacon({
    click: `https://seller-server.example/report/click?campaignId=${campaignId}`
  })
}

// Ad frame
window.fence.reportEvent({
  eventType: 'click',
  eventData: JSON.stringify({'clickX': '123', 'clickY': '456'}),
  destination:['buyer', 'seller']
});

উইন রিপোর্টিংয়ের মতো একই কারণে, Fenced Frames Ads Reporting API কমপক্ষে ২০২৬ সাল পর্যন্ত উপলব্ধ থাকবে।

আরও গভীরে যাওয়ার জন্য, ব্যাখ্যাকারীটি দেখুন।

অবাধ নেটওয়ার্ক অ্যাক্সেস

ফেন্সড ফ্রেমগুলি আইফ্রেমের মতোই নেটওয়ার্ক রিসোর্স লোড করার অনুমতি দেবে এবং আপনি ফেন্সড ফ্রেমের মধ্যে ইভেন্ট-লেভেল ডেটা আপনার সার্ভারে পাঠাতে পারবেন। আপনি পরে সার্ভার-সাইডে ইভেন্ট-লেভেল রিপোর্ট তৈরি করতে পারেন, একটি ফেন্সড ফ্রেম থেকে ইভেন্ট-লেভেল ডেটাকে sendReportTo() দিয়ে পাঠানো নিলাম ডেটার সাথে সংযুক্ত করে যা উপরে নিলাম ইভেন্ট-লেভেল রিপোর্টিং মেকানিজম বিভাগে আলোচনা করা হয়েছে।

ভবিষ্যতে নেটওয়ার্ক অ্যাক্সেস সীমিত হবে।

অ্যাট্রিবিউশন রিপোর্ট

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

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

ট্রানজিশনাল মেকানিজম

একটি বিজ্ঞাপন বীকন নিবন্ধন করার সময়, আপনি reserved.top_navigation কীওয়ার্ড ব্যবহার করতে পারেন যা স্বয়ংক্রিয়ভাবে বীকনের জন্য Attribution-Reporting-Eligible হেডার যোগ করবে যাতে এটি একটি অ্যাট্রিবিউশন উৎস হিসেবে নিবন্ধনের যোগ্য হয়ে ওঠে।

registerAdBeacon({
 'reserved.top_navigation': 'https://adtech.example/click?buyer_event_id=123',
});

আপনার নিবন্ধিত বীকনে ইভেন্ট-স্তরের ডেটা সংযুক্ত করতে, আপনি ইভেন্ট পেলোড সহ বেড়াযুক্ত ফ্রেম থেকে setReportEventDataForAutomaticBeacons() কল করতে পারেন।

window.fence.setReportEventDataForAutomaticBeacons({
  eventType: 'reserved.top_navigation',
  eventData: 'data from the frame',
  destination:['seller', 'buyer']
})

আরও জানতে বিজ্ঞাপন প্রতিবেদন API ব্যাখ্যাকারীর অ্যাট্রিবিউশন প্রতিবেদন বিভাগটি দেখুন।

এনগেজমেন্ট এবং কনভার্সন রিপোর্টিং এর উদাহরণ

এই উদাহরণে, আমরা ক্রেতার দৃষ্টিকোণ থেকে এটি দেখব যারা নিলাম, বিজ্ঞাপন ফ্রেম এবং রূপান্তর সাইট থেকে ডেটা একসাথে সংযুক্ত করতে আগ্রহী।

এই কর্মপ্রবাহে, ক্রেতা বিক্রেতার সাথে সমন্বয় করে নিলামে একটি অনন্য আইডি পাঠান। নিলামের সময়, ক্রেতা নিলামের ডেটার সাথে এই অনন্য আইডিটি পাঠান। রেন্ডার এবং রূপান্তরের সময়, ফেন্সড ফ্রেম বা আইফ্রেম থেকে ডেটাও একই অনন্য আইডি দিয়ে পাঠানো হয়। পরে, এই প্রতিবেদনগুলিকে একসাথে সংযুক্ত করতে অনন্য আইডিটি ব্যবহার করা যেতে পারে।

কর্মপ্রবাহ:

1. নিলাম শুরু হওয়ার আগে, ক্রেতা তাদের প্রোগ্রাম্যাটিক রিয়েল-টাইম বিডিং ("RTB") বিড রেসপন্সের অংশ হিসেবে বিক্রেতাকে একটি অনন্য আইডি পাঠায়। আইডিটি auctionId মতো একটি ভেরিয়েবল হিসেবে সেট করা যেতে পারে। আইডিটি auctionConfig এ perBuyerSignals হিসেবে পাস করা হয় এবং এটি ক্রেতার ওয়ার্কলেটে উপলব্ধ হয়।
2. নিলামের সময়, ক্রেতা বিজ্ঞাপন রেন্ডার সময় এবং রূপান্তর সময় ( registerAdBeacon() ) ট্রিগার করার জন্য একটি বিজ্ঞাপন বীকন নিবন্ধন করতে পারেন।
   1. কোনও বিজ্ঞাপন ফ্রেম ইভেন্টের জন্য নিলাম সিগন্যাল সংযুক্ত করতে, auctionId কে বীকন URL-এর একটি কোয়েরি প্যারামিটার হিসেবে সেট করুন।
   2. একটি রূপান্তর ইভেন্টের জন্য নিলাম সংকেত সংযুক্ত করতে, বীকন URL-এ auctionId সেট করুন।
3. বিজ্ঞাপন রেন্ডারের সময়, নিলামের সময় আপনার নিবন্ধিত বীকনগুলি ইভেন্ট-স্তরের ডেটা দিয়ে ট্রিগার বা উন্নত করা যেতে পারে।
   1. reportEvent() দিয়ে ফ্রেম ইভেন্টটি ট্রিগার করুন এবং ইভেন্ট-লেভেল ডেটা পাস করুন।
   2. setReportEventDataForAutomaticBeacons() ব্যবহার করে অ্যাট্রিবিউশন বীকনে ইভেন্ট-লেভেল পেলোড যোগ করুন।
   3. Attribution-Reporting-Register-Source হেডার ব্যবহার করে বিজ্ঞাপন বীকনের অনুরোধের জবাব দিয়ে Attribution Reporting API-এর মাধ্যমে বিজ্ঞাপনটি নিবন্ধন করুন।
4. রূপান্তরের সময়, আপনি নিলামের সময় আপনার নিবন্ধিত উৎসটি ট্রিগার করতে পারেন।

উপরের প্রক্রিয়াটির পরে, ক্রেতার কাছে একটি নিলাম রিপোর্ট, এনগেজমেন্ট রিপোর্ট এবং কনভার্সন রিপোর্ট থাকবে, যা একটি একক অনন্য কী দ্বারা একত্রিত হবে যা একে অপরের সাথে সংযুক্ত করতে ব্যবহার করা যেতে পারে।

একই ধরণের ওয়ার্কফ্লো বিক্রেতার ক্ষেত্রে প্রযোজ্য যদি তাদের অ্যাট্রিবিউশন ডেটা অ্যাক্সেসের প্রয়োজন হয় এবং বিক্রেতা registerAdBeacon() দিয়ে পাঠানোর জন্য একটি অনন্য আইডি ব্যবহার করতে পারেন। ফ্রেম থেকে, reportEvent() কলটিতে একটি গন্তব্য সম্পত্তি রয়েছে যা ক্রেতা এবং বিক্রেতা উভয়ের কাছে রিপোর্ট পাঠাতে ব্যবহার করা যেতে পারে। মনে রাখবেন যে ট্রিগারটি উৎসের সাথে যুক্ত করার জন্য ল্যান্ডিং পৃষ্ঠায় SSP-কেও উপস্থিত থাকতে হবে।

সুরক্ষিত দর্শকদের ডেটা একত্রিত করা

প্রাইভেট অ্যাগ্রিগেশন এপিআই হল প্রোটেক্টেড অডিয়েন্স ডেটা রিপোর্ট করার জন্য ব্যবহৃত একটি প্রক্রিয়া যা একটি সারাংশ রিপোর্ট তৈরি করে, যা বাকেটগুলিতে সংগৃহীত ডেটার একটি গোলমালপূর্ণ, সমষ্টিগত প্রতিবেদন। একটি বাকেটকে একটি অ্যাগ্রিগেশন কী দ্বারা প্রতিনিধিত্ব করা হয় এবং কিছু তথ্য কীতে এনকোড করা যেতে পারে।

উদাহরণস্বরূপ, একটি বিজ্ঞাপন ইম্প্রেশন ইভেন্টকে বিভিন্ন বাকেটে গণনা করা যেতে পারে, যেখানে প্রতিটি বাকেটে একটি ভিন্ন বিজ্ঞাপন প্রচারণার প্রতিনিধিত্ব করে। একটি সারাংশ প্রতিবেদন একটি ইভেন্ট-স্তরের প্রতিবেদন থেকে আলাদা কারণ এটি প্রতিটি পৃথক ইভেন্ট সম্পর্কে তথ্য প্রকাশ করে না। একটি ইভেন্ট-স্তরের প্রতিবেদনের সাহায্যে, আপনি নির্ধারণ করতে পারেন যে A, B এবং C ব্যবহারকারীরা প্রচারণা 123 দেখেছেন। সারাংশ প্রতিবেদনের সাহায্যে, আপনি কতজন ব্যবহারকারী প্রচারণা 123 দেখেছেন তা পরিমাপ করতে পারেন এবং ব্যবহারকারীর গোপনীয়তা রক্ষা করার জন্য শব্দ যোগ করা হয় ।

API সম্পর্কে আরও জানতে Private Aggregation নিবন্ধটি দেখুন।

নিলাম সংকেত একত্রিত করা

আপনি প্রাইভেট অ্যাগ্রিগেশন ব্যবহার করে ওয়ার্কলেটের মধ্যে উপলব্ধ সিগন্যালগুলিকে আপনার সার্ভারে একত্রিত করতে পারেন। সিগন্যাল অ্যাগ্রিগেশনের জন্য, আপনি privateAggregation.contributeToHistogram() পদ্ধতিটি ব্যবহার করতে পারেন যা ক্রেতা বিডিং ওয়ার্কলেট, বিক্রেতা স্কোরিং ওয়ার্কলেট এবং ক্রেতা/বিক্রেতা রিপোর্টিং ওয়ার্কলেটে উপলব্ধ।

এই উদাহরণে, বিজয়ী দরটি আগ্রহ গোষ্ঠীর মালিকের বাকেটে একত্রিত করা হয়েছে:

function convertBuyerToBucket(igOwner) {}
function convertWinningBidToValue(winningBid) {}

function reportResult(auctionConfig, browserSignals) {
  privateAggregation.contributeToHistogram({
    bucket: convertBuyerToBucket(browserSignals.interestGroupOwner),
    value: convertWinningBidToValue(browserSignals.bid)
  });
} 

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

ইভেন্ট ডেটার সাথে নিলাম সংকেত একত্রিত করা

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

ইভেন্ট অনুসারে নিলাম সংকেত একত্রিত করতে, আপনি privateAggregation.contributeToHistogramOnEvent(eventType, contribution) ব্যবহার করতে পারেন যা একটি স্ট্রিং নেয় যা ইভেন্টের ধরণ এবং সেই ইভেন্টটি ট্রিগার হওয়ার সময় রিপোর্ট করার জন্য অবদান নির্দিষ্ট করে। আপনি একটি কাস্টম ইভেন্ট টাইপ সহ পদ্ধতিটি কল করতে পারেন, তারপরে, জমা দেওয়ার জন্য রিপোর্টটি ট্রিগার করতে বিজ্ঞাপন ফ্রেম থেকে window.fence.reportEvent(eventType) কল করতে পারেন।

ধরুন আপনি একটি প্রচারণার বিজ্ঞাপন কতগুলি ক্লিক পেয়েছে তা পরিমাপ করতে চান।

// Protected Audience API worklet
function getClickReportBucketForCampaign(campaignId) {
  // return a bucket for the campaign ID and the click event
}

function generateBid(interestGroup) {
  privateAggregation.contributeToHistogramOnEvent('click', {
    bucket: getClickReportBucketForCampaign(interestGroup.ads.metadata.campaignId), 
    value: 1
  });
}

বিড জেনারেশন ফাংশনে, আপনি একটি বাকেটকে ক্যাম্পেইন আইডি এবং ক্লিক ইভেন্টের সংমিশ্রণ হিসাবে সংজ্ঞায়িত করতে পারেন, তারপর প্রতিবার ইভেন্টটি ট্রিগার করার সময় সেই বাকেটের মান 1 দ্বারা বৃদ্ধি করুন।

// Ad frame
window.fence.reportEvent('click');

তারপর, পরবর্তী সময়ে, বিজ্ঞাপন ফ্রেম থেকে, আপনি reportEvent(eventType) কল করে রিপোর্ট জমা দেওয়ার প্রক্রিয়াটি ট্রিগার করতে পারেন:

এক্সপ্লেনারের একটি ফ্রেম থেকে ব্যক্তিগত সমষ্টি অবদান ট্রিগার করার বিষয়ে আরও জানুন।

নিলামের ফলাফল এবং কর্মক্ষমতা রিপোর্ট করা

আপনি যখন একটি সংরক্ষিত ইভেন্ট টাইপ কীওয়ার্ড ( reserved.win, reserved.loss , এবং reserved.always ) পাস করেন তখন contributeToHistogramOnEvent(eventType, contribution) ব্যবহার করে নিলামের ফলাফল একত্রিত করতে পারেন যখন কোনও নিলাম জয় বা পরাজয়ের ঘটনা ট্রিগার হয়।

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

যখন কিছু বেস ভ্যালু প্রদান করা হয়, যেমন বিজয়ী বিডের পরিমাণ, তখন আপনি সেই মান থেকে কত যোগ বা বিয়োগ করতে হবে তা নির্ধারণ করতে পারেন, তারপর চূড়ান্ত মান রিপোর্ট করতে পারেন। উদাহরণস্বরূপ, যদি $5 এর বিজয়ী বিডটি বেস ভ্যালু হিসাবে প্রদান করা হয়, তাহলে আপনি আপনার $2 এর বিড বিয়োগ করে আপনার নিলামে কত হারলেন তার প্রকৃত মূল্য $3 গণনা করতে পারেন।

নিলামের ফলাফলের প্রতিবেদন

চলুন এমন একটি উদাহরণ দেখি যেখানে আপনি একটি নিলামে হেরে গেছেন, এবং আপনি জানতে চান যে আপনার বিড নিলাম ক্লিয়ারিং মূল্য থেকে কতটা দূরে ছিল।

নিলামে আপনি কত হারলেন তা জানতে, আপনি বিজয়ী বিড মূল্য থেকে আপনার বিড মূল্য বিয়োগ করতে পারেন:

function generateBid() {
  const bid = calculateBidAmount();

  privateAggregation.contributeToHistogramOnEvent('reserved.loss', {
    bucket: getBucketForCampaign(interestGroup.ads.metadata.campaignId),
    value: {
      baseValue: 'winning-bid',
      scale: 1 // Scale the value to minimize noise-to-signal ratio 
      offset: -bid, // Numbers added to browser value after scaling 
    }
  });
}

যখন রিপোর্ট জমা দেওয়া হবে, তখন প্রকৃত রিপোর্ট করা মান হবে offset মান দ্বারা স্থানান্তরিত স্কেল করা baseValue । আরও জানতে, ব্যাখ্যাকারী দেখুন।

কর্মক্ষমতা প্রতিবেদন

ক্রেতা এবং বিক্রেতারা একটি স্ক্রিপ্ট কার্যকর করতে কত সময় নিয়েছে এবং বিশ্বস্ত সংকেত পেতে কত সময় লেগেছে তা রিপোর্ট করতে পারেন। বিক্রেতারা তাদের অনুমতি নিয়ে প্রতিটি ক্রেতার বিড জেনারেশন সময় এবং বিশ্বস্ত বিডিং সিগন্যাল সময় সংগ্রহ করতে পারেন।

আরও জানতে ব্যাখ্যাকারীটি দেখুন।

শেয়ার্ড স্টোরেজে নিলাম সংকেত সংরক্ষণ করা

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

আপনি Protected Audience API বিডিং, স্কোরিং এবং রিপোর্টিং ওয়ার্কলেট থেকে শেয়ার্ড স্টোরেজে লিখতে পারেন। পরবর্তী সময়ে, আপনি Private Aggregation ব্যবহার করে শেয়ার্ড স্টোরেজে থাকা মানগুলি আপনার সার্ভারে রিপোর্ট করতে পারেন। আপনি URL নির্বাচন অপারেশনের জন্যও সঞ্চিত মানগুলি ব্যবহার করতে পারেন।

একটি Protected Audience API ওয়ার্কলেট থেকে, আপনি শেয়ার্ড স্টোরেজে যেকোনো কী এবং মান লিখতে পারেন:

// Protected Audience API worklet
function generateBid() {
  sharedStorage.set('test-bucket', 123);
}

পরবর্তী সময়ে, আপনি একটি শেয়ার্ড স্টোরেজ ওয়ার্কলেট লোড করে প্রাইভেট অ্যাগ্রিগেশনের মাধ্যমে সেই মানটি পড়তে এবং পাঠাতে পারেন:

// Shared Storage worklet
class SendReachReport{
  async run() {
    const testBucket = await this.sharedStorage.get('test-bucket');

    privateAggregation.contributeToHistogram({
      bucket: testBucket,
      value: 1
    });
  }
}

register('send-report', SendReachReport);

শেয়ার্ড স্টোরেজ সম্পর্কে আরও জানতে, প্রোটেক্টেড অডিয়েন্স API রিপোর্টিং ডেভেলপার গাইড, এক্সপ্লেনার , লাইভ ডেমো এবং GitHub-এর ডেমো কোডের শেয়ার্ড স্টোরেজ বিভাগটি দেখুন।

এরপর কি?

আমরা প্রত্যেকের জন্য কাজ করে এমন একটি API তৈরি নিশ্চিত করতে আপনার সাথে কথোপকথনে নিযুক্ত হতে চাই।

API নিয়ে আলোচনা কর

অন্যান্য গোপনীয়তা স্যান্ডবক্স API-এর মতো, এই APIটি নথিভুক্ত এবং সর্বজনীনভাবে আলোচনা করা হয় ।

API এর সাথে পরীক্ষা করুন

আপনি সুরক্ষিত শ্রোতা API সম্পর্কে কথোপকথনে পরীক্ষা করতে এবং অংশগ্রহণ করতে পারেন৷