Mobile App Deeplinking¶
With deeplinking, you can provide a link to a specific page within your mobile app. For example, you may send congregants an email with a link to an important announcement that has been made available in the app. If a recipient opens the email on a mobile device, clicking the link will open the mobile app directly to the announcement.
The domain used for these links is yourchurch.app.tpsdb.co
, where “yourchurch” is
replaced with the domain for your database. Read below for how to use your own domain for deeplinking,
how to set up a deeplink, what deeplinks are available and more…
Safelinks’ Impact on Deeplinks
If your email system is a Microsoft Exchange Server or certain Outlook services, Safelinks may be enabled for your email. Safelinks convert links before they arrive in your Inbox and will usually break deeplinks so that they do not work as intended. To be clear, deeplinks as they are sent out through TouchPoint email are not affected by Safelinks; it is only when the email is delivered to a recipient who has Safelinks that the deeplink is altered. If the Safelinks feature is negatively impacting one or more of your email recipients, it can be turned off. Below are some helpful links:
How to turn off Safelinks for an individual Office 365 subscriber
How to disable Safelinks for an Organization
Exclude specific URLs from Safelinks modification (for an Organization)
How to Use Your Own Domain for Deeplinking¶
If you want to use your own domain for these, you will need to create a CNAME entry in your domain’s DNS settings, associating your desired domain name with the actual domain used. For example, if you want to use app.yourchurch.org, create the CNAME record with app.yourchurch.org as the alias and yourchurch.app.tpsdb.co as the destination (again, where “yourchurch” is replaced with the domain for your database). Then you will need to notify Support of the domain name you are using since it will require an update to your app for a nominal fee.
Available Deeplinks¶
Listed below are deeplinks available for use. For all of them, replace the domain name with your own. When you include the protocol (http or https) in the address when sending in an SMS message through TouchPoint, the link will automatically be translated to a shortened URL.
https://mychurch.app.tpsdb.co/profile/giving : takes user to their giving history page
https://mychurch.app.tpsdb.co/giving/history : an alternate link to the giving history page
https://mychurch.app.tpsdb.co/ : takes user directly to the enabled giving page created in your database under Adminstration > Setup > Online Giving by using the text after the
.com/
from the Public URL and adding it to the end of this URL. Example: If the Public URL to your giving page ishttps://mychurch.tpsdb.com/Give/now
, the deeplink URL will behttps://mychurch.app.tpsdb.co/Give/now
https://mychurch.app.tpsdb.co/registrations/landing : takes user to the Registrations page
https://mychurch.app.tpsdb.co/registrations/register/100 : takes user directly to the registration page for the Involvement whose ID is the number at the end of the deeplink
https://mychurch.app.tpsdb.co/registrations/details/100 : takes user directly to the registration Details page for the Involvement whose ID is the number at the end of the deeplink
https://mychurch.app.tpsdb.co/profile/information : takes user to their own profile information
https://mychurch.app.tpsdb.co/profile/family : takes user to My Family page where family members are listed
https://mychurch.app.tpsdb.co/profile/involvement : takes user to their Involvements page
https://mychurch.app.tpsdb.co/tools/attendance : takes user to the Attendance page
https://mychurch.app.tpsdb.co/tools/peoplesearch : takes user to the People Search page
https://mychurch.app.tpsdb.co/tools/tasks : takes user to the Tasks page
https://mychurch.app.tpsdb.co/location/select : takes user to the Select Location page
https://mychurch.app.tpsdb.co/location/information : takes user to the Location Information page
https://mychurch.app.tpsdb.co/location/view : takes user to the Location Information page
https://mychurch.app.tpsdb.co/precheckin/ : takes user directly to Pre Check-In (the trailing
/
is required)https://mychurch.app.tpsdb.co/prayerrequest/ : takes user directly to Prayer Requests (the trailing
/
is required)
Deeplink Redirections¶
Some of these deeplinks, when clicked on a desktop/laptop will take the user to the corresponding page in the web application. Below are the links that will work in this way, along with the URL to the matching web page:
Deeplink |
Desktop Redirect |
---|---|
The following deeplinks will not redirect to a corresponding web page. Instead the user is brought to an App Store Promo page with button links for getting the app from the Google Play Store or from the Apple App Store. If you would like to customize this page (perhaps with additional explanation or instructions), create a Special Content HTML file named AppStorePromoPage. We recommend you start with the HTML code of the default page and modify it with your changes. Generic code for the page is provided below, but you may find it more convenient to copy the page source from the actual web page so you have the URL for your app icon.
When any deeplink is clicked on a mobile device but the user does not have the app installed, the user is brought directly into the app store with the app selected so they can download it.
Sample HTML code for AppStorePromoPage¶
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 | <!DOCTYPE html> <html xmlns="http://www.w3.org/1999/xhtml"> <head> <title>Install our app</title> <style> * { border: none; font-family: Helvetica Light, Segoe UI Light, sans-serif; text-align: center; } html { height: 100%; } body { height: 100%; padding: 20px; } @media only screen and (min-width: 735px) { .center-screen { display: inline-block; left: 50%; position: absolute; top: 50%; transform: translate(-50%, -50%); } } img.android.badge { width: 280px; } img.icon { border-radius: 20px; height: 246px; } img.ios.badge { width: 246px; } h1 { font-size: 3em; } h2 { font-size: 2.5em; } h3 { font-size: 2em; } h4, p { font-size: 1.5em; } </style> </head> <body> <main class="center-screen"> <h1> Install our app<br /> from your favorite app store </h1> <h2> <img src="" alt="App icon" class="icon badge" /> -- for src, enter URL for your Google app icon </h2> <p> <a href="https://play.google.com/store/apps/details?id=com.touchpointinternal.mobile"> <img class="android badge" alt="Get it on Google Play" src="https://play.google.com/intl/en_us/badges/static/images/badges/en_badge_web_generic.png" /> </a> </p> <p> <a href="https://apps.apple.com/us/app/id1510828606"> <img class="ios badge" alt="Download on the App Store" src="/img/Apple_App_Store_Badge.svg" /> </a> </p> </main> </body> </html> |
Latest Update |
10/28/2024 |
Update Tasks redirect URL