Yandex Advertising Network Mobile

https://github.com/yandexmobile/yandex-ads-sdk-android
Admin
The Yandex Advertising Network Mobile SDK provides tools for integrating Yandex mobile ads into...
Tokens:31,062
Snippets:400
Trust Score:8.5
Update:2 months ago
Show doc for...
Tokens:
Raw
### Implement BannerAdSize Examples

Source: https://github.com/yandexmobile/yandex-ads-sdk-android/blob/master/_autodocs/configuration.md

Demonstrates instantiation of different banner sizes for phones, tablets, and flexible layouts.

```kotlin
// Phone banner
val bannerSize = BannerAdSize.sticky320x50(context)

// Tablet banner
val bannerSize = BannerAdSize.sticky728x90(context)

// Flexible banner
val inlineSize = BannerAdSize.inline(context, 320, 250)
```

--------------------------------

### Construct an AdRequest instance

Source: https://github.com/yandexmobile/yandex-ads-sdk-android/blob/master/_autodocs/api-reference/CommonTypes.md

Example of initializing an AdRequest using the Builder pattern with custom parameters.

```kotlin
val adRequest = AdRequest.Builder("demo-banner-yandex")
    .setParameters(mapOf(
        "adf_ownerid" to "270901",
        "adf_p1" to "cqtgh",
        "adf_p2" to "fkbd"
    ))
    .build()
```

--------------------------------

### Implement Custom Banner Adapter

Source: https://github.com/yandexmobile/yandex-ads-sdk-android/blob/master/_autodocs/api-reference/MediationAdapters.md

Example implementation of a banner adapter that wraps a third-party SDK and maps its callbacks to the mediation listener.

```kotlin
class MyNetworkBannerAdapter(private val context: Context) : BannerAdapter {
    private var listener: BannerAdapterListener? = null
    
    override fun loadBannerAd(
        context: Context,
        adUnitId: String,
        listener: BannerAdapterListener
    ) {
        this.listener = listener
        MyNetworkSDK.loadBanner(context, adUnitId, object : MyNetworkCallback {
            override fun onSuccess(banner: MyNetworkBanner) {
                listener.onBannerLoaded(banner)
            }
            override fun onError(error: MyNetworkError) {
                listener.onBannerFailedToLoad(error.message)
            }
        })
    }
    
    override fun showBannerAd() {
        // Implementation
    }
    
    override fun destroyBannerAd() {
        // Cleanup
    }
}
```

--------------------------------

### Run migration prompt

Source: https://github.com/yandexmobile/yandex-ads-sdk-android/blob/master/YandexMobileAdsExample/skills/migrate-yandex-ads-sdk-from-7-to-8/README.md

Execute this command in your AI chat after attaching the migration skill to initiate the upgrade process.

```text
Migrate my project to Yandex Mobile Ads SDK 8.0.0 using the rules from the file @migrate-yandex-ads-sdk-from-7-to-8/SKILL.md
```

--------------------------------

### Standard SDK Initialization

Source: https://github.com/yandexmobile/yandex-ads-sdk-android/blob/master/ThirdPartyMediationAdapterTemplate/README.md

Use the standard initialization method for regular app integrations.

```kotlin
MobileAds.initialize(context) {
    onInitializationComplete.invoke()
}
```

--------------------------------

### NativeAdLoader(context: Context)

Source: https://github.com/yandexmobile/yandex-ads-sdk-android/blob/master/_autodocs/api-reference/NativeAds.md

Constructor for initializing the NativeAdLoader.

```APIDOC
## NativeAdLoader(context: Context)

### Description
Initializes a new instance of the NativeAdLoader.

### Parameters
- **context** (Context) - Required - Application or activity context

### Example
```kotlin
val loader = NativeAdLoader(context)
```
```

--------------------------------

### AppOpenAdLoader(context: Context)

Source: https://github.com/yandexmobile/yandex-ads-sdk-android/blob/master/_autodocs/api-reference/AppOpenAds.md

Constructor to initialize the AppOpenAdLoader with the required application or activity context.

```APIDOC
## Constructor

### Description
Initializes a new instance of the AppOpenAdLoader.

### Signature
`AppOpenAdLoader(context: Context)`

### Parameters
- **context** (Context) - Required - Application or activity context

### Example
```kotlin
import com.yandex.mobile.ads.appopenad.AppOpenAdLoader

val loader = AppOpenAdLoader(context)
```
```

--------------------------------

### BannerAdView(context: Context)

Source: https://github.com/yandexmobile/yandex-ads-sdk-android/blob/master/_autodocs/api-reference/BannerAds.md

Initializes a new instance of the BannerAdView component.

```APIDOC
## BannerAdView(context: Context)

### Description
Initializes a new instance of the BannerAdView component.

### Parameters
- **context** (Context) - Required - Application or activity context

### Example
```kotlin
val bannerAdView = BannerAdView(context)
container.addView(bannerAdView)
```
```

--------------------------------

### Initialize AppOpenAdLoader

Source: https://github.com/yandexmobile/yandex-ads-sdk-android/blob/master/_autodocs/api-reference/AppOpenAds.md

Instantiate the loader using an application or activity context.

```kotlin
import com.yandex.mobile.ads.appopenad.AppOpenAdLoader

val loader = AppOpenAdLoader(context)
```

--------------------------------

### Initialize and Load Banner Ads with Mediation

Source: https://github.com/yandexmobile/yandex-ads-sdk-android/blob/master/_autodocs/api-reference/MediationAdapters.md

Initialize the SDK and load banner ads using the standard API; mediation networks are automatically utilized if configured.

```kotlin
import com.yandex.mobile.ads.common.YandexAds
import com.yandex.mobile.ads.common.AdRequest
import com.yandex.mobile.ads.banner.BannerAdView

// Initialize
YandexAds.initialize(context) {
    Log.d("Ads", "Ready")
}

// Load banner (will use mediation networks if available)
val bannerView = BannerAdView(context)
bannerView.setAdSize(BannerAdSize.sticky320x50(context))
val adRequest = AdRequest.Builder("demo-banner-yandex").build()
bannerView.loadAd(adRequest)
```

--------------------------------

### Core Initialization

Source: https://github.com/yandexmobile/yandex-ads-sdk-android/blob/master/_autodocs/EXPORTS.md

Methods for initializing the Yandex Mobile Ads SDK and configuring global settings.

```APIDOC
## YandexAds.initialize(Context, () -> Unit)

### Description
Initializes the Yandex Mobile Ads SDK.

### Signature
`void initialize(Context context, Runnable completionHandler)`

## YandexAds.enableLogging(Boolean)

### Description
Enables or disables SDK logging.

### Signature
`void enableLogging(boolean enabled)`

## YandexAds.setUserConsent(Boolean)

### Description
Sets the user consent status for ad personalization.

### Signature
`void setUserConsent(boolean consent)`

## YandexAds.setLocationTracking(Boolean)

### Description
Enables or disables location tracking for ad targeting.

### Signature
`void setLocationTracking(boolean enabled)`

## YandexAds.setAgeRestricted(Boolean)

### Description
Sets the age-restricted status for the user.

### Signature
`void setAgeRestricted(boolean restricted)`
```

--------------------------------

### Initialize InstreamAdBinder

Source: https://github.com/yandexmobile/yandex-ads-sdk-android/blob/master/_autodocs/api-reference/InstreamAds.md

Creates an instance of the binder by providing the context, the loaded ad, and the video players for content and ads.

```kotlin
InstreamAdBinder(
    context: Context,
    instreamAd: InstreamAd,
    contentVideoPlayer: VideoPlayer,
    adVideoPlayer: VideoPlayer
)
```

```kotlin
val binder = InstreamAdBinder(
    this,
    instreamAd,
    contentVideoPlayer,
    adVideoPlayer
)
```

--------------------------------

### Initialize BannerAdView in Kotlin

Source: https://github.com/yandexmobile/yandex-ads-sdk-android/blob/master/_autodocs/api-reference/BannerAds.md

Instantiate the BannerAdView and add it to a container view.

```kotlin
import com.yandex.mobile.ads.banner.BannerAdView

val bannerAdView = BannerAdView(context)
container.addView(bannerAdView)
```

--------------------------------

### YandexAds.initialize(context, callback)

Source: https://github.com/yandexmobile/yandex-ads-sdk-android/blob/master/_autodocs/api-reference/YandexAds.md

Initializes the Yandex Mobile Ads SDK. This method must be called before requesting any ads.

```APIDOC
## YandexAds.initialize(context, callback)

### Description
Initializes the Yandex Mobile Ads SDK. Must be called before requesting any ads.

### Parameters
- **context** (Context) - Required - Application context
- **callback** (() -> Unit) - Required - Invoked when SDK initialization is complete

### Returns
- **Unit**
```

--------------------------------

### Initialize Sticky320x50 BannerSize

Source: https://github.com/yandexmobile/yandex-ads-sdk-android/blob/master/_autodocs/api-reference/ComposeAds.md

Creates an instance of the 320x50 sticky banner.

```kotlin
val size = BannerSize.Sticky320x50
```

--------------------------------

### Project File Structure

Source: https://github.com/yandexmobile/yandex-ads-sdk-android/blob/master/_autodocs/INDEX.md

Displays the directory layout of the documentation output.

```text
output/
├── README.md                    # Start here
├── EXPORTS.md                   # All exported symbols
├── INDEX.md                     # This file
├── types.md                     # Type definitions
├── configuration.md             # Setup & config
├── errors.md                    # Error reference
└── api-reference/               # Detailed API docs
    ├── YandexAds.md            # Core SDK
    ├── BannerAds.md
    ├── InterstitialAds.md
    ├── RewardedAds.md
    ├── NativeAds.md
    ├── AppOpenAds.md
    ├── InstreamAds.md
    ├── ComposeAds.md           # Jetpack Compose
    ├── CommonTypes.md          # Shared types
    └── MediationAdapters.md    # Third-party networks
```

--------------------------------

### AppOpenAdLoadListener Interface Methods

Source: https://github.com/yandexmobile/yandex-ads-sdk-android/blob/master/_autodocs/api-reference/AppOpenAds.md

Methods for handling successful ad loading and load failures.

```kotlin
fun onAdLoaded(ad: AppOpenAd)
```

```kotlin
fun onAdFailedToLoad(error: AdRequestError)
```

--------------------------------

### Run compilation check

Source: https://github.com/yandexmobile/yandex-ads-sdk-android/blob/master/YandexMobileAdsExample/skills/migrate-yandex-ads-sdk-from-7-to-8/SKILL.md

Execute this command after completing migration steps to identify complex build issues.

```bash
./gradlew compileDebugSources 2>&1 | tee build.log
```

--------------------------------

### show(activity: Activity)

Source: https://github.com/yandexmobile/yandex-ads-sdk-android/blob/master/_autodocs/api-reference/AppOpenAds.md

Displays the loaded app open ad. This method must be invoked on the main thread.

```APIDOC
## show(activity: Activity)

### Description
Displays the app open ad. Must be called from the main thread.

### Parameters
- **activity** (Activity) - Required - Activity to show the ad in

### Returns
- **Unit**

### Throws
- **IllegalStateException** - If called on a background thread or before ad is loaded

### Example
```kotlin
appOpenAd.show(this)
```
```

--------------------------------

### Initialize NativeAdLoader

Source: https://github.com/yandexmobile/yandex-ads-sdk-android/blob/master/_autodocs/api-reference/NativeAds.md

Instantiate the loader using the application or activity context.

```kotlin
import com.yandex.mobile.ads.nativeads.NativeAdLoader

val loader = NativeAdLoader(context)
```

--------------------------------

### Initialize RewardedAdLoader

Source: https://github.com/yandexmobile/yandex-ads-sdk-android/blob/master/_autodocs/api-reference/RewardedAds.md

Instantiate the loader using the application or activity context.

```kotlin
import com.yandex.mobile.ads.rewarded.RewardedAdLoader

val loader = RewardedAdLoader(context)
```

--------------------------------

### RewardedAdLoader(context: Context)

Source: https://github.com/yandexmobile/yandex-ads-sdk-android/blob/master/_autodocs/api-reference/RewardedAds.md

Constructor for initializing the RewardedAdLoader with the provided application or activity context.

```APIDOC
## Constructor: RewardedAdLoader(context: Context)

### Description
Initializes a new instance of the RewardedAdLoader to fetch rewarded advertisements.

### Parameters
- **context** (Context) - Required - Application or activity context.

### Example
```kotlin
import com.yandex.mobile.ads.rewarded.RewardedAdLoader

val loader = RewardedAdLoader(context)
```
```

--------------------------------

### Load an App Open Ad

Source: https://github.com/yandexmobile/yandex-ads-sdk-android/blob/master/_autodocs/api-reference/AppOpenAds.md

Fetch an advertisement using an AdRequest and handle the result via the AppOpenAdLoadListener callback.

```kotlin
val adRequest = AdRequest.Builder("demo-appopenad-admob").build()
loader.loadAd(adRequest, object : AppOpenAdLoadListener {
    override fun onAdLoaded(ad: AppOpenAd) {
        appOpenAd = ad
    }
    override fun onAdFailedToLoad(error: AdRequestError) {
        Log.e("AppOpen", error.description)
    }
})
```

--------------------------------

### Initialize Yandex Ads SDK

Source: https://github.com/yandexmobile/yandex-ads-sdk-android/blob/master/_autodocs/README.md

Initialize the SDK within the Application class, ensuring privacy settings are configured before initialization.

```kotlin
import com.yandex.mobile.ads.common.YandexAds

class MyApplication : Application() {
    override fun onCreate() {
        super.onCreate()
        
        // Configure privacy settings
        val prefs = PreferenceManager.getDefaultSharedPreferences(this)
        YandexAds.setUserConsent(prefs.getBoolean("gdpr_consent", false))
        
        // Initialize SDK
        YandexAds.initialize(this) {
            Log.d("Ads", "SDK initialized")
        }
    }
}
```

--------------------------------

### Initialize Yandex Mobile Ads SDK

Source: https://github.com/yandexmobile/yandex-ads-sdk-android/blob/master/_autodocs/api-reference/YandexAds.md

Must be called before requesting any ads. The callback is invoked once the SDK is fully initialized.

```kotlin
fun initialize(context: Context, callback: () -> Unit)
```

```kotlin
import com.yandex.mobile.ads.common.YandexAds

class MyApplication : Application() {
    override fun onCreate() {
        super.onCreate()
        YandexAds.initialize(this) {
            // SDK is ready, now you can load ads
        }
    }
}
```

--------------------------------

### Initialize Sticky728x90 BannerSize

Source: https://github.com/yandexmobile/yandex-ads-sdk-android/blob/master/_autodocs/api-reference/ComposeAds.md

Creates an instance of the 728x90 sticky banner.

```kotlin
val size = BannerSize.Sticky728x90
```

--------------------------------

### Accessing NativeAdImage

Source: https://github.com/yandexmobile/yandex-ads-sdk-android/blob/master/_autodocs/api-reference/CommonTypes.md

Demonstrates how to retrieve and display an icon from a native ad.

```kotlin
val icon: NativeAdImage? = nativeAd.adInfo.icon
if (icon != null) {
    icon.bitmap?.let { imageView.setImageBitmap(it) }
}
```

--------------------------------

### Context Parameter Usage

Source: https://github.com/yandexmobile/yandex-ads-sdk-android/blob/master/_autodocs/api-reference/CommonTypes.md

Illustrates recommended ways to provide context to ad loaders in different Android components.

```kotlin
// In Activity
val loader = BannerAdLoader(this)

// In Fragment
val loader = BannerAdLoader(requireContext())

// Global context (if needed)
val loader = BannerAdLoader(applicationContext)
```

--------------------------------

### Implement Banner Ad in Compose

Source: https://github.com/yandexmobile/yandex-ads-sdk-android/blob/master/_autodocs/api-reference/ComposeAds.md

Demonstrates the use of rememberBannerAdState and the Banner composable to load and display ads with event handling.

```kotlin
@Composable
fun BannerScreen() {
    var adUnitId by remember { mutableStateOf("demo-banner-yandex") }
    var logs by remember { mutableStateOf("") }

    val bannerState = rememberBannerAdState(
        adSize = BannerSize.Inline(width = 320.dp, maxHeight = 250.dp),
        events = BannerEvents(
            onAdLoaded = { _ -> 
                logs = "$logs\nAd loaded" 
            },
            onAdFailedToLoad = { error -> 
                logs = "$logs\nLoad failed: ${error.description}" 
            },
            onAdClicked = { 
                logs = "$logs\nClicked" 
            },
            onImpression = { 
                logs = "$logs\nImpression" 
            }
        )
    )

    LaunchedEffect(adUnitId) {
        bannerState.loadAd(AdRequest.Builder(adUnitId).build())
    }

    Column(modifier = Modifier.padding(16.dp)) {
        OutlinedTextField(
            value = adUnitId,
            onValueChange = { adUnitId = it },
            label = { Text("Ad Unit ID") }
        )
        
        Banner(
            state = bannerState,
            modifier = Modifier.fillMaxWidth()
        )
        
        Text(logs)
    }
}
```

--------------------------------

### Initialize BannerSize in Compose

Source: https://github.com/yandexmobile/yandex-ads-sdk-android/blob/master/_autodocs/configuration.md

Shows how to use the Inline banner size within a rememberBannerAdState call.

```kotlin
val bannerState = rememberBannerAdState(
    adSize = BannerSize.Inline(width = 320.dp, maxHeight = 250.dp)
)
```

--------------------------------

### Load and Display Banner Ad

Source: https://github.com/yandexmobile/yandex-ads-sdk-android/blob/master/_autodocs/README.md

Create a BannerAdView, set the ad size, and load an ad using a specific ad unit ID.

```kotlin
import com.yandex.mobile.ads.banner.BannerAdView
import com.yandex.mobile.ads.common.AdRequest

val bannerView = BannerAdView(context)
bannerView.setAdSize(BannerAdSize.sticky320x50(context))
container.addView(bannerView)

val adRequest = AdRequest.Builder("demo-banner-yandex").build()
bannerView.loadAd(adRequest)
```

--------------------------------

### Initialize Inline BannerSize

Source: https://github.com/yandexmobile/yandex-ads-sdk-android/blob/master/_autodocs/api-reference/ComposeAds.md

Creates an instance of an inline banner with specific dimensions.

```kotlin
val size = BannerSize.Inline(width = 320.dp, maxHeight = 250.dp)
```

--------------------------------

### Initialize BannerEvents

Source: https://github.com/yandexmobile/yandex-ads-sdk-android/blob/master/_autodocs/api-reference/ComposeAds.md

Configures event handlers for banner ad lifecycle events.

```kotlin
val events = BannerEvents(
    onAdLoaded = { ad ->
        Log.d("Banner", "Ad loaded")
    },
    onAdFailedToLoad = { error ->
        Log.e("Banner", "Load error: ${error.description}")
    },
    onAdClicked = {
        Log.d("Banner", "User clicked")
    },
    onImpression = { data ->
        Log.d("Banner", "Impression: ${data?.rawData}")
    }
)
```

--------------------------------

### YandexAds SDK Initialization

Source: https://github.com/yandexmobile/yandex-ads-sdk-android/blob/master/_autodocs/configuration.md

Global configuration methods for the Yandex Mobile Ads SDK, including logging, privacy, and initialization.

```APIDOC
## YandexAds.initialize(context: Context, completion: () -> Unit)

### Description
Initializes the Yandex Mobile Ads SDK.

## YandexAds.enableLogging(enabled: Boolean)

### Description
Enables or disables debug logging for the SDK.

## YandexAds.setUserConsent(consent: Boolean)

### Description
Configures user consent settings for ad personalization.

## YandexAds.setLocationTracking(enabled: Boolean)

### Description
Configures whether the SDK should track user location.

## YandexAds.setAgeRestricted(restricted: Boolean)

### Description
Sets the age-restricted status for the user.
```

--------------------------------

### Configuring NativeAdViewBinder

Source: https://github.com/yandexmobile/yandex-ads-sdk-android/blob/master/_autodocs/api-reference/NativeAds.md

Initializes a binder instance by mapping UI elements from a layout to the native ad components.

```kotlin
val binder = NativeAdViewBinder.Builder(rootView)
    .setTitleView(binding.title)
    .setBodyView(binding.body)
    .setIconView(binding.icon)
    .setMediaView(binding.media)
    .setCallToActionView(binding.callToAction)
    .setRatingView(binding.rating)
    .setReviewCountView(binding.reviewCount)
    .setDomainView(binding.domain)
    .setFaviconView(binding.favicon)
    .setPriceView(binding.price)
    .setSponsoredView(binding.sponsored)
    .build()
```

--------------------------------

### YandexAds.initialize()

Source: https://github.com/yandexmobile/yandex-ads-sdk-android/blob/master/_autodocs/configuration.md

Initializes the Yandex Mobile Ads SDK. This must be called before loading any ads, preferably in the Application or MainActivity onCreate method.

```APIDOC
## YandexAds.initialize(context: Context, callback: () -> Unit)

### Description
Initializes the SDK. Must be called before loading any ads.

### Parameters
- **context** (Context) - Required - Application context
- **callback** (() -> Unit) - Required - Called when initialization completes

### Example
```kotlin
YandexAds.initialize(this) { Log.d("SDK", "Initialized") }
```
```

--------------------------------

### AppOpenAdEventListener Interface Methods

Source: https://github.com/yandexmobile/yandex-ads-sdk-android/blob/master/_autodocs/api-reference/AppOpenAds.md

Methods for tracking ad display, dismissal, clicks, and impression events.

```kotlin
fun onAdShown()
```

```kotlin
fun onAdFailedToShow(adError: AdError)
```

```kotlin
fun onAdDismissed()
```

```kotlin
fun onAdClicked()
```

```kotlin
fun onAdImpression(data: ImpressionData?)
```

--------------------------------

### Initialize InstreamAdLoader in Kotlin

Source: https://github.com/yandexmobile/yandex-ads-sdk-android/blob/master/_autodocs/api-reference/InstreamAds.md

Instantiate the loader using an application or activity context.

```kotlin
import com.yandex.mobile.ads.instream.InstreamAdLoader

val loader = InstreamAdLoader(context)
```

--------------------------------

### Configure NativeAdOptions

Source: https://github.com/yandexmobile/yandex-ads-sdk-android/blob/master/_autodocs/api-reference/NativeAds.md

Defines the configuration for native ad loading using the Builder pattern.

```kotlin
class Builder {
    fun setShouldLoadImagesAutomatically(loadImages: Boolean): Builder
    fun build(): NativeAdOptions
}
```

```kotlin
val options = NativeAdOptions.Builder()
    .setShouldLoadImagesAutomatically(true)
    .build()
```

--------------------------------

### Configure Banner Ad Size in Kotlin

Source: https://github.com/yandexmobile/yandex-ads-sdk-android/blob/master/_autodocs/api-reference/BannerAds.md

Define the banner size using BannerAdSize and apply it to the view.

```kotlin
val bannerSize = BannerAdSize.sticky320x50(context)
bannerAdView.setAdSize(bannerSize)
```

--------------------------------

### Initialize BannerAdState in Compose

Source: https://github.com/yandexmobile/yandex-ads-sdk-android/blob/master/_autodocs/api-reference/ComposeAds.md

Creates and remembers a banner ad state with specific size and event callbacks.

```kotlin
import com.yandex.mobile.ads.compose.Banner
import com.yandex.mobile.ads.compose.BannerSize
import com.yandex.mobile.ads.compose.rememberBannerAdState

val bannerState = rememberBannerAdState(
    adSize = BannerSize.Inline(width = 320.dp, maxHeight = 250.dp),
    events = BannerEvents(
        onAdLoaded = { Log.d("Banner", "Loaded") },
        onAdFailedToLoad = { error -> Log.e("Banner", error.description) },
        onAdClicked = { Log.d("Banner", "Clicked") },
        onImpression = { Log.d("Banner", "Impression") }
    )
)
```

--------------------------------

### Implement Ad Loading Fallback Strategy in Kotlin

Source: https://github.com/yandexmobile/yandex-ads-sdk-android/blob/master/_autodocs/api-reference/MediationAdapters.md

Handles ad loading failures by differentiating between no-fill scenarios and network errors to trigger appropriate fallback actions.

```kotlin
private fun loadAdWithFallback() {
    // Try to load from mediation
    mediationLoader.loadAd(adRequest, object : LoadListener {
        override fun onAdLoaded(ad: Any) {
            displayAd(ad)
        }
        override fun onAdFailedToLoad(error: AdRequestError) {
            // Fallback to house ad or skip
            if (error.code == 0) {
                // No fill - show house ad
                displayHouseAd()
            } else {
                // Network error - retry later
                scheduleRetry()
            }
        }
    })
}
```

--------------------------------

### InstreamAdLoader(context: Context)

Source: https://github.com/yandexmobile/yandex-ads-sdk-android/blob/master/_autodocs/api-reference/InstreamAds.md

Constructor for the InstreamAdLoader class, which is responsible for fetching instream video advertisements.

```APIDOC
## InstreamAdLoader(context: Context)

### Description
Initializes a new instance of the InstreamAdLoader to fetch video advertisements.

### Parameters
- **context** (Context) - Required - Application or activity context

### Example
```kotlin
import com.yandex.mobile.ads.instream.InstreamAdLoader

val loader = InstreamAdLoader(context)
```
```

--------------------------------

### loadAd(adRequest: AdRequest, listener: AppOpenAdLoadListener)

Source: https://github.com/yandexmobile/yandex-ads-sdk-android/blob/master/_autodocs/api-reference/AppOpenAds.md

Initiates the loading of an app open advertisement using the provided request configuration and listener for callbacks.

```APIDOC
## loadAd()

### Description
Loads an app open advertisement.

### Signature
`fun loadAd(adRequest: AdRequest, listener: AppOpenAdLoadListener)`

### Parameters
- **adRequest** (AdRequest) - Required - Ad request with unit ID
- **listener** (AppOpenAdLoadListener) - Required - Callback for load result

### Example
```kotlin
val adRequest = AdRequest.Builder("demo-appopenad-admob").build()
loader.loadAd(adRequest, object : AppOpenAdLoadListener {
    override fun onAdLoaded(ad: AppOpenAd) {
        appOpenAd = ad
    }
    override fun onAdFailedToLoad(error: AdRequestError) {
        Log.e("AppOpen", error.description)
    }
})
```

--------------------------------

### Implement NativeAdLoadListener

Source: https://github.com/yandexmobile/yandex-ads-sdk-android/blob/master/_autodocs/api-reference/NativeAds.md

Handles native ad loading events through success and failure callbacks.

```kotlin
fun onAdLoaded(nativeAd: NativeAd)
```

```kotlin
fun onAdFailedToLoad(error: AdRequestError)
```

--------------------------------

### Initialize SDK for Mediation Adapters

Source: https://github.com/yandexmobile/yandex-ads-sdk-android/blob/master/ThirdPartyMediationAdapterTemplate/README.md

Use initializeForAdapter to register adapter identity globally, ensuring adapter parameters are included in all ad requests.

```kotlin
val adapterIdentity = AdapterIdentity(
    adapterNetworkName = "your_network_name",
    adapterVersion = "1.0.0.0",
    adapterNetworkVersion = "1.0.0"
)

MobileAds.initializeForAdapter(context, adapterIdentity) {
    onInitializationComplete.invoke()
}
```

--------------------------------

### MobileAds.initializeForAdapter

Source: https://github.com/yandexmobile/yandex-ads-sdk-android/blob/master/ThirdPartyMediationAdapterTemplate/README.md

Initializes the SDK specifically for mediation adapters, storing adapter identity globally.

```APIDOC
## MobileAds.initializeForAdapter(context, adapterIdentity, completionListener)

### Description
Initializes the Yandex Mobile Ads SDK for mediation adapters. This method stores the adapter identity globally and automatically includes adapter parameters in all requests.

### Parameters
- **context** (Context) - The application context.
- **adapterIdentity** (AdapterIdentity) - Object containing adapterNetworkName, adapterVersion, and adapterNetworkVersion.
- **completionListener** (Function) - Callback invoked when initialization is complete.
```

--------------------------------

### Configure Ad Request with Custom Parameters

Source: https://github.com/yandexmobile/yandex-ads-sdk-android/blob/master/_autodocs/configuration.md

Builds an ad request with a specific ad unit ID and optional custom network parameters.

```kotlin
class AdRequest.Builder(adUnitId: String) {
    fun setParameters(parameters: Map<String, String>): Builder
    fun build(): AdRequest
}
```

```kotlin
val adRequest = AdRequest.Builder("demo-banner-yandex")
    .setParameters(mapOf(
        "adf_ownerid" to "270901",
        "adf_p1" to "cqtgh",
        "adf_p2" to "fkbd"
    ))
    .build()
```

--------------------------------

### loadAd(adRequest: AdRequest, listener: RewardedAdLoadListener)

Source: https://github.com/yandexmobile/yandex-ads-sdk-android/blob/master/_autodocs/api-reference/RewardedAds.md

Method to initiate the loading of a rewarded advertisement using an ad request and a listener for callbacks.

```APIDOC
## Method: loadAd(adRequest: AdRequest, listener: RewardedAdLoadListener)

### Description
Loads a rewarded advertisement. The result is returned via the provided listener.

### Parameters
- **adRequest** (AdRequest) - Required - Ad request containing the unit ID.
- **listener** (RewardedAdLoadListener) - Required - Callback interface for handling load success or failure.

### Example
```kotlin
val adRequest = AdRequest.Builder("demo-rewarded-yandex").build()
loader.loadAd(adRequest, object : RewardedAdLoadListener {
    override fun onAdLoaded(ad: RewardedAd) {
        rewardedAd = ad
    }
    override fun onAdFailedToLoad(error: AdRequestError) {
        Log.e("Rewarded", error.description)
    }
})
```

--------------------------------

### InstreamAdBinder Constructor

Source: https://github.com/yandexmobile/yandex-ads-sdk-android/blob/master/_autodocs/api-reference/InstreamAds.md

Initializes a new instance of the InstreamAdBinder to link an instream ad with content and ad video players.

```APIDOC
## InstreamAdBinder(context, instreamAd, contentVideoPlayer, adVideoPlayer)

### Description
Initializes the binder with the required context, the loaded instream ad, and the video players for both content and ads.

### Parameters
- **context** (Context) - Required - Application or activity context
- **instreamAd** (InstreamAd) - Required - The loaded instream ad
- **contentVideoPlayer** (VideoPlayer) - Required - Player for main content video
- **adVideoPlayer** (VideoPlayer) - Required - Player for ad video
```

--------------------------------

### Handle Ad Loading Failures with Graceful Degradation

Source: https://github.com/yandexmobile/yandex-ads-sdk-android/blob/master/_autodocs/errors.md

Updates UI visibility states to hide banner containers and show fallback content when an ad fails to load.

```kotlin
private fun loadBannerAd() {
    loader.loadAd(adRequest, object : BannerAdEventListener {
        override fun onAdFailedToLoad(error: AdRequestError) {
            Log.w("Ads", "Banner failed to load")
            // Show placeholder or skip ad space
            bannerContainer.visibility = View.GONE
            contentContainer.visibility = View.VISIBLE
        }
        
        override fun onAdLoaded() {
            Log.d("Ads", "Banner loaded")
            bannerContainer.visibility = View.VISIBLE
        }
    })
}
```

--------------------------------

### Load Native Ad

Source: https://github.com/yandexmobile/yandex-ads-sdk-android/blob/master/_autodocs/README.md

Use NativeAdLoader to load native ads with specific options, binding the ad to views upon successful loading.

```kotlin
import com.yandex.mobile.ads.nativeads.NativeAdLoader

val loader = NativeAdLoader(context)
val options = NativeAdOptions.Builder()
    .setShouldLoadImagesAutomatically(true)
    .build()
val adRequest = AdRequest.Builder("demo-native-yandex").build()

loader.loadAd(adRequest, options, object : NativeAdLoadListener {
    override fun onAdLoaded(nativeAd: NativeAd) {
        // Bind native ad to views
    }
    override fun onAdFailedToLoad(error: AdRequestError) {
        Log.e("Ads", error.description)
    }
})
```

--------------------------------

### Configure Optional Manifest Permissions

Source: https://github.com/yandexmobile/yandex-ads-sdk-android/blob/master/_autodocs/configuration.md

Add these permissions to improve ad targeting capabilities based on user location.

```xml
<uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />
<uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION" />
```

--------------------------------

### Load Banner Ad in Kotlin

Source: https://github.com/yandexmobile/yandex-ads-sdk-android/blob/master/_autodocs/api-reference/BannerAds.md

Create an AdRequest with a unit ID and load the ad into the view.

```kotlin
val adRequest = AdRequest.Builder("demo-banner-yandex").build()
bannerAdView.loadAd(adRequest)
```

--------------------------------

### Initialize InterstitialAdLoader

Source: https://github.com/yandexmobile/yandex-ads-sdk-android/blob/master/_autodocs/api-reference/InterstitialAds.md

Create an instance of InterstitialAdLoader using the application or activity context.

```kotlin
import com.yandex.mobile.ads.interstitial.InterstitialAdLoader

val loader = InterstitialAdLoader(context)
```

--------------------------------

### Create Bidder Token Request Configuration

Source: https://github.com/yandexmobile/yandex-ads-sdk-android/blob/master/ThirdPartyMediationAdapterTemplate/README.md

Define the configuration for the bidder token request based on the specific ad type.

```kotlin
fun createBidderTokenRequestConfiguration(): BidderTokenRequestConfiguration {
    return when (adType) {
        AdType.BANNER -> BidderTokenRequestConfiguration.banner(bannerAdSize)
        AdType.INTERSTITIAL -> BidderTokenRequestConfiguration.interstitial()
        AdType.REWARDED -> BidderTokenRequestConfiguration.rewarded()
        AdType.NATIVE -> BidderTokenRequestConfiguration.native()
        AdType.APP_OPEN_AD -> BidderTokenRequestConfiguration.appOpenAd()
    }
}
```

--------------------------------

### Implement InstreamAdLoadListener callbacks

Source: https://github.com/yandexmobile/yandex-ads-sdk-android/blob/master/_autodocs/api-reference/InstreamAds.md

Methods for handling successful ad loading and load failures.

```kotlin
fun onInstreamAdLoaded(ad: InstreamAd)
```

```kotlin
fun onInstreamAdFailedToLoad(error: InstreamAdRequestError)
```

--------------------------------

### Load and Display Rewarded Ad

Source: https://github.com/yandexmobile/yandex-ads-sdk-android/blob/master/_autodocs/README.md

Use RewardedAdLoader to load and show a rewarded ad, handling success and failure callbacks.

```kotlin
import com.yandex.mobile.ads.rewarded.RewardedAdLoader

val loader = RewardedAdLoader(context)
val adRequest = AdRequest.Builder("demo-rewarded-yandex").build()

loader.loadAd(adRequest, object : RewardedAdLoadListener {
    override fun onAdLoaded(ad: RewardedAd) {
        ad.show(activity)
    }
    override fun onAdFailedToLoad(error: AdRequestError) {
        Log.e("Ads", error.description)
    }
})
```

--------------------------------

### Implement InstreamAdListener callbacks

Source: https://github.com/yandexmobile/yandex-ads-sdk-android/blob/master/_autodocs/api-reference/InstreamAds.md

Methods for tracking ad playback lifecycle events and errors.

```kotlin
fun onInstreamAdCompleted()
```

```kotlin
fun onInstreamAdPrepared()
```

```kotlin
fun onError(error: String)
```

--------------------------------

### loadAd(adRequest, options, listener)

Source: https://github.com/yandexmobile/yandex-ads-sdk-android/blob/master/_autodocs/api-reference/NativeAds.md

Loads a native advertisement using the provided request, options, and listener.

```APIDOC
## loadAd(adRequest: AdRequest, options: NativeAdOptions, listener: NativeAdLoadListener)

### Description
Loads a native advertisement.

### Parameters
- **adRequest** (AdRequest) - Required - Ad request with unit ID
- **options** (NativeAdOptions) - Required - Native ad options
- **listener** (NativeAdLoadListener) - Required - Callback for load result

### Example
```kotlin
val options = NativeAdOptions.Builder()
    .setShouldLoadImagesAutomatically(true)
    .build()
val adRequest = AdRequest.Builder("demo-native-yandex").build()
loader.loadAd(adRequest, options, object : NativeAdLoadListener {
    override fun onAdLoaded(nativeAd: NativeAd) {
        bindNativeAd(nativeAd)
    }
    override fun onAdFailedToLoad(error: AdRequestError) {
        Log.e("Native", error.description)
    }
})
```

--------------------------------

### Configure project repositories for mediation

Source: https://github.com/yandexmobile/yandex-ads-sdk-android/blob/master/README.md

Add the required Maven repositories to your project-level build.gradle file to support various mediation partners.

```gradle
allprojects {
    repositories {

        ...

        // IronSource
        maven { url 'https://android-sdk.is.com/' }

        // Pangle
        maven { url 'https://artifact.bytedance.com/repository/pangle' }

        // Tapjoy
        maven { url 'https://sdk.tapjoy.com/' }

        // BidMachine
        maven { url 'https://artifactory.bidmachine.io/bidmachine' }

        // Mintegral
        maven { url 'https://dl-maven-android.mintegral.com/repository/mbridge_android_sdk_oversea'}

        // Chartboost
        maven { url 'https://cboost.jfrog.io/artifactory/chartboost-ads/' }

        // AppNext
        maven { url 'https://dl.appnext.com/' }
    }
}
```

--------------------------------

### Configure Mediation Dependencies

Source: https://github.com/yandexmobile/yandex-ads-sdk-android/blob/master/_autodocs/api-reference/MediationAdapters.md

Include the core mediation library and specific network adapters in your build.gradle file.

```gradle
dependencies {
    // Core SDK with mediation support
    implementation 'com.yandex.android:mobileads-mediation:8.3.0.0'
    
    // Optional: Include specific adapters
    implementation 'com.yandex.ads.mediation:mobileads-admob:9.19.0.0'
    implementation 'com.yandex.ads.mediation:mobileads-applovin:12.0.1.0'
    
    // Optional: Compose support
    implementation 'com.yandex.android:mobileads-compose:8.3.0'
}
```

--------------------------------

### InterstitialAdLoader(Context context)

Source: https://github.com/yandexmobile/yandex-ads-sdk-android/blob/master/_autodocs/api-reference/InterstitialAds.md

Constructor for initializing the InterstitialAdLoader with the required application or activity context.

```APIDOC
### Constructor

`InterstitialAdLoader(context: Context)`

#### Parameters
- **context** (Context) - Required - Application or activity context

#### Example
```kotlin
import com.yandex.mobile.ads.interstitial.InterstitialAdLoader

val loader = InterstitialAdLoader(context)
```
```

--------------------------------

### Show App Open Ad

Source: https://github.com/yandexmobile/yandex-ads-sdk-android/blob/master/_autodocs/api-reference/AppOpenAds.md

Displays the loaded ad within the specified activity. Must be invoked on the main thread.

```kotlin
appOpenAd.show(this)
```

--------------------------------

### Configure Native Ad Image Loading

Source: https://github.com/yandexmobile/yandex-ads-sdk-android/blob/master/_autodocs/configuration.md

Sets whether the SDK should automatically download images for native ads. When disabled, only image URLs are provided.

```kotlin
class NativeAdOptions.Builder {
    fun setShouldLoadImagesAutomatically(loadImages: Boolean): Builder
    fun build(): NativeAdOptions
}
```

```kotlin
val options = NativeAdOptions.Builder()
    .setShouldLoadImagesAutomatically(true)
    .build()

loader.loadAd(adRequest, options, listener)
```

--------------------------------

### Define BannerAdSize for Classic Views

Source: https://github.com/yandexmobile/yandex-ads-sdk-android/blob/master/_autodocs/configuration.md

Provides the companion object methods for creating sticky and inline banner sizes in classic Android views.

```kotlin
companion object {
    fun sticky320x50(context: Context): BannerAdSize
    fun sticky728x90(context: Context): BannerAdSize
    fun inline(context: Context, width: Int, maxHeight: Int): BannerAdSize
}
```

--------------------------------

### AppOpenAdLoadListener

Source: https://github.com/yandexmobile/yandex-ads-sdk-android/blob/master/_autodocs/api-reference/AppOpenAds.md

Interface for handling app open ad loading events.

```APIDOC
## onAdLoaded(ad: AppOpenAd)

### Description
Called when an app open ad is successfully loaded.

### Parameters
- **ad** (AppOpenAd) - The loaded ad ready to show

## onAdFailedToLoad(error: AdRequestError)

### Description
Called when an app open ad fails to load.

### Parameters
- **error** (AdRequestError) - Error details including code and description
```

--------------------------------

### Define and apply inline banner size

Source: https://github.com/yandexmobile/yandex-ads-sdk-android/blob/master/_autodocs/api-reference/BannerAds.md

Creates a flexible inline banner size with custom width and maximum height, then applies it to a BannerAdView.

```kotlin
companion object {
    fun inline(context: Context, width: Int, maxHeight: Int): BannerAdSize
}
```

```kotlin
val inlineSize = BannerAdSize.inline(context, 320, 250)
bannerAdView.setAdSize(inlineSize)
```

--------------------------------

### show(Activity activity)

Source: https://github.com/yandexmobile/yandex-ads-sdk-android/blob/master/_autodocs/api-reference/RewardedAds.md

Displays the loaded rewarded advertisement. This method must be invoked on the main thread.

```APIDOC
## show(Activity activity)

### Description
Displays the rewarded ad. Must be called from the main thread.

### Parameters
- **activity** (Activity) - Required - Activity to show the ad in

### Throws
- **IllegalStateException** - If called on a background thread or before ad is loaded

### Example
```kotlin
rewardedAd.show(this)
```
```

--------------------------------

### NativeAdOptions

Source: https://github.com/yandexmobile/yandex-ads-sdk-android/blob/master/_autodocs/types.md

Configuration class for native ad loading, allowing control over automatic image downloading.

```APIDOC
## NativeAdOptions

### Description
Configuration for native ad loading behavior.

### Builder Methods
- **setShouldLoadImagesAutomatically(loadImages: Boolean)**: Configures whether images should be downloaded automatically. Default is true.
```

--------------------------------

### Load Native Advertisement

Source: https://github.com/yandexmobile/yandex-ads-sdk-android/blob/master/_autodocs/api-reference/NativeAds.md

Fetch a native ad by providing an AdRequest, NativeAdOptions, and a NativeAdLoadListener to handle results.

```kotlin
val options = NativeAdOptions.Builder()
    .setShouldLoadImagesAutomatically(true)
    .build()
val adRequest = AdRequest.Builder("demo-native-yandex").build()
loader.loadAd(adRequest, options, object : NativeAdLoadListener {
    override fun onAdLoaded(nativeAd: NativeAd) {
        bindNativeAd(nativeAd)
    }
    override fun onAdFailedToLoad(error: AdRequestError) {
        Log.e("Native", error.description)
    }
})
```

--------------------------------

### loadAd(adRequest: InstreamAdRequest, listener: InstreamAdLoadListener)

Source: https://github.com/yandexmobile/yandex-ads-sdk-android/blob/master/_autodocs/api-reference/InstreamAds.md

Method to initiate the loading of an instream advertisement using a request configuration and a callback listener.

```APIDOC
## loadAd(adRequest: InstreamAdRequest, listener: InstreamAdLoadListener)

### Description
Loads an instream advertisement based on the provided request configuration.

### Parameters
- **adRequest** (InstreamAdRequest) - Required - Instream ad request with Page ID
- **listener** (InstreamAdLoadListener) - Required - Callback for load result

### Example
```kotlin
val adRequest = InstreamAdRequest.Builder("demo-instream-vmap-yandex").build()
loader.loadAd(adRequest, object : InstreamAdLoadListener {
    override fun onInstreamAdLoaded(ad: InstreamAd) {
        showInstreamAd(ad)
    }
    override fun onInstreamAdFailedToLoad(error: InstreamAdRequestError) {
        Log.e("Instream", error.description)
    }
})
```
```

--------------------------------

### Banner()

Source: https://github.com/yandexmobile/yandex-ads-sdk-android/blob/master/_autodocs/api-reference/ComposeAds.md

Renders a banner ad composable.

```APIDOC
## Banner()

### Description
Renders a banner ad composable.

### Signature
`@Composable fun Banner(state: BannerAdState, modifier: Modifier = Modifier)`

### Parameters
- **state** (BannerAdState) - Required - Banner ad state from rememberBannerAdState
- **modifier** (Modifier) - Optional - Compose modifier for layout/styling

### Returns
- **Unit**
```

--------------------------------

### AppOpenAdLoader

Source: https://github.com/yandexmobile/yandex-ads-sdk-android/blob/master/_autodocs/EXPORTS.md

Handles the loading and cancellation of App Open Ads.

```APIDOC
## AppOpenAdLoader(Context)

### Methods
- **loadAd(AdRequest, AppOpenAdLoadListener): Unit** - Loads an App Open Ad.
- **cancelLoading(): Unit** - Cancels the current ad loading process.
```

--------------------------------

### Add Yandex Ads Dependencies

Source: https://github.com/yandexmobile/yandex-ads-sdk-android/blob/master/_autodocs/README.md

Include the core SDK and optional Compose support in your app-level build.gradle file.

```gradle
dependencies {
    implementation 'com.yandex.android:mobileads:8.3.0'
    // Optional: Compose support
    implementation 'com.yandex.android:mobileads-compose:8.3.0'
}
```

--------------------------------

### Implement onAdLoaded callback

Source: https://github.com/yandexmobile/yandex-ads-sdk-android/blob/master/_autodocs/api-reference/InterstitialAds.md

Triggered when an interstitial ad has been successfully loaded and is ready for display.

```kotlin
fun onAdLoaded(interstitialAd: InterstitialAd)
```

--------------------------------

### NativeAd

Source: https://github.com/yandexmobile/yandex-ads-sdk-android/blob/master/_autodocs/EXPORTS.md

Class representing a Native ad instance.

```APIDOC
## NativeAd

### Methods
- **bindNativeAd(NativeAdViewBinder): AdBindingResult** - Binds the native ad to a view binder.
- **setNativeAdEventListener(NativeAdEventListener?): Unit** - Sets the listener for ad events.
- **adInfo: NativeAdInfo** - Property to access native ad information.
```

--------------------------------

### show(activity: Activity)

Source: https://github.com/yandexmobile/yandex-ads-sdk-android/blob/master/_autodocs/api-reference/InterstitialAds.md

Displays the interstitial ad. This method must be invoked on the main thread.

```APIDOC
## show(activity: Activity)

### Description
Displays the interstitial ad. Must be called from the main thread.

### Parameters
- **activity** (Activity) - Required - Activity to show the ad in

### Returns
- **Unit**

### Throws
- **IllegalStateException** - If called on a background thread or before ad is loaded

### Example
```kotlin
interstitialAd.show(this)
```
```

--------------------------------

### RewardedAdLoadListener methods

Source: https://github.com/yandexmobile/yandex-ads-sdk-android/blob/master/_autodocs/api-reference/RewardedAds.md

Callbacks for handling the success or failure of a rewarded ad load request.

```kotlin
fun onAdLoaded(rewardedAd: RewardedAd)
```

```kotlin
fun onAdFailedToLoad(adRequestError: AdRequestError)
```

--------------------------------

### Implement onAdLoaded callback

Source: https://github.com/yandexmobile/yandex-ads-sdk-android/blob/master/_autodocs/api-reference/BannerAds.md

Triggered when a banner ad has been successfully loaded.

```kotlin
fun onAdLoaded()
```

--------------------------------

### AppOpenAd

Source: https://github.com/yandexmobile/yandex-ads-sdk-android/blob/master/_autodocs/EXPORTS.md

Represents a loaded App Open Ad and provides methods to display it and listen for events.

```APIDOC
## AppOpenAd

### Methods
- **show(Activity): Unit** - Displays the ad within the provided Activity.
- **setAdEventListener(AppOpenAdEventListener?): Unit** - Sets the listener for ad lifecycle events.
```

--------------------------------

### Handling InstreamAdRequestError

Source: https://github.com/yandexmobile/yandex-ads-sdk-android/blob/master/_autodocs/api-reference/CommonTypes.md

Shows how to log error descriptions when an instream ad fails to load.

```kotlin
override fun onInstreamAdFailedToLoad(error: InstreamAdRequestError) {
    Log.e("Instream", "Load failed: ${error.description}")
}
```

--------------------------------

### BannerAdSize.sticky320x50

Source: https://github.com/yandexmobile/yandex-ads-sdk-android/blob/master/_autodocs/api-reference/BannerAds.md

Creates a 320x50 sticky banner ad size.

```APIDOC
## BannerAdSize.sticky320x50(context: Context)

### Description
Creates a 320x50 sticky banner ad size.

### Parameters
- **context** (Context) - Required - Application or activity context

### Returns
- **BannerAdSize** - The configured banner ad size.
```

--------------------------------

### Configure Privacy Policies

Source: https://github.com/yandexmobile/yandex-ads-sdk-android/blob/master/ThirdPartyMediationAdapterTemplate/README.md

Set user consent and age restriction flags. Configure these settings before SDK initialization or reinitialize after changes.

```kotlin
MobileAds.setAgeRestrictedUser(params.isAgeRestrictedUser())
MobileAds.setLocationConsent(params.hasLocationConsent())
MobileAds.setUserConsent(params.hasUserConsent())
```

--------------------------------

### NativeAdLoader

Source: https://github.com/yandexmobile/yandex-ads-sdk-android/blob/master/_autodocs/EXPORTS.md

Class for loading Native ads.

```APIDOC
## NativeAdLoader(Context)

### Methods
- **loadAd(AdRequest, NativeAdOptions, NativeAdLoadListener): Unit** - Loads a native ad.
- **cancelLoading(): Unit** - Cancels the current ad loading process.
```

--------------------------------

### Load and Display Interstitial Ad

Source: https://github.com/yandexmobile/yandex-ads-sdk-android/blob/master/_autodocs/README.md

Use InterstitialAdLoader to load and show an interstitial ad, handling success and failure callbacks.

```kotlin
import com.yandex.mobile.ads.interstitial.InterstitialAdLoader

val loader = InterstitialAdLoader(context)
val adRequest = AdRequest.Builder("demo-interstitial-yandex").build()

loader.loadAd(adRequest, object : InterstitialAdLoadListener {
    override fun onAdLoaded(ad: InterstitialAd) {
        ad.show(activity)
    }
    override fun onAdFailedToLoad(error: AdRequestError) {
        Log.e("Ads", error.description)
    }
})
```

--------------------------------

### NativeAdOptions.Builder

Source: https://github.com/yandexmobile/yandex-ads-sdk-android/blob/master/_autodocs/api-reference/NativeAds.md

Configures options for loading native ads, such as automatic image downloading.

```APIDOC
## NativeAdOptions.Builder

### Description
Builder class used to configure settings for native ad loading.

### Methods
- **setShouldLoadImagesAutomatically(loadImages: Boolean)**: Configures whether to automatically download and set images in views. Default is true.
- **build()**: Returns a configured NativeAdOptions instance.

### Example
```kotlin
val options = NativeAdOptions.Builder()
    .setShouldLoadImagesAutomatically(true)
    .build()
```
```

--------------------------------

### Bind InstreamAd to View

Source: https://github.com/yandexmobile/yandex-ads-sdk-android/blob/master/_autodocs/api-reference/InstreamAds.md

Connects the ad binder to a specific container view for rendering the ad UI.

```kotlin
fun bind(instreamAdContainerView: View)
```

```kotlin
binder.bind(binding.instreamAdView)
```

--------------------------------

### Implement Exponential Backoff for Ad Loading

Source: https://github.com/yandexmobile/yandex-ads-sdk-android/blob/master/_autodocs/errors.md

Uses a retry counter and handler delay to attempt ad reloads with increasing wait times upon failure.

```kotlin
private var retryCount = 0
private val maxRetries = 3

private fun loadAdWithRetry() {
    retryCount = 0
    loadAdInternal()
}

private fun loadAdInternal() {
    loader.loadAd(adRequest, object : LoadListener {
        override fun onAdFailedToLoad(error: AdRequestError) {
            if (retryCount < maxRetries) {
                retryCount++
                val delayMs = 1000L * (1 shl retryCount) // 2^retryCount seconds
                handler.postDelayed({ loadAdInternal() }, delayMs)
            } else {
                Log.e("Ads", "Failed after $maxRetries retries")
            }
        }
    })
}
```

--------------------------------

### Implement onAdImpression callback

Source: https://github.com/yandexmobile/yandex-ads-sdk-android/blob/master/_autodocs/api-reference/InterstitialAds.md

Triggered when an ad impression is recorded, optionally providing impression analytics data.

```kotlin
fun onAdImpression(data: ImpressionData?)
```

--------------------------------

### Load Instream Ad in Kotlin

Source: https://github.com/yandexmobile/yandex-ads-sdk-android/blob/master/_autodocs/api-reference/InstreamAds.md

Use the loadAd method with an InstreamAdRequest and a listener to handle success or failure callbacks.

```kotlin
val adRequest = InstreamAdRequest.Builder("demo-instream-vmap-yandex").build()
loader.loadAd(adRequest, object : InstreamAdLoadListener {
    override fun onInstreamAdLoaded(ad: InstreamAd) {
        showInstreamAd(ad)
    }
    override fun onInstreamAdFailedToLoad(error: InstreamAdRequestError) {
        Log.e("Instream", error.description)
    }
})
```

--------------------------------

### bind()

Source: https://github.com/yandexmobile/yandex-ads-sdk-android/blob/master/_autodocs/api-reference/InstreamAds.md

Binds the instream ad to the specified container view for rendering.

```APIDOC
## bind(instreamAdContainerView)

### Description
Binds the instream ad to the specified container view.

### Parameters
- **instreamAdContainerView** (View) - Required - Container view for ad UI
```

--------------------------------

### NativeAdLoadListener

Source: https://github.com/yandexmobile/yandex-ads-sdk-android/blob/master/_autodocs/api-reference/NativeAds.md

Interface for receiving notifications about native ad loading status.

```APIDOC
## NativeAdLoadListener

### onAdLoaded(nativeAd: NativeAd)
Called when a native ad is successfully loaded.

### onAdFailedToLoad(error: AdRequestError)
Called when a native ad fails to load. Provides an AdRequestError object containing error details.
```

--------------------------------

### Configure Instream Ad Preloading

Source: https://github.com/yandexmobile/yandex-ads-sdk-android/blob/master/_autodocs/api-reference/YandexAds.md

Enables or disables preloading for instream ad groups.

```kotlin
fun setAdGroupPreloading(enabled: Boolean)
```

```kotlin
YandexInstreamAds.setAdGroupPreloading(true)
```

--------------------------------

### onAdLoaded()

Source: https://github.com/yandexmobile/yandex-ads-sdk-android/blob/master/_autodocs/api-reference/BannerAds.md

Triggered when a banner ad has been successfully loaded.

```APIDOC
## onAdLoaded()

### Description
Called when a banner ad is successfully loaded.

### Signature
`fun onAdLoaded()`
```

--------------------------------

### Define Inline BannerSize

Source: https://github.com/yandexmobile/yandex-ads-sdk-android/blob/master/_autodocs/api-reference/ComposeAds.md

Defines the data class structure for flexible banner sizes.

```kotlin
data class Inline(
    val width: Dp,
    val maxHeight: Dp
) : BannerSize
```

--------------------------------

### Configure Required Manifest Permissions

Source: https://github.com/yandexmobile/yandex-ads-sdk-android/blob/master/_autodocs/configuration.md

Include these permissions in your AndroidManifest.xml to enable basic network connectivity for the SDK.

```xml
<uses-permission android:name="android.permission.INTERNET" />
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
```

--------------------------------

### Handle AdError in callbacks

Source: https://github.com/yandexmobile/yandex-ads-sdk-android/blob/master/_autodocs/api-reference/CommonTypes.md

Log the error description when an ad fails to show.

```kotlin
override fun onAdFailedToShow(adError: AdError) {
    Log.e("AdError", "Show failed: ${adError.description}")
}
```

--------------------------------

### Handle Ad Display Failures in Kotlin

Source: https://github.com/yandexmobile/yandex-ads-sdk-android/blob/master/_autodocs/errors.md

Implement this within ad event listeners to log errors and trigger a reload when an ad fails to show.

```kotlin
override fun onAdFailedToShow(adError: AdError) {
    Log.e("Ads", "Show failed: ${adError.description}")
    // Reload and try showing again
    loadInterstitialAd()
}
```

--------------------------------

### Implement NativeAdEventListener

Source: https://github.com/yandexmobile/yandex-ads-sdk-android/blob/master/_autodocs/api-reference/NativeAds.md

Handles native ad display events such as clicks and impressions.

```kotlin
fun onAdClicked()
```

```kotlin
fun onImpression(data: ImpressionData?)
```

--------------------------------

### Show Rewarded Ad in Kotlin

Source: https://github.com/yandexmobile/yandex-ads-sdk-android/blob/master/_autodocs/api-reference/RewardedAds.md

Displays the loaded rewarded ad. Must be invoked on the main thread within the context of an Activity.

```kotlin
rewardedAd.show(this)
```

--------------------------------

### Load Rewarded Ad

Source: https://github.com/yandexmobile/yandex-ads-sdk-android/blob/master/_autodocs/api-reference/RewardedAds.md

Fetch an ad using an AdRequest and handle the result via the RewardedAdLoadListener.

```kotlin
val adRequest = AdRequest.Builder("demo-rewarded-yandex").build()
loader.loadAd(adRequest, object : RewardedAdLoadListener {
    override fun onAdLoaded(ad: RewardedAd) {
        rewardedAd = ad
    }
    override fun onAdFailedToLoad(error: AdRequestError) {
        Log.e("Rewarded", error.description)
    }
})
```
Tokens:
Raw