نحوه ثبت منابع برای نسبت دادن کلیک ها و بازدیدها به رویدادهای مناسب را بیاموزید.
منبع انتساب یک رویداد مرتبط با آگهی است (یک کلیک یا مشاهده)، که یک فناوری تبلیغات می تواند انواع اطلاعات زیر را به آن پیوست کند:
- داده های گزارش متنی، مانند شناسه خلاقیت آگهی، اطلاعات مربوط به کمپین، یا جغرافیا.
- مقصد تبدیل، مانند سایتی که از کاربر انتظار دارید تبدیل کند.
با دنبال کردن مراحل این سند، میتوانید منابعی را ثبت کنید - نمایشهای تبلیغاتی یا کلیکها - که مرورگر سپس تبدیلها را به آنها نسبت میدهد.
روش های ثبت نام
برای ثبت منابع اسناد، از عناصر HTML یا فراخوانی جاوا اسکریپت استفاده کنید:
- برچسب
<a>
- تگ
<img>
- تگ
<script>
-
fetch
تماس -
XMLHttpRequest
-
window.open
تماس
این درخواستهای شبکه را ایجاد میکند و سپس با یک سرصفحه پاسخ HTTP ثبت منبع به آنها پاسخ میدهید.
منابع را برای کلیک ها یا بازدیدها ثبت کنید
برای ثبت منبع انتساب برای کلیک ها یا بازدیدها، مراحل ذکر شده در اینجا را دنبال کنید. مراحل کامل دنبال می شود. در اینجا خلاصه آن است:
- ثبت منبع را آغاز کنید . از یک عنصر HTML یا یک فراخوانی جاوا اسکریپت برای درخواست استفاده کنید. این مرحله برای کلیک ها و بازدیدها متفاوت است، همانطور که در بخش های بعدی متوجه خواهید شد.
با پاسخ دادن به سربرگ ثبت منبع، ثبت منبع را تکمیل کنید . پس از دریافت آن درخواست، با سربرگ
Attribution-Reporting-Register-Source
پاسخ دهید. در آن هدر، پیکربندی Attribution Reporting مورد نظر را مشخص کنید. این مرحله هم برای کلیک ها و هم برای نمایش ها یکسان است.نمونه ای برای گزارش های خلاصه:
{ "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 واجد شرایط است. اگر از 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()
استفاده کنید.
با استفاده از لنگر
attributionsrc
به تگهای <a>
موجود که میخواهید تعداد نمایشها یا کلیکها را اندازهگیری کنید، اضافه کنید:
<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>
در مورد جاوا اسکریپت، اگر یک مقدار attributionsrc
میدهید، مطمئن شوید که URL را در صورتی که حاوی کاراکترهای خاصی مانند =
باشد، رمزگذاری کنید که باعث میشود پارامتر به درستی تجزیه نشود.
به صورت زیر رمزگذاری کنید:
const encodedUrl = encodeURIComponent(
"https://adtech.example/attribution_source?ad_id=...");
window.open(
"https://shoes.example/landing",
"_blank",
`attributionsrc=${encodedUrl}`);
attributionsrc
همچنین میتواند فهرستی از URLها را که با فاصله از هم جدا شدهاند، همانطور که در اینجا با تگ <a>
نشان داده شده است، بگیرد:
<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 درخواستهای مربوط به منبع ناوبری واجد شرایط attributionsrc
را دریافت میکنند (درخواستهایی که شامل سرصفحه Attribution-Reporting-Eligible
).
attributionsrc
با یا بدون مقدار
همانطور که قبلا دیدید، می توانید attributionsrc
بدون URL مشخص کنید. شما همچنین می توانید یک URL واحد را مشخص کنید. علاوه بر این، میتوانید از فهرستی از آدرسهای اینترنتی جدا شده با فاصله استفاده کنید.
استفاده از URLها باعث میشود که مرورگر یک درخواست واکشی نگهدارنده جداگانه - یکی برای هر URL - که شامل سرصفحه درخواست Attribution-Reporting-Eligible
آغاز کند.
اگر میخواهید با پاسخ دادن به درخواستی جدا از درخواست اصلی عنصر، ثبت منبع را انجام دهید، این کار مفید است.
برای مثال، اگر نیاز به ثبت منابع برای کلیک روی یک عنصر لنگر دارید، ممکن است در واقع کنترل مقصد را در دست نداشته باشید. در این مورد، شما یک پیکربندی می خواهید که به موجب آن سرصفحه ثبت منبع را به عنوان پاسخی به درخواستی که جدا از مسیریابی است، ارسال کنید و کاملاً بتوانید آن را کنترل کنید. با تعیین یک مقدار صریح برای attributionsrc
، به مرورگر دستور می دهید که آن درخواست اضافی را انجام دهد و مقصد آن را پیکربندی کند.
برای ثبت یک منبع انتساب برای یک نما، می توانید از یک تگ تصویر یا اسکریپت استفاده کنید که ویژگی attributionsrc
را به آن اضافه کنید.
از طرف دیگر، می توانید fetch()
JavaScript یا XMLHttpRequest()
استفاده کنید.
با یک تصویر
<img attributionsrc
src="https://adtech.example/attribution_source?ad_id=...">
با یک فیلمنامه
<script attributionsrc
src="https://adtech.example/attribution_source?ad_id=..."></script>
به صورت اختیاری، میتوانید یک مقدار URL را برای attributionsrc
به همان روشی که برای کلیکها تعیین میکند، مشخص کنید. یعنی برای یک تصویر یا اسکریپت، میتوانید URL attributionsrc
یا 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()
این کد به طور موثر کاری را که یک درخواست HTML با attributionsrc
انجام می دهد شبیه سازی می کند:
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"}
مراحل بعدی
با نحوه ثبت عوامل انتساب آشنا شوید.