Skip to main content

Managing giveaways

You can import giveaway codes into a giveaway pool, export them as a CSV file, and edit or delete your giveaway pools.

Importing giveaway codes

You can import codes into a giveaway pool at any time:

  1. On the left-most menu, click Giveaways.

  2. Click the name of the pool where you want to import the giveaway codes.

  3. In Details, click Import Codes.

    note

    If there are giveaway codes in your pool, to import more codes, in Codes, click Manage Giveaway Codes > Import Giveaway Codes.

  4. Click Upload a CSV File.

    tip

    A sample file is available for download.

  5. Click Import Giveaways.

Displaying giveaway codes

To display the codes in a giveaway pool:

  1. On the left-most menu, click Giveaways.
  2. Click the name of the giveaway pool whose codes you want to view, then click Codes.

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

ColumnDescription
CodeName of the giveaway code.
AwardedIndicates whether the code was awarded (green check box) or not (red check box).
Customer integration IDID of the customer who was awarded the giveaway code, if the giveaway was awarded.
CreatedDate and time when the code was created.
Valid fromDate and time from which the code can be used.
Valid untilDate 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. On the left-most menu, click Giveaways.

  2. Click the name of the pool whose codes you want to filter.

  3. In Codes, click Filter 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 were already awarded to a customer, or codes that have not been awarded yet.
    • Use Customer integration ID to find codes that were awarded to a specific customer.
    note

    You can use more than one filter at the same time. To see all the codes in the pool again, click Clear Filters.

Exporting giveaway codes

You can export the codes of a giveaway pool at any time:

  1. On the left-most menu, click Giveaways.

  2. Click the name of the pool whose giveaway codes you want to export.

  3. In Codes, click Manage Giveaway Codes > Export Giveaway Codes.

  4. Select a time period to filter the giveaway codes by their creation date.

    tip

    Select Max to export all the giveaway codes in your pool.

  5. Click Export Giveaway Codes.

note

The giveaway codes are exported as a CSV file. For details, see the Export giveaway codes of a giveaway pool endpoint.

Editing a giveaway pool

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

  1. On the left-most menu, click Giveaways.
  2. Click the name of the pool you want to edit.
  3. In Details, edit details like the pool name, description, and connected Applications.
  4. Click Save Changes.

Deleting a giveaway pool

You can delete a giveaway pool if it is not referenced by the rules of any campaign.

Feature access
Only admins have access to this feature.
  1. On the left-most menu, click Giveaways.
  2. Click the name of the pool you want to delete.
  3. In Details, click Delete Pool.
  4. To confirm the action, in the pop-up that appears, click Delete Pool.