This guide shows you how to use Google Mobile Ads SDK to load and display ads from LY Ads Network using [mediation](https://developers.google.com/ad-manager/mobile-ads-sdk/ios/mediation.md.txt), 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 iOS app. ## Supported integrations and ad formats The mediation adapter for LY Ads Network has the following capabilities: | Integration || |---|---| | Bidding | Yes | | Waterfall | Yes | | Banner | Yes | | Interstitial | Yes | | Rewarded | Yes | | Native | Yes | ## Prerequisites Before you continue, verify the following: - iOS deployment target of 13.0 or later. - \[For bidding\]: To integrate all supported ad formats in bidding, use LY Ads Network adapter 2.8.20240827.0 or later ([latest version recommended](https://developers.google.com/ad-manager/mobile-ads-sdk/ios/mediation/line.md.txt#line-ios-mediation-adapter-changelog)). - Latest Google Mobile Ads SDK version. - [Set up mediation](https://developers.google.com/ad-manager/mobile-ads-sdk/ios/mediation.md.txt). ## Step 1: Set up configurations in LY Ads Network UI [Sign up and log in](https://adsnetwork.line.biz/) to your LY Ads Network account. ### Add a new application Navigate to the **App** tab and click the **New registration** button. ![New Registration](https://developers.google.com/static/admob/images/mediation/line/new-registration.png) Fill out the form and click **registration**. ![New Registration Form](https://developers.google.com/static/admob/images/mediation/line/new-registration-form.png) Take note of the **App ID**. ![Registration Details](https://developers.google.com/static/admob/images/mediation/line/registration-details-iOS.png) ### Create an ad slot On the **App** tab, select your app to view your app's details. Under the **Slot** section, click **Add**. ![Add Slot](https://developers.google.com/static/admob/images/mediation/line/add-slot.png) 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. > [!NOTE] > **Note:** The **Advertising format** and **Bidding Type** cannot be changed after registering the slot. Reach out to your LY Ads Network account manager to get access to create native ad placements in the LY Ads Network UI. ![Add Slot Form](https://developers.google.com/static/admob/images/mediation/line/add-slot-form.png) Take note of the **Slot ID**. ![Slot Details](https://developers.google.com/static/admob/images/mediation/line/slot-details.png) 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. ![Request Review](https://developers.google.com/static/admob/images/mediation/line/request-review.png) ### Create a Reporting API Key Navigate to the **Managing reporting API keys** tab and click the **Create API key** button. ![Reporting API Key Tab](https://developers.google.com/static/admob/images/mediation/line/reporting_api_key.png) Fill out the form and click **Save**. ![Reporting API Key Form](https://developers.google.com/static/admob/images/mediation/line/reporting_api_key_form.png) Take note of your **API Key ID** and **API Key Secret**. ![Reporting API Key Form](https://developers.google.com/static/admob/images/mediation/line/reporting_api_key_details.png) ### Update your app-ads.txt [Authorized Sellers for Apps app-ads.txt](https://iabtechlab.com/wp-content/uploads/2019/03/app-ads.txt-v1.0-final-.pdf) 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, [create an app-ads.txt file for Ad Manager](https://support.google.com/admanager/answer/7544382). To implement `app-ads.txt` for LY Ads Network, see [About app-ads.txt](https://adsnetwork-docs.linebiz.com/fivesdk-android/store-release/app-ads-txt.html). ## Step 2: Set up LY Ads Network demand in Ad Manager UI Sign in to your [Ad Manager account](https://admanager.google.com/home/). ### Add LY Ads Network in Companies ### Bidding This step isn't required for bidding integrations. ### Waterfall Navigate to **Admin** \> **Companies** , then click the **New company** button in the **All companies** tab. Select **Ad network**. ![](https://developers.google.com/static/admob/images/mediation/gam-create-new-company.png) Select **LY Ads Network** as the **Ad network** , enter a unique **Name** and enable **Mediation** . Turn on **Automatic data collection** , and enter the **API Key ID** and **API Key Secret** obtained in the previous section. You don't need to enter a **Username** or **Password** . Click **Save** when done. ![](https://developers.google.com/static/admob/images/mediation/line/gam-create-company-mediation.png) ### Enable secure signal sharing ### Bidding Navigate to **Admin** \> **Global settings** . Go to the **Ad Exchange account settings** tab and review and turn on **Secure signal sharing** . Click **Save**. ![](https://developers.google.com/static/admob/images/mediation/gam-allow-secure-signal-sharing.png) ### Waterfall This step isn't required for waterfall integrations. ### Share secure signal on bid requests ### Bidding Navigate to **Inventory** \> **Secure Signals** . Under **Secure signals** , search for LY Ads Network and turn on **Enable app integration**. ![](https://developers.google.com/static/admob/images/mediation/enable-app-integration.png) Click **Save**. ### Waterfall This step isn't required for waterfall integrations. ### Allow secure signal sharing for SDK Bidding ### Bidding Navigate to **Delivery** \> **Demand channel settings** . In the **Default settings** tab, turn on **Allow secure signal sharing** for **SDK Bidding**. ![](https://developers.google.com/static/admob/images/mediation/secure-signal-sharing-sdk-bidding.png) Click **Save**. ### Waterfall This step isn't required for waterfall integrations. ### Configure LY Ads Network bidding ### Bidding Navigate to **Delivery** \> **Bidders** , and click **Go to SDK Bidding**. ![](https://developers.google.com/static/admob/images/mediation/gam-bidders-setup.png) Click **New bidder**. ![](https://developers.google.com/static/admob/images/mediation/gam-sdk-bidding-new-bidder.png) Select **LY Ads Network** as the bidder. ![](https://developers.google.com/static/admob/images/mediation/line/gam-sdk-bidding-new-bidder-select-bidder.png) Click **Continue** to enable SDK Bidding for this bidder. ![](https://developers.google.com/static/admob/images/mediation/enable-sdk-bidding.png) Click **Done**. ### Waterfall This step isn't required for waterfall integrations. ### Configure ad unit mapping ### Bidding Navigate to **Delivery** \> **Bidders** , and click **Go to SDK Bidding**. ![](https://developers.google.com/static/admob/images/mediation/gam-bidders-setup.png) Select the company for LY Ads Network. ![](https://developers.google.com/static/admob/images/mediation/gam-sdk-bidding-new-bidder.png) Go to the **Ad unit mapping** tab and click **New ad unit mapping**. ![](https://developers.google.com/static/admob/images/mediation/gam-sdk-bidding-ad-unit-mapping.png) Choose **Specific ad unit** . Select an ad unit and format, **Mobile app** as the **Inventory type** , and your **Mobile application** . Then, enter **Application ID** and **Slot ID** obtained in the previous section. Finally, click **Save**. > [!IMPORTANT] > **Important:** Target the selected ad unit by at least one yield group, and the **Application ID** must be associated with the targeted app as in the LY Ads Network UI. ![](https://developers.google.com/static/admob/images/mediation/line/gam-sdk-bidding-new-ad-unit-mapping.png) ### Waterfall Navigate to **Delivery** \> **Yield groups** and click the **New yield group** button. Select your **Inventory** and **App**. ![](https://developers.google.com/static/admob/images/mediation/gam-yield-group-details-and-targeting.png) Scroll to **Yield partners** and click **Add mediation partner**. ![](https://developers.google.com/static/admob/images/mediation/gam-yield-group-add-yield-partner.png) Select the company you created for LY Ads Network in the previous section. Choose **Mobile SDK mediation** as the **Integration type** , **iOS** as the **Platform** , and **Active** as the **Status**. Enter the **Application ID** and **Slot ID** obtained in the previous section, and the **Default CPM** value. Click **Save**. > [!IMPORTANT] > **Important:** The **Application ID** must be associated with the targeted app as in the LY Ads Network UI. ![](https://developers.google.com/static/admob/images/mediation/line/gam-add-yield-partner-mediation-iOS.png) > [!NOTE] > **Note:** Automatic data collection takes a few days to gather data before it can accurately calculate a Dynamic CPM value for a mediation network. Once the eCPM can be calculated, it is automatically updated on your behalf. ## Step 3: Import the LY Ads Network SDK and Adapter > [!NOTE] > **Note:** Failure to integrate the compatible LY Ads Network and Google Mobile Ads SDK versions might lead to build issues. ### Recommended: Use Swift Package Manager Before you continue, you must have the minimum supported adapter version 2.9.20251119. To [add a package dependency](https://developer.apple.com/documentation/xcode/adding-package-dependencies-to-your-app#Add-a-package-dependency) to your project, follow these steps: 1. In Xcode, navigate to **File \> Add Package Dependencies...**. 2. In the prompt that appears, search the following package URL: https://github.com/googleads/googleads-mobile-ios-mediation-line.git 3. In **Dependency Rule** , select **Branch**. 4. In the text field, enter `main`. ### Manual integration - Download the latest version of the [LY Ads Network SDK](https://cdn.fivecdm.com/release-sdk/ios/latest/FiveAd.framework.zip) and link `FiveAd.framework` in your project. - Download the latest version of the LY Ads Network adapter from the download link in Changelog and link `LineAdapter.framework` in your project. ### Use CocoaPods > [!CAUTION] > **Caution:** Starting December 2, 2026, the [CocoaPods Specs > repository](https://blog.cocoapods.org/CocoaPods-Specs-Repo/) is in read-only mode. As of this date, Google Mobile Ads SDK no longer publishes updated versions of mediation adapters for iOS to CocoaPods.
Add the following line to your project's Podfile: pod 'GoogleMobileAdsMediationLine' From the command line run: ```bash pod install --repo-update ``` ## Step 4: Add required code ### Implement SKAdNetwork Follow [LY Ads Network's documentation](https://adsnetwork-docs.linebiz.com/fivesdk-ios/advanced/sk-ad-network.html) to add the SKAdNetwork identifiers to your project's `Info.plist` file. ## Step 5: Test your implementation ### Enable test ads Make sure you [register your test device](https://developers.google.com/ad-manager/mobile-ads-sdk/ios/test-ads.md.txt#enable_test_devices) for Ad Manager. 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 Google Mobile Ads SDK](https://developers.google.com/ad-manager/mobile-ads-sdk/ios/quick-start.md.txt#initialize_the_mobile_ads_sdk) to ensure they get forwarded properly to the LY Ads Network SDK. ### Swift ```swift import LineAdapter // ... GADMediationAdapterLine.testMode = true ``` ### Objective-C ```objective-c #import // ... GADMediationAdapterLine.testMode = YES; ``` > [!IMPORTANT] > **Important:** Disable test mode for Ad Manager and LY Ads Network before releasing your app. ### Verify test ads To verify that you are receiving test ads from LY Ads Network, enable [single ad source testing](https://developers.google.com/ad-manager/mobile-ads-sdk/ios/ad-inspector.md.txt#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 `GADMediationAdapterLineExtras` class. This class includes the following properties: `adAudio` : Specifies 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: ### Swift ```swift import LineAdapter // ... let request = GAMRequest() let extras = GADMediationAdapterLineExtras() extras.adAudio = GADMediationAdapterLineAdAudio.unmuted // ... request.register(extras) ``` ### Objective-C ```objective-c #import // ... GAMRequest *request = [GAMRequest request]; GADMediationAdapterLineExtras *extras = [[GADMediationAdapterLineExtras alloc] init]; extras.adAudio = GADMediationAdapterLineAdAudioUnmuted; // ... [request registerAdNetworkExtras:extras]; ``` ### Using native ads #### Ad rendering The LY Ads Network adapter populates the following [fields](https://support.google.com/admanager/answer/6075370#appinstall) for a [`GADNativeAd`](https://developers.google.com/ad-manager/mobile-ads-sdk/ios/api/reference/Classes/GADNativeAd.md.txt). | Field | Assets always included by LY Ads Network adapter | |---|---| | Headline | Yes | | Image | Yes | | Body | Yes | | App icon | ^[1](https://developers.google.com/ad-manager/mobile-ads-sdk/ios/mediation/line.md.txt#app-icon-footnote)^ | | Call to action | Yes | | Star rating | | | Store | | | Price | | ^1^ 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 [`GADResponseInfo.adNetworkInfoArray`](https://developers.google.com/ad-manager/mobile-ads-sdk/ios/api/reference/Classes/GADResponseInfo.md.txt#adnetworkinfoarray) under the following classes: ```objective-c GADMediationAdapterLine ``` Here are the codes and accompanying messages thrown by the LY Ads Network adapter when an ad fails to load: | Error code | Domain | Reason | |---|---|---| | 1-10 | Sent by LY Ads Network SDK | LY Ads Network SDK returned an SDK-specific error. See LY Ads Network's [documentation](https://adsnetwork-docs.linebiz.com/fivesdk-ios/trouble-shooting/quick-diagnosis.html) for more details. | | 101 | com.google.ads.mediation.line | Invalid server parameters (e.g. Missing Application ID or Slot ID). | | 102 | com.google.ads.mediation.line | The requested ad size does not match a LY Ads Network supported banner ad size. | | 103 | com.google.ads.mediation.line | Failed to load an information icon image asset in native ad. | | 104 | com.google.ads.mediation.line | Failed to collect signals for bidding. | | 105 | com.google.ads.mediation.line | Failed to initialize the LINE Ads SDK ad loader. | ## LINE iOS Mediation Adapter Changelog #### [Version 3.1.1.0](https://dl.google.com/googleadmobadssdk/mediation/ios/line/LineAdapter-3.1.1.0.zip) - Verified compatibility with FiveAd SDK version 3.1.1. Built and tested with: - Google Mobile Ads SDK version 13.9.0. - FiveAd SDK version 3.1.1. #### [Version 3.1.0.0](https://dl.google.com/googleadmobadssdk/mediation/ios/line/LineAdapter-3.1.0.0.zip) - Now requires minimum iOS version `15.0`. - Verified compatibility with FiveAd SDK version 3.1.0. Built and tested with: - Google Mobile Ads SDK version 13.8.0. - FiveAd SDK version 3.1.0. #### [Version 3.0.1.2](https://dl.google.com/googleadmobadssdk/mediation/ios/line/LineAdapter-3.0.1.2.zip) - Update the minimum iOS version to relax Google Mobile Ads SDK dependency to allow minor versions. - Fixed an issue where the AdChoices icon for native ads were too large. Built and tested with: - Google Mobile Ads SDK version 13.4.0. - FiveAd SDK version 3.0.1. #### [Version 3.0.1.1](https://dl.google.com/googleadmobadssdk/mediation/ios/line/LineAdapter-3.0.1.1.zip) - Adapter now forwards the `ageRestrictedTreatment` Google Mobile Ads SDK flag to FiveAd SDK's COPPA API. Built and tested with: - Google Mobile Ads SDK version 13.3.0. - FiveAd SDK version 3.0.1. #### [Version 3.0.1.0](https://dl.google.com/googleadmobadssdk/mediation/ios/line/LineAdapter-3.0.1.0.zip) - Verified compatibility with FiveAd SDK version 3.0.1. Built and tested with: - Google Mobile Ads SDK version 13.1.0. - FiveAd SDK version 3.0.1. #### [Version 3.0.0.1](https://dl.google.com/googleadmobadssdk/mediation/ios/line/LineAdapter-3.0.0.1.zip) - Updated the Google Mobile Ads SDK dependency to version 13.0.0. Built and tested with: - Google Mobile Ads SDK version 13.0.0. - FiveAd SDK version 3.0.0. #### [Version 3.0.0.0](https://dl.google.com/googleadmobadssdk/mediation/ios/line/LineAdapter-3.0.0.0.zip) - Verified compatibility with FiveAd SDK version 3.0.0.0. Built and tested with: - Google Mobile Ads SDK version 12.14.0. - FiveAd SDK version 3.0.0. #### [Version 2.9.20251119.1](https://dl.google.com/googleadmobadssdk/mediation/ios/line/LineAdapter-2.9.20251119.1.zip) - Added support for forwarding the tagForUnderAgeOfConsent Google Mobile Ads SDK parameters to the FiveAd SDK. Built and tested with: - Google Mobile Ads SDK version 12.14.0. - FiveAd SDK version 2.9.20251119. #### [Version 2.9.20251119.0](https://dl.google.com/googleadmobadssdk/mediation/ios/line/LineAdapter-2.9.20251119.0.zip) - Verified compatibility with FiveAd SDK version 2.9.20251119. Built and tested with: - Google Mobile Ads SDK version 12.14.0. - FiveAd SDK version 2.9.20251119. #### [Version 2.9.20250930.0](https://dl.google.com/googleadmobadssdk/mediation/ios/line/LineAdapter-2.9.20250930.0.zip) - Verified compatibility with FiveAd SDK version 2.9.20250930. Built and tested with: - Google Mobile Ads SDK version 12.12.0. - FiveAd SDK version 2.9.20250930. #### [Version 2.9.20250912.0](https://dl.google.com/googleadmobadssdk/mediation/ios/line/LineAdapter-2.9.20250912.0.zip) - Adapter now initializes the FiveAd SDK before each ad request. - Verified compatibility with FiveAd SDK version 2.9.20250912. Built and tested with: - Google Mobile Ads SDK version 12.11.0. - FiveAd SDK version 2.9.20250912. #### [Version 2.9.20250512.0](https://dl.google.com/googleadmobadssdk/mediation/ios/line/LineAdapter-2.9.20250512.0.zip) - Now requires minimum iOS version 13.0. - Verified compatibility with FiveAd SDK version 2.9.20250512. Built and tested with: - Google Mobile Ads SDK version 12.4.0. - FiveAd SDK version 2.9.20250512. #### [Version 2.9.20241106.3](https://dl.google.com/googleadmobadssdk/mediation/ios/line/LineAdapter-2.9.20241106.3.zip) - Fixed an issue where `GADMediationAdapterLine.h` was not a public header. - Enabled `-fobjc-arc` and `-fstack-protector-all` flags. - Removed the banner ad size verification for bidding after successful loading. - Waterfall banner ads will continue to check for banner ad sizes upon successful loading. Built and tested with: - Google Mobile Ads SDK version 12.2.0. - FiveAd SDK version 2.9.20241106. #### [Version 2.9.20241106.2](https://dl.google.com/googleadmobadssdk/mediation/ios/line/LineAdapter-2.9.20241106.2.zip) - Added the `GADMediationAdapterLine.testMode` property to indicate whether the FiveAd SDK should be initialized in test mode. This flag must be set before initializing the Google Mobile Ads SDK. - Removed the check for FiveAd SDK initialization state before initializing the FiveAd SDK. - Removed the deprecated native ad state check before downloading native ad assets. - Now requires Google Mobile Ads SDK version 12.0.0 or higher. Built and tested with: - Google Mobile Ads SDK version 12.0.0. - FiveAd SDK version 2.9.20241106. #### [Version 2.9.20241106.1](https://dl.google.com/googleadmobadssdk/mediation/ios/line/LineAdapter-2.9.20241106.1.zip) - Updated the adapter to use the latest ad load API for bidding banner ads. - Fixed an issue preventing ad events from forwarding correctly for bidding interstitial ads. Built and tested with: - Google Mobile Ads SDK version 11.12.0. - FiveAd SDK version 2.9.20241106. #### [Version 2.9.20241106.0](https://dl.google.com/googleadmobadssdk/mediation/ios/line/LineAdapter-2.9.20241106.0.zip) - Verified compatibility with FiveAd SDK version 2.9.20241106. Built and tested with: - Google Mobile Ads SDK version 11.12.0. - FiveAd SDK version 2.9.20241106. #### [Version 2.8.20240827.1](https://dl.google.com/googleadmobadssdk/mediation/ios/line/LineAdapter-2.8.20240827.1.zip) - Updated `CFBundleShortVersionString` to have three components instead of four. Built and tested with: - Google Mobile Ads SDK version 11.10.0. - FiveAd SDK version 2.8.20240827. #### [Version 2.8.20240827.0](https://dl.google.com/googleadmobadssdk/mediation/ios/line/LineAdapter-2.8.20240827.0.zip) - Verified compatibility with FiveAd SDK version 2.8.20240827. - Added bidding support for banner, interstitial, rewarded, and native ad formats. Built and tested with: - Google Mobile Ads SDK version 11.8.0. - FiveAd SDK version 2.8.20240827. #### [Version 2.8.20240612.0](https://dl.google.com/googleadmobadssdk/mediation/ios/line/LineAdapter-2.8.20240612.0.zip) - Added audio control for native ad via GADVideoOptions. - Verified compatibility with FiveAd SDK version 2.8.20240612. Built and tested with: - Google Mobile Ads SDK version 11.5.0. - FiveAd SDK version 2.8.20240612. #### [Version 2.7.20240411.0](https://dl.google.com/googleadmobadssdk/mediation/ios/line/LineAdapter-2.7.20240411.0.zip) - Verified compatibility with FiveAd SDK version 2.7.20240411. Built and tested with: - Google Mobile Ads SDK version 11.3.0. - FiveAd SDK version 2.7.20240411. #### [Version 2.7.20240318.0](https://dl.google.com/googleadmobadssdk/mediation/ios/line/LineAdapter-2.7.20240318.0.zip) - Verified compatibility with FiveAd SDK version 2.7.20240318. Built and tested with: - Google Mobile Ads SDK version 11.2.0. - FiveAd SDK version 2.7.20240318. #### [Version 2.7.20240214.1](https://dl.google.com/googleadmobadssdk/mediation/ios/line/LineAdapter-2.7.20240214.1.zip) - Now requires minimum iOS version 12.0. - Now requires Google Mobile Ads SDK version 11.0 or higher. - Included `Info.plist` in the frameworks within `LineAdapter.xcframework`. Built and tested with: - Google Mobile Ads SDK version 11.0.1. - FiveAd SDK version 2.7.20240214. #### [Version 2.7.20240214.0](https://dl.google.com/googleadmobadssdk/mediation/ios/line/LineAdapter-2.7.20240214.0.zip) - Verified compatibility with FiveAd SDK version 2.7.20240214. Built and tested with: - Google Mobile Ads SDK version 11.0.1. - FiveAd SDK version 2.7.20240214. #### [Version 2.7.20240126.0](https://dl.google.com/googleadmobadssdk/mediation/ios/line/LineAdapter-2.7.20240126.0.zip) - Verified compatibility with FiveAd SDK version 2.7.20240126. - Updated the adapter implementation with FiveAd SDK new delegate protocols. Built and tested with: - Google Mobile Ads SDK version 10.14.0. - FiveAd SDK version 2.7.20240126. #### [Version 2.7.20231115.0](https://dl.google.com/googleadmobadssdk/mediation/ios/line/LineAdapter-2.7.20231115.0.zip) - Verified compatibility with FiveAd SDK version 2.7.20231115. - Included `GADMediationAdapterLineExtras` header in the modulemap. Built and tested with: - Google Mobile Ads SDK version 10.14.0. - FiveAd SDK version 2.7.20231115. #### [Version 2.6.20230609.1](https://dl.google.com/googleadmobadssdk/mediation/ios/line/LineAdapter-2.6.20230609.1.zip) - Added `GADMediationAdapterLineAudioState` to manage the initial audio state of the banner, interstitial, and rewarded ad when it is first displayed. Built and tested with: - Google Mobile Ads SDK version 10.14.0. - FiveAd SDK version 2.6.20230609. #### [Version 2.6.20230609.0](https://dl.google.com/googleadmobadssdk/mediation/ios/line/LineAdapter-2.6.20230609.0.zip) - Initial release! - Added waterfall support for banner, interstitial, rewarded, and native ad formats. - Verified compatibility with FiveAd SDK version 2.6.20230609. Built and tested with: - Google Mobile Ads SDK version 10.9.0. - FiveAd SDK version 2.6.20230609.