Upload Product Promotion Files

The Product Promotions feature lets you share special offers and promotions with partners. These offers appear in partner product feeds, product APIs, and impact.com’s product marketplace, where a Special offer tag displayed directly on the product tile in search results.

Important: You'll need to have an active product catalog before you can begin. For help creating your first product upload, see Add Product Catalogs.

Upload a promotion file

Direct Upload

1. From the left navigation menu, select [Engage] → Content → Products → Product Promotions.
2. In the upper-right corner, select Upload Promotion File.
3. Enter your Promotion File Name.
4. Select the [Radio button] Direct Upload method.
5. 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.
6. Select Choose File.

   • Locate the file you want to upload from your computer.
7. Select your preferred Language and Save.

Pull From URL

This option supports pulling a file from an FTP/SFTP server or HTTP/HTTPS URL to ensure up-to-date promotion data.

1. From the left navigation menu, select [Engage] → Content → Products → Product Promotions.
2. In the upper-right corner, select Upload Promotion File.
3. Enter your Promotion File Name.
4. Select the [Radio button] Pull From URL upload method.
5. 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.
6. Enter the name of your file under Upload File Name.

   • View this template for guidance when uploading your promotions.
7. 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
8. 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)
9. Select the Fetch Time that impact.com will fetch the file.

   • Options displayed are in GMT -05:00 Eastern Time.
10. Select your Time Zone.
11. 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 Note: impact.com can only map the promotions in your Google promotions feed file with specific products in 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, then 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 To submit your promotion to one or more destinations, submit each destination value as a separate column.

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. See Manage Your Product Promotion Files for more information on the Health of your promotion file.

Search and filter errors

You can click into the file errors and warnings and use the search field and filters to sort through all the uploaded promotion file's errors.

Error Type filters include:

• 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.