Godot
همه فرمتها، نصب و نمونه کامل اتصال مستقیم.
سه قدم تا اولین تبلیغ Godot
- رسانه و جایگاه همان فرمت را ثبت و تأیید کنید.
- بسته همین پلتفرم را نصب کنید.
- شناسه UNT_ مثال را با شناسه جایگاه خود جایگزین کنید.
نشانی HTTPS در مثال، سرور خود دیدنکس است. در حالت مستقیم، JWT، کلید خصوصی و ورود کاربر لازم نیست. Android، iOS، Unity و B4A شناسه بسته را از خود اپ میخوانند؛ Flutter نیز در initialize جدید، شناسه بسته را محلی میخواند؛ ورود دستی در روش سازگار قدیمی ممکن است. تغییر دامنه دیدنکس فقط به تغییر همین نشانی در تنظیم اپ نیاز دارد.
۱. نصب و تنظیم اولیه
addons/didnex را کپی و addon را فعال کنید. Android: ساخت AAR با native/gradlew و نصب Android Build Template و Use Gradle Build. Web: فایل web_bridge.js باید در خروجی باشد. نمونه Main.gd همه فرمتها را دارد.
Godot4.7.2؛ Android و Web. iOS پشتیبانی نمیشود. Android: JDK17/SDK36/Gradle9.6/AGP9.4. اجرای desktop وضعیت unavailable دارد.
var ads = Didnex.new()
add_child(ads)
ads.configure("https://didnex.com")
ads.load_ad("UNT_BANNER", "banner")راهاندازی یکباره تبلیغ و پوش
نمونه کوتاه زیر فقط تنظیم اولیه است؛ callback و ظرف نمایش را در مثال کامل همین صفحه ببینید. init اجازه اعلان نمیگیرد و عضویت خودکار ندارد. یک کلاینت را برای عمر اپ نگه دارید و همان را برای تبلیغ و پوش استفاده کنید.
const PLACEMENT_ID = "PASTE_YOUR_PLACEMENT_ID_HERE"
var client = Didnex.new()
add_child(client)
if client.initialize("https://didnex.com"):
client.load_ad(PLACEMENT_ID, "banner", "", Rect2i(0,100,320,50))
var push = client.create_push(PLACEMENT_ID)
# Android / Web only. Initialization does not enroll or prompt permission.اندازه ثابت جایگاه
اندازه از 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 هم باشد. تبلیغ پایه به مجوز مکان، اعلان، حافظه یا شناسه تبلیغاتی نیاز ندارد.
<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"/><uses-permission android:name="android.permission.RECEIVE_BOOT_COMPLETED" />
<application>
<service android:name="com.didnex.ads.DidnexDirectPush$Job" android:permission="android.permission.BIND_JOB_SERVICE" android:exported="true" /><meta-data android:name="org.godotengine.plugin.v2.DidnexPlugin" android:value="com.didnex.godot.DidnexPlugin"/></application><uses-permission android:name="android.permission.POST_NOTIFICATIONS"/></manifest>
در iOS فایل PrivacyInfo.xcprivacy بسته را به منابع Target اضافه کنید؛ HTTPS به غیرفعالکردن ATS نیاز ندارد. UIBackgroundModes فقط برای پوش پسزمینه اختیاری است. در Unity دسترسی اینترنت Player Settings را روی Require قرار دهید.
بازکردن جایگاه و راهنمای قدمبهقدم اتصال — در پنل، نمونه با شناسه و بستهٔ رسانهٔ شما ساخته میشود؛ تست تا دریافت گزارش همان جلسه ادامه دارد.
۳. مثال کامل هر فرمت
هر شناسه جایگاه فقط یک فرمت دارد؛ فرمت باید با نوع رسانه و سیاستهای پنل سازگار باشد. مثال کامل همان فرمت را انتخاب کنید. تمامصفحه فقط در نقطه طبیعی تجربه کاربر نمایش داده شود. ویدیوی معمولی خودکار و بیصداست؛ صوت و جایزه با اقدام کاربر شروع میشوند.
بنر · درون صفحه
extends Control
const ORIGIN = "https://didnex.com"
const UNITS = {"banner":"UNT_BANNER"}
var ads: Didnex
func _ready() -> void:
ads = Didnex.new()
add_child(ads)
ads.failed.connect(func(code: String): $List/Status.text = code)
ads.reward.connect(func(receipt: Dictionary): $List/Status.text = "Verified grant: " + str(receipt.get("grantId")))
ads.loaded.connect(func(request_id: String): $List/Status.text = "Loaded: " + request_id)
ads.configure(ORIGIN)
for format in UNITS:
var button := Button.new()
button.text = format
button.pressed.connect(func(): ads.load_ad(UNITS[format], format, "", Rect2i(0, 500, 480, 300)))
$List.add_child(button)
بنر تطبیقی · درون صفحه
extends Control
const ORIGIN = "https://didnex.com"
const UNITS = {"adaptive_banner":"UNT_ADAPTIVE_BANNER"}
var ads: Didnex
func _ready() -> void:
ads = Didnex.new()
add_child(ads)
ads.failed.connect(func(code: String): $List/Status.text = code)
ads.reward.connect(func(receipt: Dictionary): $List/Status.text = "Verified grant: " + str(receipt.get("grantId")))
ads.loaded.connect(func(request_id: String): $List/Status.text = "Loaded: " + request_id)
ads.configure(ORIGIN)
for format in UNITS:
var button := Button.new()
button.text = format
button.pressed.connect(func(): ads.load_ad(UNITS[format], format, "", Rect2i(0, 500, 480, 300)))
$List.add_child(button)
همسان · درون صفحه
extends Control
const ORIGIN = "https://didnex.com"
const UNITS = {"native":"UNT_NATIVE"}
var ads: Didnex
func _ready() -> void:
ads = Didnex.new()
add_child(ads)
ads.failed.connect(func(code: String): $List/Status.text = code)
ads.reward.connect(func(receipt: Dictionary): $List/Status.text = "Verified grant: " + str(receipt.get("grantId")))
ads.loaded.connect(func(request_id: String): $List/Status.text = "Loaded: " + request_id)
ads.configure(ORIGIN)
for format in UNITS:
var button := Button.new()
button.text = format
button.pressed.connect(func(): ads.load_ad(UNITS[format], format, "", Rect2i(0, 500, 480, 300)))
$List.add_child(button)
ویدیوی همسان · درون صفحه
extends Control
const ORIGIN = "https://didnex.com"
const UNITS = {"native_video":"UNT_NATIVE_VIDEO"}
var ads: Didnex
func _ready() -> void:
ads = Didnex.new()
add_child(ads)
ads.failed.connect(func(code: String): $List/Status.text = code)
ads.reward.connect(func(receipt: Dictionary): $List/Status.text = "Verified grant: " + str(receipt.get("grantId")))
ads.loaded.connect(func(request_id: String): $List/Status.text = "Loaded: " + request_id)
ads.configure(ORIGIN)
for format in UNITS:
var button := Button.new()
button.text = format
button.pressed.connect(func(): ads.load_ad(UNITS[format], format, "", Rect2i(0, 500, 480, 300)))
$List.add_child(button)
ویدیوی درون محتوا · درون صفحه
extends Control
const ORIGIN = "https://didnex.com"
const UNITS = {"video":"UNT_VIDEO"}
var ads: Didnex
func _ready() -> void:
ads = Didnex.new()
add_child(ads)
ads.failed.connect(func(code: String): $List/Status.text = code)
ads.reward.connect(func(receipt: Dictionary): $List/Status.text = "Verified grant: " + str(receipt.get("grantId")))
ads.loaded.connect(func(request_id: String): $List/Status.text = "Loaded: " + request_id)
ads.configure(ORIGIN)
for format in UNITS:
var button := Button.new()
button.text = format
button.pressed.connect(func(): ads.load_ad(UNITS[format], format, "", Rect2i(0, 500, 480, 300)))
$List.add_child(button)
بینابینی · تمامصفحه
extends Control
const ORIGIN = "https://didnex.com"
const UNITS = {"interstitial":"UNT_INTERSTITIAL"}
var ads: Didnex
func _ready() -> void:
ads = Didnex.new()
add_child(ads)
ads.failed.connect(func(code: String): $List/Status.text = code)
ads.reward.connect(func(receipt: Dictionary): $List/Status.text = "Verified grant: " + str(receipt.get("grantId")))
ads.loaded.connect(func(request_id: String): $List/Status.text = "Loaded: " + request_id)
ads.configure(ORIGIN)
for format in UNITS:
var button := Button.new()
button.text = format
button.pressed.connect(func(): ads.load_ad(UNITS[format], format, "", Rect2i(0, 500, 480, 300)))
$List.add_child(button)
ویدیوی جایزهدار · جایزهدار
extends Control
const ORIGIN = "https://didnex.com"
const UNITS = {"rewarded":"UNT_REWARDED"}
var ads: Didnex
func _ready() -> void:
ads = Didnex.new()
add_child(ads)
ads.failed.connect(func(code: String): $List/Status.text = code)
ads.reward.connect(func(receipt: Dictionary): $List/Status.text = "Verified grant: " + str(receipt.get("grantId")))
ads.loaded.connect(func(request_id: String): $List/Status.text = "Loaded: " + request_id)
ads.configure(ORIGIN)
for format in UNITS:
var button := Button.new()
button.text = format
button.pressed.connect(func(): ads.load_ad(UNITS[format], format, "", Rect2i(0, 500, 480, 300)))
$List.add_child(button)
بینابینی جایزهدار · جایزهدار
extends Control
const ORIGIN = "https://didnex.com"
const UNITS = {"rewarded_interstitial":"UNT_REWARDED_INTERSTITIAL"}
var ads: Didnex
func _ready() -> void:
ads = Didnex.new()
add_child(ads)
ads.failed.connect(func(code: String): $List/Status.text = code)
ads.reward.connect(func(receipt: Dictionary): $List/Status.text = "Verified grant: " + str(receipt.get("grantId")))
ads.loaded.connect(func(request_id: String): $List/Status.text = "Loaded: " + request_id)
ads.configure(ORIGIN)
for format in UNITS:
var button := Button.new()
button.text = format
button.pressed.connect(func(): ads.load_ad(UNITS[format], format, "", Rect2i(0, 500, 480, 300)))
$List.add_child(button)
آغاز اپ · تمامصفحه
extends Control
const ORIGIN = "https://didnex.com"
const UNITS = {"app_open":"UNT_APP_OPEN"}
var ads: Didnex
func _ready() -> void:
ads = Didnex.new()
add_child(ads)
ads.failed.connect(func(code: String): $List/Status.text = code)
ads.reward.connect(func(receipt: Dictionary): $List/Status.text = "Verified grant: " + str(receipt.get("grantId")))
ads.loaded.connect(func(request_id: String): $List/Status.text = "Loaded: " + request_id)
ads.configure(ORIGIN)
for format in UNITS:
var button := Button.new()
button.text = format
button.pressed.connect(func(): ads.load_ad(UNITS[format], format, "", Rect2i(0, 500, 480, 300)))
$List.add_child(button)
بازی تعاملی · تمامصفحه
extends Control
const ORIGIN = "https://didnex.com"
const UNITS = {"playable":"UNT_PLAYABLE"}
var ads: Didnex
func _ready() -> void:
ads = Didnex.new()
add_child(ads)
ads.failed.connect(func(code: String): $List/Status.text = code)
ads.reward.connect(func(receipt: Dictionary): $List/Status.text = "Verified grant: " + str(receipt.get("grantId")))
ads.loaded.connect(func(request_id: String): $List/Status.text = "Loaded: " + request_id)
ads.configure(ORIGIN)
for format in UNITS:
var button := Button.new()
button.text = format
button.pressed.connect(func(): ads.load_ad(UNITS[format], format, "", Rect2i(0, 500, 480, 300)))
$List.add_child(button)
صوتی · درون صفحه
extends Control
const ORIGIN = "https://didnex.com"
const UNITS = {"audio":"UNT_AUDIO"}
var ads: Didnex
func _ready() -> void:
ads = Didnex.new()
add_child(ads)
ads.failed.connect(func(code: String): $List/Status.text = code)
ads.reward.connect(func(receipt: Dictionary): $List/Status.text = "Verified grant: " + str(receipt.get("grantId")))
ads.loaded.connect(func(request_id: String): $List/Status.text = "Loaded: " + request_id)
ads.configure(ORIGIN)
for format in UNITS:
var button := Button.new()
button.text = format
button.pressed.connect(func(): ads.load_ad(UNITS[format], format, "", Rect2i(0, 500, 480, 300)))
$List.add_child(button)
کاروسلی · درون صفحه
extends Control
const ORIGIN = "https://didnex.com"
const UNITS = {"carousel":"UNT_CAROUSEL"}
var ads: Didnex
func _ready() -> void:
ads = Didnex.new()
add_child(ads)
ads.failed.connect(func(code: String): $List/Status.text = code)
ads.reward.connect(func(receipt: Dictionary): $List/Status.text = "Verified grant: " + str(receipt.get("grantId")))
ads.loaded.connect(func(request_id: String): $List/Status.text = "Loaded: " + request_id)
ads.configure(ORIGIN)
for format in UNITS:
var button := Button.new()
button.text = format
button.pressed.connect(func(): ads.load_ad(UNITS[format], format, "", Rect2i(0, 500, 480, 300)))
$List.add_child(button)
نظرسنجی · درون صفحه
extends Control
const ORIGIN = "https://didnex.com"
const UNITS = {"poll":"UNT_POLL"}
var ads: Didnex
func _ready() -> void:
ads = Didnex.new()
add_child(ads)
ads.failed.connect(func(code: String): $List/Status.text = code)
ads.reward.connect(func(receipt: Dictionary): $List/Status.text = "Verified grant: " + str(receipt.get("grantId")))
ads.loaded.connect(func(request_id: String): $List/Status.text = "Loaded: " + request_id)
ads.configure(ORIGIN)
for format in UNITS:
var button := Button.new()
button.text = format
button.pressed.connect(func(): ads.load_ad(UNITS[format], format, "", Rect2i(0, 500, 480, 300)))
$List.add_child(button)
۴. مثال کامل با مدیریت خطا
این مثال عیناً از فایل sdk/godot/examples/Main.gd داخل بسته ساخته میشود. نام package نمونه، شناسههای UNT_ و ظرف نمایش را با اپ خود هماهنگ کنید. برای بنر و تمامصفحه از نمونه جدا استفاده کنید.
نمایش مثال کامل Godot
extends Control
const ORIGIN = "__DIDNEX_ORIGIN__"
const UNITS = {"banner":"__DIDNEX_UNIT_BANNER__", "adaptive_banner":"__DIDNEX_UNIT_ADAPTIVE_BANNER__", "native":"__DIDNEX_UNIT_NATIVE__", "native_video":"__DIDNEX_UNIT_NATIVE_VIDEO__", "video":"__DIDNEX_UNIT_VIDEO__", "interstitial":"__DIDNEX_UNIT_INTERSTITIAL__", "rewarded":"__DIDNEX_UNIT_REWARDED__", "rewarded_interstitial":"__DIDNEX_UNIT_REWARDED_INTERSTITIAL__", "app_open":"__DIDNEX_UNIT_APP_OPEN__", "playable":"__DIDNEX_UNIT_PLAYABLE__", "audio":"__DIDNEX_UNIT_AUDIO__", "carousel":"__DIDNEX_UNIT_CAROUSEL__", "poll":"__DIDNEX_UNIT_POLL__"}
var ads: Didnex
func _ready() -> void:
ads = Didnex.new()
add_child(ads)
ads.failed.connect(func(code: String): $List/Status.text = code)
ads.reward.connect(func(receipt: Dictionary): $List/Status.text = "Verified grant: " + str(receipt.get("grantId")))
ads.loaded.connect(func(request_id: String): $List/Status.text = "Loaded: " + request_id)
ads.configure(ORIGIN)
for format in Didnex.FORMATS:
var button := Button.new()
button.text = format
button.pressed.connect(func(): ads.load_ad(UNITS[format], format, "", Rect2i(0, 500, 480, 300)))
$List.add_child(button)
۵. نبود تبلیغ، قطعی شبکه و چرخه عمر
آغاز اپ را منتظر تبلیغ نگه ندارید. 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 یا فروشگاهها منتشر نشدهاند.