iOS应用中Urban Airship Analytics字典传参事件跟踪的技术问询

Hey there! Let's work through that event properties problem you're hitting with Urban Airship Analytics in your iOS app. Based on your code snippet and common pitfalls developers run into, here are targeted solutions and best practices to get your custom events tracking correctly:

1. Validate Your createParamDictionary Return Type & Content #

Urban Airship's UACustomEvent.properties expects a [String: Any] dictionary, but only supports specific value types: strings, numbers (Int/Double), booleans, and Dates. Custom objects or unsupported types will be silently ignored.

Make sure your dictionary-building method returns a valid, cleaned-up dictionary. Here's an improved version that combines and filters valid values:

func createParamDictionary(_ dict1: [String: Any], _ dict2: [String: Any]) -> [String: Any] {
    var combinedDict = dict1
    // Merge dict2 into dict1, keeping dict2's values for duplicate keys (adjust logic if needed)
    combinedDict.merge(dict2) { _, new in new }
    
    // Filter out any unsupported value types
    return combinedDict.filter { _, value in
        value is String || value is Int || value is Double || value is Bool || value is Date
    }
}

If your input dictionaries contain optional values, add a step to compact them first:

func createParamDictionary(_ dict1: [String: Any?], _ dict2: [String: Any?]) -> [String: Any] {
    let cleanedDict1 = dict1.compactMapValues { $0 }
    let cleanedDict2 = dict2.compactMapValues { $0 }
    
    var combined = cleanedDict1
    combined.merge(cleanedDict2) { _, new in new }
    return combined
}

2. Ensure Event Tracking Runs on the Main Thread #

Urban Airship's Analytics APIs are not thread-safe. If you're setting properties or calling track() from a background thread, this can cause unexpected behavior (like properties not being saved, or events failing to send). Always wrap your event code in the main thread:

DispatchQueue.main.async {
    let event = UACustomEvent()
    event.properties = createParamDictionary(paramDict1, paramDict2)
    // Add this log to verify properties are set correctly
    print("Custom Event Properties: \(event.properties ?? [:])")
    event.track()
}

3. Verify Urban Airship Initialization #

Double-check that you've enabled Analytics during UA setup (in your AppDelegate or SceneDelegate). If Analytics is disabled, no events will be tracked at all:

func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?) -> Bool {
    let config = UAConfig.default()
    config.developmentAppKey = "YOUR_DEV_APP_KEY"
    config.developmentAppSecret = "YOUR_DEV_APP_SECRET"
    // Critical: Enable Analytics
    config.analyticsEnabled = true
    
    UAirship.takeOff(config)
    return true
}

4. Debug with Urban Airship's Tools #

• Use the print statement above to confirm your properties are being set before calling track(). If the output is empty, your createParamDictionary method is returning invalid data.
• Enable Urban Airship's debug logging to see if events are being sent or rejected:

  config.logLevel = .debug
  

  Check the Xcode console for messages about event validation or submission.

内容的提问来源于stack exchange，提问作者Priyanka Wadher Mistry