این راهنما به شما نشان میدهد که چگونه از GMA Next-Gen SDK برای بار کردن و نمایش دادن آگهیهای LY Ads Network بااستفاده از میانجیگری AdMob استفاده کنید، و ادغامهای آبشاری را پوشش میدهد. این راهنما نحوه افزودن LY Ads Network به پیکربندی میانجیگری واحد آگهی و نحوه ادغام کیت توسعه نرمافزار و آداپتور LY Ads Network در برنامه Android را پوشش میدهد.
یکپارچهسازیها و قالبهای آگهی پشتیبانیشده
آداپتور میانجی برای LY Ads Network قابلیتهای زیر را دارد:
| یکپارچهسازی | |
|---|---|
| پیشنهاد قیمت | |
| آبشار | |
| قالبها | |
| برنما | |
| بینابینی | |
| پاداش | |
| بومی | |
پیشنیازها
قبلاز ادامه دادن، موارد زیر را تأیید کنید:
Android API سطح ۲۴ یا بالاتر.
[برای پیشنهاد قیمت]: برای ادغام کردن همه قالبهای آگهی پشتیبانیشده در پیشنهاد قیمت، از آداپتور LY Ads Network نسخه 2.9.20241129.0 یا جدیدتر (جدیدترین نسخه توصیه میشود) استفاده کنید.
جدیدترین نسخه GMA Next-Gen SDK.
مرحله ۱: راهاندازی پیکربندیها در میانای کاربر شبکه آگهیهای LY
ثبتنام کنید و به سیستم حساب LY Ads Network خود وارد شوید.
افزودن برنامه جدید
به برگه برنامه بروید و روی دکمه ثبتنام جدید کلیک کنید.
فرم را تکمیل کنید و روی ثبتنام کلیک کنید.
شناسه برنامه را یادداشت کنید.
ایجاد جایگاه آگهی
در برگه برنامه، برنامه خود را انتخاب کنید تا جزئیات آن را مشاهده کنید. در بخش جایگاه، روی افزودن کلیک کنید.
برای دریافت جزئیات درباره جایگاه، فرم را تکمیل کنید. برای نوع پیشنهاد قیمت، استاندارد را برای پیکربندی این جایگاه برای میانجیگری آبشاری، یا پیشنهاد قیمت Google SDK را برای پیکربندی این جایگاه برای «پیشنهاد قیمت» انتخاب کنید. پساز تکمیل فرم، روی ایجاد کلیک کنید.
شناسه جایگاه را یادداشت کنید.
پساز ایجاد اولین جایگاه، روی بازبینی در صفحه جزئیات برنامهتان کلیک کنید تا تأییدیه را از LY Ads Network دریافت کنید. ممکن است این کار مدتی طول بکشد. اگر سؤالی دارید، با نماینده LY Ads Network تماس بگیرید.
ایجاد کلید میانای برنامهسازی کاربردی گزارشدهی
به برگه مدیریت کلیدهای میانای برنامهسازی کاربردی گزارشدهی بروید و روی دکمه ایجاد کلید میانای برنامهسازی کاربردی کلیک کنید.
فرم را پر کنید و روی ذخیره کلیک کنید.
شناسه کلید میانای برنامهسازی کاربردی و رمز کلید میانای برنامهسازی کاربردی را یادداشت کنید.
فایل app-ads.txt خود را بهروز کنید
Authorized Sellers for Apps app-ads.txt ابتکاری از IAB Tech Lab است که کمک میکند مطمئن شوید
فهرست آگهیهای برنامهتان فقط ازطریق کانالهایی که بهعنوان مجاز شناسایی کردهاید فروخته میشود. برای جلوگیری از
افت قابلتوجه در درآمد آگهی، باید فایل app-ads.txt را پیادهسازی کنید.
اگر قبلاً این کار را نکردهاید،
فایل app-ads.txt را برای برنامهتان راهاندازی کنید.
برای پیادهسازی app-ads.txt برای LY Ads Network، به
درباره app-ads.txt مراجعه کنید.
مرحله ۲: راهاندازی کردن تقاضای LY Ads Network در واسط کاربر AdMob
پیکربندی تنظیمات میانجیگری برای واحد آگهی شما
باید LY Ads Network را به پیکربندی میانجیگری واحد آگهیتان اضافه کنید.
ابتدا، به سیستم حساب AdMob خود وارد شوید. سپس به برگه میانجیگری بروید. اگر گروه میانجیگری موجودی دارید که میخواهید آن را اصلاح کنید، روی نام آن گروه میانجیگری کلیک کنید تا آن را ویرایش کنید، و به افزودن شبکه آگهیهای LY بهعنوان منبع آگهی بروید.
برای ایجاد گروه میانجیگری جدید، ایجاد گروه میانجیگری را انتخاب کنید.

قالب آگهی و پلاتفرم را وارد کنید، سپس روی ادامه کلیک کنید.

نامی برای گروه میانجیگریتان انتخاب کنید و مکانهای هدف را انتخاب کنید. سپس، وضعیت گروه میانجیگری را روی فعال تنظیم کنید و سپس روی افزودن واحدهای آگهی کلیک کنید.

این گروه میانجی را با یک یا چند واحد آگهی AdMob موجودتان مرتبط کنید. سپس روی تمام کلیک کنید.

اکنون باید کارت واحدهای آگهی را ببینید که با واحدهای آگهی انتخابی شما پر شده است:

افزودن LY Ads Network بهعنوان منبع آگهی
پیشنهاد قیمت
در بخش منابع آگهی، کارت پیشنهاد قیمت را پیدا کنید و افزودن منبع آگهی را انتخاب کنید. سپس شبکه آگهیهای LY را انتخاب کنید .
روی نحوه امضای قرارداد مشارکت کلیک کنید و مشارکت مناقصه با LY Ads Network را راهاندازی کنید.
روی تأیید و موافقت کلیک کنید، سپس روی ادامه کلیک کنید.
اگر ازقبل نگاشتی برای LY Ads Network دارید، میتوانید آن را انتخاب کنید. درغیراینصورت، روی افزودن نگاشت کلیک کنید.
سپس، شناسه برنامه و شناسه جایگاه را که در بخش قبلی بهدست آوردید وارد کنید. سپس روی تمام کلیک کنید.

آبشار
در زیر کارت آبشاری در بخش منابع آگهی، افزودن منبع آگهی را انتخاب کنید.
شبکه آگهیهای LY را انتخاب کنید و کلید بهینهسازی را فعال کنید. شناسه کلید میانای برنامهسازی کاربردی و رمز کلید میانای برنامهسازی کاربردی را که در بخش قبلی دریافت کردید وارد کنید تا بهینهسازی منبع آگهی برای LY Ads Network راهاندازی شود. سپس مقدار eCPM را برای LY Ads Network وارد کنید و روی ادامه کلیک کنید.

اگر ازقبل نگاشتی برای «شبکه آگهیهای LY» دارید، میتوانید آن را انتخاب کنید. درغیراینصورت، روی افزودن نگاشت کلیک کنید.

سپس، شناسه برنامه و شناسه جایگاه را که در بخش قبلی بهدست آوردید وارد کنید. سپس روی تمام کلیک کنید.

مرحله ۳: وارد کردن «کیت توسعه نرمافزار» و «آداپتور» LY Ads Network
یکپارچهسازی «استودیو Android» (توصیهشده)
در فایل gradle سطح برنامه، وابستگیهای پیادهسازی و پیکربندیهای زیر را اضافه کنید:
Kotlin
dependencies { implementation("com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:1.5.0") implementation("com.google.ads.mediation:line:3.1.1.2") } configurations.configureEach { exclude(group = "com.google.android.gms", module = "play-services-ads") exclude(group = "com.google.android.gms", module = "play-services-ads-lite") }
Groovy
dependencies { implementation 'com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:1.5.0' implementation 'com.google.ads.mediation:line:3.1.1.2' } configurations.configureEach { exclude group: 'com.google.android.gms', module: 'play-services-ads' exclude group: 'com.google.android.gms', module: 'play-services-ads-lite' }
یکپارچهسازی دستی
جدیدترین نسخه فایل
.aarکیت توسعه نرمافزار LY Ads Network را بارگیری کنید و آن را به پروژهتان اضافه کنید.به مصنوعات آداپتور LY Ads Network در مخزن Maven متعلق به Google بروید. جدیدترین نسخه را انتخاب کنید، فایل
.aarآداپتور LY Ads Network را بارگیری کنید، و آن را به پروژهتان اضافه کنید.
مرحله ۴: افزودن کد لازم
برای ادغام «شبکه آگهیهای LY» به کد دیگری نیاز نیست.
مرحله ۵: آزمایش پیادهسازی
فعال کردن آگهیهای آزمایشی
مطمئن شوید دستگاه آزمایشیتان را برای AdMob ثبت کردهاید.
آداپتور LY Ads Network حاوی یک روش کمکی برای فعال کردن حالت آزمایشی برای LY Ads Network است. باید این گزینه را قبلاز مقداردهی اولیه GMA Next-Gen SDK تنظیم کنید تا مطمئن شوید که بهدرستی به LY Ads Network SDK بازارسال میشوند.
جاوا
Kotlin
درستیسنجی آگهیهای آزمایشی
برای تأیید اینکه آگهیهای آزمایشی را از LY Ads Network دریافت میکنید، آزمایش منبع آگهی تکی را در بازرس آگهی بااستفاده از منبع(های) آگهی LY Ads Network فعال کنید.
مراحل اختیاری
پارامترهای مختص شبکه
آداپتور LY Ads Network از پارامتر درخواست دیگری پشتیبانی میکند که میتوان آن را بااستفاده از کلاس LineExtras به آداپتور ارسال کرد. این سازنده کلاس
شامل پارامترهای زیر است:
enableAdSoundbooleanبرای مشخص کردن وضعیت شروع صدای پیشفرض آگهیهای برنمایی، بینابینی، و پاداشی.
در اینجا نمونه کدی از نحوه ایجاد درخواست آگهی که این پارامترها را تنظیم میکند آورده شده است:
جاوا
Kotlin
استفاده از آگهیهای بومی
پرداز آگهی
آداپتور شبکه آگهیهای LY موارد زیر را برای
NativeAd
پر میکند:
شرح فیلدهای پیشرفته آگهیهای بومی.
| فیلد | داراییهایی که همیشه توسط آداپتور «شبکه آگهیهای LY» اضافه میشوند |
|---|---|
| Headline | |
| تصویر | |
| بدن | |
| نماد برنامه | ۱ |
| دعوت به اقدام | |
| ردهبندی با ستاره | |
| فروشگاه | |
| قیمت |
۱ برای آگهیهای بومی، کیت توسعه نرمافزار شبکه آگهیهای LY دارایی نماد برنامه را ارائه نمیدهد. درعوض، آداپتور LY Ads Network نماد برنامه را با تصویر شفاف پر میکند.
کدهای خطا
If the adapter fails to receive an ad from LY Ads Network, you can check the
underlying error from the ad response using
ResponseInfo.getAdSourceResponses()
under the following classes:
com.line.ads
com.google.ads.mediation.line.LineMediationAdapter
در اینجا کدها و پیامهای همراهی که توسط آداپتور شبکه آگهیهای LY هنگام بارگیری نشدن آگهی ارسال میشوند، آورده شده است:
| کد خطا | دامنه | استدلال |
|---|---|---|
| ۱-۱۰ | com.five_corp.ad | کیت توسعه نرمافزار LY Ads Network خطایی مختص کیت توسعه نرمافزار برگرداند. برای جزئیات بیشتر، اسناد LY Ads Network را ببینید. |
| ۱۰۱ | com.google.ads.mediation.line | شناسه برنامه وجود ندارد یا نامعتبر است. |
| 102 | com.google.ads.mediation.line | شناسه جایگاه موجود نیست یا نامعتبر است. |
| 103 | com.google.ads.mediation.line | اندازه آگهی درخواستی با اندازه آگهی برنمای پشتیبانیشده در «شبکه آگهیهای LY» مطابقت ندارد. |
| 104 | com.google.ads.mediation.line | بهدلیل نبودن بافت فعالیت، آگهی تمامصفحه یا پاداشی بار نشد. |
| ۱۰۵ | com.google.ads.mediation.line | کیت توسعه نرمافزار LY Ads Network نتوانست آگهی بینابینی یا پاداشی را نشان دهد. |
| 106 | com.google.ads.mediation.line | آگهی بومی بهدلیل نبود داراییها بار نشد. |
| 107 | com.google.ads.mediation.line | کیت توسعه نرمافزار FiveAd بارکننده آگهی تهی برگرداند. |
گزارش تغییرات آداپتور میانجی LINE Android
نسخه ۳.۱.۱.۲
- وابستگی Kotlin آداپتور را به ۱.۹.۰ (حداقل نسخه Kotlin پشتیبانیشده توسط کیت توسعه نرمافزار GMA NextGen) سنجاق کنید.
ساخته و آزمایششده با:
- کیت توسعه نرمافزار Google Mobile Ads نسخه ۲۵.۴.۰.
- نسخه ۱.۴.۰ کیت توسعه نرمافزار نسل بعدی آگهیهای Google Mobile.
- FiveAd SDK نسخه ۳.۱.۱.۱.
نسخه ۳.۱.۱.۱
- Maps
AgeRestrictedTreatmentto Line's ChildDirectedTreatment API.
ساخته و آزمایششده با:
- کیت توسعه نرمافزار Google Mobile Ads نسخه ۲۵.۴.۰.
- نسخه ۱.۲.۱ کیت توسعه نرمافزار نسل بعدی آگهیهای Google Mobile.
- FiveAd SDK نسخه ۳.۱.۱.۱.
نسخه ۳.۱.۱.۰
- سازگاری با FiveAd SDK نسخه ۳.۱.۱.۰ تأیید شد.
ساخته و آزمایششده با:
- کیت توسعه نرمافزار آگهی تلفن همراه Google نسخه ۲۵.۲.۰.
- نسخه ۱.۲.۱ کیت توسعه نرمافزار نسل بعدی آگهیهای Google Mobile.
- FiveAd SDK نسخه ۳.۱.۱.۰.
نسخه ۳.۱.۰.۰
- ویژگیای برای ساختن آداپتور با وابستگی کیت توسعه نرمافزار GMA Next-Gen اضافه شد.
- سازگاری با FiveAd SDK نسخه 3.1.0.0 تأیید شد.
ساخته و آزمایششده با:
- کیت توسعه نرمافزار آگهی تلفن همراه Google نسخه ۲۵.۱.۰.
- کیت توسعه نرمافزار نسل بعدی آگهیهای Google Mobile نسخه 0.25.0-beta01.
- FiveAd SDK نسخه ۳.۱.۰.۰.
نسخه ۳.۰.۱.۲
ساخته و آزمایششده با:
- کیت توسعه نرمافزار آگهی تلفن همراه Google نسخه ۲۵.۱.۰.
- FiveAd SDK نسخه ۳.۰.۱.۲.
نسخه ۳.۰.۱.۱
- هنگام استفاده از «کیت توسعه نرمافزار تبلیغات تلفن همراه Google» نسخه ۲۴.۴.۰ یا بالاتر، ظهورهای آگهی بومی اکنون توسط FiveAd SDK بازنویسی میشود.
ساخته و آزمایششده با:
- کیت توسعه نرمافزار آگهی تلفن همراه Google نسخه ۲۴.۹.۰.
- FiveAd SDK نسخه ۳.۰.۱.۱.
نسخه ۳.۰.۱.۰
- پشتیبانی از بازارسال پارامتر tagForUnderAgeOfConsent کیت توسعه نرمافزار Google Mobile Ads به کیت توسعه نرمافزار FiveAd اضافه شد.
- سازگاری با FiveAd SDK نسخه ۳.۰.۱.۰ تأیید شد.
ساخته و آزمایششده با:
- کیت توسعه نرمافزار آگهی تلفن همراه Google نسخه ۲۴.۹.۰.
- FiveAd SDK نسخه ۳.۰.۱.۰.
نسخه ۳.۰.۰.۰
- سازگاری با FiveAd SDK نسخه 3.0.0.0 تأیید شد.
ساخته و آزمایششده با:
- کیت توسعه نرمافزار آگهی تلفن همراه Google نسخه ۲۴.۹.۰.
- FiveAd SDK نسخه ۳.۰.۰.۰.
نسخه 2.9.20251028.0
- سازگاری با FiveAd SDK نسخه 2.9.20251028 تأیید شد.
ساخته و آزمایششده با:
- کیت توسعه نرمافزار آگهی تلفن همراه Google نسخه ۲۴.۷.۰.
- FiveAd SDK نسخه 2.9.20251028.0
نسخه 2.9.20250924.1
- ارجاعهای سطح کلاس به Context برداشته شد. میتواند به کاهش مشکلات نشت حافظه کمک کند.
ساخته و آزمایششده با:
- کیت توسعه نرمافزار آگهی تلفن همراه Google نسخه ۲۴.۷.۰.
- FiveAd SDK نسخه 2.9.20250924.1.
نسخه 2.9.20250924.0
- سازگاری با FiveAd SDK نسخه 2.9.20250924 تأیید شد.
ساخته و آزمایششده با:
- کیت توسعه نرمافزار آگهی تلفن همراه Google نسخه ۲۴.۶.۰.
- FiveAd SDK نسخه 2.9.20250924.0
نسخه 2.9.20250718.0
- سازگاری با FiveAd SDK نسخه 2.9.20250718 تأیید شد.
ساخته و آزمایششده با:
- کیت توسعه نرمافزار آگهی تلفن همراه Google نسخه ۲۴.۳.۰.
- FiveAd SDK نسخه 2.9.20250718.0.
نسخه 2.9.20250519.0
- سازگاری با FiveAd SDK نسخه 2.9.20250519 تأیید شد.
ساخته و آزمایششده با:
- کیت توسعه نرمافزار آگهی تلفن همراه Google نسخه ۲۴.۳.۰.
- FiveAd SDK نسخه 2.9.20250519.0.
نسخه 2.9.20250317.1
- ابعاد بار کردن برنما را برای آگهیهای پیشنهاد قیمت با FiveAd API جدید اصلاح میکند
ساخته و آزمایششده با:
- کیت توسعه نرمافزار آگهی تلفن همراه Google نسخه ۲۴.۱.۰.
- FiveAd SDK نسخه 2.9.20250317.0
نسخه 2.9.20250317.0
- سازگاری با FiveAd SDK نسخه 2.9.20250317 تأیید شد.
ساخته و آزمایششده با:
- کیت توسعه نرمافزار آگهی تلفن همراه Google نسخه ۲۴.۱.۰.
- FiveAd SDK نسخه 2.9.20250317.0
نسخه 2.9.20250110.1
- حداقل سطح میانای برنامهسازی کاربردی Android موردنیاز به ۲۳ بهروز شد.
- حداقل نسخه موردنیاز «کیت توسعه نرمافزار تبلیغات تلفن همراه Google» به ۲۴.۰.۰ بهروزرسانی شد.
ساخته و آزمایششده با:
- کیت توسعه نرمافزار آگهی تلفن همراه Google نسخه ۲۴.۰.۰.
- FiveAd SDK نسخه 2.9.20250110.0
نسخه 2.9.20250110.0
- کلاس منسوخشده
UnifiedNativeAdMapperبهنفعNativeAdMapperبرداشته شد - فرایند جمعآوری سیگنالهای ثابت.
- فرایند مقداردهی اولیه برای قالبهای آگهی پاداشدار و بینابینی آبشاری اصلاح شد.
- سازگاری با FiveAd SDK نسخه 2.9.20250110 تأیید شد.
ساخته و آزمایششده با:
- کیت توسعه نرمافزار Google Mobile Ads نسخه ۲۳.۶.۰.
- FiveAd SDK نسخه 2.9.20250110.0
نسخه 2.9.20241129.0
- پشتیبانی از پیشنهاد قیمت برای قالبهای آگهی برنما، بینابینی، پاداشدار، و بومی اضافه شد.
- سازگاری با FiveAd SDK نسخه 2.9.20241129 تأیید شد.
ساخته و آزمایششده با:
- کیت توسعه نرمافزار Google Mobile Ads نسخه ۲۳.۵.۰.
- FiveAd SDK نسخه 2.9.20241129.0
نسخه 2.8.20240827.0
- سازگاری با FiveAd SDK نسخه 2.8.20240827 تأیید شد.
ساخته و آزمایششده با:
- کیت توسعه نرمافزار آگهی تلفن همراه Google نسخه ۲۳.۳.۰.
- FiveAd SDK نسخه 2.8.20240827.0
نسخه 2.8.20240808.0
- سازگاری با FiveAd SDK نسخه 2.8.20240808 تأیید شد.
ساخته و آزمایششده با:
- کیت توسعه نرمافزار آگهی تلفن همراه Google نسخه ۲۳.۲.۰.
- FiveAd SDK نسخه 2.8.20240808.0
نسخه 2.8.20240722.0
- سازگاری با FiveAd SDK نسخه 2.8.20240722 تأیید شد.
ساخته و آزمایششده با:
- کیت توسعه نرمافزار آگهی تلفن همراه Google نسخه ۲۳.۲.۰.
- FiveAd SDK نسخه 2.8.20240722.0
نسخه 2.7.20240515.0
- سازگاری با FiveAd SDK نسخه 2.7.20240515 تأیید شد.
ساخته و آزمایششده با:
- کیت توسعه نرمافزار آگهی تلفن همراه Google نسخه ۲۳.۱.۰.
- FiveAd SDK نسخه 2.7.20240515.0
نسخه 2.7.20240214.1
- حداقل نسخه لازم «کیت توسعه نرمافزار تبلیغات تلفن همراه Google» به ۲۳.۰.۰ بهروزرسانی شد.
- سازگاری با FiveAd SDK نسخه 2.7.20240214 تأیید شد.
ساخته و آزمایششده با:
- کیت توسعه نرمافزار آگهی تلفن همراه Google نسخه ۲۳.۰.۰.
- FiveAd SDK نسخه 2.7.20240214.0.
نسخه 2.7.20240214.0
- سازگاری با FiveAd SDK نسخه 2.7.20240214 تأیید شد.
ساخته و آزمایششده با:
- کیت توسعه نرمافزار آگهی تلفن همراه Google نسخه ۲۲.۶.۰.
- FiveAd SDK نسخه 2.7.20240214.0.
نسخه 2.7.20240126.0
- سازگاری با FiveAd SDK نسخه 2.7.20240126 تأیید شد.
ساخته و آزمایششده با:
- کیت توسعه نرمافزار آگهی تلفن همراه Google نسخه ۲۲.۶.۰.
- FiveAd SDK نسخه 2.7.20240126.0.
نسخه 2.7.20240112.0
-
FiveAdViewEventListenerمنسوخشده بهنفعFiveAdCustomLayoutEventListener،FiveAdVideoRewardEventListener،FiveAdInterstitialEventListener، وFiveAdNativeEventListenerبرداشته شد. - سازگاری با FiveAd SDK نسخه 2.7.20240112 تأیید شد.
- حداقل نسخه موردنیاز «کیت توسعه نرمافزار تبلیغات تلفن همراه Google» به ۲۲.۶.۰ بهروزرسانی شد.
ساخته و آزمایششده با:
- کیت توسعه نرمافزار آگهی تلفن همراه Google نسخه ۲۲.۶.۰.
- FiveAd SDK نسخه 2.7.20240112.
نسخه 2.6.20230607.1
- کلاس
LineExtrasبرای ناشران اضافه شد تا تنظیمات پیشفرض صدا را برای قالبهای آگهی پاداشدار، بینابینی، و برنما تعریف کنند. - حداقل نسخه موردنیاز «کیت توسعه نرمافزار تبلیغات تلفن همراه Google» به ۲۲.۴.۰ بهروزرسانی شد.
ساخته و آزمایششده با:
- کیت توسعه نرمافزار آگهی تلفن همراه Google نسخه ۲۲.۴.۰.
- FiveAd SDK نسخه ۲.۶.۲۰۲۳۰۶۰۷.
نسخه 2.6.20230607.0
- نسخهٔ پخش اولیه.
- پشتیبانی از قالبهای آگهی برنمایی، بینابینی، پاداشدار، و بومی را اضافه میکند.
- سازگاری با FiveAd SDK نسخه ۲.۶.۲۰۲۳۰۶۰۷ تأیید شد.
ساخته و آزمایششده با:
- کیت توسعه نرمافزار آگهی تلفن همراه Google نسخه ۲۲.۱.۰.
- FiveAd SDK نسخه ۲.۶.۲۰۲۳۰۶۰۷.