[منسوخ] راهنمای مهاجرت (Chrome 92): API اندازه‌گیری تبدیل به API گزارش انتساب

API اندازه‌گیری تبدیل در کروم ۹۲ تغییر می‌کند.

چه چیزی در حال تغییر است؟

پس از تغییرات پیشنهاد API در ماه‌های اول سال ۲۰۲۱، پیاده‌سازی API در کروم در حال تکامل است. در اینجا مواردی که تغییر می‌کنند را مشاهده می‌کنید:

نام API و نام سیاست مجوزها.
نام‌های ویژگی HTML و URLهای .well-known .
قالب گزارش‌ها. گزارش‌ها اکنون به صورت JSON در بدنه درخواست ارسال می‌شوند.
محتوای گزارش‌ها: credit ، به همراه گزارش‌هایی که امتیازشان صفر بود، حذف شده است.

آنچه در کروم ۹۲ بدون تغییر باقی مانده است، مجموعه ویژگی‌های پشتیبانی‌شده است: گزارش‌های سطح رویداد، فقط برای کلیک‌ها. منتظر به‌روزرسانی‌هایی در این مورد باشید . پس از این تغییر، به‌روزرسانی‌ها و ویژگی‌های دیگری در نسخه‌های آینده کروم منتشر خواهند شد.

این تغییرات چه زمانی اعمال می‌شوند؟

این تغییرات از نسخه پایدار کروم ۹۲ در ۲۰ جولای ۲۰۲۱ اعمال می‌شوند. نسخه بتای کروم ۹۲ در ۳ ژوئن ۲۰۲۱ منتشر شد.

چه باید بکنید؟

اگر در حال اجرای یک نسخه آزمایشی اولیه بودید یا نسخه نمایشی (دمو) این API را پیاده‌سازی کرده‌اید، دو گزینه دارید:

گزینه ۱ (توصیه می‌شود) : کد خود را اکنون یا در هفته‌های بعدی، در حالت ایده‌آل قبل از اواسط ژوئیه ۲۰۲۱، منتقل کنید. به این ترتیب، کدبیس شما برای تغییرات آینده آماده خواهد بود و برای کلاینت‌های جدیدتر کروم به کار خود ادامه خواهد داد.
گزینه ۲ : منتظر بمانید تا به‌روزرسانی‌ها و ویژگی‌های بیشتری در نسخه‌های بعدی کروم منتشر شوند و تمام تغییرات لازم در کد را یکجا اعمال کنید.

مهاجرت

مثال مهاجرت

می‌توانید یک نمونه مهاجرت برای یک برنامه آزمایشی کوچک را در این درخواست pull (پیش‌نویس) مشاهده کنید.

کد خط‌مشی مجوزها را به‌روزرسانی کنید

کد قدیمی	کد جدید
`allow='conversion-measurement'`	`allow='attribution-reporting'`

کد تشخیص ویژگی خود را به‌روزرسانی کنید

کد قدیمی	کد جدید
`document.featurePolicy.features() .includes('conversion-measurement')`	`document.featurePolicy.features() .includes('attribution-reporting')`

به‌روزرسانی ویژگی‌های HTML

کد قدیمی	کد جدید
`conversiondestination`	`attributiondestination`
`impressiondata`	`attributionsourceeventid`
`impressionexpiry`	`attributionexpiry`
`reportingorigin`	`attributionreportto`

آرگومان‌های `window.open()` را به‌روزرسانی کنید

یک منبع انتساب می‌تواند برای ناوبری‌هایی که توسط window.open() آغاز می‌شوند، ثبت شود. اگر از window.open() برای ثبت منابع انتساب استفاده می‌کنید، این فراخوانی‌ها را به‌روزرسانی کنید.

کد جدید شما باید به شکل زیر باشد (این تغییر نام از تغییر نام ویژگی‌های HTML پیروی می‌کند):

window.open(
  'https://dest.example',
  '_blank',
  'attributionsourceeventid=1234,attributiondestination=https://dest.example,attributionreportto=https://reporter.example,attributionexpiry=604800000'
);

URL و پارامتر فراخوان ثبت نام خود را به‌روزرسانی کنید

کد قدیمی	کد جدید
`.well-known/register-conversion?conversion-data={DATA}`	`.well-known/attribution-reporting/trigger-attribution?trigger-data={DATA}`

کد نقطه پایانی گزارش‌دهی خود را به‌روزرسانی کنید

	کد قدیمی	کد جدید
درخواست‌هایی که باید از مرورگر انتظار داشت	`.well-known/register-conversion?impression-data=&conversion-data={DATA}&attribution-credit=100`	`.well-known/attribution-reporting/trigger-attribution`
گزارش‌های دریافتی	به عنوان پارامترهای URL ارسال می‌شود.	به صورت JSON در بدنه درخواست ارسال می‌شود. داده‌های گزارش به عنوان یک شیء JSON با کلیدهای زیر در بدنه درخواست گنجانده شده‌اند: `source_event_id` : قبلاً `impression-data` ، شناسه رویداد ۶۴ بیتی که روی منبع انتساب تنظیم شده است. `trigger_data` : قبلاً `conversion-data` نامیده می‌شد، مجموعه داده‌های ۳ بیتی در تغییر مسیر trigger مربوط به Attribution. ⚠️ `credit` حذف شده است.

گزارش انتساب: همه منابع

به گزارش انتساب مراجعه کنید.