Back

Tech Corner: Metadata

Twitter Facebook Linked In Paper Plan

Welcome to the latest edition of FMTC’s Tech Corner. We’re excited to announce the integration of AI and are introducing a new API field: metadata. 

Overview

FMTC is enhancing the efficiency of deal distribution with our new AI-powered tool. This innovative tool is designed to streamline the process of parsing deal label information, ensuring that all deals are presented in a consistent format with standardized data. By leveraging AI capabilities, the metadata accurately identifies crucial deal attributes such as currency type, discount values, percentage vs. flat amounts, maximum values, and a price or quantity triggers. This technology not only simplifies the integration of deals from various sources but also guarantees the reliability and accuracy of the information provided — essential for both merchants and consumers in making informed decisions.

New Fields

The latest edition to the v3 Deals API endpoint is the metadata field. This contains an array object with the following information from the provided labels:

Field NameDefinition
currencySpecifies the currency type as indicated in the label. 
valueRepresents the discount value extracted from the label. If a range is provided, it reflects the lower end.
max_valueIf a range is provided, the maximum discount value in the range. 
is_percentBoolean value that specifies whether the discount values are percentages (0 for fixed amounts).  
old_priceDisplays the original price before any discounts.  
new_priceShows the price after applying the discount. 
price_triggerSpecifies the price threshold for the discount to be applicable. 
quantity_triggerIndicates the quantity required for the discount to be applied.
coupon_codeProvides the discount code if applicable.
free_shippingBoolean value that indicates if free shipping is offered. 

Example Input:

label = “Save $5 on regular tickets to Disneyland Resort with promo code SUMMER”

Example Output:

“metadata”: [

                {
                    “currency”: “USD”,
                    “value”: “5.00”,
                    “max_value”: null,
                    “is_percent”: 0,
                   “old_price”: null,
                    “new_price”: null,
                    “price_trigger”: null,
                    “quantity_trigger”: null,
                    “coupon_code”: “SUMMER”,
                    “free_shipping”: 0
                }
            ]

Our system detects the currency symbol ‘$’ in the label, and extracts ‘5’ as the discount value. Since these are fixed values, is_percent remains 0. 

Example Input:

label = “Earn a $50-$500 gift card with a select regular-priced purchase. Use code JULYGC.”

Example Output:

“metadata”: [
                {
                    “currency”: “USD”,
                    “value”: “50.00”,
                    “max_value”: 500.00,
                    “is_percent”: 0,
                    “old_price”: null,
                    “new_price”: null,
                    “price_trigger”: null,
                    “quantity_trigger”: null,
                    “coupon_code”: “JULYGC”,
                    “free_shipping”: 0
                }
           ]

Our system detects the currency symbol ‘$’ in the label, and extracts the ‘50’ and ‘500’ as the discount value range. Since these are fixed values, is_percent remains 0. 

Example Input:

label = “Shop & Save | 20% off orders over £150”

Example Output:

“metadata”: [
                {
                    “currency”: “GBP”,
                    “value”: “20.00”,
                    “max_value”: null,
                    “is_percent”: 1,
                    “old_price”: null,
                    “new_price”: null,
                    “price_trigger”: 150.00,
                    “quantity_trigger”: null,
                    “coupon_code”: null,
                    “free_shipping”: 0
                }
           ]

Our system detects the currency symbol ‘£’ in the label, and extracts the ‘20’ as the discount value. Since this is a percentage, is_percent is set to 1. 

As always, a dedicated team is here to assist you! If you have any questions or concerns, feel free to contact your account manager or email us at [email protected]

Curious about other FMTC technologies? Find more information on FMTC’s tools in Tech Corner:

Written by Josh Hutter

Leave a Reply

Your email address will not be published. Required fields are marked *

Related Posts