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

ডিবাগিং অ্যাট্রিবিউশন রিপোর্টিং-এ 3-এর পার্ট 2। আপনার ডিবাগ রিপোর্ট সেট আপ করুন.

শব্দকোষ

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

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

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

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

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

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

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

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

আপনি API একীকরণের জন্য সর্বোত্তম অনুশীলন প্রয়োগ করেছেন কিনা তা পরীক্ষা করুন

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

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

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

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

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

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

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

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

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

ডিবাগিং রিপোর্ট প্রাপ্তির জন্য নির্বাচন করতে, অ্যাট্রিবিউশন-রিপোর্টিং-তথ্য প্রতিক্রিয়া শিরোনামের অংশ হিসাবে report-header-errors সাথে সাড়া দিন।

Attribution-Reporting-Info: report-header-errors

মনে রাখবেন যে অ্যাট্রিবিউশন-রিপোর্টিং-ইনফো হল একটি অভিধানের কাঠামোগত শিরোনাম 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
  }
}]

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

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

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

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

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

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

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

ধাপ 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"
}

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

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

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

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

ডিবাগ রিপোর্ট সংগ্রহ করতে একটি শেষ পয়েন্ট সেট আপ করুন। এই এন্ডপয়েন্টটি প্রধান অ্যাট্রিবিউশন এন্ডপয়েন্টের মত হওয়া উচিত, পাথে একটি অতিরিক্ত 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);
  }
);

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

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

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

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

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

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

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

{
  "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"
}

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

ধাপ 3: উৎস এবং ট্রিগার শিরোনাম মধ্যে ভার্বোজ ডিবাগিং নির্বাচন করুন

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
}

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

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

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

ডিবাগ রিপোর্ট সংগ্রহ করতে একটি শেষ পয়েন্ট সেট আপ করুন। এই এন্ডপয়েন্টটি প্রধান অ্যাট্রিবিউশন এন্ডপয়েন্টের মতো হওয়া উচিত, পাথে একটি অতিরিক্ত 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);
  }
);

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

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

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

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

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

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

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

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

[
  {
    "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 )

পরবর্তী আপ

পার্ট 3: ডিবাগিং কুকবুক