تعديلات على إعداد تقارير الإحالة في حزيران (يونيو) 2022

سيتم تغيير اقتراح "تقارير تحديد المصدر" لإصدار Chrome 104، مع توفُّر آليات ووظائف وتحديثات جديدة لواجهة برمجة التطبيقات لخدمة التجميع.

من هم المستخدمون المعنيون بهذه التعديلات؟

يمكنك الاطّلاع على هذه التعديلات في الحالات التالية:

• أنت على دراية بواجهة برمجة التطبيقات، على سبيل المثال، إذا كنت تراقب أو المشاركة في المناقشات حول مستودع WICG ويريدون فهم التغييرات التي تم إجراؤها على واجهة برمجة التطبيقات.
• أنت تستخدم Attribution Reporting API في عرض توضيحي أو تخطط للاختبار في مرحلة التجربة والتقييم

في حال كنت لا تزال مبتدئًا في استخدام واجهة برمجة التطبيقات هذه و/أو لم تجرِّب انتقل مباشرةً إلى مقدمة إلى API بدلاً من ذلك.

التعديلات على Attribution Reporting API

العرض التوضيحي لإعداد تقارير تحديد المصدر لتعكس أحدث التغييرات في إعداد تقارير تحديد المصدر من جهة العميل.

معظم التغييرات لا تتطلب اتخاذ أي إجراء. التطبيقات التي تتطلب تحديثات موضع التنفيذ أدناه.

(مطلوب اتخاذ إجراء) عناوين موحّدة للتسجيل

تم توحيد العناوين. هناك الآن عنوان واحد فقط للمصادر وآخر للمشغلات المنسقة بتنسيق 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 في التقارير القابلة للتجميع.

دعم خدمة التجميع

في Chrome 104، نعتزم تحديث تنسيق بعض المعلومات داخل للتقارير القابلة للتجميع. نعمل حاليًا على توفير الدعم لهذا التغيير في خدمة تجميع البيانات سيتم تحديث هذا المستند، بالإضافة إلى changelog، بعد شحن التغييرات.

لقد جمعنا وثيقة نصائح واستراتيجيات عملية لإنشاء ملخص التقارير. هناك عدد من الإحصاءات، بما في ذلك:

• نظرة عامة على التشويش في إنشاء تقارير الملخّص
• شرح تفصيلي للسمات والمفاتيح والقيم
• مفاتيح تجميع البيانات عمليًا، بما في ذلك خريطة البنية الرئيسية
• القيم القابلة للتجميع عمليًا والآثار المترتبة على ميزانية المساهمة
• دليل تجربة إبسيلون

مزيد من المعلومات عن التعديلات

• اطّلِع على ما يجب معرفته عن واجهة برمجة التطبيقات.
• اطّلِع على تجربة تقارير تحديد المصدر: إستراتيجيات ونصائح بشأن التقارير الموجزة.

صورة العنوان مأخوذة من قناة Diana Polekhina على Unسباش.