مرکز راهنماراهنما در پنلبسته اتصال

Flutter

اتصال مستقیم بدون سرور؛ هر ۱۱ فرمت و کیف جایزه مستقیم.

#

آخرین ویرایش راهنما: ۱۴۰۵/۸/۱۷

دریافت Flutterساخت کد جایگاه منسرور مشترک اپ‌ها ←
نسخه ۱ · اتصال مستقیم

سه قدم تا اولین تبلیغ Flutter

  1. رسانه و جایگاه همان فرمت را ثبت و تأیید کنید.
  2. بسته همین پلتفرم را نصب کنید.
  3. شناسه UNT_ مثال را با شناسه جایگاه خود جایگزین کنید.
اپ شما به سرور نیاز ندارد.

نشانی HTTPS در مثال، سرور خود دیدنکس است. در حالت مستقیم، JWT، کلید خصوصی و ورود کاربر لازم نیست. Android، iOS، Unity و B4A شناسه بسته را از خود اپ می‌خوانند؛ Flutter نیز در initialize جدید، شناسه بسته را محلی می‌خواند؛ ورود دستی در روش سازگار قدیمی ممکن است. تغییر دامنه دیدنکس فقط به تغییر همین نشانی در تنظیم اپ نیاز دارد.

۱. نصب و تنظیم اولیه

ZIP را باز و پوشه didnex_ads را در packages قرار دهید. وابستگی path زیر را در pubspec.yaml اپ اضافه و flutter pub get را اجرا کنید. example/lib/quick_start.dart یک اپ کامل است؛ برای اجرا آن را در lib/main.dart اپ میزبان قرار دهید.

Flutter ≥3.27، Dart ≥3.6، Android minSdk 24، Java 17 و iOS 15. برای AGP 9 با Kotlin داخلی فعال، Flutter ≥3.47. AGP و Kotlin را میزبان تعیین می‌کند؛ SDK کلاس‌پث Gradle دیگری دانلود نمی‌کند.

dependencies:
  didnex_ads:
    path: packages/didnex_ads

# flutter pub get
# flutter analyze
# flutter test

راه‌اندازی یک‌باره تبلیغ و پوش

نمونه کوتاه زیر فقط تنظیم اولیه است؛ callback و ظرف نمایش را در مثال کامل همین صفحه ببینید. init اجازه اعلان نمی‌گیرد و عضویت خودکار ندارد. یک کلاینت را برای عمر اپ نگه دارید و همان را برای تبلیغ و پوش استفاده کنید.

const placementId = "PASTE_YOUR_PLACEMENT_ID_HERE";
WidgetsFlutterBinding.ensureInitialized();
final client = await DidnexAds.initialize(origin: Uri.parse('https://didnex.com')); // Android/iOS identifier read locally
if (client != null) {
  final push = client.createPush(
    unitId: placementId,
    onMessage: (message) async => false, // Return true only after actual UI display.
    onError: (error) => debugPrint("DidnexPush: $error"),
  );
  // Keep push with the owner and dispose it when that owner ends.
  // Keep this client for app lifetime. Share it with views and push.
  runApp(DidnexAds.withClient(client: client, child: const MyApp()));
} else {
  runApp(const MyApp()); // App continues when SDK setup is unavailable.
}

اندازه ثابت جایگاه

اندازه از slot جایگاه تعیین می‌شود؛ تصویر و ویدیو با contain داخل همان کادرند. ابعاد فایل یا آماده‌شدن ویدیو، اندازه بیرونی را عوض نمی‌کند. noFill و خطا کادر را جمع می‌کنند. در Unity و Godot مستطیل میزبان را مطابق پروفایل انتخاب کنید.

پروفایل دیدنکساندازه مرجعنوار ثابت زیر رسانه
بنر استاندارد ۳۲۰ × ۵۰320 × 50ندارد
بنر بزرگ ۳۲۰ × ۱۰۰320 × 100ندارد
بنر مستطیل ۳۰۰ × ۲۵۰300 × 250ندارد
بنر عریض ۷۲۸ × ۹۰728 × 90ندارد
بنر تطبیقی با نسبت ۳۲۰ × ۵۰320 × 50ندارد
همسان افقی ۱۶:۹ + نوار ثابت640 × 36084 پیکسل منطقی
همسان مربع + نوار ثابت600 × 60084 پیکسل منطقی
ویدیوی همسان ۱۶:۹ + نوار ثابت640 × 36084 پیکسل منطقی
ویدیوی درون محتوا ۱۶:۹640 × 360ندارد
کاروسل ۱۶:۹ با نوار ثابت640 × 36084 پیکسل منطقی
نظرسنجی در کادر ثابت320 × 30084 پیکسل منطقی
کارت صوتی ثابت320 × 96ندارد
تمام‌صفحه با حاشیه امن360 × 64084 پیکسل منطقی
تمام‌صفحه با حاشیه امن360 × 64084 پیکسل منطقی
تمام‌صفحه با حاشیه امن360 × 64084 پیکسل منطقی
تمام‌صفحه با حاشیه امن360 × 64084 پیکسل منطقی
تمام‌صفحه با حاشیه امن360 × 64084 پیکسل منطقی

این‌ها پروفایل محصول دیدنکس‌اند؛ گواهی استاندارد یا یک اندازه پیکسلی جهانی برای همه فرمت‌ها نیستند. حداقل وضوح در فرم کمپین کنترل می‌شود. برای فعال‌شدن renderer جدید در اپ نصب‌شده، یک بار SDK را به‌روزرسانی کنید.

دریافت SDK و مثال کاملراهنمای آفلاین

فونت و ظاهر مشترک

ظاهر کارت در هر دو روش مستقیم و پراکسی از پاسخ همان تبلیغ خوانده می‌شود. مدیر در تنظیمات ← ظاهر تبلیغ و SDK، رنگ، زمینه، فونت، گردی کارت، جای نشان و پخش خودکار ویدیوی معمولی را تعیین می‌کند. ابتدا یک‌بار SDK و اپ را به‌روزرسانی کنید؛ سپس تغییرات پشتیبانی‌شده در درخواست بعدی تبلیغ اعمال می‌شوند. فونت Noto Sans Arabic فارسی و لوگو از سرور خود دیدنکس کش می‌شوند؛ خطای این دارایی‌های اختیاری باعث noFill یا خطای تبلیغ نمی‌شود. Unity برای UGUI یک فونت کوچک فارسی همراه و شکل‌دهی حروف در مرز نمایش دارد. سرور کد اجرایی جدید به اپ نمی‌فرستد.

ویدیوی معمولی هنگام دیده‌شدن خودکار و بی‌صداست؛ صوت و جایزه با انتخاب کاربر شروع می‌شوند. دامنه دیدنکس را در font-src سیاست CSP وب مجاز کنید.

۲. Manifest و مجوزهای لازم

قطعه زیر را با فایل موجود ادغام کنید. INTERNET باید در Manifest اصلی نسخه Release هم باشد. تبلیغ پایه به مجوز مکان، اعلان، حافظه یا شناسه تبلیغاتی نیاز ندارد.

<!-- Merge into android/app/src/main/AndroidManifest.xml (not debug only). -->
<manifest xmlns:android="http://schemas.android.com/apk/res/android">
 <uses-permission android:name="android.permission.INTERNET" />
 <uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
 <application />
</manifest>

در iOS فایل PrivacyInfo.xcprivacy بسته را به منابع Target اضافه کنید؛ HTTPS به غیرفعال‌کردن ATS نیاز ندارد. UIBackgroundModes فقط برای پوش پس‌زمینه اختیاری است. در Unity دسترسی اینترنت Player Settings را روی Require قرار دهید.

بازکردن جایگاه و راهنمای قدم‌به‌قدم اتصال — در پنل، نمونه با شناسه و بستهٔ رسانهٔ شما ساخته می‌شود؛ تست تا دریافت گزارش همان جلسه ادامه دارد.

۳. مثال کامل هر فرمت

هر شناسه جایگاه فقط یک فرمت دارد؛ فرمت باید با نوع رسانه و سیاست‌های پنل سازگار باشد. مثال کامل همان فرمت را انتخاب کنید. تمام‌صفحه فقط در نقطه طبیعی تجربه کاربر نمایش داده شود. ویدیوی معمولی خودکار و بی‌صداست؛ صوت و جایزه با اقدام کاربر شروع می‌شوند.

بنر · درون صفحه
import 'package:flutter/material.dart';
import 'package:didnex_ads/didnex_ads.dart';

// Match your approved media package/bundle identifier. No app backend or JWT.
const diagnosticToken='';
void main() => runApp(DidnexAds.direct(
  packageName: 'com.company.app',
  adOrigin: Uri.parse('https://didnex.com'),
  child: const MaterialApp(home: AdsPage()),
));
class AdsPage extends StatefulWidget {
  const AdsPage({super.key});
  @override State<AdsPage> createState() => _AdsPageState();
}
class _AdsPageState extends State<AdsPage> {
  String? _inlineUnit;
  bool _busy=false;
  String _message='یک فرمت انتخاب کنید';
  static const units=<String,String>{'banner':'UNT_BANNER'};
  Future<void> _show(String format) async {
    if(_busy)return;final unit=units[format]!;setState(()=>_busy=true);
    try {
      if(format.startsWith('rewarded')) {
        final receipt=await DidnexAds.showRewarded(context,unitId:unit,diagnosticToken:diagnosticToken.isEmpty?null:diagnosticToken);
        if(mounted)setState(()=>_message=receipt==null?'جایزه‌ای ثبت نشد':'جایزه در کیف نصب دیدنکس ثبت شد');
      } else if(['interstitial','app_open','playable'].contains(format)) {
        final shown=await DidnexAds.showInterstitial(context,unitId:unit,diagnosticToken:diagnosticToken.isEmpty?null:diagnosticToken);
        if(mounted)setState(()=>_message=shown?'نمایش پایان یافت':'فعلاً تبلیغی موجود نیست');
      } else {setState(()=>_inlineUnit=unit);}
    } catch(_) {if(mounted)setState(()=>_message='تبلیغ در دسترس نیست؛ اپ ادامه دارد');}
    finally {if(mounted)setState(()=>_busy=false);}
  }
  @override Widget build(BuildContext context)=>Directionality(textDirection:TextDirection.rtl,child:Scaffold(
    appBar:AppBar(title:const Text('اتصال دیدنکس')),
    body:ListView(padding:const EdgeInsets.all(16),children:[
      Text(_message),
      Wrap(spacing:8,children:units.keys.map((f)=>OutlinedButton(onPressed:_busy?null:()=>_show(f),child:Text(f))).toList()),
      if(_inlineUnit!=null)DidnexAdSlot(key:ValueKey(_inlineUnit),unitId:_inlineUnit!,diagnosticToken:diagnosticToken.isEmpty?null:diagnosticToken,
        noFillBuilder:(_,__)=>const SizedBox.shrink(),
        errorBuilder:(_,__)=>const SizedBox.shrink()),
    ]),
  ));
}
روش سروری اختیاری همین فرمت

فقط برای اپ دارای سرور: نشانی پراکسی و تابع نشست فعلی اپ را تکمیل کنید. تابع خالی نمونه، نشست واقعی ایجاد نمی‌کند. کلید خصوصی روی سرور می‌ماند.

import 'package:flutter/material.dart';
import 'package:didnex_ads/didnex_ads.dart';

// Match your approved media package/bundle identifier. No app backend or JWT.
const diagnosticToken='';
// Replace this function with the current authenticated session from YOUR app.
Future<String> appSessionToken() async => '';
void main() => runApp(DidnexAds(
  proxyUrl: Uri.parse('https://YOUR-BACKEND.example/ads'),
  sessionToken: appSessionToken,
  adOrigin: Uri.parse('https://didnex.com'),
  child: const MaterialApp(home: AdsPage()),
));
class AdsPage extends StatefulWidget {
  const AdsPage({super.key});
  @override State<AdsPage> createState() => _AdsPageState();
}
class _AdsPageState extends State<AdsPage> {
  String? _inlineUnit;
  bool _busy=false;
  String _message='یک فرمت انتخاب کنید';
  static const units=<String,String>{'banner':'UNT_BANNER'};
  Future<void> _show(String format) async {
    if(_busy)return;final unit=units[format]!;setState(()=>_busy=true);
    try {
      if(format.startsWith('rewarded')) {
        final receipt=await DidnexAds.showRewarded(context,unitId:unit,diagnosticToken:diagnosticToken.isEmpty?null:diagnosticToken);
        if(mounted)setState(()=>_message=receipt==null?'جایزه‌ای ثبت نشد':'جایزه در کیف نصب دیدنکس ثبت شد');
      } else if(['interstitial','app_open','playable'].contains(format)) {
        final shown=await DidnexAds.showInterstitial(context,unitId:unit,diagnosticToken:diagnosticToken.isEmpty?null:diagnosticToken);
        if(mounted)setState(()=>_message=shown?'نمایش پایان یافت':'فعلاً تبلیغی موجود نیست');
      } else {setState(()=>_inlineUnit=unit);}
    } catch(_) {if(mounted)setState(()=>_message='تبلیغ در دسترس نیست؛ اپ ادامه دارد');}
    finally {if(mounted)setState(()=>_busy=false);}
  }
  @override Widget build(BuildContext context)=>Directionality(textDirection:TextDirection.rtl,child:Scaffold(
    appBar:AppBar(title:const Text('اتصال دیدنکس')),
    body:ListView(padding:const EdgeInsets.all(16),children:[
      Text(_message),
      Wrap(spacing:8,children:units.keys.map((f)=>OutlinedButton(onPressed:_busy?null:()=>_show(f),child:Text(f))).toList()),
      if(_inlineUnit!=null)DidnexAdSlot(key:ValueKey(_inlineUnit),unitId:_inlineUnit!,diagnosticToken:diagnosticToken.isEmpty?null:diagnosticToken,
        noFillBuilder:(_,__)=>const SizedBox.shrink(),
        errorBuilder:(_,__)=>const SizedBox.shrink()),
    ]),
  ));
}
بنر تطبیقی · درون صفحه
import 'package:flutter/material.dart';
import 'package:didnex_ads/didnex_ads.dart';

// Match your approved media package/bundle identifier. No app backend or JWT.
const diagnosticToken='';
void main() => runApp(DidnexAds.direct(
  packageName: 'com.company.app',
  adOrigin: Uri.parse('https://didnex.com'),
  child: const MaterialApp(home: AdsPage()),
));
class AdsPage extends StatefulWidget {
  const AdsPage({super.key});
  @override State<AdsPage> createState() => _AdsPageState();
}
class _AdsPageState extends State<AdsPage> {
  String? _inlineUnit;
  bool _busy=false;
  String _message='یک فرمت انتخاب کنید';
  static const units=<String,String>{'adaptive_banner':'UNT_ADAPTIVE_BANNER'};
  Future<void> _show(String format) async {
    if(_busy)return;final unit=units[format]!;setState(()=>_busy=true);
    try {
      if(format.startsWith('rewarded')) {
        final receipt=await DidnexAds.showRewarded(context,unitId:unit,diagnosticToken:diagnosticToken.isEmpty?null:diagnosticToken);
        if(mounted)setState(()=>_message=receipt==null?'جایزه‌ای ثبت نشد':'جایزه در کیف نصب دیدنکس ثبت شد');
      } else if(['interstitial','app_open','playable'].contains(format)) {
        final shown=await DidnexAds.showInterstitial(context,unitId:unit,diagnosticToken:diagnosticToken.isEmpty?null:diagnosticToken);
        if(mounted)setState(()=>_message=shown?'نمایش پایان یافت':'فعلاً تبلیغی موجود نیست');
      } else {setState(()=>_inlineUnit=unit);}
    } catch(_) {if(mounted)setState(()=>_message='تبلیغ در دسترس نیست؛ اپ ادامه دارد');}
    finally {if(mounted)setState(()=>_busy=false);}
  }
  @override Widget build(BuildContext context)=>Directionality(textDirection:TextDirection.rtl,child:Scaffold(
    appBar:AppBar(title:const Text('اتصال دیدنکس')),
    body:ListView(padding:const EdgeInsets.all(16),children:[
      Text(_message),
      Wrap(spacing:8,children:units.keys.map((f)=>OutlinedButton(onPressed:_busy?null:()=>_show(f),child:Text(f))).toList()),
      if(_inlineUnit!=null)DidnexAdSlot(key:ValueKey(_inlineUnit),unitId:_inlineUnit!,diagnosticToken:diagnosticToken.isEmpty?null:diagnosticToken,
        noFillBuilder:(_,__)=>const SizedBox.shrink(),
        errorBuilder:(_,__)=>const SizedBox.shrink()),
    ]),
  ));
}
روش سروری اختیاری همین فرمت

فقط برای اپ دارای سرور: نشانی پراکسی و تابع نشست فعلی اپ را تکمیل کنید. تابع خالی نمونه، نشست واقعی ایجاد نمی‌کند. کلید خصوصی روی سرور می‌ماند.

import 'package:flutter/material.dart';
import 'package:didnex_ads/didnex_ads.dart';

// Match your approved media package/bundle identifier. No app backend or JWT.
const diagnosticToken='';
// Replace this function with the current authenticated session from YOUR app.
Future<String> appSessionToken() async => '';
void main() => runApp(DidnexAds(
  proxyUrl: Uri.parse('https://YOUR-BACKEND.example/ads'),
  sessionToken: appSessionToken,
  adOrigin: Uri.parse('https://didnex.com'),
  child: const MaterialApp(home: AdsPage()),
));
class AdsPage extends StatefulWidget {
  const AdsPage({super.key});
  @override State<AdsPage> createState() => _AdsPageState();
}
class _AdsPageState extends State<AdsPage> {
  String? _inlineUnit;
  bool _busy=false;
  String _message='یک فرمت انتخاب کنید';
  static const units=<String,String>{'adaptive_banner':'UNT_ADAPTIVE_BANNER'};
  Future<void> _show(String format) async {
    if(_busy)return;final unit=units[format]!;setState(()=>_busy=true);
    try {
      if(format.startsWith('rewarded')) {
        final receipt=await DidnexAds.showRewarded(context,unitId:unit,diagnosticToken:diagnosticToken.isEmpty?null:diagnosticToken);
        if(mounted)setState(()=>_message=receipt==null?'جایزه‌ای ثبت نشد':'جایزه در کیف نصب دیدنکس ثبت شد');
      } else if(['interstitial','app_open','playable'].contains(format)) {
        final shown=await DidnexAds.showInterstitial(context,unitId:unit,diagnosticToken:diagnosticToken.isEmpty?null:diagnosticToken);
        if(mounted)setState(()=>_message=shown?'نمایش پایان یافت':'فعلاً تبلیغی موجود نیست');
      } else {setState(()=>_inlineUnit=unit);}
    } catch(_) {if(mounted)setState(()=>_message='تبلیغ در دسترس نیست؛ اپ ادامه دارد');}
    finally {if(mounted)setState(()=>_busy=false);}
  }
  @override Widget build(BuildContext context)=>Directionality(textDirection:TextDirection.rtl,child:Scaffold(
    appBar:AppBar(title:const Text('اتصال دیدنکس')),
    body:ListView(padding:const EdgeInsets.all(16),children:[
      Text(_message),
      Wrap(spacing:8,children:units.keys.map((f)=>OutlinedButton(onPressed:_busy?null:()=>_show(f),child:Text(f))).toList()),
      if(_inlineUnit!=null)DidnexAdSlot(key:ValueKey(_inlineUnit),unitId:_inlineUnit!,diagnosticToken:diagnosticToken.isEmpty?null:diagnosticToken,
        noFillBuilder:(_,__)=>const SizedBox.shrink(),
        errorBuilder:(_,__)=>const SizedBox.shrink()),
    ]),
  ));
}
همسان · درون صفحه
import 'package:flutter/material.dart';
import 'package:didnex_ads/didnex_ads.dart';

// Match your approved media package/bundle identifier. No app backend or JWT.
const diagnosticToken='';
void main() => runApp(DidnexAds.direct(
  packageName: 'com.company.app',
  adOrigin: Uri.parse('https://didnex.com'),
  child: const MaterialApp(home: AdsPage()),
));
class AdsPage extends StatefulWidget {
  const AdsPage({super.key});
  @override State<AdsPage> createState() => _AdsPageState();
}
class _AdsPageState extends State<AdsPage> {
  String? _inlineUnit;
  bool _busy=false;
  String _message='یک فرمت انتخاب کنید';
  static const units=<String,String>{'native':'UNT_NATIVE'};
  Future<void> _show(String format) async {
    if(_busy)return;final unit=units[format]!;setState(()=>_busy=true);
    try {
      if(format.startsWith('rewarded')) {
        final receipt=await DidnexAds.showRewarded(context,unitId:unit,diagnosticToken:diagnosticToken.isEmpty?null:diagnosticToken);
        if(mounted)setState(()=>_message=receipt==null?'جایزه‌ای ثبت نشد':'جایزه در کیف نصب دیدنکس ثبت شد');
      } else if(['interstitial','app_open','playable'].contains(format)) {
        final shown=await DidnexAds.showInterstitial(context,unitId:unit,diagnosticToken:diagnosticToken.isEmpty?null:diagnosticToken);
        if(mounted)setState(()=>_message=shown?'نمایش پایان یافت':'فعلاً تبلیغی موجود نیست');
      } else {setState(()=>_inlineUnit=unit);}
    } catch(_) {if(mounted)setState(()=>_message='تبلیغ در دسترس نیست؛ اپ ادامه دارد');}
    finally {if(mounted)setState(()=>_busy=false);}
  }
  @override Widget build(BuildContext context)=>Directionality(textDirection:TextDirection.rtl,child:Scaffold(
    appBar:AppBar(title:const Text('اتصال دیدنکس')),
    body:ListView(padding:const EdgeInsets.all(16),children:[
      Text(_message),
      Wrap(spacing:8,children:units.keys.map((f)=>OutlinedButton(onPressed:_busy?null:()=>_show(f),child:Text(f))).toList()),
      if(_inlineUnit!=null)DidnexAdSlot(key:ValueKey(_inlineUnit),unitId:_inlineUnit!,diagnosticToken:diagnosticToken.isEmpty?null:diagnosticToken,
        noFillBuilder:(_,__)=>const SizedBox.shrink(),
        errorBuilder:(_,__)=>const SizedBox.shrink()),
    ]),
  ));
}
روش سروری اختیاری همین فرمت

فقط برای اپ دارای سرور: نشانی پراکسی و تابع نشست فعلی اپ را تکمیل کنید. تابع خالی نمونه، نشست واقعی ایجاد نمی‌کند. کلید خصوصی روی سرور می‌ماند.

import 'package:flutter/material.dart';
import 'package:didnex_ads/didnex_ads.dart';

// Match your approved media package/bundle identifier. No app backend or JWT.
const diagnosticToken='';
// Replace this function with the current authenticated session from YOUR app.
Future<String> appSessionToken() async => '';
void main() => runApp(DidnexAds(
  proxyUrl: Uri.parse('https://YOUR-BACKEND.example/ads'),
  sessionToken: appSessionToken,
  adOrigin: Uri.parse('https://didnex.com'),
  child: const MaterialApp(home: AdsPage()),
));
class AdsPage extends StatefulWidget {
  const AdsPage({super.key});
  @override State<AdsPage> createState() => _AdsPageState();
}
class _AdsPageState extends State<AdsPage> {
  String? _inlineUnit;
  bool _busy=false;
  String _message='یک فرمت انتخاب کنید';
  static const units=<String,String>{'native':'UNT_NATIVE'};
  Future<void> _show(String format) async {
    if(_busy)return;final unit=units[format]!;setState(()=>_busy=true);
    try {
      if(format.startsWith('rewarded')) {
        final receipt=await DidnexAds.showRewarded(context,unitId:unit,diagnosticToken:diagnosticToken.isEmpty?null:diagnosticToken);
        if(mounted)setState(()=>_message=receipt==null?'جایزه‌ای ثبت نشد':'جایزه در کیف نصب دیدنکس ثبت شد');
      } else if(['interstitial','app_open','playable'].contains(format)) {
        final shown=await DidnexAds.showInterstitial(context,unitId:unit,diagnosticToken:diagnosticToken.isEmpty?null:diagnosticToken);
        if(mounted)setState(()=>_message=shown?'نمایش پایان یافت':'فعلاً تبلیغی موجود نیست');
      } else {setState(()=>_inlineUnit=unit);}
    } catch(_) {if(mounted)setState(()=>_message='تبلیغ در دسترس نیست؛ اپ ادامه دارد');}
    finally {if(mounted)setState(()=>_busy=false);}
  }
  @override Widget build(BuildContext context)=>Directionality(textDirection:TextDirection.rtl,child:Scaffold(
    appBar:AppBar(title:const Text('اتصال دیدنکس')),
    body:ListView(padding:const EdgeInsets.all(16),children:[
      Text(_message),
      Wrap(spacing:8,children:units.keys.map((f)=>OutlinedButton(onPressed:_busy?null:()=>_show(f),child:Text(f))).toList()),
      if(_inlineUnit!=null)DidnexAdSlot(key:ValueKey(_inlineUnit),unitId:_inlineUnit!,diagnosticToken:diagnosticToken.isEmpty?null:diagnosticToken,
        noFillBuilder:(_,__)=>const SizedBox.shrink(),
        errorBuilder:(_,__)=>const SizedBox.shrink()),
    ]),
  ));
}
ویدیوی همسان · درون صفحه
import 'package:flutter/material.dart';
import 'package:didnex_ads/didnex_ads.dart';

// Match your approved media package/bundle identifier. No app backend or JWT.
const diagnosticToken='';
void main() => runApp(DidnexAds.direct(
  packageName: 'com.company.app',
  adOrigin: Uri.parse('https://didnex.com'),
  child: const MaterialApp(home: AdsPage()),
));
class AdsPage extends StatefulWidget {
  const AdsPage({super.key});
  @override State<AdsPage> createState() => _AdsPageState();
}
class _AdsPageState extends State<AdsPage> {
  String? _inlineUnit;
  bool _busy=false;
  String _message='یک فرمت انتخاب کنید';
  static const units=<String,String>{'native_video':'UNT_NATIVE_VIDEO'};
  Future<void> _show(String format) async {
    if(_busy)return;final unit=units[format]!;setState(()=>_busy=true);
    try {
      if(format.startsWith('rewarded')) {
        final receipt=await DidnexAds.showRewarded(context,unitId:unit,diagnosticToken:diagnosticToken.isEmpty?null:diagnosticToken);
        if(mounted)setState(()=>_message=receipt==null?'جایزه‌ای ثبت نشد':'جایزه در کیف نصب دیدنکس ثبت شد');
      } else if(['interstitial','app_open','playable'].contains(format)) {
        final shown=await DidnexAds.showInterstitial(context,unitId:unit,diagnosticToken:diagnosticToken.isEmpty?null:diagnosticToken);
        if(mounted)setState(()=>_message=shown?'نمایش پایان یافت':'فعلاً تبلیغی موجود نیست');
      } else {setState(()=>_inlineUnit=unit);}
    } catch(_) {if(mounted)setState(()=>_message='تبلیغ در دسترس نیست؛ اپ ادامه دارد');}
    finally {if(mounted)setState(()=>_busy=false);}
  }
  @override Widget build(BuildContext context)=>Directionality(textDirection:TextDirection.rtl,child:Scaffold(
    appBar:AppBar(title:const Text('اتصال دیدنکس')),
    body:ListView(padding:const EdgeInsets.all(16),children:[
      Text(_message),
      Wrap(spacing:8,children:units.keys.map((f)=>OutlinedButton(onPressed:_busy?null:()=>_show(f),child:Text(f))).toList()),
      if(_inlineUnit!=null)DidnexAdSlot(key:ValueKey(_inlineUnit),unitId:_inlineUnit!,diagnosticToken:diagnosticToken.isEmpty?null:diagnosticToken,
        noFillBuilder:(_,__)=>const SizedBox.shrink(),
        errorBuilder:(_,__)=>const SizedBox.shrink()),
    ]),
  ));
}
روش سروری اختیاری همین فرمت

فقط برای اپ دارای سرور: نشانی پراکسی و تابع نشست فعلی اپ را تکمیل کنید. تابع خالی نمونه، نشست واقعی ایجاد نمی‌کند. کلید خصوصی روی سرور می‌ماند.

import 'package:flutter/material.dart';
import 'package:didnex_ads/didnex_ads.dart';

// Match your approved media package/bundle identifier. No app backend or JWT.
const diagnosticToken='';
// Replace this function with the current authenticated session from YOUR app.
Future<String> appSessionToken() async => '';
void main() => runApp(DidnexAds(
  proxyUrl: Uri.parse('https://YOUR-BACKEND.example/ads'),
  sessionToken: appSessionToken,
  adOrigin: Uri.parse('https://didnex.com'),
  child: const MaterialApp(home: AdsPage()),
));
class AdsPage extends StatefulWidget {
  const AdsPage({super.key});
  @override State<AdsPage> createState() => _AdsPageState();
}
class _AdsPageState extends State<AdsPage> {
  String? _inlineUnit;
  bool _busy=false;
  String _message='یک فرمت انتخاب کنید';
  static const units=<String,String>{'native_video':'UNT_NATIVE_VIDEO'};
  Future<void> _show(String format) async {
    if(_busy)return;final unit=units[format]!;setState(()=>_busy=true);
    try {
      if(format.startsWith('rewarded')) {
        final receipt=await DidnexAds.showRewarded(context,unitId:unit,diagnosticToken:diagnosticToken.isEmpty?null:diagnosticToken);
        if(mounted)setState(()=>_message=receipt==null?'جایزه‌ای ثبت نشد':'جایزه در کیف نصب دیدنکس ثبت شد');
      } else if(['interstitial','app_open','playable'].contains(format)) {
        final shown=await DidnexAds.showInterstitial(context,unitId:unit,diagnosticToken:diagnosticToken.isEmpty?null:diagnosticToken);
        if(mounted)setState(()=>_message=shown?'نمایش پایان یافت':'فعلاً تبلیغی موجود نیست');
      } else {setState(()=>_inlineUnit=unit);}
    } catch(_) {if(mounted)setState(()=>_message='تبلیغ در دسترس نیست؛ اپ ادامه دارد');}
    finally {if(mounted)setState(()=>_busy=false);}
  }
  @override Widget build(BuildContext context)=>Directionality(textDirection:TextDirection.rtl,child:Scaffold(
    appBar:AppBar(title:const Text('اتصال دیدنکس')),
    body:ListView(padding:const EdgeInsets.all(16),children:[
      Text(_message),
      Wrap(spacing:8,children:units.keys.map((f)=>OutlinedButton(onPressed:_busy?null:()=>_show(f),child:Text(f))).toList()),
      if(_inlineUnit!=null)DidnexAdSlot(key:ValueKey(_inlineUnit),unitId:_inlineUnit!,diagnosticToken:diagnosticToken.isEmpty?null:diagnosticToken,
        noFillBuilder:(_,__)=>const SizedBox.shrink(),
        errorBuilder:(_,__)=>const SizedBox.shrink()),
    ]),
  ));
}
ویدیوی درون محتوا · درون صفحه
import 'package:flutter/material.dart';
import 'package:didnex_ads/didnex_ads.dart';

// Match your approved media package/bundle identifier. No app backend or JWT.
const diagnosticToken='';
void main() => runApp(DidnexAds.direct(
  packageName: 'com.company.app',
  adOrigin: Uri.parse('https://didnex.com'),
  child: const MaterialApp(home: AdsPage()),
));
class AdsPage extends StatefulWidget {
  const AdsPage({super.key});
  @override State<AdsPage> createState() => _AdsPageState();
}
class _AdsPageState extends State<AdsPage> {
  String? _inlineUnit;
  bool _busy=false;
  String _message='یک فرمت انتخاب کنید';
  static const units=<String,String>{'video':'UNT_VIDEO'};
  Future<void> _show(String format) async {
    if(_busy)return;final unit=units[format]!;setState(()=>_busy=true);
    try {
      if(format.startsWith('rewarded')) {
        final receipt=await DidnexAds.showRewarded(context,unitId:unit,diagnosticToken:diagnosticToken.isEmpty?null:diagnosticToken);
        if(mounted)setState(()=>_message=receipt==null?'جایزه‌ای ثبت نشد':'جایزه در کیف نصب دیدنکس ثبت شد');
      } else if(['interstitial','app_open','playable'].contains(format)) {
        final shown=await DidnexAds.showInterstitial(context,unitId:unit,diagnosticToken:diagnosticToken.isEmpty?null:diagnosticToken);
        if(mounted)setState(()=>_message=shown?'نمایش پایان یافت':'فعلاً تبلیغی موجود نیست');
      } else {setState(()=>_inlineUnit=unit);}
    } catch(_) {if(mounted)setState(()=>_message='تبلیغ در دسترس نیست؛ اپ ادامه دارد');}
    finally {if(mounted)setState(()=>_busy=false);}
  }
  @override Widget build(BuildContext context)=>Directionality(textDirection:TextDirection.rtl,child:Scaffold(
    appBar:AppBar(title:const Text('اتصال دیدنکس')),
    body:ListView(padding:const EdgeInsets.all(16),children:[
      Text(_message),
      Wrap(spacing:8,children:units.keys.map((f)=>OutlinedButton(onPressed:_busy?null:()=>_show(f),child:Text(f))).toList()),
      if(_inlineUnit!=null)DidnexAdSlot(key:ValueKey(_inlineUnit),unitId:_inlineUnit!,diagnosticToken:diagnosticToken.isEmpty?null:diagnosticToken,
        noFillBuilder:(_,__)=>const SizedBox.shrink(),
        errorBuilder:(_,__)=>const SizedBox.shrink()),
    ]),
  ));
}
روش سروری اختیاری همین فرمت

فقط برای اپ دارای سرور: نشانی پراکسی و تابع نشست فعلی اپ را تکمیل کنید. تابع خالی نمونه، نشست واقعی ایجاد نمی‌کند. کلید خصوصی روی سرور می‌ماند.

import 'package:flutter/material.dart';
import 'package:didnex_ads/didnex_ads.dart';

// Match your approved media package/bundle identifier. No app backend or JWT.
const diagnosticToken='';
// Replace this function with the current authenticated session from YOUR app.
Future<String> appSessionToken() async => '';
void main() => runApp(DidnexAds(
  proxyUrl: Uri.parse('https://YOUR-BACKEND.example/ads'),
  sessionToken: appSessionToken,
  adOrigin: Uri.parse('https://didnex.com'),
  child: const MaterialApp(home: AdsPage()),
));
class AdsPage extends StatefulWidget {
  const AdsPage({super.key});
  @override State<AdsPage> createState() => _AdsPageState();
}
class _AdsPageState extends State<AdsPage> {
  String? _inlineUnit;
  bool _busy=false;
  String _message='یک فرمت انتخاب کنید';
  static const units=<String,String>{'video':'UNT_VIDEO'};
  Future<void> _show(String format) async {
    if(_busy)return;final unit=units[format]!;setState(()=>_busy=true);
    try {
      if(format.startsWith('rewarded')) {
        final receipt=await DidnexAds.showRewarded(context,unitId:unit,diagnosticToken:diagnosticToken.isEmpty?null:diagnosticToken);
        if(mounted)setState(()=>_message=receipt==null?'جایزه‌ای ثبت نشد':'جایزه در کیف نصب دیدنکس ثبت شد');
      } else if(['interstitial','app_open','playable'].contains(format)) {
        final shown=await DidnexAds.showInterstitial(context,unitId:unit,diagnosticToken:diagnosticToken.isEmpty?null:diagnosticToken);
        if(mounted)setState(()=>_message=shown?'نمایش پایان یافت':'فعلاً تبلیغی موجود نیست');
      } else {setState(()=>_inlineUnit=unit);}
    } catch(_) {if(mounted)setState(()=>_message='تبلیغ در دسترس نیست؛ اپ ادامه دارد');}
    finally {if(mounted)setState(()=>_busy=false);}
  }
  @override Widget build(BuildContext context)=>Directionality(textDirection:TextDirection.rtl,child:Scaffold(
    appBar:AppBar(title:const Text('اتصال دیدنکس')),
    body:ListView(padding:const EdgeInsets.all(16),children:[
      Text(_message),
      Wrap(spacing:8,children:units.keys.map((f)=>OutlinedButton(onPressed:_busy?null:()=>_show(f),child:Text(f))).toList()),
      if(_inlineUnit!=null)DidnexAdSlot(key:ValueKey(_inlineUnit),unitId:_inlineUnit!,diagnosticToken:diagnosticToken.isEmpty?null:diagnosticToken,
        noFillBuilder:(_,__)=>const SizedBox.shrink(),
        errorBuilder:(_,__)=>const SizedBox.shrink()),
    ]),
  ));
}
بینابینی · تمام‌صفحه
import 'package:flutter/material.dart';
import 'package:didnex_ads/didnex_ads.dart';

// Match your approved media package/bundle identifier. No app backend or JWT.
const diagnosticToken='';
void main() => runApp(DidnexAds.direct(
  packageName: 'com.company.app',
  adOrigin: Uri.parse('https://didnex.com'),
  child: const MaterialApp(home: AdsPage()),
));
class AdsPage extends StatefulWidget {
  const AdsPage({super.key});
  @override State<AdsPage> createState() => _AdsPageState();
}
class _AdsPageState extends State<AdsPage> {
  String? _inlineUnit;
  bool _busy=false;
  String _message='یک فرمت انتخاب کنید';
  static const units=<String,String>{'interstitial':'UNT_INTERSTITIAL'};
  Future<void> _show(String format) async {
    if(_busy)return;final unit=units[format]!;setState(()=>_busy=true);
    try {
      if(format.startsWith('rewarded')) {
        final receipt=await DidnexAds.showRewarded(context,unitId:unit,diagnosticToken:diagnosticToken.isEmpty?null:diagnosticToken);
        if(mounted)setState(()=>_message=receipt==null?'جایزه‌ای ثبت نشد':'جایزه در کیف نصب دیدنکس ثبت شد');
      } else if(['interstitial','app_open','playable'].contains(format)) {
        final shown=await DidnexAds.showInterstitial(context,unitId:unit,diagnosticToken:diagnosticToken.isEmpty?null:diagnosticToken);
        if(mounted)setState(()=>_message=shown?'نمایش پایان یافت':'فعلاً تبلیغی موجود نیست');
      } else {setState(()=>_inlineUnit=unit);}
    } catch(_) {if(mounted)setState(()=>_message='تبلیغ در دسترس نیست؛ اپ ادامه دارد');}
    finally {if(mounted)setState(()=>_busy=false);}
  }
  @override Widget build(BuildContext context)=>Directionality(textDirection:TextDirection.rtl,child:Scaffold(
    appBar:AppBar(title:const Text('اتصال دیدنکس')),
    body:ListView(padding:const EdgeInsets.all(16),children:[
      Text(_message),
      Wrap(spacing:8,children:units.keys.map((f)=>OutlinedButton(onPressed:_busy?null:()=>_show(f),child:Text(f))).toList()),
      if(_inlineUnit!=null)DidnexAdSlot(key:ValueKey(_inlineUnit),unitId:_inlineUnit!,diagnosticToken:diagnosticToken.isEmpty?null:diagnosticToken,
        noFillBuilder:(_,__)=>const SizedBox.shrink(),
        errorBuilder:(_,__)=>const SizedBox.shrink()),
    ]),
  ));
}
روش سروری اختیاری همین فرمت

فقط برای اپ دارای سرور: نشانی پراکسی و تابع نشست فعلی اپ را تکمیل کنید. تابع خالی نمونه، نشست واقعی ایجاد نمی‌کند. کلید خصوصی روی سرور می‌ماند.

import 'package:flutter/material.dart';
import 'package:didnex_ads/didnex_ads.dart';

// Match your approved media package/bundle identifier. No app backend or JWT.
const diagnosticToken='';
// Replace this function with the current authenticated session from YOUR app.
Future<String> appSessionToken() async => '';
void main() => runApp(DidnexAds(
  proxyUrl: Uri.parse('https://YOUR-BACKEND.example/ads'),
  sessionToken: appSessionToken,
  adOrigin: Uri.parse('https://didnex.com'),
  child: const MaterialApp(home: AdsPage()),
));
class AdsPage extends StatefulWidget {
  const AdsPage({super.key});
  @override State<AdsPage> createState() => _AdsPageState();
}
class _AdsPageState extends State<AdsPage> {
  String? _inlineUnit;
  bool _busy=false;
  String _message='یک فرمت انتخاب کنید';
  static const units=<String,String>{'interstitial':'UNT_INTERSTITIAL'};
  Future<void> _show(String format) async {
    if(_busy)return;final unit=units[format]!;setState(()=>_busy=true);
    try {
      if(format.startsWith('rewarded')) {
        final receipt=await DidnexAds.showRewarded(context,unitId:unit,diagnosticToken:diagnosticToken.isEmpty?null:diagnosticToken);
        if(mounted)setState(()=>_message=receipt==null?'جایزه‌ای ثبت نشد':'جایزه در کیف نصب دیدنکس ثبت شد');
      } else if(['interstitial','app_open','playable'].contains(format)) {
        final shown=await DidnexAds.showInterstitial(context,unitId:unit,diagnosticToken:diagnosticToken.isEmpty?null:diagnosticToken);
        if(mounted)setState(()=>_message=shown?'نمایش پایان یافت':'فعلاً تبلیغی موجود نیست');
      } else {setState(()=>_inlineUnit=unit);}
    } catch(_) {if(mounted)setState(()=>_message='تبلیغ در دسترس نیست؛ اپ ادامه دارد');}
    finally {if(mounted)setState(()=>_busy=false);}
  }
  @override Widget build(BuildContext context)=>Directionality(textDirection:TextDirection.rtl,child:Scaffold(
    appBar:AppBar(title:const Text('اتصال دیدنکس')),
    body:ListView(padding:const EdgeInsets.all(16),children:[
      Text(_message),
      Wrap(spacing:8,children:units.keys.map((f)=>OutlinedButton(onPressed:_busy?null:()=>_show(f),child:Text(f))).toList()),
      if(_inlineUnit!=null)DidnexAdSlot(key:ValueKey(_inlineUnit),unitId:_inlineUnit!,diagnosticToken:diagnosticToken.isEmpty?null:diagnosticToken,
        noFillBuilder:(_,__)=>const SizedBox.shrink(),
        errorBuilder:(_,__)=>const SizedBox.shrink()),
    ]),
  ));
}
ویدیوی جایزه‌دار · جایزه‌دار
import 'package:flutter/material.dart';
import 'package:didnex_ads/didnex_ads.dart';

// Match your approved media package/bundle identifier. No app backend or JWT.
const diagnosticToken='';
void main() => runApp(DidnexAds.direct(
  packageName: 'com.company.app',
  adOrigin: Uri.parse('https://didnex.com'),
  child: const MaterialApp(home: AdsPage()),
));
class AdsPage extends StatefulWidget {
  const AdsPage({super.key});
  @override State<AdsPage> createState() => _AdsPageState();
}
class _AdsPageState extends State<AdsPage> {
  String? _inlineUnit;
  bool _busy=false;
  String _message='یک فرمت انتخاب کنید';
  static const units=<String,String>{'rewarded':'UNT_REWARDED'};
  Future<void> _show(String format) async {
    if(_busy)return;final unit=units[format]!;setState(()=>_busy=true);
    try {
      if(format.startsWith('rewarded')) {
        final receipt=await DidnexAds.showRewarded(context,unitId:unit,diagnosticToken:diagnosticToken.isEmpty?null:diagnosticToken);
        if(mounted)setState(()=>_message=receipt==null?'جایزه‌ای ثبت نشد':'جایزه در کیف نصب دیدنکس ثبت شد');
      } else if(['interstitial','app_open','playable'].contains(format)) {
        final shown=await DidnexAds.showInterstitial(context,unitId:unit,diagnosticToken:diagnosticToken.isEmpty?null:diagnosticToken);
        if(mounted)setState(()=>_message=shown?'نمایش پایان یافت':'فعلاً تبلیغی موجود نیست');
      } else {setState(()=>_inlineUnit=unit);}
    } catch(_) {if(mounted)setState(()=>_message='تبلیغ در دسترس نیست؛ اپ ادامه دارد');}
    finally {if(mounted)setState(()=>_busy=false);}
  }
  @override Widget build(BuildContext context)=>Directionality(textDirection:TextDirection.rtl,child:Scaffold(
    appBar:AppBar(title:const Text('اتصال دیدنکس')),
    body:ListView(padding:const EdgeInsets.all(16),children:[
      Text(_message),
      Wrap(spacing:8,children:units.keys.map((f)=>OutlinedButton(onPressed:_busy?null:()=>_show(f),child:Text(f))).toList()),
      if(_inlineUnit!=null)DidnexAdSlot(key:ValueKey(_inlineUnit),unitId:_inlineUnit!,diagnosticToken:diagnosticToken.isEmpty?null:diagnosticToken,
        noFillBuilder:(_,__)=>const SizedBox.shrink(),
        errorBuilder:(_,__)=>const SizedBox.shrink()),
    ]),
  ));
}
روش سروری اختیاری همین فرمت

فقط برای اپ دارای سرور: نشانی پراکسی و تابع نشست فعلی اپ را تکمیل کنید. تابع خالی نمونه، نشست واقعی ایجاد نمی‌کند. کلید خصوصی روی سرور می‌ماند.

import 'package:flutter/material.dart';
import 'package:didnex_ads/didnex_ads.dart';

// Match your approved media package/bundle identifier. No app backend or JWT.
const diagnosticToken='';
// Replace this function with the current authenticated session from YOUR app.
Future<String> appSessionToken() async => '';
void main() => runApp(DidnexAds(
  proxyUrl: Uri.parse('https://YOUR-BACKEND.example/ads'),
  sessionToken: appSessionToken,
  adOrigin: Uri.parse('https://didnex.com'),
  child: const MaterialApp(home: AdsPage()),
));
class AdsPage extends StatefulWidget {
  const AdsPage({super.key});
  @override State<AdsPage> createState() => _AdsPageState();
}
class _AdsPageState extends State<AdsPage> {
  String? _inlineUnit;
  bool _busy=false;
  String _message='یک فرمت انتخاب کنید';
  static const units=<String,String>{'rewarded':'UNT_REWARDED'};
  Future<void> _show(String format) async {
    if(_busy)return;final unit=units[format]!;setState(()=>_busy=true);
    try {
      if(format.startsWith('rewarded')) {
        final receipt=await DidnexAds.showRewarded(context,unitId:unit,diagnosticToken:diagnosticToken.isEmpty?null:diagnosticToken);
        if(mounted)setState(()=>_message=receipt==null?'جایزه‌ای ثبت نشد':'جایزه در کیف نصب دیدنکس ثبت شد');
      } else if(['interstitial','app_open','playable'].contains(format)) {
        final shown=await DidnexAds.showInterstitial(context,unitId:unit,diagnosticToken:diagnosticToken.isEmpty?null:diagnosticToken);
        if(mounted)setState(()=>_message=shown?'نمایش پایان یافت':'فعلاً تبلیغی موجود نیست');
      } else {setState(()=>_inlineUnit=unit);}
    } catch(_) {if(mounted)setState(()=>_message='تبلیغ در دسترس نیست؛ اپ ادامه دارد');}
    finally {if(mounted)setState(()=>_busy=false);}
  }
  @override Widget build(BuildContext context)=>Directionality(textDirection:TextDirection.rtl,child:Scaffold(
    appBar:AppBar(title:const Text('اتصال دیدنکس')),
    body:ListView(padding:const EdgeInsets.all(16),children:[
      Text(_message),
      Wrap(spacing:8,children:units.keys.map((f)=>OutlinedButton(onPressed:_busy?null:()=>_show(f),child:Text(f))).toList()),
      if(_inlineUnit!=null)DidnexAdSlot(key:ValueKey(_inlineUnit),unitId:_inlineUnit!,diagnosticToken:diagnosticToken.isEmpty?null:diagnosticToken,
        noFillBuilder:(_,__)=>const SizedBox.shrink(),
        errorBuilder:(_,__)=>const SizedBox.shrink()),
    ]),
  ));
}
بینابینی جایزه‌دار · جایزه‌دار
import 'package:flutter/material.dart';
import 'package:didnex_ads/didnex_ads.dart';

// Match your approved media package/bundle identifier. No app backend or JWT.
const diagnosticToken='';
void main() => runApp(DidnexAds.direct(
  packageName: 'com.company.app',
  adOrigin: Uri.parse('https://didnex.com'),
  child: const MaterialApp(home: AdsPage()),
));
class AdsPage extends StatefulWidget {
  const AdsPage({super.key});
  @override State<AdsPage> createState() => _AdsPageState();
}
class _AdsPageState extends State<AdsPage> {
  String? _inlineUnit;
  bool _busy=false;
  String _message='یک فرمت انتخاب کنید';
  static const units=<String,String>{'rewarded_interstitial':'UNT_REWARDED_INTERSTITIAL'};
  Future<void> _show(String format) async {
    if(_busy)return;final unit=units[format]!;setState(()=>_busy=true);
    try {
      if(format.startsWith('rewarded')) {
        final receipt=await DidnexAds.showRewarded(context,unitId:unit,diagnosticToken:diagnosticToken.isEmpty?null:diagnosticToken);
        if(mounted)setState(()=>_message=receipt==null?'جایزه‌ای ثبت نشد':'جایزه در کیف نصب دیدنکس ثبت شد');
      } else if(['interstitial','app_open','playable'].contains(format)) {
        final shown=await DidnexAds.showInterstitial(context,unitId:unit,diagnosticToken:diagnosticToken.isEmpty?null:diagnosticToken);
        if(mounted)setState(()=>_message=shown?'نمایش پایان یافت':'فعلاً تبلیغی موجود نیست');
      } else {setState(()=>_inlineUnit=unit);}
    } catch(_) {if(mounted)setState(()=>_message='تبلیغ در دسترس نیست؛ اپ ادامه دارد');}
    finally {if(mounted)setState(()=>_busy=false);}
  }
  @override Widget build(BuildContext context)=>Directionality(textDirection:TextDirection.rtl,child:Scaffold(
    appBar:AppBar(title:const Text('اتصال دیدنکس')),
    body:ListView(padding:const EdgeInsets.all(16),children:[
      Text(_message),
      Wrap(spacing:8,children:units.keys.map((f)=>OutlinedButton(onPressed:_busy?null:()=>_show(f),child:Text(f))).toList()),
      if(_inlineUnit!=null)DidnexAdSlot(key:ValueKey(_inlineUnit),unitId:_inlineUnit!,diagnosticToken:diagnosticToken.isEmpty?null:diagnosticToken,
        noFillBuilder:(_,__)=>const SizedBox.shrink(),
        errorBuilder:(_,__)=>const SizedBox.shrink()),
    ]),
  ));
}
روش سروری اختیاری همین فرمت

فقط برای اپ دارای سرور: نشانی پراکسی و تابع نشست فعلی اپ را تکمیل کنید. تابع خالی نمونه، نشست واقعی ایجاد نمی‌کند. کلید خصوصی روی سرور می‌ماند.

import 'package:flutter/material.dart';
import 'package:didnex_ads/didnex_ads.dart';

// Match your approved media package/bundle identifier. No app backend or JWT.
const diagnosticToken='';
// Replace this function with the current authenticated session from YOUR app.
Future<String> appSessionToken() async => '';
void main() => runApp(DidnexAds(
  proxyUrl: Uri.parse('https://YOUR-BACKEND.example/ads'),
  sessionToken: appSessionToken,
  adOrigin: Uri.parse('https://didnex.com'),
  child: const MaterialApp(home: AdsPage()),
));
class AdsPage extends StatefulWidget {
  const AdsPage({super.key});
  @override State<AdsPage> createState() => _AdsPageState();
}
class _AdsPageState extends State<AdsPage> {
  String? _inlineUnit;
  bool _busy=false;
  String _message='یک فرمت انتخاب کنید';
  static const units=<String,String>{'rewarded_interstitial':'UNT_REWARDED_INTERSTITIAL'};
  Future<void> _show(String format) async {
    if(_busy)return;final unit=units[format]!;setState(()=>_busy=true);
    try {
      if(format.startsWith('rewarded')) {
        final receipt=await DidnexAds.showRewarded(context,unitId:unit,diagnosticToken:diagnosticToken.isEmpty?null:diagnosticToken);
        if(mounted)setState(()=>_message=receipt==null?'جایزه‌ای ثبت نشد':'جایزه در کیف نصب دیدنکس ثبت شد');
      } else if(['interstitial','app_open','playable'].contains(format)) {
        final shown=await DidnexAds.showInterstitial(context,unitId:unit,diagnosticToken:diagnosticToken.isEmpty?null:diagnosticToken);
        if(mounted)setState(()=>_message=shown?'نمایش پایان یافت':'فعلاً تبلیغی موجود نیست');
      } else {setState(()=>_inlineUnit=unit);}
    } catch(_) {if(mounted)setState(()=>_message='تبلیغ در دسترس نیست؛ اپ ادامه دارد');}
    finally {if(mounted)setState(()=>_busy=false);}
  }
  @override Widget build(BuildContext context)=>Directionality(textDirection:TextDirection.rtl,child:Scaffold(
    appBar:AppBar(title:const Text('اتصال دیدنکس')),
    body:ListView(padding:const EdgeInsets.all(16),children:[
      Text(_message),
      Wrap(spacing:8,children:units.keys.map((f)=>OutlinedButton(onPressed:_busy?null:()=>_show(f),child:Text(f))).toList()),
      if(_inlineUnit!=null)DidnexAdSlot(key:ValueKey(_inlineUnit),unitId:_inlineUnit!,diagnosticToken:diagnosticToken.isEmpty?null:diagnosticToken,
        noFillBuilder:(_,__)=>const SizedBox.shrink(),
        errorBuilder:(_,__)=>const SizedBox.shrink()),
    ]),
  ));
}
آغاز اپ · تمام‌صفحه
import 'package:flutter/material.dart';
import 'package:didnex_ads/didnex_ads.dart';

// Match your approved media package/bundle identifier. No app backend or JWT.
const diagnosticToken='';
void main() => runApp(DidnexAds.direct(
  packageName: 'com.company.app',
  adOrigin: Uri.parse('https://didnex.com'),
  child: const MaterialApp(home: AdsPage()),
));
class AdsPage extends StatefulWidget {
  const AdsPage({super.key});
  @override State<AdsPage> createState() => _AdsPageState();
}
class _AdsPageState extends State<AdsPage> {
  String? _inlineUnit;
  bool _busy=false;
  String _message='یک فرمت انتخاب کنید';
  static const units=<String,String>{'app_open':'UNT_APP_OPEN'};
  Future<void> _show(String format) async {
    if(_busy)return;final unit=units[format]!;setState(()=>_busy=true);
    try {
      if(format.startsWith('rewarded')) {
        final receipt=await DidnexAds.showRewarded(context,unitId:unit,diagnosticToken:diagnosticToken.isEmpty?null:diagnosticToken);
        if(mounted)setState(()=>_message=receipt==null?'جایزه‌ای ثبت نشد':'جایزه در کیف نصب دیدنکس ثبت شد');
      } else if(['interstitial','app_open','playable'].contains(format)) {
        final shown=await DidnexAds.showInterstitial(context,unitId:unit,diagnosticToken:diagnosticToken.isEmpty?null:diagnosticToken);
        if(mounted)setState(()=>_message=shown?'نمایش پایان یافت':'فعلاً تبلیغی موجود نیست');
      } else {setState(()=>_inlineUnit=unit);}
    } catch(_) {if(mounted)setState(()=>_message='تبلیغ در دسترس نیست؛ اپ ادامه دارد');}
    finally {if(mounted)setState(()=>_busy=false);}
  }
  @override Widget build(BuildContext context)=>Directionality(textDirection:TextDirection.rtl,child:Scaffold(
    appBar:AppBar(title:const Text('اتصال دیدنکس')),
    body:ListView(padding:const EdgeInsets.all(16),children:[
      Text(_message),
      Wrap(spacing:8,children:units.keys.map((f)=>OutlinedButton(onPressed:_busy?null:()=>_show(f),child:Text(f))).toList()),
      if(_inlineUnit!=null)DidnexAdSlot(key:ValueKey(_inlineUnit),unitId:_inlineUnit!,diagnosticToken:diagnosticToken.isEmpty?null:diagnosticToken,
        noFillBuilder:(_,__)=>const SizedBox.shrink(),
        errorBuilder:(_,__)=>const SizedBox.shrink()),
    ]),
  ));
}
روش سروری اختیاری همین فرمت

فقط برای اپ دارای سرور: نشانی پراکسی و تابع نشست فعلی اپ را تکمیل کنید. تابع خالی نمونه، نشست واقعی ایجاد نمی‌کند. کلید خصوصی روی سرور می‌ماند.

import 'package:flutter/material.dart';
import 'package:didnex_ads/didnex_ads.dart';

// Match your approved media package/bundle identifier. No app backend or JWT.
const diagnosticToken='';
// Replace this function with the current authenticated session from YOUR app.
Future<String> appSessionToken() async => '';
void main() => runApp(DidnexAds(
  proxyUrl: Uri.parse('https://YOUR-BACKEND.example/ads'),
  sessionToken: appSessionToken,
  adOrigin: Uri.parse('https://didnex.com'),
  child: const MaterialApp(home: AdsPage()),
));
class AdsPage extends StatefulWidget {
  const AdsPage({super.key});
  @override State<AdsPage> createState() => _AdsPageState();
}
class _AdsPageState extends State<AdsPage> {
  String? _inlineUnit;
  bool _busy=false;
  String _message='یک فرمت انتخاب کنید';
  static const units=<String,String>{'app_open':'UNT_APP_OPEN'};
  Future<void> _show(String format) async {
    if(_busy)return;final unit=units[format]!;setState(()=>_busy=true);
    try {
      if(format.startsWith('rewarded')) {
        final receipt=await DidnexAds.showRewarded(context,unitId:unit,diagnosticToken:diagnosticToken.isEmpty?null:diagnosticToken);
        if(mounted)setState(()=>_message=receipt==null?'جایزه‌ای ثبت نشد':'جایزه در کیف نصب دیدنکس ثبت شد');
      } else if(['interstitial','app_open','playable'].contains(format)) {
        final shown=await DidnexAds.showInterstitial(context,unitId:unit,diagnosticToken:diagnosticToken.isEmpty?null:diagnosticToken);
        if(mounted)setState(()=>_message=shown?'نمایش پایان یافت':'فعلاً تبلیغی موجود نیست');
      } else {setState(()=>_inlineUnit=unit);}
    } catch(_) {if(mounted)setState(()=>_message='تبلیغ در دسترس نیست؛ اپ ادامه دارد');}
    finally {if(mounted)setState(()=>_busy=false);}
  }
  @override Widget build(BuildContext context)=>Directionality(textDirection:TextDirection.rtl,child:Scaffold(
    appBar:AppBar(title:const Text('اتصال دیدنکس')),
    body:ListView(padding:const EdgeInsets.all(16),children:[
      Text(_message),
      Wrap(spacing:8,children:units.keys.map((f)=>OutlinedButton(onPressed:_busy?null:()=>_show(f),child:Text(f))).toList()),
      if(_inlineUnit!=null)DidnexAdSlot(key:ValueKey(_inlineUnit),unitId:_inlineUnit!,diagnosticToken:diagnosticToken.isEmpty?null:diagnosticToken,
        noFillBuilder:(_,__)=>const SizedBox.shrink(),
        errorBuilder:(_,__)=>const SizedBox.shrink()),
    ]),
  ));
}
بازی تعاملی · تمام‌صفحه
import 'package:flutter/material.dart';
import 'package:didnex_ads/didnex_ads.dart';

// Match your approved media package/bundle identifier. No app backend or JWT.
const diagnosticToken='';
void main() => runApp(DidnexAds.direct(
  packageName: 'com.company.app',
  adOrigin: Uri.parse('https://didnex.com'),
  child: const MaterialApp(home: AdsPage()),
));
class AdsPage extends StatefulWidget {
  const AdsPage({super.key});
  @override State<AdsPage> createState() => _AdsPageState();
}
class _AdsPageState extends State<AdsPage> {
  String? _inlineUnit;
  bool _busy=false;
  String _message='یک فرمت انتخاب کنید';
  static const units=<String,String>{'playable':'UNT_PLAYABLE'};
  Future<void> _show(String format) async {
    if(_busy)return;final unit=units[format]!;setState(()=>_busy=true);
    try {
      if(format.startsWith('rewarded')) {
        final receipt=await DidnexAds.showRewarded(context,unitId:unit,diagnosticToken:diagnosticToken.isEmpty?null:diagnosticToken);
        if(mounted)setState(()=>_message=receipt==null?'جایزه‌ای ثبت نشد':'جایزه در کیف نصب دیدنکس ثبت شد');
      } else if(['interstitial','app_open','playable'].contains(format)) {
        final shown=await DidnexAds.showInterstitial(context,unitId:unit,diagnosticToken:diagnosticToken.isEmpty?null:diagnosticToken);
        if(mounted)setState(()=>_message=shown?'نمایش پایان یافت':'فعلاً تبلیغی موجود نیست');
      } else {setState(()=>_inlineUnit=unit);}
    } catch(_) {if(mounted)setState(()=>_message='تبلیغ در دسترس نیست؛ اپ ادامه دارد');}
    finally {if(mounted)setState(()=>_busy=false);}
  }
  @override Widget build(BuildContext context)=>Directionality(textDirection:TextDirection.rtl,child:Scaffold(
    appBar:AppBar(title:const Text('اتصال دیدنکس')),
    body:ListView(padding:const EdgeInsets.all(16),children:[
      Text(_message),
      Wrap(spacing:8,children:units.keys.map((f)=>OutlinedButton(onPressed:_busy?null:()=>_show(f),child:Text(f))).toList()),
      if(_inlineUnit!=null)DidnexAdSlot(key:ValueKey(_inlineUnit),unitId:_inlineUnit!,diagnosticToken:diagnosticToken.isEmpty?null:diagnosticToken,
        noFillBuilder:(_,__)=>const SizedBox.shrink(),
        errorBuilder:(_,__)=>const SizedBox.shrink()),
    ]),
  ));
}
روش سروری اختیاری همین فرمت

فقط برای اپ دارای سرور: نشانی پراکسی و تابع نشست فعلی اپ را تکمیل کنید. تابع خالی نمونه، نشست واقعی ایجاد نمی‌کند. کلید خصوصی روی سرور می‌ماند.

import 'package:flutter/material.dart';
import 'package:didnex_ads/didnex_ads.dart';

// Match your approved media package/bundle identifier. No app backend or JWT.
const diagnosticToken='';
// Replace this function with the current authenticated session from YOUR app.
Future<String> appSessionToken() async => '';
void main() => runApp(DidnexAds(
  proxyUrl: Uri.parse('https://YOUR-BACKEND.example/ads'),
  sessionToken: appSessionToken,
  adOrigin: Uri.parse('https://didnex.com'),
  child: const MaterialApp(home: AdsPage()),
));
class AdsPage extends StatefulWidget {
  const AdsPage({super.key});
  @override State<AdsPage> createState() => _AdsPageState();
}
class _AdsPageState extends State<AdsPage> {
  String? _inlineUnit;
  bool _busy=false;
  String _message='یک فرمت انتخاب کنید';
  static const units=<String,String>{'playable':'UNT_PLAYABLE'};
  Future<void> _show(String format) async {
    if(_busy)return;final unit=units[format]!;setState(()=>_busy=true);
    try {
      if(format.startsWith('rewarded')) {
        final receipt=await DidnexAds.showRewarded(context,unitId:unit,diagnosticToken:diagnosticToken.isEmpty?null:diagnosticToken);
        if(mounted)setState(()=>_message=receipt==null?'جایزه‌ای ثبت نشد':'جایزه در کیف نصب دیدنکس ثبت شد');
      } else if(['interstitial','app_open','playable'].contains(format)) {
        final shown=await DidnexAds.showInterstitial(context,unitId:unit,diagnosticToken:diagnosticToken.isEmpty?null:diagnosticToken);
        if(mounted)setState(()=>_message=shown?'نمایش پایان یافت':'فعلاً تبلیغی موجود نیست');
      } else {setState(()=>_inlineUnit=unit);}
    } catch(_) {if(mounted)setState(()=>_message='تبلیغ در دسترس نیست؛ اپ ادامه دارد');}
    finally {if(mounted)setState(()=>_busy=false);}
  }
  @override Widget build(BuildContext context)=>Directionality(textDirection:TextDirection.rtl,child:Scaffold(
    appBar:AppBar(title:const Text('اتصال دیدنکس')),
    body:ListView(padding:const EdgeInsets.all(16),children:[
      Text(_message),
      Wrap(spacing:8,children:units.keys.map((f)=>OutlinedButton(onPressed:_busy?null:()=>_show(f),child:Text(f))).toList()),
      if(_inlineUnit!=null)DidnexAdSlot(key:ValueKey(_inlineUnit),unitId:_inlineUnit!,diagnosticToken:diagnosticToken.isEmpty?null:diagnosticToken,
        noFillBuilder:(_,__)=>const SizedBox.shrink(),
        errorBuilder:(_,__)=>const SizedBox.shrink()),
    ]),
  ));
}
صوتی · درون صفحه
import 'package:flutter/material.dart';
import 'package:didnex_ads/didnex_ads.dart';

// Match your approved media package/bundle identifier. No app backend or JWT.
const diagnosticToken='';
void main() => runApp(DidnexAds.direct(
  packageName: 'com.company.app',
  adOrigin: Uri.parse('https://didnex.com'),
  child: const MaterialApp(home: AdsPage()),
));
class AdsPage extends StatefulWidget {
  const AdsPage({super.key});
  @override State<AdsPage> createState() => _AdsPageState();
}
class _AdsPageState extends State<AdsPage> {
  String? _inlineUnit;
  bool _busy=false;
  String _message='یک فرمت انتخاب کنید';
  static const units=<String,String>{'audio':'UNT_AUDIO'};
  Future<void> _show(String format) async {
    if(_busy)return;final unit=units[format]!;setState(()=>_busy=true);
    try {
      if(format.startsWith('rewarded')) {
        final receipt=await DidnexAds.showRewarded(context,unitId:unit,diagnosticToken:diagnosticToken.isEmpty?null:diagnosticToken);
        if(mounted)setState(()=>_message=receipt==null?'جایزه‌ای ثبت نشد':'جایزه در کیف نصب دیدنکس ثبت شد');
      } else if(['interstitial','app_open','playable'].contains(format)) {
        final shown=await DidnexAds.showInterstitial(context,unitId:unit,diagnosticToken:diagnosticToken.isEmpty?null:diagnosticToken);
        if(mounted)setState(()=>_message=shown?'نمایش پایان یافت':'فعلاً تبلیغی موجود نیست');
      } else {setState(()=>_inlineUnit=unit);}
    } catch(_) {if(mounted)setState(()=>_message='تبلیغ در دسترس نیست؛ اپ ادامه دارد');}
    finally {if(mounted)setState(()=>_busy=false);}
  }
  @override Widget build(BuildContext context)=>Directionality(textDirection:TextDirection.rtl,child:Scaffold(
    appBar:AppBar(title:const Text('اتصال دیدنکس')),
    body:ListView(padding:const EdgeInsets.all(16),children:[
      Text(_message),
      Wrap(spacing:8,children:units.keys.map((f)=>OutlinedButton(onPressed:_busy?null:()=>_show(f),child:Text(f))).toList()),
      if(_inlineUnit!=null)DidnexAdSlot(key:ValueKey(_inlineUnit),unitId:_inlineUnit!,diagnosticToken:diagnosticToken.isEmpty?null:diagnosticToken,
        noFillBuilder:(_,__)=>const SizedBox.shrink(),
        errorBuilder:(_,__)=>const SizedBox.shrink()),
    ]),
  ));
}
روش سروری اختیاری همین فرمت

فقط برای اپ دارای سرور: نشانی پراکسی و تابع نشست فعلی اپ را تکمیل کنید. تابع خالی نمونه، نشست واقعی ایجاد نمی‌کند. کلید خصوصی روی سرور می‌ماند.

import 'package:flutter/material.dart';
import 'package:didnex_ads/didnex_ads.dart';

// Match your approved media package/bundle identifier. No app backend or JWT.
const diagnosticToken='';
// Replace this function with the current authenticated session from YOUR app.
Future<String> appSessionToken() async => '';
void main() => runApp(DidnexAds(
  proxyUrl: Uri.parse('https://YOUR-BACKEND.example/ads'),
  sessionToken: appSessionToken,
  adOrigin: Uri.parse('https://didnex.com'),
  child: const MaterialApp(home: AdsPage()),
));
class AdsPage extends StatefulWidget {
  const AdsPage({super.key});
  @override State<AdsPage> createState() => _AdsPageState();
}
class _AdsPageState extends State<AdsPage> {
  String? _inlineUnit;
  bool _busy=false;
  String _message='یک فرمت انتخاب کنید';
  static const units=<String,String>{'audio':'UNT_AUDIO'};
  Future<void> _show(String format) async {
    if(_busy)return;final unit=units[format]!;setState(()=>_busy=true);
    try {
      if(format.startsWith('rewarded')) {
        final receipt=await DidnexAds.showRewarded(context,unitId:unit,diagnosticToken:diagnosticToken.isEmpty?null:diagnosticToken);
        if(mounted)setState(()=>_message=receipt==null?'جایزه‌ای ثبت نشد':'جایزه در کیف نصب دیدنکس ثبت شد');
      } else if(['interstitial','app_open','playable'].contains(format)) {
        final shown=await DidnexAds.showInterstitial(context,unitId:unit,diagnosticToken:diagnosticToken.isEmpty?null:diagnosticToken);
        if(mounted)setState(()=>_message=shown?'نمایش پایان یافت':'فعلاً تبلیغی موجود نیست');
      } else {setState(()=>_inlineUnit=unit);}
    } catch(_) {if(mounted)setState(()=>_message='تبلیغ در دسترس نیست؛ اپ ادامه دارد');}
    finally {if(mounted)setState(()=>_busy=false);}
  }
  @override Widget build(BuildContext context)=>Directionality(textDirection:TextDirection.rtl,child:Scaffold(
    appBar:AppBar(title:const Text('اتصال دیدنکس')),
    body:ListView(padding:const EdgeInsets.all(16),children:[
      Text(_message),
      Wrap(spacing:8,children:units.keys.map((f)=>OutlinedButton(onPressed:_busy?null:()=>_show(f),child:Text(f))).toList()),
      if(_inlineUnit!=null)DidnexAdSlot(key:ValueKey(_inlineUnit),unitId:_inlineUnit!,diagnosticToken:diagnosticToken.isEmpty?null:diagnosticToken,
        noFillBuilder:(_,__)=>const SizedBox.shrink(),
        errorBuilder:(_,__)=>const SizedBox.shrink()),
    ]),
  ));
}
کاروسلی · درون صفحه
import 'package:flutter/material.dart';
import 'package:didnex_ads/didnex_ads.dart';

// Match your approved media package/bundle identifier. No app backend or JWT.
const diagnosticToken='';
void main() => runApp(DidnexAds.direct(
  packageName: 'com.company.app',
  adOrigin: Uri.parse('https://didnex.com'),
  child: const MaterialApp(home: AdsPage()),
));
class AdsPage extends StatefulWidget {
  const AdsPage({super.key});
  @override State<AdsPage> createState() => _AdsPageState();
}
class _AdsPageState extends State<AdsPage> {
  String? _inlineUnit;
  bool _busy=false;
  String _message='یک فرمت انتخاب کنید';
  static const units=<String,String>{'carousel':'UNT_CAROUSEL'};
  Future<void> _show(String format) async {
    if(_busy)return;final unit=units[format]!;setState(()=>_busy=true);
    try {
      if(format.startsWith('rewarded')) {
        final receipt=await DidnexAds.showRewarded(context,unitId:unit,diagnosticToken:diagnosticToken.isEmpty?null:diagnosticToken);
        if(mounted)setState(()=>_message=receipt==null?'جایزه‌ای ثبت نشد':'جایزه در کیف نصب دیدنکس ثبت شد');
      } else if(['interstitial','app_open','playable'].contains(format)) {
        final shown=await DidnexAds.showInterstitial(context,unitId:unit,diagnosticToken:diagnosticToken.isEmpty?null:diagnosticToken);
        if(mounted)setState(()=>_message=shown?'نمایش پایان یافت':'فعلاً تبلیغی موجود نیست');
      } else {setState(()=>_inlineUnit=unit);}
    } catch(_) {if(mounted)setState(()=>_message='تبلیغ در دسترس نیست؛ اپ ادامه دارد');}
    finally {if(mounted)setState(()=>_busy=false);}
  }
  @override Widget build(BuildContext context)=>Directionality(textDirection:TextDirection.rtl,child:Scaffold(
    appBar:AppBar(title:const Text('اتصال دیدنکس')),
    body:ListView(padding:const EdgeInsets.all(16),children:[
      Text(_message),
      Wrap(spacing:8,children:units.keys.map((f)=>OutlinedButton(onPressed:_busy?null:()=>_show(f),child:Text(f))).toList()),
      if(_inlineUnit!=null)DidnexAdSlot(key:ValueKey(_inlineUnit),unitId:_inlineUnit!,diagnosticToken:diagnosticToken.isEmpty?null:diagnosticToken,
        noFillBuilder:(_,__)=>const SizedBox.shrink(),
        errorBuilder:(_,__)=>const SizedBox.shrink()),
    ]),
  ));
}
روش سروری اختیاری همین فرمت

فقط برای اپ دارای سرور: نشانی پراکسی و تابع نشست فعلی اپ را تکمیل کنید. تابع خالی نمونه، نشست واقعی ایجاد نمی‌کند. کلید خصوصی روی سرور می‌ماند.

import 'package:flutter/material.dart';
import 'package:didnex_ads/didnex_ads.dart';

// Match your approved media package/bundle identifier. No app backend or JWT.
const diagnosticToken='';
// Replace this function with the current authenticated session from YOUR app.
Future<String> appSessionToken() async => '';
void main() => runApp(DidnexAds(
  proxyUrl: Uri.parse('https://YOUR-BACKEND.example/ads'),
  sessionToken: appSessionToken,
  adOrigin: Uri.parse('https://didnex.com'),
  child: const MaterialApp(home: AdsPage()),
));
class AdsPage extends StatefulWidget {
  const AdsPage({super.key});
  @override State<AdsPage> createState() => _AdsPageState();
}
class _AdsPageState extends State<AdsPage> {
  String? _inlineUnit;
  bool _busy=false;
  String _message='یک فرمت انتخاب کنید';
  static const units=<String,String>{'carousel':'UNT_CAROUSEL'};
  Future<void> _show(String format) async {
    if(_busy)return;final unit=units[format]!;setState(()=>_busy=true);
    try {
      if(format.startsWith('rewarded')) {
        final receipt=await DidnexAds.showRewarded(context,unitId:unit,diagnosticToken:diagnosticToken.isEmpty?null:diagnosticToken);
        if(mounted)setState(()=>_message=receipt==null?'جایزه‌ای ثبت نشد':'جایزه در کیف نصب دیدنکس ثبت شد');
      } else if(['interstitial','app_open','playable'].contains(format)) {
        final shown=await DidnexAds.showInterstitial(context,unitId:unit,diagnosticToken:diagnosticToken.isEmpty?null:diagnosticToken);
        if(mounted)setState(()=>_message=shown?'نمایش پایان یافت':'فعلاً تبلیغی موجود نیست');
      } else {setState(()=>_inlineUnit=unit);}
    } catch(_) {if(mounted)setState(()=>_message='تبلیغ در دسترس نیست؛ اپ ادامه دارد');}
    finally {if(mounted)setState(()=>_busy=false);}
  }
  @override Widget build(BuildContext context)=>Directionality(textDirection:TextDirection.rtl,child:Scaffold(
    appBar:AppBar(title:const Text('اتصال دیدنکس')),
    body:ListView(padding:const EdgeInsets.all(16),children:[
      Text(_message),
      Wrap(spacing:8,children:units.keys.map((f)=>OutlinedButton(onPressed:_busy?null:()=>_show(f),child:Text(f))).toList()),
      if(_inlineUnit!=null)DidnexAdSlot(key:ValueKey(_inlineUnit),unitId:_inlineUnit!,diagnosticToken:diagnosticToken.isEmpty?null:diagnosticToken,
        noFillBuilder:(_,__)=>const SizedBox.shrink(),
        errorBuilder:(_,__)=>const SizedBox.shrink()),
    ]),
  ));
}
نظرسنجی · درون صفحه
import 'package:flutter/material.dart';
import 'package:didnex_ads/didnex_ads.dart';

// Match your approved media package/bundle identifier. No app backend or JWT.
const diagnosticToken='';
void main() => runApp(DidnexAds.direct(
  packageName: 'com.company.app',
  adOrigin: Uri.parse('https://didnex.com'),
  child: const MaterialApp(home: AdsPage()),
));
class AdsPage extends StatefulWidget {
  const AdsPage({super.key});
  @override State<AdsPage> createState() => _AdsPageState();
}
class _AdsPageState extends State<AdsPage> {
  String? _inlineUnit;
  bool _busy=false;
  String _message='یک فرمت انتخاب کنید';
  static const units=<String,String>{'poll':'UNT_POLL'};
  Future<void> _show(String format) async {
    if(_busy)return;final unit=units[format]!;setState(()=>_busy=true);
    try {
      if(format.startsWith('rewarded')) {
        final receipt=await DidnexAds.showRewarded(context,unitId:unit,diagnosticToken:diagnosticToken.isEmpty?null:diagnosticToken);
        if(mounted)setState(()=>_message=receipt==null?'جایزه‌ای ثبت نشد':'جایزه در کیف نصب دیدنکس ثبت شد');
      } else if(['interstitial','app_open','playable'].contains(format)) {
        final shown=await DidnexAds.showInterstitial(context,unitId:unit,diagnosticToken:diagnosticToken.isEmpty?null:diagnosticToken);
        if(mounted)setState(()=>_message=shown?'نمایش پایان یافت':'فعلاً تبلیغی موجود نیست');
      } else {setState(()=>_inlineUnit=unit);}
    } catch(_) {if(mounted)setState(()=>_message='تبلیغ در دسترس نیست؛ اپ ادامه دارد');}
    finally {if(mounted)setState(()=>_busy=false);}
  }
  @override Widget build(BuildContext context)=>Directionality(textDirection:TextDirection.rtl,child:Scaffold(
    appBar:AppBar(title:const Text('اتصال دیدنکس')),
    body:ListView(padding:const EdgeInsets.all(16),children:[
      Text(_message),
      Wrap(spacing:8,children:units.keys.map((f)=>OutlinedButton(onPressed:_busy?null:()=>_show(f),child:Text(f))).toList()),
      if(_inlineUnit!=null)DidnexAdSlot(key:ValueKey(_inlineUnit),unitId:_inlineUnit!,diagnosticToken:diagnosticToken.isEmpty?null:diagnosticToken,
        noFillBuilder:(_,__)=>const SizedBox.shrink(),
        errorBuilder:(_,__)=>const SizedBox.shrink()),
    ]),
  ));
}
روش سروری اختیاری همین فرمت

فقط برای اپ دارای سرور: نشانی پراکسی و تابع نشست فعلی اپ را تکمیل کنید. تابع خالی نمونه، نشست واقعی ایجاد نمی‌کند. کلید خصوصی روی سرور می‌ماند.

import 'package:flutter/material.dart';
import 'package:didnex_ads/didnex_ads.dart';

// Match your approved media package/bundle identifier. No app backend or JWT.
const diagnosticToken='';
// Replace this function with the current authenticated session from YOUR app.
Future<String> appSessionToken() async => '';
void main() => runApp(DidnexAds(
  proxyUrl: Uri.parse('https://YOUR-BACKEND.example/ads'),
  sessionToken: appSessionToken,
  adOrigin: Uri.parse('https://didnex.com'),
  child: const MaterialApp(home: AdsPage()),
));
class AdsPage extends StatefulWidget {
  const AdsPage({super.key});
  @override State<AdsPage> createState() => _AdsPageState();
}
class _AdsPageState extends State<AdsPage> {
  String? _inlineUnit;
  bool _busy=false;
  String _message='یک فرمت انتخاب کنید';
  static const units=<String,String>{'poll':'UNT_POLL'};
  Future<void> _show(String format) async {
    if(_busy)return;final unit=units[format]!;setState(()=>_busy=true);
    try {
      if(format.startsWith('rewarded')) {
        final receipt=await DidnexAds.showRewarded(context,unitId:unit,diagnosticToken:diagnosticToken.isEmpty?null:diagnosticToken);
        if(mounted)setState(()=>_message=receipt==null?'جایزه‌ای ثبت نشد':'جایزه در کیف نصب دیدنکس ثبت شد');
      } else if(['interstitial','app_open','playable'].contains(format)) {
        final shown=await DidnexAds.showInterstitial(context,unitId:unit,diagnosticToken:diagnosticToken.isEmpty?null:diagnosticToken);
        if(mounted)setState(()=>_message=shown?'نمایش پایان یافت':'فعلاً تبلیغی موجود نیست');
      } else {setState(()=>_inlineUnit=unit);}
    } catch(_) {if(mounted)setState(()=>_message='تبلیغ در دسترس نیست؛ اپ ادامه دارد');}
    finally {if(mounted)setState(()=>_busy=false);}
  }
  @override Widget build(BuildContext context)=>Directionality(textDirection:TextDirection.rtl,child:Scaffold(
    appBar:AppBar(title:const Text('اتصال دیدنکس')),
    body:ListView(padding:const EdgeInsets.all(16),children:[
      Text(_message),
      Wrap(spacing:8,children:units.keys.map((f)=>OutlinedButton(onPressed:_busy?null:()=>_show(f),child:Text(f))).toList()),
      if(_inlineUnit!=null)DidnexAdSlot(key:ValueKey(_inlineUnit),unitId:_inlineUnit!,diagnosticToken:diagnosticToken.isEmpty?null:diagnosticToken,
        noFillBuilder:(_,__)=>const SizedBox.shrink(),
        errorBuilder:(_,__)=>const SizedBox.shrink()),
    ]),
  ));
}

۴. مثال کامل با مدیریت خطا

این مثال عیناً از فایل sdk/flutter/didnex_ads/example/lib/quick_start.dart داخل بسته ساخته می‌شود. نام package نمونه، شناسه‌های UNT_ و ظرف نمایش را با اپ خود هماهنگ کنید. برای بنر و تمام‌صفحه از نمونه جدا استفاده کنید.

نمایش مثال کامل Flutter
import 'package:flutter/material.dart';
import 'package:didnex_ads/didnex_ads.dart';

// Match your approved media package/bundle identifier. No app backend or JWT.
void main() => runApp(DidnexAds.direct(
  packageName: 'com.company.app',
  adOrigin: Uri.parse('https://didnex.com'),
  child: const MaterialApp(home: AdsPage()),
));
class AdsPage extends StatefulWidget {
  const AdsPage({super.key});
  @override State<AdsPage> createState() => _AdsPageState();
}
class _AdsPageState extends State<AdsPage> {
  String? _inlineUnit;
  bool _busy=false;
  String _message='یک فرمت انتخاب کنید';
  static const units=<String,String>{
    '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',
  };
  Future<void> _show(String format) async {
    if(_busy)return;final unit=units[format]!;setState(()=>_busy=true);
    try {
      if(format.startsWith('rewarded')) {
        final receipt=await DidnexAds.showRewarded(context,unitId:unit);
        if(mounted)setState(()=>_message=receipt==null?'جایزه‌ای ثبت نشد':'جایزه در کیف نصب دیدنکس ثبت شد');
      } else if(['interstitial','app_open','playable'].contains(format)) {
        final shown=await DidnexAds.showInterstitial(context,unitId:unit);
        if(mounted)setState(()=>_message=shown?'نمایش پایان یافت':'فعلاً تبلیغی موجود نیست');
      } else {setState(()=>_inlineUnit=unit);}
    } catch(_) {if(mounted)setState(()=>_message='تبلیغ در دسترس نیست؛ اپ ادامه دارد');}
    finally {if(mounted)setState(()=>_busy=false);}
  }
  @override Widget build(BuildContext context)=>Directionality(textDirection:TextDirection.rtl,child:Scaffold(
    appBar:AppBar(title:const Text('اتصال دیدنکس')),
    body:ListView(padding:const EdgeInsets.all(16),children:[
      Text(_message),
      Wrap(spacing:8,children:units.keys.map((f)=>OutlinedButton(onPressed:_busy?null:()=>_show(f),child:Text(f))).toList()),
      if(_inlineUnit!=null)DidnexAdSlot(key:ValueKey(_inlineUnit),unitId:_inlineUnit!,
        noFillBuilder:(_,__)=>const SizedBox.shrink(),
        errorBuilder:(_,__)=>const SizedBox.shrink()),
    ]),
  ));
}

۵. نبود تبلیغ، قطعی شبکه و چرخه عمر

آغاز اپ را منتظر تبلیغ نگه ندارید. noFill وضعیت عادی است؛ فضای تبلیغ را مخفی کنید و اپ ادامه یابد. درخواست پشت سر هم و retry بی‌وقفه انجام ندهید. هنگام حذف صفحه، handle یا view را مطابق مثال ببندید. در تب پنهان یا پوشش سفارشی، active را false کنید. نمایش خودکار روی هر resume مناسب نیست.

۶. جایزه، کیف و پوش

جایزه فقط پس از انتخاب کاربر، تماشای کامل و رسید verified و applied سرور معتبر است. callback یعنی جایزه پیش‌تر در کیف نصب دیدنکس ثبت شده؛ دوباره به موجودی اضافه نکنید. برای مصرف، externalId را پیش از ارسال ذخیره و در retry ثابت نگه دارید. کیف نصب، حساب قابل بازیابی چنددستگاهی نیست.

نمونه کیف و مصرف یکتاپوش Flutter، Manifest و نمونه پس‌زمینهحساب اپ روی سرور اختیاری

Inbox بدون Firebase و در اپ فعال کار می‌کند. پوش پس‌زمینه به رضایت کاربر، مجوز سیستم‌عامل و اتصال FCM/APNs/Web Push نیاز دارد؛ فعال‌کردن تبلیغ به این تنظیم‌ها وابسته نیست. همه ۱۳ فرمت اتصال مستقیم دارند؛ React Native و Godot فعلاً مستقیم هستند و شش SDK اصلی پراکسی اختیاری هم دارند.

۷. آزمون و رفع خطا

diagnosticToken پنل، با فایل واقعی متناسب با فرمت (تصویر، ویدیو، صوت یا بازی) تست بدون هزینه و جایزه می‌دهد؛ تأیید تحویل مالی نیست. برای تبلیغ واقعی، کمپین سازگار با بودجه و رسانه فعال لازم است. در خطای package، پسوند flavor خروجی را با رسانه تطبیق دهید؛ در وب Origin دقیق و HTTPS را بررسی کنید. خطای سرویس را با موفقیت مالی یا جایزه محلی جایگزین نکنید.

آزمون‌های قرارداد سرور، وب و بسته‌بندی در مخزن اجرا می‌شوند. وضعیت کامپایل منطبق با هش منبع در SDK Lab و releases.json ثبت می‌شود؛ اجرای دستگاه فقط با رسید مستقل device_playback قابل تأیید است.

پیش از انتشار اپ، ساخت 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 امضاشده و شناسه مخاطب ثبت نمی‌شود. خروجی کپی را خودتان برای پشتیبانی می‌فرستید.

// BuildContext و DidnexAdClient واقعی همان اپ:
DidnexInspector.show(context);

خروجی‌های ویدیوی تطبیقی به‌طور خودکار از mediaSources انتخاب می‌شوند. حالت کم‌مصرف/شبکه موبایل کیفیت پایین، Wi-Fi یا شبکه سریع کیفیت بالاتر و شبکه نامشخص کیفیت میانی می‌گیرد. اجازه ACCESS_NETWORK_STATE در Android برای تشخیص شبکه لازم است؛ در نبود دسترسی، انتخاب محافظه‌کارانه انجام می‌شود. رویداد بارگذاری، نمایش قابل مشاهده، پیشرفت ویدیو و تأیید جایزه همچنان از مسیر امضاشده می‌گذرند؛ عیب‌یاب درآمد ایجاد نمی‌کند.

ابزارهای ساخت موبایل و دستگاه واقعی در محیط انتشار این سورس در دسترس نبودند. آزمون قرارداد سرور، رمزنگاری، تولید رسانه و پنل انجام شده؛ پیش از انتشار اپ، ساخت SDK در Flutter/Xcode/Android Studio/Unity/B4A و آزمون دستگاه را انجام دهید. بسته‌ها روی pub.dev یا فروشگاه‌ها منتشر نشده‌اند.