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

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

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

আপনি একটি বিজ্ঞাপন নিলাম থেকে সংগ্রহ করা গুরুত্বপূর্ণ মেট্রিক্স সম্পর্কে রিপোর্ট করতে, সুরক্ষিত দর্শক API এর সাথে কাজ করে:

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

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

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

সুরক্ষিত শ্রোতা সামগ্রিক কর্মপ্রবাহ

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

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

অবস্থান রিপোর্টিং

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

সময় কাল	গন্তব্য	অবস্থান	ডেটা উপলব্ধ	রিপোর্টিং এপিআই উপলব্ধ
নিলাম	ক্রেতা	generateBid()	সংকেত, নিলাম ফলাফল, এবং নিলাম কর্মক্ষমতা	প্রাইভেট অ্যাগ্রিগেশন API
		reportWin()		প্রাইভেট অ্যাগ্রিগেশন API বিজ্ঞাপন প্রতিবেদন API
	বিক্রেতা	scoreAd()		প্রাইভেট অ্যাগ্রিগেশন API
		reportResult()		প্রাইভেট অ্যাগ্রিগেশন API বিজ্ঞাপন প্রতিবেদন API
রেন্ডার	ক্রেতা/বিক্রেতা	প্রকাশক সাইটে ফ্রেম	বিজ্ঞাপন ফ্রেমের মধ্যে ইভেন্ট-স্তরের ডেটা	প্রাইভেট অ্যাগ্রিগেশন API বিজ্ঞাপন প্রতিবেদন API
পরিবর্তন	ক্রেতা/বিক্রেতা	রূপান্তর সাইট	রূপান্তর সাইট থেকে রূপান্তর এবং ইভেন্ট-স্তরের ডেটা	অ্যাট্রিবিউশন রিপোর্টিং API প্রাইভেট অ্যাগ্রিগেশন API বিজ্ঞাপন প্রতিবেদন API

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

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

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

সংকেত

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

সংকেত	বর্ণনা	এলাকা নির্বাচন	ব্যবহারকারীদের	উপস্থিতি
নিলাম সংকেত	যেখানে নিলাম অনুষ্ঠিত হয় সেই প্রসঙ্গে উপলভ্য ডেটা। এই ডেটাতে পৃষ্ঠার বিষয়বস্তুর তথ্য, প্রথম পক্ষের ব্যবহারকারীর ডেটা এবং আরও অনেক কিছু অন্তর্ভুক্ত থাকতে পারে।	নিলাম কনফিগারেশনে প্রকাশকের সাইট থেকে বিক্রেতার দ্বারা সেট করা হয়েছে।	ক্রেতা বিক্রেতা	বিড স্কোর তৈরি করুন বিজ্ঞাপন রিপোর্টউইন রিপোর্ট ফলাফল
directFromSellerSignals	auctionSignals , perBuyerSignals , sellerSignals এর জন্য একই ডেটা কিন্তু নির্দিষ্ট বিক্রেতার কাছ থেকে সিগন্যাল আসবে নিশ্চিত।	বিক্রেতার কাছ থেকে HTTP প্রতিক্রিয়া হেডারের মাধ্যমে সেট করুন	ক্রেতা বিক্রেতা	বিড স্কোর তৈরি করুন বিজ্ঞাপন রিপোর্টউইন রিপোর্ট ফলাফল
ব্রাউজার সিগন্যাল	ব্রাউজার দ্বারা প্রদত্ত বিভিন্ন ডেটা ( topWindowHostname , interestGroupOwner , renderUrl , adComponents , biddingDurationMsec , IGJoinCount , IGRecency , modelingSignals )।	ব্রাউজার দ্বারা সেট.	ক্রেতা বিক্রেতা	বিড স্কোর তৈরি করুন বিজ্ঞাপন রিপোর্টউইন রিপোর্ট ফলাফল
বিক্রেতা সংকেত	বিজ্ঞাপন স্কোরিংয়ের জন্য বিক্রেতাকে দেওয়া সংকেত।	নিলাম কনফিগারেশনে প্রকাশকের সাইট থেকে বিক্রেতার দ্বারা সেট করা হয়েছে।	বিক্রেতা	স্কোর বিজ্ঞাপন রিপোর্ট উইন রিপোর্ট ফলাফল
বিশ্বস্ত স্কোরিং সিগন্যাল	বিজ্ঞাপন স্কোরিংয়ের জন্য বিক্রেতাকে রিয়েল-টাইম সংকেত দেওয়া হয়।	ইউআরএলটি নিলাম কনফিগারেশনে প্রকাশকের সাইট থেকে বিক্রেতার দ্বারা সেট করা হয়।	বিক্রেতা	স্কোর বিজ্ঞাপন প্রতিবেদনের ফলাফল
perBuyerSignals	নিলাম প্রাসঙ্গিক তথ্য নির্দিষ্ট ক্রেতাদের প্রদান. নিলাম শুরু হওয়ার আগে বিক্রেতা ক্রেতাদের জন্য মান পুনরুদ্ধার করতে পারেন। এই বিজ্ঞাপনের সুযোগ ক্রেতার জ্ঞান.	নিলাম কনফিগারেশনে প্রকাশকের সাইট থেকে বিক্রেতার দ্বারা সেট করা হয়েছে।	ক্রেতা	বিড স্কোর তৈরি করুন বিজ্ঞাপন রিপোর্টউইন রিপোর্ট ফলাফল
বিশ্বস্ত বিডিং সিগন্যাল	বিজ্ঞাপন বিডিংয়ের জন্য ক্রেতাদের রিয়েল-টাইম সংকেত প্রদান করা হয়।	ইউআরএলটি বিজ্ঞাপনদাতার সাইট থেকে ক্রেতা দ্বারা সেট করা হয় যখন আগ্রহ গ্রুপ সেট করা হয়।	ক্রেতা	বিড তৈরি করুন
userBiddingSignals	ক্রেতা দ্বারা প্রদত্ত ব্যবহারকারীর ডেটা।	বিজ্ঞাপনদাতা সাইট থেকে ক্রেতা দ্বারা সেট যখন স্বার্থ গ্রুপ সেট করা হয়.	ক্রেতা	বিড তৈরি করুন

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

অন্যান্য উপলব্ধ ডেটা

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

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

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

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

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

ইভেন্ট-স্তরের রিপোর্টিং

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

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

একটি সুরক্ষিত শ্রোতা নিলামের মধ্যে ইভেন্ট-স্তরের ডেটা রিপোর্ট করার জন্য উপলব্ধ একটি প্রক্রিয়া হল একটি নিলাম জয়ের জন্য 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() থেকে কল করা হয়, এবং যখন reportWin() থেকে কল করা হয় তখন ক্রেতার জন্য একটি উইন রিপোর্ট তৈরি করা হয়। sendReportTo() ফাংশনটি কমপক্ষে 2026 পর্যন্ত উপলব্ধ থাকবে ,

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

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

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

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

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

একটি সুরক্ষিত অডিয়েন্স 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ও অন্তত 2026 পর্যন্ত উইন রিপোর্টিংয়ের মতো একই কারণে উপলব্ধ থাকবে।

একটি গভীর ডুব জন্য, ব্যাখ্যাকারী দেখুন.

সীমাহীন নেটওয়ার্ক অ্যাক্সেস

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

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

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

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

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

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

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

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

আপনি প্রাইভেট অ্যাগ্রিগেশন ব্যবহার করে আপনার সার্ভারে ওয়ার্কলেটের মধ্যে উপলব্ধ সংকেতগুলিকে একত্রিত করতে পারেন। সংকেত একত্রিত করার জন্য, আপনি বায়ার বিডিং ওয়ার্কলেট, বিক্রেতা স্কোরিং ওয়ার্কলেট এবং ক্রেতা/বিক্রেতা রিপোর্টিং ওয়ার্কলেটে উপলব্ধ 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) এ কল করে রিপোর্ট জমা দিতে ট্রিগার করতে পারেন :

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

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

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

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

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

নিলাম ফলাফল রিপোর্টিং

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

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

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-এর জন্য উপলব্ধ গেটগুলির মধ্যে একটি হল প্রাইভেট অ্যাগ্রিগেশন। আপনি শুধুমাত্র একটি ওয়ার্কলেটের ভিতর থেকে শেয়ার্ড স্টোরেজের মানগুলি পড়তে পারেন এবং আপনি ওয়ার্কলেট থেকে প্রাইভেট অ্যাগ্রিগেশন ব্যবহার করে সেই মানগুলি রিপোর্ট করতে পারেন৷

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

একটি সুরক্ষিত শ্রোতা 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 সম্পর্কে কথোপকথনে পরীক্ষা করতে এবং অংশগ্রহণ করতে পারেন৷