// Create ad data object
SingularAdData *adData = [[SingularAdData alloc] initWithAdPlatform:@"AdMob" 
                                                        withCurrency:@"USD" 
                                                         withRevenue:0.05];
adData.adUnitId = @"ca-app-pub-123456789/1234567890";
adData.adType = @"Rewarded";
adData.adPlacementName = @"level_complete";

// Track ad revenue event
[Singular adRevenue:adData];

// Clear all global properties
[Singular clearGlobalProperties];

// Create a short link for referral
[Singular createReferrerShortLink:@"https://sample.sng.link/B4tbm/v8fp"
                     referrerName:@"John Doe"
                       referrerId:@"aq239897"
                passthroughParams:@{
                    @"channel": @"sms",
                    @"campaign": @"summer_promo"
                }
                completionHandler:^(NSString *link, NSError *error) {
    if (error) {
        NSLog(@"Error creating short link: %@", error);
    } else {
        NSLog(@"Generated short link: %@", link);
        // Share the link with users
    }
}];

// Track a custom revenue event
[Singular customRevenue:@"premium_subscription"
               currency:@"USD"
                 amount:9.99];

// Track a custom revenue event with attributes
[Singular customRevenue:@"in_app_purchase"
               currency:@"USD"
                 amount:5.99
         withAttributes:@{
             @"product_id": @"com.app.gems_pack_small",
             @"quantity": @1
         }];

// Track a custom revenue event from a StoreKit transaction
NSData *transactionData = transaction.payment.requestData;
NSData *productData = [NSJSONSerialization
    dataWithJSONObject:@{@"productID": transaction.payment.productIdentifier}
               options:0
                 error:nil];
if (transactionData && productData) {
    [Singular customRevenue:@"in_app_purchase"
        transactionJsonRepresentation:transactionData
        productJsonRepresentation:productData
        withAttributes:@{@"source": @"store"}];
}

// Track a simple event
[Singular event:@"level_completed"];

// Track an event with additional parameters
[Singular event:@"level_completed" 
       withArgs:@{
           @"level_id": @5,
           @"score": @12500,
           @"time_spent": @120,
           @"difficulty": @"medium"
       }];

// Track an event with variable arguments
[Singular eventWithArgs:@"purchase", 
                        @"item_id", @"sword_01",
                        @"price", @9.99,
                        nil];

// Get all global properties
NSDictionary *properties = [Singular getGlobalProperties];
NSLog(@"Global properties: %@", properties);

// Check if data sharing is limited
BOOL isLimited = [Singular getLimitDataSharing];
if (isLimited) {
    NSLog(@"Data sharing is currently limited");
}

// Handle a received push notification
- (void)userNotificationCenter:(UNUserNotificationCenter *)center 
       didReceiveNotificationResponse:(UNNotificationResponse *)response 
                withCompletionHandler:(void (^)(void))completionHandler {
    NSDictionary *userInfo = response.notification.request.content.userInfo;
    [Singular handlePushNotification:userInfo];
    completionHandler();
}

// Track IAP completion
[Singular iapComplete:transaction];

// Track IAP completion with custom name
[Singular iapComplete:transaction 
             withName:@"premium_upgrade"];

// Track IAP completion with attributes
[Singular iapComplete:transaction 
       withAttributes:@"user_level", @42,
                      @"is_first_purchase", @YES,
                      nil];

// Check if tracking is stopped
if ([Singular isAllTrackingStopped]) {
    NSLog(@"Tracking is currently stopped");
}

// Inspect an incoming URL before handling it yourself
- (BOOL)application:(UIApplication *)application
            openURL:(NSURL *)url
            options:(NSDictionary<UIApplicationOpenURLOptionsKey,id> *)options {
    if ([Singular isSingularLink:url]) {
        // Singular's singularLinksHandler will receive the resolved link.
        return YES;
    }

    return [self handleCustomURL:url];
}

// To limit data sharing (e.g., when user opts out)
[Singular limitDataSharing:YES];

// To enable full data sharing (e.g., when user opts in)
[Singular limitDataSharing:NO];

// Register device token for uninstall tracking
- (void)application:(UIApplication *)application 
didRegisterForRemoteNotificationsWithDeviceToken:(NSData *)deviceToken {
    [Singular registerDeviceTokenForUninstall:deviceToken];
}

// Resume tracking when user opts back in
[Singular resumeAllTracking];

// Track revenue with currency and amount
[Singular revenue:@"USD" amount:9.99];

// Track revenue with additional attributes
[Singular revenue:@"USD"
           amount:19.98
     withAttributes:@{
         @"product_id": @"premium_gems",
         @"quantity": @2
     }];

// Track revenue with detailed product information
[Singular revenue:@"USD"
           amount:19.98
       productSKU:@"SKU123456"
      productName:@"Premium Sword"
  productCategory:@"Weapons"
  productQuantity:2
     productPrice:9.99];

// Track revenue from a StoreKit SKPaymentTransaction
// (typically inside paymentQueue:updatedTransactions:)
- (void)paymentQueue:(SKPaymentQueue *)queue
  updatedTransactions:(NSArray<SKPaymentTransaction *> *)transactions {
    for (SKPaymentTransaction *transaction in transactions) {
        if (transaction.transactionState == SKPaymentTransactionStatePurchased) {
            [Singular revenue:transaction];
            [[SKPaymentQueue defaultQueue] finishTransaction:transaction];
        }
    }
}

// Set custom user ID after user logs in
[Singular setCustomUserId:@"user_123456"];

// Set device-level custom user ID
[Singular setDeviceCustomUserId:@"device_user_123456"];

// Set a global property
BOOL success = [Singular setGlobalProperty:@"user_tier" 
                                  andValue:@"premium" 
                          overrideExisting:YES];
if (success) {
    NSLog(@"Global property set successfully");
}

// Limit advertising identifiers at runtime (e.g., after a consent dialog)
[Singular setLimitAdvertisingIdentifiers:YES];

// Enable SDK logging for debug builds
#ifdef DEBUG
[Singular setLoggingEnabled:YES];
[Singular setLogLevel:SingularLogLevelDebug];
#endif

// Set verbose logging for detailed debugging
[Singular setLoggingEnabled:YES];
[Singular setLogLevel:SingularLogLevelVerbose];

// Set session timeout to 2 minutes
[Singular setSessionTimeout:120];

// Get the current SKAdNetwork conversion value
NSNumber *conversionValue = [Singular skanGetConversionValue];
NSLog(@"Current conversion value: %@", conversionValue);

// Register for SKAdNetwork attribution
[Singular skanRegisterAppForAdNetworkAttribution];

// Update the SKAdNetwork conversion value
BOOL success = [Singular skanUpdateConversionValue:5];
if (success) {
    NSLog(@"Conversion value updated successfully");
}

// Update SKAdNetwork 4.0 conversion values (iOS 16.1+)
[Singular skanUpdateConversionValue:5   // fine value (0-63)
                             coarse:1   // coarse value (0=low, 1=medium, 2=high)
                               lock:NO];

// Create configuration object
SingularConfig *config = [[SingularConfig alloc] initWithApiKey:@"SDK_KEY" andSecret:@"SDK_SECRET"];

// Configure additional options if needed
config.customUserId = @"user-123456";
config.sessionTimeout = 60;

// Initialize the SDK
[Singular start:config];

// Simple session start
[Singular startSession:@"API_KEY" withKey:@"API_SECRET"];

// Session start with deep link handler
[Singular startSession:@"API_KEY" 
               withKey:@"API_SECRET" 
      andLaunchOptions:launchOptions 
withSingularLinkHandler:^(SingularLinkParams *params) {
    NSLog(@"Deep link received: %@", params.deeplink);
}];

// Stop tracking when user opts out
[Singular stopAllTracking];

// User has opted in to tracking
[Singular trackingOptIn];

// Notify Singular the user is under 13 years old
[Singular trackingUnder13];

// Clear custom user ID when user logs out
[Singular unsetCustomUserId];

// Remove a global property
[Singular unsetGlobalProperty:@"user_tier"];