উপযুক্ত ইভেন্টগুলিতে ক্লিক এবং ভিউ অ্যাট্রিবিউট করার জন্য কীভাবে উৎসগুলি নিবন্ধন করতে হয় তা শিখুন।
একটি অ্যাট্রিবিউশন সোর্স হল একটি বিজ্ঞাপন-সম্পর্কিত ইভেন্ট (একটি ক্লিক বা ভিউ), যার সাথে একজন বিজ্ঞাপন প্রযুক্তিবিদ নিম্নলিখিত ধরণের তথ্য সংযুক্ত করতে পারেন:
- প্রাসঙ্গিক প্রতিবেদনের ডেটা, যেমন বিজ্ঞাপন সৃজনশীল আইডি, প্রচারণা সম্পর্কে তথ্য, অথবা ভূগোল।
- একটি রূপান্তর গন্তব্য, যেমনটি সেই সাইটে যেখানে আপনি ব্যবহারকারীকে রূপান্তরিত করার আশা করেন।
এই ডকুমেন্টের ধাপগুলি অনুসরণ করে, আপনি উৎসগুলি নিবন্ধন করতে পারেন—বিজ্ঞাপনের ছাপ বা ক্লিকগুলি—যার সাথে ব্রাউজার রূপান্তরগুলি যুক্ত করে।
নিবন্ধন পদ্ধতি
অ্যাট্রিবিউশন সোর্স রেজিস্টার করতে, HTML এলিমেন্ট অথবা জাভাস্ক্রিপ্ট কল ব্যবহার করুন:
-
<a>ট্যাগ -
<img>ট্যাগ -
<script>ট্যাগ - কল
fetch -
XMLHttpRequest -
window.openকল
এটি এমন নেটওয়ার্ক অনুরোধ তৈরি করে যা আপনি তারপর একটি সোর্স রেজিস্ট্রেশন HTTP রেসপন্স হেডার দিয়ে সাড়া দেন।
ক্লিক বা ভিউয়ের জন্য উৎস নিবন্ধন করুন
ক্লিক বা ভিউ উভয়ের জন্য একটি অ্যাট্রিবিউশন সোর্স নিবন্ধন করতে, এখানে বর্ণিত ধাপগুলি অনুসরণ করুন। সম্পূর্ণ ধাপগুলি অনুসরণ করুন। এখানে সারাংশ দেওয়া হল:
- সোর্স রেজিস্ট্রেশন শুরু করুন । অনুরোধ করার জন্য একটি HTML এলিমেন্ট অথবা জাভাস্ক্রিপ্ট কল ব্যবহার করুন। ক্লিক এবং ভিউয়ের জন্য এই ধাপটি আলাদা, যা আপনি পরবর্তী বিভাগগুলিতে লক্ষ্য করবেন।
সোর্স রেজিস্ট্রেশন হেডার দিয়ে সাড়া দিয়ে সোর্স রেজিস্ট্রেশন সম্পূর্ণ করুন । অনুরোধটি পাওয়ার পর,
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 উপাদান ব্যবহার করার সময় অথবা জাভাস্ক্রিপ্ট কল করার সময়, আপনাকে attributionsrc অথবা attributionReporting ব্যবহার করতে হতে পারে। কখন এগুলো প্রয়োজন হবে তার বিস্তারিত জানার জন্য নিম্নলিখিত টেবিলটি দেখুন।
যখন attributionsrc ঐচ্ছিক থাকে, তখন এটি ব্যবহার করলে বোঝা যায় যে অনুরোধটি Attribution Reporting এর জন্য যোগ্য। যদি আপনি attributionsrc ব্যবহার করেন, তাহলে ব্রাউজার Attribution-Reporting-Eligible হেডার পাঠাবে। এটি অ্যাপ-টু-ওয়েব পরিমাপের জন্যও কার্যকর: যদি attributionsrc উপস্থিত থাকে, তাহলে ব্রাউজার Attribution-Reporting-Support হেডার পাঠাবে।
| নিবন্ধন পদ্ধতি | উৎস |
|---|---|
<a> ট্যাগ | (নেভিগেশন উৎস)attributionsrc আবশ্যক । |
<img> ট্যাগ | (ঘটনার উৎস)attributionsrc আবশ্যক । |
<script> ট্যাগ | (ঘটনার উৎস)attributionsrc আবশ্যক । |
কল fetch | attributionReporting বিকল্পটি প্রয়োজন । |
XMLHttpRequest | attributionReporting বিকল্পটি প্রয়োজন । |
window.open কল | (নেভিগেশন উৎস)attributionsrc প্রয়োজন। |
ধাপ ১: উৎস নিবন্ধন শুরু করুন
ক্লিক এবং ভিউয়ের জন্য ধাপ ১ ভিন্ন।
একটি ক্লিকের জন্য একটি অ্যাট্রিবিউশন সোর্স নিবন্ধন করতে, আপনি একটি <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");
বিবেচনায় নেওয়ার জন্য, ব্যবহারকারীর সাথে যোগাযোগের ৫ সেকেন্ডের মধ্যে এই পদ্ধতিটি কল করতে হবে।
একটি ছবি বা স্ক্রিপ্টের জন্য attributionsrc নিজে থেকে যোগ করার পরিবর্তে, আপনি একটি একক URL মান নির্দিষ্ট করতে পারেন:
<a href=... attributionsrc="https://a.example/register-source">Click me</a>
জাভাস্ক্রিপ্টের ক্ষেত্রে, যদি আপনি 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}`)
এই ধরনের ক্ষেত্রে, উভয় URL-ই navigation-source-eligible attributionsrc অনুরোধ ( Attribution-Reporting-Eligible হেডার অন্তর্ভুক্ত অনুরোধ) গ্রহণ করে।
মান সহ বা ছাড়াই attributionsrc
যেমনটি আপনি আগে দেখেছেন, আপনি URL ছাড়াই attributionsrc নির্দিষ্ট করতে পারেন। আপনি একটি একক URLও নির্দিষ্ট করতে পারেন। অতিরিক্তভাবে, আপনি URL গুলির একটি স্থান-বিভাজিত তালিকা ব্যবহার করতে পারেন।
URL ব্যবহার করলে ব্রাউজারটি একটি পৃথক keepalive ফেচ অনুরোধ শুরু করে—প্রতিটি URL এর জন্য একটি—যার মধ্যে Attribution-Reporting-Eligible অনুরোধ শিরোনাম অন্তর্ভুক্ত থাকে।
যদি আপনি উপাদানের মূল অনুরোধ থেকে আলাদা কোনও অনুরোধের জবাব দিয়ে উৎস নিবন্ধন করতে চান তবে এটি কার্যকর।
উদাহরণস্বরূপ, যদি আপনাকে কোনও অ্যাঙ্কর এলিমেন্টে ক্লিকের জন্য সোর্স নিবন্ধন করতে হয়, তাহলে আপনার আসলে গন্তব্যস্থলের নিয়ন্ত্রণ নাও থাকতে পারে; এই ক্ষেত্রে, আপনি এমন একটি কনফিগারেশন চাইবেন যেখানে আপনি সোর্স নিবন্ধন হেডারটি এমন একটি অনুরোধের প্রতিক্রিয়া হিসাবে পাঠাবেন যা নেভিগেশন থেকে আলাদা এবং যা আপনি সম্পূর্ণরূপে নিয়ন্ত্রণ করতে পারেন। attributionsrc এর জন্য একটি স্পষ্ট মান নির্দিষ্ট করে, আপনি ব্রাউজারকে সেই অতিরিক্ত অনুরোধটি করার এবং এর গন্তব্যস্থল কনফিগার করার নির্দেশ দিচ্ছেন।
একটি ভিউয়ের জন্য একটি অ্যাট্রিবিউশন সোর্স নিবন্ধন করতে, আপনি একটি ছবি বা স্ক্রিপ্ট ট্যাগ ব্যবহার করতে পারেন যেখানে আপনি attributionsrc অ্যাট্রিবিউট যোগ করবেন।
বিকল্পভাবে, আপনি জাভাস্ক্রিপ্ট 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 make sure 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();
ধাপ ২: হেডার দিয়ে উত্তর দিন (ক্লিক এবং ভিউ)
ক্লিক এবং ভিউ উভয়ের জন্যই পরবর্তী ধাপ হল 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"}
পরবর্তী পদক্ষেপ
অ্যাট্রিবিউশন ট্রিগার নিবন্ধন করার পদ্ধতি শিখুন।