ادغام LINE Ads Network با واسطه

شما باید شبکه تبلیغات لاین (LINE Ads Network) را به پیکربندی میانجیگری برای واحد تبلیغاتی خود اضافه کنید.

ابتدا، وارد حساب کاربری AdMob خود شوید. سپس، به برگه Mediation بروید. اگر یک گروه میانجیگری موجود دارید که می‌خواهید آن را تغییر دهید، روی نام آن گروه میانجیگری کلیک کنید تا آن را ویرایش کنید و به مرحله بعد بروید و شبکه تبلیغات LINE را به عنوان منبع تبلیغات اضافه کنید .

برای ایجاد یک گروه میانجیگری جدید، گزینه «ایجاد گروه میانجیگری» را انتخاب کنید.

قالب و پلتفرم تبلیغ خود را وارد کنید، سپس روی ادامه کلیک کنید.

به گروه میانجیگری خود یک نام بدهید و مکان‌هایی را برای هدف قرار دادن انتخاب کنید. در مرحله بعد، وضعیت گروه میانجیگری را روی فعال (Enabled) تنظیم کنید و سپس روی افزودن واحدهای تبلیغاتی (Add Ad Units) کلیک کنید.

این گروه میانجی را با یک یا چند واحد تبلیغاتی AdMob موجود خود مرتبط کنید. سپس روی «انجام شد» کلیک کنید.

اکنون باید کارت واحدهای تبلیغاتی را ببینید که با واحدهای تبلیغاتی که انتخاب کرده‌اید پر شده است:

شبکه تبلیغات LINE را به عنوان منبع تبلیغات اضافه کنید

مناقصه
در قسمت «منابع تبلیغات» ، زیر کارت پیشنهاد قیمت ، گزینه «افزودن منبع تبلیغات» را انتخاب کنید. سپس «شبکه تبلیغات لاین» را انتخاب کنید.

روی نحوه امضای قرارداد مشارکت و تنظیم مشارکت در مناقصه با شبکه تبلیغات LINE کلیک کنید.



روی تأیید و موافقت کلیک کنید، سپس روی ادامه کلیک کنید.



اگر از قبل نقشه‌ای برای شبکه تبلیغات لاین دارید، می‌توانید آن را انتخاب کنید. در غیر این صورت، روی افزودن نقشه کلیک کنید.



در مرحله بعد، شناسه برنامه و شناسه اسلات (Slot ID) که در بخش قبل به دست آورده‌اید را وارد کنید. سپس روی «انجام شد» (Done) کلیک کنید.

آبشار
در زیر کارت Waterfall در بخش Ad Sources ، گزینه Add Ad Source را انتخاب کنید.

شبکه تبلیغات لاین (LINE Ads Network) را انتخاب کنید و کلید بهینه‌سازی (Optimize) را فعال کنید. نام کاربری و رمز عبوری که در بخش قبل به دست آوردید را وارد کنید تا بهینه‌سازی منبع تبلیغات برای شبکه تبلیغات لاین (LINE Ads Network) را تنظیم کنید. سپس یک مقدار eCPM برای شبکه تبلیغات لاین وارد کنید و روی ادامه کلیک کنید.



اگر از قبل نقشه‌ای برای شبکه تبلیغات لاین دارید، می‌توانید آن را انتخاب کنید. در غیر این صورت، روی افزودن نقشه کلیک کنید.

در مرحله بعد، شناسه برنامه و شناسه اسلات (Slot ID) که در بخش قبل به دست آورده‌اید را وارد کنید. سپس روی «انجام شد» (Done) کلیک کنید.

مرحله ۳: SDK و آداپتور شبکه تبلیغات لاین را وارد کنید ادغام با اندروید استودیو (توصیه می‌شود)

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

کاتلین

dependencies {
    implementation("com.google.android.gms:play-services-ads:25.1.0")
    implementation("com.google.ads.mediation:line:3.0.1.2")
}

گرووی

dependencies {
    implementation 'com.google.android.gms:play-services-ads:25.1.0'
    implementation 'com.google.ads.mediation:line:3.0.1.2'
}

ادغام دستی

1. آخرین نسخه فایل .aar مربوط به LINE Ads Network SDK را دانلود کرده و به پروژه خود اضافه کنید.

2. به آرتیفکت‌های آداپتور شبکه LINE Ads در مخزن Maven گوگل بروید. آخرین نسخه را انتخاب کنید، فایل .aar آداپتور شبکه LINE Ads را دانلود کنید و آن را به پروژه خود اضافه کنید.

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

برای ادغام شبکه تبلیغات LINE هیچ کد اضافی لازم نیست.

مرحله ۵: پیاده‌سازی خود را آزمایش کنید فعال کردن تبلیغات آزمایشی

مطمئن شوید که دستگاه آزمایشی خود را برای AdMob ثبت کرده‌اید .

آداپتور شبکه تبلیغات LINE شامل یک متد کمکی برای فعال کردن حالت آزمایشی برای شبکه تبلیغات LINE است. شما باید این گزینه را قبل از مقداردهی اولیه Google Mobile Ads SDK تنظیم کنید تا از ارسال صحیح آنها به SDK شبکه تبلیغات LINE اطمینان حاصل شود.

جاوا

LineMediationAdapter.Companion.setTestMode(true);
LineMediationSnippets.java

کاتلین

LineMediationAdapter.setTestMode(true)
LineMediationSnippets.kt

تأیید تبلیغات آزمایشی

برای تأیید اینکه تبلیغات آزمایشی را از شبکه تبلیغات LINE دریافت می‌کنید، آزمایش منبع تبلیغاتی واحد را در بازرس تبلیغات با استفاده از منبع(های ) تبلیغاتی شبکه تبلیغات LINE (آبشاری ) فعال کنید.

مراحل اختیاری پارامترهای خاص شبکه

آداپتور شبکه LINE Ads از یک پارامتر درخواست اضافی پشتیبانی می‌کند که می‌تواند با استفاده از کلاس LineExtras به آداپتور منتقل شود. سازنده این کلاس شامل پارامترهای زیر است:

enableAdSound

یک boolean برای مشخص کردن حالت پیش‌فرض شروع صدا برای تبلیغات بنری، بینابینی و جایزه‌دار.

در اینجا یک نمونه کد از نحوه ایجاد یک درخواست تبلیغ که این پارامترها را تنظیم می‌کند، آورده شده است:

جاوا

LineExtras lineExtras = new LineExtras(/* enableAdSound: */ true);
Bundle extras = lineExtras.build();

AdRequest request =
    new AdRequest.Builder().addNetworkExtrasBundle(LineMediationAdapter.class, extras).build();
LineMediationSnippets.java

کاتلین

val lineExtras = LineExtras(enableAdSound = true)
val extras = lineExtras.build()

val request =
  AdRequest.Builder().addNetworkExtrasBundle(LineMediationAdapter::class.java, extras).build()
LineMediationSnippets.kt

استفاده از تبلیغات بومی رندرینگ آگهی

آداپتور شبکه تبلیغات 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 نسخه ۳.۱.۰.۰ (در حال انجام)

• ویژگی برای ساخت آداپتور با وابستگی به GMA Next-Gen SDK اضافه شد.

نسخه ۳.۰.۱.۲

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

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

نسخه ۳.۰.۱.۱

• اکنون هنگام استفاده از 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 فایو اد ۲.۶.۲۰۲۳۰۶۰۷.