এই নির্দেশিকাটি অ্যাট্রিবিউশন রিপোর্টিং API ব্যবহার করে ইভেন্ট-স্তর এবং সারাংশ অ্যাট্রিবিউশন রিপোর্ট উভয়ের জন্য একটি ওভারভিউ এবং সেটআপ নির্দেশাবলী প্রদান করে।
শুরু করতে, আপনি শিখবেন:
অ্যাট্রিবিউশন রিপোর্টিং API রিপোর্ট প্রকারের মধ্যে পার্থক্য করুন
সম্পূর্ণ API বাস্তবায়ন এবং প্রতিবেদন তৈরির পদক্ষেপ
রেফারেন্স এবং সমস্যা সমাধানের তথ্য খুঁজুন
একটি প্রতিবেদনের ধরন নির্বাচন করুন
বিশদ এবং গোপনীয়তার বিভিন্ন স্তরের সাথে বিজ্ঞাপন প্রচারাভিযানের কার্যকারিতা কার্যকরভাবে পরিমাপ করতে, অ্যাট্রিবিউশন রিপোর্টিং এপিআই দুটি স্বতন্ত্র প্রতিবেদন প্রকার সরবরাহ করে:
ইভেন্ট-স্তরের রিপোর্ট: সংশ্লিষ্ট রূপান্তর ডেটা ( ট্রিগার ) এর সাথে একটি নির্দিষ্ট বিজ্ঞাপন ক্লিক বা ভিউ ( উৎস ) লিঙ্ক করে দানাদার ডেটা প্রদান করুন। ইভেন্ট-স্তরের রিপোর্টগুলি রূপান্তর ডেটার পরিমাণকে সীমিত করে এবং রিপোর্টগুলিতে গোলমাল যোগ করে। এগুলি ব্যবহারের ক্ষেত্রে আদর্শ যেখানে স্বতন্ত্র ইভেন্ট অ্যাট্রিবিউশন গুরুত্বপূর্ণ, যেমন প্রচারের নাগাল পরিমাপ করা।
সারাংশ রিপোর্ট: সমষ্টিগত ব্যবহারকারীর ডেটা অফার করে এবং যোগ করা শব্দের সাথে আরও বিস্তারিত রূপান্তর তথ্য অন্তর্ভুক্ত করতে পারে। অ্যাট্রিবিউশন রিপোর্টিং এপিআই এবং প্রাইভেট অ্যাগ্রিগেশন এপিআই উভয়ই ব্যবহার করে, এগুলি সমষ্টিগত রিপোর্ট থেকে তৈরি করা হয় এবং ইভেন্ট-লেভেল রিপোর্টের তুলনায় একটি সমৃদ্ধ ডেটা মডেল অফার করে। সারসংক্ষেপ প্রতিবেদনগুলি বিশেষভাবে উপযোগী হয় এমন পরিস্থিতিতে যাতে সমষ্টিগত অন্তর্দৃষ্টি প্রয়োজন, যেমন রূপান্তর মান গণনা করা বা ব্যবহারকারীর অংশ জুড়ে প্রচারাভিযানের কার্যকারিতা বিশ্লেষণ করা।
বাস্তবায়ন ওভারভিউ
নিম্নলিখিত বিভাগগুলি প্রতিটি ধরণের রিপোর্ট তৈরি করার জন্য উচ্চ-স্তরের পদক্ষেপগুলির রূপরেখা দেয়৷ আপনি পুরো প্রক্রিয়ার ধাপে ধাপে ওয়াকথ্রু-এর জন্য অ্যাট্রিবিউশন রিপোর্টিং API ডেমো সহ অনুসরণ করতে পারেন।
পূর্বশর্ত: আপনার সাইটের অবশ্যই SSL/TLS সার্টিফিকেট (HTTPS) থাকতে হবে আপনি উত্স, ট্রিগার এবং প্রতিবেদনগুলি নিবন্ধন করতে পারেন৷
ইভেন্ট-স্তরের রিপোর্ট তৈরি
নিম্নলিখিত পদক্ষেপগুলি কীভাবে ইভেন্ট-স্তরের প্রতিবেদন তৈরি করতে হয় তা বর্ণনা করে:
একটি উত্স নিবন্ধন করুন: অ্যাট্রিবিউশন তথ্যের সাথে একটি বিজ্ঞাপন ক্লিক বা ভিউ যুক্ত করে৷ বিস্তারিত নির্দেশের জন্য নিবন্ধন অ্যাট্রিবিউশন উত্স এবং অ্যাট্রিবিউশন উত্স নিবন্ধন দেখুন৷ উল্লেখ্য যে রেজিস্ট্রেশন প্রক্রিয়া ক্লিক এবং দর্শনের জন্য সামান্য ভিন্ন।
একটি ট্রিগার নিবন্ধন করুন: একটি রূপান্তর ইভেন্ট রেকর্ড করে এবং এটি পূর্বে নিবন্ধিত উত্সের সাথে লিঙ্ক করে৷ নির্দেশাবলীর জন্য নিবন্ধন অ্যাট্রিবিউশন ট্রিগার পড়ুন।
একটি রিপোর্টিং এন্ডপয়েন্ট সেট আপ করুন: ইভেন্ট-লেভেল রিপোর্ট পেতে আপনার সার্ভারে একটি এন্ডপয়েন্ট তৈরি করুন। এন্ডপয়েন্ট URL এই ফর্ম্যাটটি অনুসরণ করবে:
{REPORTING_ENDPOINT}/.well-known/attribution-reporting/report-event-attributionPOSTপদ্ধতির উদাহরণের জন্যadtech.jsএ উদাহরণ কোডটি দেখুন।.well-knownসম্পর্কে আরও তথ্যের জন্য, উইকিপিডিয়া দেখুন।
ইভেন্ট-স্তরের রিপোর্টে গভীরভাবে ডুব দেওয়ার জন্য, ইভেন্ট-স্তরের রিপোর্ট ব্যাখ্যাকারী দেখুন।
সংক্ষিপ্ত প্রতিবেদন তৈরি
একটি উৎস নিবন্ধন করুন: ইভেন্ট-স্তরের প্রতিবেদনের মতোই। বিস্তারিত জানার জন্য রেজিস্টার অ্যাট্রিবিউশন সোর্স এবং অ্যাট্রিবিউশন সোর্স রেজিস্ট্রেশন দেখুন।
একটি ট্রিগার নিবন্ধন করুন: ইভেন্ট-স্তরের প্রতিবেদনের মতোই। রেজিস্টার অ্যাট্রিবিউশন ট্রিগার দেখুন।
একটি রিপোর্টিং এন্ডপয়েন্ট সেট আপ করুন: সামগ্রিক রিপোর্ট পেতে একটি এন্ডপয়েন্ট তৈরি করুন। URLটি হওয়া উচিত:
{REPORTING_ENDPOINT}/.well-known/attribution-reporting/report-aggregate-attribution। একটিPOSTপদ্ধতির উদাহরণের জন্যadtech.jsদেখুন এবং.well-knownতথ্যের জন্য উইকিপিডিয়া দেখুন ।ব্যাচ এবং রিপোর্ট পাঠান: সমষ্টিগত প্রতিবেদনগুলি ব্যাচ করুন এবং প্রক্রিয়াকরণের জন্য এগ্রিগেশন সার্ভিসে পাঠান। অ্যাগ্রিগেশন সার্ভিস তারপর সারাংশ রিপোর্ট তৈরি করবে। আরও তথ্যের জন্য ব্যাচিংয়ের জন্য কৌশলগুলি দেখুন।
সারাংশ রিপোর্টের গভীরে ডুব দেওয়ার জন্য, সমষ্টিগত প্রতিবেদন ব্যাখ্যাকারী পড়ুন।
বাস্তবায়নের পদক্ষেপগুলি ছাড়াও, নিম্নলিখিত বিষয়গুলি আপনাকে আপনার সারাংশ রিপোর্টিং কৌশল পরিকল্পনা করতে সাহায্য করবে:
ফিল্টার সেট আপ করুন (ঐচ্ছিক)
আপনি প্রাপ্ত অ্যাট্রিবিউশন ডেটার উপর আরও দানাদার নিয়ন্ত্রণ পেতে, আপনি ফিল্টার সেট আপ করতে পারেন।
ফিল্টারিং পরিমার্জিত ডেটা বিশ্লেষণ প্রদান করে যা আপনার বিশ্লেষণের জন্য ডেটার নির্দিষ্ট উপসেটগুলিকে বিচ্ছিন্ন করে, শব্দ কমায়। এটি আরও সুনির্দিষ্ট পরিমাপের জন্য নির্দিষ্ট বিজ্ঞাপন প্রচারাভিযান এবং রূপান্তর ইভেন্টগুলির কর্মক্ষমতা ট্র্যাক করতে সহায়তা করে৷
ফিল্টারিং সেট আপ করতে ফিল্টার ব্যবহার করে কাস্টম নিয়মগুলি সংজ্ঞায়িত করুন এবং অ্যাট্রিবিউশন ট্রিগার রেজিস্ট্রেশনের ট্রিগার বিভাগটি সমষ্টিগত প্রতিবেদনের জন্য নির্দিষ্ট বিবরণের জন্য দেখুন।
নিশ্চিত করুন যে API সক্ষম হয়েছে
API ব্যবহার করার আগে, নিম্নলিখিত কোড ব্যবহার করে এটি সক্রিয় কিনা তা পরীক্ষা করুন:
if (document.featurePolicy.allowsFeature('attribution-reporting')) {
// the Attribution Reporting API is enabled
}
বর্তমান প্রেক্ষাপটে এপিআই অনুমোদিত কিনা এই চেকটি নির্দেশ করে। যাইহোক, ব্যবহারকারী ব্রাউজার সেটিংস বা অন্যান্য কারণগুলি এখনও API ব্যবহার করা থেকে বাধা দিতে পারে। গোপনীয়তা বিবেচনার কারণে, API ব্যবহারযোগ্যতা নিশ্চিতভাবে নিশ্চিত করার কোনো প্রোগ্রামেটিক উপায় নেই।
পরবর্তী পদক্ষেপ
নিম্নলিখিত বিভাগগুলি অ্যাট্রিবিউশন রিপোর্টিং শুরু করার বিষয়ে আরও তথ্য প্রদান করে৷