ادغام کردن i-mobile با «واسطه‌گری AdMob»

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

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

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

آداپتور واسطه‌گری AdMob برای i-mobile قابلیت‌های زیر را دارد:

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

پیش‌نیازها

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

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

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

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

Android

iOS

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

Android

iOS

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

Android

iOS

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

create_ad_spot

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

new_ad_spot_form

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

ad_spot_list

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

Android

iOS

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

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

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

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

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

Android

برای دستورالعمل‌ها، مرحله ۲ را در راهنمای Android ببینید.

iOS

برای دستورالعمل‌ها، به مرحله ۲ در راهنمای iOS مراجعه کنید.

مرحله ۳: وارد کردن کیت توسعه نرم‌افزار i-mobile و آداپتور

در دایرکتوری ریشه پروژه‌تان، آداپتور میانجی‌گری Google Mobile Ads SDK for React Native را برای i-mobile نصب کنید. موارد زیر را تکمیل کنید:

  1. فایل tar آداپتور Google Mobile Ads SDK for React Native را از دایرکتوری gma-sdk-react-native/adapters/imobile/ در دایرکتوری local_packages/ پروژه‌تان کپی کنید. اگر پوشه adapters را ندارید، پیش‌نیازها را ببینید.

    mkdir -p local_packages
cp EXTRACT_DIR/gma-sdk-react-native/adapters/imobile/gma-mediation-imobile-0.1.0.tgz local_packages/

    ‫EXTRACT_DIR را با مسیر دایرکتوری‌ای که بایگانی را در آن استخراج کرده‌اید جایگزین کنید.

  2. بسته آداپتور را بااستفاده از مدیر بسته ترجیحی‌تان نصب کنید:

    npm

    npm install ./local_packages/gma-mediation-imobile-0.1.0.tgz

    کاموا

    yarn add ./local_packages/gma-mediation-imobile-0.1.0.tgz

  3. اگر برای Android می‌سازید، مخزن زیر را به فایل build.gradle در دایرکتوری android پروژه‌تان اضافه کنید:

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

مرحله ۴: کد اضافی لازم است

Android

برای ادغام i-mobile به کد دیگری نیاز نیست.

iOS

ادغام SKAdNetwork

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

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

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

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

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

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

کدهای خطا

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

Android

قالب نام کلاس
برنما com.google.ads.mediation.imobile.IMobileAdapter
بینابینی com.google.ads.mediation.imobile.IMobileAdapter
بومی com.google.ads.mediation.imobile.IMobileMediationAdapter

iOS

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

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

Android

کد خطا استدلال
0-99 کیت توسعه نرم‌افزار i-mobile خطایی برگرداند. برای جزئیات بیشتر، کد را ببینید.
۱۰۱ i-mobile برای بار کردن آگهی‌ها به بافت Activity نیاز دارد.
102 پارامترهای سرور i-mobile پیکربندی‌شده در AdMob UI وجود ندارد یا نامعتبر است.
103 اندازه آگهی درخواست‌شده با اندازه برنمای پشتیبانی‌شده i-mobile مطابقت ندارد.
104 فراخوان برگشتی بارگیری موفق آگهی بومی i-mobile فهرست آگهی‌های بومی خالی برگرداند.

iOS

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

نسخه 0.1.0

  • نسخهٔ پخش اولیه.