Widget Deep Links
Enable Opening Gameball Widget Through Inline links Using Deep-links
Last updated
Enable Opening Gameball Widget Through Inline links Using Deep-links
Last updated
Gameball provides the flexibility to customize how your customers access the loyalty widget. If the default widget button does not align with your platform’s theme or if space is limited, you can hide or replace the button and use deep links to give customers quick access to specific widget sections from anywhere on your platform.
This guide explains how to use deep links effectively and integrate them into your website, emails, or campaigns.
Deep links are URLs or hyperlinks that navigate customers directly to a specific section of the Gameball widget. They enhance the user experience by allowing customers to access the desired content immediately, bypassing unnecessary steps.
Deep links can be added to any element that supports hyperlinks, such as:
Text
Images
Menu items
Buttons
They can also be included in automated emails or SMS campaigns. For instance, if a customer clicks on a button labeled “View Your Points” in an email, they will be redirected to your website, and the Gameball widget will automatically display their points section.
Here are the deep links Gameball provides to help you customize your user experience:
#gameball-home – Takes customers to the home section and guests to the guest-view section.
#gameball-referral – Directs customers to the referral tab and guests to the home section.
#gameball-faq – Opens the "FAQ" section for both customers and guests.
#gameball-levels – Shows customers the levels progress tab and guests the levels program section.
#gameball-redemption – Leads customers to the redemption tab and guests to the "How to Redeem" section.
#gameball-wheel – Opens the "Spin the Wheel" page for customers.
#gameball-slot – Opens the "Slot Machine" page for customers.
There are three ways to implement deep links, depending on your platform and requirements:
You can append a #gameball-[section-name] hash to your website URL to navigate customers to specific sections of the widget.
Examples:
Home section: https://your-website.com/#gameball-home
Referral section: https://your-website.com/#gameball-referral
Alternatively, you can use the query parameter ?gameball-deep=[section-name] to embed deep links into emails, SMS campaigns, or website navigation.
Examples:
Home section: https://your-website.com/?gameball-deep=home
Referral section: https://your-website.com/?gameball-deep=referral
You can programmatically control the Gameball widget usingGbSdk.toggleDeeps("toggle", "[section-name]") function.
Example:
This is useful for scenarios where you want to provide customers with a button to easily open the widget on your website.
For mobile apps, you can programmatically control the Gameball widget using our SDKs. Pass the openDetail parameter with specific values to navigate directly to various sections of the widget.
Supported Values for openDetail:
details_referral – Opens the referral section.
details_reward_campaign – Displays the list of reward campaigns.
details_reward_campaign_{RewardID} – Opens a specific reward campaign by its ID.
details_wheels_list – Displays the list of available wheels.
details_wheel – Opens a specific wheel.
details_redeem_coupons – Navigates to the coupon redemption section.
details_slot_list – Shows the list of slot games.
details_slot – Opens a specific slot game.
Example (Using the Android SDK):
This approach is tailored for mobile apps and ensures a seamless customer experience.
In this tutorial, we’ve covered the various ways to utilize Gameball deep links and SDK functionalities to provide a seamless and personalized experience for your customers:
Hash Format and Query Parameters: Enable direct navigation to specific widget sections from your website, emails, or SMS campaigns.
SDKs Methods: Offer advanced control for mobile apps and programmatically toggle the widget state or navigate to specific sections.
Examples and Supported Sections: Illustrate how to guide customers to areas like referrals, rewards, or wheels.
By combining these methods, you can tailor the Gameball widget’s behavior to fit your platform and create a smoother customer journey.
