این راهنما به شما نشان می‌دهد که چگونه از Google Mobile Ads SDK for React Native برای بار کردن و نمایش دادن آگهی‌های LY Ads Network بااستفاده از میانجی‌گری استفاده کنید، و ادغام‌های آبشاری را پوشش می‌دهد. این راهنما نحوه افزودن LY Ads Network به پیکربندی میانجی‌گری واحد آگهی و نحوه ادغام کیت توسعه نرم‌افزار و آداپتور LY Ads Network در برنامه React Native را پوشش می‌دهد.
یکپارچه‌سازی‌ها و قالب‌های آگهی پشتیبانی‌شده
آداپتور واسطه‌گری AdMob برای LY Ads Network قابلیت‌های زیر را دارد:
| یکپارچه‌سازی | |
|---|---|
| پیشنهاد قیمت | |
| آبشار | |
| قالب‌ها | |
| صفحه باز شدن برنامه | |
| برنما | |
| بینابینی | |
| پاداش | |
| بینابینی پاداش‌دار | |
| بومی | |
پیش‌نیازها
قبل‌از ادامه دادن، موارد زیر را تأیید کنید:
- جدیدترین نسخه Google Mobile Ads SDK for React Native.
- چارچوب React Native نسخه ۰.۸۵.۰ یا جدیدتر.
- برای استقرار در Android
- Android API سطح ۲۴ یا بالاتر.
- برای استقرار در iOS
- هدف استقرار iOS نسخه ۱۳.۰ یا جدیدتر.
- یک پروژه React Native فعال که با Google Mobile Ads SDK for React Native پیکربندی شده است. برای جزئیات،
راه‌اندازی Google Mobile Ads SDK for React Native را ببینید.
- مطمئن شوید پوشه
adaptersرا از پوشهgma-sdk-react-nativeبارگیری و استخراج کرده‌اید. اگر پوشهadaptersرا ندارید، مراحل یک، دو، و سه را در نصب Google Mobile Ads SDK for React Native دنبال کنید.
- مطمئن شوید پوشه
- واسطه‌گری AdMob را راه‌اندازی کنید.
مرحله ۱: راه‌اندازی پیکربندی‌ها در واسط کاربر شبکه آگهی‌های LY
ثبت‌نام کنید و به سیستم حساب LY Ads Network خود وارد شوید.
افزودن برنامه جدید
به برگه برنامه بروید و روی دکمه ثبت‌نام جدید کلیک کنید.
فرم را تکمیل کنید و روی ثبت‌نام کلیک کنید.
شناسه برنامه را یادداشت کنید.
Android
iOS
ایجاد جایگاه آگهی
در برگه برنامه، برنامه‌تان را انتخاب کنید تا جزئیات آن را ببینید. در بخش جایگاه، روی افزودن کلیک کنید.
برای دریافت جزئیات درباره جایگاه، فرم را تکمیل کنید. برای نوع پیشنهاد قیمت، استاندارد را برای پیکربندی این جایگاه برای میانجی‌گری آبشاری، یا پیشنهاد قیمت کیت توسعه نرم‌افزار Google را برای پیکربندی این جایگاه برای «پیشنهاد قیمت» انتخاب کنید. پس‌از تکمیل فرم، روی ایجاد کلیک کنید.
شناسه جایگاه را یادداشت کنید.
پس‌از ایجاد اولین جایگاه، روی بازبینی در صفحه جزئیات برنامه‌تان کلیک کنید تا تأییدیه را از «شبکه آگهی‌های LY» دریافت کنید. ممکن است این کار مدتی طول بکشد. اگر سؤالی دارید، با نماینده شبکه آگهی‌های LY تماس بگیرید.
ایجاد کلید میانای برنامه‌سازی کاربردی گزارش‌دهی
به برگه مدیریت کلیدهای میانای برنامه‌سازی کاربردی گزارش‌دهی بروید و روی دکمه ایجاد کلید میانای برنامه‌سازی کاربردی کلیک کنید.
فرم را پر کنید و روی ذخیره کلیک کنید.
شناسه کلید میانای برنامه‌سازی کاربردی و رمز کلید میانای برنامه‌سازی کاربردی را یادداشت کنید.
فایل app-ads.txt خود را به‌روز کنید
فروشندگان مجاز برای برنامه‌ها (app-ads.txt) ابتکاری از IAB Tech Lab است که کمک می‌کند مطمئن شوید
فضای آگهی برنامه شما فقط ازطریق کانال‌هایی که به‌عنوان مجاز شناسایی کرده‌اید فروخته می‌شود. برای جلوگیری از
افت قابل‌توجه در درآمد آگهی، باید فایل app-ads.txt را پیاده‌سازی کنید.
اگر قبلاً این کار را نکرده‌اید،
فایل app-ads.txt را برای برنامه‌تان راه‌اندازی کنید.
برای پیاده‌سازی app-ads.txt برای «شبکه آگهی‌های LY»، به
درباره app-ads.txt مراجعه کنید.
مرحله ۲: راه‌اندازی کردن تقاضای LY Ads Network در واسط کاربر AdMob
پیکربندی تنظیمات میانجی‌گری برای واحد آگهی
Android
برای دستورالعمل‌ها، مرحله ۲ را در راهنمای Android ببینید.
iOS
برای دستورالعمل‌ها، به مرحله ۲ در راهنمای iOS مراجعه کنید.
مرحله ۳: وارد کردن آداپتور و کیت توسعه نرم‌افزار شبکه آگهی LY
در دایرکتوری ریشه پروژه‌تان، آداپتور میانجی‌گری Google Mobile Ads SDK for React Native را برای «شبکه آگهی‌های LY» نصب کنید. موارد زیر را تکمیل کنید:
فایل tar آداپتور Google Mobile Ads SDK for React Native را از دایرکتوری
gma-sdk-react-native/adapters/line/در دایرکتوریlocal_packages/پروژه‌تان کپی کنید. اگر پوشهadaptersرا ندارید، پیش‌نیازها را ببینید.mkdir -p local_packages cp EXTRACT_DIR/gma-sdk-react-native/adapters/line/gma-mediation-line-0.1.0.tgz local_packages/EXTRACT_DIR را با مسیر دایرکتوری‌ای که بایگانی را در آن استخراج کرده‌اید جایگزین کنید.
بسته آداپتور را بااستفاده از مدیر بسته ترجیحی‌تان نصب کنید:
npm
npm install ./local_packages/gma-mediation-line-0.1.0.tgzکاموا
yarn add ./local_packages/gma-mediation-line-0.1.0.tgz
مرحله ۴: افزودن کد لازم
Android
برای ادغام «شبکه آگهی‌های LY» به کد اضافی نیاز نیست.
iOS
ادغام SKAdNetwork
اسناد LY Ads Network را دنبال کنید
تا شناسه‌های SKAdNetwork را به فایل Info.plist پروژه‌تان اضافه کنید.
مرحله ۵: آزمایش کردن پیاده‌سازی
فعال کردن آگهی‌های آزمایشی
مطمئن شوید دستگاه آزمایشی‌تان را برای AdMob ثبت کرده‌اید.
درستی‌سنجی آگهی‌های آزمایشی
برای تأیید اینکه آگهی‌های آزمایشی را از LY Ads Network دریافت می‌کنید، آزمایش منبع آگهی تکی را در بازرس آگهی بااستفاده از منبع(های) آگهی LY Ads Network فعال کنید.
مراحل اختیاری
پارامترهای مختص شبکه
افزونه میانجی‌گری LY Ads Network React Native از پارامتر درخواست اضافی زیر پشتیبانی می‌کند که می‌تواند ازطریق کلاس LineMediationExtras به آداپتور ارسال شود:
-
enableAdSound: وضعیت شروع صدای پیش‌فرض آگهی‌های تمام‌صفحه، پاداشی، و برنمایشی را مشخص می‌کند.
در اینجا نمونه کدی برای نحوه ایجاد درخواست آگهی که این پارامترها را تنظیم می‌کند آورده شده است:
import { LineMediationExtras } from '@google/gma-mediation-line';
const request = {
// ...
mediationExtras: [
new LineMediationExtras({
enableAdSound: true,
}),
],
};
کدهای خطا
اگر آداپتور نتواند آگهی را از LY Ads Network دریافت کند،
ناشران می‌توانند خطای اصلی را از پاسخ آگهی بااستفاده از
ResponseInfo تحت کلاس‌های زیر بررسی کنند:
Android
com.line.ads
com.google.ads.mediation.line.LineMediationAdapter
iOS
GADMediationAdapterLine
در اینجا کدها و پیام‌های همراهی که توسط آداپتور شبکه آگهی‌های LY هنگام بارگیری نشدن آگهی ارسال می‌شوند، آورده شده است:
Android
| کد خطا | دامنه | استدلال |
|---|---|---|
| ۱-۱۰ | com.five_corp.ad | کیت توسعه نرم‌افزار LY Ads Network خطایی مختص کیت توسعه نرم‌افزار برگرداند. برای جزئیات بیشتر، اسناد LY Ads Network را ببینید. |
| ۱۰۱ | com.google.ads.mediation.line | شناسه برنامه وجود ندارد یا نامعتبر است. |
| 102 | com.google.ads.mediation.line | شناسه جایگاه وجود ندارد یا نامعتبر است. |
| 103 | com.google.ads.mediation.line | اندازه آگهی درخواستی با اندازه آگهی برنمای پشتیبانی‌شده در «شبکه آگهی‌های LY» مطابقت ندارد. |
| 104 | com.google.ads.mediation.line | به‌دلیل نبودن بافت فعالیت، آگهی تمام‌صفحه یا پاداش‌دار بار نشد. |
| ۱۰۵ | com.google.ads.mediation.line | کیت توسعه نرم‌افزار LY Ads Network نتوانست آگهی بینابینی یا پاداشی را نشان دهد. |
| 106 | com.google.ads.mediation.line | آگهی بومی به‌دلیل نبود دارایی‌ها بار نشد. |
| 107 | com.google.ads.mediation.line | کیت توسعه نرم‌افزار FiveAd بارکننده آگهی تهی برگرداند. |
iOS
| کد خطا | دامنه | استدلال |
|---|---|---|
| ۱-۱۰ | ارسال‌شده توسط LY Ads Network SDK | کیت توسعه نرم‌افزار LY Ads Network خطایی مختص کیت توسعه نرم‌افزار برگرداند. برای جزئیات بیشتر، اسناد LY Ads Network را ببینید. |
| ۱۰۱ | com.google.ads.mediation.line | پارامترهای سرور نامعتبر است (مثلاً شناسه برنامه یا شناسه جایگاه وجود ندارد). |
| 102 | com.google.ads.mediation.line | اندازه آگهی درخواستی با اندازه آگهی برنمای پشتیبانی‌شده در «شبکه آگهی‌های LY» مطابقت ندارد. |
| 103 | com.google.ads.mediation.line | بار کردن دارایی تصویر نماد اطلاعات در آگهی بومی ناموفق بود. |
| 104 | com.google.ads.mediation.line | سیگنال‌های پیشنهاد قیمت جمع‌آوری نشد. |
| ۱۰۵ | com.google.ads.mediation.line | مقداردهی اولیه بارکننده آگهی LINE Ads SDK ناموفق بود. |
نسخه 0.1.0
- نسخهٔ پخش اولیه.
- از نسخه ۳.۱.۱.۲ آداپتور LINE Android پشتیبانی می‌کند.
- از آداپتور LINE iOS نسخه ۳.۱.۱.۰ پشتیبانی می‌کند.
- بااستفاده از «افزونه React Native تبلیغات Google در تلفن همراه» نسخه ۰.۱.۰ ساخته و آزمایش شده است.