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

Conversion Measurement API در Chrome 92 در حال تغییر است.

توجه: اگر در طول مهاجرت سؤالی دارید یا نیاز به پشتیبانی دارید، به لیست پستی بپیوندید و سؤال خود را بپرسید.

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

به دنبال تغییرات پیشنهادی API در ماه های اول سال 2021، پیاده سازی API در کروم در حال تکامل است. این چیزی است که در حال تغییر است:

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

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

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

این تغییرات از Chrome 92 اعمال می‌شوند که در 20 ژوئیه 2021 پایدار است. Chrome 92 بتای در 3 ژوئن 2021 منتشر شد.

چه کاری باید انجام دهید؟

توجه: تغییرات بیشتری در API در نسخه های بعدی وجود دارد. آنها از نامگذاری جدید اتخاذ شده در کروم 92 استفاده خواهند کرد.

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

• گزینه 1 (توصیه می‌شود) : کد خود را اکنون یا در هفته‌های بعد، در حالت ایده‌آل قبل از اواسط ژوئیه 2021، منتقل کنید. به این ترتیب، پایگاه کد شما برای تغییرات آینده آماده می‌شود و برای مشتریان جدیدتر Chrome به کار خود ادامه می‌دهد.
• گزینه 2 : منتظر بمانید تا به‌روزرسانی‌ها و ویژگی‌های بیشتری در نسخه‌های بعدی Chrome منتشر شود و همه تغییرات کد لازم را به یکباره انجام دهید.

مهاجرت

نمونه مهاجرت

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

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

کد میراث	کد جدید
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 ، شناسه رویداد 64 بیتی روی منبع انتساب تنظیم می‌شد. trigger_data : قبلاً conversion-data ، مجموعه داده‌های 3 بیتی در تغییر مسیر تریگر انتساب. ⚠️ credit حذف شده است.

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

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