این راهنما نحوه استفاده از Google Mobile Ads Unity Plugin را برای بار کردن و نمایش آگهی‌ها از «شبکه آگهی‌های LY» بااستفاده از واسطه‌گری نشان می‌دهد و ادغام‌های آبشاری را پوشش می‌دهد. این راهنما نحوه افزودن «شبکه آگهی LY» به پیکربندی میانجی‌گری واحد آگهی و نحوه ادغام کیت توسعه نرم‌افزار «شبکه آگهی LY» و آداپتور در برنامه Unity را پوشش می‌دهد.
یکپارچه‌سازی‌ها و قالب‌های آگهی پشتیبانی‌شده
کارگزار میانجی‌گری AdMob برای «شبکه آگهی LY Ads» قابلیت‌های زیر را دارد:
| یکپارچه‌سازی | |
|---|---|
| پیشنهاد قیمت | |
| آبشار | |
| قالب‌ها | |
| برنما | |
| بینابینی | |
| پاداش | |
پیش‌نیازها
قبل‌از ادامه دادن، موارد زیر را درستی‌سنجی کنید:
- جدیدترین نسخه Google Mobile Ads Unity Plugin.
- نسخه ۴ یا بالاتر «ویرایشگر Unity».
- [برای پیشنهاد قیمت]: برای ادغام کردن همه قالب‌های آگهی پشتیبانی‌شده در پیشنهاد قیمت، از افزایه میانجی‌گری «آگهی‌های تلفن همراه Google» برای LY Ads Network نسخه 1.5.0 یا جدیدتر (جدیدترین نسخه توصیه می‌شود) استفاده کنید.
- برای استقرار در Android
- سطح میانای برنامه کاربردی Android 24 یا بالاتر.
- برای استقرار در iOS
- هدف استقرار iOS نسخه ۱۳.۰ یا بالاتر.
- پروژه Unity فعال که با Google Mobile Ads Unity Plugin پیکربندی شده باشد. برای جزئیات بیشتر، راه‌اندازی Google Mobile Ads Unity Plugin را ببینید.
- واسطه‌گری AdMob را راه‌اندازی کنید.
مرحله ۱: پیکربندی‌ها را در «میانای کاربر شبکه تبلیغات LY» راه‌اندازی کنید
در حساب «شبکه تبلیغات LY» ثبت‌نام کنید و به سیستم وارد شوید.
افزودن برنامه جدید
به برگه برنامه پیمایش کنید و روی دکمه ثبت جدید کلیک کنید.
فرم را تکمیل کنید و روی ثبت‌نام کلیک کنید.
شناسه برنامه را یادداشت کنید.
Android
iOS
ساختن جایگاه آگهی
در زبانه برنامه، برنامه خود را انتخاب کنید تا جزئیات برنامه را مشاهده کنید. در بخش جایگاه، روی افزودن کلیک کنید.
برای دریافت جزئیات مربوط به جای آگهی، فرم را تکمیل کنید. برای نوع پیشنهاد قیمت، استاندارد را برای پیکربندی این جای آگهی برای میانجی‌گری آبشاری، یا پیشنهاد قیمت کیت توسعه نرم‌افزار Google را برای پیکربندی این جای آگهی برای «پیشنهاد قیمت» انتخاب کنید. پس‌از تکمیل فرم، روی ایجاد کلیک کنید.
شناسه جای آگهی را یادداشت کنید.
پس‌از ایجاد اولین جای آگهی، روی مرور در صفحه جزئیات برنامه‌تان کلیک کنید تا از «شبکه تبلیغات LY» تأییدیه بگیرید. ممکن است این کار مدتی طول بکشد. اگر سؤالی دارید، با نماینده LY Ads Network تماس بگیرید.
ایجاد کلید میانای برنامه‌سازی کاربردی گزارش‌دهی
به زبانه مدیریت کلیدهای میانای برنامه‌سازی کاربردی گزارش‌دهی بروید و روی دکمه ایجاد کلید میانای برنامه‌سازی کاربردی کلیک کنید.
فرم را تکمیل کنید و روی ذخیره کلیک کنید.
شناسه کلید API و رمز کلید API خود را یادداشت کنید.
به‌روزرسانی app-ads.txt
«فروشندگان مجاز برای برنامه‌ها» app-ads.txt ابتکار IAB Tech Lab است که کمک می‌کند مطمئن شوید
فضای آگهی برنامه شما فقط ازطریق کانال‌هایی که به‌عنوان مجاز شناسایی کرده‌اید فروخته می‌شود. برای جلوگیری از
کاهش قابل‌توجه درآمد آگهی، باید فایل app-ads.txt را پیاده‌سازی کنید.
اگر قبلاً این کار را نکرده‌اید،
فایل app-ads.txt را برای برنامه‌تان راه‌اندازی کنید.
برای پیاده‌سازی app-ads.txt برای «شبکه آگهی LY»، به
درباره app-ads.txt مراجعه کنید.
مرحله ۲: راه‌اندازی کردن تقاضای «شبکه آگهی‌های LY» در «واسط کاربر AdMob»
پیکربندی تنظیمات واسطه‌گری برای واحد آگهی
Android
برای دستورالعمل‌ها، مرحله ۲ را در راهنمای Android ببینید.
iOS
برای دستورالعمل‌ها، مرحله ۲ را در راهنمای iOS ببینید.
مرحله ۳: وارد کردن «کیت توسعه نرم‌افزار شبکه آگهی LY» و آداپتور
OpenUPM-CLI
اگر OpenUPM-CLI نصب کرده‌اید، می‌توانید «افزایه میانجی‌گری شبکه تبلیغات LY Ads» را برای «تبلیغات تلفن همراه Google» در Unity با اجرای فرمان زیر از فهرست راهنمای ریشه پروژه خود به پروژه‌تان نصب کنید:
openupm add com.google.ads.mobile.mediation.lineOpenUPM
در ویرایشگر پروژه Unity، ویرایش > تنظیمات پروژه > مدیر بسته را انتخاب کنید تا تنظیمات مدیر بسته Unity باز شود.
در زبانه ثبت‌های محدود، OpenUPM را به‌عنوان ثبت محدود با جزئیات زیر اضافه کنید:
- نام:
OpenUPM - نشانی وب:
https://package.openupm.com - حوزه(ها):
com.google
سپس به Window (پنجره) > Package Manager (مدیر بسته) بروید تا Unity Package Manager (مدیر بسته Unity) را باز کنید و My Registries (ثبت‌های من) را از منو کرکره‌ای انتخاب کنید.
بسته میانجی‌گری خط آگهی‌های تلفن همراه Google را انتخاب کنید و روی نصب کلیک کنید.
بسته Unity
جدیدترین نسخه افزایه میانجی‌گری «تبلیغات تلفن همراه Google» را برای
«شبکه تبلیغات LY» از پیوند بارگیری در
Changelog
بارگیری کنید و
GoogleMobileAdsLineMediation.unitypackage را از فایل zip
استخراج کنید.
در ویرایشگر پروژه Unity، دارایی‌ها > وارد کردن بسته >
بسته سفارشی را انتخاب کنید و
GoogleMobileAdsLineMediation.unitypackage
فایل بارگیری‌شده را پیدا کنید. مطمئن شوید که همه فایل‌ها انتخاب شده‌اند و روی
وارد کردن کلیک کنید.
سپس دارایی‌ها > مدیر وابستگی خارجی >
حل‌کننده Android > حل اجباری را انتخاب کنید. کتابخانه «مدیر وابستگی خارجی»
عمل حل وابستگی را از ابتدا انجام می‌دهد و وابستگی‌های
اعلام‌شده را در دایرکتوری Assets/Plugins/Android برنامه
Unity شما کپی می‌کند.
مرحله ۴: افزودن کد الزامی
Android
برای ادغام «شبکه تبلیغات LY»، به کد اضافی نیاز نیست.
iOS
یکپارچه‌سازی SKAdNetwork
برای افزودن شناسه‌های SKAdNetwork به فایل Info.plist پروژه خود، اسناد «شبکه آگهی LY» را دنبال کنید.
مرحله ۵: پیاده‌سازی‌تان را آزمایش کنید
فعال کردن آگهی‌های آزمایشی
مطمئن شوید که دستگاه آزمایشی خود را برای AdMob ثبت کرده‌اید.
درستی‌سنجی آگهی‌های آزمایشی
برای درستی‌سنجی اینکه آگهی‌های آزمایشی را از LY Ads Network دریافت می‌کنید، آزمایش منبع آگهی تکی را در بازرس آگهی بااستفاده از منبع(های) آگهی LY Ads Network فعال کنید.
مراحل اختیاری
پارامترهای ویژه شبکه
افزایه میانجی‌گری «شبکه آگهی‌های LY» از پارامتر درخواست اضافی زیر که می‌تواند ازطریق کلاس LineMediationExtras به آداپتور منتقل شود پشتیبانی می‌کند:
-
SetEnableAdSound(boolean): وضعیت شروع صدای پیش‌فرض آگهی‌های برنمایی، بینابینی، و پاداش‌دار را مشخص می‌کند.
در اینجا نمونه کدی از نحوه ایجاد درخواست آگهی که این پارامترها را تنظیم می‌کند آورده شده است:
using GoogleMobileAds.Api;
using GoogleMobileAds.Mediation.Line.Api;
// ...
var adRequest = new AdRequest();
var lineExtras = new LineMediationExtras();
lineExtras.SetEnableAdSound(true);
adRequest.MediationExtras.Add(lineExtras);
کدهای خطا
اگر آداپتور نتواند آگهی را از «شبکه آگهی‌های LY» دریافت کند،
ناشران می‌توانند خطای زیربنایی را از پاسخ آگهی بااستفاده از
ResponseInfo در کلاس‌های زیر بررسی کنند:
Android
com.line.ads
com.google.ads.mediation.line.LineMediationAdapter
iOS
GADMediationAdapterLine
در اینجا کدها و پیام‌های همراهی که توسط میانای «شبکه آگهی LY» هنگام بار نشدن آگهی ارسال می‌شود آمده است:
Android
| کد خطا | دامنه | استدلال |
|---|---|---|
| ۱-۱۰ | com.five_corp.ad | «کیت توسعه نرم‌افزار شبکه آگهی LY» خطای مختص کیت توسعه نرم‌افزار برگرداند. برای جزئیات بیشتر، اسناد «شبکه تبلیغات LY Ads» را ببینید. |
| ۱۰۱ | 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» خطای مختص کیت توسعه نرم‌افزار برگرداند. برای جزئیات بیشتر، اسناد «شبکه تبلیغات 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 Unity
نسخه ۲.۲.۱
- از نسخه ۳.۱.۱.۲ آداپتور Android Line پشتیبانی می‌کند.
- از نسخه ۳.۱.۱.۰ آداپتور Line iOS پشتیبانی می‌کند.
- با نسخه ۱۱.۵.۰ «افزایه Google Mobile Ads Unity» ساخته و آزمایش شده است.
نسخه ۲.۲.۰
- از نسخه ۳.۱.۱.۱ آداپتور Line Android پشتیبانی می‌کند.
- از نسخه ۳.۱.۰.۰ آداپتور Line iOS پشتیبانی می‌کند.
- با نسخه ۱۱.۵.۰ «افزایه Google Mobile Ads Unity» ساخته و آزمایش شده است.
نسخه ۲.۱.۱
- از نسخه ۳.۱.۱.۱ آداپتور Line Android پشتیبانی می‌کند.
- از نسخه ۳.۰.۱.۲ آداپتور Line iOS پشتیبانی می‌کند.
- با افزایه Google Mobile Ads Unity نسخه ۱۱.۳.۰ ساخته و آزمایش شده است.
نسخه ۲.۱.۰
- از نسخه ۳.۱.۰.۰ آداپتور Android در Line پشتیبانی می‌کند.
- از نسخه ۳.۰.۱.۰ آداپتور Line iOS پشتیبانی می‌کند.
- با نسخه ۱۱.۰.۰ افزایه Google Mobile Ads Unity ساخته و آزمایش شده است.
نسخه ۲.۰.۲
- از نسخه ۳.۰.۱.۱ آداپتور Android Line پشتیبانی می‌کند.
- از نسخه ۳.۰.۱.۰ آداپتور Line iOS پشتیبانی می‌کند.
- با نسخه ۱۱.۰.۰ افزایه Google Mobile Ads Unity ساخته و آزمایش شده است.
نسخه ۲.۰.۱
- از نسخه ۳.۰.۱.۱ آداپتور Android Line پشتیبانی می‌کند.
- از نسخه ۳.۰.۰.۱ آداپتور Line iOS پشتیبانی می‌کند.
- با نسخه ۱۱.۰.۰ افزایه Google Mobile Ads Unity ساخته و آزمایش شده است.
نسخه ۲.۰.۰
- از نسخه ۳.۰.۱.۰ آداپتور Android در Line پشتیبانی می‌کند.
- از نسخه ۳.۰.۰.۰ آداپتور Line iOS پشتیبانی می‌کند.
- با نسخه 10.7.0 افزایه Google Mobile Ads Unity ساخته و آزمایش شده است.
نسخه ۱.۵.۱۰
- از نسخه ۲.۹.۲۰۲۵۱۰۲۸.۰ آداپتور Android در Line پشتیبانی می‌کند.
- از نسخه ۲.۹.۲۰۲۵۱۱۱۹.۰ آداپتور Line iOS پشتیبانی می‌کند.
- با نسخه ۱۰.۶.۰ «افزایه Google Mobile Ads Unity» ساخته و آزمایش شده است.
نسخه ۱.۵.۹
- از نسخه ۲.۹.۲۰۲۵۱۰۲۸.۰ آداپتور Android در Line پشتیبانی می‌کند.
- از نسخه ۲.۹.۲۰۲۵۰۹۳۰.۰ آداپتور Line iOS پشتیبانی می‌کند.
- با نسخه ۱۰.۶.۰ «افزایه Google Mobile Ads Unity» ساخته و آزمایش شده است.
نسخه ۱.۵.۸
- از نسخه ۲.۹.۲۰۲۵۰۹۲۴.۱ از «آداپتور Android Line» پشتیبانی می‌کند.
- از نسخه ۲.۹.۲۰۲۵۰۹۳۰.۰ آداپتور Line iOS پشتیبانی می‌کند.
- با نسخه ۱۰.۵.۰ «افزایه Google Mobile Ads Unity» ساخته و آزمایش شده است.
نسخه ۱.۵.۷
- از نسخه ۲.۹.۲۰۲۵۰۹۲۴.۰ آداپتور Android در Line پشتیبانی می‌کند.
- از نسخه ۲.۹.۲۰۲۵۰۹۱۲.۰ آداپتور Line iOS پشتیبانی می‌کند.
- با نسخه ۱۰.۵.۰ «افزایه Google Mobile Ads Unity» ساخته و آزمایش شده است.
نسخه 1.5.6
- از نسخه ۲.۹.۲۰۲۵۰۷۱۸.۰ آداپتور Android در Line پشتیبانی می‌کند.
- از نسخه ۲.۹.۲۰۲۵۰۵۱۲.۰ آداپتور Line iOS پشتیبانی می‌کند.
- با نسخه ۱۰.۳.۰ «افزایه Google Mobile Ads Unity» ساخته و آزمایش شده است.
نسخه ۱.۵.۵
- مشکلی که باعث می‌شد افزایه هنگام نصب ازطریق OpenUPM بسته‌ها را به‌درستی وارد نکند برطرف شد.
نسخه ۱.۵.۴
- از نسخه ۲.۹.۲۰۲۵۰۵۱۹.۰ آداپتور Android در Line پشتیبانی می‌کند.
- از نسخه ۲.۹.۲۰۲۵۰۵۱۲.۰ آداپتور Line iOS پشتیبانی می‌کند.
- با نسخه 10.1.0 افزایه Google Mobile Ads Unity ساخته و آزمایش شده است.
نسخه 1.5.3
- افزایه Unity اکنون با «کیت توسعه نرم‌افزار Android» نسخه ۳۵ ساخته شده است.
- از نسخه ۲.۹.۲۰۲۵۰۳۱۷.۱ آداپتور Android در Line پشتیبانی می‌کند.
- از نسخه ۲.۹.۲۰۲۴۱۱۰۶.۳ آداپتور Line iOS پشتیبانی می‌کند.
- با نسخه 10.1.0 افزایه Google Mobile Ads Unity ساخته و آزمایش شده است.
نسخه ۱.۵.۲
- از نسخه ۲.۹.۲۰۲۵۰۱۱۰.۰ آداپتور Android در Line پشتیبانی می‌کند.
- از نسخه ۲.۹.۲۰۲۴۱۱۰۶.۲ آداپتور Line iOS پشتیبانی می‌کند.
- با نسخه 10.0.0 افزایه Google Mobile Ads Unity ساخته و آزمایش شده است.
نسخه ۱.۵.۱
- از نسخه ۲.۹.۲۰۲۵۰۱۱۰.۰ آداپتور Android در Line پشتیبانی می‌کند.
- از نسخه ۲.۹.۲۰۲۴۱۱۰۶.۱ آداپتور Line iOS پشتیبانی می‌کند.
- با نسخه ۹.۵.۰ «افزایه Google Mobile Ads Unity» ساخته و آزمایش شده است.
نسخه 1.5.0
- از نسخه ۲.۹.۲۰۲۴۱۱۲۹.۰ آداپتور Android در Line پشتیبانی می‌کند.
- از نسخه ۲.۹.۲۰۲۴۱۱۰۶.۱ آداپتور Line iOS پشتیبانی می‌کند.
- با نسخه ۹.۵.۰ «افزایه Google Mobile Ads Unity» ساخته و آزمایش شده است.
نسخه ۱.۴.۰
- از نسخه ۲.۸.۲۰۲۴۰۸۲۷.۰ آداپتور Android در Line پشتیبانی می‌کند.
- از نسخه ۲.۹.۲۰۲۴۱۱۰۶.۱ آداپتور Line iOS پشتیبانی می‌کند.
- با نسخه ۹.۴.۰ «افزایه Google Mobile Ads Unity» ساخته و آزمایش شده است.
نسخه ۱.۳.۱
- از نسخه ۲.۸.۲۰۲۴۰۸۰۸.۰ آداپتور Android در Line پشتیبانی می‌کند.
- از نسخه ۲.۸.۲۰۲۴۰۶۱۲.۰ آداپتور Line iOS پشتیبانی می‌کند.
- با نسخه ۹.۲.۰ «افزایه Google Mobile Ads Unity» ساخته و آزمایش شده است.
نسخه ۱.۳.۰
- از نسخه ۲.۸.۲۰۲۴۰۷۲۲.۰ آداپتور Android در Line پشتیبانی می‌کند.
- از نسخه ۲.۸.۲۰۲۴۰۶۱۲.۰ آداپتور Line iOS پشتیبانی می‌کند.
- با نسخه ۹.۲.۰ «افزایه Google Mobile Ads Unity» ساخته و آزمایش شده است.
نسخه ۱.۲.۰
- از نسخه ۲.۷.۲۰۲۴۰۵۱۵.۰ آداپتور Android در Line پشتیبانی می‌کند.
- از نسخه ۲.۸.۲۰۲۴۰۶۱۲.۰ آداپتور Line iOS پشتیبانی می‌کند.
- با افزایه Google Mobile Ads Unity نسخه ۹.۱.۱ ساخته و آزمایش شده است.
نسخه ۱.۱.۲
- از نسخه ۲.۷.۲۰۲۴۰۵۱۵.۰ آداپتور Android در Line پشتیبانی می‌کند.
- از نسخه ۲.۷.۲۰۲۴۰۴۱۱.۰ آداپتور Line iOS پشتیبانی می‌کند.
- با نسخه ۹.۱.۰ «افزایه Google Mobile Ads Unity» ساخته و آزمایش شده است.
نسخه ۱.۱.۱
- از نسخه ۲.۷.۲۰۲۴۰۲۱۴.۱ آداپتور Android در خط پشتیبانی می‌کند.
- از نسخه ۲.۷.۲۰۲۴۰۴۱۱.۰ آداپتور Line iOS پشتیبانی می‌کند.
- با نسخه ۹.۱.۰ «افزایه Google Mobile Ads Unity» ساخته و آزمایش شده است.
نسخه ۱.۱.۰
- کلاس
LineMediationExtrasبا روش‌های زیر برای پشتیبانی از انتقال موارد اضافی میانجی‌گری اضافه شد.SetEnabledAdSound(bool)
- از نسخه ۲.۷.۲۰۲۴۰۲۱۴.۱ آداپتور Android در خط پشتیبانی می‌کند.
- از نسخه ۲.۷.۲۰۲۴۰۳۱۸.۰ آداپتور Line iOS پشتیبانی می‌کند.
- با نسخه ۹.۰.۰ «افزایه Google Mobile Ads Unity» ساخته و آزمایش شده است.
نسخه ۱.۰.۰
- نسخهٔ پخش اولیه.
- از نسخه ۲.۶.۲۰۲۳۰۶۰۷.۰ آداپتور Android در Line پشتیبانی می‌کند.
- از نسخه ۲.۶.۲۰۲۳۰۶۰۹.۰ آداپتور Line iOS پشتیبانی می‌کند.
- با نسخه ۸.۵.۱ «افزایه Google Mobile Ads Unity» ساخته و آزمایش شده است.