ثبت منابع انتساب

نحوه ثبت منابع برای نسبت دادن کلیک ها و بازدیدها به رویدادهای مناسب را بیاموزید.

منبع انتساب یک رویداد مرتبط با آگهی است (یک کلیک یا مشاهده)، که یک فناوری تبلیغات می تواند انواع اطلاعات زیر را به آن پیوست کند:

  • داده های گزارش متنی، مانند شناسه خلاقیت آگهی، اطلاعات مربوط به کمپین، یا جغرافیا.
  • مقصد تبدیل، مانند سایتی که از کاربر انتظار دارید تبدیل کند.

با دنبال کردن مراحل این سند، می‌توانید منابعی را ثبت کنید - نمایش‌های تبلیغاتی یا کلیک‌ها - که مرورگر سپس تبدیل‌ها را به آنها نسبت می‌دهد.

روش های ثبت نام

برای ثبت منابع اسناد، از عناصر HTML یا فراخوانی جاوا اسکریپت استفاده کنید:

  • برچسب <a>
  • تگ <img>
  • تگ <script>
  • fetch تماس
  • XMLHttpRequest
  • window.open تماس

این درخواست‌های شبکه را ایجاد می‌کند و سپس با یک سرصفحه پاسخ HTTP ثبت منبع به آنها پاسخ می‌دهید.

منابع را برای کلیک ها یا بازدیدها ثبت کنید

برای ثبت منبع انتساب برای کلیک ها یا بازدیدها، مراحل ذکر شده در اینجا را دنبال کنید. مراحل کامل دنبال می شود. در اینجا خلاصه آن است:

  1. ثبت منبع را آغاز کنید . از یک عنصر HTML یا یک فراخوانی جاوا اسکریپت برای درخواست استفاده کنید. این مرحله برای کلیک ها و بازدیدها متفاوت است، همانطور که در بخش های بعدی متوجه خواهید شد.
  2. با پاسخ دادن به سربرگ ثبت منبع، ثبت منبع را تکمیل کنید . پس از دریافت آن درخواست، با سربرگ 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"}

مراحل بعدی

با نحوه ثبت عوامل انتساب آشنا شوید.