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

سيتم تغيير واجهة برمجة التطبيقات Conversion Measurement API في الإصدار 92 من Chrome.

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

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

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

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

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

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

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

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

  • الخيار 1 (مُقترَح): نقل الرمز البرمجي الآن أو في الأسابيع التالية، ويُفضَّل قبل mid-July 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.

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

راجِع تقارير تحديد المصدر.