সুরক্ষিত দর্শকদের জন্য ডিবাগ রিপোর্টিং

সুরক্ষিত দর্শক ডিবাগ রিপোর্টিং বিজ্ঞাপন প্রযুক্তি ডেভেলপারদের নিলামে জেতা বা হেরে গেলে ডিভাইস থেকে GET অনুরোধ গ্রহণের জন্য দূরবর্তী URL ঘোষণা করতে দেয়। এটি নিম্নলিখিত ব্যবহারের ক্ষেত্রে সক্ষম করে:

  • নিলামের ফলাফলের জয় এবং পরাজয়ের প্রতিবেদন গ্রহণ করুন।
  • নিলাম কেন হেরে যায় তা বুঝুন। উদাহরণস্বরূপ: বুঝুন এটি কি বিডিং বা স্কোরিং স্ক্রিপ্ট বাস্তবায়নের সমস্যা নাকি মূল যুক্তির সমস্যা।
  • জাভাস্ক্রিপ্ট লজিক আপডেট করা হলে সমস্যাগুলি আবিষ্কার করুন

প্রাইভেসি স্যান্ডবক্স ডেভেলপার প্রিভিউ ৯-এ পরীক্ষার জন্য ইভেন্ট-স্তরের ডিবাগ রিপোর্টিং উপলব্ধ। AdId উপলব্ধ সমস্ত ডিভাইসে ডিবাগ রিপোর্টিং সমর্থিত।

দীর্ঘমেয়াদী পরিকল্পনা হল প্ল্যাটফর্মটিকে প্রাইভেট অ্যাগ্রিগেশন পরিষেবার মাধ্যমে নিলামের ফলাফল রিপোর্ট করতে সক্ষম করা। এটি নিশ্চিত করে যে ঘটনা-পরবর্তী প্রতিবেদন প্রকাশকের অ্যাপে পৃথক ব্যবহারকারীদের কাস্টম দর্শকদের সাথে যোগদানের জন্য ব্যবহার করা যাবে না। ইভেন্ট-স্তরের প্রতিবেদন অস্থায়ী, যতক্ষণ না একটি পর্যাপ্ত প্রতিবেদন কাঠামো প্রকাশিত হয়।

[Chrome-এর মূল FLEDGE অরিজিন ট্রায়াল প্রস্তাবনায় ডিবাগ রিপোর্টিং] সম্পর্কে আরও জানুন][10]।

ব্যবহার

ডিবাগ রিপোর্টিং নিম্নলিখিত জাভাস্ক্রিপ্ট এপিআই ব্যবহার করে বাস্তবায়িত হয়, যার উভয়ই একটি URL স্ট্রিং আর্গুমেন্ট গ্রহণ করে:

  • forDebuggingOnly.reportAdAuctionWin(String url)
  • forDebuggingOnly.reportAdAuctionLoss(String url)

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

let someDebuggableVariable = 123;
const url = "https://example.com/reportLoss?winningBid=${winningBid}&someDebuggableVariable=" + someDebuggableVariable;
forDebuggingOnly.reportAdAuctionLoss(url);

নিলাম সম্পন্ন হওয়ার পর ${winningBid} টেমপ্লেটটি আসল মূল্য দিয়ে প্রতিস্থাপিত হয়।

বিক্রেতারা ঐচ্ছিকভাবে তাদের scoreAds ফাংশন থেকে একটি rejectReason ফেরত দিতে পারেন:

function scoreAd(ad, bid, auction_config, seller_signals,
                 trusted_scoring_signals, contextual_signal,
                 custom_audience_signal) {
  let score = ...
  return {
    'status': 0,
    'score': score,
    'rejectReason': 'blocked-by-publisher'
  }
}

যদি কোনও বিক্রেতা প্রত্যাখ্যানের কারণ নির্ধারণ না করেন, তাহলে not-available পাঠানো হবে।

URL ভেরিয়েবল

ডিবাগ URL-এ যে ভেরিয়েবলগুলি যোগ করা যেতে পারে সেগুলি Chrome-এ তাদের প্রতিরূপগুলির সাথে মিলে যায় (যদিও ${topLevelWinningBid} এবং ${topLevelMadeWinningBid} অনুপলব্ধ কারণ অ্যান্ড্রয়েডে উপাদান নিলামের কোনও ধারণা নেই)।

চলকের নাম বিবরণ
winningBid বিজয়ী দরের মূল্য।
madeWinningBid একটি বুলিয়ান মান যা প্রতিনিধিত্ব করে যে এই কাস্টম অডিয়েন্সের ক্রেতা বিজয়ী বিড করেছেন কিনা, হয় এই কাস্টম অডিয়েন্সের মাধ্যমে, নাকি একই ক্রেতার সাথে অন্য কোনও কাস্টম অডিয়েন্সের মাধ্যমে।
highestScoringOtherBid বিক্রেতার scoreAd স্ক্রিপ্ট অনুসারে বিডের মূল্য যা দ্বিতীয় সর্বোচ্চ হিসাবে স্কোর করা হয়েছে। মনে রাখবেন যে এটি দ্বিতীয় সর্বোচ্চ বিড মূল্য নাও হতে পারে, কারণ স্কোর এবং বিড স্বাধীন হতে পারে।
madeHighestScoringOtherBid একটি বুলিয়ান মান যা প্রতিনিধিত্ব করে যে এই কাস্টম অডিয়েন্সের ক্রেতা ${highestScoringOtherBid} বিড করেছেন কিনা, হয় এই কাস্টম অডিয়েন্সের দ্বারা, নাকি একই ক্রেতার সাথে অন্য কোনও কাস্টম অডিয়েন্স করেছেন।
rejectReason বিক্রেতা কেন বিড প্রত্যাখ্যান করেছেন তা ব্যাখ্যা করে ঐচ্ছিকভাবে সেট করা একটি স্ট্রিং। নিম্নলিখিত মানগুলির যেকোনো একটি হতে পারে:

  • not-available
  • invalid-bid
  • bid-below-auction-floor
  • pending-approval-by-exchange
  • disapproved-by-exchange
  • blocked-by-publisher
  • language-exclusions
  • category-exclusions

সীমাবদ্ধতা

  • URL হোস্ট অবশ্যই আপনার নথিভুক্ত প্রাইভেসি স্যান্ডবক্স ডোমেনের সাথে মিলবে।
  • URL ডোমেন, https:// প্রিফিক্স এবং প্রতিস্থাপিত নিলাম ডেটা সহ 4096 অক্ষরের বেশি হওয়া উচিত নয়।
  • ভবিষ্যতের রিলিজগুলিতে, ডিবাগ পিংগুলি কেবল Wi-Fi এর সাথে সংযুক্ত থাকলেই পাঠানো হবে।

ডিভাইসে আচরণ

মোবাইল পরিবেশে, মেমরি এবং নেটওয়ার্ক ব্যবহার রক্ষা করা একটি মূল অগ্রাধিকার। তাই, ডিবাগ রিপোর্টগুলি ব্যাচে করা হয়।

নিম্নলিখিত সিস্টেম বৈশিষ্ট্যগুলি ব্যাচ রেট এবং আকার নিয়ন্ত্রণ করে, যা উন্নয়নের জন্য নিম্ন মানের সাথে সামঞ্জস্য করা যেতে পারে:

  • fledge_event_level_debug_reporting_batching_rate
  • fledge_event_level_debug_reporting_batch_size

নিলাম সম্পন্ন হওয়ার পর ডিবাগ রিপোর্টের প্রত্যাশিত বিলম্ব ১৫-৬০ মিনিটের মধ্যে।

ডিবাগ রিপোর্টের সম্পূর্ণতার কোনও শক্ত গ্যারান্টি নেই। যদি ডিভাইসটি রিবুট হয় বা সার্ভারে কল পাঠানোর আগে বিজ্ঞাপন পরিষেবা প্রক্রিয়া ক্র্যাশ করে, তাহলে এই ইভেন্টগুলি বাদ দেওয়া হয়।

প্রতিটি বিজ্ঞাপন প্রযুক্তিবিদদের নিলামে সর্বোচ্চ ৭৫টি নিবন্ধিত ডিবাগ URL সীমা থাকে। এই সীমা অতিক্রম করার পরে নিবন্ধিত URL গুলি নীরবে বাদ দেওয়া হয়।

অবশেষে, যদি ব্যবহারকারী AdId অক্ষম করে থাকেন, তাহলে ডিবাগ রিপোর্ট পাঠানো হয়। এটি ডেভেলপার প্রিভিউ 9-এ বাস্তবায়িত হয়নি, তবে ভবিষ্যতের সংস্করণগুলিতে বাস্তবায়িত হবে।

বিজ্ঞাপন প্রযুক্তি সার্ভারের আচরণ

ডিবাগ রিপোর্টিংয়ের জন্য অ্যাড টেক সার্ভারগুলির নিম্নলিখিত আচরণ থাকা উচিত:

  • ডিভাইসটি আপনার দ্বারা forDebuggingOnly.* API-এর মাধ্যমে নির্দিষ্ট করা সার্ভারে GET অনুরোধ পাঠায়।
  • প্রতিটি অনুরোধ একটি একক ইভেন্ট-স্তরের ডিবাগ রিপোর্ট উপস্থাপন করে: একটি বিজ্ঞাপন নিলামে জয় বা নিলামে ক্ষতি।
  • প্রতিটি অনুরোধের কোনও বডি নেই। সমস্ত ডেটা কোয়েরি প্যারামিটারে রয়েছে।
  • বৃহৎ রেসপন্স পেলোড কর্মক্ষমতা এবং ডেটা ব্যবহারকে নেতিবাচকভাবে প্রভাবিত করতে পারে এবং এগুলি উপেক্ষা করা হয়।