Gameball Developers Guide
v4.0
v4.0
  • Introduction
  • Installing Gameball
    • Web
      • Initialize Gameball Customer Widget
      • Track Customer Events
      • Track Orders & Cashback Reward
      • Integrate Redemption
      • Track Referrals
      • Go-Live Checklist
    • iOS
      • Getting Started
      • Initialize Gameball Customer Profile
      • Track Customer Events
      • Track Orders & Cashback Reward
      • Integrate Redemption
      • Push Notifications
      • Track Referrals
      • Go-Live Checklist
    • Android
      • Getting Started
      • Initialize Gameball Customer Profile
      • Track Customer Events
      • Track Orders & Cashback Reward
      • Integrate Redemption
      • Push Notifications
      • Go-Live Checklist
    • React Native
      • Getting Started
      • Initialize Gameball Customer Profile
      • Track Customer Events
      • Track Orders & Cashback Reward
      • Integrate Redemption
      • Track Referrals
      • Push Notifications
      • Go-Live Checklist
    • Flutter
      • Getting Started
      • Initialize Gameball Customer Profile
      • Track Customer Events
      • Track Orders & Cashback Reward
      • Integrate Redemption
      • Track Referrals
      • Go-Live Checklist
    • Generic Mobile App
      • Initialize Gameball Customer Profile
      • Track Customer Events
      • Track Orders & Cashback Reward
      • Integrate Redemption
      • Track Referrals
      • Push Notifications
  • REST API
    • Overview
      • What's New in V4.0
      • Authentication
      • Rate Limiting
      • Status and Error Codes
    • Customers
      • Customer Management
      • Customer Progress
      • Customer Tags
      • Customer Notifications
    • Events
    • Order
      • Order Tracking
      • Order Rewards & History
    • Payment
      • Payment Tracking
    • Transactions
      • Cashback & Redemptions
      • Hold Management
      • Transaction Management
      • Transaction Validation
    • Coupons
    • Configurations
      • Reward Configurations
      • Program Configurations
      • Widget Configuration
    • Leaderboard
    • Batches
      • Batch Creation
      • Batch Management
  • Webhooks
    • Overview
    • Subscribing to Webhooks
    • Webhook Topics
      • Customer's Notifications
      • Customer's Profile Updates
  • Tutorials
    • Tracking Customer Events
    • Redemption Integration
      • Direct debit redemption
      • Coupons Redemption
        • Use Your Own Couponing Engine
        • Gameball Couponing Engine
    • Checkout Integration
    • Build Custom UI Elements
      • Reward Campaigns
      • VIP Tiers
      • Customer Balance
      • Widget Configurations
      • Coupons Customer Experience
      • Customer Notifications
      • Customer Leaderboard
    • Build your Own Notification System
    • Channel Merging Guide
    • Previewing Potential Points Before Purchase
    • Refund
    • Retail & POS Integration with Gameball Loyalty Program
    • Referrals
    • Widget Deep Links
    • Batch APIs usage example
  • Branch.io Integration
  • Adjust Integration
Powered by GitBook
On this page
  • What Are Deep Links?
  • How to Use Deep Links
  • Available Deep Links
  • Implementation Guidelines
  • 1. Using the Hash Format (Web)
  • 2. Using Query Parameters (Web)
  • 3. Programmatically Using Javascript
  • 4. Using the SDK (Mobile Apps)
  • Summary
  1. Tutorials

Widget Deep Links

Enable Opening Gameball Widget Through Inline links Using Deep-links

PreviousReferralsNextBatch APIs usage example

Last updated 20 days ago

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.


What Are Deep Links?

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.


How to Use Deep Links

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.


Available Deep Links

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.

  • #gameball-calendar – Opens the "Calendar Campaign" page for customers.


Implementation Guidelines

There are three ways to implement deep links, depending on your platform and requirements:

1. Using the Hash Format (Web)

You can append a #gameball-[section-name] hash to your website URL to navigate customers to specific sections of the widget.

https://your-website.com/#gameball-[section-name]

Examples:

  • Home section: https://your-website.com/#gameball-home

  • Referral section: https://your-website.com/#gameball-referral

2. Using Query Parameters (Web)

Alternatively, you can use the query parameter ?gameball-deep=[section-name] to embed deep links into emails, SMS campaigns, or website navigation.

https://your-website.com/?gameball-deep=[section-name]

Examples:

  • Home section: https://your-website.com/?gameball-deep=home

  • Referral section: https://your-website.com/?gameball-deep=referral

3. Programmatically Using Javascript

You can programmatically control the Gameball widget usingGbSdk.toggleDeeps("toggle", "[section-name]") function.

Example:

GbSdk.toggleDeeps("toggle", "referral");

This is useful for scenarios where you want to provide customers with a button to easily open the widget on your website.

4. Using the SDK (Mobile Apps)

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_redeem_coupons – Navigates to the coupon redemption section.

  • details_reward_campaign – Displays the list of reward campaigns.

  • details_reward_campaign_{CampaignID} – Opens a specific reward campaign by its ID.

  • details_wheels_list – Displays the list of available wheels.

  • details_wheel – Navigates to the first wheel details available from the wheels' list.

  • details_wheel_{WheelID} – Opens a specific wheel by its ID.

  • details_slot_list – Displays the list of available slot machines.

  • details_slot – Navigates to the first slot machine details available from the slots' list.

  • details_slot_{SlotID} – Opens a specific slot machine by its ID.

  • details_calendar – Navigates to the first calendar campaign details available.

  • details_calendar_{CalendarID} – Opens a specific calendar campaign by its ID.

  • details_scratch - Navigates to the first Scratch and Win available.

  • details_scratch_{ScratchId} - Opens a specific Scratch and Win by its ID.

  • details_match - Navigates to the first Match game available.

  • details_match_{MatchId} - Opens a specific Match game by its ID.

  • details_redeem_main - Opens the main opens redeem tab.

Example (Using the Android SDK):

gameballApp.showProfile(this, "customer1234", "details_referral", true);

This approach is tailored for mobile apps and ensures a seamless customer experience.


Summary

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:

  1. Hash Format and Query Parameters: Enable direct navigation to specific widget sections from your website, emails, or SMS campaigns.

  2. SDKs Methods: Offer advanced control for mobile apps and programmatically toggle the widget state or navigate to specific sections.

  3. 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.

Open Gameball widget using menu item
Open Gameball widget using menu item