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

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

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

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

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

ট্রিগার নিবন্ধন করতে, 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
     }
   }
   

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

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

যদি 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> ট্যাগ) বা স্ক্রিপ্ট ট্যাগ ব্যবহার করে একটি ট্রিগার নিবন্ধন করতে পারেন।

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

নিম্নলিখিত উদাহরণটি 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 ensure 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();

মূল পয়েন্ট:

• fetch() বা open() তে সেট করা উত্স বা url অবশ্যই উত্স নিবন্ধন সম্পাদনকারী উত্সের সাথে মিলবে৷
• একটি অ্যাট্রিবিউশন শুধুমাত্র একটি পৃষ্ঠায় ট্রিগার করা যেতে পারে যার সাইটটি উৎস নিবন্ধনের সময় গন্তব্যে দেওয়া সাইটের সাথে মেলে।

একটি মান সহ বা ছাড়া 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"
});

সতর্কতা: event_trigger_data ক্ষেত্রের মান অবশ্যই বর্গাকার বন্ধনীতে নেস্ট করা উচিত, কারণ ব্রাউজার একটি JSON অ্যারে আশা করে। এই ফিল্টার জন্য দরকারী.

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

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