این راهنما به شما نشان میدهد که چگونه از Google Mobile Ads Unity Plugin برای بارگذاری و نمایش تبلیغات از شبکه تبلیغات LINE با استفاده از میانجیگری استفاده کنید، و ادغامهای آبشاری را پوشش میدهد. این راهنما نحوه اضافه کردن شبکه تبلیغات LINE به پیکربندی میانجیگری یک واحد تبلیغاتی و نحوه ادغام SDK و آداپتور شبکه تبلیغات LINE در یک برنامه Unity را پوشش میدهد.
ادغامها و قالبهای تبلیغاتی پشتیبانیشده
The Ad Manager mediation adapter for LINE Ads Network has the following capabilities:
| ادغام | |
|---|---|
| مناقصه | |
| آبشار | |
| قالبها | |
| بنر | |
| بینابینی | |
| پاداش داده شده | |
الزامات
- آخرین Google Mobile Ads Unity Plugin
- یونیتی ۴ یا بالاتر
- [For bidding]: To integrate all supported ad formats in bidding, use Google Mobile Ads mediation plugin for LINE Ads SDK 1.5.0 or higher ( latest version recommended )
- برای نصب روی اندروید
- اندروید API سطح ۲۳ یا بالاتر
- برای استقرار در iOS
- هدف استقرار iOS 13.0 یا بالاتر
- یک پروژه یونیتی فعال که با Google Mobile Ads Unity Plugin پیکربندی شده است. برای جزئیات بیشتر به بخش «راهاندازی Google Mobile Ads Unity Plugin مراجعه کنید.
- میانجیگری را تنظیم کنید .
Step 1: Set up configurations in LINE Ads Network UI
Sign up and log in to your LINE Ads Network account.
افزودن یک برنامه جدید
به برگهアプリ (برنامه) بروید و روی دکمه新規登録 (ثبت نام جدید) کلیک کنید.

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

به شناسهアプリ (شناسه برنامه) توجه داشته باشید.
اندروید

آیاواس

ایجاد جایگاه تبلیغاتی
در برگهアプリ (برنامه) ، برنامه خود را برای مشاهده جزئیات برنامه خود انتخاب کنید. در بخشスロット (اسلات) ، روی (افزودن) کلیک کنید.

برای جزئیات بیشتر در مورد اسلات، فرم را پر کنید. برای نوع پیشنهاد ، گزینه استاندارد را برای پیکربندی این اسلات برای میانجیگری آبشاری یا گزینه Google SDK Bidding را برای پیکربندی این اسلات برای پیشنهاد انتخاب کنید. پس از پر کردن فرم ، روی «ایجاد» کلیک کنید.

به شناسهスロットشناسه (شناسه شکاف) توجه داشته باشید.

فایل app-ads.txt خود را بهروزرسانی کنید.
فروشندگان مجاز برنامهها app-ads.txt یک ابتکار آزمایشگاه فناوری IAB است که به شما کمک میکند تا موجودی تبلیغات برنامه خود را فقط از طریق کانالهایی که به عنوان مجاز شناسایی کردهاید، به فروش برسانید. برای جلوگیری از کاهش قابل توجه درآمد تبلیغات، باید یک فایل app-ads.txt پیادهسازی کنید. اگر قبلاً این کار را نکردهاید، یک فایل app-ads.txt برای Ad Manager ایجاد کنید .
برای پیادهسازی app-ads.txt برای شبکه تبلیغات LINE، به «درباره app-ads.txt» مراجعه کنید.
مرحله ۲: تنظیم تقاضای شبکه تبلیغات لاین در رابط کاربری مدیریت تبلیغات
تنظیمات میانجیگری را برای واحد تبلیغاتی خود پیکربندی کنید
اندروید
برای دستورالعملها، به مرحله ۲ در راهنمای اندروید مراجعه کنید.
آیاواس
برای دستورالعملها، به مرحله ۲ در راهنمای iOS مراجعه کنید.
مرحله ۳: SDK و آداپتور شبکه تبلیغات لاین را وارد کنید
رابط خط فرمان OpenUPM
اگر OpenUPM-CLI را نصب کردهاید، میتوانید افزونهی Google Mobile Ads LINE Ads Network Mediation را برای Unity با اجرای دستور زیر از دایرکتوری ریشهی پروژهتان، روی پروژهتان نصب کنید:
openupm add com.google.ads.mobile.mediation.lineاوپنیوپیام
در ویرایشگر پروژه یونیتی خود، گزینه Edit > Project Settings > Package Manager را انتخاب کنید تا تنظیمات Unity Package Manager باز شود.
در زیر تب Scoped Registries ، OpenUPM را به عنوان یک رجیستری Scoped با جزئیات زیر اضافه کنید:
- نام:
OpenUPM - آدرس اینترنتی:
https://package.openupm.com - محدوده(ها):
com.google

سپس، به مسیر Window > Package Manager بروید تا Unity Package Manager باز شود و از منوی کشویی، My Registrys را انتخاب کنید.

بستهی Google Mobile Ads Line Mediation را انتخاب کرده و روی نصب کلیک کنید.

بسته یونیتی
آخرین نسخه افزونه Google Mobile Ads mediation برای شبکه تبلیغات لاین را از لینک دانلود موجود در Changelog دانلود کنید و بسته GoogleMobileAdsLineMediation.unitypackage را از فایل زیپ استخراج کنید.
در ویرایشگر پروژه Unity خود، Assets > Import Package > Custom Package را انتخاب کنید و فایل GoogleMobileAdsLineMediation.unitypackage را که دانلود کردهاید، پیدا کنید. مطمئن شوید که همه فایلها انتخاب شدهاند و روی Import کلیک کنید.

سپس، Assets > External Dependency Manager > Android Resolver > Force Resolve را انتخاب کنید. کتابخانه External Dependency Manager تجزیه و تحلیل وابستگیها را از ابتدا انجام میدهد و وابستگیهای اعلام شده را در پوشه Assets/Plugins/Android برنامه Unity شما کپی میکند.

مرحله ۴: اضافه کردن کد مورد نیاز
اندروید
برای ادغام شبکه تبلیغات LINE هیچ کد اضافی لازم نیست.
آیاواس
ادغام شبکه SKAd
برای افزودن شناسههای SKAdNetwork به فایل Info.plist پروژه خود، مستندات شبکه تبلیغات LINE را دنبال کنید.
مرحله ۵: پیادهسازی خود را آزمایش کنید
فعال کردن تبلیغات آزمایشی
مطمئن شوید که دستگاه آزمایشی خود را برای Ad Manager ثبت کردهاید .
تأیید تبلیغات آزمایشی
برای تأیید اینکه تبلیغات آزمایشی را از شبکه تبلیغات LINE دریافت میکنید، آزمایش منبع تبلیغاتی واحد را در بازرس تبلیغات با استفاده از منبع(های ) تبلیغاتی شبکه تبلیغات LINE (آبشاری ) فعال کنید.
مراحل اختیاری
پارامترهای خاص شبکه
افزونه میانجیگری LINE Ads Network Unity از پارامتر درخواست اضافی زیر پشتیبانی میکند که میتواند از طریق کلاس LineMediationExtras به آداپتور منتقل شود:
-
SetEnableAdSound(boolean): حالت پیشفرض شروع صدای تبلیغات بنری، بینابینی و جایزهدار را مشخص میکند.
Here's a code example of how to create an ad request that sets these parameters:
using GoogleMobileAds.Api;
using GoogleMobileAds.Mediation.Line.Api;
// ...
var adRequest = new AdRequest();
var lineExtras = new LineMediationExtras();
lineExtras.SetEnableAdSound(true);
adRequest.MediationExtras.Add(lineExtras);
کدهای خطا
If the adapter fails to receive an ad from LINE Ads Network, publishers can check the underlying error from the ad response using ResponseInfo under the following classes:
اندروید
com.line.ads
com.google.ads.mediation.line.LineMediationAdapter
آیاواس
GADMediationAdapterLine
Here are the codes and accompanying messages thrown by the LINE Ads Network adapter when an ad fails to load:
اندروید
| کد خطا | دامنه | دلیل |
|---|---|---|
| ۱-۱۰ | com.five_corp.ad | کیت توسعه نرمافزار شبکه تبلیغات لاین (LINE Ads Network SDK) خطایی مربوط به SDK را نشان داد. برای جزئیات بیشتر به مستندات شبکه تبلیغات لاین مراجعه کنید. |
| ۱۰۱ | com.google.ads.mediation.line | شناسه برنامه موجود نیست یا نامعتبر است. |
| ۱۰۲ | com.google.ads.mediation.line | شناسه اسلات نامعتبر یا موجود نیست. |
| ۱۰۳ | com.google.ads.mediation.line | The requested ad size does not match a LINE Ads Network supported banner ad size. |
| ۱۰۴ | com.google.ads.mediation.line | Failed to load an interstitial or rewarded ad due to missing activity context. |
| ۱۰۵ | com.google.ads.mediation.line | کیت توسعه نرمافزار شبکه تبلیغات لاین (LINE Ads Network SDK) نتوانست تبلیغ بینابینی یا تبلیغ پاداشی را نمایش دهد. |
| ۱۰۶ | com.google.ads.mediation.line | Failed to load a native ad due to missing assets. |
آیاواس
| کد خطا | دامنه | دلیل |
|---|---|---|
| ۱-۱۰ | ارسال شده توسط SDK شبکه تبلیغات لاین | کیت توسعه نرمافزار شبکه تبلیغات لاین (LINE Ads Network SDK) خطایی مربوط به SDK را نشان داد. برای جزئیات بیشتر به مستندات شبکه تبلیغات لاین مراجعه کنید. |
| ۱۰۱ | com.google.ads.mediation.line | Invalid server parameters (eg Missing Application ID or Slot ID). |
| ۱۰۲ | com.google.ads.mediation.line | The requested ad size does not match a LINE Ads Network supported banner ad size. |
| ۱۰۳ | com.google.ads.mediation.line | Failed to load an information icon image asset in native ad. |
تغییرات افزونه میانجیگری Line Unity
نسخه ۲.۰.۲
- از آداپتور اندروید لاین نسخه ۳.۰.۱.۱ پشتیبانی میکند.
- از آداپتور Line iOS نسخه ۳.۰.۱.۰ پشتیبانی میکند.
- ساخته و آزمایش شده با افزونه Google Mobile Ads Unity نسخه ۱۱.۰.۰.
نسخه ۲.۰.۱
- از آداپتور اندروید لاین نسخه ۳.۰.۱.۱ پشتیبانی میکند.
- از آداپتور Line iOS نسخه ۳.۰.۰.۱ پشتیبانی میکند.
- ساخته و آزمایش شده با افزونه Google Mobile Ads Unity نسخه ۱۱.۰.۰.
نسخه ۲.۰.۰
- از آداپتور اندروید لاین نسخه ۳.۰.۱.۰ پشتیبانی میکند.
- از آداپتور Line iOS نسخه ۳.۰.۰.۰ پشتیبانی میکند.
- ساخته و آزمایش شده با افزونه Google Mobile Ads Unity نسخه ۱۰.۷.۰.
نسخه ۱.۵.۱۰
- Supports Line Android adapter version 2.9.20251028.0 .
- Supports Line iOS adapter version 2.9.20251119.0 .
- ساخته و آزمایش شده با افزونه Google Mobile Ads Unity نسخه ۱۰.۶.۰.
نسخه ۱.۵.۹
- پشتیبانی از آداپتور اندروید لاین نسخه ۲.۹.۲۰۲۵۱۰۲۸.۰ .
- Supports Line iOS adapter version 2.9.20250930.0 .
- ساخته و آزمایش شده با افزونه Google Mobile Ads Unity نسخه ۱۰.۶.۰.
نسخه ۱.۵.۸
- از آداپتور اندروید لاین نسخه ۲.۹.۲۰۲۵۰۹۲۴.۱ پشتیبانی میکند.
- Supports Line iOS adapter version 2.9.20250930.0 .
- ساخته و آزمایش شده با افزونه Google Mobile Ads Unity نسخه ۱۰.۵.۰.
نسخه ۱.۵.۷
- Supports Line Android adapter version 2.9.20250924.0 .
- پشتیبانی از آداپتور Line iOS نسخه ۲.۹.۲۰۲۵۰۹۱۲.۰ .
- ساخته و آزمایش شده با افزونه Google Mobile Ads Unity نسخه ۱۰.۵.۰.
نسخه ۱.۵.۶
- پشتیبانی از آداپتور اندروید لاین نسخه ۲.۹.۲۰۲۵۰۷۱۸.۰ .
- Supports Line iOS adapter version 2.9.20250512.0 .
- ساخته و آزمایش شده با افزونه Google Mobile Ads Unity نسخه ۱۰.۳.۰.
نسخه ۱.۵.۵
- مشکلی که باعث میشد نصب از طریق OpenUPM باعث شود افزونه بستهها را به درستی وارد نکند، برطرف شد.
نسخه ۱.۵.۴
- Supports Line Android adapter version 2.9.20250519.0 .
- Supports Line iOS adapter version 2.9.20250512.0 .
- ساخته و آزمایش شده با افزونه Google Mobile Ads Unity نسخه ۱۰.۱.۰.
نسخه ۱.۵.۳
- افزونه Unity اکنون با Android SDK 35 ساخته شده است.
- از آداپتور اندروید لاین نسخه ۲.۹.۲۰۲۵۰۳۱۷.۱ پشتیبانی میکند.
- پشتیبانی از آداپتور Line iOS نسخه ۲.۹.۲۰۲۴۱۱۰۶.۳ .
- ساخته و آزمایش شده با افزونه Google Mobile Ads Unity نسخه ۱۰.۱.۰.
نسخه ۱.۵.۲
- پشتیبانی از آداپتور اندروید لاین نسخه ۲.۹.۲۰۲۵۰۱۱۰.۰ .
- پشتیبانی از آداپتور Line iOS نسخه ۲.۹.۲۰۲۴۱۱۰۶.۲ .
- ساخته و آزمایش شده با افزونه Google Mobile Ads Unity نسخه ۱۰.۰.۰.
نسخه ۱.۵.۱
- Supports Line Android adapter version 2.9.20250110.0 .
- از آداپتور Line iOS نسخه ۲.۹.۲۰۲۴۱۱۰۶.۱ پشتیبانی میکند.
- ساخته و آزمایش شده با افزونه Google Mobile Ads Unity نسخه ۹.۵.۰.
نسخه ۱.۵.۰
- از آداپتور اندروید لاین نسخه ۲.۹.۲۰۲۴۱۱۲۹.۰ پشتیبانی میکند.
- از آداپتور Line iOS نسخه ۲.۹.۲۰۲۴۱۱۰۶.۱ پشتیبانی میکند.
- ساخته و آزمایش شده با افزونه Google Mobile Ads Unity نسخه ۹.۵.۰.
نسخه ۱.۴.۰
- پشتیبانی از آداپتور اندروید لاین نسخه ۲.۸.۲۰۲۴۰۸۲۷.۰ .
- از آداپتور Line iOS نسخه ۲.۹.۲۰۲۴۱۱۰۶.۱ پشتیبانی میکند.
- ساخته و آزمایش شده با افزونه Google Mobile Ads Unity نسخه ۹.۴.۰.
نسخه ۱.۳.۱
- پشتیبانی از آداپتور اندروید لاین نسخه ۲.۸.۲۰۲۴۰۸۰۸.۰ .
- از آداپتور Line iOS نسخه ۲.۸.۲۰۲۴۰۶۱۲.۰ پشتیبانی میکند.
- ساخته و آزمایش شده با افزونه Google Mobile Ads Unity نسخه ۹.۲.۰.
نسخه ۱.۳.۰
- Supports Line Android adapter version 2.8.20240722.0 .
- Supports Line iOS adapter version 2.8.20240612.0 .
- ساخته و آزمایش شده با افزونه Google Mobile Ads Unity نسخه ۹.۲.۰.
نسخه ۱.۲.۰
- Supports Line Android adapter version 2.7.20240515.0 .
- از آداپتور Line iOS نسخه ۲.۸.۲۰۲۴۰۶۱۲.۰ پشتیبانی میکند.
- ساخته و آزمایش شده با افزونه Google Mobile Ads Unity نسخه ۹.۱.۱.
نسخه ۱.۱.۲
- پشتیبانی از آداپتور اندروید لاین نسخه ۲.۷.۲۰۲۴۰۵۱۵.۰ .
- Supports Line iOS adapter version 2.7.20240411.0 .
- ساخته و آزمایش شده با افزونه Google Mobile Ads Unity نسخه ۹.۱.۰.
نسخه ۱.۱.۱
- از آداپتور اندروید لاین نسخه ۲.۷.۲۰۲۴۰۲۱۴.۱ پشتیبانی میکند.
- از آداپتور Line iOS نسخه ۲.۷.۲۰۲۴۰۴۱۱.۰ پشتیبانی میکند.
- ساخته و آزمایش شده با افزونه Google Mobile Ads Unity نسخه ۹.۱.۰.
نسخه ۱.۱.۰
- کلاس
LineMediationExtrasبا متدهای زیر برای پشتیبانی از ارسال اضافات میانجیگری اضافه شد.-
SetEnabledAdSound(bool)
-
- از آداپتور اندروید لاین نسخه ۲.۷.۲۰۲۴۰۲۱۴.۱ پشتیبانی میکند.
- از آداپتور Line iOS نسخه ۲.۷.۲۰۲۴۰۳۱۸.۰ پشتیبانی میکند.
- ساخته و آزمایش شده با افزونه Google Mobile Ads Unity نسخه ۹.۰.۰.
نسخه ۱.۰.۰
- انتشار اولیه.
- پشتیبانی از آداپتور اندروید لاین نسخه ۲.۶.۲۰۲۳۰۶۰۷.۰
- از آداپتور Line iOS نسخه ۲.۶.۲۰۲۳۰۶۰۹.۰ پشتیبانی میکند.
- ساخته و آزمایش شده با افزونه Google Mobile Ads Unity نسخه ۸.۵.۱.