مستندات ویجت ادلی

راهنمای کامل استفاده از ویجت تبلیغات ادلی در مینی اپ‌های ایتا

نصب و راه‌اندازی

ویجت ادلی یک اسکریپت JavaScript مستقل است که به راحتی در هر صفحه HTML قابل استفاده است.

مرحله ۱: اضافه کردن اسکریپت

فایل ویجت را در صفحه HTML خود اضافه کنید: 

<script src="https://myadino.ir/widget/adly-widget.js"></script>

مرحله ۲: ایجاد Container

یک div برای نمایش تبلیغات ایجاد کنید: 

<div id="adly-container"></div>

مرحله ۳: مقداردهی ویجت

ویجت را با پارامترهای مورد نظر مقداردهی کنید: 

<script>
  AdlyWidget.init({
    apiKey: 'your-api-key',
    containerId: 'adly-container',
    adType: 'banner',
    width: 300,
    height: 250
  });
</script>

انواع تبلیغات و نمونه‌ها

ادلی از انواع مختلف تبلیغات پشتیبانی می‌کند. نمونه‌های زیر را مشاهده کنید:

بنر کوچک (Small)
300 × 250
عرض: 300px
ارتفاع: 250px 
AdlyWidget.init({
  apiKey: 'your-api-key',
  containerId: 'ad-container',
  adType: 'banner',
  width: 300,
  height: 250,
  bannerSize: 'small'
});
بنر متوسط (Medium)
728 × 90
عرض: 728px
ارتفاع: 90px 
AdlyWidget.init({
  apiKey: 'your-api-key',
  containerId: 'ad-container',
  adType: 'banner',
  width: 728,
  height: 90,
  bannerSize: 'medium'
});
بنر بزرگ (Large)
970 × 250
عرض: 970px
ارتفاع: 250px 
AdlyWidget.init({
  apiKey: 'your-api-key',
  containerId: 'ad-container',
  adType: 'banner',
  width: 970,
  height: 250,
  bannerSize: 'large'
});
تبلیغ ویدیویی
ویدیو تبلیغاتی
640 × 360
نوع: ویدیو
فرمت: MP4, WebM 
AdlyWidget.init({
  apiKey: 'your-api-key',
  containerId: 'ad-container',
  adType: 'video',
  width: 640,
  height: 360
});
تبلیغ تمام صفحه
تمام صفحه
نوع: تمام صفحه
نمایش: Overlay 
AdlyWidget.init({
  apiKey: 'your-api-key',
  containerId: 'ad-container',
  adType: 'fullscreen',
  width: '100%',
  height: '100vh'
});

پارامترها و تنظیمات

لیست کامل پارامترهای قابل استفاده در ویجت ادلی:

پارامتر نوع پیش‌فرض توضیحات
apiKey الزامی string - کلید API شما که از پنل توسعه‌دهنده دریافت می‌کنید
containerId الزامی string - شناسه عنصر HTML که تبلیغ در آن نمایش داده می‌شود
barnamk الزامی string - شناسه برنامک
adType الزامی string 'banner' نوع تبلیغ: 'banner', 'video', 'fullscreen'
width الزامی number 300 عرض تبلیغ به پیکسل
height الزامی number 250 ارتفاع تبلیغ به پیکسل
bannerSize string 'small' سایز استاندارد: 'small' (300x250), 'medium' (728x90), 'large' (970x250)
autoRefresh boolean false فعال‌سازی رفرش خودکار تبلیغات
refreshInterval number 30000 فاصله زمانی رفرش به میلی‌ثانیه (پیش‌فرض: 30 ثانیه)

نمونه کامل

یک نمونه کامل HTML با تمام تنظیمات: 

<!DOCTYPE html>
<html lang="fa" dir="rtl">
<head>
    <meta charset="UTF-8">
    <meta name="viewport" content="width=device-width, initial-scale=1.0">
    <title>نمونه استفاده از ویجت ادلی</title>
</head>
<body>
    <h1>صفحه نمونه</h1>
    
    <!-- Container برای تبلیغات -->
    <div id="adly-container"></div>
    
    <!-- لود ویجت -->
    <script src="https://myadino.ir/widget/adly-widget.js"></script>
    <script>
        AdlyWidget.init({
            apiKey: 'your-api-key',
            containerId: 'adly-container',
            barnamk: 'your-app-id',
            adType: 'banner',
            width: 300,
            height: 250,
            bannerSize: 'small',
            autoRefresh: true,
            refreshInterval: 30000,
        });
    </script>
</body>
</html>

بهترین روش‌ها

  • استفاده از سایزهای استاندارد

    برای بهترین نتیجه، از سایزهای استاندارد بنر استفاده کنید: Small (300x250), Medium (728x90), Large (970x250)

  • قرار دادن Container در مکان مناسب

    Container تبلیغات را در مکان‌هایی قرار دهید که کاربران به راحتی آن را ببینند اما تجربه کاربری را مختل نکند.

  • استفاده از Auto-Refresh

    برای نمایش تبلیغات جدید، از autoRefresh استفاده کنید. فاصله زمانی پیشنهادی: 30 تا 60 ثانیه