مراجع الدعم لواجهة برمجة التطبيقات Topics API على الويب

يمكنك العثور على اقتراحات لتحديد الأخطاء وحلّها ومراجع الدعم المتعلّقة بتطبيق "عناوين على الويب".

تحديد المشاكل وحلّها

إذا أجريت طلبًا من النوع document.browsingTopics() أو fetch() مع ضبط الرأس Sec-Browsing-Topics، ولكن تلقّيت صفيفًا فارغًا كاستجابة، هناك عدد من خطوات تصحيح الأخطاء التي يمكنك اتّخاذها لتحديد السبب الأساسي للمشكلة، سواء في بيئة التطوير المحلية أو في النظام المباشر.

تصحيح الأخطاء محليًا

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

  • لتجاوز عملية التسجيل، فعِّل العلامة chrome://flags/#privacy-sandbox-enrollment-overrides وأضِف عنوان URL للموقع الإلكتروني الذي يستدعي Topics.

  • اضبط Topics API للاختبار باستخدام علامات الميزات. تتيح لك هذه العلامات تعديل مَعلمات مثل مدة الحقبة وعدد أهم المواضيع وغيرها، حتى تتمكّن من اختبار ميزة "المواضيع" بسهولة. يمكنك استخدام علامات الميزات المقترَحة التالية:

    --enable-features=BrowsingTopics,BrowsingTopicsParameters:time_period_per_epoch/15s/max_epoch_introduction_delay/3s,PrivacySandboxAdsAPIsOverride,PrivacySandboxSettings3,OverridePrivacySandboxSettingsLocalTesting

  • قبل تشغيل Chrome باستخدام العلامات، تأكَّد من إغلاق جميع عمليات Chrome ومثيلاته الأخرى.

  • تأكَّد مما يلي:

    • استخدام الإصدار 101 من Chrome أو إصدار أحدث
    • طلب النص البرمجي واجهة برمجة التطبيقات Topics API لمراقبة المواضيع. عند الاختبار، يمكنك محاكاة سلوك المستخدِم من خلال الانتقال إلى المواقع الإلكترونية التي تم تضمين نصك البرمجي فيها. راجِع العرض التجريبي للحصول على مثال عملي.
    • عدم استخدام تطبيق أو إضافة أو برنامج مشابه لمنع الإعلانات
    • إذا لم تكن في "وضع التصفّح المتخفي"
    • من chrome://settings/trackingProtection، يكون الخيار Block all third-party cookies متوقفًا.

تصحيح الأخطاء في التنفيذ المباشر

إذا كنت تستدعي Topics API من تطبيق نشط خلال الأسبوع الأول من مراقبة مستخدم، من المتوقّع أن تكون النتيجة فارغة، لأنّ تطبيقك قد لا يكون قد رصد مواضيع لأحد المستخدِمين بعد. يمكنك تصحيح أخطاء الحلّ باتّباع اقتراحاتنا.

  • تأكَّد من أنّ موقعك الإلكتروني مسجَّل في "مبادرة حماية الخصوصية".
  • اختبِر رمز الواجهة الأمامية للتأكّد من أنّ JavaScript يعمل على النحو المطلوب.
  • اختبِر الخلفية لتلقّي نتائج المواضيع.
    • تذكَّر التأكّد من ضبط أنواع البيانات ومَعلمات واجهة برمجة التطبيقات في الخلفية بشكلٍ صحيح.
    • تأكّد من ضبط الخلفية للتوسّع بشكلٍ مناسب.
  • استنادًا إلى تجربتنا، من الضروري الانتظار لمدة ثلاثة أسابيع على الأقل قبل البدء في الحصول على نتائج مواضيع أكثر صلة.
  • لن تكون ميزة "المواضيع" مفعّلة لبعض المستخدمين:
    • يمكن للمستخدمين إيقاف Topics API بشكل صريح.
    • يمكن لصفحات الناشر التحكّم في سياسة الأذونات وإيقاف أذونات مواقعهم الإلكترونية.
  • أضِف المقاييس وإمكانية المراقبة إلى هذه البيئة، إذ ستحتاج إليها لتحليل النتائج الأولى. تشمل أمثلة المقاييس ما يلي:
    • وقت استجابة المكالمات
    • أخطاء HTTP في طلبات المواضيع
  • حاول الحدّ من التغييرات على عملية التنفيذ خلال الأسابيع الثلاثة الأولى.

الموارد