أوضاع الاختبار
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
اختبار عملية دمج adBreak()
لاختبار رمز JavaScript الذي يستخدم واجهة برمجة التطبيقات adBreak()
، نوفّر وضع اختبار يمكن تفعيله من خلال إضافة السمة data-adbreak-test="on"
إلى adsbygoogle.js
:
<script async
data-adbreak-test="on"
src="https://pagead2.googlesyndication.com/pagead/js/adsbygoogle.js?client=ca-pub-123456789"
crossorigin="anonymous">
</script>
<script>
window.adsbygoogle = window.adsbygoogle || [];
var adBreak = adConfig = function(o) {adsbygoogle.push(o);}
</script>
وضع الاختبار:
- تعرِض إعلانات تجريبية بدلاً من طلب إعلانات حقيقية.
- يحاكي سلوك الإعلانات الحقيقية، مثل الالتزام بمدّة عرض الإعلان التي تم ضبطها.
- استخدِم
console.log
أو
نقاط الإيقاف
لتصحيح الأخطاء في
adBreakDone()
وplacementInfo
.
ملاحظة: يتيح لك وضع الاختبار اختبار JavaScript من جهة العميل فقط بدون إرسال طلبات إعلانات إلى خوادم Google. ولا يمكنها مساعدتك في رصد المشاكل المتعلّقة بإعداد رمز AdSense بشكل غير صحيح، مثل قيم `data-ad-client` غير الصالحة.
يتنقّل وضع الاختبار بين سيناريوهَين: يتم تحميل الإعلان، ولا يتم تحميله، وذلك لمحاكاة بيئة حقيقية لن يتوفّر فيها الإعلان دائمًا.
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2025-07-26 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-07-26 (حسب التوقيت العالمي المتفَّق عليه)"],[[["\u003cp\u003eTesting mode for \u003ccode\u003eadBreak()\u003c/code\u003e is enabled by adding \u003ccode\u003edata-adbreak-test="on"\u003c/code\u003e to the \u003ccode\u003eadsbygoogle.js\u003c/code\u003e script tag.\u003c/p\u003e\n"],["\u003cp\u003eThis mode displays mock ads, mimics real ad behavior (like frequency capping), and allows debugging with \u003ccode\u003econsole.log\u003c/code\u003e or breakpoints.\u003c/p\u003e\n"],["\u003cp\u003eIt's for testing client-side JavaScript only and doesn't detect AdSense code misconfigurations.\u003c/p\u003e\n"],["\u003cp\u003eThe test mode cycles between scenarios where ads are and aren't loaded to simulate real-world conditions.\u003c/p\u003e\n"]]],["To test `adBreak()` API integration, enable testing mode by adding `data-adbreak-test=\"on\"` to the `adsbygoogle.js` script. This mode displays mock ads, mimicking real ad behavior, but does not send real ad requests. It cycles between ad loaded and not loaded scenarios. Use `console.log` or breakpoints to debug `adBreakDone()` and `placementInfo`. This method helps test client-side JavaScript, but it cannot detect issues related to AdSense code misconfiguration.\n"],null,["# Testing modes\n\nTest adBreak() integration\n--------------------------\n\nIn order to test JavaScript code that uses the `adBreak()` API we provide a\ntesting mode that can be enabled by adding `data-adbreak-test=\"on\"`attribute on\nthe `adsbygoogle.js`: \n\n \u003cscript async\n data-adbreak-test=\"on\"\n src=\"https://pagead2.googlesyndication.com/pagead/js/adsbygoogle.js?client=\u003cvar translate=\"no\"\u003eca-pub-123456789\u003c/var\u003e\"\n crossorigin=\"anonymous\"\u003e\n \u003c/script\u003e\n \u003cscript\u003e\n window.adsbygoogle = window.adsbygoogle || [];\n var adBreak = adConfig = function(o) {adsbygoogle.push(o);}\n \u003c/script\u003e\n\nTesting mode:\n\n- Displays mock ads instead of requesting real ads.\n- Mimics real ads behaviour such as respecting your configured ad frequency.\n- Use `console.log` or [break points](https://developer.chrome.com/docs/devtools/javascript/breakpoints) to debug [`adBreakDone()`](/ad-placement/apis/adbreak#adbreakdone_and_placementinfo) and `placementInfo`.\n\n**Note**: testing mode only allows you to test\nclient-side JavaScript without sending ad requests to Google servers. It can't\nhelp you to detect issues related to misconfiguration of the AdSense code such\nas invalid \\`data-ad-client\\` values.\n\nTest mode cycles between two scenarios: ad is loaded and ad is not loaded to\nemulate a real environment where ad will not always be available."]]