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

این راهنما به شما نشان می‌دهد که چگونه از SDK تبلیغات موبایل گوگل برای بارگذاری و نمایش تبلیغات از شبکه تبلیغات لاین با استفاده از AdMob Mediation استفاده کنید و ادغام‌های آبشاری را پوشش می‌دهد. این راهنما نحوه اضافه کردن شبکه تبلیغات لاین به پیکربندی میانجیگری یک واحد تبلیغاتی و نحوه ادغام SDK و آداپتور شبکه تبلیغات لاین در یک برنامه اندروید را پوشش می‌دهد.

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

ادغام‌ها و قالب‌های تبلیغاتی پشتیبانی‌شده

آداپتور میانجیگری برای شبکه تبلیغات LINE دارای قابلیت‌های زیر است:

ادغام
مناقصه
آبشار
قالب‌ها
بنر
بینابینی
پاداش داده شده
بومی ۱

۱ تبلیغات بومی (برای پیشنهاد قیمت) در مرحله بتای بسته است، برای درخواست دسترسی با مدیر حساب خود تماس بگیرید.

الزامات

  • اندروید API سطح ۲۳ یا بالاتر

  • جدیدترین SDK تبلیغات موبایلی گوگل

  • راهنمای شروع میانجیگری را تکمیل کنید

مرحله ۱: تنظیمات را در رابط کاربری شبکه تبلیغات لاین (LINE Ads Network UI) انجام دهید

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

افزودن یک برنامه جدید

کلیک کنید広告枠管理 (مدیریت جایگاه آگهی) >メディア (رسانه) . سپس، روی 新規作成 (ایجاد جدید) کلیک کنید.

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

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

ایجاد جایگاه تبلیغات

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

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

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

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

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

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

برای پیاده‌سازی app-ads.txt برای شبکه تبلیغات LINE، به بخش «درباره app-ads.txt» مراجعه کنید.

مرحله ۲: تنظیم تقاضای شبکه تبلیغات لاین در رابط کاربری ادموب

تنظیمات میانجیگری را برای واحد تبلیغاتی خود پیکربندی کنید

شما باید شبکه تبلیغات لاین (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 و آداپتور شبکه تبلیغات لاین را وارد کنید

در فایل build.gradle.kts سطح برنامه خود، وابستگی‌ها و پیکربندی‌های پیاده‌سازی زیر را اضافه کنید. از آخرین نسخه‌های LINE Ads Network SDK و آداپتور استفاده کنید:

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

ادغام دستی

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

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

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

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

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

فعال کردن تبلیغات آزمایشی

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

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

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

مراحل اختیاری

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

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

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

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

جاوا 

LineExtras lineExtras = new LineExtras(true);
Bundle extras = lineExtras.build();

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

کاتلین 

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

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

استفاده از تبلیغات بومی

رندرینگ آگهی

آداپتور شبکه تبلیغات 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

نسخه ۲.۹.۲۰۲۵۰۹۲۴.۱ (در حال انجام)

  • ارجاعات سطح کلاس به Context حذف شد. می‌تواند به کاهش مشکلات نشت حافظه کمک کند.

نسخه ۲.۹.۲۰۲۵۰۹۲۴.۰

  • سازگاری تأیید شده با 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 فایو اد ۲.۶.۲۰۲۳۰۶۰۷.