Device Targeting (iOS & Android)¶
Device targeting allows a single link or QR code to route visitors to platform-specific destinations based on their mobile operating system.
The Unified Link Strategy¶
Traditional app marketing often requires separate links and QR codes for Apple and Android users:
https://apps.apple.com/app/id123456789for iPhone usershttps://play.google.com/store/apps/details?id=com.examplefor Android usershttps://example.com/appfor desktop visitors
With Ruby, you share a single, on-brand link (e.g. https://rby.one/A7K92X1P or a QR code). Ruby inspects the client's device in real time at the network edge and routes each visitor to their platform's native store or deep link.
How Routing Works¶
When a visitor opens your link:
| Visitor Platform | Destination Evaluated | Typical Use Case |
|---|---|---|
| iOS (iPhone, iPad, iPod) | iOS URL (ios_url) |
Apple App Store listing or iOS universal link |
| Android Devices | Android URL (android_url) |
Google Play Store listing or Android app intent |
| Desktop & Others | Destination URL (destination_url) |
Web application, marketing homepage, or feature overview |
If a mobile destination is left empty (e.g. no iOS URL is configured), iOS visitors automatically fall back to the primary Destination URL.
Parameter Forwarding Across Mobile Stores¶
Ruby applies the same attribution and query parameter forwarding rules to mobile destinations:
- UTM Tracking: Configured UTM parameters (
utm_source,utm_medium,utm_campaign, etc.) are automatically appended to your store URLs, enabling install attribution in App Store Connect and Google Play Console. - Dynamic Query Strings: Any parameters appended by advertising platforms or email links (e.g.
?campaign_id=123) are seamlessly preserved and forwarded to the mobile target.
Configuring Device Targeting¶
- Open the link creation modal or edit an existing link in the web application.
- Expand the Device Targeting section.
- Enter your iOS Destination URL (e.g. App Store link).
- Enter your Android Destination URL (e.g. Google Play link).
- Save changes.
Targeting takes effect immediately across all live links and printed QR codes.