অ্যাট্রিবিউশন স্কোপ API কলারদের সোর্স এবং ট্রিগার রেজিস্ট্রেশনের সময় স্ট্রিংগুলির একটি তালিকা নির্দিষ্ট করার অনুমতি দেয় যা অ্যাট্রিবিউশন হওয়ার আগে ফিল্টারিংয়ের জন্য ব্যবহার করা যেতে পারে। এটি সূক্ষ্ম শস্য ফিল্টারিংকে API দক্ষতা বৃদ্ধি করতে এবং আরও নমনীয়তা প্রদান করতে সহায়তা করে। উদাহরণস্বরূপ, এটি একই সাইটে পৃথক বিজ্ঞাপনদাতাদের স্বতন্ত্রভাবে ট্র্যাক করতে সক্ষম করে। এটি একটি একক বিজ্ঞাপন ব্যানারের মধ্যে একাধিক প্রচারণা বা পণ্য ট্র্যাক করার সুবিধাও দেয়।
অ্যাট্রিবিউশন স্কোপ হল ঐচ্ছিক ক্ষেত্র যা সোর্স এবং ট্রিগার রেজিস্ট্রেশনের সময় সেট করা যেতে পারে। অ্যাট্রিবিউশনের সময়, শুধুমাত্র সেইসব সোর্স যাদের অ্যাট্রিবিউশন স্কোপের মানগুলিতে ট্রিগারের অ্যাট্রিবিউশন স্কোপের মানগুলির মধ্যে কমপক্ষে একটি থাকে, সেগুলিকে অ্যাট্রিবিউশনের জন্য বিবেচনা করা হবে। যদি ট্রিগারে কোনও স্কোপ নির্দিষ্ট না থাকে তবে সমস্ত সোর্স বিবেচনা করা হবে। চালিয়ে যাওয়ার আগে, আপনার অ্যাট্রিবিউশন রিপোর্টিং API এবং উচ্চ-স্তরের ফিল্টারগুলির সাথে পরিচিত হওয়া উচিত।
উৎস নিবন্ধনের সময়
Attribution-Reporting-Register-Source শিরোনামে একটি ঐচ্ছিক প্যারামিটার attribution_scopes যোগ করা হয়েছে যাতে দুটি প্রয়োজনীয় প্যারামিটার রয়েছে: মান এবং সীমা; এবং একটি ঐচ্ছিক প্যারামিটার: max_event_states।
- সীমা: উৎস প্রতিবেদনের উৎসের জন্য প্রতিটি গন্তব্যস্থলে অনুমোদিত স্বতন্ত্র স্কোপের মোট সংখ্যা প্রতিনিধিত্ব করে। একই প্রতিবেদনের উৎস এবং গন্তব্যস্থল সহ বিদ্যমান নিবন্ধিত উৎস, কিন্তু একটি ছোট সীমা, মুছে ফেলা হবে।
- মান: একটি নির্দিষ্ট উৎসের জন্য অ্যাট্রিবিউশন স্কোপের তালিকা উপস্থাপন করে। এই মানগুলি সর্বোচ্চ ৫০ দৈর্ঘ্যের স্ট্রিং হতে হবে।
- 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-Reporting-Register-Trigger হেডারে একটি ঐচ্ছিক প্যারামিটার attribution_scopes যোগ করা হয়। নিশ্চিত করুন যে প্যারামিটারের মানটি ট্রিগারের স্কোপগুলিকে প্রতিনিধিত্বকারী স্ট্রিংগুলির একটি তালিকা। ট্রিগারটি কেবলমাত্র সেই উৎসগুলির সাথে মিলবে যাদের attribution_scopes values প্যারামিটারে ট্রিগারের কমপক্ষে একটি attribution_scopes রয়েছে, যদি নির্দিষ্ট করা থাকে।
ট্রিগার নিবন্ধনের নমুনা
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 মান ট্রিগার রেজিস্ট্রেশনের মানগুলির সাথে ছেদ করে। মিলিত উৎস নিবন্ধনগুলি বাকি অ্যাট্রিবিউশন প্রবাহের সাথে চলতে থাকবে। এই উদাহরণে, API কলার একটি অ্যাট্রিবিউশন রিপোর্ট পাবেন যেখানে ট্রিগার নিবন্ধনটি প্রথম সোর্স নিবন্ধনের সাথে যুক্ত থাকবে।
অ্যাট্রিবিউশন স্কোপ বনাম ফিল্টার
যদিও অ্যাট্রিবিউশন স্কোপ এবং ফিল্টারের কার্যকারিতা একই রকম মনে হতে পারে, তবে ট্রিগার রেজিস্ট্রেশন ফ্লোতে এগুলি কোথায় প্রয়োগ করা হয় তা হল পার্থক্যকারী ফ্যাক্টর। অ্যাট্রিবিউশন স্কোপ ফিল্টারিং অ্যাট্রিবিউশনের আগে ঘটে। এর অর্থ হল এটি মেয়াদোত্তীর্ণ না হওয়া, প্রার্থী উৎসগুলির একই গন্তব্যস্থল এবং প্রতিবেদনের উৎসের পুল হ্রাস করে, কোন উৎসগুলির স্কোপগুলি ট্রিগারে পাওয়া স্কোপের সাথে ছেদ করে তার উপর ভিত্তি করে। তবে, শীর্ষ-স্তরের ফিল্টারগুলি একটি ট্রিগারকে একটি একক উৎসের সাথে যুক্ত করার পরে প্রয়োগ করা হয়। যদি উৎস এবং ট্রিগার ফিল্টারগুলি ছেদ না করে তবে কোনও প্রতিবেদন তৈরি হয় না।
নিচের ছবিতে কিছু উৎস এবং একটি ট্রিগার দেখানো হয়েছে যাদের গন্তব্যস্থল এবং প্রতিবেদনের উৎস একই, এবং মেয়াদোত্তীর্ণ হয়নি। আমরা সংক্ষেপে আলোচনা করব কিভাবে অ্যাট্রিবিউশন স্কোপ এবং ফিল্টার ব্যবহার করা হয় এবং উপলব্ধ উৎস এবং ট্রিগারের উপর ভিত্তি করে একটি প্রতিবেদন তৈরি করা হবে কিনা।
অ্যাট্রিবিউশনের আগে
- সোর্স #১ ফিল্টার করা হয়েছে কারণ এর অ্যাট্রিবিউশন স্কোপ
casualwearট্রিগারের স্কোপের সাথে মেলে না। সমস্ত উপলব্ধ সোর্সের মধ্যে সর্বোচ্চ অগ্রাধিকার থাকা এটিকে ফিল্টার করা থেকে বিরত রাখে না কারণ অগ্রাধিকার পরীক্ষা করার আগে প্রাক-অ্যাট্রিবিউশন ফিল্টারিং ঘটে। - ট্রিগারের মতো একই সুযোগ না থাকার কারণে উৎস #২ ফিল্টার করা হয়েছে। এই উৎসেও ট্রিগারের মতো একই ফিল্টার রয়েছে কিন্তু উচ্চ স্তরের ফিল্টারগুলি অ্যাট্রিবিউশনের পরে প্রয়োগ করা হয় না।
অ্যাট্রিবিউশনের সময়
- উৎস #৩ অ্যাট্রিবিউশনের জন্য নির্বাচিত হয়নি কারণ এর অগ্রাধিকার উৎস #৪ এর চেয়ে কম।
- উৎস #৪ নির্বাচন করা হয়েছে কারণ এতে ট্রিগারের সাথে মিলে যাওয়া অ্যাট্রিবিউশন স্কোপ রয়েছে এবং সর্বোচ্চ অগ্রাধিকার রয়েছে। উচ্চ স্তরের ফিল্টারগুলি অ্যাট্রিবিউশনের পরে প্রয়োগ করা হয় যাতে অ্যাট্রিবিউশন প্রক্রিয়ার সময় এগুলি ফ্যাক্টর না করে।
পোস্ট অ্যাট্রিবিউশন
- নির্বাচিত উৎস (উৎস #৪) এবং ট্রিগারের জন্য উচ্চ স্তরের ফিল্টারগুলি একে অপরের সাথে ছেদ না করায় কোনও প্রতিবেদন তৈরি হয় না।
পূর্ববর্তী উদাহরণটি কোনও প্রতিবেদন তৈরি করে না। তবে, যদি চতুর্থ উৎসটি সম্পূর্ণরূপে অপসারণ করা হয়:
অ্যাট্রিবিউশনের সময়
- উৎস #৩ নির্বাচন করা হয়েছে কারণ এটির ট্রিগারের সাথে একটি ছেদকারী অ্যাট্রিবিউশন স্কোপ রয়েছে।
পোস্ট অ্যাট্রিবিউশন
- উৎস #৩ প্রত্যাখ্যাত হয় না কারণ এর ফিল্টারটি ট্রিগারের ফিল্টারের সাথে ছেদ করে। এরপর অ্যাট্রিবিউশনটি পোস্টের বাকি অ্যাট্রিবিউশন চেকগুলির মধ্য দিয়ে যাবে এবং সমস্ত চেক পাস করলে একটি রিপোর্ট তৈরি হবে।
অ্যাট্রিবিউশন স্কোপ অ্যাট্রিবিউশনের জন্য বিবেচিত উৎসের সংখ্যা কমিয়ে দেয়। বাকি অ্যাট্রিবিউশন ধাপগুলি তারপর এই ছোট উৎসের পুলে প্রয়োগ করা হয়, যার ফলে একটি প্রতিবেদন তৈরি হতে পারে।
অ্যাট্রিবিউশন প্রবাহে অ্যাট্রিবিউশন স্কোপের স্থান
অ্যাট্রিবিউশনের জন্য কোনও উৎস নির্বাচন করার আগে অ্যাট্রিবিউশন স্কোপ প্রয়োগ করা হয়। এটি টপ-লেভেল-ফিল্টার এবং কাস্টম রিপোর্ট উইন্ডো ফিল্টারিংয়ের আগেও আসে। নিম্নলিখিত চিত্রটি অ্যাট্রিবিউশনের আগে অ্যাট্রিবিউশন স্কোপ এবং বাকি অ্যাট্রিবিউশন চেকের সাথে সামগ্রিক অ্যাট্রিবিউশন প্রবাহের একটি সরলীকৃত সংস্করণ দেখায়।
অ্যাট্রিবিউশন ফ্লো অপারেশন
অ্যাট্রিবিউশন ফ্লো চলাকালীন সম্পাদিত বিভিন্ন ক্রিয়াকলাপের সংক্ষিপ্তসার নিচে দেওয়া হল:
- সোর্স রেজিস্ট্রেশন: যখন একজন ব্যবহারকারী বিজ্ঞাপনদাতার সাইটে কোনও বিজ্ঞাপনের সাথে ইন্টারঅ্যাক্ট করেন, তখন একটি সোর্স ইভেন্ট নিবন্ধিত হয়। এরপর ডিভাইসটি রিপোর্টিং অরিজিনের এন্ডপয়েন্টে একটি অনুরোধ পাঠায়, যা সোর্স ইভেন্ট ডেটা ধারণকারী একটি হেডারের মাধ্যমে সাড়া দেয়।
- ট্রিগার রেজিস্ট্রেশন: যখন বিজ্ঞাপনদাতার সাইটে কোনও রূপান্তর ঘটে, তখন একটি ট্রিগার ইভেন্ট নিবন্ধিত হয়। ডিভাইসটি রিপোর্টিং অরিজিনে আরেকটি অনুরোধ পাঠায়, যা ট্রিগার ইভেন্ট ডেটা ধারণকারী একটি হেডারের সাথে সাড়া দেয়।
- সোর্স ম্যাচিং: ডিভাইসটি গন্তব্যস্থল, রিপোর্টিং উৎস এবং মেয়াদ শেষ হওয়ার মতো মানদণ্ডের উপর ভিত্তি করে সোর্স এবং ট্রিগার ইভেন্টগুলির সাথে ম্যাচ করে।
- অ্যাট্রিবিউশন স্কোপ চেক: সোর্স এবং ট্রিগার অ্যাট্রিবিউশন_স্কোপ মানের মধ্যে ছেদনের উপর ভিত্তি করে সোর্স ফিল্টার করা হয়।
- অ্যাট্রিবিউশন: একাধিক উৎস মিলে গেলে ডিভাইসটি অ্যাট্রিবিউশনের জন্য সর্বোচ্চ অগ্রাধিকার উৎস নির্বাচন করে। যদি অগ্রাধিকার সমান হয়, তাহলে সাম্প্রতিকতম উৎসটি নির্বাচন করা হয়।
- ফিল্টার চেক: ডিভাইসটি উৎস এবং ট্রিগার ফিল্টারগুলির তুলনা করে নির্ধারণ করে যে তারা মিলছে কিনা। যদি ফিল্টারগুলি মিল না করে তবে অ্যাট্রিবিউশন বাদ দেওয়া হয়।
- অন্যান্য উৎস নিষ্ক্রিয়করণ: যদি নির্বাচিত উৎসের ফিল্টারগুলি মিলে যায়, তাহলে ডিভাইসটি উৎস মিলিত হওয়ার পর্যায়ে মিলিত উৎসগুলিকে নিষ্ক্রিয় করে দেয়। নিষ্ক্রিয় উৎসগুলিতে সেই উৎসগুলি অন্তর্ভুক্ত থাকবে যাদের অ্যাট্রিবিউশন স্কোপগুলি ট্রিগার স্কোপগুলির সাথে মেলে না।
- পোস্ট-অ্যাট্রিবিউশন চেক: ডিভাইসটি নির্বাচিত অ্যাট্রিবিউশনের উপর আরও পরীক্ষা করে যেমন সোর্সটি জাল রিপোর্টের সাথে নয়েজ করা হয়েছে কিনা তা পরীক্ষা করা, ডিডুপ্লিকেশন কী ব্যবহার করে ডুপ্লিকেট অ্যাট্রিবিউশন পরীক্ষা করা, ট্রিগারটি সোর্সের রিপোর্ট উইন্ডোর মধ্যে পড়ে কিনা তা পরীক্ষা করা এবং রেট সীমা পরীক্ষা করা।
- রিপোর্ট তৈরি: যদি সমস্ত পরীক্ষা সফল হয়, তাহলে ডিভাইসটি একটি অ্যাট্রিবিউশন রিপোর্ট তৈরি করে এবং রিপোর্টিং অরিজিনের এন্ডপয়েন্টে পাঠানোর জন্য সময়সূচী করে।
পরবর্তী পদক্ষেপ
- অ্যাট্রিবিউশন স্কোপ সম্পর্কে আরও পড়ুন প্রি-অ্যাট্রিবিউশন ফিল্টারিং GitHub ব্যাখ্যাকারীতে ।
- ফিল্টার ব্যবহার করে গ্রাহকের নিয়ম নির্ধারণ করুন বিভাগে ফিল্টার সম্পর্কে আরও পড়ুন।