অ্যাট্রিবিউশন রিপোর্টিং ডিবাগ রিপোর্টের ভূমিকা

ডিবাগিং অ্যাট্রিবিউশন রিপোর্টিং সম্পর্কে ৩টির মধ্যে ১ম অংশ। ডিবাগিং কেন গুরুত্বপূর্ণ এবং পরীক্ষায় ডিবাগ রিপোর্ট কখন ব্যবহার করতে হবে তা জানুন।

আপনার ডিবাগ রিপোর্ট কেন দরকার

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

এই কাজগুলি সম্পন্ন করার জন্য ডিবাগ রিপোর্ট প্রয়োজন। অতএব, আমরা আপনাকে এগুলি সেট আপ করার জন্য দৃঢ়ভাবে সুপারিশ করছি।

শব্দকোষ

ডিবাগ রিপোর্টের মূল দিকগুলি

দুই ধরণের ডিবাগ রিপোর্ট

দুই ধরণের ডিবাগ রিপোর্ট পাওয়া যায়। উভয়ই ব্যবহার করুন, কারণ তারা বিভিন্ন ব্যবহারের ক্ষেত্রে কাজ করে।

সফল ডিবাগ রিপোর্ট

সাফল্যের ডিবাগ রিপোর্টগুলি একটি অ্যাট্রিবিউশন রিপোর্টের সফল জেনারেশন ট্র্যাক করে। এগুলি সরাসরি একটি অ্যাট্রিবিউশন রিপোর্টের সাথে সম্পর্কিত।

Chrome 101 (এপ্রিল 2022) থেকে সাফল্যের ডিবাগ রিপোর্ট পাওয়া যাচ্ছে।

ভার্বোস ডিবাগ রিপোর্ট

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

  • যেসব ক্ষেত্রে ব্রাউজার সফলভাবে একটি উৎস নিবন্ধন করেছে।
  • যেসব ক্ষেত্রে ব্রাউজার সফলভাবে কোনও উৎস নিবন্ধন করতে পারেনি বা ইভেন্ট ট্রিগার করতে পারেনি — যার অর্থ এটি কোনও অ্যাট্রিবিউশন রিপোর্ট তৈরি করবে না।
  • যেসব ক্ষেত্রে কোনও কারণে অ্যাট্রিবিউশন রিপোর্ট তৈরি বা পাঠানো যাচ্ছে না

ভার্বোস ডিবাগ রিপোর্টে একটি type ফিল্ড থাকে যা হয় একটি সফল উৎস নিবন্ধন, অথবা কেন একটি উৎস, ট্রিগার বা অ্যাট্রিবিউশন রিপোর্ট তৈরি করা হয়নি তার কারণ বর্ণনা করে।

Chrome 109 (জানুয়ারী 2023) থেকে ভার্বোস ডিবাগ রিপোর্ট পাওয়া যাচ্ছে— সোর্স রেজিস্ট্রেশন সাকসেস ভার্বোস ডিবাগ রিপোর্ট ছাড়া যা পরে Chrome 112-এ যোগ করা হয়েছে।

পার্ট ২-এ উদাহরণ রিপোর্টগুলি পর্যালোচনা করুন: ডিবাগ রিপোর্ট সেট আপ করুন

ডিবাগ রিপোর্ট ব্যবহার করার জন্য, রিপোর্টিং অরিজিনকে একটি কুকি সেট করতে হবে।

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

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

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

সফল ডিবাগ রিপোর্ট তৈরি করা হয় এবং সংশ্লিষ্ট অ্যাট্রিবিউশন রিপোর্ট তৈরি হওয়ার সাথে সাথে পাঠানো হয়: অর্থাৎ, ট্রিগার রেজিস্ট্রেশনে।

সোর্স বা ট্রিগার রেজিস্ট্রেশনের সাথে সাথেই ভার্বোস ডিবাগ রিপোর্ট পাঠানো হয়।

ডিবাগ রিপোর্টের বিভিন্ন এন্ডপয়েন্ট পাথ রয়েছে

অ্যাট্রিবিউশন রিপোর্টের মতো, সমস্ত ডিবাগ রিপোর্ট রিপোর্টিং অরিজিনে পাঠানো হয়। ডিবাগ রিপোর্ট রিপোর্টিং অরিজিনের তিনটি পৃথক এন্ডপয়েন্টে পাঠানো হয়:

  • সাফল্যের ডিবাগ রিপোর্টের শেষ বিন্দু, ইভেন্ট-স্তর
  • সাফল্যের ডিবাগ রিপোর্টের জন্য এন্ডপয়েন্ট, একত্রিতযোগ্য
  • ভার্বোজ ডিবাগ রিপোর্ট, ইভেন্ট-লেভেল এবং এগ্রিগেটেবলের জন্য এন্ডপয়েন্ট।

আরও জানুন পার্ট ২: ডিবাগ রিপোর্ট সেট আপ করুন

ব্যবহারের ক্ষেত্রে

মৌলিক রিয়েল-টাইম ইন্টিগ্রেশন চেক

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

এটি কীভাবে করবেন তা শিখুন পার্ট 3: রান্নার বই ডিবাগিং থেকে

ক্ষতি বিশ্লেষণ

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

একটি উদাহরণ: ইভেন্ট-স্তরের প্রতিবেদনের জন্য, আপনি প্রতি ইম্প্রেশনে সর্বাধিক একটি রূপান্তর নিবন্ধন করতে পারেন। এর অর্থ হল একটি নির্দিষ্ট বিজ্ঞাপন ইম্প্রেশনের জন্য, ব্যবহারকারী যতবারই রূপান্তর করুক না কেন, আপনি কেবল একটি অ্যাট্রিবিউশন প্রতিবেদন পাবেন।

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

পার্ট ৩: ডিবাগিং কুকবুক থেকে ক্ষতি বিশ্লেষণ কীভাবে চালাতে হয় তা শিখুন।

সমস্যা সমাধান

গোপনীয়তা বা রিসোর্স সুরক্ষার কারণে ক্ষতি হওয়ার সম্ভাবনা থাকলেও, অন্যান্য ক্ষতি অনিচ্ছাকৃত হতে পারে। আপনার বাস্তবায়নে ভুল কনফিগারেশন বা ব্রাউজারেই বাগের কারণে রিপোর্ট হারিয়ে যেতে পারে।

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

উন্নত কনফিগারেশন পরীক্ষা

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

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

সমষ্টিগত প্রতিবেদন সহ স্থানীয় পরীক্ষা

এনক্রিপ্ট করা অ্যাগ্রিগেটেবল অ্যাট্রিবিউশন রিপোর্টের বিপরীতে, অ্যাগ্রিগেটেবল ডিবাগ রিপোর্টে এনক্রিপ্ট না করা পেলোড অন্তর্ভুক্ত থাকে।

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

পুনঃপ্রক্রিয়াকরণ সমষ্টি পরিষেবা প্রতিবেদনগুলি

ডিবাগ মোড ব্যবহারের আরেকটি সুবিধা হল এটি আপনাকে পুনরায় রিপোর্ট প্রক্রিয়া করতে দেয়। অতএব, একাধিকবার রিপোর্ট প্রক্রিয়া করার জন্য, ডিবাগ রিপোর্ট সক্ষম করা নিশ্চিত করুন। আপনি যখন:

  • একত্রীকরণ পরিষেবা ডিবাগ করার চেষ্টা করা হচ্ছে।
  • বিভিন্ন ব্যাচিং কৌশল নিয়ে পরীক্ষা-নিরীক্ষা করা।
  • বিভিন্ন এপসিলন মান নিয়ে পরীক্ষা-নিরীক্ষা করা।

তথ্য পুনরুদ্ধার

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

পরবর্তী

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