وب‌سایت و JavaScript
دو خط HTML، صفحه پویا و بینابینی؛ بدون کلید سرور در مرورگر.
سه قدم تا اولین تبلیغ وب · JavaScript
- رسانه و جایگاه همان فرمت را ثبت و تأیید کنید.
- بسته همین پلتفرم را نصب کنید.
- شناسه UNT_ مثال را با شناسه جایگاه خود جایگزین کنید.
نشانی HTTPS در مثال، سرور خود دیدنکس است. در حالت مستقیم، JWT، کلید خصوصی و ورود کاربر لازم نیست. Android، iOS، Unity و B4A شناسه بسته را از خود اپ می‌خوانند؛ Flutter نیز در initialize جدید، شناسه بسته را محلی می‌خواند؛ ورود دستی در روش سازگار قدیمی ممکن است. تغییر دامنه دیدنکس فقط به تغییر همین نشانی در تنظیم اپ نیاز دارد.
۱. نصب و تنظیم اولیه
اسکریپت را یک بار از دامنه خود دیدنکس بارگذاری کنید. صفحه باید روی همان دامنه HTTPS ثبت‌شده و تأییدشده شما باشد؛ localhost و file:// رسانه تأییدشده نیستند.
مرورگر دارای fetch، WebCrypto و dialog؛ هیچ وابستگی npm لازم نیست.
<div id="ad-slot" style="min-height:300px"></div>
<script defer src="https://didnex.com/sdk/didnex.js"></script>راه‌اندازی یک‌باره تبلیغ و پوش
نمونه کوتاه زیر فقط تنظیم اولیه است؛ callback و ظرف نمایش را در مثال کامل همین صفحه ببینید. init اجازه اعلان نمی‌گیرد و عضویت خودکار ندارد. یک کلاینت را برای عمر اپ نگه دارید و همان را برای تبلیغ و پوش استفاده کنید.
const placementId = "PASTE_YOUR_PLACEMENT_ID_HERE";
const client = DidnexAds.initialize();
const ad = await client.display('#ad-slot', placementId);
const push = client.createPush(placementId, {
onMessage: async message => { /* Display your actual UI here. */ return false; }
});
// Call push.enableWebPush({consent:true}) only from an explicit user action.اندازه ثابت جایگاه
اندازه از slot جایگاه تعیین می‌شود؛ تصویر و ویدیو با contain داخل همان کادرند. ابعاد فایل یا آماده‌شدن ویدیو، اندازه بیرونی را عوض نمی‌کند. noFill و خطا کادر را جمع می‌کنند. در Unity و Godot مستطیل میزبان را مطابق پروفایل انتخاب کنید.
| پروفایل دیدنکس | اندازه مرجع | نوار ثابت زیر رسانه |
|---|---|---|
| بنر استاندارد ۳۲۰ × ۵۰ | 320 × 50 | ندارد |
| بنر بزرگ ۳۲۰ × ۱۰۰ | 320 × 100 | ندارد |
| بنر مستطیل ۳۰۰ × ۲۵۰ | 300 × 250 | ندارد |
| بنر عریض ۷۲۸ × ۹۰ | 728 × 90 | ندارد |
| بنر تطبیقی با نسبت ۳۲۰ × ۵۰ | 320 × 50 | ندارد |
| همسان افقی ۱۶:۹ + نوار ثابت | 640 × 360 | 84 پیکسل منطقی |
| همسان مربع + نوار ثابت | 600 × 600 | 84 پیکسل منطقی |
| ویدیوی همسان ۱۶:۹ + نوار ثابت | 640 × 360 | 84 پیکسل منطقی |
| ویدیوی درون محتوا ۱۶:۹ | 640 × 360 | ندارد |
| کاروسل ۱۶:۹ با نوار ثابت | 640 × 360 | 84 پیکسل منطقی |
| نظرسنجی در کادر ثابت | 320 × 300 | 84 پیکسل منطقی |
| کارت صوتی ثابت | 320 × 96 | ندارد |
| تمام‌صفحه با حاشیه امن | 360 × 640 | 84 پیکسل منطقی |
| تمام‌صفحه با حاشیه امن | 360 × 640 | 84 پیکسل منطقی |
| تمام‌صفحه با حاشیه امن | 360 × 640 | 84 پیکسل منطقی |
| تمام‌صفحه با حاشیه امن | 360 × 640 | 84 پیکسل منطقی |
| تمام‌صفحه با حاشیه امن | 360 × 640 | 84 پیکسل منطقی |
این‌ها پروفایل محصول دیدنکس‌اند؛ گواهی استاندارد یا یک اندازه پیکسلی جهانی برای همه فرمت‌ها نیستند. حداقل وضوح در فرم کمپین کنترل می‌شود. برای فعال‌شدن renderer جدید در اپ نصب‌شده، یک بار SDK را به‌روزرسانی کنید.
فونت و ظاهر مشترک
ظاهر کارت در هر دو روش مستقیم و پراکسی از پاسخ همان تبلیغ خوانده می‌شود. مدیر در تنظیمات ← ظاهر تبلیغ و SDK، رنگ، زمینه، فونت، گردی کارت، جای نشان و پخش خودکار ویدیوی معمولی را تعیین می‌کند. ابتدا یک‌بار SDK و اپ را به‌روزرسانی کنید؛ سپس تغییرات پشتیبانی‌شده در درخواست بعدی تبلیغ اعمال می‌شوند. فونت Noto Sans Arabic فارسی و لوگو از سرور خود دیدنکس کش می‌شوند؛ خطای این دارایی‌های اختیاری باعث noFill یا خطای تبلیغ نمی‌شود. Unity برای UGUI یک فونت کوچک فارسی همراه و شکل‌دهی حروف در مرز نمایش دارد. سرور کد اجرایی جدید به اپ نمی‌فرستد.
ویدیوی معمولی هنگام دیده‌شدن خودکار و بی‌صداست؛ صوت و جایزه با انتخاب کاربر شروع می‌شوند. دامنه دیدنکس را در font-src سیاست CSP وب مجاز کنید.
۲. Manifest و مجوزهای لازم
قطعه زیر را با فایل موجود ادغام کنید. INTERNET باید در Manifest اصلی نسخه Release هم باشد. تبلیغ پایه به مجوز مکان، اعلان، حافظه یا شناسه تبلیغاتی نیاز ندارد.
# Merge these allowed sources into your existing CSP; do not replace it blindly.
script-src 'self' https://didnex.com;
connect-src 'self' https://didnex.com;
img-src 'self' https://didnex.com;
media-src 'self' https://didnex.com;
frame-src 'self' https://didnex.com;
# Built-in renderer uses inline element styles; adapt style-src to your policy.
در iOS فایل PrivacyInfo.xcprivacy بسته را به منابع Target اضافه کنید؛ HTTPS به غیرفعال‌کردن ATS نیاز ندارد. UIBackgroundModes فقط برای پوش پس‌زمینه اختیاری است. در Unity دسترسی اینترنت Player Settings را روی Require قرار دهید.
بازکردن جایگاه و راهنمای قدم‌به‌قدم اتصال — در پنل، نمونه با شناسه و بستهٔ رسانهٔ شما ساخته می‌شود؛ تست تا دریافت گزارش همان جلسه ادامه دارد.
۳. مثال کامل هر فرمت
هر شناسه جایگاه فقط یک فرمت دارد؛ فرمت باید با نوع رسانه و سیاست‌های پنل سازگار باشد. مثال کامل همان فرمت را انتخاب کنید. تمام‌صفحه فقط در نقطه طبیعی تجربه کاربر نمایش داده شود. ویدیوی معمولی خودکار و بی‌صداست؛ صوت و جایزه با اقدام کاربر شروع می‌شوند.
بنر · درون صفحه
<!doctype html><html lang="fa" dir="rtl"><meta charset="utf-8"><meta name="viewport" content="width=device-width,initial-scale=1"><title>Didnex</title>
<button id="show-ad">نمایش تبلیغ</button><p id="status"></p><div id="ad-slot"></div>
<script src="https://didnex.com/sdk/didnex.js" data-origin="https://didnex.com"></script>
<script>
let busy=false,handle;
const button=document.getElementById('show-ad'),status=document.getElementById('status');
button.onclick=async()=>{if(busy)return;busy=true;button.disabled=true;
try{handle?.destroy?.();handle=await DidnexAds.display('#ad-slot', "UNT_BANNER",{diagnosticToken:""||null,
onError:()=>{status.textContent='تبلیغ در دسترس نیست'},onReward:()=>{status.textContent='جایزه در کیف دیدنکس ثبت شد؛ دوباره اعتبار ندهید'}});
if(!handle)status.textContent='فعلاً تبلیغی موجود نیست';
}catch(error){status.textContent='ارتباط با تبلیغ برقرار نشد'}finally{busy=false;button.disabled=false}};
window.addEventListener('pagehide',()=>handle?.destroy?.());
</script></html>بنر تطبیقی · درون صفحه
<!doctype html><html lang="fa" dir="rtl"><meta charset="utf-8"><meta name="viewport" content="width=device-width,initial-scale=1"><title>Didnex</title>
<button id="show-ad">نمایش تبلیغ</button><p id="status"></p><div id="ad-slot"></div>
<script src="https://didnex.com/sdk/didnex.js" data-origin="https://didnex.com"></script>
<script>
let busy=false,handle;
const button=document.getElementById('show-ad'),status=document.getElementById('status');
button.onclick=async()=>{if(busy)return;busy=true;button.disabled=true;
try{handle?.destroy?.();handle=await DidnexAds.display('#ad-slot', "UNT_ADAPTIVE_BANNER",{diagnosticToken:""||null,
onError:()=>{status.textContent='تبلیغ در دسترس نیست'},onReward:()=>{status.textContent='جایزه در کیف دیدنکس ثبت شد؛ دوباره اعتبار ندهید'}});
if(!handle)status.textContent='فعلاً تبلیغی موجود نیست';
}catch(error){status.textContent='ارتباط با تبلیغ برقرار نشد'}finally{busy=false;button.disabled=false}};
window.addEventListener('pagehide',()=>handle?.destroy?.());
</script></html>همسان · درون صفحه
<!doctype html><html lang="fa" dir="rtl"><meta charset="utf-8"><meta name="viewport" content="width=device-width,initial-scale=1"><title>Didnex</title>
<button id="show-ad">نمایش تبلیغ</button><p id="status"></p><div id="ad-slot"></div>
<script src="https://didnex.com/sdk/didnex.js" data-origin="https://didnex.com"></script>
<script>
let busy=false,handle;
const button=document.getElementById('show-ad'),status=document.getElementById('status');
button.onclick=async()=>{if(busy)return;busy=true;button.disabled=true;
try{handle?.destroy?.();handle=await DidnexAds.display('#ad-slot', "UNT_NATIVE",{diagnosticToken:""||null,
onError:()=>{status.textContent='تبلیغ در دسترس نیست'},onReward:()=>{status.textContent='جایزه در کیف دیدنکس ثبت شد؛ دوباره اعتبار ندهید'}});
if(!handle)status.textContent='فعلاً تبلیغی موجود نیست';
}catch(error){status.textContent='ارتباط با تبلیغ برقرار نشد'}finally{busy=false;button.disabled=false}};
window.addEventListener('pagehide',()=>handle?.destroy?.());
</script></html>ویدیوی همسان · درون صفحه
<!doctype html><html lang="fa" dir="rtl"><meta charset="utf-8"><meta name="viewport" content="width=device-width,initial-scale=1"><title>Didnex</title>
<button id="show-ad">نمایش تبلیغ</button><p id="status"></p><div id="ad-slot"></div>
<script src="https://didnex.com/sdk/didnex.js" data-origin="https://didnex.com"></script>
<script>
let busy=false,handle;
const button=document.getElementById('show-ad'),status=document.getElementById('status');
button.onclick=async()=>{if(busy)return;busy=true;button.disabled=true;
try{handle?.destroy?.();handle=await DidnexAds.display('#ad-slot', "UNT_NATIVE_VIDEO",{diagnosticToken:""||null,
onError:()=>{status.textContent='تبلیغ در دسترس نیست'},onReward:()=>{status.textContent='جایزه در کیف دیدنکس ثبت شد؛ دوباره اعتبار ندهید'}});
if(!handle)status.textContent='فعلاً تبلیغی موجود نیست';
}catch(error){status.textContent='ارتباط با تبلیغ برقرار نشد'}finally{busy=false;button.disabled=false}};
window.addEventListener('pagehide',()=>handle?.destroy?.());
</script></html>ویدیوی درون محتوا · درون صفحه
<!doctype html><html lang="fa" dir="rtl"><meta charset="utf-8"><meta name="viewport" content="width=device-width,initial-scale=1"><title>Didnex</title>
<button id="show-ad">نمایش تبلیغ</button><p id="status"></p><div id="ad-slot"></div>
<script src="https://didnex.com/sdk/didnex.js" data-origin="https://didnex.com"></script>
<script>
let busy=false,handle;
const button=document.getElementById('show-ad'),status=document.getElementById('status');
button.onclick=async()=>{if(busy)return;busy=true;button.disabled=true;
try{handle?.destroy?.();handle=await DidnexAds.display('#ad-slot', "UNT_VIDEO",{diagnosticToken:""||null,
onError:()=>{status.textContent='تبلیغ در دسترس نیست'},onReward:()=>{status.textContent='جایزه در کیف دیدنکس ثبت شد؛ دوباره اعتبار ندهید'}});
if(!handle)status.textContent='فعلاً تبلیغی موجود نیست';
}catch(error){status.textContent='ارتباط با تبلیغ برقرار نشد'}finally{busy=false;button.disabled=false}};
window.addEventListener('pagehide',()=>handle?.destroy?.());
</script></html>بینابینی · تمام‌صفحه
<!doctype html><html lang="fa" dir="rtl"><meta charset="utf-8"><meta name="viewport" content="width=device-width,initial-scale=1"><title>Didnex</title>
<button id="show-ad">نمایش تبلیغ</button><p id="status"></p><div id="ad-slot"></div>
<script src="https://didnex.com/sdk/didnex.js" data-origin="https://didnex.com"></script>
<script>
let busy=false,handle;
const button=document.getElementById('show-ad'),status=document.getElementById('status');
button.onclick=async()=>{if(busy)return;busy=true;button.disabled=true;
try{handle?.destroy?.();handle=await DidnexAds.interstitial("UNT_INTERSTITIAL",{diagnosticToken:""||null,
onError:()=>{status.textContent='تبلیغ در دسترس نیست'},onReward:()=>{status.textContent='جایزه در کیف دیدنکس ثبت شد؛ دوباره اعتبار ندهید'}});
if(!handle)status.textContent='فعلاً تبلیغی موجود نیست';
}catch(error){status.textContent='ارتباط با تبلیغ برقرار نشد'}finally{busy=false;button.disabled=false}};
window.addEventListener('pagehide',()=>handle?.destroy?.());
</script></html>ویدیوی جایزه‌دار · جایزه‌دار
<!doctype html><html lang="fa" dir="rtl"><meta charset="utf-8"><meta name="viewport" content="width=device-width,initial-scale=1"><title>Didnex</title>
<button id="show-ad">نمایش تبلیغ</button><p id="status"></p><div id="ad-slot"></div>
<script src="https://didnex.com/sdk/didnex.js" data-origin="https://didnex.com"></script>
<script>
let busy=false,handle;
const button=document.getElementById('show-ad'),status=document.getElementById('status');
button.onclick=async()=>{if(busy)return;busy=true;button.disabled=true;
try{handle?.destroy?.();handle=await DidnexAds.rewarded("UNT_REWARDED",{diagnosticToken:""||null,
onError:()=>{status.textContent='تبلیغ در دسترس نیست'},onReward:()=>{status.textContent='جایزه در کیف دیدنکس ثبت شد؛ دوباره اعتبار ندهید'}});
if(!handle)status.textContent='فعلاً تبلیغی موجود نیست';
}catch(error){status.textContent='ارتباط با تبلیغ برقرار نشد'}finally{busy=false;button.disabled=false}};
window.addEventListener('pagehide',()=>handle?.destroy?.());
</script></html>بینابینی جایزه‌دار · جایزه‌دار
<!doctype html><html lang="fa" dir="rtl"><meta charset="utf-8"><meta name="viewport" content="width=device-width,initial-scale=1"><title>Didnex</title>
<button id="show-ad">نمایش تبلیغ</button><p id="status"></p><div id="ad-slot"></div>
<script src="https://didnex.com/sdk/didnex.js" data-origin="https://didnex.com"></script>
<script>
let busy=false,handle;
const button=document.getElementById('show-ad'),status=document.getElementById('status');
button.onclick=async()=>{if(busy)return;busy=true;button.disabled=true;
try{handle?.destroy?.();handle=await DidnexAds.rewarded("UNT_REWARDED_INTERSTITIAL",{diagnosticToken:""||null,
onError:()=>{status.textContent='تبلیغ در دسترس نیست'},onReward:()=>{status.textContent='جایزه در کیف دیدنکس ثبت شد؛ دوباره اعتبار ندهید'}});
if(!handle)status.textContent='فعلاً تبلیغی موجود نیست';
}catch(error){status.textContent='ارتباط با تبلیغ برقرار نشد'}finally{busy=false;button.disabled=false}};
window.addEventListener('pagehide',()=>handle?.destroy?.());
</script></html>آغاز اپ · تمام‌صفحه
<!doctype html><html lang="fa" dir="rtl"><meta charset="utf-8"><meta name="viewport" content="width=device-width,initial-scale=1"><title>Didnex</title>
<button id="show-ad">نمایش تبلیغ</button><p id="status"></p><div id="ad-slot"></div>
<script src="https://didnex.com/sdk/didnex.js" data-origin="https://didnex.com"></script>
<script>
let busy=false,handle;
const button=document.getElementById('show-ad'),status=document.getElementById('status');
button.onclick=async()=>{if(busy)return;busy=true;button.disabled=true;
try{handle?.destroy?.();handle=await DidnexAds.interstitial("UNT_APP_OPEN",{diagnosticToken:""||null,
onError:()=>{status.textContent='تبلیغ در دسترس نیست'},onReward:()=>{status.textContent='جایزه در کیف دیدنکس ثبت شد؛ دوباره اعتبار ندهید'}});
if(!handle)status.textContent='فعلاً تبلیغی موجود نیست';
}catch(error){status.textContent='ارتباط با تبلیغ برقرار نشد'}finally{busy=false;button.disabled=false}};
window.addEventListener('pagehide',()=>handle?.destroy?.());
</script></html>بازی تعاملی · تمام‌صفحه
<!doctype html><html lang="fa" dir="rtl"><meta charset="utf-8"><meta name="viewport" content="width=device-width,initial-scale=1"><title>Didnex</title>
<button id="show-ad">نمایش تبلیغ</button><p id="status"></p><div id="ad-slot"></div>
<script src="https://didnex.com/sdk/didnex.js" data-origin="https://didnex.com"></script>
<script>
let busy=false,handle;
const button=document.getElementById('show-ad'),status=document.getElementById('status');
button.onclick=async()=>{if(busy)return;busy=true;button.disabled=true;
try{handle?.destroy?.();handle=await DidnexAds.interstitial("UNT_PLAYABLE",{diagnosticToken:""||null,
onError:()=>{status.textContent='تبلیغ در دسترس نیست'},onReward:()=>{status.textContent='جایزه در کیف دیدنکس ثبت شد؛ دوباره اعتبار ندهید'}});
if(!handle)status.textContent='فعلاً تبلیغی موجود نیست';
}catch(error){status.textContent='ارتباط با تبلیغ برقرار نشد'}finally{busy=false;button.disabled=false}};
window.addEventListener('pagehide',()=>handle?.destroy?.());
</script></html>صوتی · درون صفحه
<!doctype html><html lang="fa" dir="rtl"><meta charset="utf-8"><meta name="viewport" content="width=device-width,initial-scale=1"><title>Didnex</title>
<button id="show-ad">نمایش تبلیغ</button><p id="status"></p><div id="ad-slot"></div>
<script src="https://didnex.com/sdk/didnex.js" data-origin="https://didnex.com"></script>
<script>
let busy=false,handle;
const button=document.getElementById('show-ad'),status=document.getElementById('status');
button.onclick=async()=>{if(busy)return;busy=true;button.disabled=true;
try{handle?.destroy?.();handle=await DidnexAds.display('#ad-slot', "UNT_AUDIO",{diagnosticToken:""||null,
onError:()=>{status.textContent='تبلیغ در دسترس نیست'},onReward:()=>{status.textContent='جایزه در کیف دیدنکس ثبت شد؛ دوباره اعتبار ندهید'}});
if(!handle)status.textContent='فعلاً تبلیغی موجود نیست';
}catch(error){status.textContent='ارتباط با تبلیغ برقرار نشد'}finally{busy=false;button.disabled=false}};
window.addEventListener('pagehide',()=>handle?.destroy?.());
</script></html>کاروسلی · درون صفحه
<!doctype html><html lang="fa" dir="rtl"><meta charset="utf-8"><meta name="viewport" content="width=device-width,initial-scale=1"><title>Didnex</title>
<button id="show-ad">نمایش تبلیغ</button><p id="status"></p><div id="ad-slot"></div>
<script src="https://didnex.com/sdk/didnex.js" data-origin="https://didnex.com"></script>
<script>
let busy=false,handle;
const button=document.getElementById('show-ad'),status=document.getElementById('status');
button.onclick=async()=>{if(busy)return;busy=true;button.disabled=true;
try{handle?.destroy?.();handle=await DidnexAds.display('#ad-slot', "UNT_CAROUSEL",{diagnosticToken:""||null,
onError:()=>{status.textContent='تبلیغ در دسترس نیست'},onReward:()=>{status.textContent='جایزه در کیف دیدنکس ثبت شد؛ دوباره اعتبار ندهید'}});
if(!handle)status.textContent='فعلاً تبلیغی موجود نیست';
}catch(error){status.textContent='ارتباط با تبلیغ برقرار نشد'}finally{busy=false;button.disabled=false}};
window.addEventListener('pagehide',()=>handle?.destroy?.());
</script></html>نظرسنجی · درون صفحه
<!doctype html><html lang="fa" dir="rtl"><meta charset="utf-8"><meta name="viewport" content="width=device-width,initial-scale=1"><title>Didnex</title>
<button id="show-ad">نمایش تبلیغ</button><p id="status"></p><div id="ad-slot"></div>
<script src="https://didnex.com/sdk/didnex.js" data-origin="https://didnex.com"></script>
<script>
let busy=false,handle;
const button=document.getElementById('show-ad'),status=document.getElementById('status');
button.onclick=async()=>{if(busy)return;busy=true;button.disabled=true;
try{handle?.destroy?.();handle=await DidnexAds.display('#ad-slot', "UNT_POLL",{diagnosticToken:""||null,
onError:()=>{status.textContent='تبلیغ در دسترس نیست'},onReward:()=>{status.textContent='جایزه در کیف دیدنکس ثبت شد؛ دوباره اعتبار ندهید'}});
if(!handle)status.textContent='فعلاً تبلیغی موجود نیست';
}catch(error){status.textContent='ارتباط با تبلیغ برقرار نشد'}finally{busy=false;button.disabled=false}};
window.addEventListener('pagehide',()=>handle?.destroy?.());
</script></html>۴. مثال کامل با مدیریت خطا
این مثال عیناً از فایل sdk/web/examples/example.js داخل بسته ساخته می‌شود. نام package نمونه، شناسه‌های UNT_ و ظرف نمایش را با اپ خود هماهنگ کنید. برای بنر و تمام‌صفحه از نمونه جدا استفاده کنید.
نمایش مثال کامل وب · JavaScript
'use strict';
const units={banner:'UNT_BANNER',adaptive_banner:'UNT_ADAPTIVE_BANNER',native:'UNT_NATIVE',native_video:'UNT_NATIVE_VIDEO',video:'UNT_VIDEO',interstitial:'UNT_INTERSTITIAL',rewarded:'UNT_REWARDED',rewarded_interstitial:'UNT_REWARDED_INTERSTITIAL',app_open:'UNT_APP_OPEN',playable:'UNT_PLAYABLE',audio:'UNT_AUDIO',carousel:'UNT_CAROUSEL',poll:'UNT_POLL'};
const status=document.querySelector('#status'),slot=document.querySelector('#ad-slot');let busy=false;
for(const [format,unit] of Object.entries(units)){
const button=document.createElement('button');button.textContent=format;
button.onclick=async()=>{if(busy)return;busy=true;try{
let ad;
if(format.startsWith('rewarded'))ad=await DidnexAds.rewarded(unit,{onReward(){status.textContent='جایزه در کیف دیدنکس ثبت شد؛ دوباره اعتبار ندهید'}});
else if(['interstitial','app_open','playable'].includes(format))ad=await DidnexAds.interstitial(unit);
else ad=await DidnexAds.display(slot,unit);
if(!ad)status.textContent='فعلاً تبلیغی موجود نیست؛ استفاده از سایت ادامه دارد';
}catch(_){status.textContent='دریافت تبلیغ ممکن نشد'}finally{busy=false}};
document.querySelector('#choices').append(button);
}
window.addEventListener('pagehide',()=>{try{DidnexAds.unmount(slot)}catch{}});
۵. نبود تبلیغ، قطعی شبکه و چرخه عمر
آغاز اپ را منتظر تبلیغ نگه ندارید. noFill وضعیت عادی است؛ فضای تبلیغ را مخفی کنید و اپ ادامه یابد. درخواست پشت سر هم و retry بی‌وقفه انجام ندهید. هنگام حذف صفحه، handle یا view را مطابق مثال ببندید. در تب پنهان یا پوشش سفارشی، active را false کنید. نمایش خودکار روی هر resume مناسب نیست.
۶. جایزه، کیف و پوش
جایزه فقط پس از انتخاب کاربر، تماشای کامل و رسید verified و applied سرور معتبر است. callback یعنی جایزه پیش‌تر در کیف نصب دیدنکس ثبت شده؛ دوباره به موجودی اضافه نکنید. برای مصرف، externalId را پیش از ارسال ذخیره و در retry ثابت نگه دارید. کیف نصب، حساب قابل بازیابی چنددستگاهی نیست.
Inbox بدون Firebase و در اپ فعال کار می‌کند. پوش پس‌زمینه به رضایت کاربر، مجوز سیستم‌عامل و اتصال FCM/APNs/Web Push نیاز دارد؛ فعال‌کردن تبلیغ به این تنظیم‌ها وابسته نیست. همه ۱۳ فرمت اتصال مستقیم دارند؛ React Native و Godot فعلاً مستقیم هستند و شش SDK اصلی پراکسی اختیاری هم دارند.
۷. آزمون و رفع خطا
diagnosticToken پنل، با فایل واقعی متناسب با فرمت (تصویر، ویدیو، صوت یا بازی) تست بدون هزینه و جایزه می‌دهد؛ تأیید تحویل مالی نیست. برای تبلیغ واقعی، کمپین سازگار با بودجه و رسانه فعال لازم است. در خطای package، پسوند flavor خروجی را با رسانه تطبیق دهید؛ در وب Origin دقیق و HTTPS را بررسی کنید. خطای سرویس را با موفقیت مالی یا جایزه محلی جایگزین نکنید.
پیش از انتشار اپ، ساخت Release، قطع شبکه، DNS نامعتبر، پاسخ خراب، خروج صفحه وسط درخواست، پس‌زمینه و تکرار claim را روی دستگاه هدف بررسی کنید. مسیر ساخت تکرارپذیر و تست‌های هر SDK همراه سورس هستند.
قابلیت‌های SDK جدید و عیب‌یاب داخل اپ
نسخه نمایشی این انتشار ۱ است؛ شماره فنی و هش هر بسته در مرکز SDK درج شده است. هر ۱۱ فرمت در اتصال مستقیم و سرور اختیاری پشتیبانی می‌شوند؛ playable با helper بینابینی نمایش داده می‌شود و نیازمند SDK جدید است. در «لابراتوار تبلیغ»، بازی را بسازید و کمپین/جایگاه با فرمت playable انتخاب کنید. قالب‌های همان بازی در Flutter/Unity بومی رسم می‌شوند؛ وب و Kotlin/Swift/B4A از محیط HTML5 محدود استفاده می‌کنند.
برای عیب‌یاب، از پنل ناشر توکن تست جایگاه بگیرید و همان درخواست تست را اجرا کنید. در Flutter حالت debug، Android اپ debuggable، Swift ساخت DEBUG و Unity ساخت Development نیز مجازند. گزارش فقط محلی و محدود به ۸۰ رخداد، زمان، خطا، نوع رسانه و کیفیت است؛ کلید، JWT، URL امضاشده و شناسه مخاطب ثبت نمی‌شود. خروجی کپی را خودتان برای پشتیبانی می‌فرستید.
await DidnexAds.diagnose(document.querySelector('#slot'), 'UNT_ID', diagnosticToken);
DidnexAds.showInspector();خروجی‌های ویدیوی تطبیقی به‌طور خودکار از mediaSources انتخاب می‌شوند. حالت کم‌مصرف/شبکه موبایل کیفیت پایین، Wi-Fi یا شبکه سریع کیفیت بالاتر و شبکه نامشخص کیفیت میانی می‌گیرد. اجازه ACCESS_NETWORK_STATE در Android برای تشخیص شبکه لازم است؛ در نبود دسترسی، انتخاب محافظه‌کارانه انجام می‌شود. رویداد بارگذاری، نمایش قابل مشاهده، پیشرفت ویدیو و تأیید جایزه همچنان از مسیر امضاشده می‌گذرند؛ عیب‌یاب درآمد ایجاد نمی‌کند.
ابزارهای ساخت موبایل و دستگاه واقعی در محیط انتشار این سورس در دسترس نبودند. آزمون قرارداد سرور، رمزنگاری، تولید رسانه و پنل انجام شده؛ پیش از انتشار اپ، ساخت SDK در Flutter/Xcode/Android Studio/Unity/B4A و آزمون دستگاه را انجام دهید. بسته‌ها روی pub.dev یا فروشگاه‌ها منتشر نشده‌اند.