اختبار واجهات برمجة التطبيقات لقياس الأداء ومدى صلة الإعلانات بـ "مبادرة حماية الخصوصية"

تتضمّن مبادرة حماية الخصوصية مجموعة من الاقتراحات لتفعيل حالات استخدام الإعلانات بدون الحاجة إلى تتبُّع إجراءات المستخدم على مواقع إلكترونية متعددة. توفّر التجارب الأصلية فرصة للمطوّرين لتقييم تقنيات الويب الجديدة وتقديم ملاحظات عنها من خلال إجراء اختبارات على أرض الواقع. في تجارب المصدر السابقة، كان بإمكان المواقع الإلكترونية الاختبار مقابل واجهات برمجة التطبيقات الفردية. بالنسبة إلى Topics API وFLEDGE وAttribution Reporting API، نقدّم تجربة ذات مصدر واحد تسمح للمواقع الإلكترونية بإجراء تجارب موحَّدة على واجهات برمجة التطبيقات التي تشكِّل نسخة أولية من دورة حياة الإعلان الشاملة. تتوفّر واجهات برمجة التطبيقات للاختبار في الإصدار التجريبي من Chrome 101 والإصدارات الأحدث. يتضمّن إصدار Chrome 101 التجريبي أيضًا تحديثات لعناصر تحكّم المستخدم بينما نواصل تكرار خيارات الضبط.

بصفتك مطوِّرًا، ستتمكّن من الاشتراك في هذه التجربة ذات المصدر الواحد التي تتيح لك اختبار واجهات برمجة التطبيقات Topics وFLEDGE وAttribution Reporting API. يصحبك هذا الدليل خلال خطوات الإعداد للوصول إلى واجهات برمجة التطبيقات، ويوضح كيفية التحقّق من صحة الإعدادات، ويوفر المزيد من الموارد لإجراء الاختبار على واجهات برمجة التطبيقات.

ماذا تتضمّن مرحلة التجربة والتقييم؟

تهدف مرحلة التجربة والتقييم هذه إلى السماح بإجراء اختبارات ذات مغزى خلال دورة حياة الإعلان على عدة مواقع إلكترونية. ولتغطية هذه الرحلة، تشمل مرحلة التجربة والتقييم ما يلي:

  • Topics لمراقبة مواضيع المتصفّح والوصول إليها من خلال document.browsingTopics()
  • FLEDGE لإدارة مجموعات الاهتمامات على المتصفّح، بالإضافة إلى عروض أسعار الإعلانات والاختيار استنادًا إلى تلك المجموعات والإشارات الأخرى.
    • في مرحلة التجربة والتقييم هذه، يتوفّر FLEDGE على أجهزة الكمبيوتر المكتبي ويتضمّن مجموعة فرعية معيّنة من جميع الوظائف المقترَحة. اقرأ تفاصيل مرحلة التجربة والتقييم في FLEDGE للحصول على مزيد من المعلومات.
  • الإطارات المضمّنة لعرض عنوان URL غير شفاف للفائز بمزاد الإعلانات FLEDGE.
  • تقارير تحديد المصدر لقياس الأداء وإعداد تقارير عنه خلال مراحل نشاط الإعلانات
    • كجزء من "تقارير تحديد المصدر"، يجب معالجة التقارير المجمَّعة وتجميعها من خلال خدمة التجميع لإنشاء تقارير ملخّصة. سننشر قريبًا أدوات وأدلة إضافية للاختبار المحلي ومرحلة التجربة
    • إذا كنت قد شاركت في تجارب المنشأ السابقة لإعداد تقارير تحديد المصدر، اعلم أنّك ستحتاج إلى إجراء تعديل متوافق مع أحدث التغييرات في واجهة برمجة التطبيقات. يُرجى الرجوع إلى دليل نقل البيانات للاطّلاع على التفاصيل.

يسمح هذا الإعداد بإجراء اختبار موحّد على جميع واجهات برمجة التطبيقات هذه، إلا أنّه يمكنك انتقاء واختيار الجوانب التي تريد تنفيذها، حسب الحاجة.

كيف يمكن للمطوّرين الاشتراك في مرحلة التجربة والتقييم؟

سجِّل في تجربة مدى الصلة بالموضوع والقياس في "مبادرة حماية الخصوصية". باستخدام علامات HTML التالية، قدِّم رمزًا مميّزًا للإصدار التجريبي في كل صفحة تريد تشغيل رمز واجهة برمجة التطبيقات فيها:

  • علامة <meta> في قسم <head> لصفحة المستوى الأعلى: <meta http-equiv="origin-trial" content="TOKEN_GOES_HERE">
  • عنوان HTTP في استجابة صفحة المستوى الأعلى: Origin-Trial: TOKEN_GOES_HERE

إنّ بعض الوظائف المتوفّرة في مرحلة التجربة والتقييم مصمّمة للاستخدام في سياقات عدّة مواقع إلكترونية، كما هو الحال عند تقديم خدمة كجهة خارجية على موقع إلكتروني ذي مستوى أعلى. إذا كنت بحاجة إلى تفعيل مرحلة التجربة والتقييم لهذه السياقات الإضافية، تأكَّد من تحديد خيار "مطابقة الجهة الخارجية". لتفعيل مرحلة التجربة والتقييم من محتوى JavaScript تابع لجهة خارجية، عليك إدخال العلامة <meta> في صفحة المستوى الأعلى (أي صفحة الطرف الأول، وليس المحتوى الخاص بك) من النص البرمجي. مثال:

const otMeta = document.createElement('meta');
otMeta.setAttribute('http-equiv', 'origin-trial');
otMeta.setAttribute('content', 'TOKEN_GOES_HERE');
document.querySelector('head').appendChild(otMeta);

اطّلِع على مزيد من المعلومات في دليل بدء استخدام مرحلة التجربة والتقييم في Chrome.

كيف يختبر المطوّرون محليًا؟

إنّ مستندات المطوّرين الفردية التي تخصّ Topics وFLEDGE وتقارير تحديد المصدر توفِّر إرشادات خاصة حول اختبارات المطوِّرين المحليين لكل واجهة برمجة تطبيقات. لا تكون واجهات برمجة التطبيقات مفعّلة تلقائيًا ويجب تفعيلها باستخدام علامات للاختبار.

لتفعيل واجهات برمجة التطبيقات للاختبار، يجب تنفيذ ما يلي:

  • استخدام الإصدار 101 من الإصدار التجريبي أو الإصدارات الأحدث من Chrome
    • يتطلب FLEDGE متصفح Chrome على سطح المكتب.
    • لا تتوفر واجهات برمجة التطبيقات على إصدارات iOS من Chrome.
  • تفعيل واجهات برمجة التطبيقات باستخدام العلامة chrome://flags/#privacy-sandbox-ads-apis
    • تفرض هذه العلامة تفعيل واجهات برمجة التطبيقات لتسهيل الاختبار. وإذا كنت تريد تكرار مستخدم مؤهَّل للإصدار التجريبي حيث لا يزال بإمكان إعداداته الإضافية إيقاف واجهات برمجة التطبيقات، عليك تشغيل Chrome باستخدام علامات واجهة سطر الأوامر: --enable-features=BrowsingTopics,InterestGroupStorage,AllowURNsInIframes,PrivacySandboxAdsAPIs.
    • قد تحتوي واجهات برمجة التطبيقات الفردية على علامات إضافية أكثر للحصول على إعدادات أكثر دقة، ويمكنك الرجوع إلى الأدلة الفردية للاطّلاع على التفاصيل.
    • قد تتعارض العلامات الإضافية مع هذه العلامة، لذا ضع في اعتبارك إعداد هذه العلامة الوحيدة فقط إذا كنت تواجه مشاكل.
  • تفعيل الإصدارات التجريبية في "مبادرة حماية الخصوصية" في إعدادات Chrome: الإعدادات > الأمان والخصوصية > مبادرة حماية الخصوصية. يمكن أيضًا الوصول إلى تلك البيانات على chrome://settings/adPrivacy.
  • تفعيل ملفات تعريف الارتباط التابعة لجهات خارجية في إعدادات Chrome: الإعدادات > الأمان والخصوصية. اضبط ملفات تعريف الارتباط وبيانات الموقع الإلكتروني الأخرى على "السماح بجميع ملفات تعريف الارتباط" أو "حظر ملفات تعريف الارتباط التابعة لجهات خارجية في وضع التصفّح المتخفي". يمكن الوصول إلى هذه أيضًا على chrome://settings/cookies.
  • أن تكون في جلسة تصفُّح عادية. عدم استخدام وضع التصفُّح المتخفي

كيف يتحقّق المطوّرون من إعداد مرحلة التجربة والتقييم بشكلٍ صحيح؟

يوفّر القسم تحديد وحلّ المشاكل في تجارب المصدر في Chrome قائمة تحقُّق مفصَّلة للتحقّق من صحة ضبط مرحلة التجربة والتقييم.

&quot;أدوات مطوري البرامج&quot; تعرض حالة مرحلة التجربة والتقييم ضمن &quot;التطبيقات&quot;

تعرض "أدوات مطوري البرامج" حالة مرحلة التجربة والتقييم في علامة التبويب "التطبيقات" ضمن "الإطارات".

لن تظهر مرحلة التجربة والتقييم على أنّها نشطة إلا للمستخدمين المؤهَّلين كما هو موضّح أدناه، ولكن يمكنك أيضًا استخدام علامات المطوّرين لاختبار التطبيق على موقع الإنتاج الإلكتروني الخاص بك.

مَن هم المستخدمون المؤهّلون لمرحلة التجربة والتقييم؟

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

ومع ذلك، للسماح بإجراء اختبار موحّد على المواقع الإلكترونية، يجب أن تظل هذه المجموعة من المستخدمين المؤهَّلين متسقة في الغالب. على سبيل المثال، إذا كان المستخدم مؤهَّلاً لتجربة المصدر عند مشاهدة إعلان على موقع إلكتروني لناشر مشارك، يجب أن يكون هذا المستخدم نفسه مؤهّلاً عند إجراء إحالة ناجحة على موقع إلكتروني لمعلن مشارِك.

لكي يكون المستخدم مؤهَّلاً، يجب أن يستوفي الشروط التالية:

  • تستخدم الإصدار الإصدار التجريبي من Chrome 101 أو الإصدارات الأحدث
    • يتطلب FLEDGE متصفح Chrome على سطح المكتب.
    • لا تتوفّر أي تجارب المصدر على إصدارات iOS من Chrome.
  • الذين يتصفّحون الإنترنت خلال فترة التجربة والتقييم النشط.
  • أن تكون الإصدارات التجريبية من "مبادرة حماية الخصوصية" مفعّلة من خلال الإعدادات > الأمان والخصوصية > "مبادرة حماية الخصوصية"، والتي يمكن الوصول إليها أيضًا من خلال chrome://settings/adPrivacy.
  • تفعيل ملفات تعريف الارتباط التابعة لجهات خارجية من خلال الإعدادات > الأمان والخصوصية > ملفات تعريف الارتباط وبيانات الموقع الإلكتروني الأخرى التي تم ضبطها على "السماح بجميع ملفات تعريف الارتباط" أو "حظر ملفات تعريف الارتباط التابعة لجهات خارجية في وضع التصفّح المتخفي"، ويمكن الوصول إليها أيضًا من خلال chrome://settings/cookies.
  • أن تكون في جلسة تصفّح عادية ووليست وضع التصفّح المتخفي
  • أن يكون ضمن مجموعة التجارب النشطة في Chrome

كيف يجب أن يرصد المطوّرون إمكانية استخدام واجهة برمجة التطبيقات؟

وكما هو الحال مع أي ميزة من ميزات منصة الويب، يجب اكتشاف دعم الميزة قبل استخدامها.

المواضيع

يمكنك التحقّق من الوظيفة browsingTopics() في document وسياسة الأذونات](https://developer.chrome.com/articles/permissions-policy/#featurepolicyallowsfeaturefeature) للتعرّف على "browsing-topics".

if ('browsingTopics' in document && document.featurePolicy.allowsFeature('browsing-topics')) {
  // Topics enabled
}

FLEDGE

إذا أردت الانضمام إلى مجموعة اهتمامات إعلانية، تحقّق من الوظيفة joinAdInterestGroup في navigator وسياسة الأذونات "join-ad-interest-group".

if ('joinAdInterestGroup' in navigator && document.featurePolicy.allowsFeature('join-ad-interest-group')) {
  // FLEDGE interest group enabled
}

إذا كنت تريد إجراء مزاد، تحقَّق من الدالة runAdAuction في navigator وسياسة الأذونات الخاصة بـ "عرض المزاد".

if ('runAdAuction' in navigator && document.featurePolicy.allowsFeature('run-ad-auction')) {
  // FLEDGE auction enabled
}

إعداد تقارير الإحالة

ابحث عن الكائن attributionReporting في window وسياسة الأذونات لـ "attribution-reporting".

if (document.featurePolicy.allowsFeature('attribution-reporting')) {
  // Attribution Reporting API enabled
}

أين يمكن للمطوّرين تقديم الملاحظات والحصول على الدعم؟

توضّح صفحة النظرة العامة على الملاحظات المسارات المختلفة لتقديم ملاحظات بشأن جوانب مختلفة من "مبادرة حماية الخصوصية". هناك أقسام محددة للمواضيع وFLEDGE وتقارير تحديد المصدر، وهي توفّر روابط فردية لكل واجهة برمجة تطبيقات.

نقدّم أيضًا آخر الأخبار بشكل منتظم حول مستوى التقدُّم في سلسلة "مبادرة حماية الخصوصية" التي تقدّم ملخصًا للأخبار المهمة.