অ্যাট্রিবিউশন রিপোর্টিং: ক্রস অ্যাপ এবং ওয়েব পরিমাপ, অ্যাট্রিবিউশন রিপোর্টিং: ক্রস অ্যাপ এবং ওয়েব পরিমাপ

সাম্প্রতিক আপডেটগুলি

• ট্রানজিশনাল ডিবাগিং রিপোর্টের উপর একটি বিভাগ যোগ করা হয়েছে
• ওয়েব সোর্স নিবন্ধনের জন্য একটি অ্যালাউলিস্টে যোগদানের নির্দেশাবলী যোগ করা হয়েছে।

ট্রিগার পাথ

অ্যাট্রিবিউশন রিপোর্টিং API ডিজাইন প্রস্তাবনায় বর্ণিত হিসাবে, API একটি একক অ্যান্ড্রয়েড-চালিত ডিভাইসে নিম্নলিখিত ট্রিগার পাথগুলির অ্যাট্রিবিউশন সক্ষম করে। এখানে আমরা ওয়েবকে সংজ্ঞায়িত করি; (১) অ্যান্ড্রয়েডে চলমান একটি স্বতন্ত্র ব্রাউজার (যেমন Chrome) অথবা, (২) একটি অ্যান্ড্রয়েড অ্যাপের ভিতরে চলমান একটি ওয়েবভিউ।

• অ্যাপ-টু-অ্যাপ: ব্যবহারকারী একটি অ্যাপে একটি বিজ্ঞাপন দেখেন, তারপর সেই অ্যাপে অথবা অন্য কোনও ইনস্টল করা অ্যাপে রূপান্তরিত করেন।
• অ্যাপ-টু-ওয়েব: ব্যবহারকারী একটি অ্যাপে একটি বিজ্ঞাপন দেখেন, তারপর ওয়েবে রূপান্তরিত করেন।
• ওয়েব-টু-অ্যাপ: ব্যবহারকারী ওয়েবে একটি বিজ্ঞাপন দেখেন, তারপর একটি অ্যাপে রূপান্তরিত করেন।
• ওয়েব-টু-ওয়েব: ব্যবহারকারী ওয়েবে একটি বিজ্ঞাপন দেখেন, তারপর ওয়েবে রূপান্তরিত করেন।

পূর্ববর্তী ট্রিগার পাথগুলি নিম্নলিখিত প্রয়োজনীয়তাগুলি পূরণ করে:

• বিজ্ঞাপন প্রযুক্তিবিদদের জন্য: অ্যাপ-টু-ওয়েব পাথ সক্ষম করার জন্য API কল এবং রিপোর্টিংয়ের আপডেট।
• অ্যাপ এবং ব্রাউজারের জন্য: ওয়েব অ্যাট্রিবিউশন সোর্স এবং ওয়েব ট্রিগারের নিবন্ধন অ্যান্ড্রয়েডে পাস করার ক্ষমতা।

এই ডকুমেন্টটি ব্যাখ্যা করে যে কীভাবে অ্যাট্রিবিউশন রিপোর্টিং API অ্যাপ-টু-ওয়েব, ওয়েব-টু-অ্যাপ এবং ওয়েব-টু-ওয়েব ট্রিগার পাথগুলিকে সমর্থন করার জন্য প্রসারিত করা হয়েছে। এটি বিজ্ঞাপন প্রযুক্তি এবং অ্যাপগুলিকে এই ট্রিগার পাথগুলিকে সমর্থন করার প্রয়োজনীয়তা পূরণ করার জন্য যে পরিবর্তনগুলি করতে হবে তাও বর্ণনা করে।

অ্যাট্রিবিউশন রিপোর্টিং API-তে অ্যাক্সেস পান

অ্যাট্রিবিউশন রিপোর্টিং API অ্যাক্সেস করার জন্য বিজ্ঞাপন প্রযুক্তি প্ল্যাটফর্মগুলিকে নথিভুক্ত করতে হবে, আরও তথ্যের জন্য প্রাইভেসি স্যান্ডবক্স অ্যাকাউন্টের জন্য নথিভুক্ত করুন দেখুন।

তালিকাভুক্তি প্রক্রিয়া চূড়ান্ত হয়ে গেলে, যদি কোনও অ-নথিভুক্ত নিবন্ধন কল আসে তবে API নিবন্ধনটি বাতিল করে দেবে।

নথিভুক্ত করার সময়, বিজ্ঞাপন প্রযুক্তি প্ল্যাটফর্মগুলিকে নিশ্চিত করতে হবে যে তারা সমস্ত সার্ভার URL দিয়ে নথিভুক্ত করছে যা তারা অ্যাপ এবং ওয়েব জুড়ে অ্যাট্রিবিউশন সোর্স এবং ট্রিগার নিবন্ধনের জন্য ব্যবহার করতে পারে। একাধিক সার্ভার নিবন্ধন URL সমর্থিত, কিন্তু শুধুমাত্র একটি রিপোর্টিং অরিজিন সমর্থিত। এই রিপোর্টিং অরিজিনটি সার্ভার নিবন্ধন URLগুলির একটির ডোমেন থেকে নেওয়া হয়েছে।

বিজ্ঞাপন প্রযুক্তিবিদদের জন্য পরিবর্তন

এই বিভাগে অ্যাট্রিবিউশন রিপোর্টিং API ব্যবহার করে বিজ্ঞাপন প্রযুক্তিবিদদের জন্য পরিবর্তনগুলি নিয়ে আলোচনা করা হয়েছে।

নিবন্ধন এবং অ্যাট্রিবিউশনে পরিবর্তন

একটি অ্যাট্রিবিউশন সোর্স নিবন্ধন করার সময়, বিজ্ঞাপন প্রযুক্তিবিদরা একটি গন্তব্য ক্ষেত্র নির্দিষ্ট করে যা অ্যাপ প্যাকেজের নাম যেখানে ট্রিগার ইভেন্টটি ঘটে। অ্যাপ-টু-ওয়েব পরিমাপ সক্ষম করতে, আমরা একটি অ্যাপ গন্তব্য ক্ষেত্র (অ্যাপ প্যাকেজের নাম) এবং একটি ওয়েব গন্তব্য ক্ষেত্র (eTLD+1) সমর্থন করার পরিকল্পনা করছি।

ওয়েব অ্যাট্রিবিউশন সোর্স বা ট্রিগার নিবন্ধন করার সময়, API পুনঃনির্দেশনা সমর্থন করে না কারণ ওয়েব কন্টেন্ট হোস্ট করা প্রতিটি অ্যাপের নিজস্ব অনুমতি মডেল থাকতে পারে। প্রতিটি অ্যাপ পুনঃনির্দেশনা অনুসরণ করার জন্য (যদি সমর্থিত হয়) এবং প্রতিটি পুনঃনির্দেশনা হপের জন্য ওয়েব প্রসঙ্গ API কল করার জন্য দায়ী।

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

অ্যাপ এবং ওয়েব রিপোর্ট গ্রহণ করুন

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

• ইভেন্ট-স্তরের প্রতিবেদনের জন্য, আমরা একটি গন্তব্য ক্ষেত্র সমর্থন করব যা নির্দিষ্ট করে যে ট্রিগারটি ওয়েবে ঘটেছে (গন্তব্য একটি eTLD+1) নাকি অ্যাপে (গন্তব্য একটি অ্যাপ প্যাকেজের নাম)।
• সমষ্টিগত প্রতিবেদনের জন্য, গন্তব্যস্থল স্পষ্ট টেক্সটে পাঠানো হয়।

ওয়েব-টু-ওয়েব পরিমাপের প্রভাব

অ্যাপগুলি কখন অ্যাট্রিবিউশন রিপোর্টিং API-তে নিবন্ধন পাস করবে তা বেছে নেয়। এখানে বেশ কয়েকটি বিবেচনা রয়েছে:

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

নিম্নলিখিত উদাহরণটি দেখায় যে ব্রাউজার অ্যাপগুলি কীভাবে অ্যাট্রিবিউশন রিপোর্টিং API-এর সাথে কাজ করতে পারে যাতে ব্যবহারকারী যখন ব্রাউজার অ্যাপ এবং নন-ব্রাউজার অ্যাপ উভয়ের বিজ্ঞাপনে ক্লিক করেন তখন সঠিক পরিমাপ প্রদান করা যায়:

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

ওয়েবভিউ থেকে অ্যাট্রিবিউশন সোর্স এবং ট্রিগার নিবন্ধন করুন

যদি অ্যাপটি Android বিজ্ঞাপনের পরিবর্তে ওয়েব কন্টেন্ট দেখানোর জন্য WebView ব্যবহার করে, তাহলে অ্যাপটি registerWebSource() এর জন্য allowlist-এ যোগদানের জন্য আবেদন করতে পারে এবং অ্যাপ প্যাকেজের নামের পরিবর্তে অ্যাট্রিবিউশন সোর্সের সাথে যুক্ত ওয়েবসাইটের শীর্ষ-স্তরের উৎস প্রদান করতে পারে।

ব্রাউজারের মতো, WebView ট্রিগার রেজিস্ট্রেশনের জন্য registerWebTrigger() সমর্থন করে, যা ট্রিগারটিকে শীর্ষ-স্তরের অরিজিনের সাথে যুক্ত করে। অ্যাপ ট্রিগার নিবন্ধনের জন্য WebView-এর কোনও সমর্থন নেই; যদি আপনার কাছে এর জন্য কোনও ব্যবহারের কেস থাকে তবে যোগাযোগ করুন । WebView দ্বারা সমর্থিত সংমিশ্রণের সম্পূর্ণ তালিকার জন্য, WebView থেকে Attribution source এবং trigger registration দেখুন।

ব্রাউজারগুলির বিপরীতে, WebView শুধুমাত্র Attribution-Reporting-Eligible হেডারের মধ্যে OS-এর সাথে নিবন্ধন সমর্থন করে যদি Android-এর Attribution Reporting API উপলব্ধ থাকে। যদি Android-এর Attribution Reporting API অনুপলব্ধ থাকে, তাহলে WebView একটি Attribution-Reporting-Eligible হেডার সেট করে না এবং কোনও নিবন্ধন করা হয় না।

OS ব্যবহার করে একটি অ্যাট্রিবিউশন সোর্স / ট্রিগার নিবন্ধন করতে:

• বিজ্ঞাপন প্রযুক্তিবিদদের Attribution-Reporting-Register-OS-Source হেডার ব্যবহার করে সোর্স রেজিস্ট্রেশনের প্রতিক্রিয়া জানাতে হবে, যা WebView থেকে registerSource() অথবা registerWebSource() এ একটি সেকেন্ডারি API কল শুরু করে।
• বিজ্ঞাপন প্রযুক্তিবিদরা Attribution-Reporting-Register-OS-Trigger হেডার ব্যবহার করে ট্রিগার রেজিস্ট্রেশনের প্রতিক্রিয়া জানাতে পারেন, যা WebView থেকে registerWebTrigger() অথবা registerTrigger() এ একটি সেকেন্ডারি API কল শুরু করে।

মনে রাখবেন যে যদি প্রতিক্রিয়াটিতে পূর্ববর্তী হেডারগুলি অন্তর্ভুক্ত না থাকে, অথবা এতে Attribution-Reporting-Register-Source / Attribution-Reporting-Register-Trigger হেডারগুলিও অন্তর্ভুক্ত থাকে যদিও ওয়েব সমর্থিত নয়, তাহলে সম্পূর্ণ নিবন্ধন ব্যর্থ হবে।

WebView registerSource() / registerWebSource() এবং registerTrigger() / registerWebTrigger() ব্যবহার করবে কিনা (এবং এই আচরণ কীভাবে পরিবর্তন করবেন) তার বিস্তারিত জানতে , WebView থেকে Attribution source এবং trigger registration দেখুন।

ট্রানজিশনাল ডিবাগিং রিপোর্ট

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

একটি মাত্র অ্যাপের মধ্যে (যেমন, একই ব্রাউজার অ্যাপের মধ্যে) ওয়েব-টু-ওয়েব অ্যাট্রিবিউশনের ক্ষেত্রে, অ্যাট্রিবিউশন-সাকসেস এবং ভার্বোজ রিপোর্ট শুধুমাত্র তখনই পাওয়া যায় যখন থার্ড-পার্টি কুকিজ উপলব্ধ থাকে, এবং বিজ্ঞাপন আইডির উপলব্ধতার উপর ভিত্তি করে নয়।

অ্যাপ-টু-ওয়েব, ওয়েব-টু-অ্যাপ এবং ওয়েব-টু-ওয়েব ক্রস-অ্যাপ অ্যাট্রিবিউশনের জন্য, যদি অ্যাপ সাইডে AdID উপলব্ধ থাকে এবং বিজ্ঞাপন প্রযুক্তিবিদ ওয়েব সাইডে একই (সঠিক) AdID পাস করতে পারেন তবে অ্যাট্রিবিউশন-সাকসেস এবং ভার্বোজ রিপোর্ট পাওয়া যায়।

পরবর্তী অ্যাপ-টু-ওয়েব উদাহরণে, উৎসটি একটি প্রকাশক অ্যাপে ঘটে, কিন্তু ট্রিগারটি একটি ব্রাউজার অ্যাপের ভিতরে একটি বিজ্ঞাপনদাতার সাইটে ঘটে।

অ্যাপ-টু-ওয়েবের জন্য অ্যাট্রিবিউশন-সাকসেস ডিবাগিং রিপোর্ট সক্ষম করতে, নিম্নলিখিত শর্তগুলি পূরণ করতে হবে:

• ব্যবহারকারী অবশ্যই বিজ্ঞাপন আইডি ব্যবহার করে ব্যক্তিগতকরণ থেকে বেরিয়ে আসবেন না।
• প্রকাশক অ্যাপে AdID অনুমতি ঘোষণা করা থাকতে হবে
• বিজ্ঞাপন প্রযুক্তিবিদকে ট্রিগার রেজিস্ট্রেশনে AdID মান পাস করতে হবে (ওয়েব প্রসঙ্গ থেকে)

অ্যাপ-টু-ওয়েবের জন্য ভার্বোজ ডিবাগিং রিপোর্ট সক্ষম করতে:

• সোর্স ভার্বোস রিপোর্ট শুধুমাত্র প্রকাশকের পক্ষের অনুমতির উপর নির্ভর করে। সোর্স ভার্বোস রিপোর্ট পাঠানোর জন্য, ব্যবহারকারীকে অবশ্যই AdID ব্যক্তিগতকরণ থেকে বেরিয়ে আসতে হবে না এবং প্রকাশক অ্যাপটিকে অবশ্যই AdID অনুমতি ঘোষণা করতে হবে।
• ট্রিগার ভার্বোজ রিপোর্টগুলি শুধুমাত্র ট্রিগার সাইডের (এই উদাহরণে, ওয়েব) অনুমতির উপর নির্ভর করে। ট্রিগার ভার্বোজ রিপোর্ট পাঠানোর জন্য ব্রাউজারে তৃতীয় পক্ষের কুকিজ উপলব্ধ থাকতে হবে।
• ঐচ্ছিকভাবে একটি source_debug_key অন্তর্ভুক্ত করতে পারে এমন ট্রিগার ভার্বোজ রিপোর্টের জন্য, প্রকাশক অ্যাপে বিজ্ঞাপন আইডি উপলব্ধ থাকলে source_debug_key অন্তর্ভুক্ত করা হয়।

মনে রাখবেন যে সব ক্ষেত্রেই, বিজ্ঞাপন প্রযুক্তিবিদকে সোর্স এবং ট্রিগার রেজিস্ট্রেশন হেডারে debug_reporting অভিধান ফিল্ড ব্যবহার করে ভার্বোজ ডিবাগিং রিপোর্ট গ্রহণ করার বিকল্প বেছে নিতে হবে।

অ্যাপের জন্য পরিবর্তন

আমরা নতুন ওয়েব কনটেক্সট এপিআই কল ব্যবহার করে অ্যান্ড্রয়েডে ওয়েব অ্যাট্রিবিউশন সোর্স এবং ওয়েব ট্রিগারের নিবন্ধন অ্যাট্রিবিউশন রিপোর্টিং এপিআই-তে পাস করার অনুমতি দিয়ে অ্যাপ এবং ওয়েব সারফেস জুড়ে অ্যাট্রিবিউশন সমর্থন করব।

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

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

• Attribution-Reporting-Eligible সম্প্রচারগুলি অ্যাট্রিবিউশনের জন্য OS-স্তরের সমর্থন উপলব্ধ কিনা তা নির্দেশ করে। এই ক্ষেত্রে, হেডারটি নির্দেশ করে যে Android এর অ্যাট্রিবিউশন রিপোর্টিং API উপলব্ধ কিনা।
• যদি উপলব্ধ থাকে, তাহলে বিজ্ঞাপন প্রযুক্তিবিদরা ঐচ্ছিকভাবে Attribution-Reporting-Register-OS-Source ব্যবহার করে প্রতিক্রিয়া জানাতে পারেন, যা ব্রাউজার অ্যাপ থেকে registerWebSource() এ একটি সেকেন্ডারি API কল শুরু করে।
• বিজ্ঞাপন প্রযুক্তিবিদরা Attribution-Reporting-Register-OS-Trigger হেডার ব্যবহার করে ট্রিগার রেজিস্ট্রেশনের প্রতিক্রিয়া জানাতে পারেন, যা ব্রাউজার অ্যাপ থেকে registerWebTrigger() এ একটি সেকেন্ডারি API কল শুরু করে।

অ্যাট্রিবিউশন সোর্স রেজিস্ট্রেশন

একটি অ্যাট্রিবিউশন সোর্স নিবন্ধন করার সময়, অ্যাপগুলি registerWebSource() কল করতে পারে, যা নিম্নলিখিত প্যারামিটারগুলি আশা করে:

• অ্যাট্রিবিউশন সোর্স URI : প্ল্যাটফর্মটি এই তালিকার প্রতিটি URI-কে অ্যাট্রিবিউশন সোর্সের সাথে সম্পর্কিত মেটাডেটা আনার জন্য একটি অনুরোধ জারি করে।
  
  প্রতিটি URI-এর সাথে একটি বুলিয়ান ডিবাগ ফ্ল্যাগ থাকা উচিত যা নির্দেশ করে যে প্রযুক্তিবিদদের দ্বারা প্রদত্ত ডিবাগ কীগুলি রিপোর্টে অন্তর্ভুক্ত করা উচিত কিনা।
• ইনপুট ইভেন্ট : হয় একটি InputEvent অবজেক্ট (একটি ক্লিক ইভেন্টের জন্য) অথবা null (একটি ভিউ ইভেন্টের জন্য)
• উৎসের উৎস : উৎসটি যেখান থেকে এসেছে (প্রকাশকের ওয়েবসাইট)।
• অপারেটিং সিস্টেমের গন্তব্য : একটি অ্যাপ প্যাকেজের নাম যেখানে ট্রিগার ইভেন্টটি ঘটে।
• ওয়েব গন্তব্য : একটি eTLD+1 যেখানে ট্রিগার ইভেন্ট ঘটে।
• যাচাইকৃত গন্তব্য : ব্যবহারকারীর ক্লিকে নেভিগেশনের জন্য ব্যবহৃত OS বা ওয়েব গন্তব্য URI উদ্দেশ্য।

যখন API অ্যাট্রিবিউশন সোর্স URI-তে কোনও অনুরোধ করে, তখন বিজ্ঞাপন প্রযুক্তিবিদকে একটি HTTP হেডার, Attribution-Reporting-Register-Source এ অ্যাট্রিবিউশন সোর্স মেটাডেটা দিয়ে প্রতিক্রিয়া জানাতে হবে। এই হেডারটি অ্যাপ-টু-অ্যাপ অ্যাট্রিবিউশন সোর্স রেজিস্ট্রেশনের মতো একই ক্ষেত্র ব্যবহার করে, কিছু পরিবর্তন সহ:

• API বিজ্ঞাপন প্রযুক্তিবিদদের দ্বারা নির্দিষ্ট করা গন্তব্যগুলিকে অ্যাপ দ্বারা নির্দিষ্ট করা গন্তব্যগুলির সাথে যাচাই করে। যদি গন্তব্যগুলি ভিন্ন হয়, তাহলে API অ্যাট্রিবিউশন সোর্স রেজিস্ট্রেশন বাতিল করে দেয়।
  
  ওয়েব কনটেক্সট এপিআই কল করার আগে অ্যাপগুলি ওয়েব গন্তব্যগুলিকে যাচাই করবে বলে আশা করা হচ্ছে। ক্লিকের জন্য, অ্যাপগুলিকে পরীক্ষা করা উচিত যে নির্দিষ্ট গন্তব্যটি ব্যবহারকারী যে গন্তব্যে নেভিগেট করছেন তার সাথে মেলে কিনা।
• API Attribution-Reporting-Redirects এ প্রদত্ত যেকোনো রিডাইরেক্ট URI উপেক্ষা করে। অ্যাপগুলিকে নিজেরাই রিডাইরেক্ট অনুসরণ করতে হবে এবং প্রতিটি রিডাইরেক্টের জন্য registerWebSource() কল করতে হবে, যাতে তারা প্রয়োজন অনুসারে তাদের নিজস্ব অনুমতি নীতি প্রয়োগ করতে পারে।

registerWebSource() কল করার জন্য অ্যাপগুলিকে অবশ্যই একটি allowlist-এ যোগদান করতে হবে। allowlist-এ যোগদানের জন্য এই ফর্মটি পূরণ করুন । allowlist-এর উদ্দেশ্য হল ওয়েব কনটেক্সটের জন্য আস্থা স্থাপনের ক্ষেত্রে গোপনীয়তার বিবেচনাগুলি হ্রাস করা।

ট্রিগার (রূপান্তর) নিবন্ধন

ট্রিগার রেজিস্ট্রেশনের সময়, অ্যাপগুলি registerWebTrigger() কল করতে পারে, যা নিম্নলিখিত পরামিতিগুলি আশা করে:

• ট্রিগার URI : প্ল্যাটফর্মটি এই তালিকার প্রতিটি URI-কে ট্রিগারের সাথে সম্পর্কিত মেটাডেটা আনার জন্য একটি অনুরোধ জারি করে।
• গন্তব্যস্থল : যেখান থেকে ট্রিগারটি ঘটেছে (বিজ্ঞাপনদাতার ওয়েবসাইট)

WebView থেকে অ্যাট্রিবিউশন সোর্স এবং ট্রিগার রেজিস্ট্রেশন

ডিফল্টরূপে, WebView registerSource() এবং registerWebTrigger() ব্যবহার করবে। এটি অ্যাপের সাথে সোর্স সংযুক্ত করে এবং ট্রিগার ঘটলে WebView-এর শীর্ষ-স্তরের উৎপত্তির সাথে ট্রিগার করে।

যদি কোন অ্যাপের ভিন্ন আচরণের প্রয়োজন হয় (যেমন WebView-এ ওয়েব কন্টেন্ট হোস্ট করে), তাহলে তাদের androidx.webkit.WebViewSettingsCompat ক্লাসে setAttributionRegistrationBehavior পদ্ধতি ব্যবহার করতে হবে। এই পদ্ধতিটি WebView কে registerWebSource() অথবা registerSource() এবং registerWebTrigger() অথবা registerTrigger() কল করা উচিত কিনা তা নির্দিষ্ট করবে।

setAttributionRegistrationBehavior এর জন্য উপলব্ধ বিকল্পগুলি হল:

গোপনীয়তা এবং নিরাপত্তা বিবেচনা

এই বিভাগে অ্যাট্রিবিউশন রিপোর্টিং API ব্যবহার করে এমন অ্যাপগুলির গোপনীয়তা এবং সুরক্ষা বিবেচনা নিয়ে আলোচনা করা হয়েছে।

প্রতিবেদনে প্রয়োগ করা গোপনীয়তা-সংরক্ষণ ব্যবস্থার উপর প্রভাব

মূল নকশা প্রস্তাবে বর্ণিত হিসাবে, API প্রতিবেদনগুলিতে গোপনীয়তা-সংরক্ষণের হারের সীমা প্রয়োগ করে । কিছু সীমা উৎস এবং গন্তব্য অ্যাপগুলিতে বিভক্ত করা হয়। যখন একটি ওয়েব অ্যাট্রিবিউশন সোর্স বা ট্রিগার নিবন্ধিত হয়, তখন হারের সীমা অ্যাপের পরিবর্তে উৎস বা গন্তব্য সাইট দ্বারা বিভক্ত করা হয়।

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

ওয়েব প্রসঙ্গের জন্য আস্থা স্থাপন করুন

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

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

এটি কমাতে, আমরা কোন ব্রাউজার বা অ্যাপগুলি registerWebSource() কল করতে পারে তা সীমাবদ্ধ করব, যেগুলি প্রমাণ করে যে নিবন্ধনে ব্যবহৃত সোর্স সাইটটি ব্যবহারকারীকে দেখানো প্রকৃত সাইটের প্রতিনিধিত্ব করে। registerWebSource() কল করার জন্য allowlist-এ যোগদান করতে Web-to-App Attribution Reporting রেজিস্ট্রেশন ফর্মটি পূরণ করুন।

যেকোনো অ্যাপ registerWebTrigger() কল করতে পারে কারণ ট্রিগার সাইডে গোপনীয়তা এবং নিরাপত্তার বিষয়গুলি সোর্স-সাইড যোগসাজশ ছাড়া প্রযোজ্য নয়।

ব্যবহারকারীর নিয়ন্ত্রণ

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

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

ভবিষ্যতের বিবেচনা এবং খোলা প্রশ্ন

অ্যাট্রিবিউশন রিপোর্টিং API-এর জন্য অ্যাপ-টু-ওয়েব ইন্টারঅপারেবিলিটি নিয়ে কাজ চলছে। আমরা কয়েকটি ধারণার উপর সম্প্রদায়ের কাছ থেকে প্রতিক্রিয়া জানতে চাই:

1. একটি Android Privacy Sandbox সমর্থিত ডিভাইসে, Android Attribution Reporting API-এর মাধ্যমে আপনি কীভাবে ব্রাউজার পরিমাপ সমাধান ব্যবহার করবেন? আপনি কি সবকিছু Android-এ স্থানান্তর করতে পছন্দ করবেন?
2. প্রতিটি অ্যাট্রিবিউশন সোর্স এবং ট্রিগারের জন্য সম্ভাব্যভাবে ২টি পিং পাওয়ার বিষয়ে কি কোনও উদ্বেগ আছে, একটি ব্রাউজার বা অ্যাপ থেকে এবং একটি অ্যাট্রিবিউশন রিপোর্টিং API থেকে?
3. বিভিন্ন API তে ডিবাগিং আপনার জন্য সহজ করে তুলতে আমরা কীভাবে সাহায্য করতে পারি?
4. প্রস্তাবটিতে অ্যাপ এবং ওয়েব গন্তব্যস্থলগুলি অনুমোদিত কিনা তা যাচাইকরণ অন্তর্ভুক্ত নেই। ভবিষ্যতে, আমরা ডিজিটাল অ্যাসেট লিঙ্ক ব্যবহার করে অ্যাসোসিয়েশনগুলি পরীক্ষা করে এই গন্তব্যস্থলগুলিকে যাচাই করতে সক্ষম হতে পারি। এটি কি আপনার ব্যবহারের কোনও ক্ষেত্রে ব্লক করবে? এই যাচাইকরণের জন্য ডিজিটাল অ্যাসেট লিঙ্ক ব্যবহার করা কি যুক্তিসঙ্গত?
5. একটি অ্যাট্রিবিউশন সোর্স নিবন্ধন করার সময়, আপনাকে অবশ্যই একটি গন্তব্য নির্দিষ্ট করতে হবে। ওয়েব-টু-অ্যাপের ক্ষেত্রে, আপনি একটি অ্যাপ লিঙ্ক নির্দিষ্ট করতে চাইতে পারেন। এই অ্যাপ লিঙ্কটি নির্দিষ্ট করার জন্য আপনি কোন ফর্ম্যাটগুলি ব্যবহার করেন?
6. অ্যাপ-টু-ওয়েব অ্যাট্রিবিউশন সোর্স নিবন্ধন করার সময়, সেই সোর্স ইভেন্টটি অ্যান্ড্রয়েড অ্যাট্রিবিউশন রিপোর্টিং API-এর মাধ্যমে অ্যাপ থেকে নিবন্ধিত হতে হবে। উদাহরণস্বরূপ, যদি ব্যবহারকারী কোনও বিজ্ঞাপনে ক্লিক করেন এবং ক্লিকটি ব্রাউজার বা ব্রাউজারের কাস্টম ট্যাবে খোলা হয়, তাহলে সেই ক্লিক (সোর্স ইভেন্ট) ব্রাউজার প্রসঙ্গে নয় বরং অ্যাপ থেকে নিবন্ধিত হওয়া উচিত। যদি আপনার এই বিষয়ে কোনও উদ্বেগ থাকে, অথবা যদি এমন কোনও ব্যবহারের ঘটনা থাকে যা এই সমস্যায় অন্তর্ভুক্ত বিভাগগুলির মধ্যে পড়ে না যেখানে সমর্থিত প্রবাহ বর্ণনা করা হয়েছে , তাহলে যোগাযোগ করুন।

{% অক্ষরে অক্ষরে %} {% এন্ডভারব্যাটিম %}

আপনার জন্য প্রস্তাবিত

• দ্রষ্টব্য: জাভাস্ক্রিপ্ট বন্ধ থাকলে লিঙ্ক টেক্সট প্রদর্শিত হয়।
• অ্যাট্রিবিউশন রিপোর্টিং
• অ্যাট্রিবিউশন রিপোর্টিং API ডেভেলপারের নির্দেশিকা
• রিলিজ নোট