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

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

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

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

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

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

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

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

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

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

  1. ثبت ماشه را آغاز کنید. از یک پیکسل یا یک fetch() 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]"
  }]
}
```

**Example for summary reports:**

```json
{
  ... // 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 Anchors نمی توانند یک ماشه را ثبت کنند.
تگ <img> attributionsrc اختیاری است. هدر برای ثبت یک ماشه کافی است.
تگ <script> attributionsrc اختیاری است. هدر برای ثبت یک ماشه کافی است.
fetch تماس گزینه attributionReporting مورد نیاز است.
XMLHttpRequest گزینه attributionReporting مورد نیاز است.
window.open() N/A window.open نمی تواند یک ماشه ثبت کند.

مرحله 1: ثبت ماشه را شروع کنید

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

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

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

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

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

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

// With fetch
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 });

// With XMLHttpRequest:
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 باعث می‌شود که مرورگر یک درخواست واکشی نگهدارنده جداگانه را آغاز کند - یکی برای هر 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'})

مراحل بعدی

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