Promotion tags [promotion_tags]

Use the promotion tags [promotion_tags] attribute to specify subsets within product categories, product types, and brands that your promotion applies to.

On this page

• When to use
• Format
• Best practices
• Examples

---

When to use

Optional for each product

---

Format

Follow these formatting guidelines to make sure we understand the data you're submitting.

Formatting specifications
Technical name	promotion_tags
Type	Unicode characters (Recommended: ASCII only)
Repeated field	Yes
Schema.org property (What’s this?)	No

File format examples

To ensure your attribute is recognized correctly, use the formatting specific to your data source type.

Data source format	Examples
Text (TSV or CSV) data sources	Syntax: Acceptable keys: google_product_category, product_type, brand Format: {attribute1: “valueA”, attribute2: “valueB”} Maximum length is 500 characters. brand: “Nike”, google_product_category: “Apparel & Accessories > Shoes”
XML data sources	<g:promotion_tags>Nike</g:promotion_tags> <g:promotion_tags>Apparel &amp; Accessories &gt; Apparel &gt; Shoes</g:promotion_tags>
Merchant API	To format your data for Merchant API, check the Merchant API resource.

---

Best practices

These best practices can help you go beyond the basic requirements to optimize your promotion data for performance.

• This attribute should be used when the promotion applies to a subset (but not all) of the items in a category, type, or brand, and the specific item IDs are not known.

---

Examples

Promotion data for a sale that marks 10% off of everything, except jewelry

Attribute	Value
Promotion ID [promotion_id]	mothers_day_ten_percent_off_sale
Promotion title [long_title]	Mother’s Day 10% Off Sale
Promotion tags [promotion_tags]	Clothing & Accessories> Jewelry > Rings