[Obsolete] دليل نقل البيانات (Chrome 92): Conversion Measurement API to Attribution Reporting API

يتم إجراء تغيير على Conversion Measurement API في Chrome 92.

ما الذي سيتغيّر؟

بعد التغييرات التي تم إجراؤها على اقتراح واجهة برمجة التطبيقات في الأشهر الأولى من عام 2021، تتطوّر طريقة تنفيذ واجهة برمجة التطبيقات في Chrome. في ما يلي بعض التغييرات التي سنُجريها:

  • اسم واجهة برمجة التطبيقات واسم سياسة الأذونات
  • أسماء سمات HTML وعناوين URL الخاصة بـ .well-known
  • تنسيق التقارير. يتم الآن إرسال التقارير بتنسيق JSON في نص الطلب.
  • محتوى التقارير: تمت إزالة credit، بالإضافة إلى التقارير التي كان من الممكن أن يكون لها 0 رصيد.

وما لم يتغير في الإصدار 92 من Chrome هو مجموعة الميزات المتوافقة: التقارير على مستوى الحدث للنقرات فقط. ننصحك بالاطّلاع على آخر المعلومات عن هذا الموضوع. وبعد هذا التغيير، سيتم إطلاق تحديثات وميزات أخرى في إصدارات Chrome المستقبلية.

متى سيتم تطبيق هذه التغييرات؟

وستسري هذه التغييرات اعتبارًا من Chrome 92، والتي تم إيقافها في 20 تموز (يوليو) 2021. تم إصدار الإصدار التجريبي من Chrome 92 في 3 حزيران (يونيو) 2021.

ما هي الإجراءات التي عليك اتخاذها؟

إذا كنت تشغِّل تجربة أصل أو نفّذت إصدارًا تجريبيًا لواجهة برمجة التطبيقات هذه، لديك خياران:

  • الخيار 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.

إعداد تقارير الإحالة: جميع الموارد

اطّلِع على تقارير الإحالة.