ثبت محرک های انتساب

بیاموزید که چگونه محرک های انتساب را برای شمارش تبدیل های خود ثبت کنید.

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

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

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

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

  • تگ <img>
  • تگ <script>
  • fetch تماس
  • XMLHttpRequest

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

یک ماشه برای نسبت دادن یک تبدیل ثبت کنید

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

  1. ثبت ماشه را آغاز کنید. از یک پیکسل یا یک fetch() برای درخواست استفاده کنید.
  2. با پاسخ دادن به هدر ثبت ماشه، ثبت ماشه را تکمیل کنید .

    پس از دریافت درخواست پیکسل - ارسال شده یا به نقطه پایانی که در ویژگی معمول src تعریف شده است، یا به نقطه پایانی تعریف شده در attributionsrc اگر استفاده از attributionsrc را انتخاب کرده اید و به آن مقدار داده اید، با سرآیند Attribution-Reporting-Register-Trigger پاسخ دهید. .

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

    مثالی برای گزارش‌های سطح رویداد:

    {
      "event_trigger_data": [{
        "trigger_data": "[unsigned 64-bit integer]",
        "priority": "[signed 64-bit integer]",
        "deduplication_key": "[unsigned 64-bit integer]"
      }]
    }
    

    نمونه ای برای گزارش های خلاصه:

    {
      ... // existing fields, such as "event_trigger_data"
    
      "aggregatable_trigger_data": [
       {
         "key_piece": "0x400",
         "source_keys": ["campaignCounts"]
       },
       {
         "key_piece": "0xA80",
         "source_keys": ["geoValue", "nonMatchingKeyIdsAreIgnored"]
       }
      ],
      "aggregatable_values": {
        "campaignCounts": 32768,
        "geoValue": 1664
      }
    }
    

برخورد با زیر دامنه ها

اگر destination https://advertiser.example باشد، تبدیل‌ها در https://advertiser.example و زیر دامنه‌های آن، مانند https://shop.advertiser.example می‌تواند نسبت داده شود.

اگر destination https://shop.advertiser.example باشد، تبدیل ها در https://advertiser.example و https://shop.advertiser.example را می توان نسبت داد.

ویژگی های مورد نیاز و اختیاری

همانطور که از عناصر HTML استفاده می کنید یا تماس های جاوا اسکریپت را برای ثبت محرک ها انجام می دهید، ممکن است لازم باشد از attributionsrc یا attributionReporting استفاده کنید. برای جزئیات بیشتر در مورد زمان مورد نیاز به جدول زیر مراجعه کنید.

وقتی attributionsrc اختیاری است، استفاده از آن نشان می‌دهد که درخواست برای گزارش Attribution واجد شرایط است. اگر از attributionsrc استفاده می کنید، مرورگر سرصفحه Attribution-Reporting-Eligible ارسال می کند. همچنین برای اندازه‌گیری برنامه به وب مفید است: اگر attributionsrc وجود داشته باشد، مرورگر سرصفحه Attribution-Reporting-Support ارسال می‌کند.

روش ثبت نام ماشه
برچسب <a> N/A : لنگرها نمی توانند یک ماشه را ثبت کنند.
تگ <img> attributionsrc اختیاری است. هدر برای ثبت یک ماشه کافی است.
تگ <script> attributionsrc اختیاری است. هدر برای ثبت یک ماشه کافی است.
fetch تماس گزینه attributionReporting مورد نیاز است.
XMLHttpRequest گزینه attributionReporting مورد نیاز است.
window.open() N/A: window.open نمی تواند یک ماشه ثبت کند.

مرحله 1: ثبت ماشه را آغاز کنید

می‌توانید با استفاده از تگ پیکسل ( <img> ) یا تگ اسکریپت، یک ماشه ثبت کنید.

استفاده از یک پیکسل تبدیل جدید یا موجود

مثال زیر با افزودن ویژگی attributionsrc انتساب را در یک تصویر موجود فعال می کند.

مبدا برای attributionsrc باید با مبدای مطابقت داشته باشد که ثبت منبع را انجام داده است.

<img src="https://advertiser.example/conversionpixel"
     attributionsrc="https://adtech.example/attribution_trigger?purchase=13">

مثال بعدی با افزودن یک ویژگی جدید pixel conversion attributionsrc انتساب را راه‌اندازی می‌کند.

مبدا src باید با مبدای مطابقت داشته باشد که ثبت منبع را انجام داده است.

<img src="https://adtech.example/conversionpixel"
     attributionsrc>

استفاده از تگ اسکریپت

شما می توانید ثبت ماشه را با یک تگ اسکریپت انجام دهید. رفتار آن مشابه <img> است. نمونه کد زیر استفاده از fetch() و XMLHttpRequest() (XHR) را نشان می دهد.

این کد به طور موثر کاری را که یک درخواست HTML با attributionsrc انجام می دهد شبیه سازی می کند:

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

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

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

attributionsrc با یا بدون مقدار

می توانید attributionsrc با یا بدون مقدار اضافه کنید.

<!-- Without a value -->
<img src="..." width="1" height="1" attributionsrc>

<!-- With a value (URL) -->
<img src="..." width="1" height="1" attributionsrc="https://...">

اگر مقداری را برای attributionsrc تنظیم کنید، می‌تواند یک یا چند نشانی اینترنتی از هم جدا شده با فاصله باشد.

استفاده از URL باعث می‌شود که مرورگر یک درخواست واکشی نگهدارنده جداگانه - یکی برای هر URL - که شامل سرصفحه درخواست Attribution-Reporting-Eligible آغاز کند.

اگر می‌خواهید با پاسخ دادن به درخواستی جدا از درخواست اصلی عنصر، ثبت ماشه را انجام دهید، این کار مفید است.

به عنوان مثال، اگر شما نیاز به ثبت تریگرها در یک عنصر تصویر دارید، ممکن است در واقع کنترل پاسخ تصویر را نداشته باشید. در این مورد، شما یک پیکربندی می خواهید که به موجب آن هدر ثبت ماشه را به عنوان پاسخی به درخواستی که جدا از تصویر است ارسال کنید و کاملاً بتوانید آن را کنترل کنید. با تعیین یک مقدار صریح برای attributionsrc ، به مرورگر دستور می دهید که آن درخواست اضافی را انجام دهد و مقصد آن را پیکربندی کند.

مرحله 2: با هدر پاسخ دهید

پس از دریافت درخواست مرورگر، پاسخ دهید و سرصفحه Attribution-Reporting-Register-Trigger در پاسخ خود بگنجانید:

JSON.stringify({
  event_trigger_data: [{
    trigger_data: "412444888111012",
    // Optional
    priority: "1000000000000",
    deduplication_key: "2345698765"
  }],
  debug_key: "1115698977"
});

مراحل بعدی

نحوه ثبت منابع ارجاع را بیاموزید.