​

Troubleshooting

​

Installation Issues

​

Package Not Found

1. Check your internet connection
2. Verify the URL is correct: https://github.com/spendowl/spendowl-ios
3. Try closing and reopening Xcode
4. Clear the derived data: Xcode → Settings → Locations → Derived Data → Delete

​

Version Conflicts

1. Update other packages to their latest versions
2. Use a specific version instead of “Up to Next Major”, picking the newest 1.x release — check Releases for the current one:
   .package(url: "https://github.com/spendowl/spendowl-ios", exact: "1.4.0") // use the latest 1.x
   
   Pin forward, never back. An older pin strands you on a release without the fixes since.

​

Configuration Issues

​

SDK Not Configured

// In App.init() or AppDelegate
SpendOwl.configure(apiKey: "your-api-key")

​

Invalid API Key

1. Verify your API key in the dashboard
2. Ensure you’re using the correct environment key (test vs. live)
3. Check for extra spaces or characters in the key

​

Configure Called Multiple Times

​

Attribution Issues

​

Attribution Unavailable

• iOS version below 14.3
• Running in the simulator (limited attribution support)
• AdServices framework not available

1. Test on a real device with iOS 14.3+
2. Handle gracefully in code:
   do {
       let attribution = try await SpendOwl.attribution()
   } catch SpendOwlError.attributionUnavailable {
       // Continue without attribution
   }
   

​

Attribution Denied

• User has “Limit Ad Tracking” enabled
• MDM profile restricts tracking
• Privacy settings block attribution

​

Attribution Returns Unknown

1. First launch: Attribution may take a few seconds to process
2. Network issues: Token couldn’t be sent to servers
3. Processing delay: Server is still resolving the token

// Wait and retry
try await Task.sleep(for: .seconds(2))
let attribution = try await SpendOwl.attribution()

​

Attribution Always Organic

1. Test device isn’t enrolled in Apple Search Ads testing
2. Using a development certificate (attribution may not work)
3. Ad account isn’t linked to your app

1. Use a TestFlight or App Store build for accurate testing
2. Verify your Apple Search Ads account is properly configured
3. Check the Apple Search Ads testing guide

​

Network Issues

​

Request Timeout

1. Check internet connectivity
2. Increase timeout:
   let config = SpendOwlConfiguration(
       apiKey: "your-api-key",
       timeoutInterval: 30
   )
   SpendOwl.configure(config)
   
3. The SDK retries automatically; persistent failures indicate connectivity issues

​

Certificate Errors

• Corporate proxy intercepting HTTPS
• Network security software
• Clock significantly wrong on device

1. Disable SSL interception for spendowl.io
2. Check device date/time settings

​

Purchase Tracking Issues

​

Purchases Not Appearing

1. SDK not configured before purchase occurred
2. The product is a consumable and the Info.plist opt-in is missing
3. Sandbox purchases with live API key

1. Ensure configure() is called on app launch
2. Add SKIncludeConsumableInAppPurchaseHistory — without it a consumable missed at the moment of purchase can never be recovered. See Consumables
3. Use test API key for sandbox testing

​

Sandbox vs Production

#if DEBUG
let apiKey = "spendowl_test_xxx"
#else
let apiKey = "spendowl_live_xxx"
#endif
SpendOwl.configure(apiKey: apiKey)

​

Debugging Tips

​

Enable Verbose Logging

SpendOwl.logLevel = .debug

​

Read the Logs in Xcode

​

Verify Integration

print("Configured: \(SpendOwl.isConfigured)")
print("Version: \(SpendOwl.sdkVersion)")

if let attribution = try? await SpendOwl.attribution() {
    print("Status: \(attribution.status)")
}

​

Still Having Issues?

• iOS version
• SDK version (SpendOwl.sdkVersion)
• Device model (real device vs simulator)
• Debug logs (with sensitive data redacted)
• Steps to reproduce