অ্যাট্রিবিউশন রিপোর্টিং দিয়ে শুরু করুন

এই নির্দেশিকাটি অ্যাট্রিবিউশন রিপোর্টিং API ব্যবহার করে ইভেন্ট-স্তরের এবং সারাংশ অ্যাট্রিবিউশন রিপোর্ট উভয়ের জন্য একটি ওভারভিউ এবং সেটআপ নির্দেশাবলী প্রদান করে।

শুরু করার জন্য, আপনি শিখবেন:

  • অ্যাট্রিবিউশন রিপোর্টিং API রিপোর্টের ধরণগুলির মধ্যে পার্থক্য করুন

  • API বাস্তবায়ন এবং প্রতিবেদন তৈরির ধাপগুলি সম্পূর্ণ করুন

  • রেফারেন্স এবং সমস্যা সমাধানের তথ্য খুঁজুন

একটি রিপোর্টের ধরণ বেছে নিন

বিভিন্ন স্তরের বিশদ বিবরণ এবং গোপনীয়তার মাধ্যমে বিজ্ঞাপন প্রচারণার কর্মক্ষমতা কার্যকরভাবে পরিমাপ করার জন্য, অ্যাট্রিবিউশন রিপোর্টিং API দুটি স্বতন্ত্র ধরণের রিপোর্ট প্রদান করে:

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

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

বাস্তবায়নের সারসংক্ষেপ

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

পূর্বশর্ত: উৎস, ট্রিগার নিবন্ধন এবং প্রতিবেদন গ্রহণ করার আগে আপনার সাইটগুলিতে SSL/TLS সার্টিফিকেট (HTTPS) থাকতে হবে।

ইভেন্ট-স্তরের প্রতিবেদন তৈরি

নিম্নলিখিত ধাপগুলি ইভেন্ট-স্তরের প্রতিবেদন তৈরি করার পদ্ধতি বর্ণনা করে:

  1. উৎস নিবন্ধন করুন: একটি বিজ্ঞাপন ক্লিক বা ভিউ অ্যাট্রিবিউশন তথ্যের সাথে যুক্ত করে। বিস্তারিত নির্দেশাবলীর জন্য নিবন্ধন অ্যাট্রিবিউশন সোর্স এবং অ্যাট্রিবিউশন সোর্স নিবন্ধন দেখুন। মনে রাখবেন যে ক্লিক এবং ভিউয়ের জন্য নিবন্ধন প্রক্রিয়াটি সামান্য আলাদা।

  2. একটি ট্রিগার নিবন্ধন করুন: একটি রূপান্তর ইভেন্ট রেকর্ড করে এবং এটিকে পূর্বে নিবন্ধিত উৎসের সাথে লিঙ্ক করে। নির্দেশাবলীর জন্য নিবন্ধন অ্যাট্রিবিউশন ট্রিগার দেখুন।

  3. একটি রিপোর্টিং এন্ডপয়েন্ট সেট আপ করুন: ইভেন্ট-লেভেল রিপোর্ট পেতে আপনার সার্ভারে একটি এন্ডপয়েন্ট তৈরি করুন। এন্ডপয়েন্ট URL এই ফর্ম্যাট অনুসরণ করা উচিত: {REPORTING_ENDPOINT}/.well-known/attribution-reporting/report-event-attribution । POST পদ্ধতির উদাহরণের জন্য adtech.js এ উদাহরণ কোডটি দেখুন। .well-known সম্পর্কে আরও তথ্যের জন্য, Wikipedia দেখুন।

ইভেন্ট-স্তরের প্রতিবেদনগুলি আরও গভীরভাবে জানতে, ইভেন্ট-স্তরের প্রতিবেদন ব্যাখ্যাকারী দেখুন।

সারাংশ প্রতিবেদন তৈরি

  1. উৎস নিবন্ধন করুন: ইভেন্ট-স্তরের প্রতিবেদনের মতোই। বিস্তারিত জানার জন্য নিবন্ধন অ্যাট্রিবিউশন উৎস এবং অ্যাট্রিবিউশন উৎস নিবন্ধন দেখুন।

  2. ট্রিগার নিবন্ধন করুন: ইভেন্ট-স্তরের প্রতিবেদনের মতোই। নিবন্ধন অ্যাট্রিবিউশন ট্রিগার দেখুন।

  3. একটি রিপোর্টিং এন্ডপয়েন্ট সেট আপ করুন: সমষ্টিগত রিপোর্ট পাওয়ার জন্য একটি এন্ডপয়েন্ট তৈরি করুন। URLটি হওয়া উচিত: {REPORTING_ENDPOINT}/.well-known/attribution-reporting/report-aggregate-attribution । POST পদ্ধতির উদাহরণের জন্য adtech.js এবং .well-known তথ্যের জন্য Wikipedia দেখুন।

  4. ব্যাচ করে রিপোর্ট পাঠান: সমষ্টিগত রিপোর্টগুলিকে ব্যাচ করে প্রক্রিয়াকরণের জন্য অ্যাগ্রিগেশন সার্ভিসে পাঠান। এরপর অ্যাগ্রিগেশন সার্ভিস সারসংক্ষেপ রিপোর্ট তৈরি করবে। আরও তথ্যের জন্য ব্যাচিংয়ের কৌশলগুলি দেখুন।

সারাংশ প্রতিবেদনের আরও গভীরে যাওয়ার জন্য, Aggregatable রিপোর্ট ব্যাখ্যাকারী দেখুন।

বাস্তবায়নের ধাপগুলি ছাড়াও, নিম্নলিখিত বিষয়গুলি আপনার সারাংশ প্রতিবেদন কৌশল পরিকল্পনা করতে সাহায্য করবে:

ফিল্টার সেট আপ করুন (ঐচ্ছিক)

আপনার প্রাপ্ত অ্যাট্রিবিউশন ডেটার উপর আরও সুনির্দিষ্ট নিয়ন্ত্রণ পেতে, আপনি ফিল্টার সেট আপ করতে পারেন।

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

ফিল্টারিং সেট আপ করতে, একত্রিত প্রতিবেদনের নির্দিষ্ট বিবরণের জন্য ফিল্টার ব্যবহার করে কাস্টম নিয়ম নির্ধারণ করুন এবং অ্যাট্রিবিউশন ট্রিগার রেজিস্ট্রেশনের ট্রিগার বিভাগটি দেখুন।

API সক্রিয় আছে কিনা তা নিশ্চিত করুন

API ব্যবহার করার আগে, নিম্নলিখিত কোড ব্যবহার করে এটি সক্রিয় কিনা তা পরীক্ষা করুন:

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

এই চেকটি বর্তমান প্রেক্ষাপটে API অনুমোদিত কিনা তা নির্দেশ করে। তবে, ব্যবহারকারীর ব্রাউজার সেটিংস বা অন্যান্য কারণগুলি এখনও API ব্যবহার করা থেকে বিরত থাকতে পারে। গোপনীয়তার বিবেচনার কারণে, API ব্যবহারযোগ্যতা নিশ্চিত করার কোনও প্রোগ্রাম্যাটিক উপায় নেই।

পরবর্তী পদক্ষেপ

নিম্নলিখিত বিভাগগুলিতে অ্যাট্রিবিউশন রিপোর্টিং শুরু করার বিষয়ে আরও তথ্য প্রদান করা হয়েছে।

বাস্তবায়ন

পটভূমি এবং ধারণা

ডেমো এবং টুল

পরিকল্পনা