RuffRuff Order Bonus

thumbnail

Eligibility Conditions (Gift Campaign)

Learn how to narrow down who receives a gift and how each condition works.

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.