Microsoft Shopping campaigns feed files validation results will be displayed here.
Required Fields for Microsoft Shopping Campaigns Feed Files
Field Name | Description | What You Need to Know |
---|---|---|
description | Item description |
Example: Requirements: Alphanumeric, 10000 character limit, no HTML, no promotional text. Must match the description on the landing page. |
id | A unique identifier for the item. |
Example: Requirements: 50 Unicode character limit. Must be unique for each item. |
image_link | URL of an image of the item |
Example: Requirements: 2000 character limit, HTTP/HTTPS, image format (jpg, png, etc.), size < 16MB, no watermarks. |
link | Direct URL of the item's page on your website |
Example: Requirements: 2000 character limit, HTTP/HTTPS, no redirects. Must point to the specific product page. |
price | Base price, excluding tax and shipping, submitted in local currency. |
Example: Requirements: Number plus ISO 4217 currency. No currency symbols. Must match price on landing page. |
shipping | Cost of shipping. Required for Austria and Germany only. |
Example: Requirements: Numeric, use two decimal places, no currency symbols. |
title | Title of the item |
Example: Requirements: 150 character limit, no promotional text, no all caps. |
Item Identification Fields for Microsoft Shopping Campaigns Feed Files
Required if the value is assigned by the manufacturer.
Field Name | Description | What You Need to Know |
---|---|---|
brand | Item's manufacturer, brand or publisher |
Example: Do not add your store name as the brand unless you manufacture the product. |
gtin | Global Trade Item Number. |
Example: Up to 10 GTIN values can be provided, max 14 digits each. |
identifier_exists | Indicates that unique product identifiers (gtin, brand, mpn) aren't available. |
Example: Use for custom or homemade goods. |
mpn | Manufacturer Part Number |
Example: Should be specific to one unique product. |
Apparel Products in Microsoft Shopping Campaigns Feed Files
Field Name | Description |
---|---|
age_group | Target age group (newborn, infant, toddler, kids, adult). |
color | Dominant color of the item. |
gender | Target gender (male, female, unisex). |
size | Size of the item (small, medium, large). |
Product Variants in Microsoft Shopping Campaigns Feed Files
Field Name | Description |
---|---|
additional_image_link | URLs of additional img (up to 10). |
item_group_id | ID to group variant products. |
material | The material of the item. |
pattern | Pattern or graphic print of the item. |
Other Optional Fields for Microsoft Shopping Campaigns Feed Files
Field Name | Description |
---|---|
availability | Availability of item (in stock, out of stock, preorder). |
condition | Condition of item (new, used, refurbished). |
multipack | Bundle of identical items. |
product_category | Predefined product category. |
product_type | Your custom category for the item. |
Sales & Promotions in Microsoft Shopping Campaigns Feed Files
Field Name | Description |
---|---|
promotion_ID | ID to group items by promotion. |
sale_price | The item's sale price. |
sale_price_effective_date | Date range for the sale. |
About Microsoft Shopping Campaigns Feed Files
A Microsoft Shopping campaigns feed file contains a list of your products and attributes that define how they will display on the Microsoft Advertising Network. To run Microsoft Shopping campaigns, you must create and upload a catalog feed file. Whenever you want to update your product information, you upload an updated Microsoft Shopping campaigns feed file.
Here is an example of a Microsoft Shopping campaigns feed file
Creating Microsoft Shopping Campaigns Feed Files
- Use a spreadsheet program like Microsoft Excel.
- The first row must be a header row listing the attribute names (e.g., id, title, price).
- Each product should be in its own row, with its attributes in the corresponding columns.
- Include all required attributes for your products.
- Save the file as a tab-delimited text file (.txt). Other supported formats include .zip, .gz, .gzip.
Submitting Microsoft Shopping Campaigns Feed Files
You can submit your Microsoft Shopping campaigns feed file to Microsoft Merchant Center in several ways:
- Manual upload: For files smaller than 4MB.
- Upload via FTP/SFTP: Recommended for files larger than 4MB (up to 1GB).
- Automatically download from URL: For files up to 1GB hosted on a public server.
- Import from Google Merchant Center: If you already use Google Shopping.
Updating Your Microsoft Shopping Campaigns Feed Files
Your Microsoft Shopping campaigns feed file expires after 30 days, so it's a good practice to upload it daily to keep your product information fresh and your Microsoft Shopping campaigns running.