This guide shows you how to use Google Mobile Ads SDK to load and display ads from LINE Ads Network using mediation , covering waterfall integrations. It covers how to add LINE Ads Network to an ad unit's mediation configuration, and how to integrate the LINE Ads Network SDK and adapter into an Android app.
The dashboard interface for LINE Ads Network uses Japanese text for its labels, buttons, and descriptions. The screenshots in this guide have not been translated. In this guide's descriptions and instructions however, labels and buttons are translated with their English language equivalents in parentheses.
ادغامها و قالبهای تبلیغاتی پشتیبانیشده
The mediation adapter for LINE Ads Network has the following capabilities:
| ادغام | |
|---|---|
| مناقصه | |
| آبشار | |
| قالبها | |
| بنر | |
| بینابینی | |
| پاداش داده شده | |
| بومی | ۱ |
۱ تبلیغات بومی (برای پیشنهاد قیمت) در مرحله بتای بسته است، برای درخواست دسترسی با مدیر حساب خود تماس بگیرید.
الزامات
- اندروید API سطح ۲۳ یا بالاتر
جدیدترین Google Mobile Ads SDK
راهنمای شروع میانجیگری را تکمیل کنید
Step 1: Set up configurations in LINE Ads Network UI
ثبت نام کنید و وارد حساب کاربری شبکه تبلیغات LINE خود شوید .
افزودن یک برنامه جدید
کلیک کنید広告枠管理 (مدیریت جایگاه آگهی) >メディア (رسانه) . سپس، روی新規作成 (ایجاد جدید) کلیک کنید.

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

شناسه برنامه را یادداشت کنید.

ایجاد جایگاه تبلیغات
روی شناسه برنامهای که میخواهید محل قرارگیری تبلیغ را اضافه کنید، کلیک کنید. سپس،詳細 (جزئیات) را انتخاب کنید.

رویスロット 追加 (افزودن شکاف) کلیک کنید.

Fill out the form for details about the slot. For Bidding Type , select Standard to configure this slot for waterfall mediation, or Google SDK Bidding to configure this slot for Bidding. Click登録 (Register) once the form is filled.

به شناسه اسلات (Slot ID) توجه کنید.

فایل app-ads.txt خود را بهروزرسانی کنید.
فروشندگان مجاز برنامهها app-ads.txt یک ابتکار آزمایشگاه فناوری IAB است که به شما کمک میکند تا موجودی تبلیغات برنامه خود را فقط از طریق کانالهایی که به عنوان مجاز شناسایی کردهاید، به فروش برسانید. برای جلوگیری از کاهش قابل توجه درآمد تبلیغات، باید یک فایل app-ads.txt پیادهسازی کنید. اگر قبلاً این کار را نکردهاید، یک فایل app-ads.txt برای Ad Manager ایجاد کنید .
To implement app-ads.txt for LINE Ads Network, see About app-ads.txt .
مرحله ۲: تنظیم تقاضای شبکه تبلیغات لاین در رابط کاربری مدیریت تبلیغات
وارد حساب مدیر تبلیغات خود شوید.
شبکه تبلیغات LINE را در شرکتها اضافه کنید
مناقصه
این مرحله برای ادغامهای پیشنهاد قیمت لازم نیست.
آبشار
Navigate to Admin > Companies , then click the New company button in the All companies tab. Select Ad network .

Select LINE Ads Network as the Ad network , enter a unique Name and enable Mediation . Turn on Automatic data collection , and enter the Login name and Password obtained in the previous section.
نیازی به وارد کردن نام کاربری یا رمز عبور نیست. پس از اتمام، روی ذخیره کلیک کنید.

فعال کردن اشتراکگذاری امن سیگنال
مناقصه
به بخش مدیریت > تنظیمات کلی بروید. به برگه تنظیمات حساب Ad Exchange بروید و اشتراکگذاری امن سیگنال را بررسی و فعال کنید. روی ذخیره کلیک کنید.

آبشار
این مرحله برای ادغامهای آبشاری لازم نیست.
سیگنال امن را در درخواستهای پیشنهاد به اشتراک بگذارید
مناقصه
به بخش موجودی > سیگنالهای امن بروید. در زیر سیگنالهای امن ، لاین را جستجو کنید و گزینه فعال کردن ادغام برنامه را فعال کنید.

روی ذخیره کلیک کنید.
آبشار
این مرحله برای ادغامهای آبشاری لازم نیست.
امکان اشتراکگذاری امن سیگنال برای مناقصه SDK
مناقصه
به بخش تحویل > تنظیمات کانال تقاضا بروید. در تب تنظیمات پیشفرض ، گزینه «اجازه اشتراکگذاری امن سیگنال برای پیشنهاد SDK» را فعال کنید.

روی ذخیره کلیک کنید.
آبشار
این مرحله برای ادغامهای آبشاری لازم نیست.
پیکربندی پیشنهاد قیمت شبکه تبلیغات LINE
مناقصه
به مسیر Delivery > Bidders بروید و روی Go to SDK Bidding کلیک کنید.

روی پیشنهاددهنده جدید کلیک کنید.

شبکه تبلیغات LINE را به عنوان پیشنهاد دهنده انتخاب کنید.

برای فعال کردن پیشنهاد قیمت SDK برای این پیشنهاد دهنده، روی ادامه کلیک کنید.

روی انجام شد کلیک کنید.
آبشار
این مرحله برای ادغامهای آبشاری لازم نیست.
پیکربندی نگاشت واحد تبلیغات
مناقصه
به مسیر Delivery > Bidders بروید و روی Go to SDK Bidding کلیک کنید.

شرکت مورد نظر برای شبکه تبلیغات LINE را انتخاب کنید.

به برگه نگاشت واحد تبلیغات بروید و روی نگاشت واحد تبلیغات جدید کلیک کنید.

Choose Specific ad unit . Select an ad unit and format, Mobile app as the Inventory type , and your Mobile application . Then, enter Application ID and Slot ID obtained in the previous section. Finally, click Save .

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

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

شرکتی را که در بخش قبل برای شبکه تبلیغات لاین (LINE Ads Network) ایجاد کردید، انتخاب کنید. در قسمت نوع ادغام (Integration type) ، گزینه Mobile SDK mediation ، در قسمت پلتفرم (Platform) گزینه Android و در قسمت وضعیت (Status )، گزینه Active را انتخاب کنید.
شناسه برنامه و شناسه اسلات که در بخش قبل به دست آوردید و مقدار پیشفرض CPM را وارد کنید. روی ذخیره کلیک کنید.

Note: Automatic data collection takes a few days to gather data before it can accurately calculate a Dynamic CPM value for a mediation network. Once the eCPM can be calculated, it is automatically updated on your behalf.
مرحله ۳: SDK و آداپتور شبکه تبلیغات لاین را وارد کنید
ادغام با اندروید استودیو (توصیه میشود)
در فایل gradle سطح برنامه خود، وابستگیهای پیادهسازی زیر را اضافه کنید:
کاتلین
dependencies { implementation("com.google.android.gms:play-services-ads:24.9.0") implementation("com.google.ads.mediation:line:3.0.1.1") }
گرووی
dependencies { implementation 'com.google.android.gms:play-services-ads:24.9.0' implementation 'com.google.ads.mediation:line:3.0.1.1' }
ادغام دستی
آخرین نسخه فایل
.aarمربوط به LINE Ads Network SDK را دانلود کرده و به پروژه خود اضافه کنید.به آرتیفکتهای آداپتور شبکه LINE Ads در مخزن Maven گوگل بروید. آخرین نسخه را انتخاب کنید، فایل
.aarآداپتور شبکه LINE Ads را دانلود کنید و آن را به پروژه خود اضافه کنید.
مرحله ۴: اضافه کردن کد مورد نیاز
برای ادغام شبکه تبلیغات LINE هیچ کد اضافی لازم نیست.
مرحله ۵: پیادهسازی خود را آزمایش کنید
فعال کردن تبلیغات آزمایشی
مطمئن شوید که دستگاه آزمایشی خود را برای Ad Manager ثبت کردهاید .
The LINE Ads Network adapter contains a helper method to enable test mode for LINE Ads Network. You must set this option before you initialize Google Mobile Ads SDK to ensure they get forwarded properly to the LINE Ads Network SDK.
جاوا
کاتلین
تأیید تبلیغات آزمایشی
برای تأیید اینکه تبلیغات آزمایشی را از شبکه تبلیغات LINE دریافت میکنید، آزمایش منبع تبلیغاتی واحد را در بازرس تبلیغات با استفاده از منبع(های ) تبلیغاتی شبکه تبلیغات LINE (آبشاری ) فعال کنید.
مراحل اختیاری
پارامترهای خاص شبکه
آداپتور شبکه LINE Ads از یک پارامتر درخواست اضافی پشتیبانی میکند که میتواند با استفاده از کلاس LineExtras به آداپتور منتقل شود. سازنده این کلاس شامل پارامترهای زیر است:
-
enableAdSound - یک
booleanبرای مشخص کردن حالت پیشفرض شروع صدا برای تبلیغات بنری، بینابینی و جایزهدار.
در اینجا یک نمونه کد از نحوه ایجاد یک درخواست تبلیغ که این پارامترها را تنظیم میکند، آورده شده است:
جاوا
کاتلین
استفاده از تبلیغات بومی
رندرینگ آگهی
آداپتور شبکه تبلیغات LINE فیلدهای زیر را برای NativeAd پر میکند.
| میدان | داراییهایی که همیشه در آداپتور شبکه LINE Ads گنجانده میشوند |
|---|---|
| تیتر | |
| تصویر | |
| بدن | |
| آیکون برنامه | ۱ |
| فراخوان برای اقدام | |
| رتبهبندی ستارهای | |
| فروشگاه | |
| قیمت |
۱ برای تبلیغات بومی، کیت توسعه نرمافزار شبکه تبلیغات لاین (LINE Ads Network SDK) آیکون برنامه را ارائه نمیدهد. در عوض، آداپتور شبکه تبلیغات لاین (LINE Ads Network) آیکون برنامه را با یک تصویر شفاف پر میکند.
کدهای خطا
اگر آداپتور نتواند تبلیغی از شبکه تبلیغات LINE دریافت کند، میتوانید خطای اساسی را از پاسخ تبلیغ با استفاده ResponseInfo.getAdapterResponses() تحت کلاسهای زیر بررسی کنید:
com.line.ads
com.google.ads.mediation.line.LineMediationAdapter
در اینجا کدها و پیامهای همراه که توسط آداپتور شبکه تبلیغات LINE هنگام عدم بارگیری یک تبلیغ نمایش داده میشوند، آورده شده است:
| کد خطا | دامنه | دلیل |
|---|---|---|
| ۱-۱۰ | com.five_corp.ad | کیت توسعه نرمافزار شبکه تبلیغات لاین (LINE Ads Network SDK) خطایی مربوط به SDK را نشان داد. برای جزئیات بیشتر به مستندات شبکه تبلیغات لاین مراجعه کنید. |
| ۱۰۱ | com.google.ads.mediation.line | شناسه برنامه موجود نیست یا نامعتبر است. |
| ۱۰۲ | com.google.ads.mediation.line | شناسه اسلات نامعتبر یا موجود نیست. |
| ۱۰۳ | com.google.ads.mediation.line | اندازه تبلیغ درخواستی با اندازه بنر تبلیغاتی پشتیبانی شده توسط شبکه تبلیغات لاین مطابقت ندارد. |
| ۱۰۴ | com.google.ads.mediation.line | به دلیل عدم نمایش زمینه فعالیت، بارگذاری تبلیغ بینابینی یا جایزهدار ناموفق بود. |
| ۱۰۵ | com.google.ads.mediation.line | کیت توسعه نرمافزار شبکه تبلیغات لاین (LINE Ads Network SDK) نتوانست تبلیغ بینابینی یا تبلیغ پاداشی را نمایش دهد. |
| ۱۰۶ | com.google.ads.mediation.line | به دلیل فقدان داراییها، بارگذاری تبلیغ بومی ناموفق بود. |
تغییرات آداپتور میانجیگری اندروید LINE
نسخه ۳.۰.۱.۱ (در حال انجام)
- اکنون هنگام استفاده از SDK تبلیغات موبایلی گوگل نسخه ۲۴.۴.۰ یا بالاتر، تعداد نمایش تبلیغات بومی توسط FiveAd SDK بازنویسی میشود.
ساخته و آزمایش شده با:
- نسخه ۲۴.۹.۰ کیت توسعه نرمافزاری تبلیغات موبایلی گوگل.
- نسخه ۳.۰.۱.۰ کیت توسعه نرمافزار FiveAd.
نسخه ۳.۰.۱.۰
- پشتیبانی از ارسال پارامتر tagForUnderAgeOfConsent برای SDK تبلیغات موبایل گوگل به SDK فایو اد اضافه شد.
- سازگاری تأیید شده با FiveAd SDK نسخه ۳.۰.۱.۰.
ساخته و آزمایش شده با:
- نسخه ۲۴.۹.۰ کیت توسعه نرمافزاری تبلیغات موبایلی گوگل.
- نسخه ۳.۰.۱.۰ کیت توسعه نرمافزار FiveAd.
نسخه ۳.۰.۰.۰
- سازگاری تأیید شده با FiveAd SDK نسخه ۳.۰.۰.۰.
ساخته و آزمایش شده با:
- نسخه ۲۴.۹.۰ کیت توسعه نرمافزاری تبلیغات موبایلی گوگل.
- نسخه ۳.۰.۰.۰ کیت توسعه نرمافزار FiveAd.
نسخه ۲.۹.۲۰۲۵۱۰۲۸.۰
- سازگاری تأیید شده با FiveAd SDK نسخه ۲.۹.۲۰۲۵۱۰۲۸.
ساخته و آزمایش شده با:
- نسخه ۲۴.۷.۰ کیت توسعه نرمافزاری تبلیغات موبایلی گوگل.
- نسخه SDK فایو اد ۲.۹.۲۰۲۵۱۰۲۸.۰
نسخه ۲.۹.۲۰۲۵۰۹۲۴.۱
- ارجاعات سطح کلاس به Context حذف شد. میتواند به کاهش مشکلات نشت حافظه کمک کند.
ساخته و آزمایش شده با:
- نسخه ۲۴.۷.۰ کیت توسعه نرمافزاری تبلیغات موبایلی گوگل.
- نسخه SDK فایو اد ۲.۹.۲۰۲۵۰۹۲۴.۱.
نسخه ۲.۹.۲۰۲۵۰۹۲۴.۰
- سازگاری تأیید شده با FiveAd SDK نسخه ۲.۹.۲۰۲۵۰۹۲۴.
ساخته و آزمایش شده با:
- نسخه ۲۴.۶.۰ کیت توسعه نرمافزاری تبلیغات موبایلی گوگل.
- نسخه SDK فایو اد ۲.۹.۲۰۲۵۰۹۲۴.۰
نسخه ۲.۹.۲۰۲۵۰۷۱۸.۰
- سازگاری تأیید شده با FiveAd SDK نسخه ۲.۹.۲۰۲۵۰۷۱۸.
ساخته و آزمایش شده با:
- نسخه ۲۴.۳.۰ کیت توسعه نرمافزاری تبلیغات موبایلی گوگل.
- نسخه SDK فایو اد ۲.۹.۲۰۲۵۰۷۱۸.۰.
نسخه ۲.۹.۲۰۲۵۰۵۱۹.۰
- سازگاری تأیید شده با FiveAd SDK نسخه ۲.۹.۲۰۲۵۰۵۱۹.
ساخته و آزمایش شده با:
- نسخه ۲۴.۳.۰ کیت توسعه نرمافزاری تبلیغات موبایلی گوگل.
- نسخه SDK فایو اد ۲.۹.۲۰۲۵۰۵۱۹.۰.
نسخه ۲.۹.۲۰۲۵۰۳۱۷.۱
- ابعاد بارگذاری بنر برای تبلیغات پیشنهاد قیمت با رابط برنامهنویسی کاربردی جدید FiveAd اصلاح شد.
ساخته و آزمایش شده با:
- نسخه ۲۴.۱.۰ کیت توسعه نرمافزاری تبلیغات موبایلی گوگل.
- نسخه SDK فایو اد ۲.۹.۲۰۲۵۰۳۱۷.۰
نسخه ۲.۹.۲۰۲۵۰۳۱۷.۰
- سازگاری تأیید شده با FiveAd SDK نسخه ۲.۹.۲۰۲۵۰۳۱۷.
ساخته و آزمایش شده با:
- نسخه ۲۴.۱.۰ کیت توسعه نرمافزاری تبلیغات موبایلی گوگل.
- نسخه SDK فایو اد ۲.۹.۲۰۲۵۰۳۱۷.۰
نسخه ۲.۹.۲۰۲۵۰۱۱۰.۱
- حداقل سطح API اندروید مورد نیاز به ۲۳ ارتقا یافت.
- حداقل نسخه مورد نیاز SDK تبلیغات موبایلی گوگل به ۲۴.۰.۰ بهروزرسانی شد.
ساخته و آزمایش شده با:
- نسخه ۲۴.۰.۰ کیت توسعه نرمافزاری تبلیغات موبایلی گوگل.
- نسخه SDK فایو اد ۲.۹.۲۰۲۵۰۱۱۰.۰
نسخه ۲.۹.۲۰۲۵۰۱۱۰.۰
- کلاس
UnifiedNativeAdMapperمنسوخ شده به نفعNativeAdMapperحذف شد. - فرآیند جمعآوری سیگنالهای ثابت
- فرآیند اولیهسازی برای قالبهای تبلیغات آبشاری بینابینی و پاداشی اصلاح شد.
- سازگاری تأیید شده با FiveAd SDK نسخه ۲.۹.۲۰۲۵۰۱۱۰.
ساخته و آزمایش شده با:
- نسخه ۲۳.۶.۰ کیت توسعه نرمافزاری تبلیغات موبایلی گوگل.
- نسخه SDK فایو اد ۲.۹.۲۰۲۵۰۱۱۰.۰
نسخه ۲.۹.۲۰۲۴۱۱۲۹.۰
- پشتیبانی از پیشنهاد قیمت برای قالبهای تبلیغات بنری، بینابینی، پاداشی و بومی اضافه شد.
- سازگاری تأیید شده با FiveAd SDK نسخه ۲.۹.۲۰۲۴۱۱۲۹.
ساخته و آزمایش شده با:
- نسخه ۲۳.۵.۰ کیت توسعه نرمافزاری تبلیغات موبایلی گوگل.
- نسخه SDK فایو اد ۲.۹.۲۰۲۴۱۱۲۹.۰
نسخه ۲.۸.۲۰۲۴۰۸۲۷.۰
- سازگاری تأیید شده با FiveAd SDK نسخه ۲.۸.۲۰۲۴۰۸۲۷.
ساخته و آزمایش شده با:
- نسخه ۲۳.۳.۰ کیت توسعه نرمافزاری تبلیغات موبایلی گوگل.
- نسخه SDK فایو اد ۲.۸.۲۰۲۴۰۸۲۷.۰
نسخه ۲.۸.۲۰۲۴۰۸۰۸.۰
- سازگاری تأیید شده با FiveAd SDK نسخه ۲.۸.۲۰۲۴۰۸۰۸.
ساخته و آزمایش شده با:
- نسخه ۲۳.۲.۰ کیت توسعه نرمافزاری تبلیغات موبایلی گوگل.
- نسخه SDK فایو اد ۲.۸.۲۰۲۴۰۸۰۸.۰
نسخه ۲.۸.۲۰۲۴۰۷۲۲.۰
- سازگاری تأیید شده با FiveAd SDK نسخه ۲.۸.۲۰۲۴۰۷۲۲.
ساخته و آزمایش شده با:
- نسخه ۲۳.۲.۰ کیت توسعه نرمافزاری تبلیغات موبایلی گوگل.
- نسخه SDK فایو اد ۲.۸.۲۰۲۴۰۷۲۲.۰
نسخه ۲.۷.۲۰۲۴۰۵۱۵.۰
- سازگاری تأیید شده با FiveAd SDK نسخه ۲.۷.۲۰۲۴۰۵۱۵.
ساخته و آزمایش شده با:
- نسخه ۲۳.۱.۰ کیت توسعه نرمافزاری تبلیغات موبایلی گوگل.
- نسخه SDK فایو اد ۲.۷.۲۰۲۴۰۵۱۵.۰
نسخه ۲.۷.۲۰۲۴۰۲۱۴.۱
- حداقل نسخه مورد نیاز SDK تبلیغات موبایلی گوگل به ۲۳.۰.۰ بهروزرسانی شد.
- سازگاری تأیید شده با FiveAd SDK نسخه ۲.۷.۲۰۲۴۰۲۱۴.
ساخته و آزمایش شده با:
- نسخه ۲۳.۰.۰ کیت توسعه نرمافزاری تبلیغات موبایلی گوگل.
- نسخه SDK فایو اد ۲.۷.۲۰۲۴۰۲۱۴.۰.
نسخه ۲.۷.۲۰۲۴۰۲۱۴.۰
- سازگاری تأیید شده با FiveAd SDK نسخه ۲.۷.۲۰۲۴۰۲۱۴.
ساخته و آزمایش شده با:
- نسخه ۲۲.۶.۰ کیت توسعه نرمافزاری تبلیغات موبایلی گوگل.
- نسخه SDK فایو اد ۲.۷.۲۰۲۴۰۲۱۴.۰.
نسخه ۲.۷.۲۰۲۴۰۱۲۶.۰
- سازگاری تأیید شده با FiveAd SDK نسخه ۲.۷.۲۰۲۴۰۱۲۶.
ساخته و آزمایش شده با:
- نسخه ۲۲.۶.۰ کیت توسعه نرمافزاری تبلیغات موبایلی گوگل.
- نسخه SDK فایو اد ۲.۷.۲۰۲۴۰۱۲۶.۰.
نسخه ۲.۷.۲۰۲۴۰۱۱۲.۰
-
FiveAdViewEventListenerمنسوخ شده به نفعFiveAdCustomLayoutEventListener،FiveAdVideoRewardEventListener،FiveAdInterstitialEventListenerوFiveAdNativeEventListenerحذف شد. - سازگاری تأیید شده با FiveAd SDK نسخه ۲.۷.۲۰۲۴۰۱۱۲.
- حداقل نسخه مورد نیاز SDK تبلیغات موبایلی گوگل به ۲۲.۶.۰ بهروزرسانی شد.
ساخته و آزمایش شده با:
- نسخه ۲۲.۶.۰ کیت توسعه نرمافزاری تبلیغات موبایلی گوگل.
- نسخه SDK فایو اد ۲.۷.۲۰۲۴۰۱۱۲.
نسخه ۲.۶.۲۰۲۳۰۶۰۷.۱
- کلاس
LineExtrasبرای ناشران اضافه شد تا تنظیمات صدای پیشفرض را برای قالبهای تبلیغات بنری، بینابینی و پاداشی تعریف کنند. - حداقل نسخه مورد نیاز SDK تبلیغات موبایلی گوگل به ۲۲.۴.۰ بهروزرسانی شد.
ساخته و آزمایش شده با:
- نسخه ۲۲.۴.۰ کیت توسعه نرمافزاری تبلیغات موبایلی گوگل.
- نسخه SDK فایو اد ۲.۶.۲۰۲۳۰۶۰۷.
نسخه ۲.۶.۲۰۲۳۰۶۰۷.۰
- انتشار اولیه.
- پشتیبانی از قالبهای تبلیغات بنری، بینابینی، پاداشی و بومی را اضافه میکند.
- سازگاری تأیید شده با FiveAd SDK نسخه ۲.۶.۲۰۲۳۰۶۰۷.
ساخته و آزمایش شده با:
- نسخه ۲۲.۱.۰ کیت توسعه نرمافزاری تبلیغات موبایلی گوگل.
- نسخه SDK فایو اد ۲.۶.۲۰۲۳۰۶۰۷.