উপযুক্ত ইভেন্টগুলিতে ক্লিক এবং ভিউ অ্যাট্রিবিউট করার জন্য কীভাবে উত্স নিবন্ধন করবেন তা শিখুন।
একটি অ্যাট্রিবিউশন উৎস হল একটি বিজ্ঞাপন-সম্পর্কিত ইভেন্ট (একটি ক্লিক বা ভিউ), যার সাথে একটি বিজ্ঞাপন প্রযুক্তি নিম্নলিখিত ধরণের তথ্য সংযুক্ত করতে পারে: - প্রাসঙ্গিক রিপোর্টিং ডেটা, যেমন বিজ্ঞাপন ক্রিয়েটিভ আইডি, প্রচারাভিযান সম্পর্কে তথ্য বা ভূগোল৷ - একটি রূপান্তর গন্তব্য, যেমন সাইটে আপনি ব্যবহারকারীকে রূপান্তর করতে আশা করেন।
এই ডকুমেন্টের ধাপগুলি অনুসরণ করে, আপনি উৎসগুলি নিবন্ধন করতে পারেন—বিজ্ঞাপনের ইমপ্রেশন বা ক্লিকগুলি—যাতে ব্রাউজার তখন রূপান্তরগুলিকে দায়ী করে৷
নিবন্ধন পদ্ধতি
অ্যাট্রিবিউশন উত্স নিবন্ধন করতে, HTML উপাদান বা জাভাস্ক্রিপ্ট কল ব্যবহার করুন:
-
<a>
ট্যাগ -
<img>
ট্যাগ -
<script>
ট্যাগ - কল
fetch
-
XMLHttpRequest
-
window.open
এটি নেটওয়ার্ক অনুরোধগুলি তৈরি করে যা আপনি একটি উত্স নিবন্ধন HTTP প্রতিক্রিয়া শিরোনামের সাথে প্রতিক্রিয়া জানান৷
ক্লিক বা দর্শনের জন্য উত্স নিবন্ধন করুন
ক্লিক বা ভিউয়ের জন্য একটি অ্যাট্রিবিউশন উত্স নিবন্ধন করতে, এখানে বর্ণিত ধাপগুলি অনুসরণ করুন৷ সম্পূর্ণ পদক্ষেপ অনুসরণ করুন. এখানে সারসংক্ষেপ:
- উৎস নিবন্ধন শুরু করুন . একটি অনুরোধ করতে একটি HTML উপাদান বা একটি JavaScript কল ব্যবহার করুন৷ এই ধাপটি ক্লিক এবং ভিউয়ের জন্য আলাদা, আপনি নিম্নলিখিত বিভাগে লক্ষ্য করবেন।
সোর্স রেজিস্ট্রেশন হেডার দিয়ে উত্তর দিয়ে সোর্স রেজিস্ট্রেশন সম্পূর্ণ করুন । সেই অনুরোধ পাওয়ার পর, শিরোনাম
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">
JavaScript ক্ষেত্রে, আপনি যদি attributionsrc
একটি মান দেন, তাহলে সেই URLটিকে এনকোড করতে ভুলবেন না যদি এতে '=' এর মতো বিশেষ অক্ষর থাকে যা প্যারামিটারটিকে ভুলভাবে পার্স করতে পারে।
নিম্নরূপ এনকোড:
const encodedUrl = encodeURIComponent(
'https://adtech.example/attribution_source?ad_id=...');
window.open(
"https://shoes.example/landing",
"_blank",
attributionsrc=${encodedUrl});
attributionsrc
এখানে একটি অ্যাঙ্কর ট্যাগ দিয়ে চিত্রিত URL-এর একটি স্থান-বিচ্ছিন্ন তালিকাও নিতে পারে:
<!-- With an anchor tag -->
<a href=... attributionsrc="https://a.example/register-source
https://b.example/register-source">
অথবা এটি এখানে window.open()
ব্যবহার করে।
// With window.open()
window.open('...', '_blank', attributionsrc=${encodedUrl1}
attributionsrc=${encodedUrl2})
এই ধরনের ক্ষেত্রে, উভয় ইউআরএলই navigation-source-eligible
attributionsrc
অনুরোধগুলি পায় (অনুরোধ যাতে Attribution-Reporting-Eligible
শিরোনাম অন্তর্ভুক্ত থাকে)।
একটি মান সহ বা ছাড়া attributionsrc
আপনি আগে দেখেছেন, আপনি একটি URL ছাড়া attributionsrc
নির্দিষ্ট করতে পারেন। আপনি একটি একক URLও নির্দিষ্ট করতে পারেন। উপরন্তু, শুধুমাত্র উৎসের জন্য ( ট্রিগারের ক্ষেত্রে প্রযোজ্য নয়), আপনি URL-এর একটি স্থান-বিচ্ছিন্ন তালিকা ব্যবহার করতে পারেন।
ইউআরএল ব্যবহার করার ফলে ব্রাউজার একটি আলাদা রাখা লাইভ আনার অনুরোধ শুরু করে—প্রতিটি ইউআরএলের জন্য একটি—যাতে Attribution-Reporting-Eligible
অনুরোধের শিরোনাম রয়েছে।
আপনি যদি উপাদানটির মূল অনুরোধ থেকে আলাদা একটি অনুরোধের প্রতিক্রিয়া জানিয়ে উত্স নিবন্ধন করতে চান তবে এটি কার্যকর।
উদাহরণস্বরূপ, যদি আপনাকে একটি অ্যাঙ্কর উপাদানে ক্লিকের জন্য উত্স নিবন্ধন করতে হয়, আপনি আসলে গন্তব্যের নিয়ন্ত্রণে নাও থাকতে পারেন; এই ক্ষেত্রে, আপনি একটি কনফিগারেশন চাইবেন যার মাধ্যমে আপনি নেভিগেশন থেকে আলাদা একটি অনুরোধের প্রতিক্রিয়া হিসাবে উৎস নিবন্ধন শিরোনাম পাঠাবেন এবং আপনি সম্পূর্ণ নিয়ন্ত্রণ করতে পারবেন। attributionsrc
এর জন্য একটি সুস্পষ্ট মান নির্দিষ্ট করে, আপনি ব্রাউজারকে সেই অতিরিক্ত অনুরোধ করতে এবং এর গন্তব্য কনফিগার করার নির্দেশ দিচ্ছেন।
ভিউ নিবন্ধনের ধাপ 1 এর জন্য ট্যাবে যান এবং ভিউ ধাপ 1 নির্বাচন করুন।
একটি দৃশ্যের জন্য একটি অ্যাট্রিবিউশন উত্স নিবন্ধন করতে, আপনি একটি চিত্র বা স্ক্রিপ্ট ট্যাগ ব্যবহার করতে পারেন যেখানে আপনি বিকল্পভাবে, আপনি JavaScript ঐচ্ছিকভাবে, আপনি ক্লিকের মতোই একটি একক URL সহ: URL-এর তালিকা সহ: এই কোডটি কার্যকরভাবে অনুকরণ করে যে ক্লিক নিবন্ধন করার ধাপ 1 এর জন্য ট্যাবে যান এবং ক্লিক ধাপ 1 নির্বাচন করুন। attributionsrc
বৈশিষ্ট্য যোগ করবেন৷fetch()
বা XMLHttpRequest()
ব্যবহার করতে পারেন। একটি ইমেজ সঙ্গে
<img attributionsrc
src="https://adtech.example/attribution_source?ad_id=..."/>
একটি স্ক্রিপ্ট সহ
<script attributionsrc
src="https://adtech.example/attribution_source?ad_id=..."/>
attributionsrc
এর জন্য একটি URL মান নির্দিষ্ট করতে পারেন; অর্থাৎ, একটি ইমেজ বা স্ক্রিপ্টের জন্য, আপনি attributionsrc
URL বা URL গুলি সেট করতে পারেন: attributionsrc="https://adtech.example/attribution_source?ad_id=123"
attributionsrc="https://a.example/register-source
https://b.example/register-source"
fetch()
বা XMLHttpRequest()
ব্যবহার করেattributionsrc
সহ একটি HTML অনুরোধ কী করবে:// With fetch
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 });
// With XHR
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"}