অ্যাট্রিবিউশন রিপোর্টিং এপিআই ক্রস ওয়েব এবং অ্যাপ ইমপ্লিমেন্টেশন গাইড

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

এই নির্দেশিকাটি আপনাকে শেখাবে কিভাবে ক্রস অ্যাপ এবং ওয়েব অ্যাট্রিবিউশন সেট আপ করতে হয়।

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

অ্যান্ড্রয়েড ওএস দিয়ে উৎস এবং ট্রিগার নিবন্ধন করুন

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

বিজ্ঞাপন প্রযুক্তিবিদকে সিদ্ধান্ত নিতে হবে যে ওয়েব সোর্স বা ওয়েব ট্রিগারটি ব্রাউজারে নিবন্ধন করবেন নাকি অপারেটিং সিস্টেমে।

শুধুমাত্র ওয়েব প্রচারণার জন্য, বিজ্ঞাপন প্রযুক্তিবিদরা Chrome এর অ্যাট্রিবিউশন রিপোর্টিং API-এর মাধ্যমে উৎস এবং ট্রিগার উভয়ই নিবন্ধন করতে পারেন অথবা উভয়ই OS-এ অর্পণ করতে পারেন। শুধুমাত্র ওয়েব প্রচারণার জন্য যেখানে WebView-এ উৎস বা ট্রিগার উভয়ই ঘটতে পারে, বিজ্ঞাপন প্রযুক্তিবিদদের অবশ্যই উৎস এবং ট্রিগার উভয়ই OS-এ অর্পণ করতে হবে। আরও তথ্যের জন্য WebViews বিভাগটি দেখুন।
ডুপ্লিকেট অ্যাট্রিবিউশন রিপোর্ট তৈরি এড়াতে বিজ্ঞাপন প্রযুক্তিবিদদের Chrome এবং Android API উভয়ের সাথে একই সাথে সোর্স এবং ট্রিগার নিবন্ধন করা এড়িয়ে চলা উচিত।
ব্রাউজার এবং অপারেটিং সিস্টেমের জন্য অ্যাট্রিবিউশন আলাদাভাবে ঘটে। যদি কোনও উৎস ব্রাউজারে নিবন্ধিত থাকে কিন্তু ট্রিগারটি অপারেটিং সিস্টেমে নিবন্ধিত থাকে, তাহলে দুটিকে মেলানো যাবে না এবং বিপরীতভাবে।
যেসব উৎসের ফলে অ্যাপ অথবা ওয়েব ট্রিগার হতে পারে, সেসব ক্ষেত্রে বিজ্ঞাপন প্রযুক্তিবিদদের ওয়েব উৎস এবং নিবন্ধন ট্রিগার করে Android Attribution Reporting API-তে অর্পণ করা অত্যন্ত বাঞ্ছনীয়।
অ্যাপ ভিত্তিক উৎস থেকে চালিত ট্রিগারগুলির জন্য, বিজ্ঞাপন প্রযুক্তিবিদরা ওয়েব ট্রিগার নিবন্ধনটি Android অ্যাট্রিবিউশন রিপোর্টিং API-তে অর্পণ করতে পারেন।
যেসব প্রচারণায় সোর্স এবং ট্রিগার উভয়ই একটি অ্যাপে ঘটে, তাদের জন্য ওএস অ্যাট্রিবিউশন রিপোর্টিং এপিআই-তে নিবন্ধিত হতে হবে।

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

কিছু প্রচারণার ক্ষেত্রে, উৎসটি একটি অ্যাপে ঘটতে পারে যখন ট্রিগারটি একই ডিভাইসে মোবাইল ব্রাউজারে একটি ওয়েবসাইটে ঘটবে।

উদাহরণ

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

অ্যাপ সোর্স নিবন্ধন:

ডেইলি নিউজ অ্যান্ড্রয়েড অ্যাপের বিজ্ঞাপন প্রযুক্তি SDK registerSource() ব্যবহার করে ক্লিক নিবন্ধন করে।
Android-এর Attribution Reporting API registerSource() এ প্রদত্ত বিজ্ঞাপন প্রযুক্তি সার্ভার URL-এ একটি অনুরোধ পাঠায়।
বিজ্ঞাপন প্রযুক্তি সার্ভার সোর্স রেজিস্ট্রেশন সম্পূর্ণ করার জন্য অ্যাট্রিবিউশন-রিপোর্টিং-রেজিস্টার-সোর্স হেডার ব্যবহার করে প্রতিক্রিয়া জানায়।

ওয়েব ট্রিগার নিবন্ধন:

বিজ্ঞাপন প্রযুক্তিবিদ একটি ট্রিগার নিবন্ধন করেন এবং অ্যাট্রিবিউশন রিপোর্টিং API-তে OS এর উপলব্ধতা পরীক্ষা করেন।
ওয়েব ARA কোন প্ল্যাটফর্মটি সমর্থিত সে সম্পর্কে তথ্য প্রদান করে
OS-Trigger হেডার ওয়েব ARA API কে OS ARA API registerWebTrigger() ফাংশনটি কল করতে বলে।
registerWebTrigger() কলটি গোপনে করা হয় এবং ডেভেলপারকে সরাসরি OS দিয়ে registerWebTrigger() কল করার প্রয়োজন হয় না।
OS ARA দায়িত্ব নেয় এবং Attribution-Reporting-Register-OS-Trigger হেডার দ্বারা প্রদত্ত বিজ্ঞাপন প্রযুক্তি সার্ভার URL-এ একটি অনুরোধ পাঠায়।
বিজ্ঞাপন প্রযুক্তিবিদ OS API এর মাধ্যমে ট্রিগার নিবন্ধন সম্পন্ন করবেন।
OS ARA অ্যাপ<>অ্যাপ অ্যাট্রিবিউশনে প্রয়োগ করা একই যুক্তি অনুসারে অ্যাট্রিবিউশন সম্পাদন করবে এবং একই প্রতিবেদন পাঠাবে।

কর্মপ্রবাহ

নিম্নলিখিত ধাপগুলিতে কাজটি কীভাবে সম্পন্ন করবেন সে সম্পর্কে আরও বিশদ বিবরণ অন্তর্ভুক্ত রয়েছে:

অ্যাপের বিজ্ঞাপন প্রযুক্তিবিদ নিম্নলিখিত সমন্বয়গুলি সহ অ্যান্ড্রয়েডের অ্যাট্রিবিউশন রিপোর্টিং API-এর সাথে একটি উৎস নিবন্ধন করেন:
- একটি ওয়েবসাইটে রূপান্তরিত হওয়ার প্রত্যাশিত একটি অ্যাপ সোর্স নিবন্ধন করতে, Attribution-Reporting-Register-Source রেসপন্স হেডারে অ্যাপ ডেস্টিনেশনের পরিবর্তে একটি ওয়েব ডেস্টিনেশন (eTLD+1) অন্তর্ভুক্ত করা উচিত।
```
Attribution-Reporting-Register-Source: {
    "web_destination": "https://advertiser.example",
    ...
}
```
দ্রষ্টব্য: যেসব প্রচারণা ওয়েব অথবা অ্যাপ গন্তব্যে রূপান্তরিত হতে পারে, তাদের জন্য দ্বৈত গন্তব্যের বিভাগটি দেখুন।
- কিছু বিজ্ঞাপনদাতা 302 রিডাইরেক্ট চেইন ব্যবহার করে একাধিক পরিমাপ প্রদানকারী (যেমন, একটি তৃতীয় পক্ষের পরিমাপ সরঞ্জাম বা একটি বিশ্লেষণ সরঞ্জাম) ব্যবহার করতে পারেন। কিছু ক্ষেত্রে, অ্যাট্রিবিউশন রিপোর্টিং API ব্যাকগ্রাউন্ডে অ্যাট্রিবিউশন-রিপোর্টিং-রিডাইরেক্ট শিরোনামে নির্দিষ্ট পুনর্নির্দেশ পথ অনুসরণ করবে এবং একই সাথে 302 রিডাইরেক্ট পথটি বিদ্যমান নেভিগেশন অনুরোধগুলির জন্য অগ্রভাগে কার্যকর হবে। এই অনুরোধগুলি একই URL-এ যাবে এবং তৃতীয় পক্ষের পরিমাপ প্রদানকারী দ্বিগুণ গণনা নিবন্ধন করতে পারে। দ্বিগুণ গণনা নিবন্ধন প্রতিরোধ করতে, বিজ্ঞাপন প্রযুক্তিবিদরা পুনর্নির্দেশ আচরণ পরিবর্তন করে অ্যাট্রিবিউশন রিপোর্টিং API নিবন্ধনকে একটি বিকল্প কিন্তু নির্ধারক URL-এ পাঠাতে পারেন।
- এই আচরণটি সক্ষম করার জন্য, বিজ্ঞাপন প্রযুক্তিবিদদের নিবন্ধনের অনুরোধের জবাব দেওয়ার সময় একটি নতুন HTTP হেডার অন্তর্ভুক্ত করতে হবে:
  - হেডারটি হল Attribution-Reporting-Redirect-Config
  - হেডারের মান redirect-302-to-well-known হওয়া উচিত।
```
Attribution-Reporting-Redirect-Config: redirect-302-to-well-known
```
  দ্রষ্টব্য: এই হেডারের পরে পরবর্তী সকল পুনঃনির্দেশনায় .well-known পুনঃনির্দেশ URI এর পথের শুরুতে যুক্ত করা হবে।
- বাকি সোর্স রেজিস্ট্রেশন প্রক্রিয়াটি একটি স্ট্যান্ডার্ড অ্যাপ-টু-অ্যাপ সোর্স রেজিস্ট্রেশনের মতোই।
দ্রষ্টব্য: যদি আপনি অথবা প্রকাশনা অ্যাপটি কোনও অ্যান্ড্রয়েড অ্যাপে বিজ্ঞাপন দেখানোর জন্য ওয়েবভিউ ব্যবহার করেন, তাহলে ওয়েবভিউ- এর বিভাগটি দেখুন।
বিজ্ঞাপনদাতার ওয়েবসাইটের বিজ্ঞাপন প্রযুক্তিবিদ Chrome কে Android Attribution Reporting API-তে নিবন্ধন অর্পণ করতে বলে ট্রিগারটি নিবন্ধন করে:
- একবার একজন ব্যবহারকারী কোনও ওয়েবসাইটে রূপান্তর সম্পন্ন করলে, বিজ্ঞাপন প্রযুক্তিবিদ Chrome-এ ট্রিগারটি নিবন্ধন করার জন্য অনুরোধ করবেন।
  1. একটি ট্রিগার নিবন্ধনের অনুরোধ করতে একটি পিক্সেল অথবা fetch() অনুরোধ ব্যবহার করা যেতে পারে।
  2. ক্রোম Attribution-Reporting-Support রিকোয়েস্ট হেডারটি বিজ্ঞাপন প্রযুক্তিতে ফেরত পাঠায়। যদি Chrome ব্রাউজার এবং অ্যান্ড্রয়েড ডিভাইস উভয় ক্ষেত্রেই API সক্ষম করা থাকে, তাহলে হেডারটি os, web
```
Attribution-Reporting-Support: os, web
```
- এরপর বিজ্ঞাপন প্রযুক্তিবিদদের Chrome-কে Attribution-Reporting-Register-OS-Trigger হেডার ব্যবহার করে OS-এ ডেলিগেট করতে বলা উচিত যা:
  1. ক্রোমকে অপারেটিং সিস্টেমের কাছে নিবন্ধন অর্পণ করতে বলে।
  2. Chrome OS API ফাংশন registerWebTrigger() কল করে OS-এ নিবন্ধন অর্পণ করে।
    - registerWebTrigger() এর কলটি গোপনে করা হয়, বিজ্ঞাপন প্রযুক্তিবিদদের সরাসরি registerWebTrigger() কল করার প্রয়োজন হয় না।
  3. OS API ব্রাউজার থেকে প্রেরিত বিজ্ঞাপন প্রযুক্তি URI-তে একটি সেকেন্ডারি API কল শুরু করে।
```
Attribution-Reporting-Register-OS-Trigger: "https://adtech.example/register-trigger",
"https://other-adtech.example/register-trigger"
```
- কিছু ক্ষেত্রে Attribution-Reporting-Support হেডারটি অনুপলব্ধ থাকে এবং পাঠানো যায় না। যখন এটি ঘটে, তখনও বিজ্ঞাপন প্রযুক্তিবিদ Attribution-Reporting-Info হেডারটি অন্তর্ভুক্ত করে ট্রিগার নিবন্ধন পরিচালনা করার জন্য একটি পছন্দের প্ল্যাটফর্ম সেট করতে পারেন। কীটি হল preferred-platform এবং অনুমোদিত মানগুলি হল os এবং web । উপলব্ধ হলে ব্রাউজার পছন্দের প্ল্যাটফর্মটি ব্যবহার করবে এবং OS অনুপলব্ধ থাকলে ওয়েব প্ল্যাটফর্মে ফিরে যাবে।
দ্রষ্টব্য: সঠিক প্ল্যাটফর্ম নিবন্ধন সম্ভব কিনা তা যাচাই করার জন্য একটি পছন্দের প্ল্যাটফর্ম নির্দিষ্ট করার সময় ওয়েব নিবন্ধন তথ্য সম্বলিত Attribution-Reporting-Register-Trigger হেডার এবং OS নিবন্ধন তথ্য সম্বলিত Attribution-Reporting-Register-OS-Trigger হেডার উভয়ই ফেরত দেওয়া উচিত। OS এবং ওয়েব উভয় নিবন্ধনই প্রদান করতে হবে, যাতে পছন্দের প্ল্যাটফর্মটি উপলব্ধ না থাকলে, ফলব্যাক পদ্ধতির জন্য প্রয়োজনীয় তথ্য উপস্থিত থাকে।
```
Attribution-Reporting-Info: preferred-platform=os
```
- ট্রিগার রেজিস্ট্রেশন সম্পূর্ণ করার জন্য, বিজ্ঞাপন প্রযুক্তির এন্ডপয়েন্টকে রেসপন্স হেডার ব্যবহার করে অ্যান্ড্রয়েড অ্যাট্রিবিউশন রিপোর্টিং API অনুরোধের জবাব দিতে হবে।
```
Attribution-Reporting-Register-Trigger: {
    "event_trigger_data": [{"trigger_data":"1"}],
    "aggregatable_trigger_data": [
        {"key_piece":"0x400","source_keys":["campaignCounts"]},
        {"key_piece":"0xA80","source_keys":["geoValue"]}
    ],
    ...
}
```
- ট্রিগার রেজিস্ট্রেশনের বাকি অংশ একই রয়ে গেছে।

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

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

উদাহরণ

একজন ব্যবহারকারী তাদের অ্যান্ড্রয়েড ফোনে তাদের ক্রোম ব্রাউজারে একটি সাইট ব্রাউজ করছেন। তারা তাদের প্রিয় দোকানগুলির একটি থেকে একটি সোয়েটারের বিজ্ঞাপন দেখতে পান। তারা বিজ্ঞাপনটিতে ক্লিক করেন এবং তাদের ইতিমধ্যেই ডাউনলোড করা অ্যাপে নিয়ে যাওয়া হয়। যে ওয়েবসাইটে বিজ্ঞাপনটি পরিবেশিত হয়েছিল সেই ওয়েবসাইটের বিজ্ঞাপন প্রযুক্তিবিদ Chrome-এ অ্যাট্রিবিউশন রিপোর্টিং API ব্যবহার না করে Android অ্যাট্রিবিউশন রিপোর্টিং API-তে নিবন্ধন অর্পণ করার নির্দেশ দিয়ে ক্লিক সোর্সটি নিবন্ধন করেন। ব্যবহারকারী শপিং অ্যাপ থেকে সোয়েটারটি কিনেন। বিজ্ঞাপনদাতার অ্যাপের বিজ্ঞাপন প্রযুক্তিবিদ তারপর রূপান্তর ট্রিগারটিকে Android অ্যাট্রিবিউশন রিপোর্টিং API-এর সাথে নিবন্ধন করেন। OS-স্তরের অ্যাট্রিবিউশন রিপোর্টিং API ওয়েব সোর্স এবং অ্যাপ ট্রিগারের সাথে মেলাতে সক্ষম এবং প্রাসঙ্গিক প্রতিবেদন পাঠাতে সক্ষম।

ওয়েব সোর্স নিবন্ধন:

বিজ্ঞাপন প্রযুক্তিবিদ একটি উৎস নিবন্ধন করেন এবং অ্যাট্রিবিউশন রিপোর্টিং API-তে OS এর উপলব্ধতা পরীক্ষা করেন।
ওয়েব ARA কোন প্ল্যাটফর্মটি সমর্থিত সে সম্পর্কে তথ্য প্রদান করে
OS-Source হেডারটি ওয়েব ARA API কে OS ARA API registerWebSource() ফাংশনটি কল করতে বলে।
registerWebSource() এ কলটি গোপনে করা হয় এবং ডেভেলপারকে সরাসরি OS দিয়ে registerWebSource() এ কল করার প্রয়োজন হয় না।
OS ARA দায়িত্ব নেয় এবং Attribution-Reporting-Register-OS-Source হেডার দ্বারা প্রদত্ত বিজ্ঞাপন প্রযুক্তি সার্ভার URL-এ একটি অনুরোধ পাঠায়।
বিজ্ঞাপন প্রযুক্তিবিদ OS API এর মাধ্যমে উৎস নিবন্ধন সম্পন্ন করবেন।

অ্যাপ ট্রিগার নিবন্ধন:

পোশাকের দোকানের অ্যান্ড্রয়েড অ্যাপের বিজ্ঞাপন প্রযুক্তি SDK OS ARA-এর সাথে ট্রিগার নিবন্ধন করে।
Android-এর অ্যাট্রিবিউশন রিপোর্টিং API registerTrigger() এ প্রদত্ত বিজ্ঞাপন প্রযুক্তি সার্ভার URL-এ একটি অনুরোধ পাঠায়।
ট্রিগার রেজিস্ট্রেশন সম্পূর্ণ করার জন্য বিজ্ঞাপন প্রযুক্তি সার্ভার Attribution-Reporting-Register-Trigger হেডার ব্যবহার করে প্রতিক্রিয়া জানায়।
OS ARA অ্যাপ<>অ্যাপ অ্যাট্রিবিউশনে প্রয়োগ করা একই যুক্তি অনুসারে অ্যাট্রিবিউশন সম্পাদন করবে এবং একই প্রতিবেদন পাঠাবে।

কর্মপ্রবাহ

প্রকাশকের ওয়েবসাইটের বিজ্ঞাপন প্রযুক্তিবিদরা Chrome কে Android Attribution Reporting API-তে নিবন্ধন অর্পণ করার নির্দেশ দিয়ে উৎসটি নিবন্ধন করে:
- ওয়েব টু অ্যাপ ব্যবহারের ক্ষেত্রে, কোনও উৎস নিবন্ধন করার সময়, অ্যাট্রিবিউশন সোর্স প্যারামিটারটি সরাসরি নির্দিষ্ট করতে হবে, হয় attributionsrc ট্যাগ ব্যবহার করে অথবা JavaScript নিবন্ধন ব্যবহার করে।
- নিচের উদাহরণে সোর্স প্যারামিটার নির্দিষ্ট করার জন্য attributionsrc ট্যাগ ব্যবহার করা হয়েছে:
```
<img src="https://adtech.example/conversionpixel"
attributionsrc="https://adtech.example/register-source?purchase=12">
```
Chrome দ্বারা Attribution-Reporting-Support অনুরোধের হেডারটি বিজ্ঞাপন প্রযুক্তিতে ফেরত পাঠানো হয়। যদি Chrome ব্রাউজার এবং Android ডিভাইস উভয় ক্ষেত্রেই API সক্ষম করা থাকে, তাহলে হেডারটি os, web ফেরত দেবে।
```
Attribution-Reporting-Support: os, web
```
দ্রষ্টব্য: অ্যাপ এবং ওয়েব জুড়ে সফলভাবে পরিমাপ করার জন্য Android OS-এ অ্যাট্রিবিউশন রিপোর্টিং API সক্রিয় থাকতে হবে।
বিজ্ঞাপন প্রযুক্তিবিদদের Chrome-কে Attribution-Reporting-Register-OS-Source হেডার ব্যবহার করে OS-স্তরের API-তে ডেলিগেট করতে বলা উচিত যা:
1. ক্রোমকে অপারেটিং সিস্টেমের কাছে নিবন্ধন অর্পণ করতে বলে।
2. Chrome OS API ফাংশন registerWebSource() কল করে OS-এর কাছে নিবন্ধন অর্পণ করে।
3. registerWebSource() এর কলটি গোপনে করা হয়, বিজ্ঞাপন প্রযুক্তিবিদদের সরাসরি registerWebSource() কল করার প্রয়োজন হয় না।
4. OS API ব্রাউজার থেকে প্রেরিত বিজ্ঞাপন প্রযুক্তি URI-তে একটি সেকেন্ডারি API কল শুরু করে।
```
Attribution-Reporting-Register-OS-Source: "https://adtech.example/register-source"
```
- কিছু ক্ষেত্রে Attribution-Reporting-Support হেডারটি অনুপলব্ধ থাকে। যখন এটি ঘটে, তখনও বিজ্ঞাপন প্রযুক্তিবিদ Attribution-Reporting-Info হেডারটি অন্তর্ভুক্ত করে উৎস নিবন্ধন পরিচালনা করার জন্য একটি পছন্দের প্ল্যাটফর্ম সেট করতে পারেন। কীটি হল preferred-platform এবং অনুমোদিত মানগুলি হল os এবং web । উপলব্ধ থাকলে ব্রাউজার পছন্দের প্ল্যাটফর্মটি ব্যবহার করবে এবং OS অনুপলব্ধ থাকলে ওয়েব প্ল্যাটফর্মে ফিরে যাবে।
দ্রষ্টব্য: সঠিক প্ল্যাটফর্ম নিবন্ধন সম্ভব কিনা তা যাচাই করার জন্য একটি পছন্দের প্ল্যাটফর্ম নির্দিষ্ট করার সময় ওয়েব নিবন্ধন তথ্য সম্বলিত Attribution-Reporting-Register-Source হেডার এবং OS নিবন্ধন তথ্য সম্বলিত Attribution-Reporting-Register-OS-Source হেডার উভয়ই ফেরত দেওয়া উচিত। OS এবং ওয়েব উভয় নিবন্ধনই প্রদান করতে হবে, যাতে পছন্দের প্ল্যাটফর্মটি উপলব্ধ না থাকলে, ফলব্যাক পদ্ধতির জন্য প্রয়োজনীয় তথ্য উপস্থিত থাকে।
```
Attribution-Reporting-Info: preferred-platform=os
```
- সোর্স রেজিস্ট্রেশন সম্পূর্ণ করার জন্য, বিজ্ঞাপন প্রযুক্তির এন্ডপয়েন্টকে Android অ্যাট্রিবিউশন রিপোর্টিং API অনুরোধের প্রতিক্রিয়া হেডার Attribution-Reporting-Register-Source দিয়ে জানাতে হবে। প্রতিক্রিয়াটিতে গন্তব্য ক্ষেত্রে একটি অ্যাপ গন্তব্যও উল্লেখ করতে হবে।
```
Attribution-Reporting-Register-Source: {
    "source_event_id":"123001",
    "destination":"android-app://com.example.advertiser",
    ...
}
```
- সোর্স রেজিস্ট্রেশনের জন্য রিডাইরেক্ট সমর্থন করার জন্য, Chrome রিডাইরেক্টগুলি অনুসরণ করবে এবং প্রতিটি রিডাইরেক্ট হপের জন্য ওয়েব কনটেক্সট API গুলিকে কল করবে।
- উৎস নিবন্ধনের বাকি অংশ একই রয়ে গেছে।
বিজ্ঞাপনদাতার অ্যাপের বিজ্ঞাপন প্রযুক্তিবিদ Android Attribution Reporting API-এর মাধ্যমে একটি ট্রিগার নিবন্ধন করেন:
- অ্যাপগুলিতে ঘটে যাওয়া ট্রিগারগুলির জন্য, অ্যাপগুলি স্বাভাবিকভাবে Android অ্যাট্রিবিউশন রিপোর্টিং API ব্যবহার করে ট্রিগারগুলি নিবন্ধন করে ।

যেসব প্রচারণায় অ্যাপ এবং ওয়েব উভয় সম্ভাব্য গন্তব্যস্থল রয়েছে

দ্বৈত গন্তব্য স্থাপন করুন
- কিছু প্রচারণা বিজ্ঞাপনদাতার অ্যাপে অথবা বিজ্ঞাপনদাতার ওয়েব পৃষ্ঠায় রূপান্তর করার জন্য সেট আপ করা হতে পারে, যা বিভিন্ন বিষয়ের উপর নির্ভর করে, যেমন ব্যবহারকারী অ্যাপটি ইনস্টল করেছেন কিনা।
- এই ক্ষেত্রে, যেখানেই পাওয়া যায় সেখানে সোর্স রেজিস্ট্রেশনটি অর্পণ করার পরামর্শ দেওয়া হয় যাতে ট্রিগারটি যেখানেই ঘটুক না কেন, সোর্সটি সঠিকভাবে নির্ধারণ করা যায়। OS-এর সাথে সোর্স নিবন্ধন করার সময়, সংশ্লিষ্ট প্যারামিটারে একটি অ্যাপ এবং ওয়েব গন্তব্য উভয়ই নির্দিষ্ট করা যেতে পারে।
- অ্যাপের গন্তব্য destination ক্ষেত্রে থাকা উচিত
- ওয়েব গন্তব্য web_destination ক্ষেত্রে থাকা উচিত
- Chrome ডেভেলপারদের মনে রাখা উচিত যে OS Attribution Reporting API-এর destination ক্ষেত্রটি একটি অ্যাপ প্যাকেজ হওয়া উচিত, URL নয়।
```
Attribution-Reporting-Register-Source: {
    "source_event_id":"123001",
    "destination":"android-app://com.example.advertiser",
    "web_destination": "https://example.advertiser"
    ...
}
```
- মসৃণ প্রতিবেদনের পরবর্তী অংশে ব্যাখ্যা করা হবে যে দ্বৈত গন্তব্য ব্যবহার কীভাবে আপনার প্রতিবেদনের শব্দের উপর প্রভাব ফেলতে পারে।
দ্বৈত গন্তব্য উৎসের জন্য ইভেন্ট-স্তরের প্রতিবেদনে শব্দ কমাতে মোটা প্রতিবেদন ব্যবহার করুন:
- যদি সোর্স রেজিস্ট্রেশনে একটি OS (অ্যাপ) এবং একটি ওয়েব গন্তব্য উভয়ই নির্দিষ্ট করা থাকে, তাহলে ইভেন্ট-স্তরের প্রতিবেদনগুলি ডিফল্টরূপে ট্রিগারটি কোনও ওয়েব গন্তব্যে ঘটেছে নাকি অ্যাপ গন্তব্যে ঘটেছে তা নির্দিষ্ট করবে। তবে, গোপনীয়তার সীমা বজায় রাখার জন্য, এই প্রতিবেদনগুলিতে অতিরিক্ত শব্দ যোগ করা হবে।
- বিজ্ঞাপন প্রযুক্তিবিদরা Attribution-Reporting-Register-Source হেডারের অধীনে coarse_event_report_destinations ফিল্ড ব্যবহার করে কোয়ার রিপোর্টিং চালু করতে এবং শব্দ কমাতে পারেন। যদি coarse_event_report_destinations ফিল্ড নির্দিষ্ট করা আছে এমন কোনও সোর্স অ্যাট্রিবিউশন জিতে, তাহলে ফলাফলের রিপোর্টে অ্যাপ এবং ওয়েব গন্তব্য উভয়ই অন্তর্ভুক্ত থাকে, যেখানে প্রকৃত ট্রিগারটি কোথায় ঘটেছে তা আলাদাভাবে উল্লেখ করা হয় না, তবে যেখানে অ্যাপ বা ওয়েব গন্তব্য নির্দিষ্ট করা হয়েছে তার তুলনায় কম শব্দ থাকে।
- সামগ্রিক প্রতিবেদন অপরিবর্তিত রয়েছে।

Chrome কাস্টম ট্যাব ব্যবহারকারী অ্যাপগুলির জন্য

কিছু অ্যাপ ওয়েব কন্টেন্ট রেন্ডার করার জন্য কাস্টম ট্যাব ব্যবহার করতে পারে। অ্যাপ এবং মোবাইল ওয়েব সাইট জুড়ে পরিমাপ করার সময় কাস্টম ট্যাবগুলি একটি নিয়মিত ওয়েব পৃষ্ঠার মতোই আচরণ করে।

একটি অ্যাপ সোর্স এবং কাস্টম ট্যাব ট্রিগার নিবন্ধন করুন:
- একটি অ্যাপ সোর্স এবং ওয়েব ট্রিগার নিবন্ধন করতে নির্দেশাবলী অনুসরণ করুন।
একটি কাস্টম ট্যাব সোর্স এবং অ্যাপ ট্রিগার নিবন্ধন করুন:
- একটি ওয়েব সোর্স এবং অ্যাপ ট্রিগার নিবন্ধন করতে নির্দেশাবলী অনুসরণ করুন।
একটি CCT উৎস এবং CCT ট্রিগার নিবন্ধন করুন
- এটি Chrome-এ যেকোনো সাইট-টু-সাইট ওয়েব অ্যাট্রিবিউশনের মতোই বিবেচিত হবে।

WebView ব্যবহারকারী অ্যাপগুলির জন্য

কিছু অ্যাপ কন্টেন্ট প্রদর্শনের জন্য WebView ব্যবহার করতে পারে। WebView-এর জন্য বিভিন্ন ধরণের ব্যবহারের ক্ষেত্র রয়েছে, যেমন বিজ্ঞাপন রেন্ডার করা, ওয়েব কন্টেন্ট হোস্ট করা, অথবা ওয়েব ফর্ম্যাটের সাথে আরও উপযুক্ত কাস্টম অ্যাপ বৈশিষ্ট্য।

WebViews-কে অ্যাট্রিবিউশন রিপোর্টিং API ব্যবহার করার অনুমতি দিতে, এম্বেডিং অ্যাপটিকে সঠিক অনুমতি দিয়ে কনফিগার করতে হবে।
WebView-এ শুধুমাত্র OS-স্তরের অ্যাট্রিবিউশন উপলব্ধ। Attribution-Reporting-Support হেডারটি শুধুমাত্র OS প্রদান করবে, এবং শুধুমাত্র যদি Android Attribution Reporting API উপলব্ধ থাকে।
দ্রষ্টব্য: Chrome এবং WebView জুড়ে অ্যাট্রিবিউশন করার জন্য, Chrome-এ সোর্স এবং ট্রিগার রেজিস্ট্রেশনগুলি OS-এর উপর অর্পণ করতে হবে কারণ WebView-এর জন্য শুধুমাত্র OS-ভিত্তিক অ্যাট্রিবিউশন সমর্থিত।

OS-এ ডেলিগেট করার সময়, WebView registerSource অথবা registerWebSource এবং registerTrigger অথবা registerWebTrigger ব্যবহার করতে পারে। WebView কোন পদ্ধতি ব্যবহার করবে তা WebView রেন্ডারকারী অ্যাপ দ্বারা সেট করা হয় এবং প্রতি WebView ভিত্তিতে নির্ধারিত হয়।

registerSource এবং registerWebSource মধ্যে পার্থক্য হল কোন উৎসটি প্রকাশক হিসেবে লগ করা হয়। registerSource এর মাধ্যমে, অ্যাপটি প্রকাশক হিসেবে লগ করা হয়; registerSource কখন ব্যবহার করতে হবে তার একটি উদাহরণ হল একটি প্রকাশক অ্যাপ যা WebView ব্যবহার করে রেন্ডার করা একটি বিজ্ঞাপন দেখায়। registerWebSource এর মাধ্যমে, WebView এ হোস্ট করা ওয়েবসাইটটি প্রকাশক হিসেবে লগ করা হয়; registerWebSource কখন ব্যবহার করতে হবে তার একটি উদাহরণ হল একটি WebView হোস্ট করা একটি অ্যাপ এবং WebView দ্বারা রেন্ডার করা ওয়েবসাইটটি বিজ্ঞাপন দেখাচ্ছে। registerTrigger এবং registerWebTrigger একইভাবে আচরণ করে। আইটেম #3 এর চার্টে বিভিন্ন পরিস্থিতির বিবরণ দেওয়া হয়েছে যখন কোনও অ্যাপ বা SDK ডেভেলপার registerSource বা registerWebSource এবং registerTrigger বা registerWebTrigger ব্যবহার করার জন্য API কনফিগার করতে চাইবে।

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

যদি কোন অ্যাপের ভিন্ন আচরণের প্রয়োজন হয়, তাহলে তাদের androidx.webkit.WebViewSettingsCompat ক্লাসে একটি নতুন পদ্ধতি setAttributionRegistrationBehavior ব্যবহার করতে হবে। এই পদ্ধতিটি নির্দিষ্ট করবে যে WebView registerWebSource() অথবা registerWebTrigger() এর পরিবর্তে registerWebSource registerSource() অথবা registerTrigger() কল করা উচিত কিনা।
এই আচরণটি শুরু হওয়া প্রতিটি ওয়েবভিউয়ের জন্য সেট করা প্রয়োজন।
যদি বিজ্ঞাপন প্রযুক্তি SDK WebView শুরু করে, তাহলে SDK-কে এই ডিফল্ট আচরণ সেট করতে হবে।
যেসব অ্যাপ অ্যাপের পরিবর্তে WebView-এ থাকা ওয়েবসাইটের সাথে সোর্স রেজিস্ট্রেশন যুক্ত করতে registerWebSource() ব্যবহার করতে চায়, তাদের অবশ্যই WebApp allowlist-এ যোগ দিতে হবে। allowlist-এ যোগদানের জন্য এই ফর্মটি পূরণ করুন । allowlist-এর উদ্দেশ্য হল ওয়েব কনটেক্সটের জন্য আস্থা স্থাপনের ক্ষেত্রে গোপনীয়তার বিবেচনা হ্রাস করা।

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

WebView থেকে নিবন্ধন উৎস এবং ট্রিগার করুন
বিজ্ঞাপন প্রযুক্তিবিদদের Attribution-Reporting-Register-OS-Source হেডার ব্যবহার করে সোর্স রেজিস্ট্রেশনের প্রতিক্রিয়া জানাতে হবে। WebView-এর জন্য সেট আচরণের উপর ভিত্তি করে, এটি OS-এর সাথে registerSource() অথবা registerWebSource() কল করবে এবং Android Attribution Reporting API থেকে বিজ্ঞাপন প্রযুক্তি URI-তে একটি সেকেন্ডারি API কল শুরু করবে।
- সোর্স রেজিস্ট্রেশন সম্পূর্ণ করার জন্য, বিজ্ঞাপন প্রযুক্তির এন্ডপয়েন্টকে রেসপন্স হেডার ব্যবহার করে অ্যান্ড্রয়েড অ্যাট্রিবিউশন রিপোর্টিং এপিআই অনুরোধের জবাব দিতে হবে।
```
 Attribution-Reporting-Register-OS-Source: {
  "source_event_id":"123001",
  "destination":"android-app://com.example.advertiser",
  ...
}
```
উৎস নিবন্ধনের বাকি অংশ একই রয়ে গেছে।
বিজ্ঞাপন প্রযুক্তিবিদদের Attribution-Reporting-Register-OS-Trigger হেডার ব্যবহার করে ট্রিগার রেজিস্ট্রেশনের প্রতিক্রিয়া জানানো উচিত। WebView-এর জন্য সেট আচরণের উপর ভিত্তি করে, এটি OS-এর মাধ্যমে registerTrigger() অথবা registerWebTrigger() কল করবে এবং Rb থেকে বিজ্ঞাপন প্রযুক্তি URI-তে একটি সেকেন্ডারি API কল শুরু করবে।
ট্রিগার রেজিস্ট্রেশন সম্পূর্ণ করার জন্য, বিজ্ঞাপন প্রযুক্তির এন্ডপয়েন্টকে রেসপন্স হেডার ব্যবহার করে অ্যান্ড্রয়েড অ্যাট্রিবিউশন রিপোর্টিং এপিআই অনুরোধের জবাব দিতে হবে।

Attribution-Reporting-Register-OS-Trigger: {
    "event_trigger_data": [{"trigger_data":"1"}],
    "aggregatable_trigger_data": [
        {"key_piece":"0x400","source_keys":["campaignCounts"]},
        {"key_piece":"0xA80","source_keys":["geoValue"]}
    ],
    ...
}

ট্রিগার নিবন্ধনের বাকি প্রক্রিয়াটি একই থাকে।

ডিবাগ

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

সাধারণ অ্যাট্রিবিউশন রিপোর্টিং ডিবাগিং ধাপগুলির জন্য, ডিবাগিং কুকবুকটি দেখুন।