---
title: "GAN Promotions"
slug: "gan-promotions"
updated: 2026-06-09T10:05:06Z
published: 2026-06-09T10:05:06Z
canonical: "docs.xtremepush.com/gan-promotions"
stale: true
---

> ## Documentation Index
> Fetch the complete documentation index at: https://docs.xtremepush.com/llms.txt
> Use this file to discover all available pages before exploring further.

# GAN Promotions

Add GAN promotions to your Xtremepush campaigns to send promotions to your users and track them

Syncing your GAN promotions with Xtremepush allows you to send promotion campaigns and return details of who was sent a promotion back to GAN.

It is possible to assign different promotions to different variants via [split test](/documentation/docs/campaign-split-test) campaigns so that the effectiveness of different promotions can be assessed.

Customers can also use the [multi-stage journey builder](/documentation/docs/multi-stage-journey-campaigns) to create campaigns that assign different promotions at different stages of a campaign based on customer behaviour.

## Create a connection to GAN

Select the GAN Promotions card in the **Integrations Marketplace** tab found at **Settings > Integrations > Marketplace** and click **Connect**.

### Basic settings

Give your connection a *Name* that helps you easily identify it.

### Connection settings

Input your GAN credentials and click **Connect**.

> [!WARNING]
> More than one connection to GAN Bonus Engine
> 
> It is possible to have additional GAN Bonus Engine connections by repeating the integration steps outlined in the section above.
> 
> However, you should only have one active connection at any given time to avoid any potential clashes with sync processes.

## Synchronise promotions

### Sync from GAN to Xtremepush

#### Automated sync

An automated sync from GAN to Xtremepush runs as soon as the connection has been set up.

An hourly, automated sync runs going forward. Details can be found on the **Overview** page.

#### Manual sync

If you update your promotions within GAN and need to use them in a campaign before the next scheduled automated sync, it's possible to n run a manual sync.

In the **Overview** tab for your integration found at **Settings > Integrations > Marketplace > Configured Integrations**, click the **Actions** button. Select **Sync** action and click **Start sync**.

#### Check task status

When the sync process has started, you will be taken to the *Task group* page in the **Task history**, where you can see the status of the promotion synchronisation.

To check the sync task history go to **Settings > Integrations > Marketplace > Configured Integrations** and select your integration. On the **Overview** tab you will find a list of the *Sync history* showing the status of each sync task.

### Sync from Xtremepush to GAN

The Xtremepush platform will return the GAN `promotionID` and `user_id` back to GAN in real-time (once the campaign has been sent).

#### Download details from a completed sync

The *Task details* page provides information for the selected sync such as processed promotions, created promotions, updated promotions, deleted promotions and sync status.

Select the integration at **Settings > Integrations > Marketplace > Configured Integrations > Overview**. Find the sync task in the *Sync history* table and click the **Details** button to open the *Task details* page.

Click the **Download** button to download a CSV file of the data from that sync task.

## Update or delete an existing connection

Select the integration you want to update at **Settings > Integrations > Marketplace > Configured Integrations**. Go to the **Settings** tab and update any necessary settings, click **Save** to confirm. If you need to delete or deactivate the connection, click on the **Actions** button. You will be presented with the option to either **Deactivate** or **Delete** the integration. Clicking either of them opens a confirmation dialog.

## Assign promotions to a campaign

To add a promotion to a campaign, click on **Add promotion** in the [**Setup tab**](/documentation/docs/campaign-setup) from the campaign builder.

Search the list of available promotions (these need to be created beforehand in GAN) and select the desired one.

![](https://cdn.document360.io/b056e88b-f6c1-4bd2-b5b8-08e9336a17c9/Images/Documentation/f5fbabe-Screenshot_2023-07-06_at_15.06.11(1).png)

When the campaign is sent, GAN is sent a list of all user IDs included in the send.

For more information on how to add promotion in single-stage and multi stage campaigns, please read [Bonus Engine Integrations Overview](/documentation/docs/bonus-engine-integrations-overview) to learn more.

### Using promotions for split test variants

To test the effectiveness of different promotions it's also possible to combine GAN promotions with split test variants. To do so click on **Variants** from the **Setup tab** of your campaign and assign the GAN promotion for each variant.

![](https://cdn.document360.io/b056e88b-f6c1-4bd2-b5b8-08e9336a17c9/Images/Documentation/4677c10-Screenshot_2023-07-06_at_15.08.42(1).png)