অ্যাট্রিবিউশন রিপোর্টিংয়ের জন্য ডিবাগ রিপোর্ট সেট আপ করুন, অ্যাট্রিবিউশন রিপোর্টিংয়ের জন্য ডিবাগ রিপোর্ট সেট আপ করুন

ডিবাগিং অ্যাট্রিবিউশন রিপোর্টিং সম্পর্কিত ৩টির মধ্যে ২য় অংশ। আপনার ডিবাগ রিপোর্ট সেট আপ করুন।

শব্দকোষ

• রিপোর্টিং অরিজিন হল সেই অরিজিন যা অ্যাট্রিবিউশন রিপোর্টিং সোর্স এবং ট্রিগার হেডার সেট করে। ব্রাউজার দ্বারা উত্পন্ন সমস্ত প্রতিবেদন এই মূলে পাঠানো হয়। এই নির্দেশিকাতে, আমরা https://adtech.example ব্যবহার করি উদাহরণ প্রতিবেদনের উৎস হিসেবে।
• একটি অ্যাট্রিবিউশন রিপোর্ট (সংক্ষেপে রিপোর্ট ) হল চূড়ান্ত রিপোর্ট (ইভেন্ট-স্তর বা সমষ্টিগত) যাতে আপনার অনুরোধ করা পরিমাপ ডেটা থাকে।
• একটি ডিবাগ রিপোর্টে একটি অ্যাট্রিবিউশন রিপোর্ট বা একটি উৎস বা ট্রিগার ইভেন্ট সম্পর্কে অতিরিক্ত ডেটা থাকে। একটি ডিবাগ রিপোর্ট প্রাপ্তির অর্থ এই নয় যে কিছু ভুলভাবে কাজ করছে! ডিবাগ রিপোর্ট দুই ধরনের আছে
• একটি ট্রানজিশনাল ডিবাগ রিপোর্ট হল একটি ডিবাগ রিপোর্ট যা তৈরি এবং পাঠানোর জন্য একটি কুকি সেট করা প্রয়োজন৷ ট্রানজিশনাল ডিবাগ রিপোর্ট অনুপলব্ধ হবে যদি একটি কুকি সেট না করা হয়, এবং একবার তৃতীয় পক্ষের কুকি অবচয় করা হয়। এই নির্দেশিকায় বর্ণিত সমস্ত ডিবাগ রিপোর্ট হল ট্রানজিশনাল ডিবাগ রিপোর্ট।
• সাফল্য ডিবাগ রিপোর্ট একটি অ্যাট্রিবিউশন রিপোর্টের সফল প্রজন্ম ট্র্যাক করে। তারা সরাসরি একটি অ্যাট্রিবিউশন রিপোর্টের সাথে সম্পর্কিত। সফল ডিবাগ রিপোর্ট Chrome 101 (এপ্রিল 2022) থেকে পাওয়া যাচ্ছে।
• ভার্বোস ডিবাগ রিপোর্টগুলি অনুপস্থিত রিপোর্টগুলিকে ট্র্যাক করতে পারে এবং কেন সেগুলি অনুপস্থিত তা নির্ধারণ করতে আপনাকে সাহায্য করতে পারে৷ তারা এমন ক্ষেত্রে নির্দেশ করে যেখানে ব্রাউজার কোনও উত্স বা ট্রিগার ইভেন্ট রেকর্ড করেনি, (যার মানে এটি কোনও অ্যাট্রিবিউশন রিপোর্ট তৈরি করবে না), এবং এমন ক্ষেত্রে যেখানে কোনও কারণের জন্য অ্যাট্রিবিউশন রিপোর্ট তৈরি বা পাঠানো যাবে না। ভার্বোস ডিবাগ রিপোর্টে একটি type ফিল্ড অন্তর্ভুক্ত থাকে যা উৎস ইভেন্ট, ট্রিগার ইভেন্ট বা অ্যাট্রিবিউশন রিপোর্ট তৈরি না হওয়ার কারণ বর্ণনা করে। ভার্বোস ডিবাগ রিপোর্টগুলি Chrome 109 ( জানুয়ারী 2023-এ স্থিতিশীল ) থেকে পাওয়া যায়।
• ডিবাগ কীগুলি হল অনন্য শনাক্তকারী যা আপনি সোর্স সাইড এবং ট্রিগার সাইড উভয় দিকে সেট করতে পারেন। ডিবাগ কী আপনাকে কুকি-ভিত্তিক রূপান্তর এবং অ্যাট্রিবিউশন-ভিত্তিক রূপান্তরগুলি ম্যাপ করতে সক্ষম করে৷ আপনি যখন ডিবাগ রিপোর্ট তৈরি করতে এবং ডিবাগ কী সেট করার জন্য আপনার সিস্টেম সেট আপ করেন, তখন ব্রাউজার সমস্ত অ্যাট্রিবিউশন রিপোর্ট এবং ডিবাগ রিপোর্টে এই ডিবাগ কীগুলিকে অন্তর্ভুক্ত করবে৷

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

• রিপোর্টিং অরিজিন হল সেই অরিজিন যা অ্যাট্রিবিউশন রিপোর্টিং সোর্স এবং ট্রিগার হেডার সেট করে। ব্রাউজার দ্বারা উত্পন্ন সমস্ত প্রতিবেদন এই মূলে পাঠানো হয়। এই নির্দেশিকাতে, আমরা https://adtech.example ব্যবহার করি উদাহরণ প্রতিবেদনের উৎস হিসেবে।
• একটি অ্যাট্রিবিউশন রিপোর্ট (সংক্ষেপে রিপোর্ট ) হল চূড়ান্ত রিপোর্ট (ইভেন্ট-স্তর বা সমষ্টিগত) যাতে আপনার অনুরোধ করা পরিমাপ ডেটা থাকে।
• একটি ডিবাগ রিপোর্টে একটি অ্যাট্রিবিউশন রিপোর্ট বা একটি উৎস বা ট্রিগার ইভেন্ট সম্পর্কে অতিরিক্ত ডেটা থাকে। একটি ডিবাগ রিপোর্ট প্রাপ্তির অর্থ এই নয় যে কিছু ভুলভাবে কাজ করছে! ডিবাগ রিপোর্ট দুই ধরনের আছে
• একটি ট্রানজিশনাল ডিবাগ রিপোর্ট হল একটি ডিবাগ রিপোর্ট যা তৈরি এবং পাঠানোর জন্য একটি কুকি সেট করা প্রয়োজন৷ ট্রানজিশনাল ডিবাগ রিপোর্ট অনুপলব্ধ হবে যদি একটি কুকি সেট না করা হয়, এবং একবার তৃতীয় পক্ষের কুকি অবচয় করা হয়। এই নির্দেশিকায় বর্ণিত সমস্ত ডিবাগ রিপোর্ট হল ট্রানজিশনাল ডিবাগ রিপোর্ট।
• সাফল্য ডিবাগ রিপোর্ট একটি অ্যাট্রিবিউশন রিপোর্টের সফল প্রজন্ম ট্র্যাক করে। তারা সরাসরি একটি অ্যাট্রিবিউশন রিপোর্টের সাথে সম্পর্কিত। সফল ডিবাগ রিপোর্ট Chrome 101 (এপ্রিল 2022) থেকে পাওয়া যাচ্ছে।
• ভার্বোস ডিবাগ রিপোর্টগুলি অনুপস্থিত রিপোর্টগুলিকে ট্র্যাক করতে পারে এবং কেন সেগুলি অনুপস্থিত তা নির্ধারণ করতে আপনাকে সাহায্য করতে পারে৷ তারা এমন ক্ষেত্রে নির্দেশ করে যেখানে ব্রাউজার কোনও উত্স বা ট্রিগার ইভেন্ট রেকর্ড করেনি, (যার মানে এটি কোনও অ্যাট্রিবিউশন রিপোর্ট তৈরি করবে না), এবং এমন ক্ষেত্রে যেখানে কোনও কারণের জন্য অ্যাট্রিবিউশন রিপোর্ট তৈরি বা পাঠানো যাবে না। ভার্বোস ডিবাগ রিপোর্টে একটি type ফিল্ড অন্তর্ভুক্ত থাকে যা উৎস ইভেন্ট, ট্রিগার ইভেন্ট বা অ্যাট্রিবিউশন রিপোর্ট তৈরি না হওয়ার কারণ বর্ণনা করে। ভার্বোস ডিবাগ রিপোর্টগুলি Chrome 109 ( জানুয়ারী 2023-এ স্থিতিশীল ) থেকে পাওয়া যায়।
• ডিবাগ কীগুলি হল অনন্য শনাক্তকারী যা আপনি সোর্স সাইড এবং ট্রিগার সাইড উভয় দিকে সেট করতে পারেন। ডিবাগ কী আপনাকে কুকি-ভিত্তিক রূপান্তর এবং অ্যাট্রিবিউশন-ভিত্তিক রূপান্তরগুলি ম্যাপ করতে সক্ষম করে৷ আপনি যখন ডিবাগ রিপোর্ট তৈরি করতে এবং ডিবাগ কী সেট করার জন্য আপনার সিস্টেম সেট আপ করেন, তখন ব্রাউজার সমস্ত অ্যাট্রিবিউশন রিপোর্ট এবং ডিবাগ রিপোর্টে এই ডিবাগ কীগুলিকে অন্তর্ভুক্ত করবে৷

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

বাস্তবায়ন প্রশ্ন?

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

ডিবাগ রিপোর্ট সেট আপ করার জন্য প্রস্তুত হন

ডিবাগ রিপোর্ট সেট আপ করার আগে, এই পদক্ষেপগুলি অনুসরণ করুন:

API ইন্টিগ্রেশনের জন্য আপনি সেরা অনুশীলনগুলি প্রয়োগ করেছেন কিনা তা পরীক্ষা করুন।

• আপনার কোডটি বৈশিষ্ট্য সনাক্তকরণের পিছনে গেটেড কিনা তা পরীক্ষা করুন। অনুমতি-নীতি দ্বারা API ব্লক করা হয়নি তা নিশ্চিত করতে, নিম্নলিখিত কোডটি চালান:

  if (document.featurePolicy.allowsFeature('attribution-reporting')) {
  // the Attribution Reporting API is enabled
  }
  

  যদি এই বৈশিষ্ট্য সনাক্তকরণ পরীক্ষাটি সত্য হয়, তাহলে APIটি সেই প্রসঙ্গে (পৃষ্ঠায়) অনুমোদিত যেখানে চেকটি চালানো হবে।

• (পরীক্ষার সময় প্রয়োজন নেই: আপনি একটি Permissions-Policy সেট করেছেন কিনা তা পরীক্ষা করুন)

মৌলিক ইন্টিগ্রেশন সমস্যাগুলি সমাধান করুন

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

DevTools সমস্যা বিভিন্ন ধরণের হতে পারে। যদি আপনি কোনও invalid header সমস্যার সম্মুখীন হন, তাহলে হেডারটি হেডার ভ্যালিডেটর টুলে কপি করুন। এটি আপনাকে সমস্যা সৃষ্টিকারী ক্ষেত্রটি সনাক্ত করতে এবং ঠিক করতে সাহায্য করবে।

অ্যাট্রিবিউশন রিপোর্টিং হেডার যাচাই করুন

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

ডিবাগিং রিপোর্ট গ্রহণ করার বিকল্প বেছে নিতে, Attribution-Reporting-Info রেসপন্স হেডারের অংশ হিসেবে report-header-errors দিয়ে উত্তর দিন।

Attribution-Reporting-Info: report-header-errors

মনে রাখবেন যে Attribution-Reporting-Info হল একটি অভিধান কাঠামোগত হেডার Attribution-Reporting-Info , তাই বুলিয়ান report-header-errors কী প্রদান করলে একটি সত্য মান বোঝা যায়।

ডিবাগিং রিপোর্টগুলি অবিলম্বে রিপোর্টিং এন্ডপয়েন্টে পাঠানো হয়:

https://<reporting origin>/.well-known/attribution-reporting/debug/verbose

এই ফর্মের অবজেক্টের JSON তালিকা হিসেবে অনুরোধের বডিতে রিপোর্ট ডেটা অন্তর্ভুক্ত করা হয়েছে:

[{
  "type": "header-parsing-error",
  "body": {
    "context_site": "https://source.example",
    "header": "Attribution-Reporting-Register-Source",
    "value": "!!!", // header value received in the response
    "error": "invalid JSON" // optional error details that may vary across browsers or different versions of the same browser
  }
}]

ডিবাগ রিপোর্ট সেট আপ করুন: সাফল্যের রিপোর্ট এবং ভার্বোজ রিপোর্টের সাধারণ ধাপগুলি

ধাপ ১: ডিবাগ কুকি সেট করুন

রিপোর্টিং অরিজিনে নিম্নলিখিত কুকি সেট করুন:

Set-Cookie: ar_debug=1; SameSite=None; Secure; Path=/; HttpOnly

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

ডেমো কোড: ডিবাগ কুকি

মনে রাখবেন যে মোড B-তে ব্রাউজারগুলির জন্য ডিবাগ রিপোর্ট সক্ষম করা যেতে পারে, যেখানে তৃতীয় পক্ষের কুকিগুলি তৃতীয় পক্ষের কুকি অবচয় পরীক্ষা এবং প্রস্তুতির সুবিধার্থে অক্ষম করা হয়। মোড B-তে ব্রাউজারগুলির জন্য, ডিবাগ রিপোর্ট সক্ষম করার জন্য আপনাকে ডিবাগ কুকি সেট করার প্রয়োজন নেই। সাফল্যের ডিবাগ রিপোর্টের জন্য ডিবাগ কী সেট আপ করতে ধাপ 2 এ যান।

ধাপ ২: ডিবাগ কী সেট করুন

প্রতিটি ডিবাগ কী অবশ্যই একটি 64-বিট স্বাক্ষরবিহীন পূর্ণসংখ্যা হতে হবে যা বেস-10 স্ট্রিং হিসাবে ফর্ম্যাট করা হবে। প্রতিটি ডিবাগ কীকে একটি অনন্য আইডি করুন। ডিবাগ কী সেট করা থাকলেই কেবল সাফল্যের ডিবাগ রিপোর্ট তৈরি করা হবে।

• সোর্স-সাইড ডিবাগ কীটি অতিরিক্ত সোর্স-টাইম তথ্যের সাথে ম্যাপ করুন যা আপনার মনে হয় ডিবাগ করার জন্য প্রাসঙ্গিক।
• ট্রিগার-সাইড ডিবাগ কীটি অতিরিক্ত ট্রিগার-টাইম তথ্যের সাথে ম্যাপ করুন যা আপনার মনে হয় ডিবাগ করার জন্য প্রাসঙ্গিক।

উদাহরণস্বরূপ, আপনি নিম্নলিখিত ডিবাগ কীগুলি সেট করতে পারেন:

• কুকি আইডি + সোর্স টাইমস্ট্যাম্পকে সোর্স ডিবাগ কী হিসেবে ব্যবহার করুন (এবং আপনার কুকি-ভিত্তিক সিস্টেমে একই টাইমস্ট্যাম্প ক্যাপচার করুন)
• কুকি আইডি + ট্রিগার ডিবাগ কী হিসেবে টাইমস্ট্যাম্প ট্রিগার করুন (এবং আপনার কুকি-ভিত্তিক সিস্টেমে একই টাইমস্ট্যাম্প ক্যাপচার করুন)

এর সাহায্যে, আপনি কুকি-ভিত্তিক রূপান্তর তথ্য ব্যবহার করে সংশ্লিষ্ট ডিবাগ রিপোর্ট বা অ্যাট্রিবিউশন রিপোর্টগুলি দেখতে পারেন। আরও জানুন পর্ব 3: কুকবুক এ।

সোর্স-সাইড ডিবাগ কীটিকে source_event_id থেকে আলাদা করুন, যাতে আপনি একই সোর্স ইভেন্ট আইডি সহ পৃথক প্রতিবেদনগুলিকে আলাদা করতে পারেন।

Attribution-Reporting-Register-Source:
{
// … Usual fields for Attribution-Reporting-Register-Source
"debug_key":"647775351539539"
}

Attribution-Reporting-Register-Trigger:
{
// … Usual fields for Attribution-Reporting-Register-Trigger
"debug_key":"938321351539743"
}

ডেমো কোড: সোর্স ডিবাগ কী ডেমো কোড: ট্রিগার ডিবাগ কী

সফল ডিবাগ রিপোর্ট সেট আপ করুন

এই বিভাগের উদাহরণ কোডটি ইভেন্ট-লেভেল এবং এগ্রিগেটেবল উভয় রিপোর্টের জন্যই সাফল্যের ডিবাগ রিপোর্ট তৈরি করে। ইভেন্ট-লেভেল এবং এগ্রিগেটেবল রিপোর্ট একই ডিবাগ কী ব্যবহার করে।

ধাপ ৩: সাফল্যের ডিবাগ রিপোর্ট সংগ্রহের জন্য একটি এন্ডপয়েন্ট সেট আপ করুন

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

• ইভেন্ট-স্তরের সাফল্যের ডিবাগ রিপোর্টের এন্ডপয়েন্ট: https://adtech.example/.well-known/attribution-reporting/debug/report-event-attribution
  • সমষ্টিগত সাফল্যের ডিবাগ রিপোর্টের জন্য এন্ডপয়েন্ট: https://adtech.example/.well-known/attribution-reporting/debug/report-aggregate-attribution

যখন কোনও অ্যাট্রিবিউশন ট্রিগার করা হয়, তখন ব্রাউজারটি তাৎক্ষণিকভাবে এই এন্ডপয়েন্টে একটি POST অনুরোধ ব্যবহার করে একটি ডিবাগ রিপোর্ট পাঠাবে। ইনকামিং সাকসেস ডিবাগ রিপোর্ট পরিচালনা করার জন্য আপনার সার্ভার কোডটি নিম্নরূপ দেখতে পারে (নোড এন্ডপয়েন্টে এখানে):

// Handle incoming event-Level Success Debug reports
adtech.post(
  '/.well-known/attribution-reporting/debug/report-event-attribution',
  async (req, res) => {
    // Debug report is in req.body
    res.sendStatus(200);
  }
);

// Handle incoming aggregatable Success Debug reports
adtech.post(
  '/.well-known/attribution-reporting/debug/report-aggregate-attribution',
  async (req, res) => {
    // Debug report is in req.body
    res.sendStatus(200);
  }
);

ডেমো কোড: ইভেন্ট-স্তরের ডিবাগ রিপোর্ট এন্ডপয়েন্ট

ডেমো কোড: সমষ্টিগত ডিবাগ রিপোর্ট এন্ডপয়েন্ট

ধাপ ৪: নিশ্চিত করুন যে আপনার সেটআপ সফল ডিবাগ রিপোর্ট তৈরি করবে

• আপনার ব্রাউজারে chrome://attribution-internals খুলুন।
• নিশ্চিত করুন যে ইভেন্ট-লেভেল রিপোর্ট এবং অ্যাগ্রিগেটেবল রিপোর্ট উভয় ট্যাবেই ডিবাগ রিপোর্ট দেখান চেকবক্সটি চেক করা আছে।
• যেসব সাইটে আপনি অ্যাট্রিবিউশন রিপোর্টিং বাস্তবায়ন করেছেন সেগুলি খুলুন। অ্যাট্রিবিউশন রিপোর্ট তৈরি করতে আপনি যে ধাপগুলি ব্যবহার করেন তা সম্পূর্ণ করুন; এই ধাপগুলিই সফল ডিবাগ রিপোর্ট তৈরি করবে।
• chrome://attribution-internals এ:
  • অ্যাট্রিবিউশন রিপোর্টগুলি সঠিকভাবে তৈরি করা হয়েছে কিনা তা পরীক্ষা করুন।
  • ইভেন্ট-লেভেল রিপোর্ট ট্যাব এবং অ্যাগ্রিগেটেবল রিপোর্ট ট্যাবে, সফল ডিবাগ রিপোর্টগুলিও তৈরি হয়েছে কিনা তা পরীক্ষা করুন। নীল debug পাথ দিয়ে তালিকায় তাদের চিনুন।

• আপনার সার্ভারে, যাচাই করুন যে আপনার এন্ডপয়েন্টটি অবিলম্বে এই সাফল্যের ডিবাগ রিপোর্টগুলি পেয়েছে। ইভেন্ট-স্তরের এবং সমষ্টিগত সাফল্যের ডিবাগ রিপোর্ট উভয়ই পরীক্ষা করে দেখুন।

ধাপ ৫: সাফল্যের ডিবাগ রিপোর্টগুলি পর্যবেক্ষণ করুন

একটি সফল ডিবাগ রিপোর্ট একটি অ্যাট্রিবিউশন রিপোর্টের অনুরূপ, এবং এতে সোর্স-সাইড এবং ট্রিগার-সাইড ডিবাগ কী উভয়ই থাকে।

{
  "attribution_destination": "https://advertiser.example",
  "randomized_trigger_rate": 0.0000025,
  "report_id": "7d76ef29-d59e-4954-9fff-d97a743b4715",
  "source_debug_key": "647775351539539",
  "source_event_id": "760938763735530",
  "source_type": "event",
  "trigger_data": "0",
  "trigger_debug_key": "156477391437535"
}

{
  "aggregation_service_payloads": [
    {
      "debug_cleartext_payload": "omRkYXRhgqJldmFsdWVEAACAAGZidWNrZXRQPPhnkD+7c+wm1RjAlowp3KJldmFsdWVEAAARMGZidWNrZXRQJFJl9DLxbnMm1RjAlowp3GlvcGVyYXRpb25paGlzdG9ncmFt",
      "key_id": "d5f32b96-abd5-4ee5-ae23-26490d834012",
      "payload": "0s9mYVIuznK4WRV/t7uHKquHPYCpAN9mZHsUGNiYd2G/9cg87Y0IjlmZkEtiJghMT7rmg3GtWVPWTJU5MvtScK3HK3qR2W8CVDmKRAhqqlz1kPZfdGUB4NsXGyVCy2UWapklE/r7pmRDDP48b4sQTyDMFExQGUTE56M/8WFVQ0qkc7UMoLI/uwh2KeIweQCEKTzw"
    }
  ],
  "shared_info": "{\"api\":\"attribution-reporting\",\"attribution_destination\":\"https://advertiser.example\",\"debug_mode\":\"enabled\",\"report_id\":\"4a04f0ff-91e7-4ef6-9fcc-07d000c20495\",\"reporting_origin\":\"https://adtech.example\",\"scheduled_report_time\":\"1669888617\",\"source_registration_time\":\"1669852800\",\"version\":\"0.1\"}",
  "source_debug_key": "647775351539539",
  "trigger_debug_key": "156477391437535"
}

ভার্বোস ডিবাগ রিপোর্ট সেট আপ করুন

ধাপ ৩: সোর্স এবং ট্রিগার হেডারে ভার্বোজ ডিবাগিং বেছে নিন

Attribution-Reporting-Register-Source এবং Attribution-Reporting-Register-Trigger উভয় ক্ষেত্রেই debug_reporting true তে সেট করুন।

Attribution-Reporting-Register-Source:
{
// … Usual fields for Attribution-Reporting-Register-Source
"debug_key":"938321351539743",
"debug_reporting": true // defaults to false if not present
}

Attribution-Reporting-Register-Trigger:
{
// … Usual fields for Attribution-Reporting-Register-Trigger
"debug_key":"938321351539743",
"debug_reporting": true // defaults to false if not present
}

ডেমো কোড: সোর্স হেডার

ডেমো কোড: ট্রিগার হেডার

ধাপ ৪: ভার্বোজ ডিবাগ রিপোর্ট সংগ্রহের জন্য একটি এন্ডপয়েন্ট সেট আপ করুন

ডিবাগ রিপোর্ট সংগ্রহ করার জন্য একটি এন্ডপয়েন্ট সেট আপ করুন। এই এন্ডপয়েন্টটি মূল অ্যাট্রিবিউশন এন্ডপয়েন্টের অনুরূপ হওয়া উচিত, পাথে একটি অতিরিক্ত debug/verbose স্ট্রিং থাকা উচিত:

https://adtech.example/.well-known/attribution-reporting/debug/verbose

যখন ভার্বোজ ডিবাগ রিপোর্ট তৈরি করা হয়, অর্থাৎ যখন কোনও সোর্স বা ট্রিগার নিবন্ধিত থাকে না, তখন ব্রাউজারটি তাৎক্ষণিকভাবে এই এন্ডপয়েন্টে একটি POST অনুরোধ ব্যবহার করে একটি ভার্বোজ ডিবাগ রিপোর্ট পাঠাবে। ইনকামিং ভার্বোজ ডিবাগ রিপোর্ট পরিচালনা করার জন্য আপনার সার্ভার কোডটি নিম্নরূপ দেখতে পারে (এখানে একটি নোড এন্ডপয়েন্টে):

// Handle incoming verbose debug reports
adtech.post(
  '/.well-known/attribution-reporting/debug/verbose',
  async (req, res) => {
    // List of verbose debug reports is in req.body
    res.sendStatus(200);
  }
);

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

ডেমো কোড: ভার্বোস ডিবাগ রিপোর্ট এন্ডপয়েন্ট

ধাপ ৫: নিশ্চিত করুন যে আপনার সেটআপ ভার্বোজ ডিবাগ রিপোর্ট তৈরি করবে

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

1. আপনার ব্রাউজারে chrome://attribution-internals খুলুন।
2. আপনার সাইটে অ্যাট্রিবিউশন রিপোর্টিং সহ সেট আপ করা একটি অ্যাট্রিবিউশন (রূপান্তর) ট্রিগার করুন। যেহেতু এই রূপান্তরের আগে কোনও বিজ্ঞাপনের ব্যস্ততা (ছাপ বা ক্লিক) ছিল না, তাই আপনার আশা করা উচিত যে trigger-no-matching-source ধরণের একটি ভার্বোস ডিবাগ রিপোর্ট তৈরি হবে।
3. chrome://attribution-internals এ, Verbose debug reports ট্যাবটি খুলুন এবং trigger-no-matching-source ধরণের একটি verbose debug report তৈরি হয়েছে কিনা তা পরীক্ষা করুন।
4. আপনার সার্ভারে, যাচাই করুন যে আপনার এন্ডপয়েন্টটি অবিলম্বে এই ভার্বোজ ডিবাগ রিপোর্টটি পেয়েছে।

ধাপ ৬: ভার্বোজ ডিবাগ রিপোর্টগুলি পর্যবেক্ষণ করুন

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

ব্রাউজার দ্বারা প্রেরিত ভার্বোজ ডিবাগ রিপোর্ট সম্বলিত একটি অনুরোধের উদাহরণ:

[
  {
    "body": {
      "attribution_destination": "http://arapi-advertiser.localhost",
      "randomized_trigger_rate": 0.0000025,
      "report_id": "92b7f4fd-b157-4925-999e-aad6361de759",
      "source_debug_key": "282273499788483",
      "source_event_id": "480041649210491",
      "source_type": "event",
      "trigger_data": "1",
      "trigger_debug_key": "282273499788483"
    },
    "type": "trigger-event-low-priority"
  },
  {
    "body": {
      "attribution_destination": "http://arapi-advertiser.localhost",
      "limit": "65536",
      "source_debug_key": "282273499788483",
      "source_event_id": "480041649210491",
      "source_site": "http://arapi-publisher.localhost",
      "trigger_debug_key": "282273499788483"
    },
    "type": "trigger-aggregate-insufficient-budget"
  }
]

প্রতিটি ভার্বোজ রিপোর্টে নিম্নলিখিত ক্ষেত্রগুলি থাকে:

Type

রিপোর্টটি তৈরির কারণ কী। সমস্ত ভার্বোস রিপোর্টের ধরণ সম্পর্কে জানতে এবং প্রতিটি ধরণের উপর নির্ভর করে কী পদক্ষেপ নিতে হবে, পার্ট 3: ডিবাগিং কুকবুক -এ ভার্বোস রিপোর্টের রেফারেন্সটি পর্যালোচনা করুন।

Body

রিপোর্টের মূল অংশ। এটি তার ধরণের উপর নির্ভর করবে। পার্ট 3: ডিবাগিং কুকবুক -এ ভার্বোজ রিপোর্ট রেফারেন্স পর্যালোচনা করুন।

একটি অনুরোধের মূল অংশে কমপক্ষে একটি এবং সর্বাধিক দুটি ভার্বোজ রিপোর্ট থাকবে:

• যদি ব্যর্থতা শুধুমাত্র ইভেন্ট-স্তরের প্রতিবেদনগুলিকে প্রভাবিত করে (অথবা যদি এটি শুধুমাত্র সমষ্টিগত প্রতিবেদনগুলিকে প্রভাবিত করে) তবে একটি ভার্বোজ প্রতিবেদন। একটি উৎস বা ট্রিগার নিবন্ধন ব্যর্থতার কেবল একটি কারণ থাকে; তাই প্রতি ব্যর্থতা এবং প্রতি প্রতিবেদনের ধরণ (ইভেন্ট-স্তরের বা সমষ্টিগত) অনুসারে একটি ভার্বোজ প্রতিবেদন তৈরি করা যেতে পারে।
• যদি ব্যর্থতা ইভেন্ট-লেভেল এবং সমষ্টিগত উভয় প্রতিবেদনকেই প্রভাবিত করে, তাহলে দুটি ভার্বোজ রিপোর্ট—একটি ব্যতিক্রম ছাড়া: যদি ইভেন্ট-লেভেল এবং সমষ্টিগত প্রতিবেদনের ক্ষেত্রে ব্যর্থতার কারণ একই হয়, তাহলে শুধুমাত্র একটি ভার্বোজ রিপোর্ট তৈরি করা হয় (উদাহরণস্বরূপ: trigger-no-matching-source )

পরবর্তী

পার্ট ৩: রান্নার বই ডিবাগ করা