এই পৃষ্ঠাটি Cloud Translation API অনুবাদ করেছে।

অ্যাট্রিবিউশন ট্রিগার নিবন্ধন করুন

আপনার রূপান্তরগুলি গণনা করতে অ্যাট্রিবিউশন ট্রিগারগুলি কীভাবে নিবন্ধন করবেন তা শিখুন।

একটি অ্যাট্রিবিউশন ট্রিগার হল সেই ইভেন্ট যা ব্রাউজারকে রূপান্তরগুলি ক্যাপচার করতে বলে৷

এই ডকুমেন্টের ধাপগুলি অনুসরণ করে, আপনি কনভার্সন রেজিস্টার করার জন্য ট্রিগার নিবন্ধন করতে পারেন যা ব্রাউজার তখন প্রাসঙ্গিক উত্স ইভেন্টের জন্য অ্যাট্রিবিউট করে—যেমন, বিজ্ঞাপন ইমপ্রেশন বা বিজ্ঞাপন ক্লিক৷

নিবন্ধন পদ্ধতি

ট্রিগার নিবন্ধন করতে, HTML উপাদান বা জাভাস্ক্রিপ্ট কল ব্যবহার করুন:

<a> ট্যাগ
<img> ট্যাগ
<script> ট্যাগ
কল fetch
XMLHttpRequest
window.open

এটি নেটওয়ার্ক অনুরোধগুলি তৈরি করে যা আপনি একটি ট্রিগার নিবন্ধন HTTP প্রতিক্রিয়া শিরোনামের সাথে প্রতিক্রিয়া জানান৷

একটি রূপান্তর অ্যাট্রিবিউট করতে একটি ট্রিগার নিবন্ধন করুন৷

একটি ট্রিগার নিবন্ধন করা একটি অ্যাট্রিবিউশন উত্স ইভেন্ট নিবন্ধনের অনুরূপ৷ সম্পূর্ণ পদক্ষেপগুলি পরে বর্ণিত হয়েছে। এখানে সারসংক্ষেপ:

ট্রিগার নিবন্ধন শুরু করুন. একটি অনুরোধ করতে একটি পিক্সেল বা একটি fetch() কল ব্যবহার করুন৷
ট্রিগার নিবন্ধন শিরোনাম দিয়ে সাড়া দিয়ে ট্রিগার নিবন্ধন সম্পূর্ণ করুন ।

পিক্সেল রিকোয়েস্ট পাওয়ার পর—সাধারণ src অ্যাট্রিবিউটে সংজ্ঞায়িত এন্ডপয়েন্টে অথবা attributionsrc -তে সংজ্ঞায়িত এন্ডপয়েন্টে পাঠানো হয় যদি আপনি attributionsrc ব্যবহার করা বেছে নেন এবং এটিকে একটি মান দেন—হেডার Attribution-Reporting-Register-Trigger দিয়ে সাড়া দিন .

এই হেডারে, শেষ পর্যন্ত রিপোর্টে যে ট্রিগার ডেটা আপনি দেখতে চান তা নির্দিষ্ট করুন। কোনো প্রতিক্রিয়া এই শিরোনাম সেট করতে পারেন. যতক্ষণ না এটি একটি সাইট থেকে করা একটি অনুরোধের প্রতিক্রিয়া যা destination সাথে মেলে, উত্সগুলি মিলিত হবে৷ শিরোনামটি প্রাপ্ত হলে, ব্রাউজার মিলিত উত্সগুলি সন্ধান করে এবং একটি প্রতিবেদন নির্ধারণ করে।
ইভেন্ট-স্তরের প্রতিবেদনের উদাহরণ:
```
{
  "event_trigger_data": [{
    "trigger_data": "[unsigned 64-bit integer]",
    "priority": "[signed 64-bit integer]",
    "deduplication_key": "[unsigned 64-bit integer]"
  }]
}
```

**Example for summary reports:**

```json
{
  ... // existing fields, such as "event_trigger_data"

  "aggregatable_trigger_data": [
   {
     "key_piece": "0x400",
     "source_keys": ["campaignCounts"]
   },
   {
     "key_piece": "0xA80",
     "source_keys": ["geoValue", "nonMatchingKeyIdsAreIgnored"]
   }
  ],
  "aggregatable_values": {
    "campaignCounts": 32768,
    "geoValue": 1664
  }
}
```
```

দ্রষ্টব্য: যখন ব্রাউজার একটি প্রদত্ত পৃষ্ঠায় একটি attributionsrc URL থেকে একটি অ্যাট্রিবিউশন ট্রিগার প্রতিক্রিয়া পায়, তখন একটি স্থানীয় স্টোরেজ অনুসন্ধান করা হয় একটি উত্স খুঁজে বের করার জন্য যা attributionsrc মূল এবং সেই পৃষ্ঠার URL এর eTLD+1 উভয়ের সাথে মিলে যায়৷ <br> যদি একাধিক উত্স পাওয়া যায়, ব্রাউজারটি সম্প্রতি সংরক্ষিত একটিকে বেছে নেয়- যদি না উৎসগুলির বিভিন্ন অগ্রাধিকার থাকে, যেখানে ব্রাউজার সর্বাধিক অগ্রাধিকার দিয়ে একটিকে বেছে নেয়৷

সাবডোমেন নিয়ে কাজ করা

যদি destination https://advertiser.example হয়, তাহলে https://advertiser.example এবং এর সাবডোমেন, যেমন https://shop.advertiser.example উভয়েরই রূপান্তরকে দায়ী করা যেতে পারে।

যদি destination https://shop.advertiser.example হয়, তাহলে https://advertiser.example এবং https://shop.advertiser.example উভয় ক্ষেত্রেই রূপান্তরকে দায়ী করা যেতে পারে।

প্রয়োজনীয় এবং ঐচ্ছিক বৈশিষ্ট্য

আপনি যেহেতু এইচটিএমএল উপাদান ব্যবহার করেন বা ট্রিগার নিবন্ধন করতে জাভাস্ক্রিপ্ট কল করেন, আপনাকে attributionsrc বা attributionReporting ব্যবহার করতে হতে পারে। এগুলি কখন প্রয়োজন তার বিশদ বিবরণের জন্য নিম্নলিখিত টেবিলটি পড়ুন।

যখন attributionsrc ঐচ্ছিক হয়, তখন এটি ব্যবহার করে নির্দেশ করে যে অনুরোধটি অ্যাট্রিবিউশন রিপোর্টিংয়ের জন্য যোগ্য। আপনি attributionsrc ব্যবহার করলে, ব্রাউজারটি Attribution-Reporting-Eligible শিরোনাম পাঠায়। এটি অ্যাপ-টু-ওয়েব পরিমাপের জন্যও দরকারী: যদি attributionsrc উপস্থিত থাকে, ব্রাউজারটি Attribution-Reporting-Support শিরোনাম পাঠায়।

নিবন্ধন পদ্ধতি	ট্রিগার
`<a>` ট্যাগ	N/A অ্যাঙ্কররা ট্রিগার নিবন্ধন করতে পারে না।
`<img>` ট্যাগ	`attributionsrc` ঐচ্ছিক। শিরোনামটি একটি ট্রিগার নিবন্ধন করার জন্য যথেষ্ট।
`<script>` ট্যাগ	`attributionsrc` ঐচ্ছিক । শিরোনামটি একটি ট্রিগার নিবন্ধন করার জন্য যথেষ্ট।
কল `fetch`	`attributionReporting` বিকল্পটি প্রয়োজন ।
`XMLHttpRequest`	`attributionReporting` বিকল্পটি প্রয়োজন ।
`window.open()`	N/A `window.open` একটি ট্রিগার নিবন্ধন করতে পারে না।

ধাপ 1: ট্রিগার নিবন্ধন শুরু করুন

আপনি একটি পিক্সেল ( <img> ট্যাগ) বা স্ক্রিপ্ট ট্যাগ ব্যবহার করে একটি ট্রিগার নিবন্ধন করতে পারেন।

একটি নতুন বা বিদ্যমান রূপান্তর পিক্সেল ব্যবহার করে

<img src="https://ad-tech.example/conversionpixel"
     attributionsrc="https://adtech.example/attribution_trigger?purchase=13">

মূল পয়েন্ট: * src এর উৎপত্তি অবশ্যই উৎসের সাথে মেলে যেটি উৎস নিবন্ধন করেছে। * একটি অ্যাট্রিবিউশন শুধুমাত্র একটি পৃষ্ঠায় ট্রিগার করা যেতে পারে যার eTLD+1 সেই সাইটের সাথে মেলে যা উৎস নিবন্ধনের সময় গন্তব্যে দেওয়া হয়েছিল।

একটি স্ক্রিপ্ট ট্যাগ ব্যবহার করে

আপনি একটি স্ক্রিপ্ট ট্যাগ দিয়ে ট্রিগার নিবন্ধন সম্পাদন করতে পারেন; এটি <img> এর সাথে অভিন্ন আচরণ করে। নিম্নলিখিত কোড নমুনাগুলি fetch() এবং XMLHttpRequest() (XHR) এর ব্যবহার চিত্রিত করে৷

এই কোডটি কার্যকরভাবে অনুকরণ করে যে attributionsrc সহ একটি HTML অনুরোধ কী করবে:

// With fetch
const attributionReporting = {
  eventSourceEligible: false,
  triggerEligible: true,
};

// Optionally set keepalive to ensure the request outlives the page.
window.fetch("https://adtech.example/attribution_source?my_ad_id=123",
  { keepalive: true, attributionReporting });

// With XMLHttpRequest:
const attributionReporting = {
  eventSourceEligible: false,
  triggerEligible: true,
};

const req = new XMLHttpRequest();
  req.open('GET', url);
  req.setAttributionReporting(
      attributionReporting);
  req.send();

একটি মান সহ বা ছাড়া `attributionsrc`

আপনি একটি মান সহ বা ছাড়াই attributionsrc যোগ করতে পারেন।

<!-- Without a value -->
<img src="..." width="1" height="1" attributionsrc>

<!--With a value (URL) -->
<img src="..." width="1" height="1" attributionsrc="https://...">

আপনি attributionsrc এর জন্য একটি মান সেট করলে, এটি একটি একক URL হওয়া উচিত।

একটি ইউআরএল ব্যবহার করার ফলে ব্রাউজার একটি আলাদা করে রাখার অনুরোধ শুরু করে—প্রতিটি ইউআরএলের জন্য একটি—যাতে Attribution-Reporting-Eligible অনুরোধের শিরোনাম রয়েছে।

আপনি যদি উপাদানটির মূল অনুরোধ থেকে আলাদা একটি অনুরোধের প্রতিক্রিয়া জানিয়ে উত্স নিবন্ধন করতে চান তবে এটি কার্যকর।

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

ধাপ 2: হেডার দিয়ে উত্তর দিন

ব্রাউজার অনুরোধ পাওয়ার পরে, প্রতিক্রিয়া জানান এবং আপনার প্রতিক্রিয়াতে Attribution-Reporting-Register-Trigger শিরোনামটি অন্তর্ভুক্ত করুন:

JSON.stringify({event_trigger_data: [{
      trigger_data: '412444888111012',
      // Optional
      priority: '1000000000000',
      deduplication_key: '2345698765'
    }], debug_key: '1115698977'})

পরবর্তী পদক্ষেপ

অ্যাট্রিবিউশন সোর্স রেজিস্টার করতে শিখুন।