Skip to content

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.


Traditional app marketing often requires separate links and QR codes for Apple and Android users:

  • https://apps.apple.com/app/id123456789 for iPhone users
  • https://play.google.com/store/apps/details?id=com.example for Android users
  • https://example.com/app for 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

  1. Open the link creation modal or edit an existing link in the web application.
  2. Expand the Device Targeting section.
  3. Enter your iOS Destination URL (e.g. App Store link).
  4. Enter your Android Destination URL (e.g. Google Play link).
  5. Save changes.

Targeting takes effect immediately across all live links and printed QR codes.