> For the complete documentation index, see [llms.txt](https://help.impact.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.impact.com/brand/what-would-you-like-to-learn-about/beta-product-boost/product-boost-campaign-management/bulk-upload-product-boost-campaigns.md).

# Bulk Upload Product Boost Campaigns

You can use the bulk uploads tool to create or modify multiple Product Boost campaigns at once rather than individually. You'll use a CSV or Excel file to provide details for the fields you would otherwise fill in manually.

{% stepper %}
{% step %}

## Prepare your file

{% tabs %}
{% tab title="Create campaigns in bulk" %}

1. Copy this template file to your device:

{% code overflow="wrap" %}

```
Campaign Name,Method,Campaign ID,Vendor ID,Internal Campaign ID,Funding,Eligibility Type,Partner IDs,Partner Group IDs,Budget,Enforced Budget,Draft,Start Date,End Date,Event Type ID,Payout Type,Payout Value,Precedence,Rules
Winter Boot Promo,Add,,,EXAMPLE-001,,JOINED_PARTNERS,,,1000.00,no,yes,2026-08-01T00:00:00-07:00,2026-08-31T23:59:59-07:00,17897,FIXED,5.00,10,[ITEM_SKU IS BOOT123]
```

{% endcode %}

2. Replace the sample row with your own campaign details and fill in one row for each campaign you want to create.
   * Ensure the *Campaign ID* field is blank, as the system auto-assigns one to each new campaign.
   * To add multiple payout group rules to a single campaign, see [Bulk Upload Multiple Product Boost Payout Rules](/brand/what-would-you-like-to-learn-about/beta-product-boost/product-boost-campaign-management/bulk-upload-multiple-product-boost-payout-rules.md).
3. Check your fields against the [File format reference](#file-format-reference) below to ensure you enter correct data and in their required formats.
4. Save the edits to your file with an appropriate name, e.g., `Product_Boost_Bulk_Create`. Make sure the file saves in `.csv` or `.xlsx` format.
   {% endtab %}

{% tab title="Edit campaigns in bulk" %}

1. Copy this template file to your device:

{% code overflow="wrap" %}

```
Campaign Name,Method,Campaign ID,Vendor ID,Internal Campaign ID,Funding,Eligibility Type,Partner IDs,Partner Group IDs,Budget,Enforced Budget,Draft,Start Date,End Date,Event Type ID,Payout Type,Payout Value,Precedence,Rules
Summer Sandal Promo,Modify,1234,,EXAMPLE-002,,PARTNER_GROUPS,,,1234.00,yes,yes,2026-08-01T00:00:00-07:00,2026-08-31T23:59:59-07:00,17897,FIXED,5.00,10,[ITEM_SKU IS BOOT123]
```

{% endcode %}

2. Replace the sample row with the campaign's new details and fill in one row for each campaign you want to edit.
   * Ensure the *Method* field indicates you're trying to *Modify* a campaign.
   * Ensure the *Campaign ID* field indicates which campaign you're trying to edit.
   * A campaign's payout groups can only be replaced as a complete set. To add multiple payout group rules to a single campaign, see [Bulk Upload Multiple Product Boost Payout Rules](/brand/what-would-you-like-to-learn-about/beta-product-boost/product-boost-campaign-management/bulk-upload-multiple-product-boost-payout-rules.md).
3. Check your fields against the [Modifiable fields reference](#modifiable-fields-reference) below to ensure you only edit supported fields and in their required formats.
4. Save the edits to your file with an appropriate name, e.g., `Product_Boost_Bulk_Edit`. Make sure the file saves in `.csv` or `.xlsx` format.
   {% endtab %}
   {% endtabs %}

It's also possible to create new campaigns and modify existing ones in a single file upload. The value you enter in each row's *Method* field will indicate whether you're trying to create a campaign or editing an existing one.

{% hint style="success" %}
**Note:** Your upload file is limited to 1,000 rows.
{% endhint %}
{% endstep %}

{% step %}

## Upload your campaigns

1. From the left navigation bar, 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]** → **Campaign Manager** → [**Product Boost**](https://app.impact.com/secure/advertiser/engage/campaigns/manage-rate-boost-campaigns-flow.ihtml#sortBy=dateOfEntry\&sortOrder=ASC).
2. In the upper-right corner of the screen, select **Bulk Upload**.
3. Select **Choose File** or drag and drop the file you prepared for upload.
4. Select **Next**.
   {% endstep %}

{% step %}

## Review any validation errors

1. Review your uploaded data for errors.
   * Validation failures will be highlighted in red, with errors listed in the first column for you to address.
   * Each row represents a single campaign. To filter out rows that validated successfully, select ![](https://4048883401-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-b5e1740618ed6571d97b8fed7c25a7678f85d375%2F299632fb6f4f91fbf9847471754cc6180e4284a65b4960af4c4ea472a159f552.svg?alt=media) **\[Checkbox] Show errors only**.
2. If there are errors in your file, select **Back** to return to the upload step. Refer to the [validation error reference](#validation-error-reference) below for guidance on addressing each error.
   * When all rows are clear and show *OK* in the first column, your campaigns are ready to be approved.

<div data-with-frame="true"><figure><img src="https://4048883401-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2F4oJ2tv4RiFlATHGkCSPL%2FScreenshot_2026-07-23_at_10_04_30%E2%80%AFAM.png?alt=media&amp;token=d21d2c4e-1dfe-423c-943d-4aad68135dd6" alt=""><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}

## Approve your upload

1. Select **Accept**.
   * The new campaigns you uploaded will appear in your campaigns list.
2. Next, learn what each Product Boost campaign status means and how to [manage them](/brand/what-would-you-like-to-learn-about/beta-product-boost/product-boost-campaign-management/manage-product-boost-campaigns.md).
   {% endstep %}
   {% endstepper %}

## References

Use these references as a guide when updating the placeholder row in your file with your own campaign details.

<details>

<summary>File format reference</summary>

<table data-header-hidden="false" data-header-sticky><thead><tr><th>Column Name</th><th>Required</th><th>Type</th><th>Description</th></tr></thead><tbody><tr><td>Campaign Name</td><td>Yes</td><td>String</td><td>The name of the campaign.</td></tr><tr><td>Method</td><td>No</td><td>String</td><td>Whether you want to <code>Add</code> a new campaign or <code>Modify</code> an existing one. Leaving the field blank will default to <code>Add</code>.</td></tr><tr><td>Campaign ID</td><td>No</td><td>Integer</td><td>The system-assigned identifier for the campaign. Leave this field blank when creating campaigns.</td></tr><tr><td>Vendor ID</td><td>No</td><td>Integer</td><td>The ID of the vendor, if applicable. This can be obtained from your <a href="/brand/what-would-you-like-to-learn-about/beta-product-boost/beta-product-boost-for-retailers/get-started-with-retail-media-as-a-retailer.md#step-2-view-your-listed-vendors"><em>My Vendors</em></a> page.</td></tr><tr><td>Internal Campaign ID</td><td>No</td><td>String</td><td>Your own optional identifier for this campaign.</td></tr><tr><td>Funding</td><td>No</td><td>String</td><td>The funding details for the campaign.</td></tr><tr><td>Eligibility Type</td><td>Yes</td><td>String</td><td>Identify the eligible partners who will be automatically hired. For groups or specific partners, add the IDs and comma separate them. Allowed values: <code>JOINED_PARTNERS</code>, <code>PARTNER_GROUPS</code>, <code>INDIVIDUAL_PARTNERS</code></td></tr><tr><td>Partner IDs</td><td>No</td><td>CSV string</td><td>Comma-separated partner IDs. Required when Eligibility Type is <code>INDIVIDUAL_PARTNERS</code>.</td></tr><tr><td>Partner Group IDs</td><td>No</td><td>CSV string</td><td>Comma-separated partner group IDs. Required when Eligibility Type is <code>PARTNER_GROUPS</code>.</td></tr><tr><td>Budget</td><td>Yes</td><td>Decimal(8,2)</td><td>Total budget for the campaign.</td></tr><tr><td>Enforced Budget</td><td>No</td><td>Boolean</td><td>Accepted values: <code>yes</code>, <code>true</code> (end the campaign automatically when the budget is fully spent) or <code>no</code>, <code>false</code> (do not enforce). Leave blank if not interested in enforcing.</td></tr><tr><td>Draft</td><td>Yes</td><td>Boolean</td><td>Whether to save the campaign as a draft. Accepted values: <code>yes</code>, <code>true</code> (save as draft) or <code>no</code>, <code>false</code> (active immediately).</td></tr><tr><td>Start Date</td><td>Yes</td><td>Date</td><td>The date the campaign will start in ISO8601 format. Example: <code>2013-06-30T00:00:00-07:00</code></td></tr><tr><td>End Date</td><td>Yes</td><td>Date</td><td>The date the campaign will end in ISO8601 format. Example: <code>2013-06-30T00:00:00-07:00</code></td></tr><tr><td>Event Type ID</td><td>Yes</td><td>Integer</td><td>The numeric event type ID for the primary payout tracker of this campaign.</td></tr><tr><td>Payout Type</td><td>Yes</td><td>String</td><td>The payout type for this event (i.e <code>PERCENTAGE</code> or <code>FIXED</code>).</td></tr><tr><td>Payout Value</td><td>Yes</td><td>Decimal(8,2)</td><td>The payout amount for this event type. Must be greater than zero.</td></tr><tr><td>Precedence</td><td>Yes</td><td>Integer</td><td>Campaign priority from 1 (highest) to 10 (lowest).</td></tr><tr><td>Rules</td><td>Yes</td><td>String</td><td><ul><li><strong>One</strong> eligibility condition in the format <code>[VARIABLE OPERATOR VALUE]</code> e.g., <code>[ITEM_SKU IS HYD-2000]</code>. Learn how to <a href="/brand/what-would-you-like-to-learn-about/platform-features/contracts-and-template-terms/template-terms/payout-adjustments/how-payout-rules-work.md">set payout rules</a>.</li><li>To add multiple payout rules to a single campaign, follow the process in <a href="/brand/what-would-you-like-to-learn-about/beta-product-boost/product-boost-campaign-management/bulk-upload-multiple-product-boost-payout-rules.md">Bulk Upload Multiple Product Boost Payout Rules</a>.</li></ul></td></tr></tbody></table>

</details>

<details>

<summary>Modifiable fields reference</summary>

For campaign modifications, note the following:

* Only fill in the fields you want to change; a blank field keeps its current value.
* When modifying a campaign's rules, all existing rules and event types are replaced by the upload file.
* A campaign's status restricts which modifications will apply. Completed campaigns cannot be modified, and active campaigns cannot be reverted to draft status.

<table data-header-hidden="false" data-header-sticky><thead><tr><th>Column Name</th><th>Modifiable?</th><th>Instruction</th></tr></thead><tbody><tr><td>Campaign Name</td><td>Yes</td><td>Enter the new name of the campaign.</td></tr><tr><td>Method</td><td>No, but required</td><td>Enter <code>Modify</code> to indicate you want to edit an existing campaign.</td></tr><tr><td>Campaign ID</td><td>No, but required</td><td>Use this field to signal which pre-existing campaign you want to modify.</td></tr><tr><td>Vendor ID</td><td>Only before campaign goes live</td><td>If eligible, enter the new ID of the vendor from your <a href="/brand/what-would-you-like-to-learn-about/beta-product-boost/beta-product-boost-for-retailers/get-started-with-retail-media-as-a-retailer.md#step-2-view-your-listed-vendors"><em>My Vendors</em></a> page. The vendor can't be changed once the campaign is live, and can't be changed at all on a formally vendor-funded campaign.</td></tr><tr><td>Internal Campaign ID</td><td>Yes</td><td>Enter your own new identifier for this campaign.</td></tr><tr><td>Funding</td><td>Yes</td><td>Enter the new funding details for the campaign.</td></tr><tr><td>Eligibility Type</td><td>Yes</td><td>Indicate the new eligible partners who will be automatically hired. Allowed values: <code>JOINED_PARTNERS</code>, <code>PARTNER_GROUPS</code>, <code>INDIVIDUAL_PARTNERS</code></td></tr><tr><td>Partner IDs</td><td>Only with Eligibility Type</td><td>Indicate the IDs of any new eligible partners. Required when Eligibility Type = <code>INDIVIDUAL_PARTNERS</code>.</td></tr><tr><td>Partner Group IDs</td><td>Only with Eligibility Type</td><td>Indicate the IDs of any new eligible Partner Groups. Required when Eligibility Type = <code>PARTNER_GROUPS</code>.</td></tr><tr><td>Budget</td><td>Yes</td><td>Enter the new total budget for the campaign.</td></tr><tr><td>Enforced Budget</td><td>Yes</td><td>Enter <code>yes</code> / <code>true</code> (to end the campaign automatically when the budget is fully spent) or <code>no</code> / <code>false</code> (do not enforce). Leave blank if not interested in enforcing.</td></tr><tr><td>Draft</td><td>No</td><td>Leave blank.</td></tr><tr><td>Start Date</td><td>Only if not started</td><td>Enter the new start date in ISO8601 format. Example: <code>2013-06-30T00:00:00-07:00</code></td></tr><tr><td>End Date</td><td>Only if not ended</td><td>Enter the new end date in ISO8601 format. Example: <code>2013-06-30T00:00:00-07:00</code></td></tr><tr><td>Event Type ID</td><td>Only with continuation rows</td><td>See <a href="/brand/what-would-you-like-to-learn-about/beta-product-boost/product-boost-campaign-management/bulk-upload-multiple-product-boost-payout-rules.md">Bulk Upload Multiple Product Boost Payout Rules</a>.</td></tr><tr><td>Payout Type</td><td>Only with continuation rows</td><td>See <a href="/brand/what-would-you-like-to-learn-about/beta-product-boost/product-boost-campaign-management/bulk-upload-multiple-product-boost-payout-rules.md">Bulk Upload Multiple Product Boost Payout Rules</a>.</td></tr><tr><td>Payout Value</td><td>Only with continuation rows</td><td>See <a href="/brand/what-would-you-like-to-learn-about/beta-product-boost/product-boost-campaign-management/bulk-upload-multiple-product-boost-payout-rules.md">Bulk Upload Multiple Product Boost Payout Rules</a>.</td></tr><tr><td>Precedence</td><td>Only with continuation rows</td><td>See <a href="/brand/what-would-you-like-to-learn-about/beta-product-boost/product-boost-campaign-management/bulk-upload-multiple-product-boost-payout-rules.md">Bulk Upload Multiple Product Boost Payout Rules</a>.</td></tr><tr><td>Rules</td><td>Yes</td><td><ul><li>Enter <strong>one</strong> eligibility condition in the format <code>[VARIABLE OPERATOR VALUE]</code> e.g., <code>[ITEM_SKU IS HYD-2000]</code>, or learn how to <a href="/brand/what-would-you-like-to-learn-about/platform-features/contracts-and-template-terms/template-terms/payout-adjustments/how-payout-rules-work.md">set payout rules</a>.</li><li>To add multiple payout rules to a single campaign, follow the process in <a href="/brand/what-would-you-like-to-learn-about/beta-product-boost/product-boost-campaign-management/bulk-upload-multiple-product-boost-payout-rules.md">Bulk Upload Multiple Product Boost Payout Rules</a>.</li><li>Modifying this field will erase and replace any existing rules and event types for the campaign.</li></ul><div data-gb-custom-block data-tag="hint" data-style="danger" class="hint hint-danger"><p><strong>Risk:</strong> Any existing rules or event types you don't include in the modification file may get dropped. If the campaign has more than one event type, add each one you want to keep as a <a href="/brand/what-would-you-like-to-learn-about/beta-product-boost/product-boost-campaign-management/bulk-upload-multiple-product-boost-payout-rules.md">continuation row</a>.</p></div></td></tr></tbody></table>

For field formats and allowed values, use the [File format reference](#file-format-reference) above.

</details>

<details>

<summary>Validation error reference</summary>

If your uploaded data contains validation errors, find the error message below to see what's likely causing it and how to fix it.

| Error message                                                                                                               | How to fix                                                                                                                                                                                                                                                                                                                                                                                        |
| --------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Limited Time Start Date is invalid                                                                                          | Check that your `Start Date` has a value, falls before `End Date`, and is in ISO8601 format (e.g. `2026-08-01T00:00:00-07:00`).                                                                                                                                                                                                                                                                   |
| Limited Time End Date is invalid                                                                                            | Check that your `End Date` has a value, falls after the `Start Date`, and is in ISO8601 format (e.g., `2026-08-30T00:00:00-07:00`).                                                                                                                                                                                                                                                               |
| Draft is required                                                                                                           | Enter `yes`/`true` or `no`/`false` in the `Draft` column to indicate whether the campaign should save as a draft or go active immediately.                                                                                                                                                                                                                                                        |
| Eligibility Type is required                                                                                                | Enter one of the three accepted values in the `Eligibility Type` column: `JOINED_PARTNERS`, `PARTNER_GROUPS`, or `INDIVIDUAL_PARTNERS`.                                                                                                                                                                                                                                                           |
| Precedence is required                                                                                                      | Enter a whole number from 1 (highest priority) to 10 (lowest priority) in the `Precedence` column.                                                                                                                                                                                                                                                                                                |
| Start Date cannot be in the past                                                                                            | Update `Start Date` to a date in the future, formatted in ISO8601 (e.g., `2026-08-01T00:00:00-07:00`).                                                                                                                                                                                                                                                                                            |
| Event Type ID does not belong to this program                                                                               | The `Event Type ID` you entered doesn't match any event types actually linked to your program. Learn how to [find your event type ID](/brand/what-would-you-like-to-learn-about/platform-features/event-types/how-do-i-find-my-event-type-ids.md).                                                                                                                                                |
| Rules column contains an invalid rule expression. Use the format \[Variable Operator Value], chain multiple rules with AND. | <ul><li>Use one condition per row, in the format <code>\[VARIABLE OPERATOR VALUE]</code> e.g., <code>\[ITEM\_SKU IS HYD-2000]</code>.</li><li>See <a href="/brand/what-would-you-like-to-learn-about/beta-product-boost/product-boost-campaign-management/bulk-upload-multiple-product-boost-payout-rules.md">Bulk Upload Multiple Product Boost Payout Rules</a> for more information.</li></ul> |
| Campaign ID is required when Method is Modify                                                                               | Add the `Campaign ID` of the campaign you want to edit to every `Modify` row.                                                                                                                                                                                                                                                                                                                     |
| Campaign ID does not exist in this program                                                                                  | Check that the `Campaign ID` matches an existing Product Boost campaign in your program.                                                                                                                                                                                                                                                                                                          |
| Duplicate campaign ID in this file                                                                                          | Each campaign can appear only once per file. Combine that campaign's changes into a single `Modify` row.                                                                                                                                                                                                                                                                                          |
| \[Field] cannot be edited while the campaign is in Completed status.                                                        | Remove the `Modify` row for the completed campaign, or create a new campaign with `Method` = `Add`.                                                                                                                                                                                                                                                                                               |
| One or more Partner Group IDs do not belong to this program.                                                                | Check that each ID in `Partner Group IDs` matches a [Partner Group](/brand/what-would-you-like-to-learn-about/platform-features/reach-out-to-partners/partner-groups/create-and-manage-partner-groups.md) in your program.                                                                                                                                                                        |
| Partner Groups IDs are required when Eligibility Type is `PARTNER_GROUPS`                                                   | Add one or more Partner Group IDs to the `Partner Group IDs` column, comma-separated, or change `Eligibility Type` to `JOINED_PARTNERS` or `INDIVIDUAL_PARTNERS`.                                                                                                                                                                                                                                 |
| Partner Groups IDs must be a comma-separated list of whole numbers.                                                         | Enter only whole numbers in `Partner Group IDs`, separated by commas — for example, `1024,1099,2001`. Remove any spaces, letters, decimals, or other characters.                                                                                                                                                                                                                                  |
| Start Date cannot be edited after the campaign has started.                                                                 | The `Start Date` of an active campaign is locked. Leave `Start Date` blank on the `Modify` row to keep the current value, or edit only campaigns that haven't started yet.                                                                                                                                                                                                                        |
| \[Field] can only be changed while the campaign is in Draft status.                                                         | Once a campaign is active, this field is locked. Leave blank to keep the current value, or create a new campaign with `Method` = `Add`.                                                                                                                                                                                                                                                           |
| Vendor ID does not exist or is not connected to this program.                                                               | Check that the `Vendor ID` matches a vendor listed on your *My Vendors* page. If the vendor isn't listed, you'll need to [connect with them](/brand/what-would-you-like-to-learn-about/beta-product-boost/beta-product-boost-for-retailers/get-started-with-retail-media-as-a-retailer.md#step-3-connect-with-vendors) before you can fund a campaign through them.                               |
| Click event types are not supported for product boost Campaigns.                                                            | Enter an `Event Type ID` for a non-click event type (for example, a sale). Learn how to [find your event type ID](/brand/what-would-you-like-to-learn-about/platform-features/event-types/how-do-i-find-my-event-type-ids.md).                                                                                                                                                                    |

</details>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://help.impact.com/brand/what-would-you-like-to-learn-about/beta-product-boost/product-boost-campaign-management/bulk-upload-product-boost-campaigns.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.