Skip to main content

Reward Campaign - Campaign URL

Using Campaign URLs to Share Your Game Campaigns

Shaimaa Salama avatar
Written by Shaimaa Salama
Updated over 2 weeks ago

Platform

Plan

Shopify

Not Available

Salla

Not Available

Non-Platform

All Plans

The Campaign URL is available for game campaigns only.

Intro

Gameball makes it easier than ever to engage your customers — no technical integration needed. Instantly generate and share a Campaign URL for your games across social media, email, SMS, or offline channels. Perfect for businesses without apps or websites: just share the link and start engaging!

How to Access the Campaign URL

  1. From the Campaign Details Page:
    After creating a campaign, you can find the Campaign URL next to the internal campaign name at the top.

  2. From the Campaign Listing Page:
    Click the three dots (︙) next to the campaign, and select Campaign URL from the dropdown menu.

Campaign URL Options

The URL may either open directly for customers to play the game or prompt a lead form to identify the customer first, depending on the selected audience.

Case

Details

1. Audience:

  • Registered

  • Specific Customers

  • The URL will contain a customer ID placeholder {customerid}

  • Replace {customerid} With the actual customer value or your dynamic variable.

  • The customer is automatically identified and enters the game directly.

  • Example: https://play.gameball.app?k=xxx&p={customerid}&d=details_spin_123

Notes:

  • If the URL is missing the ID, the game will not load.

  • If the customer ID passed in the URL doesn't exist in Gameball, we will create a new customer account.

  • Customers are created as members.

2. Audience:

  • Anonymous

  • No ID was passed in the URL.

  • The customer will see a form requesting their Email or Mobile Number before playing.

  • You can customize the lead form from the customization page.

  • Example: https://play.gameball.app?k=xxx&d=details_spin_123

Notes:

  • You can set whether the customer identifier field on the form is Email (default) or Mobile.

  • If the customer fills out the form and does not already exist in Gameball, a new customer account will be created.

  • Customers are created as guests.

Lead Form Configuration (When Audience is Anonymous)

When a customer accesses the Campaign URL, a form will appear to collect their information.

You can access it from Customize Design >> Lead Form

Field

Notes

Name

  • Optional

  • A field to collect the customer's name.

Email

  • Default identifier.

  • A field to collect the customer's email.

  • Required unless Mobile is selected as the identifier.

Mobile

  • Can be enabled and set as the primary identifier instead of Email.

  • Mobile numbers are stored in E.164 international format +[Country Code][Number] (e.g., +1XXXXXXXXXX).

  • The customer’s mobile number is stored in E.164 format by default.

    • E.164 format is an international standard for phone numbers.

    • It looks like this: +[country code][area code][number]

    • Example: Egypt: +201xxxxxxxxx

Terms and Conditions

  • Optional

  • A checkbox to confirm customer agreement.

[Shopify] The lead form will appear if the customer selects "Anonymous" as the campaign audience from the Gameball dashboard.

What happens if a registered customer fills out the lead form?

If an already registered customer filled out the lead form, Gameball will add the missing data to their profile and ignore the already collected data.
For example, a registered customer fills out the lead form, providing their name, email address, and phone number.

Gameball checks and finds out that this is, in fact, a registered customer and that it already has their name and email filled, but it has no phone number. Gameball will only add the phone number to their stored profile data and will not overwrite the name and email, as this information has already been previously collected.

📝 Important Notes:

Replace Customer ID

When using a URL with a customer ID, make sure to replace customerid with the actual customer value or your dynamic variable.

Change Lang

  • You can change the game language to any of the configured languages by passing the lang attribute in the URL (e.g., ?lang=ar for Arabic).

  • If the lang parameter is not passed, the game will open using the widget’s default language.

  • You can update or manage your available languages from Widget Settings → General → Languages.

Related Articles:

Did this answer your question?