Integrate LY with mediation

Select platform: Android Android iOS Unity Flutter

This guide shows you how to use GMA Next-Gen SDK to load and display ads from LY Ads Network using AdMob Mediation, covering waterfall integrations. It covers how to add LY Ads Network to an ad unit's mediation configuration, and how to integrate the LY Ads Network SDK and adapter into an Android app.

Supported integrations and ad formats

The mediation adapter for LY Ads Network has the following capabilities:

Requirements

• Android API level 24 or higher

• [For bidding]: To integrate all supported ad formats in bidding, use LY Ads Network adapter 2.9.20241129.0 or higher (latest version recommended)

• Latest GMA Next-Gen SDK

• Complete the mediation Get started guide

Step 1: Set up configurations in LY Ads Network UI

Sign up and log in to your LY Ads Network account.

Add a new application

Navigate to the App tab and click the New registration button.

Fill out the form and click registration.

Take note of the App ID.

Create an ad slot

On the App tab, select your app to view your app's details. Under the Slot section, click Add.

Fill out the form for details about the slot. For Bidding Type, select Standard to configure this slot for waterfall mediation, or Google SDK Bidding to configure this slot for Bidding. Click Create once the form is filled.

Take note of the 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.

Create a Reporting API Key

Navigate to the Managing reporting API keys tab and click the Create API key button.

Fill out the form and click Save.

Take note of your API Key ID and API Key Secret.

Update your app-ads.txt

Authorized Sellers for Apps app-ads.txt is an IAB Tech Lab initiative that helps ensure your app ad inventory is only sold through channels you've identified as authorized. To prevent a significant loss in ad revenue, you'll need to implement an app-ads.txt file. If you haven't done so already, set up an app-ads.txt file for your app.

To implement app-ads.txt for LY Ads Network, see About app-ads.txt.

Step 2: Set up LY Ads Network demand in AdMob UI

Configure mediation settings for your ad unit

You need to add LY Ads Network to the mediation configuration for your ad unit.

First, sign in to your AdMob account. Next, navigate to the Mediation tab. If you have an existing mediation group you'd like to modify, click the name of that mediation group to edit it, and skip ahead to Add LY Ads Network as an ad source.

To create a new mediation group, select Create Mediation Group.

Enter your ad format and platform, then click Continue.

Give your mediation group a name, and select locations to target. Next, set the mediation group status to Enabled, and then click Add Ad Units.

Associate this mediation group with one or more of your existing AdMob ad units. Then click Done.

You should now see the ad units card populated with the ad units you selected:

Add LY Ads Network as an ad source

Bidding

Under the Bidding card in the Ad Sources section, select Add ad source. Then select LY Ads Network .

Click How to sign a partnership agreement and set up a bidding partnership with LY Ads Network.



Click Acknowledge & agree, then click Continue.



If you already have a mapping for LY Ads Network, you can select it. Otherwise, click Add mapping.



Next, enter the Application ID and Slot ID obtained in the previous section. Then click Done.

Waterfall

Under the Waterfall card in the Ad Sources section, select Add Ad Source.

Select LY Ads Network and enable the Optimize switch. Enter the API Key ID and API Key Secret obtained in the previous section to set up ad source optimization for LY Ads Network. Then enter an eCPM value for LY Ads Network and click Continue.




If you already have a mapping for LY Ads Network, you can select it. Otherwise, click Add mapping.



Next, enter the Application ID and Slot ID obtained in the previous section. Then click Done.

Step 3: Import the LY Ads Network SDK and Adapter

Android Studio integration (recommended)

In your app-level gradle file, add the following implementation dependencies and configurations:

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'
}

Manual integration

1. Download the latest version of the LY Ads Network SDK's .aar file and add it to your project.

2. Navigate to the LY Ads Network adapter artifacts on Google's Maven Repository. Select the latest version, download the LY Ads Network adapter's .aar file, and add it to your project.

Step 4: Add required code

No additional code is required for LY Ads Network integration.

Step 5: Test your implementation

Enable test ads

Make sure you register your test device for AdMob.

The LY Ads Network adapter contains a helper method to enable test mode for LY Ads Network. You must set this option before you initialize GMA Next-Gen SDK to ensure they get forwarded properly to the LY Ads Network SDK.

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

LineMediationAdapter.setTestMode(true)
LineMediationSnippets.kt

Verify test ads

To verify that you are receiving test ads from LY Ads Network, enable single ad source testing in ad inspector using the LY Ads Network ad source(s).

Optional steps

Network-specific parameters

The LY Ads Network adapter supports an additional request parameter which can be passed to the adapter using the LineExtras class. This class constructor includes the following parameters:

enableAdSound

A boolean to specify the default sound start state of banner, interstitial and rewarded ads.

Here's a code example of how to create an ad request that sets these parameters:

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

Using native ads

Ad rendering

The LY Ads Network adapter populates the following Native ads advanced field descriptions for a NativeAd.

¹ For native ads, the LY Ads Network SDK does not provide an app icon asset. Instead, the LY Ads Network adapter populates the app icon with a transparent image.

Error codes

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

Here are the codes and accompanying messages thrown by the LY Ads Network adapter when an ad fails to load:

LINE Android Mediation Adapter Changelog

Next Version

• Maps AgeRestrictedTreatment to Line's ChildDirectedTreatment API.

Version 3.1.1.0 (In progress)

Version 3.1.0.0

• Added property to build the adapter with GMA Next-Gen SDK dependency.
• Verified compatibility with FiveAd SDK version 3.1.0.0.

Built and tested with:

• Google Mobile Ads SDK version 25.1.0.
• Google Mobile Ads Next-Gen SDK version 0.25.0-beta01.
• FiveAd SDK version 3.1.0.0.

Version 3.0.1.2

Built and tested with:

• Google Mobile Ads SDK version 25.1.0.
• FiveAd SDK version 3.0.1.2.

Version 3.0.1.1

• Native ad impressions are now overwritten by FiveAd SDK when using Google Mobile Ads SDK v24.4.0 or above.

Built and tested with:

• Google Mobile Ads SDK version 24.9.0.
• FiveAd SDK version 3.0.1.1.

Version 3.0.1.0

• Added support for forwarding the tagForUnderAgeOfConsent Google Mobile Ads SDK parameter to the FiveAd SDK.
• Verified compatibility with FiveAd SDK version 3.0.1.0.

Built and tested with:

• Google Mobile Ads SDK version 24.9.0.
• FiveAd SDK version 3.0.1.0.

Version 3.0.0.0

• Verified compatibility with FiveAd SDK version 3.0.0.0.

Built and tested with:

• Google Mobile Ads SDK version 24.9.0.
• FiveAd SDK version 3.0.0.0.

Version 2.9.20251028.0

• Verified compatibility with FiveAd SDK version 2.9.20251028.

Built and tested with:

• Google Mobile Ads SDK version 24.7.0.
• FiveAd SDK version 2.9.20251028.0

Version 2.9.20250924.1

• Removed class-level references to Context. Can help reduce memory leak issues.

Built and tested with:

• Google Mobile Ads SDK version 24.7.0.
• FiveAd SDK version 2.9.20250924.1.

Version 2.9.20250924.0

• Verified compatibility with FiveAd SDK version 2.9.20250924.

Built and tested with:

• Google Mobile Ads SDK version 24.6.0.
• FiveAd SDK version 2.9.20250924.0

Version 2.9.20250718.0

• Verified compatibility with FiveAd SDK version 2.9.20250718.

Built and tested with:

• Google Mobile Ads SDK version 24.3.0.
• FiveAd SDK version 2.9.20250718.0.

Version 2.9.20250519.0

• Verified compatibility with FiveAd SDK version 2.9.20250519.

Built and tested with:

• Google Mobile Ads SDK version 24.3.0.
• FiveAd SDK version 2.9.20250519.0.

Version 2.9.20250317.1

• Fixes banner loading dimensions for bidding ads with new FiveAd API

Built and tested with:

• Google Mobile Ads SDK version 24.1.0.
• FiveAd SDK version 2.9.20250317.0

Version 2.9.20250317.0

• Verified compatibility with FiveAd SDK version 2.9.20250317.

Built and tested with:

• Google Mobile Ads SDK version 24.1.0.
• FiveAd SDK version 2.9.20250317.0

Version 2.9.20250110.1

• Updated the minimum required Android API level to 23.
• Updated the minimum required Google Mobile Ads SDK version to 24.0.0.

Built and tested with:

• Google Mobile Ads SDK version 24.0.0.
• FiveAd SDK version 2.9.20250110.0

Version 2.9.20250110.0

• Removed deprecated UnifiedNativeAdMapper class in favor of NativeAdMapper
• Fixed signals collection process.
• Fixed initialization process for waterfall interstitial and rewarded ad formats.
• Verified compatibility with FiveAd SDK version 2.9.20250110.

Built and tested with:

• Google Mobile Ads SDK version 23.6.0.
• FiveAd SDK version 2.9.20250110.0

Version 2.9.20241129.0

• Added bidding support for banner, interstitial, rewarded and native ad formats.
• Verified compatibility with FiveAd SDK version 2.9.20241129.

Built and tested with:

• Google Mobile Ads SDK version 23.5.0.
• FiveAd SDK version 2.9.20241129.0

Version 2.8.20240827.0

• Verified compatibility with FiveAd SDK version 2.8.20240827.

Built and tested with:

• Google Mobile Ads SDK version 23.3.0.
• FiveAd SDK version 2.8.20240827.0

Version 2.8.20240808.0

• Verified compatibility with FiveAd SDK version 2.8.20240808.

Built and tested with:

• Google Mobile Ads SDK version 23.2.0.
• FiveAd SDK version 2.8.20240808.0

Version 2.8.20240722.0

• Verified compatibility with FiveAd SDK version 2.8.20240722.

Built and tested with:

• Google Mobile Ads SDK version 23.2.0.
• FiveAd SDK version 2.8.20240722.0

Version 2.7.20240515.0

• Verified compatibility with FiveAd SDK version 2.7.20240515.

Built and tested with:

• Google Mobile Ads SDK version 23.1.0.
• FiveAd SDK version 2.7.20240515.0

Version 2.7.20240214.1

• Updated the minimum required Google Mobile Ads SDK version to 23.0.0.
• Verified compatibility with FiveAd SDK version 2.7.20240214.

Built and tested with:

• Google Mobile Ads SDK version 23.0.0.
• FiveAd SDK version 2.7.20240214.0.

Version 2.7.20240214.0

• Verified compatibility with FiveAd SDK version 2.7.20240214.

Built and tested with:

• Google Mobile Ads SDK version 22.6.0.
• FiveAd SDK version 2.7.20240214.0.

Version 2.7.20240126.0

• Verified compatibility with FiveAd SDK version 2.7.20240126.

Built and tested with:

• Google Mobile Ads SDK version 22.6.0.
• FiveAd SDK version 2.7.20240126.0.

Version 2.7.20240112.0

• Removed deprecated FiveAdViewEventListener in favor of FiveAdCustomLayoutEventListener, FiveAdVideoRewardEventListener, FiveAdInterstitialEventListener and FiveAdNativeEventListener.
• Verified compatibility with FiveAd SDK version 2.7.20240112.
• Updated the minimum required Google Mobile Ads SDK version to 22.6.0.

Built and tested with:

• Google Mobile Ads SDK version 22.6.0.
• FiveAd SDK version 2.7.20240112.

Version 2.6.20230607.1

• Added LineExtras class for publishers to define default sound settings for banner, interstitial and rewarded ad formats.
• Updated the minimum required Google Mobile Ads SDK version to 22.4.0.

Built and tested with:

• Google Mobile Ads SDK version 22.4.0.
• FiveAd SDK version 2.6.20230607.

Version 2.6.20230607.0

• Initial release.
• Adds support for banner, interstitial, rewarded and native ad formats.
• Verified compatibility with FiveAd SDK version 2.6.20230607.

Built and tested with:

• Google Mobile Ads SDK version 22.1.0.
• FiveAd SDK version 2.6.20230607.