The Product Promotions feature allows you to share your product promotions with your partners. These promotions will be available on partner product feeds, product APIs, and impact.com’s product marketplace.
We’ll cover…
- Uploading promotion files
- Viewing promotion files
- Troubleshooting promotion file errors and warnings
Upload a promotion file
- From the left navigation panel, select Content → Products [Drop-down menu] → Product Promotions.
- Near the top-right of the page, select Upload Promotion File.
- Enter your Promotion File Name.
- Select your Upload Method.
- Select the file Format.
- impact.com supports Google Merchant Center (TXT format) .txt and Google Merchant Center (CSV format) .csv files.
Refer to the feed field reference table for more information on these fields.
- impact.com supports Google Merchant Center (TXT format) .txt and Google Merchant Center (CSV format) .csv files.
- Select Choose File.
- Locate the file you want to upload on your computer.
This option supports pulling a file from an FTP/SFTP server or HTTP/HTTPS URL.
- Select the file Format.
- impact.com supports Google Merchant Center (TXT format) .txt and Google Merchant Center (CSV format) .csv files.
Refer to the feed field reference table for more information on these fields.
- impact.com supports Google Merchant Center (TXT format) .txt and Google Merchant Center (CSV format) .csv files.
- Enter the Upload File Name.
- 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
- Select the Fetch Frequency for how often impact.com will fetch the file: Daily, every 8 hours, every 4 hours, or every 2 hours.
- Select the Fetch Time that impact.com will fetch the file (in GMT -05:00 Eastern Time).
- Select your Time Zone.
- Select the file Format.
- Select your preferred language and Save.
Product promotion feed field reference
| Expected fields | Description | Format |
|---|---|---|
ID {promotion_id} *Required | The unique ID of each promotion. | This ID is in number format and should not contain spaces or symbols. Example 103330482 |
Applicability {product_applicability} *Required | This attribute specifies if the promotion applies to all products or only to specific products. | Supported values:
|
Description {long_title} *Required | The full title of each promotion. | The maximum length of the title is 60 characters. Example Free mug with purchase |
Effective {promotion_effective_dates} *Required | The period for the promotion. |
Example 2009-07-19T03:00:00+00:00/2009-07-26T21:00:00+00:00 |
Display {promotion_display_dates} Optional | 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 (/). Example 2009-07-19T03:00:00+00:00/2009-07-26T21:00:00+00:00 |
Channel {redemption_channel} *Required | This attribute indicates that the promotion is valid online or in-store. | Supported values:
|
Offer Code Type {offer_type} *Required | This attribute indicates whether or not a coupon code is required for customers to redeem the offer. | Supported values:
|
Offer Code {generic_redemption_code} Optional | This attribute specifies the code that can be used online to redeem the promotion. | The maximum length is 20 characters. Example EXTRA20 |
{promotion_destination} Optional | This attribute specifies the format of each promotion. | Supported values:
|
Download
Download this template to help guide you when you upload your promotions.View or delete promotion files
Once uploaded, you can view a list of promotions with the File Name, Health, Upload State, No. of Promotions, and Last Updated.
- Select [More] and View Promotions to view uploaded product promotions.
- Select Delete to delete the uploaded product promotions.
Download and filter promotion files
- Select [Download] to download the promotion files and [Column] to add or remove column headers.
- Search for promotion files by typing in full or 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 promotion file is uploading and being processed. |
| Excellent | A “healthy” promotion file with no errors or warnings. |
| Good | Certain suggested fields that contain crucial data could be missing, however, the file can still be uploaded. |
| Poor | Required information is missing in more than 10% of the records you sent in. This promotion file will have to be fixed and re-uploaded. |
Troubleshoot error and warning messages
View errors and warnings
On the Product Promotions screen, select the errors and warnings link from the Health column to find out information like the error type and 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. |