BoostLinks Configuration

BoostLinks is a professional deep linking feature included in the free BoostOps SDK. This Unity Editor tool configures iOS Universal Links and Android App Links in your games, eliminating the complexity of manual platform configuration and following the same patterns used by Firebase, Unity IAP, and other enterprise Unity tools.

What Are BoostLinks?

BoostLinks is our free deep linking solution that handles both iOS Universal Links and Android App Links seamlessly.

iOS Universal Links

Universal Links are Apple’s secure deep linking technology that allows your app to handle HTTPS URLs directly. When a user clicks a BoostLink:

If your app is installed, it opens directly to the specified content
If your app isn’t installed, it opens the URL in Safari (typically your app store page)
No custom URL schemes required - uses standard HTTPS URLs

Android App Links

Android App Links provide similar functionality for Android devices, allowing your app to handle specific web URLs directly and securely.

Why BoostLinks Matter

Security & User Experience

Secure: Unlike custom URL schemes, BoostLinks require verification between your app and website
Seamless: Users get a native app experience without confusing “Open with…” dialogs
Fallback: Graceful handling when your app isn’t installed

Marketing & Growth

Better Attribution: Track which campaigns drive app opens vs. installs
Reduced Friction: Direct deep links to specific game content improve conversion rates
Cross-Promotion: Link between your games with verified, secure deep links

BoostLinks Unity Editor Tool

Professional Unity Editor Integration

Our tool follows the same patterns as Firebase and other enterprise Unity solutions:

GUI-Based Configuration: No manual file editing required
Automatic File Generation: Creates all platform-specific files automatically
Post-Build Processing: Automatically configures Xcode projects
Validation & Testing: Built-in tools to verify your setup

Two Deployment Options

Option 1: Self-Hosted (Always Free)

Generate all necessary files locally and deploy them to your own web server:

Apple App Site Association files for iOS
Android Asset Links files for Android
Platform Configuration files for Unity
Deployment Instructions with step-by-step guides
No Usage Limits: Handle unlimited clicks and apps

Option 2: BoostOps Managed (Freemium)

Let BoostOps handle everything automatically:

Automatic File Hosting: We host all verification files
Dynamic Link Generation: Create and manage links through our dashboard
Analytics Integration: Track link performance and attribution
Free Subdomains: Get <app>.boostlink.me subdomains
Pricing: Free up to 1000 clicks/month, 1 app - then subscription pricing

Getting Started

1. Install BoostOps SDK (Always Free)

The BoostLinks feature is included in the BoostOps SDK, which is always completely free:

# Via Unity Package Manager
https://github.com/boostops/unity-sdk.git

Note: The BoostOps SDK is completely free forever and includes BoostLinks, CrossPromo, and analytics integration features. You can generate and host your own files with no usage limits.

2. Open BoostLinks Configuration

In Unity, navigate to:

Window → BoostOps → BoostLinks Configuration

3. Basic Setup

Configure your basic settings:

Domain: Your website domain or free BoostLink subdomain
Bundle ID: Your iOS app bundle identifier
Package Name: Your Android app package name
Fallback URL: Where to redirect when app isn’t installed

4. Choose Your Deployment Method

Self-Hosted Deployment (Always Free)

Enable “Generate Files Locally”
Configure your domain settings
Click “Generate All Files”
Upload generated files to your web server:
- apple-app-site-association → https://yourdomain.com/.well-known/apple-app-site-association
- assetlinks.json → https://yourdomain.com/.well-known/assetlinks.json
✅ No usage limits - handle unlimited clicks and apps

BoostOps Managed (Freemium)

Select “Generate & Manage with BoostOps”
Sign in to your BoostOps account
Configure your project settings
Click “Deploy to BoostOps”
Your BoostLinks will be automatically available at <app>.boostlink.me
Free tier: Up to 1000 clicks/month, 1 app
Paid tier: Higher limits and multiple apps

Platform-Specific Configuration

iOS Universal Links Setup

The tool automatically handles iOS configuration:

Associated Domains: Automatically added to your iOS build
URL Scheme Support: Custom schemes for backward compatibility
Info.plist Configuration: Automatic post-build processing
App Store ID: Optional but recommended for better fallback

Android App Links Setup

Android configuration is similarly automated:

Intent Filters: Automatically added to AndroidManifest.xml
Auto-Verify: Enables automatic link verification
Certificate Fingerprints: Configured for your signing certificate
Fallback Handling: Graceful handling for unverified links

Best Practices

URL Structure

Design your BoostLinks with clear, meaningful paths:

https://yourgame.boostlink.me/level/boss-battle
https://yourgame.boostlink.me/store/premium-pack
https://yourgame.boostlink.me/invite/friend-code-123

Content Validation

Always validate deep link content in your app:

Check if the user has access to the linked content
Verify authentication state for restricted content
Provide fallback screens for invalid links

Testing & Debugging

Use the built-in testing tools:

Link Validation: Verify your BoostLinks are properly configured
Device Testing: Test on both iOS and Android devices
Simulator Support: Test in Unity Editor and device simulators

Advanced Configuration

Custom URL Schemes

For backward compatibility, you can still configure custom schemes:

myawesomegame://level/boss-battle
myawesomegame://store/premium-pack

Multiple Domains

Support multiple domains for different markets:

yourgame.com for global markets
yourgame.jp for Japanese market
yourgame.kr for Korean market

Localized Links

Create region-specific deep links:

https://yourgame.boostlink.me/en/level/boss-battle
https://yourgame.boostlink.me/es/level/boss-battle
https://yourgame.boostlink.me/ja/level/boss-battle

Integration with BoostOps Analytics

When using BoostOps managed BoostLinks, you automatically get:

Click Attribution: Track which campaigns drive the most app opens
Install Attribution: See which links lead to new installs
Conversion Tracking: Monitor how deep links affect in-app purchases
A/B Testing: Test different link destinations and measure performance

Security Considerations

Verification Requirements

iOS: Requires valid HTTPS certificate and proper file hosting
Android: Requires SHA-256 certificate fingerprint verification
Domain Ownership: Must prove ownership of the domain

Data Validation

Always validate incoming deep link data:

public void HandleBoostLink(string url) {
    // Validate URL format
    if (!IsValidBoostLink(url)) {
        // Redirect to safe fallback
        ShowMainMenu();
        return;
    }

    // Parse and validate parameters
    var linkData = ParseBoostLink(url);
    if (!ValidateUserAccess(linkData)) {
        // Show appropriate error or login screen
        ShowLoginScreen();
        return;
    }

    // Proceed with deep link action
    NavigateToContent(linkData);
}

Troubleshooting

Common iOS Issues

Links not opening app: Check Associated Domains configuration
Certificate errors: Ensure valid HTTPS certificate
File not found: Verify apple-app-site-association file is accessible

Common Android Issues

Auto-verification failing: Check certificate fingerprint
Intent not recognized: Verify AndroidManifest.xml configuration
Redirect loops: Check for conflicting intent filters

Testing Tools

Use these tools to verify your setup:

Apple App Site Association Validator: Check iOS configuration
Android Asset Links Tester: Verify Android setup
BoostLinks Tester: Built-in validation tools

Pricing

Free Local Configuration

✅ Unity Editor tool
✅ File generation
✅ Platform configuration
✅ Testing tools
✅ Documentation & guides

BoostOps Managed Service

✅ Everything in Free
✅ Automatic file hosting
✅ Free subdomain (<app>.boostlink.me)
✅ Link analytics & attribution
✅ A/B testing tools
✅ Dashboard management

Getting Support

Documentation

Unity Integration: Unity SDK Guide
Firebase Setup: Firebase Integration
Troubleshooting: BoostLinks Issues

Community & Support

FAQ: Frequently Asked Questions
Contact: Get Support
Discord: Join our developer community

Ready to implement BoostLinks? The BoostLinks tool makes it easy to add professional deep linking to your Unity games. Get started today!