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

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

অ্যাট্রিবিউশন ট্রিগার হলো সেই ইভেন্ট যা ব্রাউজারকে কনভার্সন ক্যাপচার করতে বলে।

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

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

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

  • <img> ট্যাগ
  • <script> ট্যাগ
  • কল fetch
  • XMLHttpRequest

এটি নেটওয়ার্ক অনুরোধ তৈরি করে যার উত্তর আপনি একটি ট্রিগার রেজিস্ট্রেশন HTTP রেসপন্স হেডার দিয়ে দেন।

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

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

  1. ট্রিগার নিবন্ধন শুরু করুন। অনুরোধ করতে একটি পিক্সেল অথবা একটি fetch() কল ব্যবহার করুন।

  2. ট্রিগার রেজিস্ট্রেশন হেডার দিয়ে সাড়া দিয়ে ট্রিগার রেজিস্ট্রেশন সম্পূর্ণ করুন ।

    পিক্সেল অনুরোধটি পাওয়ার পর—যা হয় সাধারণ 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]"
  }]
}

    সারাংশ প্রতিবেদনের উদাহরণ:

    {
  ... // 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
  }
}

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

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

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

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

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

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

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

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

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

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

নিম্নলিখিত উদাহরণটি attributionsrc অ্যাট্রিবিউট যোগ করে একটি বিদ্যমান ছবিতে অ্যাট্রিবিউশন ট্রিগার করে।

attributionsrc এর অরিজিন অবশ্যই উৎস নিবন্ধনকারী অরিজিনের সাথে মিলতে হবে।

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

পরবর্তী উদাহরণটি একটি নতুন রূপান্তর পিক্সেল attributionsrc অ্যাট্রিবিউট যোগ করে অ্যাট্রিবিউশনটি ট্রিগার করে।

src এর অরিজিন অবশ্যই উৎস নিবন্ধনকারী অরিজিনের সাথে মিলতে হবে।

<img src="https://adtech.example/conversionpixel"
     attributionsrc>

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

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

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

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

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

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 হতে পারে।

একটি URL ব্যবহার করলে ব্রাউজারটি একটি পৃথক keepalive ফেচ অনুরোধ শুরু করে—প্রতিটি URL এর জন্য একটি—যার মধ্যে Attribution-Reporting-Eligible অনুরোধ শিরোনাম অন্তর্ভুক্ত থাকে।

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

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

ধাপ ২: একটি হেডার দিয়ে উত্তর দিন

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

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

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

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