encore_flutter 2.3.1

Flutter plugin wrapping the native Encore iOS and Android SDKs for monetization, offers, and entitlements. All offer UI is rendered natively via StoreKit (iOS) and Play Billing (Android).

2.3.1

Ships with native iOS EncoreKit 2.3.1 and Android com.encorekit:encore 2.3.1.

Reward for trying: a reward on every offer, and pay on verification

What changed

• Each offer on the reward-for-trying sheet now shows its own reward, for example "500 coins". You set the amount in the Encore portal under your app's reward settings, and can override it per offer on the Offers page. An offer with no amount shows your publisher reward title, as before.
• New "pay on verification" mode. When your app's reward settings use it, a user's "Yes" no longer grants the reward. The reward is paid only when the advertiser confirms the completion, and an offer with no amount shows no reward.
• The offer_completed webhook now includes a reward object with the amount and unit fixed when the user claimed the offer. Every webhook for the same transaction carries the same reward, so credit the user once per transactionId.

What to call

• Nothing new. Identify the user with Encore.shared.identify(userId: userId) and pass your reward with Encore.placement(id).publisherReward(EncorePublisherReward(id: ..., title: ...)) when you show the placement, as in 2.3.0. The SDK reads the per-offer amounts and the mode from the server.

Requirements

• Credit each reward from either the device or the offer_completed webhook, never both. In the default mode, grant on userConfirmedCompletion as in 2.3.0. If your app pays only on verification, set up the offer_completed webhook in the Encore portal and credit reward.amount from it.
• Leave your app's reward settings unset until your users are on 2.3.1. Older SDKs show the flat reward title and their claims carry no reward on the webhook, so under pay on verification a user on an older build is never paid.

2.3.0

Ships with native iOS EncoreKit 2.3.0 and Android com.encorekit:encore 2.3.0.

Added

• Reward for trying. Pass your own prize on a placement with Encore.placement(id).publisherReward(EncorePublisherReward(...)). On a reward-for-trying variant the sheet promises it and, when the user comes back from the advertiser, asks whether they finished. Encore's server decides the prize per identified user, across devices, so identify() is required: an anonymous user gets no promise. When the server grants a "Yes", the new EncoreClaimedOffer.userConfirmedCompletion is true on the show() result, and that is when your app grants the prize (from the result only, not also from outcomes, deduped on your user id plus campaignId). It is the user's own word: the advertiser stage and Encore's payout are unchanged. Passing a prize commits your app to paying it when the flag is true.
• Encore.shared.setPublisherRewardPolicy(EncorePublisherRewardPolicy(...)) sets the daily limit on the prize (default 3 per user in any 24 hours; the native SDK clamps it to 1 to 10). The first "Yes" per user per offer earns the prize, and the server then hides that offer from the user.
• EncoreClaimedOffer.userConfirmedCompletion defaults to false, so code that builds an EncoreClaimedOffer itself keeps compiling.
• Encore.shared.setLanguage(tag) shows Encore's copy in an app-chosen language instead of the device language, for an in-app language picker. It takes a BCP 47 tag (fr, pt-BR), and only the language part is used. The choice is a device preference: it stays across launches and through reset() (logout) until clearLanguage(). For a tag that is not well-formed (for example pt_BR, from Locale.toString()), the returned future fails with an ArgumentError before anything reaches the native SDK.
• Encore.shared.clearLanguage() removes that language so Encore's copy follows the device language again, for a picker that goes back to "System default". The user and every attribute are kept.
• Encore.shared.configure accepts transactionLinking (default true). Set it to false to stop the store purchase query and the transaction uploads on both platforms.

Changed

• Deprecated: EncoreUserAttributes.language. It still works, applied natively as setLanguage would, and is removed in the next major version. Replace EncoreUserAttributes(language: tag) with Encore.shared.setLanguage(tag).
• The SDK sends the device language with every request (Android from 2.3.0).

2.2.0

Add more UI variants for A/B testing Bug Fixes

2.0.1

Bug Fixes

2.0.0

Migrates the plugin onto the native Encore 2.0 surface (iOS EncoreKit 2.0.0, Android com.encorekit:encore 2.0.1). Breaking, with no compatibility shim; see "Migrating from 1.x" in the README for the full walkthrough.

Android 2.0.0 is not usable and must not be pinned: its published AAR shipped the 2.0 public API obfuscated, so nothing could compile against it. 2.0.1 is the first Android release that exposes the surface this plugin needs.

Breaking

• onPurchaseRequest and onPurchaseRequestResult are gone. Both native SDKs deleted onPurchaseRequest in 2.0 and replaced it with a registered purchase controller. Implement EncorePurchaseController and pass the instance to Encore.shared.configure(purchaseController: ...). The controller returns a three-valued EncorePurchaseResult (purchased / cancelled / pending) instead of nothing (1.x onPurchaseRequest, which could not report success at all) or a bool (1.x onPurchaseRequestResult, which reported deferred purchases — Ask to Buy, SCA — as failures).
• onPurchaseComplete is gone, along with EncoreBillingPurchaseResult. The SDK no longer runs purchases itself, so there is no native purchase to report; your controller already sees every purchase it runs.
• onPassthrough is gone. The presentation record answers the same question with more detail: EncoreNotPresented means nothing was shown, and a presented record carries the dismissal reason and both funnels.
• EncorePresentationResult has a new shape. Granted / Claimed / NotGranted are replaced by EncoreNotPresented(reason) and EncorePresented(outcome), where the outcome carries two independent funnels — advertiser (the Encore offer claim) and publisher (your purchase) — plus a dismissal. The record is facts only: there is no SDK-computed "unlocked" verdict, because what a claim means is a property of the variant flow that served it.
• Encore.shared.placements.setClaimEnabled(...) moved to Encore.shared.setClaimEnabled(...), matching the native SDKs, which folded the 1.x placements manager into the facade. EncorePlacements is removed.

Added

• Encore.shared.outcomes — a broadcast Stream<EncorePlacementOutcome> over the native outcomes stream. Carries every show() resolution plus EncoreStrictUnlockVerified events, which can land on a later launch than the presentation that produced them and so can never be a show() return value.
• EncoreUnlockMode on configure, selecting how claims are verified. EncoreUnlockMode.strict is what makes EncoreStrictUnlockVerified reachable.
• EncorePurchaseRequest.basePlanId — the Google Play base plan to select, when the product exposes several. null on iOS.
• EncoreClaimedOffer carries campaignId, advertiserName and the transactionId that joins a claim to its later verification.

Fixed

• EncoreUseCase now actually reaches the native SDK. In 1.x the value was dropped at the bridge — neither native plugin implemented the channel method that carried it — so EncoreUseCase.rewardUsers could never present, and headline / subheadline overrides were silently ignored. Both bridges now forward all three on every show().

1.0.39