BoostLinks Quick Start
BoostLinks Quick Start
Section titled “BoostLinks Quick Start”Get iOS Universal Links and Android App Links working in your Unity game in just 5 minutes with BoostLinks - the professional deep linking feature included in the free BoostOps SDK.
Prerequisites
Section titled “Prerequisites”- Unity 2021.3 or later
- iOS/Android build support installed
- BoostOps SDK installed in your project (always free - includes BoostLinks, CrossPromo, and analytics integration)
5-Minute Setup
Section titled “5-Minute Setup”Step 1: Open the BoostLinks Configuration Tool
Section titled “Step 1: Open the BoostLinks Configuration Tool”In Unity, go to:
Window → BoostOps → BoostLinks Configuration
Step 2: Choose Your Setup Method
Section titled “Step 2: Choose Your Setup Method”Option A: Self-Hosted (Always Free)
Section titled “Option A: Self-Hosted (Always Free)”Perfect for production use and unlimited scale:
- Click “Generate files locally”
- Enter your domain (e.g.,
yourgame.com
) - Your iOS Bundle ID and Android Package Name are auto-filled
- Click “Generate All Files”
- Upload the 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
Option B: BoostOps Managed (Freemium)
Section titled “Option B: BoostOps Managed (Freemium)”Let us handle everything automatically:
- Click “Generate & manage with BoostOps”
- Sign in to your BoostOps account
- Your project gets a subdomain:
<app>.boostlink.me
- Click “Deploy to BoostOps”
- ✅ Done! Your BoostLinks are live immediately
- Free tier: Up to 1000 clicks/month, 1 app
- Paid tier: Higher limits and multiple apps
Step 3: Test Your Setup
Section titled “Step 3: Test Your Setup”- Build your app to a test device
- In the configuration tool, click “Test BoostLink”
- Scan the QR code or send the test link to your device
- The link should open your app directly
Your First BoostLink
Section titled “Your First BoostLink”Create a Test Link
Section titled “Create a Test Link”Using the BoostOps managed option, your BoostLinks will look like:
https://your-app.boostlink.me/level/boss-battlehttps://your-app.boostlink.me/store/premium-pack
Handle the Link in Your Code
Section titled “Handle the Link in Your Code”Add this to your main game script:
using BoostOps;
public class GameManager : MonoBehaviour { void Start() { // Subscribe to BoostLinks events BoostOpsDynamicLinks.OnDynamicLinkReceived += HandleBoostLink;
// Check for launch link if (!string.IsNullOrEmpty(Application.absoluteURL)) { HandleBoostLink(Application.absoluteURL); } }
void HandleBoostLink(string url) { Debug.Log($"BoostLink received: {url}");
// Parse the URL if (url.Contains("/level/")) { string levelName = url.Split('/').LastOrDefault(); LoadLevel(levelName); } else if (url.Contains("/store/")) { string itemId = url.Split('/').LastOrDefault(); OpenStore(itemId); } }
void LoadLevel(string levelName) { // Your level loading logic Debug.Log($"Loading level: {levelName}"); }
void OpenStore(string itemId) { // Your store opening logic Debug.Log($"Opening store for item: {itemId}"); }}
Testing Checklist
Section titled “Testing Checklist”iOS Testing
Section titled “iOS Testing”- Test BoostLink opens app when installed
- Test BoostLink goes to App Store when not installed
- Test different link paths work correctly
- Test from Safari, Messages, and other apps
Android Testing
Section titled “Android Testing”- Test BoostLink opens app when installed
- Test BoostLink goes to Play Store when not installed
- Test auto-verification works
- Test from Chrome, Messages, and other apps
Common Issues & Solutions
Section titled “Common Issues & Solutions”iOS Issues
Section titled “iOS Issues”BoostLink opens Safari instead of app
- Check that your
apple-app-site-association
file is accessible - Verify your Associated Domains are correctly configured
- Make sure you’re using HTTPS with a valid certificate
Android Issues
Section titled “Android Issues”BoostLink doesn’t auto-verify
- Check your certificate fingerprint in the configuration
- Verify your
assetlinks.json
file is accessible - Make sure your domain is properly configured
General Issues
Section titled “General Issues”BoostLinks work on one platform but not the other
- Check that both platform files are properly deployed
- Verify your app’s bundle ID/package name matches the configuration
- Test on actual devices (simulators can behave differently)
Next Steps
Section titled “Next Steps”Add Analytics
Section titled “Add Analytics”If using BoostOps managed BoostLinks, you automatically get:
- Click tracking
- Install attribution
- Conversion analytics
- A/B testing capabilities
Advanced Configuration
Section titled “Advanced Configuration”- Custom URL schemes: For backward compatibility
- Multiple domains: For different markets
- Localized links: For international games
- Campaign tracking: For marketing attribution
Learn More
Section titled “Learn More”Need Help?
Section titled “Need Help?”Quick Support
Section titled “Quick Support”- Discord: Join our developer community
- Email: support@boostops.com
- Docs: FAQ and BoostLinks Troubleshooting
Video Tutorial
Section titled “Video Tutorial”Watch our 5-minute video guide: BoostLinks Setup Tutorial
That’s it! You now have professional BoostLinks working in your Unity game. Your users will get a seamless experience whether they have your app installed or not.