অ্যাট্রিবিউশন স্কোপগুলি API কলারদের উত্সের সময় স্ট্রিংগুলির একটি তালিকা নির্দিষ্ট করতে দেয় এবং নিবন্ধকরণ ট্রিগার করে যা অ্যাট্রিবিউশন হওয়ার আগে ফিল্টারিংয়ের জন্য ব্যবহার করা যেতে পারে৷ এটি সূক্ষ্ম শস্য ফিল্টারিংকে API দক্ষতা বাড়াতে এবং আরও নমনীয়তা প্রদানের অনুমতি দেয়। উদাহরণস্বরূপ, এটি একই সাইটে স্বতন্ত্রভাবে পৃথক বিজ্ঞাপনদাতাদের ট্র্যাকিং সক্ষম করে৷ এটি একটি একক বিজ্ঞাপন ব্যানারের মধ্যে একাধিক প্রচারাভিযান বা পণ্য ট্র্যাক করার সুবিধা দেয়৷
অ্যাট্রিবিউশন স্কোপ হল ঐচ্ছিক ক্ষেত্র যা উৎস এবং ট্রিগার রেজিস্ট্রেশনের সময় সেট করা যেতে পারে। অ্যাট্রিবিউশন চলাকালীন, শুধুমাত্র সেই উৎসগুলি যাদের অ্যাট্রিবিউশন স্কোপের মান ট্রিগারের অ্যাট্রিবিউশন স্কোপের মানগুলির মধ্যে অন্তত একটি ধারণ করে অ্যাট্রিবিউশনের জন্য বিবেচনা করা হবে। যদি ট্রিগারে কোন সুযোগ নির্দিষ্ট করা না থাকে তাহলে সমস্ত উৎস বিবেচনা করা হবে। আপনি চালিয়ে যাওয়ার আগে, আপনাকে অ্যাট্রিবিউশন রিপোর্টিং API এবং উচ্চ-স্তরের ফিল্টারগুলির সাথে পরিচিত হতে হবে।
উৎস নিবন্ধনের সময়
একটি ঐচ্ছিক প্যারামিটার attribution_scopes হেডারে যোগ করা হয়েছে Attribution-Reporting-Register-Source যাতে দুটি প্রয়োজনীয় প্যারামিটার রয়েছে: মান এবং সীমা; এবং একটি ঐচ্ছিক প্যারামিটার: max_event_states।
- সীমা: উৎস রিপোর্টিং উত্সের জন্য গন্তব্য প্রতি অনুমোদিত স্বতন্ত্র স্কোপের মোট সংখ্যা প্রতিনিধিত্ব করে। একই রিপোর্টিং উত্স এবং গন্তব্যের সাথে বিদ্যমান যেকোন নিবন্ধিত উত্স, তবে একটি ছোট সীমা, মুছে ফেলা হবে৷
- মান: একটি নির্দিষ্ট উৎসের জন্য অ্যাট্রিবিউশন স্কোপের তালিকা উপস্থাপন করে। এই মানগুলি অবশ্যই 50 এর সর্বাধিক দৈর্ঘ্য সহ স্ট্রিং হতে হবে৷
- max_event_states (ঐচ্ছিক): ইভেন্ট স্টেটগুলির সর্বাধিক সংখ্যক প্রতিনিধিত্ব করে যা একজন API কলার পরবর্তী সমস্ত ইভেন্ট-সোর্স রেজিস্ট্রেশন জুড়ে ব্যবহার করার পরিকল্পনা করে। মনে রাখবেন যে একই রিপোর্টিং উত্স এবং গন্তব্যের সাথে বিদ্যমান নিবন্ধিত উত্সগুলি কিন্তু একটি ভিন্ন
max_event_states valueমুছে ফেলা হবে৷ এই ঐচ্ছিক ক্ষেত্রের ডিফল্ট মান হল 3।
উৎস নিবন্ধন নমুনা
Attribution-Reporting-Register-source: {
//optional
"attribution_scopes":{
"limit": <int>,
"values": <list of strings>,
// optional
"max_event_states": <int>
},
...
}
ট্রিগার নিবন্ধন সময়
ট্রিগার নিবন্ধনের সময় একটি ঐচ্ছিক প্যারামিটার attribution_scopes শিরোনাম Attribution-Reporting-Register-Trigger এ যোগ করা হয়। নিশ্চিত করুন যে প্যারামিটার মানটি ট্রিগারের স্কোপের প্রতিনিধিত্বকারী স্ট্রিংয়ের একটি তালিকা। ট্রিগারটি শুধুমাত্র সেই উত্সগুলির সাথে মেলে যেগুলির অ্যাট্রিবিউশন_স্কোপের মান প্যারামিটারে অন্তত একটি ট্রিগারের অ্যাট্রিবিউশন_স্কোপ আছে, যদি নির্দিষ্ট করা থাকে।
ট্রিগার নিবন্ধন নমুনা
Attribution-Reporting-Register-Trigger: {
//optional
"attribution_scopes": <list of strings>,
...
}
অ্যাট্রিবিউশন স্কোপের উদাহরণ
নিম্নলিখিত উদাহরণটি এমন কেস দেখায় যেখানে অ্যাট্রিবিউশন স্কোপগুলি ব্যবহার করার সময় একটি উত্সে একটি ট্রিগার অ্যাট্রিবিউট করা হয়৷
উত্স নিবন্ধন # 1
Attribution-Reporting-Register-source: {
"destination": "https://trigger.example",
"attribution_scopes": {
"limit": 2,
"values": ["advertiser1"],
"max_event_states": 3
},
...
}
উৎস নিবন্ধন #2
Attribution-Reporting-Register-source: {
"destination": "https://trigger.example",
"attribution_scopes": {
"limit": 2,
"values": ["advertiser2"],
"max_event_states": 3
},
...
}
ট্রিগার নিবন্ধন
Attribution-Reporting-Register-Trigger: {
"attribution_scopes": ["advertiser1"],
...
}
যখন ট্রিগার রেজিস্ট্রেশন হয়, তখন API সেই উৎসগুলিকে অ্যাট্রিবিউশনের জন্য বিবেচনা করার জন্য নির্বাচন করে যেগুলিতে attribution_scopes মান রয়েছে যা ট্রিগার নিবন্ধনের মানগুলির সাথে ছেদ করে। বাকি অ্যাট্রিবিউশন প্রবাহের সাথে মিলে যাওয়া উৎস নিবন্ধন চলতে থাকবে। এই উদাহরণে, এপিআই কলার একটি অ্যাট্রিবিউশন রিপোর্ট পাবেন যা ট্রিগার রেজিস্ট্রেশনকে প্রথম সোর্স রেজিস্ট্রেশনের জন্য দায়ী করে।
অ্যাট্রিবিউশন স্কোপ বনাম ফিল্টার
যদিও অ্যাট্রিবিউশন স্কোপ এবং ফিল্টারগুলির কার্যকারিতা একই রকম দেখাতে পারে, তবে পার্থক্যকারী ফ্যাক্টর হল ট্রিগার নিবন্ধন প্রবাহে যেখানে তারা প্রয়োগ করা হয়। অ্যাট্রিবিউশনের আগে অ্যাট্রিবিউশন স্কোপ ফিল্টারিং হয়। এর মানে এটি অপ্রয়োজনীয়, একই গন্তব্য সাইট এবং রিপোর্টিং উৎসের প্রার্থীর উত্সগুলির পুলকে হ্রাস করে, যার উপর ভিত্তি করে উৎসগুলির স্কোপ রয়েছে যা ট্রিগারে পাওয়া স্কোপের সাথে ছেদ করে। শীর্ষ-স্তরের ফিল্টারগুলি, তবে, একটি ট্রিগারকে একটি একক উত্সে দায়ী করার পরে প্রয়োগ করা হয়। যদি উৎস এবং ট্রিগার ফিল্টার ছেদ না করে তাহলে কোনো প্রতিবেদন তৈরি হয় না।
নিম্নলিখিত চিত্রটি উত্সগুলির একটি গ্রুপ এবং একটি ট্রিগার দেখায় যেগুলির একই গন্তব্য সাইট এবং প্রতিবেদনের উত্স রয়েছে এবং মেয়াদ শেষ হয়নি৷ অ্যাট্রিবিউশন স্কোপ এবং ফিল্টারগুলি কীভাবে ব্যবহার করা হয় এবং উপলব্ধ উত্স এবং ট্রিগারগুলির উপর ভিত্তি করে একটি প্রতিবেদন তৈরি করা হবে কিনা সে সম্পর্কে আমরা সংক্ষেপে কথা বলব৷
আরোপ আগে
- উৎস #1 ফিল্টার করা হয়েছে কারণ এর অ্যাট্রিবিউশন স্কোপ
casualwearট্রিগারের সুযোগের সাথে মেলে না। সমস্ত উপলব্ধ উত্সগুলির মধ্যে সর্বোচ্চ অগ্রাধিকার থাকা এটিকে ফিল্টার করা থেকে বাধা দেয় না কারণ অগ্রাধিকারগুলি পরীক্ষা করার আগে প্রাক-অ্যাট্রিবিউশন ফিল্টারিং ঘটে। - ট্রিগারের মতো একই সুযোগ না থাকার কারণে উত্স #2 ফিল্টার করা হয়েছে। এই উত্সটিতেও ট্রিগারের মতো একই ফিল্টার রয়েছে তবে উচ্চ স্তরের ফিল্টারগুলি অ্যাট্রিবিউশনের পরে প্রয়োগ করা হয় না৷
অ্যাট্রিবিউশন সময়
- উত্স #3 অ্যাট্রিবিউশনের জন্য নির্বাচন করা হয়নি কারণ এটির উত্স #4 এর চেয়ে কম অগ্রাধিকার রয়েছে।
- সোর্স #4 নির্বাচন করা হয়েছে কারণ এটির ট্রিগারের সাথে মানানসই অ্যাট্রিবিউশন স্কোপ রয়েছে এবং সর্বোচ্চ অগ্রাধিকার রয়েছে। উচ্চ স্তরের ফিল্টারগুলি পোস্ট অ্যাট্রিবিউশন প্রয়োগ করা হয় যাতে তারা অ্যাট্রিবিউশন প্রক্রিয়ার সময় ফ্যাক্টর না করে।
পোস্ট অ্যাট্রিবিউশন
- নির্বাচিত উৎসের জন্য উচ্চ স্তরের ফিল্টার (উৎস #4) এবং ট্রিগার ছেদ করে না বলে কোনো প্রতিবেদন তৈরি হয় না।
পূর্ববর্তী উদাহরণের ফলে একটি প্রতিবেদন তৈরি হয় না। যাইহোক, যদি চতুর্থ উত্স সম্পূর্ণরূপে সরানো হয়:
অ্যাট্রিবিউশন সময়
- উত্স #3 নির্বাচন করা হয়েছে কারণ এটিতে ট্রিগারের সাথে একটি ছেদকারী অ্যাট্রিবিউশন সুযোগ রয়েছে৷
পোস্ট অ্যাট্রিবিউশন
- উত্স #3 প্রত্যাখ্যান করা হয় না কারণ এটির ফিল্টার ট্রিগারের ফিল্টারের সাথে ছেদ করে। তারপরে অ্যাট্রিবিউশনটি বাকি পোস্ট অ্যাট্রিবিউশন চেকের মধ্য দিয়ে যাবে এবং যদি এটি সমস্ত চেক পাস করে তাহলে একটি প্রতিবেদন তৈরি করা হবে।
অ্যাট্রিবিউশন স্কোপ অ্যাট্রিবিউশনের জন্য বিবেচিত উৎসের সংখ্যা কমিয়ে দেয়। অবশিষ্ট অ্যাট্রিবিউশন পদক্ষেপগুলি তারপরে উত্সের এই ছোট পুলটিতে প্রয়োগ করা হয়, যার ফলে একটি প্রতিবেদন হতে পারে।
অ্যাট্রিবিউশন প্রবাহে অ্যাট্রিবিউশন স্কোপের স্থান
অ্যাট্রিবিউশনের জন্য উৎস নির্বাচন করার আগে অ্যাট্রিবিউশন স্কোপ প্রয়োগ করা হয়। এটি টপ-লেভেল-ফিল্টার এবং কাস্টম রিপোর্ট উইন্ডো ফিল্টারিং-এর আগেও রয়েছে। নিম্নলিখিত চিত্রটি অ্যাট্রিবিউশন এবং বাকি অ্যাট্রিবিউশন চেকের আগে অ্যাট্রিবিউশন স্কোপের সাথে সামগ্রিক অ্যাট্রিবিউশন প্রবাহের একটি সরলীকৃত সংস্করণ দেখায়।
অ্যাট্রিবিউশন ফ্লো অপারেশন
নিম্নলিখিতটি অ্যাট্রিবিউশন প্রবাহের সময় সম্পাদিত বিভিন্ন ক্রিয়াকলাপের সংক্ষিপ্ত বিবরণ:
- উত্স নিবন্ধন: যখন একজন ব্যবহারকারী বিজ্ঞাপনদাতার সাইটে একটি বিজ্ঞাপনের সাথে ইন্টারঅ্যাক্ট করেন, তখন একটি উত্স ইভেন্ট নিবন্ধিত হয়৷ ডিভাইসটি তারপর রিপোর্টিং অরিজিন এর এন্ডপয়েন্টে একটি অনুরোধ পাঠায়, যা সোর্স ইভেন্ট ডেটা ধারণকারী হেডারের সাথে সাড়া দেয়।
- ট্রিগার নিবন্ধন: যখন বিজ্ঞাপনদাতার সাইটে একটি রূপান্তর ঘটে, তখন একটি ট্রিগার ইভেন্ট নিবন্ধিত হয়। আরেকটি অনুরোধ ডিভাইস দ্বারা রিপোর্টিং মূলে পাঠানো হয়, যা ট্রিগার ইভেন্ট ডেটা ধারণকারী হেডারের সাথে প্রতিক্রিয়া জানায়।
- উত্স মিল: ডিভাইসটি গন্তব্য সাইট, প্রতিবেদনের উত্স এবং মেয়াদ শেষ হওয়ার মতো মানদণ্ডের ভিত্তিতে উত্স এবং ট্রিগার ইভেন্টগুলির সাথে মেলে৷
- অ্যাট্রিবিউশন স্কোপ চেক: সোর্স এবং ট্রিগার অ্যাট্রিবিউশন_স্কোপ মানগুলির মধ্যে ছেদগুলির উপর ভিত্তি করে উত্সগুলি ফিল্টার করা হয়৷
- অ্যাট্রিবিউশন: একাধিক উত্স মিলে গেলে ডিভাইসটি অ্যাট্রিবিউশনের জন্য সর্বোচ্চ অগ্রাধিকারের উত্স নির্বাচন করে৷ অগ্রাধিকার সমান হলে, সাম্প্রতিকতমটি নির্বাচন করা হয়।
- ফিল্টার চেক: ডিভাইসটি সোর্স এবং ট্রিগার ফিল্টারগুলির সাথে তুলনা করে তা নির্ধারণ করে যে তারা মেলে কিনা। ফিল্টার না মিললে অ্যাট্রিবিউশন বাদ দেওয়া হয়।
- অন্যান্য উত্সের নিষ্ক্রিয়করণ: যদি নির্বাচিত উত্সের ফিল্টারগুলি মিলে যায়, তাহলে ডিভাইসটি উত্স মেলানো পর্যায়ে মিলিত উত্সগুলি নিষ্ক্রিয় করে৷ নিষ্ক্রিয় করা উৎসগুলিতে সেই উৎসগুলি অন্তর্ভুক্ত থাকবে যার অ্যাট্রিবিউশন স্কোপ ট্রিগার স্কোপের সাথে মেলে না।
- পোস্ট-অ্যাট্রিবিউশন চেক: ডিভাইসটি নির্বাচিত অ্যাট্রিবিউশনের উপর আরও চেক সঞ্চালন করে যেমন জাল রিপোর্টের সাথে উৎসটি শোরগোল করা হয়েছে কিনা তা পরীক্ষা করা, ডিডপ্লিকেশন কী ব্যবহার করে ডুপ্লিকেট অ্যাট্রিবিউশন পরীক্ষা করা, ট্রিগারটি উৎসের রিপোর্ট উইন্ডোর মধ্যে পড়ে কিনা তা পরীক্ষা করা এবং হারের সীমা পরীক্ষা করা।
- রিপোর্ট তৈরি করা: সমস্ত চেক পাস হলে, ডিভাইসটি রিপোর্টিং মূলের শেষ পয়েন্টে পাঠানোর জন্য একটি অ্যাট্রিবিউশন রিপোর্ট তৈরি করে এবং সময়সূচী করে।
পরবর্তী পদক্ষেপ
- প্রাক-অ্যাট্রিবিউশন ফিল্টারিং GitHub ব্যাখ্যাকারীতে অ্যাট্রিবিউশন স্কোপ সম্পর্কে আরও পড়ুন।
- ফিল্টার ব্যবহার করে গ্রাহকের নিয়ম নির্ধারণে ফিল্টার সম্পর্কে আরও পড়ুন।