ادغام i-mobile با واسطه

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

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

ادغام ها و قالب های تبلیغاتی پشتیبانی شده

آداپتور میانجی برای i-mobile دارای قابلیت های زیر است:

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

الزامات

• هدف استقرار iOS 12.0 یا بالاتر

• جدیدترین SDK تبلیغات موبایل گوگل

• راهنمای شروع میانجیگری را کامل کنید

مرحله 1: تنظیمات را در i-mobile UI تنظیم کنید

ثبت نام کنید یا به حساب آی موبایل خود وارد شوید .

با کلیک کردن روی تب (مدیریت سایت/برنامه) و دکمه پلت فرم برنامه خود، برنامه خود را به داشبورد i-mobile اضافه کنید.

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

توجه: i-mobile باید ثبت نام شما را تایید کند. پس از تایید، می توانید یک مکان تبلیغاتی ایجاد کنید.

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

به تب広告スポット管理 (مدیریت مکان تبلیغات) بروید و روی دکمه新規広告スポット (نقطه تبلیغاتی جدید) کلیک کنید.

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

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

به شناسه パブリッシャーشناسه (شناسه ناشر) ، شناسه (شناسه رسانه) و شناسه (شناسه نقطه ای) توجه داشته باشید. بعداً هنگام پیکربندی i-mobile برای میانجیگری در رابط کاربری AdMob به این پارامترها نیاز خواهید داشت.

مرحله 2: تقاضای i-mobile را در رابط کاربری AdMob تنظیم کنید

تنظیمات میانجی را برای واحد تبلیغات خود پیکربندی کنید

باید i-mobile را به پیکربندی میانجی واحد تبلیغاتی خود اضافه کنید.

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

برای ایجاد یک گروه میانجی جدید، Create Mediation Group را انتخاب کنید.

قالب و پلتفرم تبلیغ خود را وارد کنید، سپس روی Continue کلیک کنید.

به گروه میانجی خود یک نام بدهید و مکان‌هایی را برای هدف انتخاب کنید. سپس، وضعیت گروه میانجی را روی Enabled تنظیم کنید و سپس روی Add Units Ad Units کلیک کنید.

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

اکنون باید کارت واحدهای تبلیغاتی را با واحدهای تبلیغاتی که انتخاب کرده‌اید مشاهده کنید:

i-mobile را به عنوان منبع تبلیغ اضافه کنید

در زیر کارت Waterfall در بخش Ad Sources ، Add Source Ad را انتخاب کنید. سپس i-mobile را انتخاب کنید.

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

توجه : شما فقط باید یک بار در هر شبکه بهینه سازی منبع تبلیغات را تنظیم کنید.

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

در مرحله بعد، شناسه ناشر ، شناسه رسانه و شناسه Spot را که در بخش قبل به دست آمده است وارد کنید. سپس روی Done کلیک کنید.

توجه : بهینه‌سازی منبع آگهی چند روز طول می‌کشد تا داده‌های کافی برای محاسبه دقیق eCPM برای یک شبکه میانجی جمع‌آوری شود. در ضمن، وضعیت بهینه‌سازی منبع آگهی PENDING است، بنابراین باید به‌طور دستی مقدار eCPM را برای شبکه تنظیم کنید. پس از محاسبه eCPM، منبع آگهی به‌طور خودکار از طرف شما شروع به به‌روزرسانی eCPM می‌کند.

مرحله 3: SDK و آداپتور i-mobile را وارد کنید

توجه: عدم ادغام نسخه‌های سازگار با i-mobile و Google Mobile Ads SDK ممکن است منجر به مشکلات ساخت شود.

استفاده از CocoaPods (توصیه می شود)

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

pod 'GoogleMobileAdsMediationIMobile'

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

pod install --repo-update

ادغام دستی

• آخرین نسخه i-mobile SDK را دانلود کنید و ImobileSdkAds.framework را در پروژه خود پیوند دهید.
• آخرین نسخه آداپتور i-mobile را از لینک دانلود در Changelog دانلود کنید و IMobileAdapter.framework در پروژه خود پیوند دهید.

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

ادغام SKAdNetwork

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

مرحله 5: اجرای خود را آزمایش کنید

فعال کردن تبلیغات آزمایشی

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

مهم: قبل از انتشار برنامه، حالت تست AdMob و i-mobile را غیرفعال کنید.

تبلیغات آزمایشی را تأیید کنید

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

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

استفاده از تبلیغات بومی

رندر آگهی

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

میدان	دارایی ها همیشه توسط آداپتور i-mobile گنجانده شده است
تیتر
تصویر
بدن
نماد برنامه	^1
فراخوان به اقدام
رتبه بندی ستاره
فروشگاه
قیمت

¹ برای تبلیغات بومی، i-mobile SDK دارایی نماد برنامه را ارائه نمی دهد. در عوض، آداپتور i-mobile نماد برنامه را با یک تصویر شفاف پر می کند.

کدهای خطا

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

قالب	نام کلاس
بنر	آداپتور IMobile
بینابینی	آداپتور IMobile
بومی	GADMediationAdapterIMmobile

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

کد خطا	دلیل
0-10	i-mobile SDK یک خطا را نشان داد. برای جزئیات بیشتر به کد مراجعه کنید.
101	پارامترهای سرور i-mobile پیکربندی شده در رابط کاربری AdMob گم شده/نامعتبر است.
102	اندازه آگهی درخواستی با اندازه بنر پشتیبانی شده از i-mobile مطابقت ندارد.
103	i-mobile موفق به ارائه آگهی نشد.
104	i-mobile یک آرایه تبلیغاتی بومی خالی را برگرداند.
105	i-mobile در دانلود دارایی های تبلیغاتی بومی شکست خورد.
106	i-mobile از درخواست چندین آگهی بینابینی با استفاده از همان Spot ID پشتیبانی نمی کند.

i-mobile iOS Mediation Adapter Changelog

نسخه 2.3.4.1

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

ساخته و تست شده با:

• Google Mobile Ads SDK نسخه 11.10.0.
• i-mobile SDK نسخه 2.3.4.

نسخه 2.3.4.0

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

ساخته و تست شده با:

• Google Mobile Ads SDK نسخه 11.2.0.
• i-mobile SDK نسخه 2.3.4.

نسخه 2.3.3.0

• سازگاری تایید شده با i-mobile SDK 2.3.3.

ساخته و تست شده با:

• Google Mobile Ads SDK نسخه 11.1.0.
• i-mobile SDK نسخه 2.3.3.

نسخه 2.3.2.1

• روش منسوخ شده willBackgroundApplication delegate از بنر، بینابینی و اجرای تبلیغات بومی حذف شد.
• اکنون به حداقل نسخه iOS 12.0 نیاز دارد.
• اکنون به Google Mobile Ads SDK نسخه 11.0 یا بالاتر نیاز دارد.
• Info.plist در چارچوب های IMobileAdapter.xcframework گنجانده شده است.

ساخته و تست شده با:

• Google Mobile Ads SDK نسخه 11.0.1.
• i-mobile SDK نسخه 2.3.2.

نسخه 2.3.2.0

• سازگاری تایید شده با i-mobile SDK 2.3.2.
• پشتیبانی از معماری armv7 حذف شد.
• اکنون به حداقل نسخه iOS 11.0 نیاز دارد.
• اکنون به Google Mobile Ads SDK نسخه 10.4.0 یا بالاتر نیاز دارد.

ساخته و تست شده با:

• Google Mobile Ads SDK نسخه 10.4.0.
• i-mobile SDK نسخه 2.3.2.

نسخه 2.3.1.0

• سازگاری تایید شده با i-mobile SDK 2.3.1.

ساخته و تست شده با:

• Google Mobile Ads SDK نسخه 10.3.0.
• i-mobile SDK نسخه 2.3.1.

نسخه 2.3.0.1

• اکنون به Google Mobile Ads SDK نسخه 10.0.0 یا بالاتر نیاز دارد.

ساخته و تست شده با:

• Google Mobile Ads SDK نسخه 10.0.0.
• i-mobile SDK نسخه 2.3.0.

نسخه 2.3.0.0

• سازگاری تایید شده با i-mobile SDK 2.3.0.
• اکنون به Google Mobile Ads SDK نسخه 9.8.0 یا بالاتر نیاز دارد.

ساخته و تست شده با:

• Google Mobile Ads SDK نسخه 9.13.0.
• i-mobile SDK نسخه 2.3.0.

نسخه 2.2.0.1

• اکنون به Google Mobile Ads SDK نسخه 9.0.0 یا بالاتر نیاز دارد.

ساخته و تست شده با:

• Google Mobile Ads SDK نسخه 9.0.0.
• i-mobile SDK نسخه 2.2.0.

نسخه 2.2.0.0

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

ساخته و تست شده با

• Google Mobile Ads SDK نسخه 8.13.0.
• i-mobile SDK نسخه 2.2.0.

نسخه 2.1.0.1

• وابستگی آرام به Google Mobile Ads SDK نسخه 8.0.0 یا بالاتر.

ساخته و تست شده با

• Google Mobile Ads SDK نسخه 8.4.0.
• i-mobile SDK نسخه 2.1.0.

نسخه 2.1.0.0

• سازگاری تایید شده با i-mobile SDK نسخه 2.1.0.
• اکنون به Google Mobile Ads SDK نسخه 8.1.0 یا بالاتر نیاز دارد.
• آداپتور را برای استفاده از قالب .xcframework . به روز کرد.

ساخته و تست شده با

• Google Mobile Ads SDK نسخه 8.1.0.
• i-mobile SDK نسخه 2.1.0.

نسخه 2.0.33.1

• کدها و پیام های خطای استاندارد آداپتور اضافه شده است.
• آداپتور اکنون درخواست چندین آگهی بینابینی را با استفاده از همان i-mobile Spot ID محدود می کند.
• آداپتور اکنون -nativeAdWillLeaveApplication: هنگامی که تبلیغات بومی ضربه زده می شود.
• اکنون به Google Mobile Ads SDK نسخه 7.68.0 یا بالاتر نیاز دارد.

ساخته و تست شده با

• Google Mobile Ads SDK نسخه 7.68.0.
• i-mobile SDK نسخه 2.0.33.

نسخه 2.0.33.0

• سازگاری تایید شده با i-mobile SDK نسخه 2.0.33.
• اکنون به Google Mobile Ads SDK نسخه 7.65.0 یا بالاتر نیاز دارد.
• اکنون به حداقل نسخه iOS 9.0 نیاز دارد.

ساخته و تست شده با

• Google Mobile Ads SDK نسخه 7.65.0.
• i-mobile SDK نسخه 2.0.33.

نسخه 2.0.32.0

• سازگاری تایید شده با i-mobile SDK نسخه 2.0.32.
• اکنون به Google Mobile Ads SDK نسخه 7.60.0 یا بالاتر نیاز دارد.
• پشتیبانی از مقیاس بندی تبلیغات 320x50 و 320x100 برای تناسب بهتر با اندازه های درخواست بنر تطبیقی ​​اضافه شده است.
• پشتیبانی از معماری i386 حذف شد.

ساخته و تست شده با

• Google Mobile Ads SDK نسخه 7.60.0.
• i-mobile SDK نسخه 2.0.32.

نسخه 2.0.31.0

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

ساخته و تست شده با

• Google Mobile Ads SDK نسخه 7.53.1.
• i-mobile SDK نسخه 2.0.31.

نسخه 2.0.29.0

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

ساخته و تست شده با

• Google Mobile Ads SDK نسخه 7.52.0.
• i-mobile SDK نسخه 2.0.29.