Eligibility conditions in RuffRuff Order Bonus let you narrow down the customers or orders that receive a gift. If you set no conditions, all customers are eligible.
When you add multiple conditions, you can combine them in either of the following ways.
Match type | Description |
|---|---|
All conditions must be met (AND) | Customers who meet all configured conditions are eligible. |
Any condition can be met (OR) | Customers who meet at least one configured condition are eligible. |
The following conditions are available.
Condition | Description | Example |
|---|---|---|
Cart subtotal price | Evaluated using the subtotal price of items in the cart. | Distribute a gift for a subtotal of ¥5,000 or more |
Cart item quantity | Evaluated using the total quantity of items in the cart. | Distribute a gift when the cart contains 2 or more of Product A |
Customer login status | For in-cart distribution on the online store, evaluated by whether the customer is logged in or is a guest. | Distribute gifts only to logged-in customers |
Customer tag | Evaluated using tags assigned to the customer. | Distribute gifts to customers with the "VIP" tag |
Customer total order count | Evaluated using the customer's historical order count. Post-order distribution excludes the current order. | Distribute a gift when the customer has placed 10 or more orders |
Customer total spent | Evaluated using the customer's historical total purchase amount. Post-order distribution excludes the amount of the current order. | Distribute a gift when the customer has spent ¥10,000 or more |
Customer metafield | Evaluated using the customer's metafield value. | Distribute gifts to customers whose membership rank is GOLD |
The subtotal is evaluated as follows.
Calculation: Adds together each item's unit price × quantity.
Excluded costs: Shipping, tax, and fees are excluded.
Post-order distribution: Uses the order line items for evaluation.
Currency: Enter the amount in the store currency. When customers purchase with a cart in a currency other than the store currency, the subtotal is compared with the amount converted to that currency at the exchange rate.
Example: Product A (¥1,000) × 2 + Product B (¥500) × 1 gives a subtotal of ¥2,500.
The settings are as follows.
Field | Description |
|---|---|
Operator | Choose Is equal to, Is not equal to, Is less than, Is less than or equal to, Is greater than, or Is greater than or equal to. |
Amount | Enter the threshold amount. |
Calculation basis | Select "Before product discounts" or "After product discounts." |
Applies to | Choose which products count toward the subtotal: "All products," "Specific collection," or "Specific product." |
Under "Applies to", "Advanced settings" lets you narrow by purchase type and set products to exclude.
Setting | Description |
|---|---|
Purchase types to include | Choose All purchase types, One-time purchases only, or Subscriptions only. The subtotal uses only products of the purchase type you select. |
Exclude gifts | Excludes gift products from gift campaigns. |
Exclude sale products | Excludes products with a compare-at price (the price before the discount). |
Exclude pre-order products | Excludes RuffRuff Pre-Order products. |
Caution: If your store also uses product discounts, the "Calculation basis" changes the amount used for evaluation. Select the intended basis.
Item quantity is evaluated as follows.
In-cart distribution: Uses the total quantity of items in the cart.
Post-order distribution: Uses the order line items.
The settings are as follows.
Field | Description |
|---|---|
Operator | Choose Is equal to, Is not equal to, Is less than, Is less than or equal to, Is greater than, or Is greater than or equal to. |
Quantity | Enter the threshold quantity (0 or more). |
Applies to | Choose which products count toward the quantity: "All products," "Specific collection," or "Specific product." |
Only published collections and products with "Active" or "Draft" status are included in the calculation.
Under "Applies to", "Advanced settings" lets you narrow by purchase type and set products to exclude.
Setting | Description |
|---|---|
Purchase types to include | Choose All purchase types, One-time purchases only, or Subscriptions only. The quantity uses only products of the purchase type you select. |
Exclude gifts | Excludes gift products from gift campaigns. |
Exclude sale products | Excludes products with a compare-at price (the price before the discount). |
Exclude pre-order products | Excludes RuffRuff Pre-Order products. |
Evaluated by whether the customer is logged in. Use this condition to distribute gifts differently to logged-in customers and guests.
The settings are as follows.
Field | Description |
|---|---|
Login status | Select "Customer is logged in" or "Customer is not logged in" using the radio buttons. |
The "Customer login status" condition has the following limitations.
Unavailable when: You cannot set this condition when Online Store uses "After the order" or when Online Store is excluded from the campaign.
Reason: Order data cannot determine the customer's login status at checkout.
If a campaign uses both in-cart distribution on the online store and channels other than the online store, note the following.
Added channels: Post-order evaluation cannot determine the customer's login status at the time of purchase.
Orders requiring review: These are orders whose eligibility cannot be determined by the other conditions alone and therefore depends on login status.
Evaluated using tags assigned to the customer.
The settings are as follows.
Field | Description |
|---|---|
Match type | Choose Contains all, Contains any, Does not contain all (but can contain some, or none), or Contains none. |
Customer tag | Enter the tags to evaluate. You can specify multiple tags. |
Each match type is evaluated as follows.
Match type | Description |
|---|---|
Contains all | Customers with all specified tags are eligible (AND). |
Contains any | Customers with at least one specified tag are eligible (OR). |
Does not contain all (but can contain some, or none) | Customers who do not have all specified tags are eligible. |
Contains none | Customers with none of the specified tags are eligible. |
Eligibility by distribution method is as follows.
In-cart distribution: Customers who are not logged in are ineligible.
Post-order distribution: Regardless of login status, eligibility is evaluated using the tags of the customer linked to the order.
Evaluated using metafield values assigned to the customer. This supports custom attributes such as a membership rank of GOLD.
The settings are as follows.
Field | Description |
|---|---|
Namespace and key | Specify the customer metafield to evaluate. You can configure it with the edit button, and the definition is shared within the campaign. |
Operator | Choose Is, Is not, Is empty, Is not empty, Contains, Does not contain, Starts with, Does not start with, Ends with, or Does not end with. |
Value | Enter the value to evaluate. This is not required when you select "Is empty" or "Is not empty." |
The customer metafield namespace and key must be configured in Shopify admin in advance.
Eligibility by distribution method is as follows.
In-cart distribution: Customers who are not logged in are ineligible.
Post-order distribution: Regardless of login status, eligibility is evaluated using the metafields of the customer linked to the order.
The following example evaluates custom.rank for in-cart distribution on the online store. Customers who are not logged in are ineligible for every operator.
Operator and value | Eligible customers | Ineligible customers |
|---|---|---|
Is: VIP | rank = VIP | rank is blank, rank = GOLD |
Is not: VIP | rank is blank, rank = GOLD | rank = VIP |
Is empty | rank is blank | rank = GOLD, rank = VIP |
Is not empty | rank = GOLD, rank = VIP | rank is blank |
Contains: V | rank = VIP | rank is blank, rank = GOLD |
Does not contain: V | rank is blank, rank = GOLD | rank = VIP |
Starts with: V | rank = VIP | rank is blank, rank = GOLD |
Does not start with: V | rank is blank, rank = GOLD | rank = VIP |
Ends with: P | rank = VIP | rank is blank, rank = GOLD |
Does not end with: P | rank is blank, rank = GOLD | rank = VIP |
Evaluated using the customer's historical order count.
The settings are as follows.
Field | Description |
|---|---|
Operator | Choose Is equal to, Is not equal to, Is less than, Is less than or equal to, Is greater than, or Is greater than or equal to. |
Count | Enter the threshold order count (0 or more). |
Example: Distribute a gift to customers who have placed 10 or more orders.
Eligibility by distribution method is as follows.
In-cart distribution: Customers who are not logged in are ineligible.
Post-order distribution: Regardless of login status, eligibility is evaluated using the total order count of the customer linked to the order, excluding the current order.
Evaluated using the customer's historical total purchase amount.
The settings are as follows.
Field | Description |
|---|---|
Operator | Choose Is equal to, Is not equal to, Is less than, Is less than or equal to, Is greater than, or Is greater than or equal to. |
Amount | Enter the threshold amount. |
Example: Distribute a gift to customers who have spent ¥10,000 or more in total.
Eligibility by distribution method is as follows.
In-cart distribution: Customers who are not logged in are ineligible.
Post-order distribution: Regardless of login status, eligibility is evaluated using the total spent by the customer linked to the order, excluding the current order.
Caution: In a cart in a currency other than the store currency, customers whose total spent exceeds the condition amount by only about 2% or less may not meet the condition at checkout. If you sell in other currencies, set the condition amount about 2% lower.
In this case, even if a gift is added automatically on the storefront, an error appears at checkout when “Limit distribution of gifts that do not meet conditions” is enabled in the Restrictions settings.
For setup notes when you sell in other currencies, see How amounts work when you sell in other currencies.
Number of conditions: You can add any number of conditions, including none.
Combining multiple conditions: Select AND (all conditions must be met) or OR (any condition can be met).
Product and collection limit: You can select up to 50 products and up to 50 collections. To include 51 or more products, or to target products by product tag, create a collection of those products and select "Specific collection". To target by product tag, create an automated collection that uses the tag as a condition.
When customer information is unavailable for post-order distribution: Customer tag, customer metafield, customer total order count, and customer total spent conditions are not met.
How purchase types are handled: Products on purchase options without recurring delivery, such as pre-orders, are treated as one-time purchases.
Required permission: The first time you use "Purchase types to include", you must allow the "Read purchase options" permission. This permission is used only to read purchase options on products.