Quick Start

This page shows a minimal end-to-end integration. For details on each API, see the API Reference as well Common Flows.

using Ciao;
 
// 1. Build consent from your consent UI (UMP / ATT / etc.).
CiaoConsent consent = new CiaoConsent(
    gdprConsent:          true,
    ccpaDoNotSell:        false,
    isChildDirected:      false,
    isUnderAgeOfConsent:  false,
    attGranted:           true);
 
// 2. Subscribe to Anti-Cheat events BEFORE calling Initialize.
CiaoSDKAntiCheat.OnSuspiciousActivityDetected += args =>
    CiaoSDK.SendCheaterDetected(args);
 
// 3. Initialize in your bootstrap (first) scene.
CiaoSDK.Initialize(consent);
 
// 4. Report a level completion.
CiaoSDK.SendLevelCompleted(new LevelCompletedArgs {
    level   = 1,
    time    = 45,
    session = 1,
    ltv     = 0.0f
});
 
// 5. Show a rewarded ad.
//    Interstitial and Rewarded ads are auto-loaded.
//    Ad Revenue is auto-reported — you do not need to report it manually.
CiaoSDKAds.ShowRewarded("reviveOnDeath", success => {
    if (success) GrantReward();
});
 
// 6a. Report an IAP (Unity IAP v5 — PendingOrder).
CiaoSDK.SendIAPPurchased(new IAPArgs(order, false));
 
// 6b. Report an IAP (Unity IAP v4 — PurchaseEventArgs).
CiaoSDK.SendIAPPurchased(new IAPArgs(args.purchasedProduct, false));
 
// 7. Report a detected cheater (typically wired from OnSuspiciousActivityDetected).
CiaoSDK.SendCheaterDetected(cheatArgs);

Key Points

  • Call CiaoSDK.Initialize(consent) once in your bootstrap scene.
  • Subscribe to events (Anti-Cheat, Ads) before calling Initialize.
  • Ad Revenue is auto-reported to MMP and Analytics - you never need to send it manually.
  • Interstitial and Rewarded ads are auto-loaded - just check IsInterstitialReady / IsRewardedReady before showing.


Did this page help you?