Contents x
    Enhanced Feeds: Product Data Specification
    • 09 Dec 2024
    • Dark
      Light
    Contents

    Enhanced Feeds: Product Data Specification

    • Updated on 09 Dec 2024
    • Dark
      Light
    Article summary

    An “Awin Product” has the same structure as Google’s Product Data Specification.

    The Google format, however, has several fields that are used for managing Google Merchant Center settings. We accept Feeds with any of those values submitted but with neither store nor display them to Publishers.

    These fields include:

    • cost_of_goods sold

    • ads_redirect

    • custom_label_0-4

    • promotion_id

    • external_seller_id

    • excluded_destination

    • included_destination

    • shopping_ads

    • excluded_country

    • pause

    • shipping_label

    • transit_time_label

    • tax_category

    Example Product JSON

    This is an example of one valid product. There should be no new lines within the Product’s JSON.

    {"product_basic":{"id":"16817108","title":"Organic Cotton Men''s T-Shirt - Blue - M","description":"Made from 100% organic cotton, this classic red men''s polo has a slim fit and signature logo embroidered on the left chest. Machine wash cold; imported.","link":"https://www.example.com/writing/pens","image_link":"http:// www.example.com/image1.jpg","additional_image_link":["http://www.example.com/image1.jpg","http://www.example.com/image2.jpg"],"mobile_link":"https://www.m.example.com/writing/pens"},"price_and_availability":{"availability":"in_stock","availability_date":"2023-12-25T13:00-0800","expiration_date":"2023-12-26T13:00-0800","price":"15.00 GBP","sale_price":"5.00 GBP","sale_price_effective_date":"2022-02-24T13:00-0800/2022-03-29T15:30-0800","cost_of_goods_sold":"3526.63 USD","unit_pricing_measure":"750 ml","unit_pricing_base_measure":"100 ml","installment":{"months":6,"amount":"50 BRL"},"subscription_cost":{"period":"month","period_length":"12","amount":"35.00 EUR"},"loyalty_points":"Programme A:100:0.5"},"product_category":{"google_product_category":"Apparel & Accessories > Clothing > Dresses","product_type":"Home > Women > Dresses > Maxi Dresses"},"product_identifiers":{"brand":"Google","gtin":"3243567980126","mpn":"EXA12345MPLE","identifier_exists":"yes"},"product_detailed":{"condition":"new","adult":"yes","multipack":20,"is_bundle":false,"energy_efficiency_class":"A+","min_energy_efficiency_class":"A+","max_energy_efficiency_class":"D","age_group":"adult","color":"yellow","gender":"unisex","material":"Cotton/polyester/elastane","pattern":"Striped","size":"L","size_type":["regular","plus"],"size_system":"UK","item_group_id":"AB12345","product_length":"14 cm","product_width":"14 cm","product_height":"14 cm","product_weight":"173 g","product_detail":[{"section_name":"General","attribute_name":"Product Type","attribute_value":"Digital player"},{"section_name":"General","attribute_name":"Product Type","attribute_value":"Digital Video"}],"product_highlight":["Supports thousands of apps, including Netflix, YouTube, HBO Now, Spotify, Showtime, Pandora, Google Play Movies","Supports thousands of apps, including Netflix, YouTube, HBO Now, Spotify, Showtime, Pandora, Google Play Movies","Supports thousands of apps, including Netflix, YouTube, HBO Now, Spotify, Showtime, Pandora, Google Play Movies"]},"shopping_campaign":{"lifestyle_image_link":"https://www.example.com/image1.jpg","short_title":"Running Shoes"},"delivery":{"shipping":[{"country":"US","region":"US","postal_code":"80302","service":"Overnight","price":"16.00 USD","min_handling_time":"1","max_handling_time":"1","min_transit_time":"3","max_transit_time":"3"}],"shipping_weight":"3 kg","shipping_length":"20 in","shipping_width":"40 cm","shipping_height":"20 in","ships_from_country":"DE","min_handling_time":1,"max_handling_time":10},"tax":{"tax":[{"country":"US","region":"CA","postal_code":"94043","rate":"8.75","tax_ship":"yes"}]}}

    Product Sections

    An Awin Product consists of sections which carry the individual fields that contain product information.

    Basic Product Data - product_basic

    • id (Required)
      Advertier’s unique product ID used to identify each product.

      • Format: Alphanumeric, underscores and dashes.

      • Length: 1-50 characters.

      • Example:

        {"product_basic":{"id":"16817108"}}

    • title (Required)
      Advertiser’s product name. Distinguish between variants where applicable.

      • Format: Unicode characters (Recommended: ASCII-only).

      • Length: 1-150 characters.

      • Example:

        {"product_basic":{"title":"Organic Cotton Men's T-Shirt - Blue - M"}}

    • description (Required)
      Advertiser’s product description.

      • Format: Unicode characters (Recommended: ASCII-only).

      • Length: 1-5,000 characters.

      • Example:

        {"product_basic":{"description":"Made from 100% organic cotton, this classic red men's polo..."}}

    • link (Required)
      Direct link to the product, non-trackable.

      • Format: URL (RFC 3986 compliant, ASCII characters only).

      • Length: 1-2,000 characters.

      • Example:

        {"product_basic":{"link":"https://www.example.com/writing/pens"}}

    • image_link (Required)
      Direct link to the product image, non-trackable.

      • Format: URL (JPEG, WebP, PNG, GIF, BMP, or TIFF).

      • Length: 1-2,000 characters.

      • Example:

        {"product_basic":{"image_link":"http://www.example.com/image1.jpg"}}

    • additional_image_link (Optional)
      Direct links to additional product images, non-trackable.

      • Format: JSON Array of URLs.

      • Max: Up to 10 images.

      • Example:

        {"product_basic":{"additional_image_link":[
  "http://www.example.com/image1.jpg",
  "http://www.example.com/image2.jpg"
]}}

    • mobile_link (Optional)
      Mobile-optimized version of the product’s landing page.

      • Format: URL (RFC 3986 compliant, ASCII characters only).

      • Length: 1-2,000 characters.

      • Example:

        {"product_basic":{"mobile_link":"https://www.m.example.com/writing/pens"}}

    Price and Availability - price_and_availability

    • availability (Required)
      Indicate product availability.

      • Values: in_stock, out_of_stock, preorder, backorder.

      • Example:

        {"price_and_availability":{"availability":"in_stock"}}

    • availability_date (Conditional)
      Required if availability is set to preorder or backorder.

      • Format: ISO 8601 (e.g., YYYY-MM-DDThh:mm±hhmm).

      • Example:

        {"price_and_availability":{"availability_date":"2023-12-25T13:00-0800"}}

    • expiration_date (Optional)
      Date the product will stop being available.

      • Format: ISO 8601 (e.g., YYYY-MM-DDThh:mm±hhmm).

      • Example:

        {"price_and_availability":{"expiration_date":"2023-12-26T13:00-0800"}}

    • price (Required)
      Product price.

      • Format: Number plus currency (ISO 4217).

      • Example:

        {"price_and_availability":{"price":"15.00 GBP"}}

    • sale_price (Recommended)
      Product price during sales periods.

      • Format: Number plus currency (ISO 4217).

      • Example:

        {"price_and_availability":{"sale_price":"5.00 GBP"}}

    • sale_price_effective_date (Recommended)
      Date range for the sale price.

      • Format: ISO 8601.

      • Example: 

        {"price_and_availability":{"sale_price_effective_date":"2022-02-24T13:00-0800/2022-03-29T15:30-0800"}}

    • unit_pricing_measure (Optional)
      Measure and dimension of the product (e.g., cost per unit).

      • Format: Positive number plus unit (e.g., 750 mL).

      • Example:

        {"price_and_availability":{"unit_pricing_measure":"750 ml"}}

    • unit_pricing_base_measure (Optional)
      Base measure for pricing.

      • Format: Positive number plus unit (e.g., 100 mL).

      • Example:

        {"price_and_availability":{"unit_pricing_base_measure":"100 ml"}}

    • installment (Optional)
      Installment payment plan details.

      • Format: JSON Object (e.g., “months”:6, “amount”:”50 BRL”).

      • Example:

        {"price_and_availability":{"installment":{
  "months":6,
  "amount":"50 BRL"
}}}

    • subcription_cost (Optional)
      Details of a subscription plan.

      • Format: JSON Object (e.g., "period":"month", "period_length":12, "amount":"35.00 EUR").

      • Example:

        {"price_and_availability":{"subscription_cost":{
  "period":"month",
  "period_length":12,
  "amount":"35.00 EUR"
}}}

    • loyalty_points (Optional)
      Details about loyalty points awarded for the purchase.

      • Format: JSON Object (e.g., "program_label":"Program A", "points":100, "multiplier":0.5).

      • Example:

        {"price_and_availability":{"loyalty_points":"Program A:100:0.5"}}

    Category and Identifiers - product_category

    • google_product_category (Recommended)
      Google-defied product category.

      • Format: Numerical ID or category path.

      • Example:

        {"product_category":{"google_product_category":"Apparel & Accessories > Clothing > Dresses"}}

    • product_type (Optional)
      Advertiser’s product category.

      • Format: Unicode characters (Recommended: ASCII only).

      • Example:

        {"product_category":{"product_type":"Home > Women > Dresses > Maxi Dresses"}}

    Was this article helpful?
    What's Next

    © 2024, AWIN Ltd. All rights reserved. Awin is part of Axel Springer Group. No part of this publication may be reproduced, translated, stored in a retrieval system, or transmitted in any form or by any means, electronic, mechanical, photocopying, recording or otherwise, without the prior permission of the copyright owner.