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

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

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

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

پیش‌نیازها

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

• سطح میانای برنامه کاربردی Android 24 یا بالاتر.

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

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

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

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

در حساب «شبکه تبلیغات LY» ثبت‌نام کنید و به سیستم وارد شوید.

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

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

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

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

ساختن جایگاه آگهی

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

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

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

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

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

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

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

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

به‌روزرسانی app-ads.txt

«فروشندگان مجاز برای برنامه‌ها» 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» در «شرکت‌ها»

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

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

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

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

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

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

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

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

dependencies {
    implementation("com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:1.6.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.6.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 SDK را بارگیری کنید و آن را به پروژه‌تان اضافه کنید.

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

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

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

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

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

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

«آداپتور شبکه آگهی LY» حاوی روش کمکی برای فعال کردن حالت آزمایش برای «شبکه آگهی LY» است. باید این گزینه را قبل‌از مقداردهی اولیه GMA Next-Gen SDK تنظیم کنید تا مطمئن شوید که به‌درستی به «کیت توسعه نرم‌افزار شبکه تبلیغات 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» فیلدهای زیر را برای NativeAd پر می‌کند.

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

کدهای خطا

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

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

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

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

نسخه ۳.۱.۱.۲

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

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

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

نسخه ۳.۱.۱.۱

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

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

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

نسخه ۳.۱.۱.۰

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

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

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

نسخه ۳.۱.۰.۰

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

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

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

نسخه ۳.۰.۱.۲

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

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

نسخه 3.0.1.1

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

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

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

نسخه 3.0.1.0

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

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

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

نسخه ۳.۰.۰.۰

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

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

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

نسخه 2.9.20251028.0

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

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

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

نسخه 2.9.20250924.1

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

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

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

نسخه 2.9.20250924.0

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

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

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

نسخه 2.9.20250718.0

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

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

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

نسخه 2.9.20250519.0

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

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

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

نسخه 2.9.20250317.1

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

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

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

نسخه 2.9.20250317.0

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

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

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

نسخه 2.9.20250110.1

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

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

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

نسخه 2.9.20250110.0

• کلاس UnifiedNativeAdMapper منسوخ‌شده به‌نفع NativeAdMapper برداشته شد
• فرایند جمع‌آوری نشان‌های ثابت اصلاح شد.
• فرایند مقداردهی اولیه برای قالب‌های آگهی بینابینی آبشاری و پاداش‌دار اصلاح شد.
• سازگاری با نسخه ۲.۹.۲۰۲۵۰۱۱۰ «کیت توسعه نرم‌افزار FiveAd» تأیید شد.

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

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

نسخه 2.9.20241129.0

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

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

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

نسخه 2.8.20240827.0

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

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

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

نسخه 2.8.20240808.0

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

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

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

نسخه 2.8.20240722.0

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

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

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

نسخه 2.7.20240515.0

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

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

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

نسخه 2.7.20240214.1

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

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

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

نسخه 2.7.20240214.0

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

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

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

نسخه 2.7.20240126.0

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

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

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

نسخه 2.6.20230607.0

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

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

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