ادغام LINE Ads Network با واسطه (بتا)، ادغام شبکه تبلیغات LINE با واسطه (بتا)

این راهنما به شما نشان می‌دهد که چگونه از Google Mobile Ads SDK برای بارگیری و نمایش تبلیغات از Line با استفاده از میانجی‌گری استفاده کنید که ادغام‌های آبشار را پوشش می‌دهد. نحوه افزودن Line به پیکربندی میانجی واحد تبلیغات و نحوه ادغام Line SDK و آداپتور در یک برنامه Android را پوشش می‌دهد.

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

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

آداپتور میانجی برای LINE Ads Network دارای قابلیت های زیر است:

یکپارچه سازی
مناقصه
آبشار	^1
فرمت ها
بنر
بینابینی
پاداش داده شد
بومی

¹ ادغام Waterfall در نسخه بتا باز است.

الزامات

• Android API سطح 21 یا بالاتر

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

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

مرحله 1: تنظیمات را در رابط کاربری LINE Ads Network تنظیم کنید

به حساب LINE Ads Network خود وارد شوید .

یک برنامه جدید اضافه کنید

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

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

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

یک مکان تبلیغاتی ایجاد کنید

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

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

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

توجه: برای دسترسی به ایجاد مکان‌های تبلیغاتی بومی در رابط کاربری LINE Ads Network، با مدیر حساب LINE Ads Network خود تماس بگیرید.

به شناسه اسلات توجه داشته باشید.

مرحله 2: تقاضای شبکه LINE Ads را در رابط کاربری Ad Manager تنظیم کنید

به حساب Ad Manager خود وارد شوید.

اضافه کردن LINE Ads Network در شرکت ها

مناقصه

این مرحله برای ادغام پیشنهادها لازم نیست.

آبشار

به Admin > Companies بروید، سپس روی دکمه New company در تب All companys کلیک کنید. شبکه تبلیغات را انتخاب کنید.

LINE Ads Network را به عنوان شبکه تبلیغاتی انتخاب کنید، یک نام منحصر به فرد وارد کنید و Mediation را فعال کنید.

شما نیازی به وارد کردن نام کاربری یا رمز عبور ندارید. پس از اتمام روی ذخیره کلیک کنید.

اشتراک گذاری سیگنال ایمن را فعال کنید

مناقصه

به Admin > تنظیمات جهانی بروید. به برگه تنظیمات حساب Ad Exchange بروید و اشتراک‌گذاری ایمن سیگنال را بررسی کرده و آن را تغییر دهید. روی ذخیره کلیک کنید.

آبشار

این مرحله برای ادغام آبشار لازم نیست.

مناقصه شبکه LINE Ads را پیکربندی کنید

مناقصه

به Delivery > Bidders بروید و روی New bidder در زیر برگه SDK Bidding کلیک کنید.

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

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

روی Continue کلیک کنید.

روی Done کلیک کنید.

آبشار

این مرحله برای ادغام آبشار لازم نیست.

پیکربندی نقشه واحد تبلیغات

مناقصه

به Delivery > Bidders بروید و شرکتی را برای LINE Ads Network در برگه SDK Bidding انتخاب کنید.

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

واحد تبلیغات خاص را انتخاب کنید. یک واحد تبلیغات و قالب، برنامه موبایل را به عنوان نوع موجودی ، و برنامه تلفن همراه خود را انتخاب کنید. سپس Application ID و Slot ID بدست آمده در قسمت قبل را وارد کنید. در نهایت روی Save کلیک کنید.

مهم: واحد تبلیغات انتخابی را حداقل با یک گروه بازدهی هدف قرار دهید، و شناسه برنامه باید مطابق با رابط کاربری LINE Ads Network با برنامه مورد نظر مرتبط باشد.

آبشار

به مسیر Delivery > Yield Groups بروید و روی دکمه گروه بازده جدید کلیک کنید. برنامه موبایل خود را انتخاب کنید.

به پایین بروید و روی افزودن شریک بازده کلیک کنید.

شرکتی را که برای LINE Ads Network ایجاد کرده اید در قسمت قبل انتخاب کنید. میانجی SDK موبایل را به عنوان نوع ادغام ، Android را به عنوان پلتفرم و Active را به عنوان وضعیت انتخاب کنید.

شناسه برنامه و شناسه اسلات به دست آمده در بخش قبل و مقدار پیش فرض CPM را وارد کنید. روی ذخیره کلیک کنید.

مهم: شناسه برنامه باید مانند رابط کاربری LINE Ads Network با برنامه مورد نظر مرتبط باشد.

مرحله 3: SDK و آداپتور LINE Ads Network را وارد کنید

توجه: عدم ادغام نسخه‌های LINE Ads Network و Google Mobile Ads SDK ممکن است به مشکلات ساخت منجر شود.

ادغام Android Studio (توصیه می شود)

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

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

ادغام دستی

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

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

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

هیچ کد اضافی برای ادغام LINE Ads Network مورد نیاز نیست.

مرحله 5: اجرای خود را آزمایش کنید

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

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

مهم: قبل از انتشار برنامه، حالت آزمایشی را برای Ad Manager و LINE Ads Network غیرفعال کنید.

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

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

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

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

آداپتور شبکه 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 Ads Network فیلدهای زیر را برای NativeAd پر می کند.

میدان	دارایی ها همیشه توسط آداپتور شبکه LINE Ads گنجانده شده است
تیتر
تصویر
بدن
نماد برنامه	^1
فراخوان به اقدام
امتیاز ستاره
فروشگاه
قیمت

¹ برای تبلیغات بومی، LINE Ads Network SDK دارایی نماد برنامه را ارائه نمی دهد. در عوض، آداپتور شبکه LINE Ads نماد برنامه را با یک تصویر شفاف پر می کند.

کدهای خطا

اگر آداپتور نتواند تبلیغی را از LINE Ads Network دریافت کند، می‌توانید با استفاده از ResponseInfo.getAdapterResponses() در کلاس‌های زیر، خطای اساسی مربوط به پاسخ آگهی را بررسی کنید:

com.line.ads
com.google.ads.mediation.line.LineMediationAdapter

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

کد خطا	دامنه	دلیل
1-10	com.five_corp.ad	LINE Ads Network SDK یک خطای خاص SDK را برگرداند. برای جزئیات بیشتر به مستندات LINE Ads Network مراجعه کنید.
101	com.google.ads.mediation.line	شناسه برنامه موجود نیست یا نامعتبر است.
102	com.google.ads.mediation.line	شناسه اسلات وجود ندارد یا نامعتبر است.
103	com.google.ads.mediation.line	اندازه تبلیغ درخواستی با اندازه تبلیغات بنری پشتیبانی شده از شبکه LINE Ads مطابقت ندارد.
104	com.google.ads.mediation.line	به دلیل نداشتن زمینه فعالیت، یک آگهی بینابینی یا پاداش بارگیری نشد.
105	com.google.ads.mediation.line	LINE Ads Network SDK نتوانست یک تبلیغ بینابینی یا دارای پاداش را نشان دهد.
106	com.google.ads.mediation.line	به دلیل کمبود دارایی، آگهی بومی بارگیری نشد.

لاین تغییرات آداپتور میانجی اندروید

نسخه بعدی

• فرآیند جمع آوری سیگنال های ثابت

نسخه 2.9.20241129.0

• پشتیبانی از مناقصه برای قالب های تبلیغاتی بنر، بینابینی، پاداش و بومی اضافه شده است.
• سازگاری تایید شده با FiveAd SDK نسخه 2.9.20241129.0

ساخته و تست شده با:

• Google Mobile Ads SDK نسخه 23.5.0.
• FiveAd SDK نسخه 2.9.20241129.0

نسخه 2.8.20240827.0

• سازگاری تایید شده با FiveAd SDK نسخه 2.8.20240827.0

ساخته و تست شده با:

• Google Mobile Ads SDK نسخه 23.3.0.
• FiveAd SDK نسخه 2.8.20240827.0

نسخه 2.8.20240808.0

• سازگاری تایید شده با FiveAd SDK نسخه 2.8.20240808.0

ساخته و تست شده با:

• Google Mobile Ads SDK نسخه 23.2.0.
• FiveAd SDK نسخه 2.8.20240808.0

نسخه 2.8.20240722.0

• سازگاری تایید شده با FiveAd SDK نسخه 2.8.20240722.0

ساخته و تست شده با:

• Google Mobile Ads SDK نسخه 23.2.0.
• FiveAd SDK نسخه 2.8.20240722.0

نسخه 2.7.20240515.0

• سازگاری تأیید شده با FiveAd SDK نسخه 2.7.20240515.0

ساخته و تست شده با:

• Google Mobile Ads SDK نسخه 23.1.0.
• FiveAd SDK نسخه 2.7.20240515.0

نسخه 2.7.20240214.1

• حداقل نسخه مورد نیاز Google Mobile Ads SDK به 23.0.0 به روز شد.
• سازگاری تأیید شده با FiveAd SDK نسخه 2.7.20240214.0.

ساخته و تست شده با:

• Google Mobile Ads SDK نسخه 23.0.0.
• FiveAd SDK نسخه 2.7.20240214.0.

نسخه 2.7.20240214.0

• سازگاری تأیید شده با FiveAd SDK نسخه 2.7.20240214.0.

ساخته و تست شده با:

• Google Mobile Ads SDK نسخه 22.6.0.
• FiveAd SDK نسخه 2.7.20240214.0.

نسخه 2.7.20240126.0

• سازگاری تأیید شده با FiveAd SDK نسخه 2.7.20240126.0.

ساخته و تست شده با:

• Google Mobile Ads SDK نسخه 22.6.0.
• FiveAd SDK نسخه 2.7.20240126.0.

نسخه 2.7.20240112.0

• FiveAdViewEventListener منسوخ شده به نفع FiveAdCustomLayoutEventListener ، FiveAdVideoRewardEventListener ، FiveAdInterstitialEventListener و FiveAdNativeEventListener حذف شد.
• سازگاری تأیید شده با FiveAd SDK نسخه 2.7.20240112.
• حداقل نسخه مورد نیاز Google Mobile Ads SDK به 22.6.0 به روز شد.

ساخته و تست شده با:

• Google Mobile Ads SDK نسخه 22.6.0.
• FiveAd SDK نسخه 2.7.20240112.

نسخه 2.6.20230607.1

• کلاس LineExtras برای ناشران اضافه شد تا تنظیمات صدای پیش‌فرض را برای قالب‌های تبلیغاتی بنر، بینابینی و پاداش تعریف کنند.
• حداقل نسخه مورد نیاز Google Mobile Ads SDK به 22.4.0 به روز شد.

ساخته و تست شده با:

• Google Mobile Ads SDK نسخه 22.4.0.
• FiveAd SDK نسخه 2.6.20230607.

نسخه 2.6.20230607.0

• انتشار اولیه
• پشتیبانی از قالب‌های تبلیغاتی بنر، بینابینی، پاداش و بومی را اضافه می‌کند.
• سازگاری تأیید شده با FiveAd SDK نسخه 2.6.20230607.

ساخته و تست شده با:

• Google Mobile Ads SDK نسخه 22.1.0.
• FiveAd SDK نسخه 2.6.20230607.