این راهنما به شما نشان می‌دهد که چگونه از SDK تبلیغات موبایل گوگل برای بارگذاری و نمایش تبلیغات از شبکه تبلیغات لاین با استفاده از میانجیگری استفاده کنید و ادغام‌های آبشاری را پوشش می‌دهد. این راهنما نحوه اضافه کردن شبکه تبلیغات لاین به پیکربندی میانجیگری یک واحد تبلیغاتی و نحوه ادغام 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 برای Ad Manager ایجاد کنید .
برای پیاده‌سازی app-ads.txt برای شبکه تبلیغات LINE، به بخش «درباره app-ads.txt» مراجعه کنید.
مرحله ۲: تنظیم تقاضای شبکه تبلیغات لاین در رابط کاربری مدیریت تبلیغات
وارد حساب مدیر تبلیغات خود شوید.
شبکه تبلیغات LINE را در شرکت‌ها اضافه کنید
مناقصه
این مرحله برای ادغام‌های پیشنهاد قیمت لازم نیست.
آبشار
به بخش مدیریت > شرکت‌ها بروید، سپس در تب «همه شرکت‌ها» روی دکمه «شرکت جدید» کلیک کنید. شبکه تبلیغاتی را انتخاب کنید.
شبکه تبلیغات لاین (LINE Ads Network) را به عنوان شبکه تبلیغات انتخاب کنید، یک نام منحصر به فرد وارد کنید و میانجیگری (Mediation) را فعال کنید. جمع‌آوری خودکار داده‌ها را فعال کنید و نام کاربری و رمز عبوری که در بخش قبل به دست آورده‌اید را وارد کنید.
نیازی به وارد کردن نام کاربری یا رمز عبور نیست. پس از اتمام، روی ذخیره کلیک کنید.
فعال کردن اشتراک‌گذاری امن سیگنال
مناقصه
به بخش مدیریت > تنظیمات کلی بروید. به برگه تنظیمات حساب Ad Exchange بروید و اشتراک‌گذاری امن سیگنال را بررسی و فعال کنید. روی ذخیره کلیک کنید.
آبشار
این مرحله برای ادغام‌های آبشاری لازم نیست.
سیگنال امن را در درخواست‌های پیشنهاد به اشتراک بگذارید
مناقصه
به بخش موجودی > سیگنال‌های امن بروید. در زیر سیگنال‌های امن ، لاین را جستجو کنید و گزینه فعال کردن ادغام برنامه را فعال کنید.
روی ذخیره کلیک کنید.
آبشار
این مرحله برای ادغام‌های آبشاری لازم نیست.
امکان اشتراک‌گذاری امن سیگنال برای مناقصه SDK
مناقصه
به بخش تحویل > تنظیمات کانال تقاضا بروید. در تب تنظیمات پیش‌فرض ، گزینه «اجازه اشتراک‌گذاری امن سیگنال برای پیشنهاد SDK» را فعال کنید.
روی ذخیره کلیک کنید.
آبشار
این مرحله برای ادغام‌های آبشاری لازم نیست.
پیکربندی پیشنهاد قیمت شبکه تبلیغات LINE
مناقصه
به مسیر Delivery > Bidders بروید و روی Go to SDK Bidding کلیک کنید.
روی پیشنهاددهنده جدید کلیک کنید.
شبکه تبلیغات LINE را به عنوان پیشنهاد دهنده انتخاب کنید.
برای فعال کردن پیشنهاد قیمت SDK برای این پیشنهاد دهنده، روی ادامه کلیک کنید.
روی انجام شد کلیک کنید.
آبشار
این مرحله برای ادغام‌های آبشاری لازم نیست.
پیکربندی نگاشت واحد تبلیغات
مناقصه
به مسیر Delivery > Bidders بروید و روی Go to SDK Bidding کلیک کنید.
شرکت مورد نظر برای شبکه تبلیغات LINE را انتخاب کنید.
به برگه نگاشت واحد تبلیغات بروید و روی نگاشت واحد تبلیغات جدید کلیک کنید.
واحد تبلیغاتی خاص را انتخاب کنید. یک واحد تبلیغاتی و قالب، برنامه موبایل را به عنوان نوع موجودی و برنامه موبایل خود انتخاب کنید. سپس، شناسه برنامه و شناسه اسلات به دست آمده در بخش قبل را وارد کنید. در نهایت، روی ذخیره کلیک کنید.
آبشار
به بخش تحویل > گروه‌های بازده بروید و روی دکمه‌ی گروه بازده جدید کلیک کنید. برنامه‌ی موبایل خود را انتخاب کنید.
به پایین اسکرول کنید و روی «افزودن شریک عملکرد» کلیک کنید.
شرکتی را که در بخش قبل برای شبکه تبلیغات لاین (LINE Ads Network) ایجاد کردید، انتخاب کنید. در قسمت نوع ادغام (Integration type )، گزینه Mobile SDK mediation ، در قسمت پلتفرم (Platform) گزینه Android و در قسمت وضعیت (Status )، گزینه Active را انتخاب کنید.
شناسه برنامه و شناسه اسلات که در بخش قبل به دست آوردید و مقدار پیش‌فرض CPM را وارد کنید. روی ذخیره کلیک کنید.
توجه: جمع‌آوری خودکار داده‌ها چند روز طول می‌کشد تا بتواند مقدار CPM پویا را برای یک شبکه واسطه‌گری به طور دقیق محاسبه کند. به محض اینکه eCPM قابل محاسبه شد، به طور خودکار از طرف شما به‌روزرسانی می‌شود.
مرحله ۳: 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.1")
}
ادغام دستی
آخرین نسخه فایل
.aarمربوط به LINE Ads Network SDK را دانلود کرده و به پروژه خود اضافه کنید.به آرتیفکت‌های آداپتور شبکه LINE Ads در مخزن Maven گوگل بروید. آخرین نسخه را انتخاب کنید، فایل
.aarآداپتور شبکه LINE Ads را دانلود کنید و آن را به پروژه خود اضافه کنید.
مرحله ۴: اضافه کردن کد مورد نیاز
برای ادغام شبکه تبلیغات LINE هیچ کد اضافی لازم نیست.
مرحله ۵: پیاده‌سازی خود را آزمایش کنید
فعال کردن تبلیغات آزمایشی
مطمئن شوید که دستگاه آزمایشی خود را برای Ad Manager ثبت کرده‌اید .
تأیید تبلیغات آزمایشی
برای تأیید اینکه تبلیغات آزمایشی را از شبکه تبلیغات LINE دریافت می‌کنید، آزمایش منبع تبلیغاتی واحد را در بازرس تبلیغات با استفاده از منبع(های ) تبلیغاتی شبکه تبلیغات LINE (آبشاری ) فعال کنید.
مراحل اختیاری
پارامترهای خاص شبکه
آداپتور شبکه LINE Ads از یک پارامتر درخواست اضافی پشتیبانی می‌کند که می‌تواند با استفاده از کلاس LineExtras به آداپتور منتقل شود. سازنده این کلاس شامل پارامترهای زیر است:
-
enableAdSound - یک
booleanبرای مشخص کردن حالت پیش‌فرض شروع صدا برای تبلیغات بنری، بینابینی و جایزه‌دار.
در اینجا یک نمونه کد از نحوه ایجاد یک درخواست تبلیغ که این پارامترها را تنظیم می‌کند، آورده شده است:
جاوا
LineExtras lineExtras = new LineExtras(true);
Bundle extras = lineExtras.build();
AdManagerAdRequest request = new AdManagerAdRequest.Builder()
.addNetworkExtrasBundle(LineMediationAdapter.class, extras)
.build();
کاتلین
val lineExtras = LineExtras(true)
val extras = lineExtras.build()
val request = AdManagerAdRequest.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 حذف شد. می‌تواند به کاهش مشکلات نشت حافظه کمک کند.
ساخته و آزمایش شده با:
- نسخه ۲۴.۷.۰ کیت توسعه نرم‌افزاری تبلیغات موبایلی گوگل.
- نسخه 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 فایو اد ۲.۶.۲۰۲۳۰۶۰۷.
این راهنما به شما نشان می‌دهد که چگونه از SDK تبلیغات موبایل گوگل برای بارگذاری و نمایش تبلیغات از شبکه تبلیغات لاین با استفاده از میانجیگری استفاده کنید و ادغام‌های آبشاری را پوشش می‌دهد. این راهنما نحوه اضافه کردن شبکه تبلیغات لاین به پیکربندی میانجیگری یک واحد تبلیغاتی و نحوه ادغام 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 برای Ad Manager ایجاد کنید .
برای پیاده‌سازی app-ads.txt برای شبکه تبلیغات LINE، به بخش «درباره app-ads.txt» مراجعه کنید.
مرحله ۲: تنظیم تقاضای شبکه تبلیغات لاین در رابط کاربری مدیریت تبلیغات
وارد حساب مدیر تبلیغات خود شوید.
شبکه تبلیغات LINE را در شرکت‌ها اضافه کنید
مناقصه
این مرحله برای ادغام‌های پیشنهاد قیمت لازم نیست.
آبشار
به بخش مدیریت > شرکت‌ها بروید، سپس در تب «همه شرکت‌ها» روی دکمه «شرکت جدید» کلیک کنید. شبکه تبلیغاتی را انتخاب کنید.
شبکه تبلیغات لاین (LINE Ads Network) را به عنوان شبکه تبلیغات انتخاب کنید، یک نام منحصر به فرد وارد کنید و میانجیگری (Mediation) را فعال کنید. جمع‌آوری خودکار داده‌ها را فعال کنید و نام کاربری و رمز عبوری که در بخش قبل به دست آورده‌اید را وارد کنید.
نیازی به وارد کردن نام کاربری یا رمز عبور نیست. پس از اتمام، روی ذخیره کلیک کنید.
فعال کردن اشتراک‌گذاری امن سیگنال
مناقصه
به بخش مدیریت > تنظیمات کلی بروید. به برگه تنظیمات حساب Ad Exchange بروید و اشتراک‌گذاری امن سیگنال را بررسی و فعال کنید. روی ذخیره کلیک کنید.
آبشار
این مرحله برای ادغام‌های آبشاری لازم نیست.
سیگنال امن را در درخواست‌های پیشنهاد به اشتراک بگذارید
مناقصه
به بخش موجودی > سیگنال‌های امن بروید. در زیر سیگنال‌های امن ، لاین را جستجو کنید و گزینه فعال کردن ادغام برنامه را فعال کنید.
روی ذخیره کلیک کنید.
آبشار
این مرحله برای ادغام‌های آبشاری لازم نیست.
امکان اشتراک‌گذاری امن سیگنال برای مناقصه SDK
مناقصه
به بخش تحویل > تنظیمات کانال تقاضا بروید. در تب تنظیمات پیش‌فرض ، گزینه «اجازه اشتراک‌گذاری امن سیگنال برای پیشنهاد SDK» را فعال کنید.
روی ذخیره کلیک کنید.
آبشار
این مرحله برای ادغام‌های آبشاری لازم نیست.
پیکربندی پیشنهاد قیمت شبکه تبلیغات LINE
مناقصه
به مسیر Delivery > Bidders بروید و روی Go to SDK Bidding کلیک کنید.
روی پیشنهاددهنده جدید کلیک کنید.
شبکه تبلیغات LINE را به عنوان پیشنهاد دهنده انتخاب کنید.
برای فعال کردن پیشنهاد قیمت SDK برای این پیشنهاد دهنده، روی ادامه کلیک کنید.
روی انجام شد کلیک کنید.
آبشار
این مرحله برای ادغام‌های آبشاری لازم نیست.
پیکربندی نگاشت واحد تبلیغات
مناقصه
به مسیر Delivery > Bidders بروید و روی Go to SDK Bidding کلیک کنید.
شرکت مورد نظر برای شبکه تبلیغات LINE را انتخاب کنید.
به برگه نگاشت واحد تبلیغات بروید و روی نگاشت واحد تبلیغات جدید کلیک کنید.
واحد تبلیغاتی خاص را انتخاب کنید. یک واحد تبلیغاتی و قالب، برنامه موبایل را به عنوان نوع موجودی و برنامه موبایل خود انتخاب کنید. سپس، شناسه برنامه و شناسه اسلات به دست آمده در بخش قبل را وارد کنید. در نهایت، روی ذخیره کلیک کنید.
آبشار
به بخش تحویل > گروه‌های بازده بروید و روی دکمه‌ی گروه بازده جدید کلیک کنید. برنامه‌ی موبایل خود را انتخاب کنید.
به پایین اسکرول کنید و روی «افزودن شریک عملکرد» کلیک کنید.
شرکتی را که در بخش قبل برای شبکه تبلیغات لاین (LINE Ads Network) ایجاد کردید، انتخاب کنید. در قسمت نوع ادغام (Integration type )، گزینه Mobile SDK mediation ، در قسمت پلتفرم (Platform) گزینه Android و در قسمت وضعیت (Status )، گزینه Active را انتخاب کنید.
شناسه برنامه و شناسه اسلات که در بخش قبل به دست آوردید و مقدار پیش‌فرض CPM را وارد کنید. روی ذخیره کلیک کنید.
توجه: جمع‌آوری خودکار داده‌ها چند روز طول می‌کشد تا بتواند مقدار CPM پویا را برای یک شبکه واسطه‌گری به طور دقیق محاسبه کند. به محض اینکه eCPM قابل محاسبه شد، به طور خودکار از طرف شما به‌روزرسانی می‌شود.
مرحله ۳: 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.1")
}
ادغام دستی
آخرین نسخه فایل
.aarمربوط به LINE Ads Network SDK را دانلود کرده و به پروژه خود اضافه کنید.به آرتیفکت‌های آداپتور شبکه LINE Ads در مخزن Maven گوگل بروید. آخرین نسخه را انتخاب کنید، فایل
.aarآداپتور شبکه LINE Ads را دانلود کنید و آن را به پروژه خود اضافه کنید.
مرحله ۴: اضافه کردن کد مورد نیاز
برای ادغام شبکه تبلیغات LINE هیچ کد اضافی لازم نیست.
مرحله ۵: پیاده‌سازی خود را آزمایش کنید
فعال کردن تبلیغات آزمایشی
مطمئن شوید که دستگاه آزمایشی خود را برای Ad Manager ثبت کرده‌اید .
تأیید تبلیغات آزمایشی
برای تأیید اینکه تبلیغات آزمایشی را از شبکه تبلیغات LINE دریافت می‌کنید، آزمایش منبع تبلیغاتی واحد را در بازرس تبلیغات با استفاده از منبع(های ) تبلیغاتی شبکه تبلیغات LINE (آبشاری ) فعال کنید.
مراحل اختیاری
پارامترهای خاص شبکه
آداپتور شبکه LINE Ads از یک پارامتر درخواست اضافی پشتیبانی می‌کند که می‌تواند با استفاده از کلاس LineExtras به آداپتور منتقل شود. سازنده این کلاس شامل پارامترهای زیر است:
-
enableAdSound - یک
booleanبرای مشخص کردن حالت پیش‌فرض شروع صدا برای تبلیغات بنری، بینابینی و جایزه‌دار.
در اینجا یک نمونه کد از نحوه ایجاد یک درخواست تبلیغ که این پارامترها را تنظیم می‌کند، آورده شده است:
جاوا
LineExtras lineExtras = new LineExtras(true);
Bundle extras = lineExtras.build();
AdManagerAdRequest request = new AdManagerAdRequest.Builder()
.addNetworkExtrasBundle(LineMediationAdapter.class, extras)
.build();
کاتلین
val lineExtras = LineExtras(true)
val extras = lineExtras.build()
val request = AdManagerAdRequest.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 حذف شد. می‌تواند به کاهش مشکلات نشت حافظه کمک کند.
ساخته و آزمایش شده با:
- نسخه ۲۴.۷.۰ کیت توسعه نرم‌افزاری تبلیغات موبایلی گوگل.
- نسخه 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 فایو اد ۲.۶.۲۰۲۳۰۶۰۷.