# Add Product Catalogs as a Brand

A product catalog is a data feed that holds a list of your products and their metadata. These are commonly used if you're selling products online, but can also be used in other verticals, such as credit cards, travel, home listings, and more. Many brands will create a product catalog through their e-commerce (or shopping cart) solution, which can be exported and shared with impact.com.

When adding a retail product catalog, there are 4 steps you need to complete, which help showcase your offerings, enhance customer experience, and streamline the buying process. Follow the 4 steps below:

{% embed url="<https://res.cloudinary.com/product-enablement/video/upload/v1748512975/PXA%20Microlearnings/eng-350-6.mp4>" %}

{% stepper %}
{% step %}

#### Step 1 - Check program ad settings

Before adding product catalogs to your program, ensure that they are enabled in your ad settings. Partners will not be able to view your product catalogs unless this setting is enabled.

1. From the top navigation bar, select ![](https://4048883401-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-1183576591b45997efe4dc81a25024640591d02a%2F245137dc972a7a7f6165b59538fcdbac8fd5bd8fee4ba9f20c1a2982c5b58b57.svg?alt=media) **\[User profile] → Settings**.
2. In the right column, under *General*, select [**Ad Settings**](https://app.impact.com/secure/advertiser/campaign/campaign-ad-settings-flow.ihtml).
3. In the *Ad Types* section, under *Product Catalogs*, ensure that ![](https://4048883401-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-d2954616dc486c3e12c9211e20ff376bda0ab1af%2F7586e04e82e7c7203e5c82320dd417f8ac564cae5035024fdf0eb2ed017e6376.svg?alt=media) **\[Checked box]** **Enable product catalogs for this program** is checked.
4. Select **Save**.
   {% endstep %}

{% step %}

#### Step 2 - Add a product catalog

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]** → **Content** → **Products** → [**Product Catalogs**](https://app.impact.com/secure/advertiser/engage/ads/productcatalogs/manage-ads-product-catalog-flow.ihtml).
2. In the upper-right corner, select **Create Product Catalog** → **Retail**.
   * For credit card catalogs, see [Add Credit Card Catalogs](https://help.impact.com/brand/what-would-you-like-to-learn-about/platform-features/product-catalogs/add-credit-card-catalogs-as-a-brand).
3. Enter a unique **Product Catalog Name** (this is how your partners will search for it).
4. Optionally, enter **Labels** that partners can use to search for this product catalog.
5. Optionally, upload a PDF document with *Catalog Instructions* so partners understand how to navigate your product catalog.
6. Select an upload method for your product catalog:
   * **Direct Upload**
   * **impact.com FTP Server**
   * **impact SFTP Server**
   * **Pull From URL**
   * **Integrated Shopping Cart Import**
7. If applicable, select a **Format**. Otherwise, select **Integrated Shopping Cart Import**.

{% tabs %}
{% tab title="Format" %}

1. Select the ![](https://4048883401-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-c2cb550b55c51ea1eeff0acbd6f437a03b621a2c%2F60d033ae8a04c14498d5229c3c0160ac05feea7f605dbd770741793c900469f0.svg?alt=media) **\[Drop-down menu]**, then select a format.
2. Enter the **Upload File Name** for the product catalog with its file extension. The name you enter here must match the name of the file you upload.
   * E.g., `starks_catalog.xml`, `starks_catalog.txt`, `starks_catalog.csv`.
   * If you're using a CSV file, replace spaces in the field names with underscores.

| Format                            | Description                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| --------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Google Merchant Center**        | impact.com currently supports Google Merchant’s [text-based formats](https://support.google.com/merchants/answer/7052112) (tab-delimited TXT files, not CSV files), as well as [XML files](https://support.google.com/merchants/answer/14987622) (RSS and Atom).                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| **eBay Commerce Merchant Center** | impact.com supports both text-based (.TXT and .CSV) and XML formats for eBay Commerce. When using a .CSV file, ensure you replace spaces in the Field column with underscores. You can also view the eBay Commerce merchant file fields [here](https://docs.google.com/spreadsheets/d/1np1YixxczH_IZBxer-EckMkAdcV9_lp74RQAtI-1Ct0/edit?usp=sharing).                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
| **Connexity Merchant Center**     | impact.com currently supports .TXT and .CSV file versions of [Connexity's product catalogs](https://connexity.jitbit.com/helpdesk/KB/View/8469181-required-data-feed-fields-and-template). After generating your product catalog, you can upload it to impact.com.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
| **CJ Affiliate by Conversant**    | impact.com supports various formats for [CJ Affiliate product catalogs](https://developers.cj.com/docs/data-imports/product-feeds), including .TXT, .CSV, .PSV, and .XML files under the *Product Feed Specifications: Shopping (Google Format)* section. After generating your product catalog, you can upload it to impact.com.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
| **Custom format**                 | <p>impact.com also supports custom-formatted catalogs. You can upload files in .XML, .TXT, .CSV, and .PSV formats.</p><p>1. Specify your custom catalog's <strong>Link URL Field, Catalog Item ID Field, and Name Field</strong> in the respective textbox. These fields are mandatory.</p><p>2. Fill in the <strong>Catalog Item ID</strong> and <strong>Name</strong> mandatory fields.</p><ul><li>View the <a href="https://docs.google.com/spreadsheets/d/1Cc1-9IdACq-TWdx47Xnnekh8MF0mJvHa_3zakJqKzoc/edit?usp=sharing">Custom Format file fields</a> for a full list of fields.</li><li>See the example below of formats to follow when entering product details.</li></ul><p>3. Optionally, you can add custom fields to your product catalog. Select <strong>Add Another Field</strong>, then select the <img src="https://4048883401-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-c2cb550b55c51ea1eeff0acbd6f437a03b621a2c%2F60d033ae8a04c14498d5229c3c0160ac05feea7f605dbd770741793c900469f0.svg?alt=media" alt=""> <strong>\[Drop-down menu]</strong> and select an option.</p><ul><li>Review the <a href="https://docs.google.com/spreadsheets/d/1Cc1-9IdACq-TWdx47Xnnekh8MF0mJvHa_3zakJqKzoc/edit?usp=sharing">Custom Format file fields</a> to learn more about the options in the drop-down menu.</li></ul> |

{% hint style="info" %}
**Example**

```programlisting
name,id,url,manufacturingcost,mycurrency,mycategory
ACME Bird Seed,1234567,http://example.com/products,20,USD,Accessories
```

{% endhint %}
{% endtab %}

{% tab title="Integrated Shopping Cart Import" %}

1. Select your **shopping cart** solution:
   * **Shopify**, **Magento**, **BigCommerce**, **WooCommerce**, **Demandware**, **Shoplazza**, or **Amazon**.
2. Enter your e-commerce access details. Select your e-commerce solution below for information on where to find these details:<br>

   **Shopify**

   View our guide on the [Shopify Product Catalog](https://integrations.impact.com/impact-brand/docs/shopify-product-catalog#step-1-gather-your-shopify-store-details) to learn how to find and set up your credentials.

   1. Enter the **Base URL** of your store.
      * E.g., `https://www.acmeacademy.com`.
   2. Enter your **Access Token**.
      * Learn how to get your [Access Token](https://shopify.dev/docs/api/storefront/latest/objects/CustomerAccessToken).
   3. Optionally, enter a **Collection ID**.
   4. Optionally, ![\[Toggle on\]](https://paligoapp-cdn-eu1.s3.eu-west-1.amazonaws.com/impact/attachments/f01cdffa431a4d75ff09c130b66974d4-84d1224fd3bb6ba94b899febe2021eaa.svg) **\[Toggle on]** **Include Product Variants** to filter out variants.

   **Magento**

   1. Enter the **Base URL** of your store.
      * E.g., `https://www.acmeacademy.com`.
   2. For the **Consumer Key**, **Consumer Secret**, **Access Token**, and **Access Token Secret**, access your [authentication keys and tokens](https://devdocs.magento.com/guides/v2.3/get-started/authentication/gs-authentication-token.html) .

   **BigCommerce**

   1. Enter your **Store Hash** .
   2. Enter your **Access Token**. Learn how to [create an access token](https://developer.bigcommerce.com/docs/storefront-auth/tokens#create-a-token) .
      * Before calling the API to create a token, you'll need to [create a store-level API account](https://support.bigcommerce.com/s/article/Store-API-Accounts?language=en_US) in Bigcommerce and [get its admin API access token](https://developer.bigcommerce.com/docs/start/authentication) (`X-Auth-Token`) to authenticate your request. This is an example of the BigCommerce API credentials you'll get:

        ```programlisting
        Client ID: h81bpnt123hrx3crd219ebxyr3dsou1
        Client secret: edbdc3c61dd6030909a5ea6a4c8123456a2824b41536bee6274b27a17fcbe5f8
        Access token: mv05yxg8ji49cdboa5wc8vpx1un1234
        ```
      * Also include required header fields (`channel_id` / `channel_ids`, `allowed_cors_origins`) and body fields (`expires_at`).

   <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%2Fgit-blob-98b7fb391fdfb0e8b54c78f9123824933bd5b2a8%2Ff6671b02a702a4094af273a4aed8e99440c948009d9a1784555363ab471d788c.gif?alt=media" alt=""><figcaption></figcaption></figure></div>

   **WooCommerce**

   1. Enter the **Base URL** of your store.
      * E.g., `https://www.acmeacademy.com`.
   2. Enter your **API Username** and **Password**.

      * **API username** — enter your *Consumer Key* here
      * **API password** — enter your *Consumer Secret* here

      Learn how to [generate your keys](https://woocommerce.com/document/woocommerce-rest-api/#generate-api-keys) . You'll also need to enable [legacy REST API](https://woocommerce.com/document/woocommerce-rest-api/#enable-legacy-rest-api) .

   **Demandware**

   1. Enter your **Base URL** and **Site ID**. They will be the same. Learn how to get your [site ID](https://documentation.b2c.commercecloud.salesforce.com/DOC1/index.jsp?topic=%2Fcom.demandware.dochelp%2FDWAPI%2Fscriptapi%2Fhtml%2Fapi%2Fclass_dw_system_Site.html) .
      * E.g., `https://www.acmeacademy.com`.
   2. Learn how to get the [API username and password credentials](https://developer.salesforce.com/docs/commerce/b2c-commerce/references/b2c-commerce-ocapi/get-started-with-ocapi.html) .

   **Shoplazza**

   1. Enter the **Base URL** of your store.
      * E.g., `https://www.acmeacademy.com`.
   2. Enter your **Access Token**.
      * Learn how to get your [Access Token](https://www.shoplazza.dev/reference/overview-23) .
   3. Optionally, specify a **Collection ID** to only add products from a specific [Shoplazza product collection](https://www.shoplazza.dev/reference/collection-list) .

   **Amazon**

{% hint style="warning" %}
**Warning:** Amazon shopping cart integration is currently exclusive to brands with [Seller subscriptions](https://help.impact.com/brand/what-would-you-like-to-learn-about/seller-program/amazon-seller-program/amazon-seller-program-explained) and is not a self-serve feature.&#x20;
{% endhint %}

If your Seller catalog has more than 1,000 products, use one of the manual [file upload methods](https://help.impact.com/brand/what-would-you-like-to-learn-about/platform-features/product-catalogs/add-product-catalogs-as-a-brand#format) to import them instead. Automatic catalog ingestion is limited to 1,000 products due to Amazon API restrictions.
{% endtab %}
{% endtabs %}

8. From the ![](https://4048883401-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-c2cb550b55c51ea1eeff0acbd6f437a03b621a2c%2F60d033ae8a04c14498d5229c3c0160ac05feea7f605dbd770741793c900469f0.svg?alt=media) **\[Drop-down menus]** select the **Language** and **Currency** in which the catalog will be displayed for partners.
9. Use the ![](https://4048883401-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-c2cb550b55c51ea1eeff0acbd6f437a03b621a2c%2F60d033ae8a04c14498d5229c3c0160ac05feea7f605dbd770741793c900469f0.svg?alt=media) **\[Drop-down menu]** to select **Service Areas** for geo-targeting.
   * Your *Available* areas are the service areas targeted by your program. You can change this in your program settings as follows:<br>

     **Manage available service areas**

     * From the top navigation bar, select ![](https://4048883401-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-1183576591b45997efe4dc81a25024640591d02a%2F245137dc972a7a7f6165b59538fcdbac8fd5bd8fee4ba9f20c1a2982c5b58b57.svg?alt=media) **\[User profile]** **→ Settings**.
     * Under *General* in the right column, select [**Marketplace Profile**](https://app.impact.com/secure/advertiser/campaign/view-edit-campaign-flow.ihtm).
     * Under *Program Information*, navigate to *Service Areas*.
     * Use the ![](https://4048883401-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-c2cb550b55c51ea1eeff0acbd6f437a03b621a2c%2F60d033ae8a04c14498d5229c3c0160ac05feea7f605dbd770741793c900469f0.svg?alt=media) **\[Drop-down menu]** and ![](https://4048883401-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-9fd92d4378edf839f6a1f6fc0beaa1660b3892b5%2F69842c54f03332c1e2eed608d72b25ad10248384a914164a7255a1e94dc76ee2.svg?alt=media) **\[Unchecked boxes]** to select or deselect service areas as needed.
     * Once you're done, select **Save**.<br>
10. Optionally, you can manage your product catalog via API. Refer to [Catalogs overview](https://integrations.impact.com/impact-brand/reference/catalogs-overview).
11. Optionally, set up mobile fallback.<br>

    **Configure mobile fallback**

    You can set up mobile fallback on your product catalogs. This option allows you to send traffic to your mobile apps, which allows partners to use generic ads for a single app across many platforms.

    1. In the *Mobile App Fallback* section, ![](https://4048883401-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-d0b6669ae76a7bef06a8d6940d7ad5c16bb8d018%2F7cb018d4face8d7cceb880eb5086c812e764fbcfe6f2a0377f88bc7576973070.svg?alt=media) **\[Toggle on] Mobile Fallback**.
       * Alternatively, find an existing product catalog and select **Edit**.
    2. From the ![](https://4048883401-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-c2cb550b55c51ea1eeff0acbd6f437a03b621a2c%2F60d033ae8a04c14498d5229c3c0160ac05feea7f605dbd770741793c900469f0.svg?alt=media) **\[Drop-down menu]** options under *Android* and *iOS*, select a fallback option for each platform. This selection will then be populated with the URL to download your app.
       * impact.com will automatically detect the device type of the consumer and direct them to the appropriate app store to download your app once mobile fallback is set up.
    3. Select **Save**.<br>
12. Select **Save**.
13. Optionally, to restrict which partners can access this product catalog, ![](https://4048883401-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-d0b6669ae76a7bef06a8d6940d7ad5c16bb8d018%2F7cb018d4face8d7cceb880eb5086c812e764fbcfe6f2a0377f88bc7576973070.svg?alt=media) **\[Toggle on] Restrict Partner Access**, then enter the names of *Partners* and partner *Groups* that should have access.
14. Select which *Partner Download Options* you want to make available for this catalog. Options you can enable include **FTP**, **API**, or **Partner Portal Browser Download**
15. Select **Save** to create the product catalog entry and move on to the upload screen (for direct uploads).
    * Otherwise, if not adding your catalog via *Direct Upload*, you'll return to the *Product Catalogs* screen and continue the process below.
      {% endstep %}

{% step %}

#### Step 3 - Review product catalog health and troubleshoot

Each product catalog has a health score that highlights any issues. To reach the *excellent* range, resolve errors, warnings, and duplicates.

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 Catalogs**](https://app.impact.com/secure/advertiser/engage/ads/productcatalogs/manage-ads-product-catalog-flow.ihtml).
2. If a catalog has any errors, warnings, or duplicate line items, you will see how many of each are present in the *Health* column.
   * **Pending** - Your catalog is being uploaded.
   * **Processing** - Your catalog is being processed.
   * **Excellent** - Your catalog is healthy. This product data set is complete and well-structured, giving it the best chance of performing effectively.
   * **Good** - Some crucial fields, like category or status, may be missing. Fixing this is necessary to improve the overall quality of the catalog.
   * **Poor** - More than 10% of required information is missing. The catalog must be fixed and re-uploaded.
3. Select *errors*, *warnings*, or *duplicates* to view line items with problems.
   * Only the first item in a set of duplicates will be represented in impact.com; all items duplicating the first will be ignored.
4. Address the issues, then re-upload the catalog to impact.com using the same method you used to upload the original catalog.
   * Upload methods that automatically fetch the catalog should automatically update when the next fetch event happens.
     {% endstep %}

{% step %}

#### Step 4 - Make catalogs available to partners

After adding the catalog and reviewing its health, proceed to the final step to make it available for your partners and ensure your products are featured in the Product Marketplace. This could attract more program applications. Consider [creating workflows](https://help.impact.com/brand/what-would-you-like-to-learn-about/platform-features/review-partner-applications/automate-partner-application-processing/create-workflows-to-automatically-process-partner-applications) to automate your program application processing.

1. From the [*Product Catalogs*](https://app.impact.com/secure/advertiser/engage/ads/productcatalogs/manage-ads-product-catalog-flow.ihtml) screen, find the catalog you just added.
2. Hover over the catalog you just added, on the right select ![](https://4048883401-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-8ec3e877b1397045c61d394485e72ac4d93120ee%2Fc6ddb46c637059f06e86c790a911217a9428f5c47b5efef046f90555e85b03cd.svg?alt=media) **\[More]** → **Make Available for Use**.<br>

   <div data-gb-custom-block data-tag="hint" data-style="success" data-icon="circle-info" class="hint hint-success"><p><strong>Note:</strong> Enable direct product links, add the product landing page domain as a deep-linkable domain in the <a href="../../account-administration/program-settings/tracking-settings/set-up-permitted-domains-for-deep-linking"><em>Allow Partners to deep link to specific pages on my site</em></a> section of your tracking settings.</p></div>

{% endstep %}
{% endstepper %}


---

# Agent Instructions: Querying This Documentation

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

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://help.impact.com/brand/what-would-you-like-to-learn-about/platform-features/product-catalogs/add-product-catalogs-as-a-brand.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.
