Optional Attribution Parameters (UTM)
UAS links support standard UTM parameters for execution attribution.
These parameters allow ONCHAIN and integrators to understand where execution intent originates across wallets, bots, launchpads, explorers, and other distribution surfaces — without introducing custody, tracking scripts, or platform control.
UTM parameters are optional, but strongly recommended for integrators distributing UAS links across multiple environments.
UTM parameters do not affect execution routing, pricing, access guarantees, or settlement.
Supported UTM Parameters
utm_source
The specific surface where the link appears
utm_medium
The class of surface
utm_campaign
Logical grouping or distribution phase
utm_content
(Optional) Placement or variant identifier
UTM parameters follow standard conventions and are passed through execution unchanged.
Recommended utm_medium Values
To ensure consistency across the UAS ecosystem, integrators are encouraged to select utm_medium values from the list below.
These values describe the type of surface, not the implementation details.
wallet
Embedded inside a wallet UI
bot
Automated or chat-based agents (Telegram, Discord, Farcaster, etc.)
explorer
Block explorers and discovery tools
launchpad
Token launch and distribution platforms
social
Social feeds and profile links
web
General-purpose websites or web applications
api
Programmatic or server-generated execution
Email-based distribution
qr
Physical or scanned QR placements
Integrators may use custom values if necessary, but doing so may reduce comparability across surfaces.
Example: UAS Link with Attribution
utm_source=telegram identifies the exact surface
utm_medium=bot classifies the execution environment
utm_campaign=uas_links groups related distribution
utm_content=inline_cta identifies placement (optional)
If your UAS link already includes query parameters, append UTM parameters using &.
Recommended Naming Conventions
To maintain clean attribution data:
Use lowercase
Use underscores instead of spaces
Keep utm_source specific and utm_medium generic
Avoid user-identifiable or sensitive data
Good
Avoid
Why Attribution Matters
Because UAS links are permissionless and portable, execution may originate far from the destination application.
UTM parameters allow ONCHAIN and integrators to:
Measure execution completion by surface type
Compare execution quality across environments
Understand repeat execution behavior
Improve distribution without restricting access
Attribution is informational only and does not influence execution behavior.
Last updated