Learn how to set up and use URLs, links, and deep links in OneSignal messages including Push, Email, In-App Messages, and SMS.
https://
.http://
URLs with Apple devices, you must setup the NSAppTransportSecurity property in your app’s Info.plist
file.your-custom-scheme://
, results may vary. See Deep Linking.url
— for general targeting across all platforms.web_url
— for web push Subscriptions.app_url
— for mobile Subscriptions.OneSignal Dashboard – Launch URL Field
data
in the API) to send custom data with your push and handle this data in your app using the SDK’s Notification Click Listener via the additionalData
property. This might be a better option than Launch URL to provide more flexibility.Send a URL to read within your app via the Additional Data field.
external_id
, email
)custom_data
sent via the APIexternal_id
or email
directly into URLs.Example:external_id
is 12345, the final URL will be:john@example.com
, the final URL will be:custom_data
for parts of the URL. Don’t include the protocol (https://
or your-app-scheme://
) and domain in the URL.default
filter to set a default value if the tag is not set.source
, medium
, and campaign
details to URLs. Simply add your UTM parameters directly into the URLs of your messages.
You can have OneSignal automatically add UTMs to push notification Launch URLs sent from the Dashboard.
Automatic UTMs for push notifications.
utm_source
defaults to onesignal
utm_medium
defaults to push
utm_campaign
defaults to {{ sendDate }}-{{ title }}
sendDate
: Date senttitle
: First 15 alphanumeric characters, underscores, or hyphens from the message titlehttps://developer.android.com/distribute/marketing-tools/linking-to-google-play.html
iOS - get the link to the app store page, but replace https://
with itms-apps://
.
x://
. For example, deep linking into Whatsapp, you can use: whatsapp://wa.me/15551234567
For email and sms, you will need to use the https://
app store link.
?_osp=do_not_open
to the end of a URL like this https://yoursite.com/page?_osp=do_not_open
as the launch url, this will prevent the push from going to any url upon click and will just dismiss the push.