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

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

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

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

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

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

برای ثبت منابع اسناد، از عناصر 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">

در مورد جاوا اسکریپت، اگر مقدار attributionsrc می‌دهید، مطمئن شوید که URL را در صورتی که دارای کاراکترهای خاصی مانند '=' باشد، رمزگذاری کنید که باعث می‌شود پارامتر به درستی تجزیه نشود.

به صورت زیر کد گذاری کنید:

const encodedUrl = encodeURIComponent(
  'https://adtech.example/attribution_source?ad_id=...');
window.open(
  "https://shoes.example/landing",
   "_blank",
   attributionsrc=${encodedUrl});

attributionsrc همچنین می‌تواند فهرستی از URLها را که با فاصله از هم جدا شده‌اند، همانطور که در اینجا نشان داده شده است، با یک تگ لنگر دریافت کند:

<!-- With an anchor tag -->
<a href=... attributionsrc="https://a.example/register-source 
  https://b.example/register-source">

یا همانطور که اینجاست با استفاده از window.open() .

// With window.open()
window.open('...', '_blank', attributionsrc=${encodedUrl1}
  attributionsrc=${encodedUrl2})

در چنین مواردی، هر دو URL درخواست‌های navigation-source-eligible attributionsrc دریافت می‌کنند (درخواست‌هایی که شامل سرصفحه Attribution-Reporting-Eligible هستند).

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

همانطور که قبلا دیدید، می توانید attributionsrc بدون URL مشخص کنید. شما همچنین می توانید یک URL واحد را مشخص کنید. به‌علاوه، فقط برای منابع (برای راه‌اندازها قابل اعمال نیست)، می‌توانید از فهرستی از نشانی‌های وب جدا شده با فاصله استفاده کنید.

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

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

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

برای مرحله 1 ثبت نماها به برگه ها رفته و Views step 1 را انتخاب کنید.

برای ثبت یک منبع انتساب برای یک نما، می توانید از یک تگ تصویر یا اسکریپت استفاده کنید که ویژگی attributionsrc را به آن اضافه کنید.

از طرف دیگر، می توانید fetch() JavaScript یا XMLHttpRequest() استفاده کنید.

با یک تصویر

<img attributionsrc
src="https://adtech.example/attribution_source?ad_id=..."/>

با یک فیلمنامه

<script attributionsrc
  src="https://adtech.example/attribution_source?ad_id=..."/>

به صورت اختیاری، می‌توانید یک مقدار URL را برای attributionsrc به همان روشی که برای کلیک‌ها تعیین می‌کند، مشخص کنید. یعنی برای یک تصویر یا اسکریپت، می‌توانید URL attributionsrc یا URL‌هایی مانند این را تنظیم کنید:

با یک URL واحد:

 attributionsrc="https://adtech.example/attribution_source?ad_id=123"

با لیستی از URL ها:

  attributionsrc="https://a.example/register-source
    https://b.example/register-source"

استفاده از `fetch()` یا `XMLHttpRequest()`

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

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

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

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

برای مرحله 1 ثبت کلیک، به برگه ها بروید و مرحله 1 کلیک را انتخاب کنید.

مرحله 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"}

مراحل بعدی

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