پشتیبانی از منابع برای 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 دیگر را بسته‌اید.

  • اطمینان حاصل کنید که:

    • شما از Chrome 101 یا جدیدتر استفاده می کنید.
    • اسکریپت شما Topics API را برای مشاهده موضوعات فراخوانی کرده است. هنگام آزمایش، می توانید با مراجعه به سایت هایی که اسکریپت شما در آن جاسازی شده است، رفتار کاربر را شبیه سازی کنید. برای مثال عملی به دمو مراجعه کنید.
    • شما adblocker یا برنامه یا افزونه مشابهی در حال اجرا ندارید.
    • شما در حالت ناشناس نیستید.
    • از chrome://settings/trackingProtection ، گزینه Block all third-party cookies غیرفعال است.

اشکال زدایی اجرای زنده

اگر در هفته اول پس از مشاهده یک کاربر، Topics API را از یک برنامه زنده فراخوانی می کنید، نتیجه خالی انتظار می رود، زیرا ممکن است برنامه شما هنوز موضوعاتی را برای کاربر مشاهده نکرده باشد. شما می توانید راه حل خود را با توجه به توصیه های ما اشکال زدایی کنید.

  • مطمئن شوید که سایت شما با Privacy Sandbox ثبت نام کرده است.
  • کد ظاهری خود را آزمایش کنید تا مطمئن شوید جاوا اسکریپت شما همانطور که انتظار می رود کار می کند.
  • باطن خود را برای دریافت نتایج موضوعات تست کنید.
    • به یاد داشته باشید که مطمئن شوید انواع داده ها و پارامترهای API backend به درستی پیکربندی شده اند.
    • اطمینان حاصل کنید که باطن شما برای مقیاس مناسب پیکربندی شده است.
  • با توجه به تجربه ما، لازم است حداقل سه هفته قبل از شروع برای دریافت نتایج موضوعات مرتبط تر، فرصت دهیم.
  • همه کاربران موضوعات را فعال نخواهند کرد:
    • کاربران می توانند به صراحت API موضوعات را غیرفعال کنند.
    • صفحات ناشر می توانند خط مشی مجوزها را کنترل کرده و سایت های خود را انصراف دهند .
  • معیارها و قابلیت مشاهده را به این محیط اضافه کنید: برای تجزیه و تحلیل اولین نتایج به آنها نیاز دارید. معیارهای نمونه عبارتند از:
    • تأخیر تماس ها
    • خطاهای HTTP در تماس های موضوعی.
  • سعی کنید تغییرات را در اجرای خود در سه هفته ابتدایی محدود کنید.

منابع