multi_ads 2.0.0

Multiple Ad Network

Changelog

All notable changes to this package are documented in this file.

2.0.0 - 2026-10-15

Requires common_interface 2.x; see its BREAKING_CHANGES.md. Network plugins (google, unity, yodo, ironSource, facebook) must be on 2.x too.

Breaking

• adModuleWithCallBacks: parameters are now callbacks: and take AdCallbacks (onClosed, onLoaded, onShown, onRewardEarned, onRewardSkipped).
• MultiAds.showOnFailed and MultiAds.limit are gone; fallback handling is internal.
• AdClass.initAdNetwork(initNetwork: List) is initNetworks: List<NetworkType>; AdClass.showAd takes an AdTarget.
• Models renamed: RewardsModel → Reward, RewardDetailModel → RewardDetail, AdConfigDataModel → AdConfig; CategoryRewards fields are now pending / collected / expired.
• GlobalAdVariables is replaced by AdSession, AdState and ReviewPrompt; DeviceMethods by DeviceService.
• JsonMethods.parseScreenData / parseAdNetworkIds return empty maps instead of null.
• package:provider is no longer re-exported through multi_ads; add it to your pubspec if you use it.

Fixed

• The fallback chain now uses the config of the requested route (showAdBasedOnName used the current screen's route), and its 3-attempt limit is per request instead of a counter shared across the whole session.
• A network that is not registered, or a missing config, no longer crashes or leaves the loader spinning: it counts as a load failure and falls back.
• Rewarded ads that fail to show on IronSource/Yodo now fall back instead of hanging.
• Banner/native placements can use any registered network, not only google/unity/yodo.
• The review dialog's rating notifier is no longer replaced on every rating change.
• AdClass.showUserMessage now awaits the ATT request inside its try, so failures are handled instead of escaping.
• Dialogs and ads shown after async gaps check context.mounted first.

1.1.7 - 2026-08-07

• Added IspIdentifyService to detect Apple / Google ISPs via wildcard patterns from remote versions.extra_config (list [{...}] or map; built-in defaults when config is missing).
• Wired ISP capture and extra_config binding into SetupMixin.registerApp.
• Migrated consent / UMP flow from discontinued user_messaging_platform to google_mobile_ads (SPM-friendly).
• Bumped common_interface to ^1.0.7 and package_info_plus to ^10.2.1 (requires Flutter >=3.38.1 / Dart >=3.10.0).

1.1.6 - 2026-06-14

• SPM Support

1.1.5 - 2026-04-20

• Added Clash of Clans base layout support: CocApiHelper (filtered layout listing, pagination via onNextPage, and getFilters for /cocbases/filter-options) plus CocLayout model parsing.
• Expanded the anime module: AnimeApiClient and AnimeServices now cover dashboard, staff, per-episode fetch, forum, videos (including paginated video episodes), pictures, statistics, more info, recommendations, user updates, relations, themes, external links, and richer anime search query parameters; requests continue to use the shared Jikan-style proxy and device_public_key where applicable.
• Documented BrawlStarHelper.officialApi in README.md (Brawl Stars proxy URL shape, endpoint query parameter, and player tag encoding with %23).

1.1.4 - 2026-04-08

• Fixed Dashboard API.

1.1.3 - 2026-04-05

• Added Anime API helper module with complete anime endpoint methods.
• Added Jikan cache-wrapper support via /jikan with endpoint=/... query forwarding.
• Ensured Anime API requests include device_public_key header.
• Improved package documentation with a full plugin-style README.md.

1.1.2 - 2025-02-01

• Fixed bugs and stability issues.

1.1.1 - 2025-01-30

• Added Clash of Clans helper data support.

1.1.0 - 2025-07-10

• Updated ad network SDK versions.

1.0.9 - 2025-06-12

• Updated internal plugins.
• Added mediation support.

1.0.8 - 2024-12-27

• Updated internal system plugin versions.

1.0.7 - 2024-12-02

• Added showFullScreenAdWithName to trigger ads using a route name.

1.0.5

• Fixed imports.
• Updated common_interface integration.

1.0.4

• Migrated core helper flows to mixin-based structure.

1.0.3

• Initial release updates.

1.0.2

• Initial release updates.

1.0.1

• Initial release updates.

1.0.0

• Initial release.