logo logo
  • صفحات
    تماس با ما راهنمای نصب کد تبلیغات

    • راهنما و مستندات تبلیغات در سایت

    • خانه /
    • راهنما و مستندات تبلیغات در سایت

    نسخه مستندات: 1.2

    1. افزودن اسکریپت تبلیغات

    برای فعال شدن سیستم تبلیغات Farazno باید اسکریپت اصلی فقط یک بار در سایت شما بارگذاری شود.

    کد زیر را قبل از بسته شدن تگ </head> قرار دهید:

    <script async src=”https://ad.farazno.com/v1/api.js”></script>

    نکات مهم

    • این اسکریپت فقط یک بار در کل سایت باید قرار داده شود

    • اسکریپت به صورت async بارگذاری می‌شود

    • تاثیری روی سرعت سایت ندارد

    برای نمایش تبلیغ باید کد جایگاه (Placement) را در سایت قرار دهید.

    کد نمایش:

    <div class=”farazno” data-id=”PLACEMENT_ID”></div>

    مثال:

    <div class=”farazno” data-id=”3″></div>

    توضیح پارامتر:

    data-id

    شناسه جایگاه تبلیغ (Placement ID) است که در پنل ناشران برای هر جایگاه ساخته می‌شود.

    ابزارک (Sidebar / Footer)

    نمایش → ابزارک‌ها → HTML سفارشی:

    <div class=”farazno” data-id=”5″></div>

    راهنمای اتصال Farazno Ads در وب‌سایت‌های HTML عادی

    اگر سایت شما پنل ندارد و فقط فایل‌های HTML هست:

    افزودن اسکریپت

    در <head> صفحه:

    <script async src=”https://ad.farazno.com/v1/api.js”></script>

    جایگاه تبلیغ

    در هر جایی از صفحه:

    <div class=”farazno” data-id=”3″></div>

    هیچ تنظیم اضافه لازم نیست.

    راهنمای استفاده Farazno Ads در React / Next.js / SPAها

    چون React و Next.js رندر سمت کلاینت دارند، بهتر است اسکریپت را دینامیک بارگذاری کنید.

    بارگذاری اسکریپت در React

    در فایل App.js یا index.js:

    useEffect(() => {
    const script = document.createElement(“script”);
    script.src = “https://ad.farazno.com/v1/api.js”;
    script.async = true;
    document.head.appendChild(script);
    }, []);

    افزودن جایگاه تبلیغ

    در هر کامپوننت React:

    <div className=”farazno” data-id=”3″></div>

    برای SPA ها (Single Page Apps)

    چون صفحه Reload نمی‌شود، بعد از تغییر Route باید تبلیغات را refresh کنید:

    if (window.FaraznoAds && window.FaraznoAds.loadAds) {
    window.FaraznoAds.loadAds();
    }

    چند جایگاه در یک صفحه

    می‌توانید چند Placement در یک صفحه قرار دهید.

    مثال:

    <div class=”farazno” data-id=”1″></div>
    <div class=”farazno” data-id=”2″></div>
    <div class=”farazno” data-id=”3″></div>
    <div class=”farazno” data-id=”4″></div>

    هر Placement ID تبلیغ مخصوص همان جایگاه را نمایش می‌دهد.

    سؤالات پرتکرار (FAQ)

    1. آیا باید اسکریپت را در هر صفحه قرار دهم؟

    خیر. فقط یک بار در فایل header.php یا <head> اصلی.

    2. آیا این اسکریپت سرعت سایت را کند می‌کند؟

    خیر.

    اسکریپت async است و به صورت غیرهمزمان بارگذاری می‌شود.

    3. آیا امکان داشتن چند جایگاه وجود دارد؟

    بله.

    هر تعداد <div class="farazno"> می‌توانید داشته باشید.

    سیستم ثبت آمار

    سیستم Farazno به صورت خودکار ثبت می‌کند:

    • Impression (نمایش تبلیغ)

    • Click (کلیک کاربر)

    سیستم ضد تقلب

    برای جلوگیری از تقلب:

    • محدودیت ثبت Impression تکراری از یک IP در ۳۰ ثانیه

    • استفاده از impression hash

    • استفاده از توکن کلیک یکبار مصرف

    • پاکسازی خودکار توکن‌ها بعد از ۳۰ دقیقه

    چرا تبلیغ نمایش داده نمی‌شود؟

    دلایل رایج:

    در آن جایگاه تبلیغ فعال وجود ندارد

    کش وردپرس فعال است → کش را پاک کنید

    Cloudflare یا افزونه امنیتی اسکریپت خارجی را مسدود کرده

    Placement غیرفعال است