ادغام i-mobile با میانجی‌گری

انتخاب پلاتفرم: Android iOS Unity Flutter Android (قدیمی)

این راهنما نحوه استفاده از Google Mobile Ads SDK را برای بار کردن و نمایش آگهی‌های i-mobile بااستفاده از واسطه‌گری AdMob نشان می‌دهد، و ادغام‌های آبشاری را پوشش می‌دهد. این راهنما نحوه افزودن i-mobile به پیکربندی میانجی‌گری واحد آگهی و نحوه ادغام کردن کیت توسعه نرم‌افزار و آداپتور i-mobile در برنامه iOS را پوشش می‌دهد.

میانای داشبورد i-mobile از نوشتار ژاپنی برای برچسب‌ها، دکمه‌ها، و شرح‌های خود استفاده می‌کند. نماگرفت‌های این راهنما ترجمه نشده است. بااین‌حال، در شرح‌ها و دستورالعمل‌های این راهنما، برچسب‌ها و دکمه‌ها با معادل‌های انگلیسی آن‌ها در پرانتز ترجمه شده‌اند.

یکپارچه‌سازی‌ها و قالب‌های آگهی پشتیبانی‌شده

کارگزار میانجی‌گری برای i-mobile قابلیت‌های زیر را دارد:

یکپارچه‌سازی
پیشنهاد قیمت
آبشار
قالب‌ها
برنما
بینابینی
پاداش
بومی

پیش‌نیازها

قبل‌از ادامه دادن، موارد زیر را درستی‌سنجی کنید:

  • هدف استقرار iOS نسخه ۱۳.۰ یا بالاتر.

مرحله ۱: پیکربندی‌ها را در i-mobile UI راه‌اندازی کنید

در حساب i-mobile خود ثبت‌نام کنید یا وارد سیستم شوید.

با کلیک کردن روی برگه サイト／アプリ管理 (مدیریت سایت/برنامه) و دکمه مربوط به پلاتفرم برنامه، برنامه‌تان را به داشبورد i-mobile اضافه کنید.

فرم را تکمیل کنید و روی دکمه 新規登録 (ثبت‌نام) کلیک کنید.

برای ایجاد «جای آگهی» جدید، برنامه خود را در برگه サイト／アプリ管理 (مدیریت سایت/برنامه) انتخاب کنید.

به برگه 広告スポット管理 (مدیریت جای آگهی) پیمایش کنید و روی دکمه 新規広告スポット (جای آگهی جدید) کلیک کنید.

create_ad_spot

سپس با ارائه 広告スポット名 (نام جای آگهی)، 広告スポットサイズ (اندازه جای آگهی)، و جزئیات دیگر، فرم را تکمیل کنید. سپس، روی دکمه 新規登録 (ثبت‌نام) کلیک کنید.

new_ad_spot_form

جای آگهی جدید شما آماده است. برای مشاهده جزئیات یکپارچه‌سازی آن، روی دکمه アプリ設定取得 (دریافت تنظیمات برنامه) کلیک کنید.

ad_spot_list

パブリッシャーID (شناسه ناشر)، メディアID (شناسه رسانه)، و スポットID (شناسه نقطه) را یادداشت کنید. بعداً هنگام پیکربندی i-mobile برای میانجی‌گری در «میانای کاربر AdMob» به این پارامترها نیاز خواهید داشت.

به‌روزرسانی app-ads.txt

«فروشندگان مجاز برای برنامه‌ها» app-ads.txt ابتکار IAB Tech Lab است که کمک می‌کند مطمئن شوید فضای آگهی برنامه شما فقط ازطریق کانال‌هایی که به‌عنوان مجاز شناسایی کرده‌اید فروخته می‌شود. برای جلوگیری از کاهش قابل‌توجه درآمد آگهی، باید فایل app-ads.txt را پیاده‌سازی کنید. اگر قبلاً این کار را نکرده‌اید، فایل app-ads.txt را برای برنامه‌تان راه‌اندازی کنید.

برای پیاده‌سازی app-ads.txt برای i-mobile، به پرسشگان آن‌ها مراجعه کنید.

مرحله ۲: راه‌اندازی تقاضای i-mobile در «میانای کاربری AdMob»

پیکربندی تنظیمات واسطه‌گری برای واحد آگهی

باید i-mobile را به پیکربندی میانجی‌گری برای واحد آگهی‌تان اضافه کنید.

ابتدا به سیستم حساب AdMob خود وارد شوید. سپس به برگه واسطه‌گری پیمایش کنید. اگر گروه واسطه‌گری موجودی دارید که می‌خواهید آن را اصلاح کنید، روی نام آن گروه واسطه‌گری کلیک کنید تا آن را ویرایش کنید و به افزودن i-mobile به‌عنوان منبع آگهی بروید.

برای ایجاد گروه واسطه‌گری جدید، ایجاد گروه واسطه‌گری را انتخاب کنید.

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

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

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

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

افزودن i-mobile به‌عنوان منبع آگهی


در کارت آبشاری در بخش منابع آگهی، افزودن منبع آگهی را انتخاب کنید.

i-mobile را انتخاب کنید و کلید بهینه‌سازی را فعال کنید. برای راه‌اندازی بهینه‌سازی منبع آگهی برای i-mobile، نام ورود به سیستم و گذرواژه میانای برنامه‌سازی کاربردی دریافت‌شده در بخش قبلی را وارد کنید. سپس مقدار eCPM را برای i-mobile وارد کنید و روی ادامه دادن کلیک کنید.




اگر ازقبل نگاشتی برای i-mobile دارید، می‌توانید آن را انتخاب کنید. درغیراین‌صورت، روی افزودن نگاشت کلیک کنید.



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

مرحله ۳: وارد کردن i-mobile SDK و «آداپتور»

استفاده از مدیر بسته Swift

قبل‌از ادامه دادن، باید حداقل نسخه پشتیبانی‌شده آداپتور ۲.۳.۴.۲ را داشته باشید.

برای افزودن وابستگی بسته به پروژه، این مراحل را دنبال کنید:

  1. در Xcode، به File > Add Package Dependencies…‎ پیمایش کنید.

  2. در پیام‌واره‌ای که ظاهر می‌شود، نشانی وب بسته زیر را جستجو کنید:

    https://github.com/googleads/googleads-mobile-ios-mediation-imobile.git

  3. در قانون وابستگی، شاخه را انتخاب کنید.

  4. در فیلد نوشتاری، main را وارد کنید.

استفاده از CocoaPods

  • خط زیر را به Podfile پروژه خود اضافه کنید:

    pod 'GoogleMobileAdsMediationIMobile'

  • از خط فرمان اجرا کنید:

    pod install --repo-update

یکپارچه‌سازی دستی

  • آخرین نسخه i-mobile SDK را بارگیری کنید و ImobileSdkAds.framework را در پروژه‌تان پیوند دهید.
  • جدیدترین نسخه آداپتور i-mobile را از پیوند بارگیری در Changelog (گزارش تغییرات) و پیوند IMobileAdapter.framework در پروژه‌تان بارگیری کنید.

مرحله ۴: افزودن کد الزامی

پیاده‌سازی SKAdNetwork

برای افزودن شناسه‌های SKAdNetwork به فایل Info.plist پروژه، مستندات i-mobile را دنبال کنید.

مرحله ۵: پیاده‌سازی‌تان را آزمایش کنید

فعال کردن آگهی‌های آزمایشی

مطمئن شوید که دستگاه آزمایشی خود را برای AdMob ثبت کرده‌اید. ‫i-mobile شناسه نقطه، شناسه رسانه، و شناسه ناشر را برای آزمایش ارائه می‌دهد، می‌توانید آن‌ها را اینجا پیدا کنید.

درستی‌سنجی آگهی‌های آزمایشی

برای تأیید اینکه از i-mobile آگهی‌های آزمایشی دریافت می‌کنید، آزمایش منبع آگهی تکی را در بازرس آگهی بااستفاده از منبع (های) آگهی i-mobile(آبشاری) فعال کنید.

مراحل اختیاری

استفاده از آگهی‌های بومی

پرداز آگهی

تبدیل‌کننده i-mobile شرح‌های فیلد پیشرفته آگهی‌های بومی را برای GADNativeAd تکمیل می‌کند.

فیلد دارایی‌هایی که همیشه توسط آداپتور i-mobile اضافه می‌شود
Headline
تصویر
بدن
نماد برنامه ۱
دعوت به اقدام
رده‌بندی با ستاره
فروشگاه
قیمت

۱ برای آگهی‌های بومی، «کیت توسعه نرم‌افزار i-mobile» دارایی نماد برنامه ارائه نمی‌دهد. درعوض، آداپتور i-mobile نماد برنامه را با تصویر شفافی پر می‌کند.

کدهای خطا

اگر این آداپتور نتواند آگهی را از i-mobile دریافت کند، ناشران می‌توانند خطای زیربنایی را از پاسخ آگهی بااستفاده از GADResponseInfo.adNetworkInfoArray در کلاس‌های زیر بررسی کنند:

قالب نام کلاس
برنما IMobileAdapter
بینابینی IMobileAdapter
بومی GADMediationAdapterIMobile

در اینجا کدها و پیام‌های همراهی که توسط آداپتور i-mobile وقتی آگهی بار نمی‌شود ارائه می‌شود آورده شده است:

کد خطا استدلال
0-10 «کیت توسعه نرم‌افزار i-mobile» خطایی برگرداند. برای جزئیات بیشتر، کد را ببینید.
۱۰۱ پارامترهای سرور i-mobile که در «میانای کاربری AdMob» پیکربندی شده‌اند وجود ندارند/نامعتبر هستند.
102 اندازه آگهی درخواست‌شده با اندازه برنمای پشتیبانی‌شده i-mobile مطابقت ندارد.
103 ‫i-mobile نتوانست آگهی ارائه دهد.
104 ‫i-mobile آرایه آگهی بومی خالی برگرداند.
۱۰۵ ‫i-mobile دارایی‌های آگهی بومی را بارگیری نکرد.
106 ‫i-mobile از درخواست برای چندین آگهی بینابینی بااستفاده از یک «شناسه نقطه» پشتیبانی نمی‌کند.
107 درخواست‌های دارای محدودیت سنی را برای «کیت توسعه نرم‌افزار i-mobile» فیلتر کنید زیرا نمی‌تواند نشان‌های دارای محدودیت سنی را دریافت کند.

تغییرات آداپتور میانجی‌گری i-mobile iOS

نسخه ۲.۳.۴.۸

  • حداقل نسخه iOS به‌روزرسانی شد تا وابستگی «کیت توسعه نرم‌افزار تبلیغات تلفن همراه Google» برای اجازه دادن به نسخه‌های جزئی کاهش یابد.

ساخته و آزمایش‌شده با:

  • نسخه 13.7.0 کیت توسعه نرم‌افزار آگهی تلفن همراه Google.
  • نسخه ۲.۳.۴ کیت توسعه نرم‌افزار i-mobile.

نسخه ۲.۳.۴.۷

  • وقتی ageRestrictedTreatment جدید روی GADAgeRestrictedTreatmentChild تنظیم می‌شود، درخواست‌های دارای محدودیت سنی را برای «کیت توسعه نرم‌افزار i-mobile» فیلتر کنید.

ساخته و آزمایش‌شده با:

  • نسخه ۱۳.۴.۰ «کیت توسعه نرم‌افزار آگهی تلفن همراه Google».
  • نسخه ۲.۳.۴ کیت توسعه نرم‌افزار i-mobile.

نسخه ۲.۳.۴.۶

  • درخواست‌های دارای محدودیت سنی را برای «کیت توسعه نرم‌افزار i-mobile» فیلتر کنید زیرا نمی‌تواند نشان‌های دارای محدودیت سنی را دریافت کند.

ساخته و آزمایش‌شده با:

  • نسخه 13.2.0 کیت توسعه نرم‌افزار «آگهی تلفن همراه Google».
  • نسخه ۲.۳.۴ کیت توسعه نرم‌افزار i-mobile.

نسخه ۲.۳.۴.۵

  • وابستگی «کیت توسعه نرم‌افزار تبلیغات تلفن همراه Google» به نسخه 13.0.0 به‌روزرسانی شد.

ساخته و آزمایش‌شده با:

  • نسخه 13.0.0 کیت توسعه نرم‌افزار آگهی تلفن همراه Google.
  • نسخه ۲.۳.۴ کیت توسعه نرم‌افزار i-mobile.

نسخه ۲.۳.۴.۴

  • حداقل نسخه iOS در CocoaPods به 13.0 به‌روزرسانی شد.

ساخته و آزمایش‌شده با:

  • نسخه 13.0.0 کیت توسعه نرم‌افزار آگهی تلفن همراه Google.
  • نسخه ۲.۳.۴ کیت توسعه نرم‌افزار i-mobile.

نسخه ۲.۳.۴.۳

  • نام‌های چارچوب و سرصفحه چتر در IMobileAdapter modulemap تصحیح شد.

ساخته و آزمایش‌شده با:

  • نسخه ۱۲.۱۲.۰ «کیت توسعه نرم‌افزار آگهی تلفن همراه Google».
  • نسخه ۲.۳.۴ کیت توسعه نرم‌افزار i-mobile.

نسخه ۲.۳.۴.۲

  • اکنون به نسخه ۱۲.۰.۰ یا بالاتر «کیت توسعه نرم‌افزار تبلیغات تلفن همراه Google» نیاز دارد.

ساخته و آزمایش‌شده با:

  • نسخه ۱۲.۰.۰ «کیت توسعه نرم‌افزار آگهی تلفن همراه Google».
  • نسخه ۲.۳.۴ کیت توسعه نرم‌افزار i-mobile.

نسخه ۲.۳.۴.۱

  • ‫CFBundleShortVersionString به‌روز شد تا به‌جای چهار مؤلفه، سه مؤلفه داشته باشد.

ساخته و آزمایش‌شده با:

  • نسخه ۱۱.۱۰.۰ «کیت توسعه نرم‌افزار آگهی تلفن همراه Google».
  • نسخه ۲.۳.۴ کیت توسعه نرم‌افزار i-mobile.

نسخه ۲.۳.۴.۰

  • سازگاری با i-mobile SDK نسخه ۲.۳.۴ تأیید شد.
  • پشتیبانی از برگرداندن نسخه i-mobile SDK در adSDKVersion اضافه شد.

ساخته و آزمایش‌شده با:

  • نسخه ۱۱.۲.۰ کیت توسعه نرم‌افزار آگهی تلفن همراه Google.
  • نسخه ۲.۳.۴ کیت توسعه نرم‌افزار i-mobile.

نسخه ۲.۳.۳.۰

  • سازگاری با i-mobile SDK نسخه ۲.۳.۳ تأیید شد.

ساخته و آزمایش‌شده با:

  • نسخه ۱۱.۱.۰ کیت توسعه نرم‌افزار آگهی تلفن همراه Google.
  • نسخه ۲.۳.۳ کیت توسعه نرم‌افزار i-mobile.

نسخه ۲.۳.۲.۱

  • روش نماینده منسوخ‌شده willBackgroundApplication را از پیاده‌سازی‌های آگهی برافراز، بینابینی، و بومی برداشت.
  • اکنون به حداقل iOS نسخه ۱۲.۰ نیاز دارد.
  • اکنون به «کیت توسعه نرم‌افزار تبلیغات تلفن همراه Google» نسخه ۱۱.۰ یا بالاتر نیاز دارد.
  • ‫Info.plist در چارچوب‌های IMobileAdapter.xcframework گنجانده شده است.

ساخته و آزمایش‌شده با:

  • نسخه ۱۱.۰.۱ «کیت توسعه نرم‌افزار آگهی تلفن همراه Google».
  • نسخه ۲.۳.۲ کیت توسعه نرم‌افزار i-mobile.

نسخه ۲.۳.۲.۰

  • سازگاری با i-mobile SDK نسخه ۲.۳.۲ تأیید شد.
  • پشتیبانی از معماری armv7 برداشته شد.
  • اکنون به حداقل iOS نسخه ۱۱.۰ نیاز دارد.
  • اکنون به نسخه ۱۰.۴.۰ یا بالاتر «کیت توسعه نرم‌افزار تبلیغات تلفن همراه Google» نیاز دارد.

ساخته و آزمایش‌شده با:

  • نسخه ۱۰.۴.۰ «کیت توسعه نرم‌افزار آگهی تلفن همراه Google».
  • نسخه کیت توسعه نرم‌افزار i-mobile‏ 2.3.2.

نسخه ۲.۳.۱.۰

  • سازگاری با i-mobile SDK نسخه ۲.۳.۱ تأیید شد.

ساخته و آزمایش‌شده با:

  • نسخه 10.3.0 کیت توسعه نرم‌افزار آگهی تلفن همراه Google.
  • نسخه کیت توسعه نرم‌افزار i-mobile‏ 2.3.1.

نسخه ۲.۳.۰.۱

  • اکنون به «کیت توسعه نرم‌افزار تبلیغات تلفن همراه Google» نسخه ۱۰.۰.۰ یا بالاتر نیاز دارد.

ساخته و آزمایش‌شده با:

  • نسخه 10.0.0 کیت توسعه نرم‌افزار آگهی تلفن همراه Google.
  • نسخه ۲.۳.۰ کیت توسعه نرم‌افزار i-mobile.

نسخه ۲.۳.۰.۰

  • سازگاری با i-mobile SDK 2.3.0 تأیید شد.
  • اکنون به نسخه ۹.۸.۰ یا بالاتر «کیت توسعه نرم‌افزار تبلیغات تلفن همراه Google» نیاز دارد.

ساخته و آزمایش‌شده با:

  • نسخه ۹.۱۳.۰ «کیت توسعه نرم‌افزار آگهی تلفن همراه Google».
  • نسخه ۲.۳.۰ کیت توسعه نرم‌افزار i-mobile.

نسخه ۲.۲.۰.۱

  • اکنون به «کیت توسعه نرم‌افزار تبلیغات تلفن همراه Google» نسخه ۹.۰.۰ یا بالاتر نیاز دارد.

ساخته و آزمایش‌شده با:

  • نسخه ۹.۰.۰ «کیت توسعه نرم‌افزار آگهی تلفن همراه Google».
  • نسخه ۲.۲.۰ کیت توسعه نرم‌افزار i-mobile.

نسخه ۲.۲.۰.۰

  • سازگاری با نسخه ۲.۲.۰ کیت توسعه نرم‌افزار i-mobile تأیید شد.

ساخته و آزمایش‌شده با

  • نسخه ۸.۱۳.۰ «کیت توسعه نرم‌افزار آگهی تلفن همراه Google».
  • نسخه ۲.۲.۰ کیت توسعه نرم‌افزار i-mobile.

نسخه ۲.۱.۰.۱

  • وابستگی آسان‌گیرانه به «کیت توسعه نرم‌افزار تبلیغات تلفن همراه Google» نسخه ۸.۰.۰ یا بالاتر.

ساخته و آزمایش‌شده با

  • نسخه ۸.۴.۰ کیت توسعه نرم‌افزار آگهی تلفن همراه Google.
  • نسخه کیت توسعه نرم‌افزار i-mobile‏ 2.1.0.

نسخه ۲.۱.۰.۰

  • سازگاری با نسخه ۲.۱.۰ کیت توسعه نرم‌افزار i-mobile تأیید شد.
  • اکنون به نسخه ۸.۱.۰ یا بالاتر «کیت توسعه نرم‌افزار تبلیغات تلفن همراه Google» نیاز دارد.
  • آداپتور برای استفاده از قالب .xcframework به‌روزرسانی شد.

ساخته و آزمایش‌شده با

  • نسخه ۸.۱.۰ «کیت توسعه نرم‌افزار آگهی تلفن همراه Google».
  • نسخه ۲.۱.۰ کیت توسعه نرم‌افزار i-mobile.

نسخه ۲.۰.۳۳.۱

  • پیام‌ها و کدهای خطای آداپتور استانداردشده اضافه شد.
  • اکنون «آداپتور» درخواست چندین آگهی بینابینی را بااستفاده از یک «شناسه نقطه i-mobile» محدود می‌کند.
  • اکنون وقتی روی آگهی‌های بومی ضربه زده می‌شود، کارگزاری -nativeAdWillLeaveApplication: تماس برگشتی را بازارسال می‌کند.
  • اکنون به «کیت توسعه نرم‌افزار تبلیغات تلفن همراه Google» نسخه ۷.۶۸.۰ یا بالاتر نیاز دارد.

ساخته و آزمایش‌شده با

  • نسخه ۷.۶۸.۰ «کیت توسعه نرم‌افزار آگهی تلفن همراه Google».
  • نسخه کیت توسعه نرم‌افزار i-mobile‏ 2.0.33.

نسخه 2.0.33.0

  • سازگاری با نسخه ۲.۰.۳۳ کیت توسعه نرم‌افزار i-mobile تأیید شد.
  • اکنون به نسخه ۷.۶۵.۰ یا بالاتر «کیت توسعه نرم‌افزار تبلیغات تلفن همراه Google» نیاز دارد.
  • اکنون به حداقل نسخه iOS 9.0 نیاز دارد.

ساخته و آزمایش‌شده با

  • نسخه ۷.۶۵.۰ «کیت توسعه نرم‌افزار آگهی تلفن همراه Google».
  • نسخه کیت توسعه نرم‌افزار i-mobile‏ 2.0.33.

نسخه 2.0.32.0

  • سازگاری با نسخه ۲.۰.۳۲ کیت توسعه نرم‌افزار i-mobile تأیید شد.
  • اکنون به «کیت توسعه نرم‌افزار تبلیغات تلفن همراه Google» نسخه ۷.۶۰.۰ یا بالاتر نیاز دارد.
  • پشتیبانی از مقیاس‌بندی آگهی‌های ‎۳۲۰×۵۰ و ‎۳۲۰×۱۰۰ اضافه شد تا بهتر با اندازه‌های درخواست برنمای تطبیقی مطابقت داشته باشند.
  • پشتیبانی از معماری i386 برداشته شد.

ساخته و آزمایش‌شده با

  • نسخه ۷.۶۰.۰ «کیت توسعه نرم‌افزار آگهی تلفن همراه Google».
  • نسخه کیت توسعه نرم‌افزار i-mobile‏ 2.0.32.

نسخه 2.0.31.0

  • سازگاری با نسخه ۲.۰.۳۱ کیت توسعه نرم‌افزار i-mobile تأیید شد.

ساخته و آزمایش‌شده با

  • نسخه ۷.۵۳.۱ «کیت توسعه نرم‌افزار آگهی تلفن همراه Google».
  • نسخه کیت توسعه نرم‌افزار i-mobile‏ 2.0.31.

نسخه ۲.۰.۲۹.۰

  • انتشار اولیه!
  • پشتیبانی از آگهی‌های برنمایی، بینابینی، و بومی اضافه شد.

ساخته و آزمایش‌شده با

  • نسخه ۷.۵۲.۰ «کیت توسعه نرم‌افزار آگهی تلفن همراه Google».
  • نسخه کیت توسعه نرم‌افزار i-mobile‏ 2.0.29.