Using Deeplinks with Endemic Offers
Who is this for: Mobile app developers building endemic offer integrations who need offers to open directly in a native app instead of a browser.
Outcome: Configure a MomentScience bounce URL that wraps a deeplink, enabling tracking while routing users to specific in-app destinations from endemic offer clicks.
Overview
For mobile app integrations, you can use mobile app deeplinks as landing page URLs in your direct offers. Deeplinks open offers directly in native apps instead of web browsers, providing a more integrated user experience. MomentScience supports deeplink URLs through a bounce URL mechanism that preserves tracking.
This feature applies only to endemic offers shown within mobile apps. Standard web-based offers should use regular HTTPS URLs.
When to Use Deeplinks
Use deeplinks when:-
- Your endemic offer promotes in-app content or features
- You want users to land directly in your mobile app
- You need to drive engagement to specific app sections
- Your target audience accesses offers from within your mobile app
How Bounce URLs Work
Since raw deeplinks (like `yourapp://section`) cannot be used directly as landing pages, MomentScience provides a bounce URL mechanism. The bounce URL wraps your deeplink in a standard HTTPS URL that redirects users into your mobile app while enabling tracking.
Step-by-Step Setup
Step 1: Identify Your Deeplink
Determine the deeplink URL that opens the desired destination in your mobile app.
Examples:
- yourapp://home
- yourapp://offers/spring-sale
- myapp://section?id=123
Step 2: Encode Your Deeplink
Deeplinks must be URL-encoded before being used in the bounce URL. Use your browser's developer console to encode the deeplink:
encodeURIComponent("yourapp://section")This returns the encoded version:
yourapp%3A%2F%2FhomeStep 3: Construct the Bounce URL
Use this template to build your bounce URL:
https://trk.pubtailer.com/sdk/campaign/landing?q=ENCODED_DEEPLINKURL Parameters:
- q : Contains your URL-encoded deeplink from Step 2
Replace ENCODED_DEEPLINK with your encoded deeplink from Step 2.
Example:
https://trk.pubtailer.com/sdk/campaign/landing?q=yourapp%3A%2F%2FhomeStep 4: Use as Landing Page URL
In the offer creation form:
- Navigate to the Landing page URL field
- Paste your complete bounce URL
- Complete the rest of your offer configuration
Step 5: Test Your Configuration
Before launching your offer:
Quick test: Open the bounce URL directly on a mobile device where your app is installed. The app should open to the correct destination.
- Create a test offer using the bounce URL
- Click the offer CTA from within your mobile app
- Verify the app opens to the correct destination
App Not Installed Behavior
If users click an offer with a deeplink but don't have the target app installed, the mobile operating system will handle the failed deeplink attempt. Typically, this results in a silent fail or system-level prompt. For endemic offers shown within mobile apps, this is acceptable since the target app is already installed (users are viewing the offer from within the app).
Test thoroughly in your target environment before launching offers to production.
Tracking Verification
After setting up your bounce URL, verify that tracking works correctly by checking that offer clicks appear in your MomentScience dashboard reporting.
Common Mistakes
Issue | Incorrect | Correct |
|---|---|---|
Wrong parameter name | ?url=yourapp%3A%2F%2Fhome | ?q=yourapp%3A%2F%2Fhome |
Unencoded deeplink | ?q=yourapp://home | ?q=yourapp%3A%2F%2Fhome |
๐ข If you're running into any issues while going through the integration process, feel free to contact us at [email protected]๏ปฟ