بازیها
همکاری با بیش از 20 بازی پرمخاطب ایرانی
SDK overview
AdPlay Unity SDK Documentation
AdPlay یک SDK یونیتی برای درخواست و نمایش تبلیغات داخل UI بازی است. این SDK، فایلهای تبلیغ را دانلود میکند، تبلیغهای فعال را کش میکند و داده impression یا click را ارسال میکند.
Supported Unity versions
The repository was created with Unity 6000.3.8f1. Unity 6.3 or newer Unity 6.3 patch releases are recommended for this SDK build.
| Field | Use |
|---|---|
| Recommended Unity Editor | Unity 6000 or newer |
| Minimum declared in package manifest | unity: 2020 |
| Required Unity packages | com.unity.nuget.newtonsoft-json, RTLTMPro |
| دسترسی شبکه در زمان اجرا | بازی باید به https://addata.ir و دامنههای فایلهای تبلیغ دسترسی داشته باشد. |
پلتفرم جایگذاری محصول درون بازی
همکاری با بیش از 20 بازی پرمخاطب ایرانی، ساعت بازی ماهانه بیش از 75 میلیون ساعت و بازدید ماهانه بیش از 150 میلیون بازدید.
زمان بازی ماهانه
ساعت بازی ماهانه بیش از 75 میلیون ساعت
بازدید ماهانه
بازدید ماهانه بیش از 150 میلیون بازدید
Supported formats
Current ad formats
The SDK currently supports Splash, Banner, Pop-up, Pop-up Button, and interstitial sound ad formats.
SplashFull-entry ad for launch, loading, or pre-menu moments.
BannerSmall persistent placement for menus, stores, or calm screens.
Pop-upA larger template-driven ad, useful after transitions or on menu screens.
Pop-up ButtonShows only a button first. The popup opens after the player clicks.
Interstitial SoundPlays an interstitial audio ad without creating a UI template.
Requirements
Before importing the SDK
Before importing the AdPlay SDK, make sure your Unity project has the required packages and App Key.
AdPlaySDK.unitypackage
The SDK package should be imported with Assets > Import Package > Custom Package.
RTLTMPro
The SDK requires RTLTMPro for Persian and right-to-left text through RTLTextMeshPro components.
Newtonsoft Json
The SDK uses Newtonsoft Json for serializing and deserializing API data.
Package contents
Imported directories
After importing the package, the main SDK directory is added under Assets/Adplay.
| Path | Purpose |
|---|---|
| Assets/Adplay/Prefabs/AdPlayManager.prefab | Runtime manager that initializes ads, caches textures, and sends engagement batches |
| Assets/Adplay/Prefabs/AdPlayTemplate.prefab | Reusable UI template containing required image, button, and RTL text references |
| Assets/Adplay/ScriptableObjects/Adplay/AdPlayApiConfigData.asset | Stores the app key in the apiToken field |
| Assets/Adplay/ScriptableObjects/Adplay/AdPlayRequest.asset | API request asset that references AdPlayApiConfigData |
| Assets/Adplay/AdPlaySampleScene.unity | Sample scene demonstrating SDK initialization and ad requests |
AdPlayManager
Manager responsibilities
Initializes the SDKPrepares the token, network layer, and active ad cache.
Gets ads from AdPlay serverRequests active ad content for the selected format.
Downloads ad imagesFetches creative assets before rendering them in Unity UI.
Caches active adsKeeps active content available during the session.