این صفحه به‌وسیله ‏Cloud Translation API‏ ترجمه شده است.

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

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

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

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

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

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

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

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

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

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

ثبت ماشه را آغاز کنید. از یک پیکسل یا یک fetch() برای درخواست استفاده کنید.
با پاسخ دادن به هدر ثبت ماشه، ثبت ماشه را تکمیل کنید .
پس از دریافت درخواست پیکسل - ارسال شده یا به نقطه پایانی که در ویژگی معمول 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
  }
}
```

توجه: هنگامی که مرورگر یک پاسخ راه‌اندازی انتساب را از URL attributionsrc در یک صفحه دریافت می‌کند، جستجوی فضای ذخیره‌سازی محلی برای یافتن منبعی انجام می‌شود که هم با سایت مبدا و هم مقصد attributionsrc که آن صفحه به آن تعلق دارد مطابقت داشته باشد. اگر چندین منبع پیدا شود، مرورگر منبعی را انتخاب می‌کند که اخیراً ذخیره شده است-مگر اینکه منابع دارای اولویت‌های متفاوتی باشند که در آن مرورگر منبعی را انتخاب می‌کند که بیشترین اولویت را دارد.

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

اگر 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"
});

احتیاط: مقدار فیلد event_trigger_data باید در پرانتز قرار گیرد، زیرا مرورگر انتظار آرایه JSON را دارد. این برای فیلترها مفید است.

مراحل بعدی

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