# 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. {% hint style="warning" %} **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](https://help.impact.com/brand/what-would-you-like-to-learn-about/platform-features/product-catalogs/add-product-catalogs-as-a-brand). {% endhint %} #### Upload a promotion file {% tabs %} {% tab title="Direct Upload" %} 1. From the left navigation menu, select ![](https://4048883401-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-230534471fef5f40808e921e41ee44e4a06ded03%2Fe6cb9548999afdc1ed3ce4942e4cb5b45b5cecbd323267aac2a7cd1915fccc09.svg?alt=media) **\[Engage] → Content → Products → Product Promotions**. 2. In the upper-right corner, select **Upload Promotion File**. 3. Enter your **Promotion File Name**. 4. Select the ![](https://4048883401-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-590bdf4e1ffbcc1fe86ad456bebab6a28c64af1f%2Ffd6e4291628446bb1fe27a831f7874b256a28cc84833d72cce2e73b94641edb7.svg?alt=media) **\[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*](#para-idm73509110741608) 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**. {% endtab %} {% tab title="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 ![](https://4048883401-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-230534471fef5f40808e921e41ee44e4a06ded03%2Fe6cb9548999afdc1ed3ce4942e4cb5b45b5cecbd323267aac2a7cd1915fccc09.svg?alt=media) **\[Engage] → Content → Products → Product Promotions**. 2. In the upper-right corner, select **Upload Promotion File**. 3. Enter your **Promotion File Name**. 4. Select the ![](https://4048883401-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-590bdf4e1ffbcc1fe86ad456bebab6a28c64af1f%2Ffd6e4291628446bb1fe27a831f7874b256a28cc84833d72cce2e73b94641edb7.svg?alt=media) **\[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*](#para-idm73509110741608) below for more information on these fields. 6. Enter the **name** of your file under *Upload File Name*. * [View this template](https://docs.google.com/spreadsheets/d/1OUr9Hoc2DRnS3KnyXwAetcgtho76ftej/edit?usp=sharing\&ouid=106843525620835185016\&rtpof=true\&sd=true) 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**. {% endtab %} {% endtabs %}
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](https://help.impact.com/brand/what-would-you-like-to-learn-about/platform-features/product-promotions/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. |