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

উপযুক্ত ইভেন্টগুলিতে ক্লিক এবং ভিউ অ্যাট্রিবিউট করার জন্য কীভাবে উত্স নিবন্ধন করবেন তা শিখুন।

একটি অ্যাট্রিবিউশন উত্স হল একটি বিজ্ঞাপন-সম্পর্কিত ইভেন্ট (একটি ক্লিক বা ভিউ), যেখানে একটি বিজ্ঞাপন প্রযুক্তি নিম্নলিখিত ধরণের তথ্য সংযুক্ত করতে পারে:

  • প্রাসঙ্গিক রিপোর্টিং ডেটা, যেমন বিজ্ঞাপন ক্রিয়েটিভ আইডি, প্রচারাভিযান সম্পর্কে তথ্য, বা ভূগোল।
  • একটি রূপান্তর গন্তব্য, যেমন সাইটে আপনি ব্যবহারকারীকে রূপান্তর করতে আশা করেন।

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

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

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

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

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

ক্লিক বা দর্শনের জন্য উত্স নিবন্ধন করুন

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

  1. উৎস নিবন্ধন শুরু করুন . একটি অনুরোধ করতে একটি HTML উপাদান বা একটি JavaScript কল ব্যবহার করুন৷ এই ধাপটি ক্লিক এবং ভিউয়ের জন্য আলাদা, আপনি নিম্নলিখিত বিভাগে লক্ষ্য করবেন।

  2. সোর্স রেজিস্ট্রেশন হেডার দিয়ে উত্তর দিয়ে সোর্স রেজিস্ট্রেশন সম্পূর্ণ করুন । সেই অনুরোধ পাওয়ার পর, শিরোনাম Attribution-Reporting-Register-Source দিয়ে সাড়া দিন। সেই হেডারে, পছন্দসই অ্যাট্রিবিউশন রিপোর্টিং কনফিগারেশন নির্দিষ্ট করুন। এই ধাপটি ক্লিক এবং ভিউ উভয়ের জন্যই একই।

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

    {
  "aggregation_keys": {
    "campaignCounts": "0x159",
    "geoValue": "0x5"
  },
  "aggregatable_report_window": "86400",
  "destination": "https://example.com"
}

    ইভেন্ট-স্তরের প্রতিবেদনের উদাহরণ: 

    {
  "source_event_id": "12340873456",
  "destination": "[eTLD+1]",
  "expiry": "[64-bit signed integer]",
  "priority": "[64-bit signed integer]",
  "event_report_window": "[64-bit signed integer]"
}

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

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

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

নিবন্ধন পদ্ধতি উৎস
<a> ট্যাগ (নেভিগেশন উত্স)
attributionsrc প্রয়োজন ।
<img> ট্যাগ (ঘটনার সূত্র)
attributionsrc প্রয়োজন ।
<script> ট্যাগ (ঘটনার সূত্র)
attributionsrc প্রয়োজন ।
কল fetch attributionReporting বিকল্পটি প্রয়োজন ।
XMLHttpRequest attributionReporting বিকল্পটি প্রয়োজন ।
window.open কল (নেভিগেশন উত্স)
attributionsrc প্রয়োজন।

ধাপ 1: উৎস নিবন্ধন শুরু করুন

ধাপ 1 ক্লিক এবং ভিউ জন্য ভিন্ন.

একটি ক্লিকের জন্য একটি অ্যাট্রিবিউশন উৎস নিবন্ধন করতে, আপনি একটি <a> ট্যাগ বা JavaScript window.open() ব্যবহার করতে পারেন।

একটি নোঙ্গর ব্যবহার করে

বিদ্যমান <a> ট্যাগগুলিতে attributionsrc যোগ করুন যার জন্য আপনি ইম্প্রেশন বা ক্লিকগুলি পরিমাপ করতে চান:

<a href="https://shoes.example/..." attributionsrc>Click me</a>

আরও তথ্যের জন্য উদাহরণ কোড পর্যালোচনা করুন.

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

attributionsrc সহ window.open() কে কল করুন:

window.open(
  "https://shoes.example/...",
  "_blank",
  "attributionsrc");

বিবেচনায় নেওয়ার জন্য, এই পদ্ধতিটি ব্যবহারকারীর ইন্টারঅ্যাকশনের 5 সেকেন্ডের মধ্যে কল করতে হবে।

নিজে থেকে attributionsrc যোগ করার পরিবর্তে, একটি চিত্র বা স্ক্রিপ্টের জন্য আপনি একটি একক URL মান নির্দিষ্ট করতে পারেন:

<a href=... attributionsrc="https://a.example/register-source">Click me</a>

JavaScript ক্ষেত্রে, আপনি যদি attributionsrc একটি মান দেন, তাহলে নিশ্চিত করুন যে URLটি এনকোড করতে হবে যদি এতে বিশেষ অক্ষর থাকে যেমন = যা প্যারামিটারটিকে ভুলভাবে পার্স করতে পারে।

নিম্নরূপ এনকোড:

const encodedUrl = encodeURIComponent(
  "https://adtech.example/attribution_source?ad_id=...");
window.open(
  "https://shoes.example/landing",
   "_blank",
   `attributionsrc=${encodedUrl}`);

attributionsrc এখানে <a> ট্যাগ দিয়ে চিত্রিত URL-এর একটি স্থান-বিচ্ছিন্ন তালিকাও নিতে পারে:

<a href=... attributionsrc="https://a.example/register-source
  https://b.example/register-source">Click me</a>

অথবা এটি এখানে window.open() ব্যবহার করে।

window.open("...", "_blank", `attributionsrc=${encodedUrl1}
  attributionsrc=${encodedUrl2}`)

এই ধরনের ক্ষেত্রে, উভয় ইউআরএলই নেভিগেশন-সোর্স-যোগ্য attributionsrc অনুরোধগুলি পায় (অনুরোধ যাতে Attribution-Reporting-Eligible শিরোনাম অন্তর্ভুক্ত থাকে)।

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

আপনি আগে দেখেছেন, আপনি একটি URL ছাড়া attributionsrc নির্দিষ্ট করতে পারেন। আপনি একটি একক URLও নির্দিষ্ট করতে পারেন। উপরন্তু, আপনি URL-এর একটি স্থান-বিচ্ছিন্ন তালিকা ব্যবহার করতে পারেন।

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

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

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

একটি দৃশ্যের জন্য একটি অ্যাট্রিবিউশন উত্স নিবন্ধন করতে, আপনি একটি চিত্র বা স্ক্রিপ্ট ট্যাগ ব্যবহার করতে পারেন যেখানে আপনি attributionsrc বৈশিষ্ট্য যোগ করবেন৷

বিকল্পভাবে, আপনি JavaScript fetch() বা XMLHttpRequest() ব্যবহার করতে পারেন।

একটি ইমেজ সঙ্গে 

<img attributionsrc
src="https://adtech.example/attribution_source?ad_id=...">

একটি স্ক্রিপ্ট সহ

<script attributionsrc
  src="https://adtech.example/attribution_source?ad_id=..."></script>

ঐচ্ছিকভাবে, আপনি ক্লিকের মতোই attributionsrc এর জন্য একটি URL মান নির্দিষ্ট করতে পারেন; অর্থাৎ, একটি ইমেজ বা স্ক্রিপ্টের জন্য, আপনি attributionsrc URL বা URL গুলি সেট করতে পারেন:

একটি একক URL সহ:

<img attributionsrc="https://adtech.example/attribution_source?ad_id=123">

URL-এর তালিকা সহ: 

<img attributionsrc="https://a.example/register-source
  https://b.example/register-source">

fetch() বা XMLHttpRequest() ব্যবহার করে

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

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

// 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: true,
  triggerEligible: false,
};

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

ধাপ 2: শিরোনাম সহ উত্তর দিন (ক্লিক এবং ভিউ)

ক্লিক এবং ভিউ উভয়ের জন্য পরবর্তী ধাপ হল Attribution-Reporting-Register-Source শিরোনাম দিয়ে প্রতিক্রিয়া জানানো।

আরও তথ্যের জন্য উদাহরণ কোড পর্যালোচনা করুন.

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

res.set(
  "Attribution-Reporting-Register-Source",
  JSON.stringify({
    // Use source_event_id to map it to any granular information
    // you need at ad-serving time
    source_event_id: "412444888111012",
    destination: "https://advertiser.example",
    // Optional fields
    expiry: "604800",
    priority: "100",
    debug_key: "122939999"
  })
);

একবার স্ট্রিং করা হলে, আপনার শিরোনামটি এইরকম দেখায়: 

{"source_event_id":"412444888111012","destination":"https://advertiser.example","expiry":"604800","priority":"100","debug_key":"122939999"}

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

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