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

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

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

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

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

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

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

تسري هذه التغييرات اعتبارًا من الإصدار 92 من Chrome، وهو إصدار ثابت تم طرحه في 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`.

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

راجِع Attribution Reporting API.