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
From the left navigation menu, select
[Engage] → Content → Products → Product Promotions.In the upper-right corner, select Upload Promotion File.
Enter your Promotion File Name.
Select the
[Radio button] Direct Upload method.Select the file Format.
impact.com only supports Google Merchant Center (TXT format) i.e.
.txtand Google Merchant Center (CSV format) i.e..csvfiles.Refer to the Product promotion feed field reference below for more information on these fields.
Select Choose File.
Locate the file you want to upload from your computer.
Select your preferred Language and Save.
This option supports pulling a file from an FTP/SFTP server or HTTP/HTTPS URL to ensure up-to-date promotion data.
From the left navigation menu, select
[Engage] → Content → Products → Product Promotions.In the upper-right corner, select Upload Promotion File.
Enter your Promotion File Name.
Select the
[Radio button] Pull From URL upload method.Select the file Format.
impact.com only supports Google Merchant Center (TXT format) i.e.
.txtand Google Merchant Center (CSV format) i.e..csvfiles.Refer to the Product promotion feed field reference below for more information on these fields.
Enter the name of your file under Upload File Name.
View this template for guidance when uploading your promotions.
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.comorhttps://acme.com/anvil_promotions/anvil.txt
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)
Select the Fetch Time that impact.com will fetch the file.
Options displayed are in GMT -05:00 Eastern Time.
Select your Time Zone.
Select your preferred Language and Save.
Product promotion feed field reference
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.
Last updated
Was this helpful?