Change Log
[1.6.0] - 2026-11-16
Changed
- Custom events (
CiaoSDK.SendEvent/CiaoSDKMMP.SendEvent) to Singular:iap_is a reserved prefix for IAP pack events (e.g.iap_gem500). It never gets themn_prefix.mnPrefix: false: event sent as is (iap_gem500,event_name). No change from before.mnPrefix: true: event sent both as is and with themn_prefix, so the oldmn_events keep firing until retired:iap_gem500→iap_gem500+mn_gem500event_name→event_name+mn_event_name- Names already starting with
mn_are sent unchanged, as before.
- Not affected: IAP revenue event, level events,
cheater, internalciao_*events, ByteBrew.
Added
- Singular: every event now carries
ciaosdk_versionin its event attributes (data payload).
[1.5.0] - 2026-10-14
Added
- EventGuard: client-side level event validation to detect fraudulent progression.
- Validates
sng_level_achievedsequence against persisted state. - Flags users as cheater when a level event jumps forward by more than the configured delta.
- Fires one
cheaterevent on first detection with reasonLevelJump, then silently blocks subsequent level events. - Non-level events (IAP, ad revenue, custom) are not affected.
- State persisted encrypted in
Application.persistentDataPath. - Configurable via
CiaoSDKSettings.eventGuard:enabled(default: true)minLevelForCheck(default: 5) — levels below this skip the checkmaxLevelDelta(default: 4) — maximum allowed forward jump
- Validates
Notes
- Existing users on upgrade: EventGuard treats them as fresh baseline. First level event after upgrade seeds the state, checks apply from the next event onward.
- Disabling
eventGuard.enabledis a full kill-switch: no checks, no state updates. Previously flagged users resume blocked status if re-enabled.
[1.4.2] - 2026-10-09
Added
RevenueArgsfor reporting non-Unity IAP purchases (Appcharge, Stash etc.)CiaoSDK.SendIAPPurchased(RevenueArgs)overload for DTC purchase reportingIMMPProvider.SendIAPPurchased(RevenueArgs)interface methodIAnalyticsProvider.SendIAPPurchased(RevenueArgs)interface method- Singular routing via
CustomRevenue()for unvalidated revenue - ByteBrew routing via
TrackInAppPurchaseEvent()with configurablesourceas store
[1.4.1] - 2026-10-07
Added
rewardedAdsGraceSecondssetting (default1s) inCiaoSDKSettings. Controls the grace window afterOnAdClosedfor catching a lateOnAdRewarded.- Handler log on reward resolution:
Rewarded resolved: <true/false>, graceActive=<true/false>for debugging reward flow.
Fixed
- Rewarded ads: late reward loss.
ShowRewardedcallback could resolvefalsewhenOnAdRewardedfired afterOnAdClosed(documented LevelPlay behavior). The callback now waits a short grace window after close for a late reward signal before resolvingfalse. Reward signals that arrive during the window resolvetrueas expected.
[1.4.0] - 2026-10-05
Added
- Per-module consent overrides in
CiaoConsent:adsConsent,mmpConsent,analyticsConsent(nullable bools). If not set, each inherits fromgdprConsent. skipAdsInitparameter onCiaoSDK.InitializeandCiaoSDK.UpdateConsent(defaultfalse). Whentrue, LevelPlay is not initialized and no ad preloads happen. MMP and Analytics initialize independently based on their own consent flags. Flip tofalseviaUpdateConsentto initialize LevelPlay later.CiaoSDKMMP.SetCustomUserId(string)- sets a custom user ID on Singular. Safe to call before or after SDK start; cached if called before consent.CiaoSDKMMP.UnsetCustomUserId()- clears the custom user ID on Singular. Also cancels any pending id if called before SDK start.
Changed
- Minimum Singular Unity SDK version is now 5.8.0 when using Unity IAP v5 on iOS.
Singular 5.7.0 and earlier do not support StoreKit 2 receipt validation.
If you must use Singular 5.7.0 or earlier, stay on Unity IAP v4. SingularMMPProvidernow gates onconsent.mmpConsentinstead ofconsent.gdprConsent.ByteBrewAnalyticsProvidernow gates onconsent.analyticsConsentinstead ofconsent.gdprConsent.LevelPlayAdsProviderreadsconsent.adsConsentwhen callingLevelPlay.SetConsent.
Fixed
- iOS IAP v5: StoreKit 2 receipts now validate correctly via Singular's native Order handling.
Removed
- Internal JWS payload workaround in
SingularMMPHelper(no longer needed with Singular 5.8.0+).
Backwards compatibility
- Existing integrations that pass only
gdprConsentcontinue to work unchanged. All three per-module flags default togdprConsent's value. skipAdsInitdefaults tofalse, preserving 1.3.0 behavior.
[1.3.0] - 2026-09-18
Added
- CiaoSecureString type in Ciao.Core for storing sensitive strings as encrypted bytes at rest (AES-128-CBC).
- Custom PropertyDrawer for transparent plaintext editing of CiaoSecureString fields in the Inspector.
- CiaoConfigDto / ConfigMapper to bridge downloaded JSON config into runtime types with encryption applied at write time.
Changed
- MMPConfig.sdkKey and MMPConfig.sdkSecret are now CiaoSecureString instead of plain string. Values are encrypted in the CiaoSDKSettings asset on disk.
- ConfigDownloader.Download and ConfigFileDecryption.Decrypt now return CiaoConfigDto.
- SettingsWriter.Write accepts CiaoConfigDto and maps to runtime CiaoConfig with encryption.
- SingularMMPProvider no longer retains a reference to MMPConfig after initialization.
[1.2.1] - 2026-09-10
Added
- Analytics event: reward_center for Reward Center valid campaign activation.
[1.2.0] - 2026-09-07
Added
- Reward Center (optional module). When the Reward Center package is installed, CiaoSDK automatically initializes it, forwards event names to
RewardCenter.ReportEvent, and forwards deep links toRewardCenter.HandleDeepLink. Studios do not need any extra integration code. - 'Update' menu item in the Ciao Games menu and Setup Window.
[1.1.0] - 2026-08-14
Added
- Support for multiple ad units per format (interstitial and rewarded). At show time, the SDK picks the highest eCPM ad unit, falling back to rotation when revenue data is unavailable.
- New analytics event ciao_ad_competition reporting winner, worst, and selection method.
- New config schema fields:
legacyLevelEventNameandlegacyLevelDigitsFormat. Fields are used only whenmnPrefix=true.
Changed
- Config schema: interstitial and rewarded are now lists of ad unit IDs. banner is a list of one.
- Config download now bypasses HTTP cache so studios always receive the latest version.
- Changed Singular event reporting in cases of mnPrefix=true, to support legacy games.
[1.0.1] - 2026-08-07
Changed
- LevelPlay adapter debug is now controlled by
CiaoSDKLogger.CurrentLogLevel. Enabled only atInfo; disabled atWarn/Error/None. Silences vendor adapter noise for studios shipping at production log levels.
Fixed
- Singular: privacy flags (
TrackingOptIn,LimitDataSharing,TrackingUnder13,SetLimitAdvertisingIdentifiers) are now applied beforeInitializeSingularSDKper Singular's guidance, ensuring they are reflected in the first-session payload.
[1.0.0] - 2026-08-06
First general release.
Added
- Consent snapshot event (
ciao_consent) sent to MMP and Analytics onInitializeandUpdateConsent, for dashboard visibility on how studios are wiring consent. Fields:gdpr_consent,ccpa_do_not_sell,is_child_directed,is_under_age_of_consent,att_granted,gdpr_networks_source.
Changed
- Singular: Opt-In consent pattern per Singular's official guidance.
InitializeSingularSDK()is now called only aftergdprConsent=true. Declined users produce no session and no events.UpdateConsent(true)later triggers deferred initialization. - ByteBrew: Opt-In consent pattern.
InitializeByteBrew()is now called only aftergdprConsent=trueand non-child-directed. Same deferred behavior on later consent updates.
[0.7.6] - 2026-08-03
Fixed
- LevelPlay consent: use
LevelPlay.SetConsent(bool)(LevelPlay 9.4+) instead ofLevelPlayPrivacySettings.SetGDPRConsent(bool)(LevelPlay 9.5+), restoring compatibility.
[0.7.5] - 2026-08-03
Fixed
- ByteBrew analytics: possible NRE on
SendEventwhenInitialize()bailed out early. Event queue is now constructed first. - Singular consent: opting back in after
gdprConsent=falsedid not resume tracking. Opt-in path now also resumes. - LevelPlay consent: Always wire primary GDPR flag
SetGDPRConsent(bool).
Changed
- Added diagnostic logs around platform key writes in
ByteBrewAnalyticsProvider(no key values logged).
[0.7.4] - 2026-07-30
Changed
- Removed
maxLevelcap from custom level event reporting.
[0.7.3] - 2026-07-20
Changed
- Custom level events now include level 1 (
level_0001). Previously levels below 2 were silently skipped from Singular custom level reporting.
[0.7.2] - 2026-07-20
Fixed
- Singular SDK logging now respects
CiaoSDKLogger.CurrentLogLevel. OnlyLogLevel.Infoenables verbose Singular output that logs Singular API key.
[0.7.1] - 2026-07-15
Fixed
- InstallSourceChecker detects emulator and sideload installs. Application.installMode fallback removed.
- Anti-cheat events fired during initialization are no longer lost. MMP and Analytics providers are now initialized before the anti-cheat provider, so early detections reach the reporting sinks.
Changed
- LevelCompletedArgs: currencyName and currencyBalance are now optional. Analytics events omit these fields when currencyName is empty.
- TimeChecker now reads server time from the HTTP
Dateheader of a configurable endpoint (default:www.example.com), replacing the previous JSON time API. More reliable and globally reachable.
[0.7.0] - 2026-07-14
Added
- Remote Config support via ByteBrew: CiaoSDKAnalytics.RefreshConfig, IsConfigReady, GetConfig.
- User attribute tagging for segmentation: CiaoSDKAnalytics.SetUserAttribute (string/int/double/bool).
- CiaoSDKAnalytics.GetUserId- returns the ByteBrew user ID.
- CiaoSDKAnalytics.StartPushNotifications - enables ByteBrew push notifications (studio-side platform + dashboard setup required).
[0.6.0] - 2026-07-09
Added
- Events queue in Singular and ByteBrew providers. Events are queued and processed one at a time with a configurable delay, preventing race conditions during provider initialization.
- ciaosdk_version global property attached to all Singular and ByteBrew events.
- Auto-sync of SDK version into CiaoSDKSettings on every Editor domain reload.
Changed
- Providers no longer drop events that arrive before initialization completes; events are queued and delivered once the provider is ready.
[0.5.2] - 2026-07-06
Fixed
- Detect legacy vendor SDK imports (LevelPlay, Singular, ByteBrew) in Assets/ and block activation with a clear migration message.
- Detect UPM vendor SDK version below required minimum and block with an update message.
- Vendor SDK package definitions moved to sdkPackages.json.
Changed
- Editor folder reorganized into PackageManagement/, SetupWizard/, Configuration/.
[0.5.1] - 2026-07-01
Fixed
- iOS IAP v5: revenue now correctly reported to Singular (was showing as nil due to missing
rattribute). - iOS IAP v5: receipt now works with StoreKit 2 by extracting the payload from Apple's JWS representation (Unity IAP v5's
Order.Info.Receipt.Payloadis empty on iOS). - IAP v5:
restoredflag now correctly forwarded to Singular (was being ignored due to overload resolution).
Changed
- Renamed
SingularMMPHelper.BuildIAPAttributestoBuildIOSIAPAttributesfor clarity. - Cleaned up
CiaoSDKTest.cssample script (removed diagnostic logs, made IAP/ATT sections opt-in via comments).
[0.5.0] - 2026-06-30
This is the Pilot pre-release of CiaoSDK.
Changed
- None - this is the Pilot pre-release version.
Fixed
- None - initial Pilot pre-release.
Updated 3 days ago
Did this page help you?
