How Can We Help?
Microsoft Advertising Feed | Build Guide
Feed Content
Required Fields
id
Description:
A unique identifier for the item.
Example:
ISI1
Requirements:
50 Unicode character limit
Recommended: ASCII only: alphanumeric, underscores (_), and dashes (-)
- ID must be unique for each item in your catalog per market.
- If you have multiple feeds, IDs of items across different feeds still need to be unique.
- Special ASCII characters (e.g., asterisk (*), comma (,), backslash (\), ampersand (&), etc. are allowed.
- The ID is the same as the merchant product ID (MPID).
title
Description:
Title of the item
Example:
Women’s shoes
Requirements:
Alphanumeric
150 character limit
Don’t enclose in quotes
- Use relevant titles that match with what users are searching for with key information first in the title (e.g., Women’s over the knee boots).
- When applicable, we recommend you include gender, size, color, material, and pattern details in title (e.g., Women’s small red wool sweater).
- Include characteristics like color to differentiate from other products.
- Do not include promotional text (e.g., Free shipping) or use all caps (e.g., WOMEN’S SHOES).
- Uploading an item for the first time will be pending review until the offer title has been successfully reviewed. Updating the offer title of an existing item will be reverted to the pending review status until it has been successfully reviewed again. The review process can take up to 3 business days.
- The title of the item can be slightly different, but it must be for the same item.
- For mobile devices or tablets, the price can be 0 when payment options with multiple installments are provided. For such items, you must include the product_category value of “Electronics > Communications > Telephony > Mobile Phones” (267) for mobile devices or “Electronics > Computers > Tablet Computers” (4745) for tablets.
link
Description:
Direct URL of the item’s page on your website
Example:
product.asp?pn=ISI1
Requirements:
0-2000 characters
- HTTP or HTTPs only and no redirects. For redirect URLs, use the ads_redirect field.
- Link should point to the specific product instead of your store’s home page or pages with multiple products.
- The Product URL domain must match the Store URL domain.
- Must be a path under your store’s destination URL. For aggregators, this must be a direct link to the seller’s product page. Aggregators are third party sites that consolidate items to Microsoft Bing on behalf of individual merchants. In the catalog that an aggregator submits, the link attribute must be a direct link to the seller’s product page and the seller-name attribute is required. Adding items submitted on behalf of the merchant must comply with our policies and Terms of Service.
- Uploading an item for the first time will be pending review until the product URL has been successfully reviewed. Updating the product URL of an existing item will be reverted to the pending review status until it has been successfully reviewed again. The review process can take up to 3 business days.
- Use as few redirects as possible and be sure that the redirects go to the same verified store domains to avoid offer rejections.
- Do not require customers to register, sign in, or take other actions to view information about your product. Make sure customers see your final landing page immediately after clicking your ad.
price
Description:
Base price, excluding tax and shipping, submitted in local currency.
Example:
23.99
Requirements:
Numeric
0.00 to 10000000.00 (10 million)
Use two decimal places and no symbols (e.g.. $)
- The price from the landing page of your offer must be the same price as indicated in the feed.
- For the United States, exclude tax in the price. For the United Kingdom, include any value added tax (VAT) in the price. See Microsoft Merchant Center catalog tax policy for more details.
- Uploading an item for the first time will be pending review until the price has been successfully reviewed. Updating the price of an existing item will be reverted to the pending review status until it has been processed again. The pricing update can take up to 6 hours to process.
- For mobile devices or tablets, the price can be 0 when payment options with multiple installments are provided. For such items, you must include the product_category value of “Electronics > Communications > Telephony > Mobile Phones” (267) for mobile devices or “Electronics > Computers > Tablet Computers” (4745) for tablets.
- Auction price is not allowed. The price must be a fixed price for the product.
description
Description:
Item description
Example:
Bright yellow 100% cotton dress shirt
Requirements:
Alphanumeric
10000 character limit
No HTML code and no promotional text
Do not enclose in quotes
- The description from the landing page of your offer must be the same description as indicated in the feed.
- We recommend that you include size, color, and pattern when applicable.
- User relevant description with the most important data at the front.
- Uploading an item for the first time will be pending review until the description has been successfully reviewed. Updating the description of an existing item will be reverted to the pending review status until it has been successfully reviewed. The review process can take up to 3 business days.
- The description of the item can be slightly different, but it must be for the same item.
image_link
Description:
URL of an image of the item
Example:
images/ISI1.jpg
Requirements:
Alphanumeric
1000 character limit
Link must be HTTP or HTTPs only
Image must be: bmp, gif, exif, jpg, png, tiff
The recommended minimum size is 220px by 220px
The image size cannot exceed 3.9 MB
No watermarks or free shipping text
Only one image per item
- Do not include any text within your images, including promotional messaging.
- Use images with a white background for a “pop” effect.
- Update robots.txt file to allow Microsoft Advertising to crawl your site. Your ad cannot be served if the crawling is incomplete. Learn more.
- The image link URL is case-sensitive. Changing the casing on the URL will cause the URL to be re-crawled.
- Uploading an item for the first time will be pending review until the image URL has been successfully crawled. Updating the image URL of an existing item will be reverted to the pending review status until it has been successfully re-crawled. The review process can take up to 3 business days.
- If you have updated the image, be sure to update the image URL for the new image to be reflected in the ad.
- If the images aren’t displaying because the URL is missing an image or the image size is too large or small, update the URL for the offer so it can be reviewed in the next crawl.
shipping
Description:
Cost of shipping, submitted in local currency. This is a required field for Austria and Germany only.
Shipping has multiple subfields and can have the following headers:
shipping(price)
shipping(country:price)
shipping(country:service:price)
shipping
Example:
12.99
Requirements:
Numeric
0.01 to 10000000.00 (10 million)
Use two decimal places and no symbols (e.g., €)
For free shipping, use 0
- The shipping field is required for Austria and Germany only.
- Multiple shipping prices for any item is accepted. For example, DE:Standard:10, DE:Express:20, and DE:Same Day:30 can be used for the same item.
- The format depends on the attribute name in the header row of the feed file and the order of the values must match the order in the attribute name. For example, shipping(country:price) must be DE:6.49 or shipping(country:service:price) must be DE:Standard:12.99
- Each sub-attribute needs to be separate with a colon and each delivery attribute group needs to be separated with a comma.
- If a country is not included, the shipping price will apply to the target country of the item by default.
- Uploading an item’s shipping for the first time will be pending review until the shipping has been successfully reviewed. This can take up to 30 hours to process. Updating the shipping of an existing item will be reverted to the pending review status until it has been processed again. The shipping update can take up to 8 hours to process.
Required (if value is assigned by the manufacturer)
mpn
Description:
Manufacturer Part Number
Example:
ADNK-5020
Requirements:
Alphanumeric
70 character limit
- MPN should be specific to one unique product.
- MPNs are assigned by the manufacturer.
- Learn more about unique identifiers for your product ads.
gtin
Description:
Global Trade Item Number.
Up to 10 GTIN values can be provided, with a maximum of 14 digits per value. For multiple GTIN values, separate by a comma and space.
Example:
00012345600012
Requirements:
Numeric
14 digits max per value
Multi-value
- Learn more about unique identifiers for your product ads.
brand
Description:
Item’s manufacturer, brand or publisher
Example:
Contoso
Requirements:
Alphanumeric
70-character limit
10-word limit
- Do not add your store name as the brand unless you manufacture the product.
- We recommend to keep the brand character limit to 70, but it can be up to 1000 characters.
- The maximum word limit is 10.
- Uploading an item for the first time will be pending review until the brand has been successfully crawled. Updating the brand of an existing item will be reverted to the pending review status until it has been successfully re-crawled. The review process can take up to 3 business days.
- Learn more about unique identifiers for your product ads.
identifier_exists
Description:
Used to indicate that unique product identifiers (gtin, brand, and mpn) aren’t available for a product.
Example:
FALSE
Requirements:
Boolean: TRUE or FALSE
- Products that may not have an identifier_exists attribute include custom goods, like homemade products, or products that were made before gtins were created, like antiques.
- Learn more about unique identifiers for your product ads.