ادغام «شبکه آگهی LY» با واسطه‌گری

این راهنما به شما نشان می‌دهد که چگونه از GMA Next-Gen SDK برای بار کردن و نمایش دادن آگهی‌های LY Ads Network بااستفاده از میانجی‌گری استفاده کنید، و ادغام‌های آبشاری را پوشش می‌دهد. این راهنما نحوه افزودن LY Ads Network به پیکربندی میانجی‌گری واحد آگهی و نحوه ادغام کیت توسعه نرم‌افزار و آداپتور LY Ads Network در برنامه Android را پوشش می‌دهد.

یکپارچه‌سازی‌ها و قالب‌های آگهی پشتیبانی‌شده

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

پیش‌نیازها

قبل‌از ادامه دادن، موارد زیر را تأیید کنید:

• Android API سطح ۲۴ یا بالاتر.

• [برای پیشنهاد قیمت]: برای ادغام همه قالب‌های آگهی پشتیبانی‌شده در پیشنهاد قیمت، از LY Ads Network adapter 2.9.20241129.0 یا نسخه‌های جدیدتر (استفاده از جدیدترین نسخه توصیه می‌شود) استفاده کنید.

• جدیدترین نسخه GMA Next-Gen SDK.

• راه‌اندازی میانجی‌گری.

مرحله ۱: پیکربندی‌ها را در «میانای کاربر شبکه تبلیغات LY» راه‌اندازی کنید

ثبت‌نام کنید و به سیستم حساب LY Ads Network خود وارد شوید.

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

به برگه برنامه پیمایش کنید و روی دکمه ثبت جدید کلیک کنید.

فرم را تکمیل کنید و روی ثبت‌نام کلیک کنید.

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

ایجاد جایگاه آگهی

در برگه برنامه، برنامه خود را انتخاب کنید تا جزئیات آن را مشاهده کنید. در بخش جایگاه، روی افزودن کلیک کنید.

برای دریافت جزئیات درباره جایگاه، فرم را تکمیل کنید. برای نوع پیشنهاد قیمت، استاندارد را برای پیکربندی این جایگاه برای میانجی‌گری آبشاری، یا پیشنهاد قیمت Google SDK را برای پیکربندی این جایگاه برای «پیشنهاد قیمت» انتخاب کنید. پس‌از تکمیل فرم، روی ایجاد کلیک کنید.

شناسه جای آگهی را یادداشت کنید.

پس‌از ایجاد اولین جایگاه، روی بازبینی در صفحه جزئیات برنامه‌تان کلیک کنید تا تأییدیه را از LY Ads Network دریافت کنید. ممکن است این کار مدتی طول بکشد. اگر سؤالی دارید، با نماینده LY Ads Network تماس بگیرید.

ایجاد کلید میانای برنامه‌سازی کاربردی گزارش‌دهی

به برگه مدیریت کلیدهای میانای برنامه‌سازی کاربردی گزارش‌دهی بروید و روی دکمه ایجاد کلید میانای برنامه‌سازی کاربردی کلیک کنید.

فرم را پر کنید و روی ذخیره کلیک کنید.

شناسه کلید API و رمز کلید API خود را یادداشت کنید.

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

Authorized Sellers for Apps app-ads.txt ابتکاری از IAB Tech Lab است که کمک می‌کند مطمئن شوید فهرست آگهی‌های برنامه‌تان فقط ازطریق کانال‌هایی که به‌عنوان مجاز شناسایی کرده‌اید فروخته می‌شود. برای جلوگیری از کاهش قابل‌توجه درآمد آگهی، باید فایل app-ads.txt را پیاده‌سازی کنید. اگر قبلاً این کار را نکرده‌اید، فایل app-ads.txt برای Ad Manager ایجاد کنید.

برای پیاده‌سازی app-ads.txt برای LY Ads Network، به درباره app-ads.txt مراجعه کنید.

مرحله ۲: راه‌اندازی تقاضای LY Ads Network در واسط کاربر Ad Manager

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

افزودن «شبکه آگهی LY» در «شرکت‌ها»

فعال کردن هم‌رسانی سیگنال ایمن

هم‌رسانی نشان امن در درخواست‌های پیشنهاد قیمت

اجازه دادن به هم‌رسانی نشان امن برای «پیشنهاد قیمت کیت توسعه نرم‌افزار»

پیکربندی پیشنهاد قیمت شبکه تبلیغات LY

پیکربندی تخصیص واحد آگهی

مرحله ۳: وارد کردن «کیت توسعه نرم‌افزار» و «آداپتور» LY Ads Network

یکپارچه‌سازی «استودیو Android» (توصیه‌شده)

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

dependencies {
    implementation("com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:1.5.0")
    implementation("com.google.ads.mediation:line:3.1.1.2")
}

configurations.configureEach {
    exclude(group = "com.google.android.gms", module = "play-services-ads")
    exclude(group = "com.google.android.gms", module = "play-services-ads-lite")
}

dependencies {
    implementation 'com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:1.5.0'
    implementation 'com.google.ads.mediation:line:3.1.1.2'
}

configurations.configureEach {
    exclude group: 'com.google.android.gms', module: 'play-services-ads'
    exclude group: 'com.google.android.gms', module: 'play-services-ads-lite'
}

یکپارچه‌سازی دستی

1. جدیدترین نسخه فایل .aar کیت توسعه نرم‌افزار LY Ads Network را بارگیری کنید و آن را به پروژه‌تان اضافه کنید.

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

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

برای ادغام «شبکه آگهی‌های LY» به کد دیگری نیاز نیست.

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

فعال کردن آگهی‌های آزمایشی

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

«آداپتور شبکه آگهی LY» حاوی روش کمکی برای فعال کردن حالت آزمایش برای «شبکه آگهی LY» است. باید این گزینه را قبل‌از مقداردهی اولیه GMA Next-Gen SDK تنظیم کنید تا مطمئن شوید که به‌درستی به LY Ads Network SDK بازارسال می‌شوند.

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

LineMediationAdapter.setTestMode(true)
LineMediationSnippets.kt

درستی‌سنجی آگهی‌های آزمایشی

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

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

پارامترهای ویژه شبکه

آداپتور «شبکه آگهی‌های LY» از پارامتر درخواست اضافی که می‌تواند بااستفاده از کلاس 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

استفاده از آگهی‌های بومی

پرداز آگهی

آداپتور LY Ads Network فیلدهای زیر را برای NativeAd پر می‌کند.

^۱ برای آگهی‌های بومی، کیت توسعه نرم‌افزار شبکه آگهی‌های LY دارایی نماد برنامه را ارائه نمی‌دهد. درعوض، میانای «شبکه آگهی‌های LY» نماد برنامه را با تصویری شفاف تکمیل می‌کند.

کدهای خطا

If the adapter fails to receive an ad from LY Ads Network, you can check the underlying error from the ad response using ResponseInfo.getAdSourceResponses() under the following classes:

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

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

گزارش تغییرات آداپتور میانجی LINE Android

نسخه ۳.۱.۱.۲

• وابستگی Kotlin آداپتور را به ۱.۹.۰ (حداقل نسخه Kotlin پشتیبانی‌شده توسط کیت توسعه نرم‌افزار GMA NextGen) سنجاق کنید.

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

• نسخه ۲۵.۴.۰ «کیت توسعه نرم‌افزار آگهی تلفن همراه Google».
• نسخه ۱.۴.۰ کیت توسعه نرم‌افزار نسل بعدی آگهی‌های Google Mobile.
• FiveAd SDK نسخه ۳.۱.۱.۱.

نسخه ۳.۱.۱.۱

• ‫Maps AgeRestrictedTreatment به Line's ChildDirectedTreatment API.

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

• کیت توسعه نرم‌افزار Google Mobile Ads نسخه ۲۵.۴.۰.
• نسخه ۱.۲.۱ کیت توسعه نرم‌افزار نسل بعدی آگهی‌های Google Mobile.
• نسخه کیت توسعه نرم‌افزار FiveAd‏ 3.1.1.1.

نسخه ۳.۱.۱.۰

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

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

• نسخه ۲۵.۲.۰ «کیت توسعه نرم‌افزار آگهی تلفن همراه Google».
• نسخه ۱.۲.۱ «کیت توسعه نرم‌افزار نسل بعدی تبلیغات تلفن همراه Google».
• نسخه کیت توسعه نرم‌افزار FiveAd‏ 3.1.1.0.

نسخه ۳.۱.۰.۰

• دارایی برای ساختن آداپتور با وابستگی «کیت توسعه نرم‌افزار نسل بعدی GMA» اضافه شد.
• سازگاری با FiveAd SDK نسخه 3.1.0.0 تأیید شد.

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

• کیت توسعه نرم‌افزار آگهی تلفن همراه Google نسخه ۲۵.۱.۰.
• کیت توسعه نرم‌افزار نسل بعدی آگهی‌های Google Mobile نسخه 0.25.0-beta01.
• نسخه کیت توسعه نرم‌افزار FiveAd‏ 3.1.0.0.

نسخه ۳.۰.۱.۲

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

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

نسخه ۳.۰.۱.۱

• اکنون ظهورهای آگهی بومی هنگام استفاده از Google Mobile Ads SDK نسخه ۲۴.۴.۰ یا بالاتر با FiveAd SDK بازنویسی می‌شود.

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

• کیت توسعه نرم‌افزار آگهی تلفن همراه Google نسخه ۲۴.۹.۰.
• FiveAd SDK نسخه ۳.۰.۱.۱.

نسخه 3.0.1.0

• پشتیبانی از بازارسال پارامتر tagForUnderAgeOfConsent کیت توسعه نرم‌افزار Google Mobile Ads به کیت توسعه نرم‌افزار FiveAd اضافه شد.
• سازگاری با FiveAd SDK نسخه ۳.۰.۱.۰ تأیید شد.

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

• کیت توسعه نرم‌افزار آگهی تلفن همراه Google نسخه ۲۴.۹.۰.
• FiveAd SDK نسخه ۳.۰.۱.۰.

نسخه ۳.۰.۰.۰

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

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

• نسخه ۲۴.۹.۰ کیت توسعه نرم‌افزار آگهی تلفن همراه Google.
• FiveAd SDK نسخه ۳.۰.۰.۰.

نسخه 2.9.20251028.0

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

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

• نسخه ۲۴.۷.۰ «کیت توسعه نرم‌افزار آگهی تلفن همراه Google».
• نسخه کیت توسعه نرم‌افزار FiveAd‏ 2.9.20251028.0

نسخه 2.9.20250924.1

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

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

• کیت توسعه نرم‌افزار آگهی تلفن همراه Google نسخه ۲۴.۷.۰.
• FiveAd SDK نسخه 2.9.20250924.1.

نسخه 2.9.20250924.0

• سازگاری با نسخه 2.9.20250924 کیت توسعه نرم‌افزار FiveAd تأیید شد.

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

• نسخه ۲۴.۶.۰ «کیت توسعه نرم‌افزار آگهی تلفن همراه Google».
• FiveAd SDK نسخه 2.9.20250924.0

نسخه 2.9.20250718.0

• سازگاری با نسخه ۲.۹.۲۰۲۵۰۷۱۸ کیت توسعه نرم‌افزار FiveAd تأیید شد.

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

• کیت توسعه نرم‌افزار آگهی تلفن همراه Google نسخه ۲۴.۳.۰.
• نسخه کیت توسعه نرم‌افزار FiveAd‏ 2.9.20250718.0.

نسخه 2.9.20250519.0

• سازگاری با نسخه ۲.۹.۲۰۲۵۰۵۱۹ «کیت توسعه نرم‌افزار FiveAd» تأیید شد.

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

• نسخه ۲۴.۳.۰ «کیت توسعه نرم‌افزار آگهی تلفن همراه Google».
• FiveAd SDK نسخه 2.9.20250519.0.

نسخه 2.9.20250317.1

• ابعاد بار کردن برنما را برای آگهی‌های پیشنهاد قیمت با FiveAd API جدید اصلاح می‌کند

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

• نسخه ۲۴.۱.۰ «کیت توسعه نرم‌افزار آگهی تلفن همراه Google».
• FiveAd SDK نسخه 2.9.20250317.0

نسخه 2.9.20250317.0

• سازگاری با نسخه ۲.۹.۲۰۲۵۰۳۱۷ کیت توسعه نرم‌افزار FiveAd تأیید شد.

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

• نسخه ۲۴.۱.۰ «کیت توسعه نرم‌افزار آگهی تلفن همراه Google».
• نسخه کیت توسعه نرم‌افزار FiveAd‏ 2.9.20250317.0

نسخه 2.9.20250110.1

• حداقل سطح میانای برنامه‌سازی کاربردی Android موردنیاز به ۲۳ به‌روز شد.
• حداقل نسخه موردنیاز «کیت توسعه نرم‌افزار تبلیغات تلفن همراه Google» به ۲۴.۰.۰ به‌روزرسانی شد.

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

• کیت توسعه نرم‌افزار آگهی تلفن همراه Google نسخه ۲۴.۰.۰.
• FiveAd SDK نسخه 2.9.20250110.0

نسخه 2.9.20250110.0

• کلاس منسوخ‌شده UnifiedNativeAdMapper به‌نفع NativeAdMapper برداشته شد
• فرایند جمع‌آوری نشان‌های ثابت اصلاح شد.
• فرایند مقداردهی اولیه برای قالب‌های آگهی پاداش‌دار و بینابینی آبشاری اصلاح شد.
• سازگاری با FiveAd SDK نسخه 2.9.20250110 تأیید شد.

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

• نسخه ۲۳.۶.۰ «کیت توسعه نرم‌افزار آگهی تلفن همراه Google».
• FiveAd SDK نسخه 2.9.20250110.0

نسخه 2.9.20241129.0

• پشتیبانی پیشنهاد قیمت برای قالب‌های آگهی برنمایی، بینابینی، پاداش‌دار، و بومی اضافه شد.
• سازگاری با نسخه ۲.۹.۲۰۲۴۱۱۲۹ «کیت توسعه نرم‌افزار FiveAd» تأیید شد.

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

• کیت توسعه نرم‌افزار Google Mobile Ads نسخه ۲۳.۵.۰.
• نسخه کیت توسعه نرم‌افزار FiveAd‏ 2.9.20241129.0

نسخه 2.8.20240827.0

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

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

• کیت توسعه نرم‌افزار آگهی تلفن همراه Google نسخه ۲۳.۳.۰.
• FiveAd SDK نسخه 2.8.20240827.0

نسخه 2.8.20240808.0

• سازگاری با نسخه ۲.۸.۲۰۲۴۰۸۰۸ کیت توسعه نرم‌افزار FiveAd تأیید شد.

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

• کیت توسعه نرم‌افزار آگهی تلفن همراه Google نسخه ۲۳.۲.۰.
• FiveAd SDK نسخه 2.8.20240808.0

نسخه 2.8.20240722.0

• سازگاری با نسخه ۲.۸.۲۰۲۴۰۷۲۲ «کیت توسعه نرم‌افزار FiveAd» تأیید شد.

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

• نسخه ۲۳.۲.۰ «کیت توسعه نرم‌افزار آگهی تلفن همراه Google».
• FiveAd SDK نسخه 2.8.20240722.0

نسخه 2.7.20240515.0

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

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

• کیت توسعه نرم‌افزار آگهی تلفن همراه Google نسخه ۲۳.۱.۰.
• FiveAd SDK نسخه 2.7.20240515.0

نسخه 2.7.20240214.1

• حداقل نسخه لازم «کیت توسعه نرم‌افزار تبلیغات تلفن همراه Google» به ۲۳.۰.۰ به‌روزرسانی شد.
• سازگاری با FiveAd SDK نسخه 2.7.20240214 تأیید شد.

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

• کیت توسعه نرم‌افزار آگهی تلفن همراه Google نسخه ۲۳.۰.۰.
• FiveAd SDK نسخه 2.7.20240214.0.

نسخه 2.7.20240214.0

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

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

• کیت توسعه نرم‌افزار آگهی تلفن همراه Google نسخه ۲۲.۶.۰.
• FiveAd SDK نسخه 2.7.20240214.0.

نسخه 2.7.20240126.0

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

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

• نسخه ۲۲.۶.۰ «کیت توسعه نرم‌افزار آگهی تلفن همراه Google».
• FiveAd SDK نسخه 2.7.20240126.0.

نسخه 2.7.20240112.0

• ‫FiveAdViewEventListener منسوخ‌شده به‌نفع FiveAdCustomLayoutEventListener، FiveAdVideoRewardEventListener، FiveAdInterstitialEventListener، و FiveAdNativeEventListener برداشته شد.
• سازگاری با نسخه 2.7.20240112 کیت توسعه نرم‌افزار FiveAd تأیید شد.
• حداقل نسخه موردنیاز «کیت توسعه نرم‌افزار تبلیغات تلفن همراه Google» به ۲۲.۶.۰ به‌روزرسانی شد.

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

• نسخه ۲۲.۶.۰ «کیت توسعه نرم‌افزار آگهی تلفن همراه Google».
• FiveAd SDK نسخه 2.7.20240112.

نسخه 2.6.20230607.1

• کلاس LineExtras برای ناشران اضافه شد تا تنظیمات پیش‌فرض صدا را برای قالب‌های آگهی پاداش‌دار، بینابینی، و برنما تعریف کنند.
• حداقل نسخه موردنیاز «کیت توسعه نرم‌افزار تبلیغات تلفن همراه Google» به ۲۲.۴.۰ به‌روزرسانی شد.

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

• کیت توسعه نرم‌افزار آگهی تلفن همراه Google نسخه ۲۲.۴.۰.
• FiveAd SDK نسخه ۲.۶.۲۰۲۳۰۶۰۷.

نسخه 2.6.20230607.0

• نسخهٔ پخش اولیه.
• از قالب‌های آگهی برنمایی، بینابینی، پاداش‌دار، و بومی پشتیبانی می‌کند.
• سازگاری با FiveAd SDK نسخه ۲.۶.۲۰۲۳۰۶۰۷ تأیید شد.

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

• نسخه ۲۲.۱.۰ «کیت توسعه نرم‌افزار آگهی تلفن همراه Google».
• FiveAd SDK نسخه ۲.۶.۲۰۲۳۰۶۰۷.