این راهنما به شما نشان میدهد که چگونه از Google Mobile Ads SDK برای بارگیری و نمایش تبلیغات از maio استفاده کنید میانجیگری ،پوشش ادغام آبشار نحوه افزودن maio به پیکربندی میانجی واحد تبلیغات و نحوه ادغام maio SDK و آداپتور در یکiOS برنامه
رابط داشبورد برای maio از متن ژاپنی برای برچسبها، دکمهها و توضیحات خود استفاده میکند و اسکرینشاتهای این راهنما ترجمه نشدهاند. اما در توضیحات و دستورالعمل های این راهنما، برچسب ها و دکمه ها با معادل های زبان انگلیسی خود ارجاع داده شده اند. برای مثال "URL スキーム"، "URL Scheme" است.
ادغام ها و قالب های تبلیغاتی پشتیبانی شده
آداپتور میانجی برای maio دارای قابلیت های زیر است:
یکپارچه سازی | |
---|---|
مناقصه | |
آبشار | |
فرمت ها | |
بنر | |
بینابینی | |
پاداش داده شد | |
بومی |
الزامات
- هدف استقرار iOS 12.0 یا بالاتر
جدیدترین SDK تبلیغات موبایل گوگل
راهنمای شروع میانجیگری را کامل کنید
مرحله 1: تنظیمات را در maio UI تنظیم کنید
ابتدا ثبت نام کنید یا وارد حساب کاربری maio خود شوید . روی دکمه مدیریت برنامه در نوار کناری سمت چپ کلیک کنید و روی برنامه جدید کلیک کنید.
برگه مربوط به نوع تبلیغ دلخواه خود را انتخاب کنید.
بینابینی
نام برنامه خود را وارد کنید، پلتفرم را انتخاب کنید و URL برنامه خود را ارائه دهید. Video interstitial را به عنوان نوع آگهی انتخاب کنید و سپس روی Update کلیک کنید.
پاداش داده شد
نام برنامه خود را وارد کنید، پلتفرم را انتخاب کنید و URL برنامه خود را ارائه دهید. Video Rewards را به عنوان نوع تبلیغ انتخاب کنید و سپس روی Update کلیک کنید.
در صفحه مدیریت برنامه ، شناسه رسانه را یادداشت کنید. برای راهاندازی واحد تبلیغات Ad Manager در بخش بعدی، لازم است.
در صفحه مدیریت منطقه ، شناسه منطقه را یادداشت کنید. همچنین لازم است واحد تبلیغات Ad Manager خود را در بخش بعدی تنظیم کنید.
(فقط آبشار) علاوه بر شناسه رسانه و شناسه منطقه ، به شناسه API و API KEY برای تنظیم شناسه واحد تبلیغات خود برای میانجیگری نیاز دارید. در صفحه گزارش API ، شناسه API و کلید API را یادداشت کنید.مرحله 2: تقاضای maio را تنظیم کنید Ad Manager UI
تنظیمات میانجی را برای واحد تبلیغات خود پیکربندی کنید
به حساب Ad Manager خود وارد شوید.
به مسیر Delivery > Yield Groups بروید و روی دکمه گروه بازده جدید کلیک کنید.
یک نام منحصر به فرد برای گروه بازدهی خود وارد کنید، وضعیت را روی فعال تنظیم کنید، قالب تبلیغات خود را انتخاب کنید و نوع موجودی را روی برنامه موبایل تنظیم کنید. در بخش Targeting > Inventory ، واحد تبلیغاتی را در برنامه Inventory and Mobile که میخواهید میانجیگری را به آن اضافه کنید، انتخاب کنید.
بعد، روی دکمه افزودن شریک عملکرد کلیک کنید.
اگر در حال حاضر یک شریک بازده برایmaio، می توانید آن را انتخاب کنید. در غیر این صورت، Create a new yield partner را انتخاب کنید.
انتخاب کنیدmaio به عنوان شبکه تبلیغات ، یک نام منحصر به فرد وارد کنید و Mediation را فعال کنید.
جمع آوری خودکار داده ها را روشن کرده و وارد کنیدAPI ID and API KEYدر بخش قبل به دست آمد.
پس از انتخاب شریک Yield ، Mobile SDK Mediation را به عنوان نوع ادغام انتخاب کنید.iOS به عنوان پلتفرم و فعال به عنوان وضعیت . را وارد کنیدMedia ID and Zone ID در بخش قبل به دست آمد. سپس، یک مقدار پیش فرض CPM را وارد کنید.
پس از اتمام روی ذخیره در پایین صفحه کلیک کنید.
مرحله 3: maio SDK و آداپتور را وارد کنید
استفاده از CocoaPods (توصیه می شود)
خط زیر را به Podfile پروژه خود اضافه کنید:
pod 'GoogleMobileAdsMediationMaio'
از خط فرمان اجرا کنید:
pod install --repo-update
ادغام دستی
- آخرین نسخه maio SDK را دانلود کنید.
- آخرین نسخه آداپتور maio را از لینک دانلود در Changelog دانلود کنید و
maioAdapter.framework
در پروژه خود پیوند دهید.
مرحله 4: کد مورد نیاز را اضافه کنید
ادغام SKAdNetwork
مستندات maio را دنبال کنید تا شناسه های SKAdNetwork را به فایل Info.plist
پروژه خود اضافه کنید.
مرحله 5: اجرای خود را آزمایش کنید
فعال کردن تبلیغات آزمایشی
مطمئن شوید که دستگاه آزمایشی خود را برای Ad Manager ثبت کرده اید.
ناشرانی که از نسخه 7.26.0 یا بالاتر از Google Mobile Ads SDK استفاده میکنند، هنگام درخواست، بهطور خودکار آگهیهای آزمایشی را از maio در تلفنها و رایانههای لوحی ثبتشده بهعنوان دستگاههای آزمایشی دریافت میکنند.
تبلیغات آزمایشی را تأیید کنید
برای تأیید اینکه آگهیهای آزمایشی را از maio دریافت میکنید، با استفاده از منبع(های) آگهی maio (آبشار) آزمایش منبع آگهی را در بازرس آگهی فعال کنید.
کدهای خطا
اگر آداپتور نتواند تبلیغی را از maio دریافت کند، ناشران می توانند با استفاده از پاسخ آگهی، خطای اساسی را بررسی کنند.GADResponseInfo.adNetworkInfoArray
تحت کلاس های زیر:
قالب | نام کلاس |
---|---|
بینابینی | GADMMaioInterstitialAdapter |
پاداش داده شد | GADMMaioRewardedAdapter |
در اینجا کدها و پیامهای همراهی هستند که توسط آداپتور maio در هنگام بارگیری یک آگهی ارسال میشوند:
کد خطا | دلیل |
---|---|
0-10 | maio یک خطای خاص SDK را برگرداند. برای جزئیات بیشتر به کد maio مراجعه کنید. |
101 | maio هنوز تبلیغی در دسترس ندارد. |
102 | پارامترهای سرور نامعتبر (به عنوان مثال شناسه مکان وجود ندارد). |
103 | آداپتور maio از قالب آگهی درخواستی پشتیبانی نمی کند. |
104 | یک آگهی قبلاً برای این پیکربندی شبکه بارگیری شده است. |
maio iOS Mediation Adapter Changelog
نسخه 2.1.5.1
-
CFBundleShortVersionString
بهروزرسانی کرد تا به جای چهار مؤلفه، سه مؤلفه داشته باشد.
ساخته و تست شده با:
- Google Mobile Ads SDK نسخه 11.10.0.
- Maio SDK نسخه 2.1.5.
نسخه 2.1.5.0
- سازگاری تایید شده با maio SDK نسخه 2.1.5.
ساخته و تست شده با:
- Google Mobile Ads SDK نسخه 11.6.0.
- Maio SDK نسخه 2.1.5.
نسخه 2.1.4.0
- سازگاری تایید شده با maio SDK نسخه 2.1.4.
ساخته و تست شده با:
- Google Mobile Ads SDK نسخه 11.2.0.
- Maio SDK نسخه 2.1.4.
نسخه 2.1.3.0
- سازگاری تایید شده با maio SDK نسخه 2.1.3.
ساخته و تست شده با:
- Google Mobile Ads SDK نسخه 11.1.0.
- Maio SDK نسخه 2.1.3.
نسخه 2.1.2.1
- اکنون به Google Mobile Ads SDK نسخه 11.0 یا بالاتر نیاز دارد.
- شامل
Info.plist
در چارچوب های موجود درMaioAdapter.xcframework
.
ساخته و تست شده با:
- Google Mobile Ads SDK نسخه 11.0.1.
- Maio SDK نسخه 2.1.2.
نسخه 2.1.2.0
- سازگاری تایید شده با maio SDK نسخه 2.1.2.
ساخته و تست شده با:
- Google Mobile Ads SDK نسخه 10.14.0.
- Maio SDK نسخه 2.1.2.
نسخه 2.1.1.0
- سازگاری تایید شده با maio SDK نسخه 2.1.1.
ساخته و تست شده با:
- Google Mobile Ads SDK نسخه 10.12.0.
- Maio SDK نسخه 2.1.1.
نسخه 2.0.0.0
- سازگاری تایید شده با maio SDK نسخه 2.0.0.
- وابستگی به
MaioOB SDK
حذف شد. - پشتیبانی از معماری
armv7
حذف شد. - اکنون به حداقل نسخه iOS 12.0 نیاز دارد.
- اکنون به Google Mobile Ads SDK نسخه 10.4.0 یا بالاتر نیاز دارد.
ساخته و تست شده با:
- Google Mobile Ads SDK نسخه 10.10.0.
- Maio SDK نسخه 2.0.0.
نسخه 1.6.3.1
- اکنون به Google Mobile Ads SDK نسخه 10.0.0 یا بالاتر نیاز دارد.
ساخته و تست شده با:
- Google Mobile Ads SDK نسخه 10.0.0.
- Maio SDK نسخه 1.6.3.
- MaioOB SDK نسخه 2.0.0-alpha.
نسخه 1.6.3.0
- آداپتور را برای استفاده از
didRewardUser
API به روز کرد. - اکنون به Google Mobile Ads SDK نسخه 9.8.0 یا بالاتر نیاز دارد.
- سازگاری تأیید شده با maio SDK نسخه 1.6.3 و maioOB SDK نسخه 2.0.0-alpha.
ساخته و تست شده با:
- Google Mobile Ads SDK نسخه 9.12.0.
- Maio SDK نسخه 1.6.3.
- MaioOB SDK نسخه 2.0.0-alpha.
نسخه 1.6.2.0
- سازگاری تأیید شده با maio SDK نسخه 1.6.2 و maioOB SDK نسخه 2.0.0-alpha.
ساخته و تست شده با:
- Google Mobile Ads SDK نسخه 9.5.0.
- Maio SDK نسخه 1.6.2.
- MaioOB SDK نسخه 2.0.0-alpha.
نسخه 1.6.1.0
- سازگاری تایید شده با maio SDK نسخه 1.6.1 و maioOB SDK نسخه 2.0.0-alpha.
ساخته و تست شده با:
- Google Mobile Ads SDK نسخه 9.2.0.
- Maio SDK نسخه 1.6.1.
- MaioOB SDK نسخه 2.0.0-alpha.
نسخه 1.6.0.1
- سازگاری تأیید شده با Google Mobile Ads SDK نسخه 9.0.0.
- اکنون به Google Mobile Ads SDK نسخه 9.0.0 یا بالاتر نیاز دارد.
ساخته و تست شده با:
- Google Mobile Ads SDK نسخه 9.0.0.
- Maio SDK نسخه 1.6.0.
- MaioOB SDK نسخه 2.0.0-alpha.
نسخه 1.6.0.0
- سازگاری تأیید شده با maio SDK نسخه 1.6.0 و maioOB SDK نسخه 2.0.0-alpha.
ساخته و تست شده با:
- Google Mobile Ads SDK نسخه 8.13.0.
- اکنون به حداقل نسخه iOS 10.0 نیاز دارد.
- Maio SDK نسخه 1.6.0.
- MaioOB SDK نسخه 2.0.0-alpha.
نسخه 1.5.8.0
- سازگاری تأیید شده با maio SDK نسخه 1.5.8 و maioOB SDK نسخه 2.0.0-alpha.
- قابلیت پیشنهاد قیمت به آداپتور برای قالبهای تبلیغاتی بینابینی و پاداش اضافه شده است.
- وابستگی آرام به Google Mobile Ads SDK نسخه 8.0.0 یا بالاتر.
ساخته و تست شده با:
- Google Mobile Ads SDK نسخه 8.7.0.
- Maio SDK نسخه 1.5.8.
- MaioOB SDK نسخه 2.0.0-alpha.
نسخه 1.5.6.1
- کدها و پیام های خطای استاندارد آداپتور اضافه شده است.
- آداپتور را برای استفاده از قالب
.xcframework
. به روز کرد. - رفع اشکالی که در آن رویدادهای تبلیغاتی پاداش داده شده گاهی اوقات بازارسال نمی شدند.
- اکنون به Google Mobile Ads SDK نسخه 8.3.0 یا بالاتر نیاز دارد.
ساخته و تست شده با:
- Google Mobile Ads SDK نسخه 8.3.0.
- Maio SDK نسخه 1.5.6.
نسخه 1.5.6.0
- سازگاری تایید شده با maio SDK نسخه 1.5.6.
- اکنون به Google Mobile Ads SDK نسخه 7.68.0 یا بالاتر نیاز دارد.
ساخته و تست شده با:
- Google Mobile Ads SDK نسخه 7.68.0.
- Maio SDK نسخه 1.5.6.
نسخه 1.5.5.0
- سازگاری تایید شده با maio SDK نسخه 1.5.5.
- اکنون به Google Mobile Ads SDK نسخه 7.64.0 یا بالاتر نیاز دارد.
ساخته و تست شده با:
- Google Mobile Ads SDK نسخه 7.64.0.
- Maio SDK نسخه 1.5.5.
نسخه 1.5.4.0
- سازگاری تایید شده با maio SDK نسخه 1.5.4.
- اکنون به Google Mobile Ads SDK نسخه 7.60.0 یا بالاتر نیاز دارد.
ساخته و تست شده با:
- Google Mobile Ads SDK نسخه 7.60.0.
- Maio SDK نسخه 1.5.4.
نسخه 1.5.3.1
- برای محدود کردن زمانهای زمانی، اگر maio آگهی آماده نمایش نداشته باشد، درخواستهای تبلیغات فوراً با شکست مواجه میشوند.
- پشتیبانی از معماری i386 حذف شد.
ساخته و تست شده با:
- Google Mobile Ads SDK نسخه 7.58.0.
- Maio SDK نسخه 1.5.3.
نسخه 1.5.3.0
- سازگاری تایید شده با maio SDK نسخه 1.5.3.
ساخته و تست شده با:
- Google Mobile Ads SDK نسخه 7.55.1.
- Maio SDK نسخه 1.5.3.
نسخه 1.5.2.1
- مشکلی را که در آن آداپتور
-rewardedAdDidPresent:
callback را فراخوانی نمی کرد، برطرف شد.
ساخته و تست شده با:
- Google Mobile Ads SDK نسخه 7.53.1.
- Maio SDK نسخه 1.5.2.
نسخه 1.5.2.0
- سازگاری تایید شده با maio SDK نسخه 1.5.2.
ساخته و تست شده با:
- Google Mobile Ads SDK نسخه 7.53.1.
- Maio SDK نسخه 1.5.2.
نسخه 1.5.1.0
- سازگاری تایید شده با maio SDK نسخه 1.5.1.
ساخته و تست شده با:
- Google Mobile Ads SDK نسخه 7.52.0.
- Maio SDK نسخه 1.5.1.
نسخه 1.5.0.0
- سازگاری تایید شده با maio SDK نسخه 1.5.0.
ساخته و تست شده با
- Google Mobile Ads SDK نسخه 7.51.0.
- Maio Ads SDK نسخه 1.5.0.
نسخه 1.4.8.0
- سازگاری تایید شده با maio SDK نسخه 1.4.8.
نسخه 1.4.6.0
- سازگاری تایید شده با maio SDK نسخه 1.4.6.
- آداپتور را برای استفاده از API جدید پاداش به روز کرد.
- اکنون به Google Mobile Ads SDK نسخه 7.42.2 یا بالاتر نیاز دارد.
نسخه 1.4.2.0
- سازگاری تایید شده با maio SDK نسخه 1.4.2.
نسخه 1.4.1.0
- سازگاری تایید شده با maio SDK نسخه 1.4.1.
- اگر چندین MediaId از AdMob ارائه شود، مشکلی برطرف شد که در آن آداپتور maio ممکن است از کار بیفتد.
نسخه 1.4.0.0
- سازگاری تایید شده با maio SDK نسخه 1.4.0.
نسخه 1.3.2.0
- سازگاری تایید شده با maio SDK نسخه 1.3.2.
نسخه 1.3.1.1
-
adapterDidCompletePlayingRewardBasedVideoAd:
برگشت به آداپتور.
نسخه 1.3.1.0
- سازگاری تایید شده با maio SDK نسخه 1.3.1.
نسخه 1.3.0.0
- سازگاری تایید شده با maio SDK نسخه 1.3.0.
نسخه 1.2.19.0
- سازگاری تایید شده با maio SDK نسخه 1.2.19.
نسخه 1.2.18.0
- اولین انتشار!
- پشتیبانی برای تبلیغات ویدیوهای بینابینی و پاداش اضافه شده است.