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

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

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

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

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

ট্রিগার নিবন্ধন করতে, 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 উভয় ক্ষেত্রেই রূপান্তরকে দায়ী করা যেতে পারে।

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

আপনি যেহেতু এইচটিএমএল উপাদান ব্যবহার করেন বা ট্রিগার নিবন্ধন করতে জাভাস্ক্রিপ্ট কল করেন, আপনাকে 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();

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

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

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