سيتم تغيير اقتراح "تقارير تحديد المصدر" للإصدار 104 من Chrome، مع إضافة آليات ووظائف وتحديثات جديدة لواجهة برمجة التطبيقات على خدمة التجميع.
لمن هذه التعديلات؟
هذه التعديلات مناسبة لك في الحالات التالية:
- أنت على دراية بواجهة برمجة التطبيقات، على سبيل المثال، إذا كنت تراقب أو تشارك في المناقشات حول مستودع WICG وتريد فهم التغييرات التي تم إجراؤها على واجهة برمجة التطبيقات.
- أنت تستخدم Attribution Reporting API في إصدار تجريبي أو تخطط لاختباره في تجربة المصدر.
إذا كنت قد بدأت حديثًا في استخدام واجهة برمجة التطبيقات هذه و/أو لم تجرِها لها بعد، انتقِل مباشرةً إلى مقدمة حول واجهة برمجة التطبيقات بدلاً من ذلك.
تعديلات Attribution Reporting API
تم تعديل العرض التوضيحي لإعداد تقارير الإحالة ليعكس آخر التغييرات التي تم إجراؤها على Attribution Reporting من واجهة برمجة التطبيقات من جهة العميل.
معظم التغييرات لا تتطلب أي إجراء. وقد تم تمييز تلك التي تتطلب تحديثات لتنفيذك أدناه.
(مطلوب اتخاذ إجراء) رؤوس موحَّدة للتسجيل
تم توحيد الرؤوس. يوجد الآن عنوان واحد فقط للمصادر وعنوان واحد للمشغلات، بتنسيق JSON.
- لتسجيل مصادر تحديد المصدر، يمكنك الردّ على طلبات التسجيل
باستخدام العنوان
Attribution-Reporting-Register-Source. - لإكمال تسجيل المشغِّل، اضبط
عنوان
Attribution-Reporting-Register-Trigger.
يتطلب هذا التغيير اتخاذ إجراء. يُرجى الاطّلاع على دليل مطوّر واجهات برمجة التطبيقات للاطّلاع على مزيد من المعلومات.
(مطلوب اتخاذ إجراء) أصبحت مفاتيح التجميع الآن قاموسًا
لتسجيل مصادر تحديد المصدر،
عليك مواصلة استخدام aggregation_keys، ولكن يتم تخزينها الآن كقاموس JSON
بدلاً من قائمة.
مثال:
"aggregation_keys": {
// Generate a "0x159" key piece for the key named "campaignCounts".
"campaignCounts": "0x159", // User saw ad from campaign 345 (out of 511)
// Generates a "0x5" key piece (low order bits of the key) for
// the key named "geoValue".
"geoValue": "0x5" // Source-side geo region = 5 (US), out of a possible ~100 regions
}
يتطلب هذا التغيير اتخاذ إجراء. راجِع كتيب واجهة برمجة التطبيقات للاطّلاع على مزيد من المعلومات.
إنشاء التقرير
يمكنك اختيار إنشاء تقارير قابلة للتجميع فقط، والتي يمكن تجميعها في شكل تقارير موجزة. إذا لم تتطابق الفلاتر مع أي عوامل تشغيل للأحداث، لن يتم إنشاء أي تقارير على مستوى الحدث.
إعداد مفتاح تصحيح الأخطاء الموحّد
يجب الآن ضبط مفتاح تصحيح الأخطاء في العناوين المصدر وعوامل التشغيل، بدلاً من استخدام عناوين منفصلة. تعرَّف على مزيد من المعلومات حول كيفية تصحيح أخطاء التقارير.
تسجيل مصادر تحديد المصدر
يمكن الآن استخدام علامات النصوص البرمجية لتسجيل مصادر تحديد المصدر، بالطريقة نفسها التي يتم بها استخدام علامة <img>.
المزيد من تحديثات واجهة برمجة التطبيقات
تشمل التغييرات الأخرى التي تم إجراؤها في دليل واجهة برمجة التطبيقات ما يلي:
- يمكن تسجيل المصادر باستخدام واجهات برمجة التطبيقات لطلبات JavaScript.
- تمت إزالة الحقل "
window.registerSource". - أصبح الآن تضمين قيمة في الحقل
attributionsrcاختياريًا عند تسجيل المصادر. - تمت إضافة عنوان
Attribution-Reporting-Eligibleإلى طلبات تسجيل المصدر الواردة. - حدث تغيير بسيط في
encodeURIComponent. - تمت إزالة مفتاح ميزانية الخصوصية
من الحقل
shared_infoفي التقارير القابلة للتجميع.
دعم خدمة تجميع البيانات
ننوي تعديل تنسيق بعض المعلومات في الإصدار 104 من Chrome داخل التقارير المجمّعة. نعمل حاليًا على إنشاء دعم لهذا التغيير في خدمة التجميع. سيتم تحديث هذا المستند، بالإضافة إلى سجل التغييرات، بعد شحن التغييرات.
لقد جمعنا مستند يتضمن نصائح واستراتيجيات عملية لإنشاء تقارير ملخصة. هناك عدد من الرؤى، بما في ذلك:
- نظرة عامة على التشويش في إنشاء تقارير الملخص
- شرح تفصيلي للسمات والمفاتيح والقيم
- استخدام مفاتيح تجميع البيانات، بما في ذلك خريطة بنية المفاتيح
- القيم المجمّعة من الناحية العملية، والآثار المترتبة على ميزانية المساهمات
- دليل خوض التجربة باستخدام الإبسيلون
الاطّلاع على مزيد من المعلومات عن التعديلات
- يُرجى الاطّلاع على المعلومات المطلوب معرفتها عن واجهة برمجة التطبيقات.
- اطّلِع على تجربة تقارير تحديد المصدر: الاستراتيجية ونصائح للتقارير التلخيصية.
صورة العنوان مأخوذة من Diana Polekhina على منصة Unسبلاش.