Add, Manage, & Troubleshoot Promotion Files

Published on: Thu, 11 Jan, 2024 at 2:31 AM | Updated on: Mon, 15 Jan, 2024 at 4:40 AM

The Product Promotions feature allows you to share your special offers and promotions with partners. These promotions will be accessible to partners on their product feeds, product APIs, and impact.com’s product marketplace, where partners will see a Special offer tag displayed on the products. Partners will also be able to filter for products on promotion.

f01cdffa431a4d75ff09c130b66974d4-ccf5322f8d51fffa737129098fd80607__1_.png

Upload a promotion file

Important

You'll need to have an active product catalog before you can begin. For help creating your first product upload, see this doc.

From the left navigation panel, select [Engage] → Content → Products [Drop-down menu] → Product Promotions.
In the upper-right of the page, select Upload Promotion File.
Enter your Promotion File Name.
Select your Upload Method.
Direct Upload
Pull From URL
1. Select the file Format.
  impact.com only supports Google Merchant Center (TXT format) i.e. .txt and Google Merchant Center (CSV format) i.e. .csv files.
  Refer to the Product promotion feed field reference below for more information on these fields.
2. Select Choose File.
  Locate the file you want to upload from your computer.
This option supports pulling a file from an FTP/SFTP server or HTTP/HTTPS URL.
1. Select the file Format.
  impact.com only supports Google Merchant Center (TXT format) i.e. .txt and Google Merchant Center (CSV format) i.e. .csv files.
  Refer to the Product promotion feed field reference below for more information on these fields.
2. Enter the name of your file under Upload File Name.
  View this template for guidance when uploading your promotions.
3. Enter the Pull URL that points to the directory where your promotion data file exists.
  This URL can be an FTP or HTTPS URL. E.g., ftp://ftp.acme.com or https://acme.com/anvil_promotions/anvil.txt
4. Select the Fetch Frequency for how often impact.com will fetch the file:
  Daily
  Every 8 hour(s)
  Every 4 hour(s)
  Every 2 hour(s)
5. Select the Fetch Time that impact.com will fetch the file.
  Options displayed are in GMT -05:00 Eastern Time.
6. Select your Time Zone.
Select your preferred Language and Save.

Product promotion feed field reference

Expected fields	Required?	Description	Format
ID `[promotion_id]`	Yes	The unique ID of each promotion.	This ID is in number format and should not contain spaces or symbols, e.g., `103330482`.
Applicability `[product_applicability]`	Yes	This attribute specifies if the promotion applies to all products or only to specific products.	Supported values: `all_products` `specific_products` Important impact.com can only map the promotions in your Google promotions feed file [External link] with specific products in your product feed file (i.e., your product catalog) if your product feed includes `promotion_id`. In other words, you cannot have the `specific_products` value if your product feed does not include promotion IDs.
Description `[long_title]`	Yes	The full title of each promotion.	The maximum length of the title is 60 characters, e.g., `Free mug with purchase`.
Effective `[promotion_effective_dates]`	Yes	The period for the promotion.	The start and end dates are separated by a forward slash (/). The date format is (YYYY-MM-DD), followed by the letter ‘T’, the time of day when the sale starts or ends, and an expression of the time zone for the sale. Example: `2009-07-19T03:00:00+00:00/2009-07-26T21:00:00+00:00`
Display `[promotion_display_dates]`	No	This attribute specifies the date and the time frame when the promotion will be live.	The start and end dates are separated by a forward slash (/), e.g., `2009-07-19T03:00:00+00:00/2009-07-26T21:00:00+00:00`.
Channel `[redemption_channel]`	Yes	This attribute indicates that the promotion is valid online or in-store.	Supported values: `online` `in_store`
Offer Code Type `[offer_type]`	Yes	This attribute indicates whether or not a coupon code is required for customers to redeem the offer.	Supported values: `no_code` `generic_code` Important If the value for this attribute is `generic_code`, `generic_redemption_code` is required.
Offer Code `[generic_redemption_code]`	No	This attribute specifies the code that can be used online to redeem the promotion.	The maximum length is 20 characters, e.g., `EXTRA20`.
Destination `[promotion_destination]`	No	This attribute specifies the format of each promotion.	Supported values: `Shopping_ads` `Buy_on_Google_listings` `Free_listings` Important To submit your promotion to one or more destinations, submit each destination value as a separate column.

View or delete promotion files

Once you've uploaded your list of promotions, they will display as follows:

To view uploaded product promotions, select [More] → View Promotions.
To delete your uploaded product promotions, select Delete.

Download and filter promotion files

f01cdffa431a4d75ff09c130b66974d4-1c7d159710af2be8175b6d27855ca75c.png

To download the promotion files, select [Download] and to add or remove column headers, select [Column].
Search for a particular promotion file by typing part of the description in the Description box and selecting Enter on your keyboard.

Promotion file health indicator

If promotion files contain any errors or warnings, you’ll see a total of each in the Health column. The color of the indicator changes according to the health of the uploaded promotion file:

Indicator	Description
Pending	Your file is uploading and being processed.
Excellent	Your file has no errors or warnings.
Good	Certain suggested fields that contain crucial data could be missing, however, your file will still be uploaded.
Poor	Required information is missing in more than 10% of the records you sent in. You will have to fix and re-upload the file.

Troubleshoot error and warning messages

View errors and warnings

On the Product Promotions screen, under the Health column, select errors or warnings to see more information about the error, like the error type or error message.

Search and filter errors

You can use the search field and filters to better sort through the product promotion upload errors.

The Error Type filters include the following:

All
Warning
Error
Duplicate

Error and warning messages

Error Message	Explanation
Required field(s) missing:{Required field}	One or more of the required fields are missing in the upload file.
Records skipped due to an expired effective date	The promotion's effective end date is in the past and that record is skipped.

Upload a promotion file

View or delete promotion files

Download and filter promotion files

Promotion file health indicator

Troubleshoot error and warning messages

Related Articles