Shopify: Discounts
Description
Each record represents a unique discount, enriched with information about its associated price_rule and metrics regarding orders and abandoned checkouts.
Supported Data Sources
Shopify
Columns
_fivetran_synced
The time when a record was last updated by Fivetran.
code
The case-insensitive discount code that customers use at checkout. Shopify recommends this map onto the associated price_rule.title
.
created_at
The date and time (ISO 8601 format) when the discount code was created.
discount_code_id
The ID for the discount code.
price_rule_id
The ID for the price rule.
updated_at
The date and time (ISO 8601 format) when the discount code was updated.
usage_count
The number of times that the discount code has been redeemed.
allocation_limit
The number of times the discount can be allocated on the cart - if eligible. For example a Buy 1 hat Get 1 hat for free discount can be applied 3 times on a cart having more than 6 hats, where maximum of 3 hats get discounted - if the allocation_limit is 3. Empty (null) allocation_limit means unlimited number of allocations.
allocation_method
The allocation method of the price rule. Valid values include each
(the discount is applied to each of the entitled items. For example, for a price rule that takes $15 off, each entitled line item in a checkout will be discounted by $15) and across
(the calculated discount amount will be applied across the entitled items. For example, for a price rule that takes $15 off, the discount will be applied across all the entitled items).
price_rule_created_at
The date and time (ISO 8601 format) when the price rule was created.
customer_selection
The customer selection for the price rule. Valid values include all
(the price rule is valid for all customers) and prerequisite
(the customer must either belong to one of the customer segments specified by customer_segment_prerequisite_ids, or be one of the customers specified by prerequisite_customer_ids).
ends_at
The date and time (ISO 8601 format) when the price rule ends. Must be after starts_at.
is_once_per_customer
Boolean representing whether the generated discount code will be valid only for a single use per customer. This is tracked using customer ID.
prereq_min_quantity
If customer_selection
is prerequisite
, the minimum number of items for the price rule to be applicable. The quantity of an entitled cart item must be greater than or equal to this value.
prereq_max_shipping_price
If customer_selection
is prerequisite
, the maximum shipping price for the price rule to be applicable. The shipping price must be less than or equal to this value
prereq_min_subtotal
If customer_selection
is prerequisite
, the minimum subtotal for the price rule to be applicable. The subtotal of the entitled cart items must be greater than or equal to this value for the discount to apply.
prereq_min_purchase_quantity_for_entitlement
If customer_selection
is prerequisite
, the prerequisite purchase for a Buy X Get Y discount. The minimum purchase amount required to be entitled to the discount.
prereq_buy_x_get_this
If customer_selection
is prerequisite
, in a Buy/Get ratio for a Buy X Get Y discount, this is the offered 'get' quantity.
prereq_buy_this_get_y
If customer_selection
is prerequisite
, in a Buy/Get ratio for a Buy X Get Y discount, this defines the necessary 'buy' quantity.
starts_at
The date and time (ISO 8601 format) when the price rule starts.
target_selection
The target selection method of the price rule. Valid values include all
(the price rule applies the discount to all line items in the checkout) and entitled
(the price rule applies the discount to selected entitlements only).
target_type
The target type that the price rule applies to. Valid values include line_item
(the price rule applies to the cart's line items) and shipping_line
(the price rule applies to the cart's shipping lines).
title
The title of the price rule. This is used by the Shopify admin search to retrieve discounts. It is also displayed on the Discounts page of the Shopify admin for bulk discounts. Shopify recommends that this map onto the associated discount_code.code
.
price_rule_updated_at
The date and time (ISO 8601 format) when the price rule was updated.
usage_limit
The maximum number of times the price rule can be used, per discount code.
value
The value of the price rule. If if the value of target_type
is shipping_line
, then only -100 is accepted. The value must be negative.
value_type
The value type of the price rule. Valid values include fixed_amount
(applies a discount of value as a unit of the store's currency. For example, if value is -30 and the store's currency is USD, then $30 USD is deducted when the discount is applied) and percentage
(applies a percentage discount of value. For example, if value is -30, then 30% will be deducted when the discount is applied).If target_type
is shipping_line
, then only percentage
is accepted.
total_order_discount_amount
Total monetary amount (in shop currency) of discounts taken off of orders.
total_abandoned_checkout_discount_amount
Total monetary amount (in shop currency) of discounts taken off abandoned checkout orders.
total_order_line_items_price
Total monetary amount (in shop currency) of line items for orders that have used this discount.
total_order_shipping_cost
Total shipping costs for orders that used this discount.
total_abandoned_checkout_shipping_price
Total projected shipping costs for abandoned checkouts that applied this discount first.
total_order_refund_amount
Total refunded amount (in shop currency) for orders that used this discount code.
count_customers
Count of distinct customers who placed orders using this discount.
count_customer_emails
Count of distinct customer emails who placed orders using this discount.
avg_order_discount_amount
Average amount (in shop currency) of discount taken off orders.
source_relation
The schema or database this record came from if you are making use of the shopify_union_schemas
or shopify_union_databases
variables, respectively. Empty string if you are not using either of these variables to union together multiple Shopify connectors.
count_orders
Count of orders in which this discount code was applied.
count_abandoned_checkouts
Count of abandoned checkouts in which this discount code was applied.
count_abandoned_checkout_customers
Distinct count of customers who applied this discount in a checkout that they abandoned.
count_abandoned_checkout_customer_emails
Distinct count of customer emails who applied this discount in a checkout that they abandoned.
Last updated
Was this helpful?