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 the mn_ prefix.
    • mnPrefix: false: event sent as is (iap_gem500, event_name). No change from before.
    • mnPrefix: true: event sent both as is and with the mn_ prefix, so the old mn_ events keep firing until retired:
      • iap_gem500 → iap_gem500 + mn_gem500
      • event_name → event_name + mn_event_name
      • Names already starting with mn_ are sent unchanged, as before.
    • Not affected: IAP revenue event, level events, cheater, internal ciao_* events, ByteBrew.

Added

  • Singular: every event now carries ciaosdk_version in 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_achieved sequence against persisted state.
    • Flags users as cheater when a level event jumps forward by more than the configured delta.
    • Fires one cheater event on first detection with reason LevelJump, 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 check
      • maxLevelDelta (default: 4) — maximum allowed forward jump

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.enabled is 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

  • RevenueArgs for reporting non-Unity IAP purchases (Appcharge, Stash etc.)
  • CiaoSDK.SendIAPPurchased(RevenueArgs) overload for DTC purchase reporting
  • IMMPProvider.SendIAPPurchased(RevenueArgs) interface method
  • IAnalyticsProvider.SendIAPPurchased(RevenueArgs) interface method
  • Singular routing via CustomRevenue() for unvalidated revenue
  • ByteBrew routing via TrackInAppPurchaseEvent() with configurable source as store

[1.4.1] - 2026-10-07

Added

  • rewardedAdsGraceSeconds setting (default 1s) in CiaoSDKSettings. Controls the grace window after OnAdClosed for catching a late OnAdRewarded.
  • Handler log on reward resolution: Rewarded resolved: <true/false>, graceActive=<true/false> for debugging reward flow.

Fixed

  • Rewarded ads: late reward loss. ShowRewarded callback could resolve false when OnAdRewarded fired after OnAdClosed (documented LevelPlay behavior). The callback now waits a short grace window after close for a late reward signal before resolving false. Reward signals that arrive during the window resolve true as expected.

[1.4.0] - 2026-10-05

Added

  • Per-module consent overrides in CiaoConsent: adsConsent, mmpConsent, analyticsConsent (nullable bools). If not set, each inherits from gdprConsent.
  • skipAdsInit parameter on CiaoSDK.Initialize and CiaoSDK.UpdateConsent (default false). When true, LevelPlay is not initialized and no ad preloads happen. MMP and Analytics initialize independently based on their own consent flags. Flip to false via UpdateConsent to 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.
  • SingularMMPProvider now gates on consent.mmpConsent instead of consent.gdprConsent.
  • ByteBrewAnalyticsProvider now gates on consent.analyticsConsent instead of consent.gdprConsent.
  • LevelPlayAdsProvider reads consent.adsConsent when calling LevelPlay.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 gdprConsent continue to work unchanged. All three per-module flags default to gdprConsent's value.
  • skipAdsInit defaults to false, 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 to RewardCenter.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: legacyLevelEventName and legacyLevelDigitsFormat. Fields are used only when mnPrefix=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 at Info; disabled at Warn/Error/None. Silences vendor adapter noise for studios shipping at production log levels.

Fixed

  • Singular: privacy flags (TrackingOptIn, LimitDataSharing, TrackingUnder13, SetLimitAdvertisingIdentifiers) are now applied before InitializeSingularSDK per 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 on Initialize and UpdateConsent, 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 after gdprConsent=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 after gdprConsent=true and 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 of LevelPlayPrivacySettings.SetGDPRConsent(bool) (LevelPlay 9.5+), restoring compatibility.

[0.7.5] - 2026-08-03

Fixed

  • ByteBrew analytics: possible NRE on SendEvent when Initialize() bailed out early. Event queue is now constructed first.
  • Singular consent: opting back in after gdprConsent=false did 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 maxLevel cap 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. Only LogLevel.Info enables 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 Date header 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 r attribute).
  • 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.Payload is empty on iOS).
  • IAP v5: restored flag now correctly forwarded to Singular (was being ignored due to overload resolution).

Changed

  • Renamed SingularMMPHelper.BuildIAPAttributes to BuildIOSIAPAttributes for clarity.
  • Cleaned up CiaoSDKTest.cs sample 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.

Did this page help you?