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 a week 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

When creating or editing your game campaign, you will be able to generate a link that works in two different ways:

Case

Details

1. URL with Customer ID

Pass the customer's ID as a URL parameter.

The customer is automatically identified and enters the game directly.

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

Notes:

  • Make sure to replace customerid with the actual customer value or your dynamic variable.

  • 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. URL without Customer ID

No ID was passed in the URL.

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

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 No Customer ID is Passed)

When a customer accesses the Campaign URL without a customer ID, 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 Gameball dashboard.

📝 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?