Deep Link Integration

AdStage Cross Promotion integrates deeply with the deep link system to deliver accurate attribution and seamless redirection. This document explains the auto‑generated link, parameter structure, and redirect logic.

Auto Generation Workflow

When a promotion is created:

Unique deep link URL allocated
Tracking parameters (UTM + custom) attached
Platform redirect targets stored (Android / iOS / Web)
Real-time tracking pipeline activated (impression, click, install)

Deep Link Structure

Example:

https://your-domain.com/deeplink/{promotion-id}
?utm_source=cross_promotion
&utm_medium=banner
&utm_campaign={app-name}
&audience={target-audience}
&region={selected-regions}
&ageGroup={age-group}
&interest={primary-interest}

Standard UTM Parameters

Parameter	Value Type	Purpose
utm_source	Fixed: cross_promotion	Identifies channel
utm_medium	Fixed: banner	Identifies placement type
utm_campaign	Dynamic (App name)	Attributes to specific app campaign
utm_content	Dynamic (banner type)	Compare asset / layout types
utm_term	Dynamic (targeting keywords)	Analyze targeting combos

Custom Targeting Parameters

Category	Key	Example	Notes
Audience	audience	new	all / new / existing
Interest	interest	gaming	Primary category
Age Group	ageGroup	twenties	teens / twenties / thirties / forties / fifties_plus
Region	region	kr	kr / jp / us / sea / eu / global
Game Genre	gameGenre	rpg	If game app context
Spending Tier	gameSpending	medium	free / low / high
Play Time	playTime	evening	morning / noon / evening / night
Device	deviceType	mobile	mobile / tablet

Redirect Logic (Smart Routing)

Detect app install status
- Installed → Open app via deep link
- Not installed → Proceed to platform store
Detect platform
- Android → Play Store URL
- iOS → App Store URL
- Other → Web URL fallback
Preserve parameters through redirect for attribution & post-install context

Store URL Usage Examples

Android:

https://play.google.com/store/apps/details?id=com.pkg.name&referrer=utm_source%3Dcross_promotion%26utm_campaign%3Dmy_app

iOS:

https://itunes.apple.com/app/id123456789?pt=provider_token&ct=cross_promotion_my_app

Web:

https://example.com/app?utm_source=cross_promotion&utm_campaign=my_app&audience=new

Tracked Events

Event	Trigger	Purpose
Impression	Banner enters viewport	Exposure measurement
Click	User taps/clicks banner	Engagement & CTR analysis
Install	First confirmed install	CPI & conversion evaluation
First Open	App opens after install	Activation quality signal

Analytics Dimensions

Time breakdown (hour/day)
Region
Device type
Targeting attributes (age, interest, genre)

Troubleshooting

Symptom	Cause	Action
No installs recorded	Missing post-install callback	Verify SDK integration
CTR suddenly drops	Creative fatigue or load issue	Refresh banner / check asset delivery
Region parameter blank	Targeting misconfiguration	Recreate promotion or adjust targeting
Duplicate clicks	Client-side double fire	Add dedupe guard (throttle / idempotent key)

Governance Best Practices

Maintain consistent event naming & parameter casing
Document required parameters for each promotional app
Periodically audit deprecated promotions & disable unused links

Leverage the structured parameters to build cohort analyses and optimize creative + targeting combinations.

Deep Link Integration

Table of Contents