সাম্প্রতিক হাল নাগাদ
- ট্রানজিশনাল ডিবাগিং রিপোর্টে একটি বিভাগ যোগ করা হয়েছে
- ওয়েব সোর্স রেজিস্টার করার জন্য অনুমোদিত তালিকায় যোগ দেওয়ার নির্দেশনা যোগ করা হয়েছে
অ্যাট্রিবিউশন রিপোর্টিং API ডিজাইন প্রস্তাবে বর্ণিত হিসাবে, API একটি একক Android-চালিত ডিভাইসে নিম্নলিখিত ট্রিগার পাথগুলির অ্যাট্রিবিউশন সক্ষম করে:
- অ্যাপ-টু-অ্যাপ: ব্যবহারকারী একটি অ্যাপে একটি বিজ্ঞাপন দেখেন, তারপর সেই অ্যাপে বা অন্য ইনস্টল করা অ্যাপে রূপান্তর করেন।
- অ্যাপ-টু-ওয়েব: ব্যবহারকারী একটি অ্যাপে একটি বিজ্ঞাপন দেখেন, তারপর একটি মোবাইল বা অ্যাপ ব্রাউজারে রূপান্তরিত করেন।
- ওয়েব-টু-অ্যাপ: ব্যবহারকারী একটি মোবাইল বা অ্যাপ ব্রাউজারে একটি বিজ্ঞাপন দেখেন, তারপর একটি অ্যাপে রূপান্তরিত করেন।
- ওয়েব-টু-ওয়েব: ব্যবহারকারী একটি মোবাইল বা অ্যাপ ব্রাউজারে একটি বিজ্ঞাপন দেখেন, তারপর একই ব্রাউজারে বা একই ডিভাইসে অন্য ব্রাউজারে রূপান্তর করেন৷
এখানে ওয়েবকে একটি অ্যাপে দেখানো ওয়েব সামগ্রী হিসাবে সংজ্ঞায়িত করা হয়েছে। ওয়েব বিষয়বস্তু একটি মোবাইল ব্রাউজার অ্যাপের প্রেক্ষাপটে বা নন-ব্রাউজার অ্যাপে দেখানো এমবেডেড ওয়েবসাইট হিসেবে দেখানো যেতে পারে।
পূর্ববর্তী ট্রিগার পাথগুলি নিম্নলিখিত প্রয়োজনীয়তাগুলিকে অনুবাদ করে:
- বিজ্ঞাপন প্রযুক্তির জন্য: এপিআই কলের আপডেট এবং অ্যাপ-টু-ওয়েব পাথ সক্ষম করতে রিপোর্টিং
- অ্যাপস এবং ব্রাউজারগুলির জন্য: ওয়েব অ্যাট্রিবিউশন সোর্স এবং ওয়েব ট্রিগারগুলিকে অ্যান্ড্রয়েডে নিবন্ধন পাস করার ক্ষমতা
এই নথিটি ব্যাখ্যা করে যে কীভাবে অ্যাট্রিবিউশন রিপোর্টিং এপিআই অ্যাপ-টু-ওয়েব, ওয়েব-টু-অ্যাপ এবং ওয়েব-টু-ওয়েব ট্রিগার পাথগুলিকে সমর্থন করার জন্য প্রসারিত করা হয়। এই ট্রিগার পাথগুলিকে সমর্থন করার জন্য প্রয়োজনীয়তাগুলি পূরণ করতে বিজ্ঞাপন প্রযুক্তি এবং অ্যাপগুলিকে যে পরিবর্তনগুলি করতে হবে তাও এটি বর্ণনা করে৷
অ্যাট্রিবিউশন রিপোর্টিং এপিআই-এ অ্যাক্সেস পান
বিজ্ঞাপন প্রযুক্তি প্ল্যাটফর্মগুলিকে অ্যাট্রিবিউশন রিপোর্টিং এপিআই অ্যাক্সেস করতে নথিভুক্ত করতে হবে, আরও তথ্যের জন্য একটি গোপনীয়তা স্যান্ডবক্স অ্যাকাউন্টের জন্য নথিভুক্ত করুন দেখুন৷
একবার তালিকাভুক্তি প্রক্রিয়া চূড়ান্ত হয়ে গেলে, নিবন্ধনহীন নিবন্ধন কল পাওয়া গেলে API নিবন্ধনটি বাতিল করে দেবে।
নথিভুক্ত করার সময়, বিজ্ঞাপন প্রযুক্তি প্ল্যাটফর্মগুলিকে নিশ্চিত করা উচিত যে তারা সমস্ত সার্ভার ইউআরএলের সাথে নথিভুক্ত করছে যা তারা অ্যাট্রিবিউশন উত্স এবং ট্রিগারগুলি নিবন্ধন করতে অ্যাপ এবং ওয়েব জুড়ে ব্যবহার করতে পারে। একাধিক সার্ভার নিবন্ধন URL সমর্থিত, কিন্তু শুধুমাত্র একটি রিপোর্টিং মূল সমর্থিত। এই প্রতিবেদনের উত্সটি সার্ভার নিবন্ধন URLগুলির একটির ডোমেন থেকে উদ্ভূত হয়েছে৷
বিজ্ঞাপন প্রযুক্তির জন্য পরিবর্তন
নিবন্ধন এবং অ্যাট্রিবিউশন পরিবর্তন
একটি অ্যাট্রিবিউশন উৎস নিবন্ধন করার সময়, বিজ্ঞাপন প্রযুক্তিগুলি বর্তমানে একটি গন্তব্য ক্ষেত্র নির্দিষ্ট করে যা অ্যাপ প্যাকেজের নাম যেখানে ট্রিগার ইভেন্টটি ঘটে। অ্যাপ-টু-ওয়েব পরিমাপ সক্ষম করতে, আমরা একটি অ্যাপ গন্তব্য ক্ষেত্র (অ্যাপ প্যাকেজের নাম) এবং একটি ওয়েব গন্তব্য ক্ষেত্র (eTLD+1) সমর্থন করার পরিকল্পনা করছি।
ওয়েব অ্যাট্রিবিউশন উত্স বা ট্রিগার নিবন্ধন করার সময়, API পুনঃনির্দেশ সমর্থন করে না কারণ প্রতিটি অ্যাপ হোস্টিং ওয়েব সামগ্রীর নিজস্ব অনুমতি মডেল থাকতে পারে। প্রতিটি অ্যাপ রিডাইরেক্ট অনুসরণ করার জন্য দায়ী (যদি সমর্থিত হয়) এবং প্রতিটি রিডাইরেক্ট হপের জন্য ওয়েব কনটেক্সট API কল করার জন্য।
উপরন্তু, এই ইন্টিগ্রেশন বিজ্ঞাপন প্রযুক্তিকে ওয়েব অ্যাট্রিবিউশন উত্সগুলিতে অ্যাপ-নির্দিষ্ট অ্যাট্রিবিউশন লজিক ব্যবহার করতে সক্ষম করে। উদাহরণস্বরূপ, আপনি এখন একটি ওয়েব অ্যাট্রিবিউশন উত্সে পোস্ট-ইনস্টল অ্যাট্রিবিউশন উইন্ডোগুলি নির্দিষ্ট করতে পারেন৷
অ্যাপ এবং ওয়েব রিপোর্ট পান
অ্যান্ড্রয়েড অ্যাট্রিবিউশন রিপোর্টিং API অ্যাপ এবং ওয়েব রূপান্তর উভয়ের জন্য রিপোর্ট পাঠাতে পারে। যদি বিজ্ঞাপন প্রযুক্তিগুলি ওয়েব এবং অ্যাপ সারফেস জুড়ে ট্রিগার ডেটা এবং একত্রিত মূল-মানগুলিকে সারিবদ্ধ করতে না চায়, তাহলে তারা একটি ওয়েব এবং একটি অ্যাপ রূপান্তরের মধ্যে পার্থক্য করতে পারে:
- ইভেন্ট-স্তরের প্রতিবেদনের জন্য, আমরা একটি গন্তব্য ক্ষেত্র সমর্থন করব যা নির্দিষ্ট করে যে ট্রিগারটি ওয়েবে ঘটেছে কিনা (গন্তব্য হল একটি eTLD+1) বা অ্যাপ (গন্তব্য হল একটি অ্যাপ প্যাকেজের নাম)
- সমষ্টিগত প্রতিবেদনের জন্য, গন্তব্য স্পষ্ট পাঠ্যে পাঠানো হয়।
ওয়েব থেকে ওয়েব পরিমাপের প্রভাব
অ্যাট্রিবিউশন রিপোর্টিং API-এ কখন নিবন্ধন পাস করতে হবে তা অ্যাপগুলি বেছে নেয়। এখানে বেশ কয়েকটি বিবেচনা রয়েছে:
- অ্যাট্রিবিউশন রিপোর্টিং API কি সেই ডিভাইসে উপলব্ধ? আমরা অ্যাপ্লিকেশানগুলিতে একটি নতুন সংকেত প্রকাশ করব যা সেই ডিভাইসে অ্যাট্রিবিউশন রিপোর্টিং API উপলব্ধ কিনা তা ফেরত দেয়৷ অ্যাপগুলি কীভাবে অ্যাট্রিবিউশন রিপোর্টিং এপিআই-তে নিবন্ধন পাস করতে পারে সে সম্পর্কে আরও বিশদ বিবরণের জন্য অ্যাপ পরিবর্তন বিভাগটি দেখুন।
- অ্যাট্রিবিউশন সোর্স এবং ট্রিগারের কোন অংশ এপিআই-তে পাস করা উচিত? এটি প্রতিটি অ্যাপ বা বিজ্ঞাপন প্রযুক্তির দ্বারা নেওয়া একটি সিদ্ধান্ত হবে যদি অ্যাপটি একটি পছন্দের অনুমতি দেয়। অ্যাপটির নিজস্ব পরিমাপের সমাধান থাকলে, তারা পরিবর্তে এটি ব্যবহার করার বিষয়ে বিবেচনা করতে চাইতে পারে। শেষ পর্যন্ত, সমস্ত উৎস এবং ট্রিগার নিবন্ধনগুলিকে Android অ্যাট্রিবিউশন রিপোর্টিং API-তে পাস করা, যখন উপলব্ধ, অ্যাপ এবং ওয়েব জুড়ে সবচেয়ে সঠিক অ্যাট্রিবিউশন সক্ষম করে৷
নিম্নলিখিত উদাহরণ দেখায় কিভাবে ব্রাউজার অ্যাপগুলি অ্যাট্রিবিউশন রিপোর্টিং API এর সাথে কাজ করতে পারে যখন ব্যবহারকারী একটি ব্রাউজার অ্যাপ এবং একটি নন-ব্রাউজার অ্যাপ উভয়ের বিজ্ঞাপনে ক্লিক করে তখন সঠিক পরিমাপ প্রদান করতে পারে:
- প্রথম দিন, ব্যবহারকারী ব্রাউজার অ্যাপে একটি বিজ্ঞাপনে ক্লিক করেন।
- ব্রাউজার অ্যাপটি তাদের নিজস্ব পরিমাপ সমাধান ব্যবহার করতে বা অ্যাট্রিবিউশন রিপোর্টিং এপিআই-তে ওয়েব বিজ্ঞাপন ক্লিকের নিবন্ধন পাস করতে পারে।
- ২য় দিনে, ব্যবহারকারী একটি নন-ব্রাউজার অ্যাপে একটি বিজ্ঞাপনে ক্লিক করেন।
- ক্লিকটি API এর সাথে একটি অ্যাট্রিবিউশন উত্স হিসাবে নিবন্ধিত হয়৷ ব্রাউজার অ্যাপের এই ক্লিকে কোনো দৃশ্যমানতা নেই কারণ ঘটনাটি একটি ভিন্ন অ্যাপের মধ্যে ঘটেছে।
- ৩য় দিনে, ব্যবহারকারী ব্রাউজার অ্যাপে কনভার্ট করে।
- যদি ব্রাউজার অ্যাপ উভয়ই তাদের নিজস্ব পরিমাপ সমাধান ব্যবহার করে ক্লিক এবং রূপান্তর নিবন্ধন করে এবং সেই তথ্যটি অ্যাট্রিবিউশন রিপোর্টিং এপিআই-তে পাস করে, তাহলে এটি অসম্ভাব্য যে কোনও বিজ্ঞাপন প্রযুক্তি পরিমাপ সমাধান জুড়ে রূপান্তর প্রতিবেদনগুলিকে ডিডপ্লিকেট করতে পারে। উপরন্তু, একটি বিজ্ঞাপন প্রযুক্তি ব্রাউজার অ্যাপ রেট সীমা এবং অ্যাট্রিবিউশন রিপোর্টিং API রেট সীমা উভয়ই গ্রাস করতে পারে। অতএব, আমরা সুপারিশ করি যে অ্যাপগুলি যখন API উপলব্ধ থাকে তখন API-এ নিবন্ধিত হতে সমস্ত বিজ্ঞাপন ইভেন্ট এবং রূপান্তরগুলি পাস করে৷
ওয়েবভিউ থেকে অ্যাট্রিবিউশন উত্স এবং ট্রিগার নিবন্ধন করুন
যে ক্ষেত্রে অ্যাপটি কোনও নেটিভ অ্যান্ড্রয়েড বিজ্ঞাপনের পরিবর্তে ওয়েব কন্টেন্ট দেখানোর জন্য ওয়েবভিউ ব্যবহার করছে, অ্যাপটি registerWebSource()
অনুমতি তালিকায় যোগ দেওয়ার জন্য আবেদন করতে পারে এবং অ্যাট্রিবিউশন সোর্সের সাথে যুক্ত হতে ওয়েবসাইটের শীর্ষ-স্তরের উৎস প্রদান করতে পারে। অ্যাপ প্যাকেজ নামের চেয়ে।
ব্রাউজারগুলির মতো, WebView ট্রিগার নিবন্ধনের জন্য registerWebTrigger()
সমর্থন করে, যা ট্রিগারটিকে শীর্ষ-স্তরের উত্সের সাথে যুক্ত করে। একটি অ্যাপ ট্রিগার নিবন্ধন করার জন্য WebView এর জন্য কোন সমর্থন নেই; আপনার কাছে এটির জন্য একটি ব্যবহারের ক্ষেত্রে থাকলে যোগাযোগ করুন । WebView দ্বারা সমর্থিত সংমিশ্রণের সম্পূর্ণ তালিকার জন্য, অ্যাট্রিবিউশন উত্স দেখুন এবং WebView থেকে নিবন্ধন ট্রিগার করুন ।
ব্রাউজারগুলির বিপরীতে, WebView শুধুমাত্র Attribution-Reporting-Eligible
শিরোনামের মধ্যে OS এর সাথে নিবন্ধন সমর্থন করে যদি Android এর অ্যাট্রিবিউশন রিপোর্টিং API উপলব্ধ থাকে৷ যদি অ্যান্ড্রয়েডের অ্যাট্রিবিউশন রিপোর্টিং এপিআই অনুপলব্ধ হয়, ওয়েবভিউ একটি Attribution-Reporting-Eligible
শিরোনাম সেট করে না এবং কোনও নিবন্ধন করা হয় না।
OS ব্যবহার করে একটি অ্যাট্রিবিউশন সোর্স/ট্রিগার নিবন্ধন করতে:
- বিজ্ঞাপন প্রযুক্তিগুলিকে
Attribution-Reporting-Register-OS-Source
হেডার ব্যবহার করে সোর্স রেজিস্ট্রেশনে সাড়া দেওয়া উচিত, যাregisterSource()
বাregisterWebSource()
করতে WebView থেকে একটি সেকেন্ডারি API কল শুরু করে। - অ্যাড টেকগুলিও
Attribution-Reporting-Register-OS-Trigger
হেডার ব্যবহার করে ট্রিগার রেজিস্ট্রেশনে সাড়া দিতে পারে, যা ওয়েবভিউ থেকেregisterWebTrigger()
বাregisterTrigger()
করতে একটি সেকেন্ডারি API কল শুরু করে।
মনে রাখবেন যে প্রতিক্রিয়া যদি পূর্ববর্তী শিরোনামগুলিকে অন্তর্ভুক্ত না করে, অথবা এটিতে Attribution-Reporting-Register-Source
/ Attribution-Reporting-Register-Trigger
শিরোনামগুলিও অন্তর্ভুক্ত থাকে যদিও ওয়েব সমর্থিত নয়, তাহলে সম্পূর্ণ নিবন্ধন ব্যর্থ হবে৷
WebView registerSource()
/ registerWebSource()
এবং registerTrigger()
/ registerWebTrigger()
(পাশাপাশি এই আচরণটি কীভাবে পরিবর্তন করবেন) ব্যবহার করবে কিনা সে সম্পর্কে বিশদ বিবরণের জন্য WebView থেকে অ্যাট্রিবিউশন উত্স এবং ট্রিগার নিবন্ধন দেখুন।
ট্রানজিশনাল ডিবাগিং রিপোর্ট
অ্যাট্রিবিউশন রিপোর্টিং এপিআই ট্রানজিশনাল ডিবাগিং রিপোর্ট নামে একটি ঐচ্ছিক কার্যকারিতা সমর্থন করে, যা বিজ্ঞাপন প্রযুক্তিগুলিকে বিজ্ঞাপন আইডি উপলব্ধ থাকলে অ্যাট্রিবিউশন রিপোর্ট সম্পর্কে আরও তথ্য জানতে দেয়৷ দুই ধরনের ডিবাগিং রিপোর্ট আছে: অ্যাট্রিবিউশন-সফল এবং ভার্বোস । এই রিপোর্টগুলি ক্রস অ্যাপ এবং ওয়েব অ্যাট্রিবিউশনের জন্য সমর্থিত, এবং উভয় রিপোর্টের ধরন একই তথ্য ধারণ করে; ডিবাগিং রিপোর্ট পাঠানো হয় যখন গেট অনুমতি চারপাশে শুধুমাত্র পার্থক্য.
ওয়েব-টু-ওয়েব অ্যাট্রিবিউশনের জন্য যা একটি একক অ্যাপের মধ্যে ঘটে (উদাহরণস্বরূপ, একই ব্রাউজার অ্যাপের মধ্যে), অ্যাট্রিবিউশন-সাফল্য এবং ভার্বোস রিপোর্ট শুধুমাত্র তৃতীয় পক্ষের কুকিজ উপলব্ধ হলেই পাওয়া যায় এবং বিজ্ঞাপন আইডি উপলব্ধতার উপর ভিত্তি করে নয়।
অ্যাপ-টু-ওয়েব, ওয়েব-টু-অ্যাপ, এবং ওয়েব-টু-ওয়েব ক্রস-অ্যাপ অ্যাট্রিবিউশনের জন্য, অ্যাট্রিবিউশন-সফলতা এবং ভার্বোস রিপোর্ট পাওয়া যায় যদি অ্যাপের পাশে AdID পাওয়া যায় এবং বিজ্ঞাপন প্রযুক্তি একই পাস করতে পারে (সঠিক ) ওয়েব সাইডে AdID। একটি অ্যাপ-টু-ওয়েব উদাহরণের জন্য নীচে দেখুন যেখানে উত্সটি একটি প্রকাশক অ্যাপে ঘটে, কিন্তু ট্রিগারটি একটি ব্রাউজার অ্যাপের মধ্যে একটি বিজ্ঞাপনদাতার সাইটে ঘটে।
অ্যাপ-টু-ওয়েবের জন্য একটি অ্যাট্রিবিউশন-সাফল্য ডিবাগিং রিপোর্ট সক্ষম করতে, নীচের তিনটি শর্ত অবশ্যই পূরণ করতে হবে:
- ব্যবহারকারীকে অবশ্যই বিজ্ঞাপন আইডি ব্যবহার করে ব্যক্তিগতকরণ থেকে অপ্ট আউট করা উচিত নয়৷
- প্রকাশক অ্যাপকে অবশ্যই AdID অনুমতি ঘোষণা করতে হবে
- ট্রিগার রেজিস্ট্রেশনে বিজ্ঞাপন প্রযুক্তিকে অবশ্যই AdID মান পাস করতে হবে (ওয়েব প্রসঙ্গ থেকে)
অ্যাপ-টু-ওয়েবের জন্য ভার্বোস ডিবাগিং রিপোর্ট সক্ষম করতে:
- উৎস ভার্বোস রিপোর্ট শুধুমাত্র প্রকাশকের পক্ষের অনুমতির উপর নির্ভর করে। উৎস ভার্বোস রিপোর্ট পাঠানোর জন্য, ব্যবহারকারীকে অবশ্যই AdID ব্যক্তিগতকরণ থেকে অপ্ট আউট করা উচিত নয় এবং প্রকাশক অ্যাপকে অবশ্যই AdID অনুমতিগুলি ঘোষণা করতে হবে৷
- ট্রিগার ভার্বোস রিপোর্ট শুধুমাত্র ট্রিগার সাইড (এই উদাহরণে, ওয়েব) অনুমতির উপর নির্ভর করে। ট্রিগার ভার্বোস রিপোর্ট পাঠানোর জন্য ব্রাউজারে তৃতীয় পক্ষের কুকিজ অবশ্যই উপলব্ধ থাকতে হবে।
- ট্রিগার ভার্বোস রিপোর্টের জন্য যা ঐচ্ছিকভাবে একটি
source_debug_key
অন্তর্ভুক্ত করতে পারে,source_debug_key
অন্তর্ভুক্ত করা হয় যদি বিজ্ঞাপন আইডি প্রকাশক অ্যাপে উপলব্ধ থাকে।
মনে রাখবেন যে সমস্ত ক্ষেত্রে, বিজ্ঞাপন প্রযুক্তিকে এখনও উৎসে debug_reporting
অভিধান ক্ষেত্রের মাধ্যমে ভার্বোস ডিবাগিং রিপোর্ট গ্রহণ করতে বেছে নিতে হবে এবং নিবন্ধন শিরোনাম ট্রিগার করতে হবে।
অ্যাপের জন্য পরিবর্তন
ওয়েব প্রসঙ্গ API কলগুলির একটি নতুন সেট ব্যবহার করে Android-এ অ্যাট্রিবিউশন রিপোর্টিং API-এ ওয়েব অ্যাট্রিবিউশন উত্স এবং ওয়েব ট্রিগারগুলির নিবন্ধন পাস করার অনুমতি দিয়ে আমরা অ্যাপ এবং ওয়েব সারফেস জুড়ে অ্যাট্রিবিউশন সমর্থন করব৷
নিম্নলিখিত বিভাগগুলিতে নিবন্ধকরণের পদক্ষেপগুলি সম্পূর্ণ করার পরে, অ্যাপ এবং ওয়েব অ্যাট্রিবিউশন উত্স এবং ট্রিগারগুলি ডিভাইসে সংরক্ষণ করা হয় এবং অ্যাট্রিবিউশন রিপোর্টিং API অ্যাপ এবং ওয়েব সারফেস জুড়ে সোর্স-অগ্রাধিকারযুক্ত, লাস্ট-টাচ অ্যাট্রিবিউশন সম্পাদন করতে পারে।
ক্রস অ্যাপ এবং ওয়েব পরিমাপ সক্ষম করতে ব্রাউজারগুলি কীভাবে অ্যান্ড্রয়েডের অ্যাট্রিবিউশন রিপোর্টিং API এর সাথে একীভূত করতে পারে তার উদাহরণের জন্য ওয়েবের প্রস্তাবের জন্য গোপনীয়তা স্যান্ডবক্স দেখুন৷ প্রস্তাবে, ব্রাউজার নিম্নলিখিত অনুরোধ শিরোনাম যোগ করবে:
-
Attribution-Reporting-Eligible
সম্প্রচার অ্যাট্রিবিউশনের জন্য OS-স্তরের সমর্থন উপলব্ধ কিনা। এই ক্ষেত্রে, শিরোনামটি Android এর অ্যাট্রিবিউশন রিপোর্টিং API উপলব্ধ কিনা তা নির্দেশ করে৷ - যদি উপলব্ধ থাকে, বিজ্ঞাপন প্রযুক্তিগুলি ঐচ্ছিকভাবে
Attribution-Reporting-Register-OS-Source
ব্যবহার করে প্রতিক্রিয়া জানাতে পারে, যাregisterWebSource()
করার জন্য ব্রাউজার অ্যাপ থেকে একটি সেকেন্ডারি API কল শুরু করে। - অ্যাড টেকও
Attribution-Reporting-Register-OS-Trigger
হেডার ব্যবহার করে ট্রিগার রেজিস্ট্রেশনে সাড়া দিতে পারে, যাregisterWebTrigger()
জন্য ব্রাউজার অ্যাপ থেকে একটি সেকেন্ডারি API কল শুরু করে।
অ্যাট্রিবিউশন সোর্স রেজিস্ট্রেশন
একটি অ্যাট্রিবিউশন সোর্স রেজিস্টার করার সময়, অ্যাপগুলি registerWebSource()
কল করতে পারে, যা নিম্নলিখিত প্যারামিটারগুলি আশা করে:
- অ্যাট্রিবিউশন সোর্স ইউআরআই : অ্যাট্রিবিউশন সোর্সের সাথে যুক্ত মেটাডেটা আনার জন্য প্ল্যাটফর্ম এই তালিকার প্রতিটি ইউআরআই-কে একটি অনুরোধ জারি করে।
প্রতিটি URI-এর সাথে একটি বুলিয়ান ডিবাগ পতাকা থাকা উচিত যাতে তা নির্দেশ করে যে কারিগরি দ্বারা সরবরাহ করা ডিবাগ কীগুলি প্রতিবেদনে অন্তর্ভুক্ত করা উচিত। - ইনপুট ইভেন্ট : হয় একটি
InputEvent
অবজেক্ট (একটি ক্লিক ইভেন্টের জন্য) বাnull
(একটি ভিউ ইভেন্টের জন্য) - উত্স উত্স : উত্স যেখানে উত্স ঘটেছে (প্রকাশক ওয়েবসাইট)।
- OS গন্তব্য : একটি অ্যাপ প্যাকেজের নাম যেখানে ট্রিগার ইভেন্ট ঘটে।
- ওয়েব গন্তব্য : একটি eTLD+1 যেখানে ট্রিগার ইভেন্ট ঘটে।
- যাচাইকৃত গন্তব্য : ব্যবহারকারীর ক্লিকে নেভিগেশনের জন্য ব্যবহৃত OS বা ওয়েব গন্তব্য URI অভিপ্রায়।
এপিআই যখন অ্যাট্রিবিউশন সোর্স ইউআরআই-কে অনুরোধ করে, তখন অ্যাড টেককে HTTP হেডার, Attribution-Reporting-Register-Source
এ অ্যাট্রিবিউশন সোর্স মেটাডেটা দিয়ে সাড়া দেওয়া উচিত। এই শিরোনামটি কয়েকটি পরিবর্তন সহ অ্যাপ-টু-অ্যাপ অ্যাট্রিবিউশন সোর্স রেজিস্ট্রেশনের মতো একই ক্ষেত্র ব্যবহার করে:
- এপিআই অ্যাপ দ্বারা নির্দিষ্ট গন্তব্যগুলির সাথে বিজ্ঞাপন প্রযুক্তি দ্বারা নির্দিষ্ট গন্তব্যগুলিকে যাচাই করে৷ গন্তব্য ভিন্ন হলে, এপিআই অ্যাট্রিবিউশন সোর্স রেজিস্ট্রেশন বাতিল করে।
ওয়েব প্রসঙ্গ API কল করার আগে অ্যাপগুলি ওয়েব গন্তব্যগুলি যাচাই করবে বলে আশা করা হচ্ছে৷ ক্লিকের জন্য, অ্যাপগুলিকে পরীক্ষা করা উচিত যে নির্দিষ্ট গন্তব্যটি ব্যবহারকারী যে গন্তব্যে নেভিগেট করছে তার সাথে মেলে। - এপিআই
Attribution-Reporting-Redirects
দেওয়া যেকোনো রিডাইরেক্ট ইউআরআইকে উপেক্ষা করে। অ্যাপগুলিকে তাদের নিজস্বভাবে পুনঃনির্দেশ অনুসরণ করা উচিত এবং প্রতিটি পুনঃনির্দেশের জন্যregisterWebSource()
কল করা উচিত, যাতে তারা প্রয়োজনে তাদের নিজস্ব অনুমতি নীতি প্রয়োগ করতে পারে।
registerWebSource()
কল করার জন্য অ্যাপগুলিকে একটি অনুমোদিত তালিকায় যোগ দিতে হবে। অনুমোদিত তালিকায় যোগ দিতে এই ফর্মটি পূরণ করুন । অনুমোদিত তালিকার উদ্দেশ্য হল ওয়েব প্রেক্ষাপটের জন্য বিশ্বাস স্থাপনের জন্য গোপনীয়তা বিবেচনাকে প্রশমিত করা।
ট্রিগার (রূপান্তর) নিবন্ধন
ট্রিগার রেজিস্ট্রেশনে, অ্যাপগুলি registerWebTrigger()
কল করতে পারে, যা নিম্নলিখিত প্যারামিটারগুলি আশা করে:
- ট্রিগার ইউআরআই : ট্রিগারের সাথে যুক্ত মেটাডেটা আনার জন্য প্ল্যাটফর্ম এই তালিকার প্রতিটি ইউআরআই-কে একটি অনুরোধ জারি করে
- গন্তব্যের উত্স : মূল স্থান যেখানে ট্রিগারটি ঘটেছে (বিজ্ঞাপনদাতার ওয়েবসাইট)
WebView থেকে অ্যাট্রিবিউশন সোর্স এবং ট্রিগার রেজিস্ট্রেশন
ডিফল্টরূপে, WebView registerSource()
এবং registerWebTrigger()
ব্যবহার করবে। এটি অ্যাপের সাথে উত্সগুলিকে সংযুক্ত করে এবং যখন ট্রিগারটি ঘটে তখন WebView এর শীর্ষ-স্তরের উত্সের সাথে ট্রিগার করে৷
যদি একটি অ্যাপের ভিন্ন আচরণের প্রয়োজন হয় (যেমন যেগুলি ওয়েবভিউতে ওয়েব সামগ্রী হোস্ট করে) তাদের androidx.webkit.WebViewSettingsCompat
ক্লাসে setAttributionRegistrationBehavior
পদ্ধতি ব্যবহার করতে হবে। এই পদ্ধতিটি নির্দিষ্ট করবে যে WebView-কে registerWebSource()
অথবা registerSource()
এবং registerWebTrigger()
বা registerTrigger()
কল করা উচিত কিনা।
setAttributionRegistrationBehavior
এর জন্য উপলব্ধ বিকল্পগুলি হল:
মান | বর্ণনা | উদাহরণ ব্যবহার ক্ষেত্রে |
---|---|---|
APP_SOURCE_AND_WEB_TRIGGER (ডিফল্ট) | অ্যাপগুলিকে ওয়েবভিউ থেকে অ্যাপ উত্স (অ্যাপ প্যাকেজ নামের সাথে যুক্ত উত্স) এবং ওয়েব ট্রিগার (eTLD+1 এর সাথে যুক্ত ট্রিগার) নিবন্ধন করার অনুমতি দেয়৷ | যে অ্যাপগুলি ওয়েব ব্রাউজিং সক্ষম করার পরিবর্তে বিজ্ঞাপন পরিবেশন করতে WebView ব্যবহার করে৷ |
WEB_SOURCE_AND_WEB_TRIGGER | অ্যাপগুলিকে ওয়েবভিউ থেকে ওয়েব উত্স এবং ওয়েব ট্রিগার নিবন্ধন করার অনুমতি দেয়৷ দ্রষ্টব্য: এই বিকল্পটি ব্যবহার করা অ্যাপগুলিকে registerWebSource() ব্যবহার করার জন্য অনুমোদিত তালিকায় যোগদানের জন্য আবেদন করতে হবে। | WebView-ভিত্তিক ব্রাউজার অ্যাপ, যেখানে বিজ্ঞাপন ইম্প্রেশন এবং রূপান্তর উভয়ই WebView-এর ওয়েবসাইটে ঘটতে পারে। |
APP_SOURCE_AND_APP_TRIGGER | অ্যাপগুলিকে ওয়েবভিউ থেকে অ্যাপ উত্স এবং অ্যাপ ট্রিগার নিবন্ধন করার অনুমতি দেয়৷ | WebView-ভিত্তিক অ্যাপ্লিকেশান যেখানে বিজ্ঞাপনের ইমপ্রেশন এবং রূপান্তরগুলি সবসময় WebView এর eTLD+1 এর পরিবর্তে অ্যাপের সাথে যুক্ত হওয়া উচিত। |
অক্ষম | WebView থেকে উৎস এবং ট্রিগার নিবন্ধন নিষ্ক্রিয় করে। মনে রাখবেন যে অ্যাট্রিবিউশন সোর্স বা ট্রিগার URI-তে প্রাথমিক নেটওয়ার্ক কল এখনও ঘটতে পারে, কিন্তু কোনো প্রতিক্রিয়া বাতিল করা হয়েছে এবং ডিভাইসে কিছুই সংরক্ষণ করা হবে না। |
গোপনীয়তা এবং নিরাপত্তা বিবেচনা
প্রতিবেদনে প্রয়োগ করা গোপনীয়তা-সংরক্ষণ পদ্ধতির উপর প্রভাব
মূল নকশা প্রস্তাবে বর্ণিত হিসাবে, API প্রতিবেদনগুলিতে গোপনীয়তা-সংরক্ষণের হার সীমা প্রয়োগ করে । কিছু সীমা উৎস এবং গন্তব্য অ্যাপ জুড়ে বিভাজিত। যখন একটি ওয়েব অ্যাট্রিবিউশন উত্স বা ট্রিগার নিবন্ধিত হয়, তখন অ্যাপের পরিবর্তে উৎস বা গন্তব্য সাইট দ্বারা হারের সীমা ভাগ করা হয়।
যদি অ্যাপটি পৃথক হারের সীমা বজায় রাখে, তাহলে একজন প্রতিপক্ষের পক্ষে API-এর হারের সীমা ছাড়াও অ্যাপ-নির্দিষ্ট হারের সীমা ব্যবহার করা সম্ভব হবে। এটি প্রশমিত করার জন্য, অ্যাপগুলিকে নিশ্চিত করতে হবে যে প্রদত্ত অ্যাট্রিবিউশন উত্সটি অ্যাপের পরিমাপ সমাধান এবং Android অ্যাট্রিবিউশন রিপোর্টিং API উভয়েই নিবন্ধিত নয়৷
ওয়েব প্রসঙ্গের জন্য বিশ্বাস স্থাপন করুন
ওয়েব কনটেক্সট API কলগুলিতে, API উত্স এবং গন্তব্য উত্স সনাক্ত করতে এবং নির্দিষ্ট করতে অ্যাপের উপর আস্থা রাখে। এটি সম্ভাব্য গোপনীয়তা এবং সুরক্ষা বিবেচনাগুলি খুলতে পারে:
- একটি প্রতিপক্ষ তার মালিকানাধীন ওয়েবসাইটগুলিকে হোস্টিং করার দাবি করতে পারে যে কোনও উত্স যে পরিমাণ তথ্য স্থানান্তর করতে পারে তার হারের সীমা অতিক্রম করার প্রয়াসে৷
- একাধিক প্রতিপক্ষ একই সোর্স সাইট দাবি করে আলাদা অ্যাট্রিবিউশন সোর্স রেজিস্টার করার জন্য যোগসাজশ করতে পারে। এটি সোর্স সাইটটিকে বিজ্ঞাপন প্রযুক্তি প্ল্যাটফর্মের হারের সীমাকে আঘাত করতে পারে এবং প্রকৃত উত্স সাইটটিকে বৈধ অ্যাট্রিবিউশন উত্স নিবন্ধন করা থেকে বাধা দিতে পারে৷
এটি প্রশমিত করার জন্য, আমরা সীমাবদ্ধ করব কোন ব্রাউজার বা অ্যাপগুলিকে registerWebSource()
কল করতে পারে এমন ব্রাউজার বা অ্যাপ যা প্রমাণ করে যে রেজিস্ট্রেশনে ব্যবহৃত সোর্স সাইট ব্যবহারকারীকে দেখানো হচ্ছে প্রকৃত সাইটটিকে প্রতিনিধিত্ব করে। registerWebSource()
কল করার অনুমতি তালিকায় যোগ দিতে এই ফর্মটি পূরণ করুন।
যেকোন অ্যাপ registerWebTrigger()
কল করতে পারে কারণ ট্রিগার সাইডে গোপনীয়তা এবং নিরাপত্তা বিবেচনাগুলি উৎস-পার্শ্বের যোগসাজশ ছাড়া প্রযোজ্য নয়।
ব্যবহারকারী নিয়ন্ত্রণ
অ্যাপগুলি ব্যবহারকারীর নিয়ন্ত্রণ বা অনুমতি নীতিগুলিকে সমর্থন করা চালিয়ে যেতে পারে যতক্ষণ না সেগুলি নিবন্ধকরণের সময় সংজ্ঞায়িত করা যেতে পারে। উদাহরণস্বরূপ, যদি অ্যাপগুলি কোনও সাইট-লেভেল বা ব্যবহারকারী-স্তরের অনুমতি দেয়, তবে অ্যাপটিকে সেগুলি মূল্যায়ন করা উচিত এবং ওয়েব প্রসঙ্গ API কল করা হবে কিনা তা নির্ধারণ করা উচিত।
উপরন্তু, ডিভাইসে সেই অ্যাপের জন্য সঞ্চিত যেকোন অ্যাট্রিবিউশন সোর্স, ট্রিগার এবং মুলতুবি রিপোর্ট মুছে ফেলার জন্য আমরা অ্যাপ থেকে একটি নতুন API কল সমর্থন করব। উদাহরণস্বরূপ, যদি অ্যাপগুলি ব্যবহারকারীকে তাদের ব্রাউজিং ইতিহাস সাফ করার অনুমতি দেয়, তবে তারা ব্যবহারকারীর ডিভাইসে সেই অ্যাপের জন্য সংরক্ষিত অ্যাট্রিবিউশন উত্স, ট্রিগার এবং মুলতুবি প্রতিবেদনগুলি মুছে ফেলার জন্য API কল করতে চাইতে পারে।
ভবিষ্যতের বিবেচনা এবং খোলা প্রশ্ন
অ্যাট্রিবিউশন রিপোর্টিং API-এর জন্য অ্যাপ-টু-ওয়েব ইন্টারঅপারেবিলিটি একটি কাজ চলছে। আমরা কয়েকটি ধারণা সম্পর্কে সম্প্রদায়ের কাছ থেকে প্রতিক্রিয়া চাইতে চাই:
- অ্যান্ড্রয়েড প্রাইভেসি স্যান্ডবক্স সমর্থিত ডিভাইসে, আপনি কীভাবে অ্যান্ড্রয়েড অ্যাট্রিবিউশন রিপোর্টিং API-এর সাথে ব্রাউজার পরিমাপ সমাধানগুলি ব্যবহার করবেন? আপনি কি অ্যান্ড্রয়েডে সবকিছু পাস করতে পছন্দ করবেন?
- প্রতিটি অ্যাট্রিবিউশন সোর্স এবং ট্রিগারের জন্য একটি ব্রাউজার/অ্যাপ থেকে এবং একটি অ্যাট্রিবিউশন রিপোর্টিং এপিআই থেকে সম্ভাব্যভাবে 2টি পিং পাওয়ার বিষয়ে কোন উদ্বেগ আছে?
- আমরা কীভাবে আপনার জন্য বিভিন্ন API গুলি থেকে ডিবাগিং সহজ করতে সাহায্য করতে পারি?
- প্রস্তাবটিতে অ্যাপ এবং ওয়েব গন্তব্যগুলি অনুমোদিত হওয়ার বিষয়টি অন্তর্ভুক্ত নয়। ভবিষ্যতে, আমরা ডিজিটাল সম্পদ লিঙ্কগুলি ব্যবহার করে অ্যাসোসিয়েশনগুলি পরীক্ষা করে এই গন্তব্যগুলিকে যাচাই করতে সক্ষম হতে পারি৷ যে আপনার ব্যবহারের ক্ষেত্রে কোনো ব্লক করবে? এই বৈধতা করার জন্য ডিজিটাল সম্পদ লিঙ্কগুলি ব্যবহার করা কি অর্থপূর্ণ?
- একটি অ্যাট্রিবিউশন উত্স নিবন্ধন করার সময়, আপনাকে অবশ্যই একটি গন্তব্য নির্দিষ্ট করতে হবে৷ ওয়েব-টু-অ্যাপ ক্ষেত্রে, আপনি একটি অ্যাপ লিঙ্ক নির্দিষ্ট করতে চাইতে পারেন। এই অ্যাপ লিঙ্কটি নির্দিষ্ট করতে আপনি কোন ফর্ম্যাট ব্যবহার করেন?
- একটি অ্যাপ-টু-ওয়েব অ্যাট্রিবিউশন সোর্স রেজিস্টার করার সময়, সেই সোর্স ইভেন্টটিকে অ্যাপ থেকে অ্যান্ড্রয়েড অ্যাট্রিবিউশন রিপোর্টিং এপিআই-এর সাথে নিবন্ধিত করতে হবে। উদাহরণস্বরূপ, যদি ব্যবহারকারী একটি বিজ্ঞাপনে ক্লিক করে এবং ক্লিকটি একটি ব্রাউজার বা ব্রাউজারের কাস্টম ট্যাবে খোলা হয়, তাহলে সেই ক্লিকটি (উৎস ইভেন্ট) ব্রাউজার প্রসঙ্গের পরিবর্তে অ্যাপ থেকে নিবন্ধিত হওয়া উচিত। এই বিষয়ে আপনার উদ্বেগ থাকলে অনুগ্রহ করে যোগাযোগ করুন, অথবা যদি সমর্থিত প্রবাহের বর্ণনা দিয়ে এই সমস্যাটির অন্তর্ভুক্ত বিভাগগুলির মধ্যে পড়ে না এমন অন্যান্য ব্যবহারের ক্ষেত্রে থাকে।
আপনার জন্য প্রস্তাবিত
- দ্রষ্টব্য: জাভাস্ক্রিপ্ট বন্ধ থাকলে লিঙ্ক টেক্সট প্রদর্শিত হয়
- অ্যাট্রিবিউশন রিপোর্টিং
- অ্যাট্রিবিউশন রিপোর্টিং API বিকাশকারীর নির্দেশিকা
- অব্যাহতি পত্র