ادغام شبکه تبلیغاتی LY با میانجیگری

انتخاب پلتفرم: اندروید اندروید، iOS، یونیتی ، فلاتر

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

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

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

الزامات

• اندروید API سطح ۲۴ یا بالاتر

• [برای پیشنهاد قیمت]: برای ادغام تمام قالب‌های تبلیغاتی پشتیبانی‌شده در پیشنهاد قیمت، از آداپتور شبکه LY Ads نسخه ۲.۹.۲۰۲۴۱۱۲۹.۰ یا بالاتر استفاده کنید ( آخرین نسخه توصیه می‌شود )

• آخرین GMA Next-Gen SDK

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

مرحله ۱: تنظیمات را در رابط کاربری شبکه تبلیغات LY تنظیم کنید

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

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

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

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

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

ایجاد جایگاه تبلیغاتی

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

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

به شناسه اسلات (Slot ID) توجه کنید.

After you create your first slot, click Review on your app's detail page to get approval from LY Ads Network. This may take some time. Contact your LY Ads Network representative if you have any questions.

ایجاد کلید API گزارش‌دهی

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

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

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

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

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

برای پیاده‌سازی app-ads.txt برای شبکه تبلیغات LY، به بخش «درباره app-ads.txt» مراجعه کنید.

مرحله ۲: تنظیم تقاضای شبکه تبلیغات LY در رابط کاربری Ad Manager

وارد حساب مدیر تبلیغات خود شوید.

شبکه تبلیغاتی LY را در شرکت‌ها اضافه کنید

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

سیگنال امن را در درخواست‌های پیشنهاد به اشتراک بگذارید

امکان اشتراک‌گذاری امن سیگنال برای مناقصه SDK

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

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

مرحله ۳: SDK و آداپتور شبکه LY Ads را وارد کنید

ادغام با اندروید استودیو (توصیه می‌شود)

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

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

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.2.1'
    implementation 'com.google.ads.mediation:line:3.1.0.0'
}

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 مربوط به SDK شبکه تبلیغاتی LY را دانلود کرده و به پروژه خود اضافه کنید.

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

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

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

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

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

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

آداپتور شبکه تبلیغات LY شامل یک متد کمکی برای فعال کردن حالت آزمایشی برای شبکه تبلیغات LY است. شما باید این گزینه را قبل از مقداردهی اولیه GMA Next-Gen SDK تنظیم کنید تا از ارسال صحیح آنها به SDK شبکه تبلیغات LY اطمینان حاصل شود.

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

LineMediationAdapter.setTestMode(true)
LineMediationSnippets.kt

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

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

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

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

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

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

نسخه بعدی

• AgeRestrictedTreatment را به API رفتار با هدایت کودک (ChildDirectedTreatment) لاین (Line) نگاشت می‌کند.

نسخه ۳.۱.۱.۰ (در حال انجام)

نسخه ۳.۱.۰.۰

• ویژگی برای ساخت آداپتور با وابستگی به GMA Next-Gen SDK اضافه شد.
• سازگاری تأیید شده با FiveAd SDK نسخه ۳.۱.۰.۰.

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

• نسخه ۲۵.۱.۰ کیت توسعه نرم‌افزاری تبلیغات موبایلی گوگل.
• نسخه ۰.۲۵.۰-بتا۰۱ از کیت توسعه نرم‌افزاری (SDK) تبلیغات موبایلی گوگل.
• نسخه ۳.۱.۰.۰ کیت توسعه نرم‌افزار FiveAd.

نسخه ۳.۰.۱.۲

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

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

نسخه ۳.۰.۱.۱

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

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

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

نسخه ۳.۰.۱.۰

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

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

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

نسخه ۳.۰.۰.۰

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

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

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

نسخه ۲.۹.۲۰۲۵۱۰۲۸.۰

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

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

• نسخه ۲۴.۷.۰ کیت توسعه نرم‌افزاری تبلیغات موبایلی گوگل.
• نسخه SDK فایو اد ۲.۹.۲۰۲۵۱۰۲۸.۰

نسخه ۲.۹.۲۰۲۵۰۹۲۴.۱

• ارجاعات سطح کلاس به 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 فایو اد ۲.۶.۲۰۲۳۰۶۰۷.