Skip to content

XMediator

XMediator SDK for Android.

Adding XMediator to your project

repositories {
    maven {
        url = URI("https://android-artifact-registry.x3mads.com/maven")
    }
}

// [...]

dependencies {
    implementation("com.x3mads.android.xmediator:core:1.80.1")
}

repositories {
    maven {
        url "https://android-artifact-registry.x3mads.com/maven"
    }
}

// [...]

dependencies {
    implementation 'com.x3mads.android.xmediator:core:1.80.1'
}

Token based repository deprecation notice

If you are using the deprecated https://YOUR_MAVEN_TOKEN.artifact-registry.x3mads.com/maven along with the deprecated package domains com.etermax.android.xmediator*, please migrate to the new repository and package domain:

  • https://YOUR_MAVEN_TOKEN.artifact-registry.x3mads.com/maven to https://android-artifact-registry.x3mads.com/maven
  • com.etermax.android.xmediator to com.x3mads.android.xmediator

We'll continue supporting the old repository in the short term, to maintain compatibility with already integrated projects. Please consider migrating as soon as posible to avoid running into issues in the future.

1.80.1 (Nov 19th 2024)

Fixes:

  • Performance and stability improvements

1.77.0 (Oct 24th 2024)

New Features:

  • (Android) Added Testing Tools for MetaMediation to the Debugging Suite
  • (Android) Updated Kotlin to 1.9
  • (Android) Updated Room to 2.6.1
  • (Android) Updated OkHttp to 4.12.0

Fixes:

  • Performance and stability improvements

1.74.0 (Oct 4th 2024)

Fixes:

  • Performance and stability improvements.

1.71.3 (Sep 18th 2024)

New Features:

  • Added adNetwork and mediation properties to SuccessResult and ImpressionData. Deprecated the networkName property, as adNetwork reports a normalized network name for all mediation services.

Fixes:

  • Performance and stability improvements.

1.67.2 (Aug 14th 2024)

New Features:

  • Requires a minimum compileSdkVersion of 34.
  • Support for target 34.
  • JDK 17 is used for building the SDK.

Fixes:

  • Performance and stability improvements.

1.64.1 (Jul 25th 2024)

New Features:

  • Debuggin Suite: Event Viewer you can now visualize and analyze user interactions.

Fixes:

  • Performance and stability improvements.

1.62.2 (Jul 15th 2024)

Fixes:

  • Fix ClassCastException occurring on some Android devices.

1.62.1 (Jul 4th 2024)

Fixes:

  • Performance and stability improvements.

1.59.0 (Jun 25th 2024)

New Features:

  • You can now set an ad space property when showing an ad, to indicate the space in your app from where the ad will be shown (eg: dashboard, settings). Used for tracking.

Fixes:

  • Performance and stability improvements.

1.51.0 (Apr 16th 2024)

New Features:

  • The sdk now shows fullscreen ads from the main thread.

1.48.0 (Mar 25th 2024)

New Features:

  • Added to SuccessResult and ImpressionData the creativeId and subNetworkName properties.
  • Added support for sub-partner tracking.

Fixes:

  • Buffer now starts before the init callback is called.

1.47.0 (Mar 14th 2024)

Fixes:

  • Performance and stability improvements.
  • Banner viewability tracking improvements.
  • Logging improvements.

1.43.0 (Jan 29th 2024)

Fixes:

  • Bug fixes and performance improvements.

1.42.2 (Jan 10th 2024)

Fixes:

  • Avoid NoClassDefFoundError crash when reading the TCF String.

1.42.1 (Jan 9th 2024)

Fixes:

  • Avoid NPE when clearing shared preferences

1.41.0 (Dec 28th 2023)

New Features:

  • Added CMP Automation feature
  • Added support for consent signals retrieval from network adapters
  • Added Privacy Settings screen to Debugging Suite

Deprecated features:

  • The hasUserConsent flag has been deprecated. Apps should now integrate a CMP in order to support GDPR regions

1.34.0 (Nov 15th 2023)

New Features:

  • Updated Kotlin version to 1.8.22
  • Public API for getting current consent status
  • Banner viewability tracking improvements

1.31.0 (Oct 24th 2023)

New Features:

  • Request body compression

Fixes:

  • Loading multiple placements has been improved
  • Improved memory management in some cases, when loading placements with shared resources

1.28.0 (Sep 29th 2023)

New Features:

  • Improved logs for banner ads and prebidding
  • Added documentation for implementing custom adapters

1.26.0 (Sep 14th 2023)

New Features:

  • Banner autorefresh improvements.

1.22.2 (Aug 22th 2023)

New Features:

  • Tracking improvements.

  • Debugging Suite improvements.

  • Added In-App Network Test to Debugging Suite.

  • Updated transitive dependencies OkHttp to 4.10.0, Coroutines to 1.6.4 and Kotlin to 1.7.20

1.20.1 (Jul 24th 2023)

Fixes:

  • Fullscreen ads: Handle edge cases where the APS network failed to notify an impression.

New Features:

  • Debugging Suite improvements.

1.18.1 (Jul 10h 2023)

New Features:

  • New entry point for SDK. XMediatorSdk is deprecated and you should now use XMediatorAds instead. XMediatorSdk will be removed in future releases.

    • Replace XMediatorSdk with XMediatorAds

    • Replace XMediatorSdk.initialize(...) with XMediatorAds.startWith(...)

  • Add experimental support for Debugging Suite. In this first iteration you can check integration info, such as adapters' status and initialization settings.

Fixes:

  • Prevent mediated banner ads from requesting focus.

1.16.0 (Jun 15th 2023)

New Features:

  • Improved fullscreen ads buffering. You can now enable or disable buffering per placement id, from our Admin tool.

1.15.0 (Jun 7th 2023)

New Features:

  • Performance and stability improvements.

1.9.0 (Apr 10th 2023)

New Features:

  • Performance and stability improvements.

1.2.1 (Feb 2nd 2023)

New Features:

  • Added support for Banner MREC.
  • Improved ad stats metrics for optimizations

1.0.0 (Dec 6th 2022)

Features:

  • Removed Logback dependencies
  • Added AdvertisingId permission to AndroidManifest to support applications targeting Android 13

Fixes:

  • Improved timespan measurements
  • Consecutive loads to banner no longer cancel previous requests

0.95.0 (Oct 21st 2022)

New features:

  • The onImpression callback of each ad format now returns a new ImpressionData object.

BREAKING CHANGES:

  • The onImpression callback no longer returns a LoadResult object. If you were using it, you can now access it as a property of the new ImpressionData object.