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

این راهنما به شما نشان می‌دهد که چگونه از Google Mobile Ads SDK (Legacy) برای بار کردن و نمایش دادن آگهی‌های LY Ads Network بااستفاده از میانجی‌گری استفاده کنید، و ادغام‌های آبشاری را پوشش می‌دهد. این راهنما نحوه افزودن «شبکه تبلیغات LY» به پیکربندی میانجی‌گری واحد آگهی و نحوه ادغام «کیت توسعه نرم‌افزار شبکه تبلیغات LY» و آداپتور در برنامه Android را پوشش می‌دهد.

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

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

پیش‌نیازها

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

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

• جدیدترین نسخه Google Mobile Ads SDK (Legacy).

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

فایل 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»، به درباره app-ads.txt مراجعه کنید.

مرحله ۲: راه‌اندازی تقاضای «شبکه آگهی‌های LY» در «واسط کاربر Ad Manager»

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

افزودن LY Ads Network در شرکت‌ها

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

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

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

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

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

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

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

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

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

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

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

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

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

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

برای ادغام «شبکه تبلیغات LY»، به کد اضافی نیاز نیست.

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

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

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

«آداپتور شبکه آگهی LY» حاوی روش کمکی برای فعال کردن حالت آزمایش برای «شبکه آگهی LY» است. باید این گزینه را قبل‌از مقداردهی اولیه Google Mobile Ads SDK (Legacy) تنظیم کنید تا مطمئن شوید که به‌درستی به «کیت توسعه نرم‌افزار شبکه تبلیغات LY» بازارسال می‌شوند.

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

کدهای خطا

اگر آداپتور نتواند آگهی را از «شبکه آگهی‌های LY» دریافت کند، می‌توانید خطای زیربنایی را از پاسخ آگهی بااستفاده از ResponseInfo.getAdapterResponses() در کلاس‌های زیر بررسی کنید:

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

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

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

نسخه ۳.۱.۱.۲

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

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

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

نسخه ۳.۱.۱.۱

• Maps AgeRestrictedTreatment to Line's ChildDirectedTreatment API.

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

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

نسخه ۳.۱.۱.۰

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

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

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

نسخه ۳.۱.۰.۰

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

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

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

نسخه ۳.۰.۱.۲

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

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

نسخه ۳.۰.۱.۱

• هنگام استفاده از «کیت توسعه نرم‌افزار تبلیغات تلفن همراه Google» نسخه ۲۴.۴.۰ یا بالاتر، ظهورهای آگهی بومی اکنون توسط FiveAd SDK بازنویسی می‌شود.

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

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

نسخه ۳.۰.۱.۰

• پشتیبانی از بازارسال پارامتر tagForUnderAgeOfConsent کیت توسعه نرم‌افزار تبلیغات تلفن همراه Google به کیت توسعه نرم‌افزار FiveAd اضافه شد.
• سازگاری با نسخه 3.0.1.0 کیت توسعه نرم‌افزار FiveAd تأیید شد.

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

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

نسخه ۳.۰.۰.۰

• سازگاری با 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

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

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

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

نسخه 2.9.20250924.0

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

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

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

نسخه 2.9.20250718.0

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

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

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

نسخه 2.9.20250519.0

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

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

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

نسخه 2.9.20250317.1

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

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

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

نسخه 2.9.20250317.0

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

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

• کیت توسعه نرم‌افزار آگهی تلفن همراه Google نسخه ۲۴.۱.۰.
• FiveAd SDK نسخه 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 Mobile Ads نسخه ۲۳.۶.۰.
• نسخه کیت توسعه نرم‌افزار FiveAd‏ 2.9.20250110.0

نسخه 2.9.20241129.0

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

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

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

نسخه 2.8.20240827.0

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

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

• کیت توسعه نرم‌افزار آگهی تلفن همراه 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» تأیید شد.

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

• نسخه ۲۳.۱.۰ «کیت توسعه نرم‌افزار آگهی تلفن همراه 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

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

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

• نسخه ۲۲.۶.۰ «کیت توسعه نرم‌افزار آگهی تلفن همراه 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‏ 2.7.20240112.

نسخه 2.6.20230607.1

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

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

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

نسخه 2.6.20230607.0

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

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

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