Product Feed Data File
CJ's product feeds functionality allows you to submit feeds of your products and their details to CJ. This enables publishers to find and promote your products on their sites. It also enables you to access rich product-level data about the products you are selling.
Choosing the Right Feed Spec
Shopping (Google Format)
Best for retail advertisers selling physical products with unique SKUs that ship to a customer.
Examples: apparel, electronics, housewares, car parts, cosmetics, software.
Learn moreCJ Travel and Experiences
Best for advertisers selling products that depend on a date, time, or location.
Examples: hotels, vacations, cruises, concert tickets, restaurants, local events.
Learn moreFinance
Best for finance vertical advertisers promoting application-driven financial products.
Examples: credit cards, mortgages, deposits, personal loans.
Learn moreHow to Upload
CJ supports three methods of transferring your Product Feed Data File: POST, FETCH, and manual upload through the CJ Account Manager
POST to CJ SFTP
Use the POST method to send your file directly to CJ's SFTP server.
SFTP upload
Use your SFTP credentials to connect. If you need your credentials or need to reset them, submit a support ticket to the CJ team.
Need credentials? Submit a support ticket →Once logged in, place the file in the / root directory. Do not upload to a subdirectory.
If processed successfully, CJ will send two emails — one confirming receipt and a second with the processing status.
Email 1: receipt confirmation · Email 2: processing statusHow to validate your processing status email →Submitting Your Feed
Your product feed will update every time you submit it. Deliver your files to the root directory. Do not create new folders or deliver to a different directory — your file will not process.
Publishers who subscribe to receive an export of your feed may receive a new copy each time you submit one.
Passwords
All CJ SFTP subscriptions on your account share the same password.
- New password: If you select this method and have no other SFTP subscriptions in your CJ account, an SFTP account and password will be generated for you. This information will be emailed to the addresses you indicated when you registered your feed.
- Forgot password: CJ cannot retrieve SFTP passwords. To reset, click Reset Password on the Feeds page. All registered users on all of your SFTP subscriptions (including non-product-feed subscriptions) will receive the new credentials.
Warning: Resetting your SFTP password resets the password for all subscriptions using SFTP — not just product feeds. Review all subscriptions under Account > ADMIN > Subscriptions before resetting. Resetting cannot be undone.
FETCH from Your FTP, SFTP, or HTTP/S
For all FETCH methods, CJ will fetch your file once per day. Fetch jobs are scheduled throughout the day; you can't choose a specific time for your file to be retrieved. If you need your feed to update more than once per day, use POST to CJ SFTP instead.
| Transfer Method | Requirements |
|---|---|
| FETCH from FTP or SFTP | Provide the host name, username, password, directory, and port. |
| FETCH from HTTP/S | Provide the URL where your file is hosted. The URL must not be password-protected. CJ requires SSL certificates signed by a trusted certificate authority — self-signed certificates are not accepted. |
CJ recommends that if you use a FETCH method, you only give CJ access to the files you want to use for your product feed.
Upload Through the CJ Account Manager
To upload your file manually, log into the CJ Account Manager, and go to Account > Subscriptions to submit your feed file:
Manual upload
CJ Account Manager
Subscriptions
Upload File
and select Upload
Sample Feed Files
Download and reference these sample files when building your feed:
| Feed | Download |
|---|---|
| Shopping Feed (all fields) | ShoppingFeedSample_csv.csv |
| Shopping Feed (required fields only) | Shopping Feed Sample – Required Fields.csv |
| Travel Experiences Feed | TravelExperiencesFeedSample_csv.csv |
Troubleshooting
Common Processing Mistakes and Errors
- Make sure your file contains all the required fields, and that the field names contain no spaces.
- Field names should appear in the file exactly as listed in the file specifications.
- Make sure you include the 'condition' field, CJ requires this and Google does not.
- Make sure "id" values contain only alphanumeric characters, dashes and underscores. Other non-alphanumeric characters in "id" values will prevent item based commissioning from functioning properly.
- Make sure you remove or rename fields that we don't accept, but Google does, to avoid warnings.
- Make sure the file format matches the format set when you registered your feed.
- Make sure your file name is an exact match, including extension, to the name with which you registered your feed.
- Almost all CJ advertisers are eligible to create and submit a product feed. The only advertisers who are not eligible are advertisers who have a gateway without redirect integration. This integration is uncommon.
I submitted a feed but got no confirmation that it was received or processed.
- Does the filename of the file you submitted match the filename you indicated on your feed registration? CJ uses your filename to identify your file in our data transfer system. See more info in the section on Filename above. This is the most common cause of this problem.
- Did you submit it via the delivery method you indicated on your feed registration? For example, are you submitting your product feed to the CJ FTP instead of the CJ SFTP?
- If you selected Fetch from F/SFTP, did you enter your S/FTP credentials correctly? Is the password right? Did you enter the correct directory?
- If you selected Fetch from HTTP/S, is the URL accurate? Does the link require a password?
- Is your email address on the notifications setting section of the feed registration page?
I submitted a feed and the whole file was rejected.
- Does your feed have at least the minimum required fields? Refer to the spec requirements above.
- Did you submit your feed in a required format?
- For XML files, is your XML formatted correctly?
- Were all the individual products in your feed rejected? Your file must have at least one acceptable product for the file to process. Refer to the specific field level information above.
I submitted a feed and got an unable to parse file error message.
- Have you submitted a feed in the Google Shopping format? Refer to the feed spec above. Double check that you haven’t sent a feed formatted for a different purpose.
- For delimited files, did you submit a plain text version of your file? We cannot accept Excel documents, Google Sheets, etc.
- Did you include an unsupported header? Unlike previous versions of our feed system, the current product feed system does not require a file header with anything other than the column names.
- Did you include the column names? These are required.
- Is your file delimited in the format you selected when you registered? For example, did you select “CSV” but are submitting a pipe-delimited file?
- Did you select the correct option for quoted fields? Most files will need to select “yes.” You should only select “no” if your file has quotes in the content of the feed, and no quotes separating values.
I want to use CJ SFTP but I do not have my SFTP password.
CJ cannot retrieve SFTP passwords. If you do not have your SFTP password you may reset your password by navigating to Links > Feeds and clicking Reset Password. Note: Selecting to reset your SFTP password will reset the SFTP password for all the subscriptions that use SFTP, including those that may not be product feeds. We strongly advise you to review all the subscriptions under Account > ADMIN > Subscriptions before resetting your password to be sure you are not inadvertently resetting the password for other subscription types. Resetting your password cannot be undone.
I want to pass HTML or other markup.
CJ will accept a feed with markup in content fields such as title and description. These values will be pass escaped, meaning we will not convert them into the formatting you intend. For example, if you pass:
- Product feature
- Product feature
Publishers will see <ul><li>Product feature</li><li>Product feature</li></ul>
And not
Product feature Product feature
Updated 11 days ago
