Campaigns Configurations

Changed on

The API retrieves your reward campaign configurations, including both event-based and transactional campaigns. If the customerId, productSku, or collectionId query parameters are provided, the response will include the reward campaigns that are applicable for the specified customer or product.

get/api/v4.0/integrations/configurations/reward-campaigns

Request

  • Base URL: https://api.gameball.co
  • URL: https://api.gameball.co/api/v4.0/integrations/configurations/reward-campaigns
  • Auth: API key in header apikey

Query parameters

customerIdstring

Unique identifier for the customer that you can reference across the customer's whole lifetime. Could be a database ID, random string, email, or anything that uniquely identifies the customer. If provided, the API filters and returns only the campaigns that can be achieved by this customer.

collectionIdstring

Unique identifier for a product collection. If provided, the API returns the transactional campaigns applicable to the specified collection.

productSkustring

The SKU (Stock Keeping Unit) of a product. If provided, the API returns the transactional campaigns applicable to the specified product.

Headers

langstring

If the lang header is provided, the response will be returned in the specified language (e.g., en for English, fr for French). If this header is not included, the system will use the default language.

Response

Campaigns retrieved successfully

idnumber

Unique identifier for the reward campaign.

namestring

Name of the reward campaign.

descriptionstring nullable

A brief description of the reward campaign.

isRepeatableboolean

Indicates whether the campaign can be earned multiple times. Example: If set to true, a customer can earn the campaign reward each time they meet the criteria, and if set to false, the campaign can only be earned once per customer.

maxAchievementnumber

Specifies the maximum number of times the campaign can be earned if the value of isRepeatable is true. If the value is -1, it means the campaign can be earned indefinitely. Example: A value of 3 means the customer can earn the campaign reward up to three times before it is no longer available.

typestring

The type of the campaign. Possible values: SignUp (Reward is given when a user signs up), SocialMedia (Reward is linked to social media activity), ScheduledChallenge (A time-based challenge that gives rewards), Spin The Wheel (Rewards are given based on a spin-the-wheel game), EventBased (Reward is given based on specific customer events), HighScore (Reward is given based on achieving high scores in a campaign), Birthday (Reward is given for birthday-related activity), Streak (Reward is given for consecutive actions over a Day, Week, or Month interval).

visibilitystring

The visibility status of the campaign. Possible values: AlwaysVisible (The campaign is always visible on the widget), NotVisible (The campaign is not visible to the customer on the widget), VisibleIfEarned (The campaign becomes visible once the customer earns it on the widget).

streakIntervalUnit'Day' | 'Week' | 'Month' nullable

The unit used to count streak steps. Returned only for streak campaigns. Each step in startStep and endStep is measured in this unit: Day (consecutive days), Week (consecutive weeks), or Month (consecutive months).

iconstring nullable

The URL of the campaign's icon image. This icon visually represents the campaign and can be used in marketing materials or on the platform.

redirectionButtonTextstring nullable

The text displayed on the redirection button within the reward campaign page on the widget. Example: "Claim Your Reward" would prompt customers to take action.

redirectionButtonLinkstring nullable

The URL that the redirection button points to. When customers click the button, they will be redirected to this link. It should lead to a relevant page that provides more information or facilitates the reward campaign achievement. Example: "https://yourwebsite.com/rewards" directs customers to a page where they can view their rewards.

Changes

    • info

      added the optional property /// to the response with the status

    • info

      added the optional property /// to the response with the status

    • info

      added the optional property /// to the response with the status

    • info

      added the optional property / to the response with the status

    • breaking

      the response's body type changed from object to array for status

    • warning

      removed the optional property from the response with the status

    • info

      api operation id getCampaignsConfigurations was added

    • info

      added the new optional header request parameter lang

    • info

      added the new optional query request parameter collectionId

    • info

      added the new optional query request parameter customerId

    • info

      added the new optional query request parameter productSku