این راهنما نحوه استفاده از Google Mobile Ads Flutter Plugin را برای بار کردن و نمایش آگهی‌ها از «شبکه آگهی‌های LY» بااستفاده از واسطه‌گری نشان می‌دهد و ادغام‌های آبشاری را پوشش می‌دهد. این راهنما نحوه افزودن LY Ads Network به پیکربندی میانجیگری واحد آگهی و نحوه ادغام کردن کیت توسعه نرم‌افزار و آداپتور LY Ads Network در برنامه Flutter را پوشش می‌دهد.
یکپارچه‌سازی‌ها و قالب‌های آگهی پشتیبانی‌شده
آداپتور میانجی Ad Manager برای LY Ads Network قابلیت‌های زیر را دارد:
| یکپارچه‌سازی | |
|---|---|
| پیشنهاد قیمت | |
| آبشار | |
| قالب‌ها | |
| برنما | |
| بینابینی | |
| پاداش | |
| بومی | |
پیش‌نیازها
قبل‌از ادامه دادن، موارد زیر را درستی‌سنجی کنید:
- جدیدترین نسخه Google Mobile Ads Flutter Plugin.
- نسخه چارچوب Flutter ۳.۷.۰ یا بالاتر.
- برای استقرار در Android
- Android API سطح ۲۴ یا بالاتر.
- برای استقرار در iOS
- هدف استقرار iOS نسخه ۱۳.۰ یا جدیدتر.
- پروژه Flutter کاری که با Google Mobile Ads Flutter Plugin پیکربندی شده است. برای جزئیات بیشتر، راه‌اندازی Google Mobile Ads Flutter Plugin را ببینید.
مرحله ۱: پیکربندی‌ها را در «میانای کاربر شبکه تبلیغات LY» راه‌اندازی کنید
ثبت‌نام کنید و به سیستم حساب LY Ads Network خود وارد شوید.
افزودن برنامه جدید
به برگه برنامه بروید و روی دکمه ثبت‌نام جدید کلیک کنید.
فرم را تکمیل کنید و روی ثبت‌نام کلیک کنید.
شناسه برنامه را یادداشت کنید.
Android
iOS
ایجاد جایگاه آگهی
در برگه برنامه، برنامه خود را انتخاب کنید تا جزئیات آن را مشاهده کنید. در بخش جایگاه، روی افزودن کلیک کنید.
برای دریافت جزئیات درباره جایگاه، فرم را تکمیل کنید. برای نوع پیشنهاد قیمت، استاندارد را برای پیکربندی این جای آگهی برای میانجیگری آبشاری، یا پیشنهاد قیمت کیت توسعه نرم‌افزار Google را برای پیکربندی این جای آگهی برای «پیشنهاد قیمت» انتخاب کنید. پس‌از تکمیل فرم، روی ایجاد کلیک کنید.
شناسه جایگاه را یادداشت کنید.
پس‌از ایجاد اولین جایگاه، روی بازبینی در صفحه جزئیات برنامه‌تان کلیک کنید تا تأییدیه را از 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 برای Ad Manager ایجاد کنید.
برای پیاده‌سازی app-ads.txt برای LY Ads Network، به
درباره app-ads.txt مراجعه کنید.
مرحله ۲: راه‌اندازی تقاضای «شبکه آگهی‌های LY» در «واسط کاربر Ad Manager»
پیکربندی تنظیمات میانجیگری برای واحد آگهی شما
Android
برای دستورالعمل‌ها، مرحله ۲ را در راهنمای Android ببینید.
iOS
برای دستورالعمل‌ها، مرحله ۲ را در راهنمای iOS ببینید.
مرحله ۳: وارد کردن آداپتور و کیت توسعه نرم‌افزار LY Ads Network
یکپارچه‌سازی ازطریق pub.dev
وابستگی زیر را با جدیدترین نسخه‌های
LY Ads Network SDK و آداپتور در
فایل pubspec.yaml بسته‌تان اضافه کنید:
dependencies:
gma_mediation_line: ^2.2.1
ادغام دستی
جدیدترین نسخه افزایه میانجیگری Google Mobile Ads را برای
LY Ads Network بارگیری کنید،
فایل بارگیری‌شده را استخراج کنید، و پوشه افزایه استخراج‌شده
(و محتوای آن) را به پروژه Flutter خود اضافه کنید. سپس، با افزودن وابستگی زیر، به افزایه در فایل
pubspec.yaml خود ارجاع دهید:
dependencies:
gma_mediation_line:
path: path/to/local/package
مرحله ۴: افزودن کد لازم
Android
برای ادغام «شبکه آگهی‌های LY» به کد دیگری نیاز نیست.
iOS
یکپارچه‌سازی SKAdNetwork
سندگان LY Ads Network را دنبال کنید
تا شناسه‌های SKAdNetwork را به فایل Info.plist پروژه‌تان اضافه کنید.
مرحله ۵: آزمایش پیاده‌سازی
فعال کردن آگهی‌های آزمایشی
مطمئن شوید دستگاه آزمایشی خود را برای Ad Manager ثبت کنید.
درستی‌سنجی آگهی‌های آزمایشی
برای تأیید اینکه آگهی‌های آزمایشی را از LY Ads Network دریافت می‌کنید، آزمایش منبع آگهی تکی را در بازرس آگهی بااستفاده از منبع(های) آگهی LY Ads Network فعال کنید.
مراحل اختیاری
پارامترهای مختص شبکه
افزونه میانجیگری LY Ads Network Flutter از پارامتر درخواست اضافی زیر پشتیبانی می‌کند که می‌تواند ازطریق کلاس LineMediationExtras به آداپتور ارسال شود:
-
enableAdSound: وضعیت شروع صدای پیش‌فرض آگهی‌های برنمایشی، بینابینی، و پاداش‌دار را مشخص می‌کند.
در اینجا نمونه کدی از نحوه ایجاد درخواست آگهی که این پارامترها را تنظیم می‌کند آورده شده است:
LineMediationExtras lineExtras = LineMediationExtras(enableAdSound: true)
AdRequest request = AdRequest(
keywords: <String>['foo', 'bar'],
contentUrl: 'http://foo.com/bar.html',
mediationExtras: [lineExtras],
);
کدهای خطا
اگر آداپتور نتواند آگهی‌ای از LY Ads Network دریافت کند،
ناشران می‌توانند خطای زمینه‌ای را از پاسخ آگهی بااستفاده از
ResponseInfo تحت کلاس‌های زیر بررسی کنند:
Android
com.line.ads
com.google.ads.mediation.line.LineMediationAdapter
iOS
GADMediationAdapterLine
در اینجا کدها و پیام‌های همراهی که توسط میانای «شبکه آگهی LY» هنگام بار نشدن آگهی ارسال می‌شود آمده است:
Android
| کد خطا | دامنه | استدلال |
|---|---|---|
| ۱-۱۰ | 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» نتوانست آگهی بینابینی یا آگهی پاداش‌دار را نمایش دهد. |
| 106 | com.google.ads.mediation.line | آگهی بومی به‌دلیل نبود دارایی‌ها بار نشد. |
| 107 | com.google.ads.mediation.line | «کیت توسعه نرم‌افزار FiveAd» بارکننده آگهی تهی برگرداند. |
iOS
| کد خطا | دامنه | استدلال |
|---|---|---|
| ۱-۱۰ | ارسال‌شده توسط کیت توسعه نرم‌افزار «شبکه آگهی LY» | کیت توسعه نرم‌افزار LY Ads Network خطایی مختص کیت توسعه نرم‌افزار برگرداند. برای جزئیات بیشتر، اسناد «شبکه تبلیغات LY Ads» را ببینید. |
| ۱۰۱ | com.google.ads.mediation.line | پارامترهای سرور نامعتبر است (برای نمونه، «شناسه برنامه» یا «شناسه جایگاه» وجود ندارد). |
| 102 | com.google.ads.mediation.line | اندازه آگهی درخواستی با اندازه آگهی برنمای پشتیبانی‌شده در «شبکه آگهی‌های LY» مطابقت ندارد. |
| 103 | com.google.ads.mediation.line | دارایی تصویر نماد اطلاعات در آگهی بومی بار نشد. |
| 104 | com.google.ads.mediation.line | سیگنال‌های قیمت پیشنهادی جمع‌آوری نشد. |
| ۱۰۵ | com.google.ads.mediation.line | بارکننده آگهی «کیت توسعه نرم‌افزار آگهی‌های LINE» مقداردهی اولیه نشد. |
گزارش تغییرات آداپتور میانجی Line Flutter
نسخه ۲.۲.۲ (درحال انجام)
- اکنون به حداقل iOS نسخه ۱۵.۰ نیاز دارد.
نسخه ۲.۲.۱
- از نسخه ۳.۱.۱.۲ آداپتور Android Line پشتیبانی می‌کند.
- از آداپتور Line iOS نسخه ۳.۱.۱.۰ پشتیبانی می‌کند.
- ساخته و آزمایش‌شده با نسخه ۹.۱.۰ «افزایه Google Mobile Ads Flutter»
نسخه ۲.۲.۰
- از Line Android adapter نسخه ۳.۱.۱.۱ پشتیبانی می‌کند.
- از نسخه ۳.۱.۰.۰ آداپتور Line iOS پشتیبانی می‌کند.
- ساخته‌شده و آزمایش‌شده با «افزونه Google Mobile Ads Flutter» نسخه ۹.۱.۰
نسخه ۲.۱.۳
- برای پشتیبانی از نسخه ۹.۱.۰ «افزایه Google Mobile Ads Flutter» به‌روزرسانی شد.
- پشتیبانی از Swift Package Manager اضافه شد.
- از نسخه ۳.۱.۱.۱ آداپتور Line Android پشتیبانی می‌کند.
- از نسخه ۳.۰.۱.۲ آداپتور Line iOS پشتیبانی می‌کند.
- ساخته‌شده و آزمایش‌شده با نسخه ۹.۱.۰ «افزونه Flutter تبلیغات تلفن همراه Google»
نسخه ۲.۱.۲
- از Line Android adapter نسخه ۳.۱.۱.۱ پشتیبانی می‌کند.
- از نسخه ۳.۰.۱.۲ آداپتور Line iOS پشتیبانی می‌کند.
- ساخته و آزمایش‌شده با «افزونه Google Mobile Ads Flutter» نسخه ۹.۰.۰
نسخه ۲.۱.۱
- از Line Android adapter نسخه ۳.۱.۱.۰ پشتیبانی می‌کند.
- از نسخه ۳.۰.۱.۲ آداپتور Line iOS پشتیبانی می‌کند.
- ساخته و آزمایش‌شده با نسخه ۹.۰.۰ افزایه Google Mobile Ads Flutter
نسخه ۲.۱.۰
- حداقل نسخه Flutter به ۳.۳۸.۱ به‌روز شد
- به‌روزرسانی‌شده برای پشتیبانی از نسخه ۸.۰.۰ «افزونه Flutter تبلیغات تلفن همراه Google»
- از آداپتور Line Android نسخه ۳.۱.۰.۰ پشتیبانی می‌کند.
- از آداپتور Line iOS نسخه ۳.۰.۱.۰ پشتیبانی می‌کند.
- بااستفاده از «افزونه Flutter تبلیغات تلفن همراه Google» نسخه ۸.۰.۰ ساخته و آزمایش شده است
نسخه ۲.۰.۰
- حداقل نسخه Flutter به ۳.۳۵.۱ به‌روز شد
- به‌روزرسانی‌شده برای پشتیبانی از نسخه ۷.۰.۰ «افزونه Flutter تبلیغات تلفن همراه Google»
- از نسخه ۳.۰.۱.۰ آداپتور Android در Line پشتیبانی می‌کند.
- از نسخه ۳.۰.۰.۰ آداپتور Line iOS پشتیبانی می‌کند.
- ساخته و آزمایش‌شده با نسخه ۷.۰.۰ افزایه Google Mobile Ads Flutter
نسخه ۱.۰.۶
- از نسخه ۲.۹.۲۰۲۵۱۰۲۸.۰ آداپتور Android در Line پشتیبانی می‌کند.
- از آداپتور Line iOS نسخه ۲.۹.۲۰۲۵۱۱۱۹.۰ پشتیبانی می‌کند.
- ساخته‌شده و آزمایش‌شده با «افزونه Google Mobile Ads Flutter» نسخه ۶.۰.۰
نسخه ۱.۰.۵
- از آداپتور Line Android نسخه ۲.۹.۲۰۲۵۰۹۲۴.۱ پشتیبانی می‌کند.
- از آداپتور Line iOS نسخه ۲.۹.۲۰۲۵۰۹۳۰.۰ پشتیبانی می‌کند.
- بااستفاده از «افزونه Google Mobile Ads Flutter» نسخه ۶.۰.۰ ساخته و آزمایش شده است
نسخه ۱.۰.۴
- از نسخه ۲.۹.۲۰۲۵۰۷۱۸.۰ آداپتور Android در Line پشتیبانی می‌کند.
- از آداپتور Line iOS نسخه ۲.۹.۲۰۲۵۰۵۱۲.۰ پشتیبانی می‌کند.
- ساخته و آزمایش‌شده با افزایه Google Mobile Ads Flutter نسخه ۶.۰.۰
نسخه ۱.۰.۳
- از Line Android adapter نسخه 2.9.20250519.0 پشتیبانی می‌کند.
- از آداپتور Line iOS نسخه ۲.۹.۲۰۲۵۰۵۱۲.۰ پشتیبانی می‌کند.
- ساخته‌شده و آزمایش‌شده با «افزونه Google Mobile Ads Flutter» نسخه ۶.۰.۰
نسخه ۱.۰.۲
- از آداپتور Line Android نسخه 2.9.20250317.1 پشتیبانی می‌کند.
- از نسخه 2.9.20241106.3 آداپتور Line iOS پشتیبانی می‌کند.
- بااستفاده از «افزونه Google Mobile Ads Flutter» نسخه ۶.۰.۰ ساخته و آزمایش شده است
نسخه ۱.۰.۱
- از آداپتور Line Android نسخه ۲.۹.۲۰۲۵۰۱۱۰.۱ پشتیبانی می‌کند.
- از آداپتور Line iOS نسخه ۲.۹.۲۰۲۴۱۱۰۶.۲ پشتیبانی می‌کند.
- بااستفاده از نسخه ۵.۳.۱ «افزونه Flutter تبلیغات تلفن همراه Google» ساخته و آزمایش شده است.
نسخه ۱.۰.۰
- نسخهٔ پخش اولیه.
- از نسخه ۲.۹.۲۰۲۵۰۱۱۰.۰ آداپتور Android در Line پشتیبانی می‌کند.
- از نسخه ۲.۹.۲۰۲۴۱۱۰۶.۱ آداپتور Line iOS پشتیبانی می‌کند.
- بااستفاده از نسخه ۵.۳.۱ «افزونه Flutter تبلیغات تلفن همراه Google» ساخته و آزمایش شده است.