Giveaway overview

You can use giveaway pools to store codes or vouchers generated outside of Talon.One with which to reward your customers. 

For example, you can send customers Amazon gift cards when they spend a certain amount or join a new tier in a loyalty program. 

To use giveaways in the effects of your rules:

1. Activate the giveaway feature in your campaign.
2. Create a giveaway pool and connect it to the Application containing your campaign. 
3. Import codes into the pool. 

Listing giveaway pools

To list your giveaway pools, click Giveaways in the left-most menu.

This page displays the available giveaway pools. It contains the following information for each of them:

Column	Description
ID	Unique number identifying the giveaway pool. It can be used for integration purposes.
Pool	Name and description of the pool.
Apps	Number of Applications the pool is connected to.

 

Creating a giveaway pool

1. Click Giveaways in the left-most menu.
2. Click Create Giveaway Pool.
3. In Name, type a name for the pool. 
4. (Optional) In Description, enter some information to help you identify the pool.
5. In Connected Applications, ​​select the Applications where you want the pool to be available.
6. (Optional) In Import Codes, select a CSV file of promotional codes from your computer. This can be done after creating the pool. 

   Note: An example file is available for download. 

7. Click Create Pool.

A notification pops up, indicating that the giveaway pool has been created. 

If you imported codes during the pool creation process, a second notification pops up, indicating that the giveaway codes have been successfully imported. 

Importing giveaway codes

You can import codes into a pool at any time. 

1. Click Giveaways in the left-most menu.
2. Click the name of the pool where you want to import giveaway codes.
3. Click Import Codes at the top-right corner of the page.
4. Click Upload a CSV file.

   Note: An example file is available for download.

5. Click Import Giveaways.

A notification pops up, indicating that the giveaway codes have been successfully imported. To import more data, click Import More Giveaways Codes.

Listing the codes in a pool

To list the codes in a given giveaway pool:

1. Click Giveaways in the left-most menu.
2. Click the name of the required giveaway pool.
3. Click Codes in the left-side menu.

This page displays all the codes in the pool. It contains the following information for each of them:

Column	Description
Code	Name of the giveaway code.
Awarded	Indicates whether the code has already been awarded: Green check box: code awarded. Red check box: code not yet awarded.
Created	Date and time when the code was created.
Award from	Date and time from which the code can be used.
Award until	Date and time when the code expires.
Attributes	Custom attributes created for referrals, along with any values added when importing the code.  Learn more about this in our Developer Docs.

 

Filtering giveaway codes

To filter giveaway codes:

1. Click Giveaways in the left-most menu.
2. Click the name of the pool whose codes you want to filter.
3. Click Codes in the left-side menu.
4. Click Filter at the top of the page to display the filtering options:
   • Use Award date range to select dates and find codes created within a certain time frame.
   • Use Awarded to find codes that have already been awarded to a customer or those that have not. 

   Note: You can use more than one filter at the same time. The filters used appear at the top of the page, and you can edit them by clicking on the box with their name.  You can also remove them individually by clicking the X to the right of their name.

You see the giveaway codes that match the filters you have set. 

Note: Click Clear Filters at the top of the page to see again all the codes in the pool.

Editing a giveaway pool

You can modify some characteristics of a giveaway pool after it has been created. For example, you can make it available in different Applications.

1. Click Giveaways in the left-most menu.
2. Click the name of the pool you want to edit.
3. Edit the required details (name, description, connected Applications).
4. Click Save Changes.

A notification pops up, indicating that the giveaway pool has been successfully updated.

Deleting a giveaway pool

You can delete giveaway pools at any time.

1. Click Giveaways in the left-most menu.
2. Click the name of the pool you want to delete.
3. Click Delete Pool at the top-right of the page.
4. Click Delete Pool in the confirmation pop-up that appears.

A notification pops up, indicating that a giveaway pool has been deleted.

Related pages

• Learn more about loyalty programs.
• Learn more about how to create campaigns.