Help Center

| Submit or View Help Requests | Developer Docs |

View desktop instructions
View mobile app instructions
Configure Deep Linking Logic with URI Schemes

Certain mobile apps with custom in-app browsers don't support all deep linking technologies, making it necessary to use URI schemes external-link-alt-solid.svg to ensure consistent tracking when standard deep linking fails. Follow the steps in this article to enhance the accuracy of your conversion tracking when users engage with your sales landing page via these custom in-app browsers.

Desired outcome flowchart

The flowchart below represents the outcome for which you're aiming. In short, you want to configure a redirect rule on impact.com to route users who click your tracking link to the relevant mobile app page whenever possible. If not possible due to the app not being installed on the user's device, you'll want to direct them to the web version of that page. You can also configure an interstitial landing page on impact.com, as this will allow you to ensure that the user is only redirected to destination pages recognized by your app.

Screenshot_2024-05-28_at_12_14_06_PM.png

Prerequisites

  • Your mobile app's URI scheme, e.g. acmeapp://item/view/12345, must be the same across Android and iOS versions of your app.

  • Your web URL paths must be mapped to your mobile app URI scheme in order for redirection to work, e.g., if ACME Corporation's URL is https://acme.com/item/view/12345, their URI will be acmeapp://item/view/12345.

  • You must know any unsupported paths (i.e., paths that aren't mapped) within your mobile app so that you can implement corresponding filters to the interstitial page within the rule conditions, as detailed below.

Configure URI scheme tracking

Step 1: Configure URI scheme tracking on your app

Configure your mobile app to track when the referrer is a URI scheme.

  1. Parse the clickid from the URI scheme and other relevant gateway tracking parameters.

  2. Call the PageLoad API, passing the URI to the PageUrl field on app open events.

    Example: acmeapp://item/view/12345?clickid=abcdef12345.

Step 2: Configure your program's URI scheme
  1. On impact.com, navigate to ellipsis-v-solid.svg [Menu] → Settings.

  2. In the right column, under Tracking, select General.

  3. In the URI Scheme field, select pencil-alt-solid__2_.svg [Edit].

  4. Enter your mobile app's URI scheme, excluding :// from the end of the scheme.

    • If multiple URI schemes are listed, impact.com will default to the first scheme.

  5. Select Save.

    Screenshot_2024-05-31_at_10_45_56_AM.png
Step 3: Create redirect rule
  1. From the left navigation bar, select ellipsis-v-solid.svg [Menu] → Settings.

  2. In the right column, under Technical, select Blocking & Redirect.

  3. In the upper-right corner, select Create rule.

  4. Name the rule descriptively.

    • The name should indicate the purpose of the rule.

  5. Add a Condition with the App Name parameter, and enter the mobile app platforms for which the rule is applicable.

    • impact.com recommends including Facebook, Instagram, and X.

  6. Optionally, plus-circle-solid__1_.svg [Add another] condition with the Landing Page parameter, and specify paths and domains for which you want to redirect users.

    • This step is recommended and will allow you to use the feature only for paths that your app can recognize.

    • Use regex external-link-alt-solid.svg to match landing pages that contain specific paths — see the example below.

    ^(https?:\/\/)?(www\.)?(domain\.com|sub\.domain\.com)(\/(shop|product)(\/[^?]*?)?)?(\/?(\?.*)?)?$
  7. Optionally, plus-circle-solid__1_.svg [Add another] condition with the Probability parameter and specify a percentage of traffic to be rerouted for A/B testing.

    Screenshot_2024-05-31_at_11_11_25_AM.png
Step 4: Customize interstitial for Mobile Deep Linking
  1. In the Action field, use the angle-down-solid.svg [Dropdown menu] to select Mobile Deep Linking.

  2. Customize the interstitial template to align with your brand:

Fields

Description

Header text & font color

Your header text is a short phrase displayed on your interstitial in large type. You can specify what this text says and define the font color using the color picker or hexadecimal external-link-alt-solid.svg notation.

Sub header text & font color

Your subheader text is a short phrase displayed on your interstitial below your header text. You can specify what this text says and define the font color using the color picker or hexadecimal external-link-alt-solid.svg notation.

Upload logo

Upload your brand logo in .gif, .jpg, .png, or .svg format. The image can't be > 1 MB in size.

Upload cover image

Upload a suitable background image in .gif, .jpg, .png, or .svg format. The image can't be > 1 MB in size.

Open App button label & colors

Your button label is the text displayed on the button that opens the URI scheme to your mobile app. You can specify what this text says and define the font color using the color picker or hexadecimal external-link-alt-solid.svg notation.

Continue link label & font color

Your link label is the text displayed on the link that opens your destination web page URL. You can specify what this text says and define the font color using the color picker or hexadecimal external-link-alt-solid.svg notation.

Screenshot_2024-05-31_at_3_58_38_PM.png
Step 5: Configure app open logic & auto-redirect
  1. In the Action field, scroll to the end of the visual customization options and fill in the following fields.

    Field

    Description

    App Open

    Indicate when to open your mobile app:

    • As soon as the interstitial loads [Recommended] — automatically open your mobile app on the user's device as soon as the interstitial loads.

    • When the button is tapped — after the interstitial loads, require the user to approve your mobile app opening on their device.

    Auto-redirect

    Select the square-regular.svg [Unchecked box] to define a timeout in case the app open fails, after which they'll be redirected automatically to the web link. impact.com recommends a 10-second timeout.

    Default URI Path

    Enter a URI path, such as for your website's home page, to be used when one isn't extracted from the URL. This ensures that your app opens successfully even from a custom in-app browser that would otherwise fail to open your app. E.g., if your destination page URL is https://acme.com, and you input a default URI path of home, the resulting URI scheme link will be acmeapp://home.

    Custom URI Regex

    By default, impact.com creates a URI scheme link by appending paths from the destination landing page URL to the URI scheme. E.g., if your destination page URL is https://acme.com/product/12345, and your URI scheme is acmeapp, the resulting URI scheme will be acmeapp://product/12345.

    However, you can also use regex external-link-alt-solid.svg to specify which parts of a destination page URL must be extracted and appended to the URI scheme. E.g., if your destination page URL is https://acme.com/product/12345, and you input a regex of acme\.com.*$, the resulting URI scheme will be acmeapp://acme.com/product/12345.

  2. Remember to Save your rule when you're done.

    Screenshot_2024-05-31_at_12_42_51_PM.png

Using interstitials with postbacks

If you use postbacks to track conversions across various impact.com program types, impact.com recommends implementing the interstitial only on your primary program. The primary program handles the last redirect before the destination page, ensuring that all clicks are tracked before opening your mobile app. This approach ensures that attribution works accurately when the conversion is posted to one of the child programs.

Did you find it helpful? Yes No

Send feedback
Sorry we couldn't be helpful. Help us improve this article with your feedback.