Skip to main content
If Gameball’s traditional widget button does not match your theme, or you don’t have a space for it, you no longer have to depend on Gameball’s button to let your customers and guests access the Gameball loyalty widget. You can hide and replace the button, or add new elements that allow your customers to quickly access any section of the widget from any part of your platform.
Deep links are URLs or hyperlinks that take users directly to a specific section of the Gameball widget. This allows for a more seamless user experience by providing quick access to the desired content without navigating through the entire widget. You can use deep links with any element that can hold a hyperlink, such as text, images, menu items, or buttons. You can also include these hyperlinks in automated emails or SMS campaigns. For example, if a customer clicks a button labeled “Check your earned points now!” in an email, they will be redirected to your website and see the widget section displaying their points.
Takes customers to the home section and guests to the sign-up section.
Home deep link example
Directs customers to the referral tab and guests to the home section.
Referral deep link example
Opens the “FAQ” section for both customers and guests.
FAQ deep link example
Shows customers the levels progress tab and guests the levels program section.
Levels deep link example
Leads customers to the redemption tab and guests to the “How to Redeem” section.
Redemption deep link example
Opens the “Spin the Wheel” page for customers. SDK value: details_wheel.
Opens the Scratch and Win page for customers. SDK value: details_scratch.
Opens the Match Cards page for customers. SDK value: details_match.
Opens The Catcher page for customers. SDK value: details_catcher.
Opens the Calendar Campaign page for customers. SDK value: details_calendar.
Opens the “Slot Machine” page for customers. SDK value: details_slot.
Opens the Quiz page for customers. SDK value: details_quiz.
Opens the Space Shooter page for customers. SDK value: details_shooter.
Opens the Tap the Target page for customers. SDK value: details_tap_target.
Opens the Driving Game page for customers. SDK value: details_highway_drive.
Opens the Sliding Puzzle page for customers. SDK value: details_puzzle.
Opens the Tic Tac Toe page for customers. SDK value: details_tictactoe.
Opens the Survey page for customers. SDK value: details_survey.
Opens the list of Survey campaigns. SDK value: details_survey_list.
Opens the Mission page for customers. SDK value: details_mission.
Opens the Streak campaign page for customers. SDK value: details_streak.
Opens the widget directly in the Customer History section.
To open a specific campaign from an SDK, append the campaign ID to the value — for example, details_catcher_123 or details_quiz_456. See the full web vs SDK compatibility table in Widget Deep Links.
When embedding any widget page to a button on the menu bar, use the deep link in this format: #gameball-home. Do not use the full URL format like https://(home page)/#gameball-home.
To redirect users from an email or SMS to your website and open the Gameball widget to a specific section, you need to use a query string. Combine your website link with the Gameball widget deep link. For example, if you want your customer to press a button on the link that takes them to the homepage of your website and opens up Gameball’s referral section, the link would be as follows: www.example.com/#gameball-referral

​
Triggering the Gameball Widget Using JavaScript

You can also open or toggle the Gameball widget programmatically using the JavaScript function:
This function can be attached to a button’s onclick event, like in the example below:

Hide Gameball's Widget Button

Learn how to hide the default launcher button and rely on deep links instead.

Customize the Widget Launcher

Control the shape, position, icon, and visibility of your loyalty launcher button.

Widget Deep Links (Web & SDK)

See every section key, including SDK openDetail values such as details_quiz and details_catcher_123.