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

این راهنما به شما نشان می‌دهد که چگونه از Google Mobile Ads SDK (Legacy) برای بار کردن و نمایش دادن آگهی‌های i-mobile بااستفاده از میانجی‌گری استفاده کنید، و ادغام‌های آبشاری را پوشش می‌دهد. این راهنما نحوه افزودن i-mobile به پیکربندی میانجی‌گری واحد آگهی و نحوه ادغام کیت توسعه نرم‌افزار و مبدل i-mobile در برنامه Android را پوشش می‌دهد.

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

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

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

پیش‌نیازها

پیش‌از ادامه دادن، موارد زیر را تأیید کنید:

• Android API سطح ۲۴ یا بالاتر.

• جدیدترین نسخه Google Mobile Ads SDK (Legacy).

• راه‌اندازی میانجی‌گری.

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

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

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

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

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

به برگه 広告スポット管理 (Ad Spot Management) بروید و روی دکمه 新規広告スポット (New Ad Spot) کلیک کنید.

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

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

パブリッシャーID (Publisher ID)، メディアID (Media ID)، و スポットID (Spot ID) را یادداشت کنید. بعداً هنگام پیکربندی i-mobile برای میانجی‌گری در میانای کاربر Ad Manager به این پارامترها نیاز خواهید داشت.

فایل app-ads.txt خود را به‌روز کنید

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

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

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

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

به سیستم حساب Ad Manager خود وارد شوید.

به تحویل > گروه‌های بازده بروید و روی دکمه گروه بازده جدید کلیک کنید.

نام منحصربه‌فردی برای گروه بازدهی‌تان وارد کنید، وضعیت را روی فعال تنظیم کنید، قالب آگهی خود را انتخاب کنید، و نوع فضای آگهی را روی برنامه تلفن همراه تنظیم کنید. در بخش هدف‌یابی > فضای آگهی، واحد آگهی را در بخش فضای آگهی و برنامه تلفن همراه که می‌خواهید میانجی‌گری را به آن اضافه کنید انتخاب کنید.

سپس، روی دکمه افزودن شریک بازده کلیک کنید.

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

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

جمع‌آوری خودکار داده‌ها را روشن کنید و نام ورود به سیستم و گذرواژه API را وارد کنید

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

پس‌از اتمام، روی ذخیره در پایین صفحه کلیک کنید.

مرحله ۳: وارد کردن i-mobile SDK و Adapter

یکپارچه‌سازی «استودیو Android» (توصیه‌شده)

در فایل settings.gradle.kts سطح پروژه، مخازن زیر را اضافه کنید:

dependencyResolutionManagement {
  repositories {
    google()
    mavenCentral()
    maven {
      url = uri("https://imobile.github.io/adnw-sdk-android")
    }
  }
}

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

dependencies {
    implementation("com.google.android.gms:play-services-ads:25.5.0")
    implementation("com.google.ads.mediation:imobile:2.3.2.5")
}

dependencies {
    implementation 'com.google.android.gms:play-services-ads:25.5.0'
    implementation 'com.google.ads.mediation:imobile:2.3.2.5'
}

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

1. جدیدترین نسخه i-mobile SDK را بارگیری کنید و android-ad-sdk.aar را در پوشه sdk استخراج کنید و آن را به پروژه‌تان اضافه کنید.

2. به مصنوعات آداپتور i-mobile در «مخزن Maven» متعلق به Google بروید. جدیدترین نسخه را انتخاب کنید، فایل .aar آداپتور i-mobile را بارگیری کنید، و آن را به پروژه‌تان اضافه کنید.

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

بار کردن آگهی با بافت فعالیت

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

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

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

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

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

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

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

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

پرداز آگهی

آداپتور i-mobile فیلدهای زیر را برای NativeAd پر می‌کند.

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

کدهای خطا

اگر آداپتور نتواند آگهی‌ای از i-mobile دریافت کند، ناشران می‌توانند خطای اصلی را از پاسخ آگهی بااستفاده از ResponseInfo.getAdapterResponses() تحت کلاس‌های زیر بررسی کنند:

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

گزارش تغییرات آداپتور میانجی i-mobile Android

نسخه بعدی

• آداپتور برای استفاده از میانای برنامه‌سازی کاربردی InitializationCompleteCallback.onInitializationFailed(AdError) به‌روز شد.
• حداقل سطح میانای برنامه‌سازی کاربردی Android موردنیاز به ۲۴ به‌روز شد.
• مشکلی برطرف شد که در آن، بازخوان‌های بارگیری و ارائه آگهی بینابینی بازارسال نمی‌شدند زیرا شنونده خالی با i-mobile SDK ثبت شده بود.

نسخه ۲.۳.۲.۵

• وابستگی Kotlin آداپتور را به ۱.۹.۰ (حداقل نسخه Kotlin پشتیبانی‌شده توسط کیت توسعه نرم‌افزار GMA NextGen) سنجاق کنید.
• رفتار سقوط در شاخه‌های خرابی با محدودیت سنی درطول مقداردهی اولیه آگهی و درخواست‌های بارگیری آگهی برطرف شد.

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

• نسخه ۲۵.۴.۰ کیت توسعه نرم‌افزار آگهی‌های Google Mobile.
• نسخه ۱.۴.۰ کیت توسعه نرم‌افزار نسل بعدی آگهی‌های Google Mobile.
• IMobile SDK نسخه ۲.۳.۲.

نسخه ۲.۳.۲.۴

• وقتی AgeRestrictedTreatment جدید روی CHILD تنظیم شده باشد، درخواست‌های دارای محدودیت سنی برای i-mobile SDK فیلتر می‌شود.

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

• نسخه ۲۵.۴.۰ کیت توسعه نرم‌افزار آگهی‌های Google Mobile.
• کیت توسعه نرم‌افزار نسل بعدی تبلیغات تلفن همراه Google نسخه ۱.۲.۰.
• IMobile SDK نسخه ۲.۳.۲.

نسخه ۲.۳.۲.۳

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

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

• کیت توسعه نرم‌افزار آگهی تلفن همراه Google نسخه ۲۵.۱.۰.
• نسخه ۱.۱.۰ کیت توسعه نرم‌افزار نسل بعدی تبلیغات تلفن همراه Google.
• IMobile SDK نسخه ۲.۳.۲.

نسخه ۲.۳.۲.۲

• ویژگی‌ای برای ساختن آداپتور با وابستگی کیت توسعه نرم‌افزار GMA Next-Gen اضافه شد.
• پیاده‌سازی‌های آگهی بومی، بینابینی، و برنما از میانای برنامه‌سازی کاربردی قدیمی به میانای برنامه‌سازی کاربردی جدید منتقل شد.

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

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

نسخه ۲.۳.۲.۱

• حداقل سطح میانای برنامه‌سازی کاربردی Android موردنیاز به ۲۳ به‌روز شد.
• حداقل نسخه موردنیاز «کیت توسعه نرم‌افزار تبلیغات تلفن همراه Google» به ۲۴.۰.۰ به‌روزرسانی شد.

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

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

نسخه ۲.۳.۲.۰

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

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

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

نسخه ۲.۳.۱.۲

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

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

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

نسخه ۲.۳.۱.۱

• آداپتور برای استفاده از کلاس VersionInfo جدید به‌روز شد.
• حداقل نسخه لازم «کیت توسعه نرم‌افزار تبلیغات تلفن همراه Google» به ۲۲.۰.۰ به‌روزرسانی شد.

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

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

نسخه ۲.۳.۱.۰

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

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

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

نسخه ۲.۳.۰.۰

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

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

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

نسخه 2.0.23.1

• ‫compileSdkVersion و targetSdkVersion به میانای برنامه‌سازی کاربردی ۳۱ به‌روزرسانی شد.
• حداقل نسخه موردنیاز «کیت توسعه نرم‌افزار تبلیغات تلفن همراه Google» به ۲۱.۰.۰ به‌روزرسانی شد.
• حداقل سطح میانای برنامه‌سازی کاربردی Android موردنیاز به ۱۹ به‌روز شد.

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

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

نسخه 2.0.23.0

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

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

• کیت توسعه نرم‌افزار آگهی تلفن همراه Google نسخه ۲۰.۵.۰.
• IMobile SDK نسخه ۲.۰.۲۳.

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

• کدها و پیام‌های خطای استانداردشده آداپتور اضافه شد.
• حداقل نسخه لازم «کیت توسعه نرم‌افزار تبلیغات تلفن همراه Google» به ۲۰.۱.۰ به‌روزرسانی شد.

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

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

نسخه 2.0.22.1

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

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

• کیت توسعه نرم‌افزار آگهی تلفن همراه Google نسخه ۲۰.۰.۰.
• IMobile SDK نسخه ۲.۰.۲۲.

نسخه 2.0.22.0

• سازگاری با i-mobile SDK نسخه ۲.۰.۲۲ تأیید شد.
• آداپتور برای پشتیبانی از درخواست‌های برنمای تطبیقی درون‌خطی به‌روز شد.

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

• کیت توسعه نرم‌افزار آگهی تلفن همراه Google نسخه ۱۹.۱.۰.
• IMobile SDK نسخه ۲.۰.۲۲.

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

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

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

• کیت توسعه نرم‌افزار آگهی تلفن همراه Google نسخه ۱۹.۱.۰.
• IMobile SDK نسخه ۲.۰.۲۱.

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

• پشتیبانی از اندازه‌های آگهی برنمای انعطاف‌پذیر اضافه شد.
• حداقل نسخه لازم «کیت توسعه نرم‌افزار تبلیغات تلفن همراه Google» به ۱۸.۳.۰ به‌روزرسانی شد.

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

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

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

• اکنون آداپتور نسبت ابعادی mediaContent غیرصفر را برمی‌گرداند.

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

• کیت توسعه نرم‌افزار آگهی تلفن همراه Google نسخه ۱۸.۲.۰.
• IMobile SDK نسخه ۲.۰.۲۰.

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

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