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

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

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

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

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

أما ما لم يتغيَّر في الإصدار 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".

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

اطّلِع على تقارير تحديد المصدر.