In RuffRuff Order Bonus, Gift settings define the gift product and distribution method by channel when the active dates and eligibility conditions are met.
There are 3 gift types. The settings that follow depend on the selected type.
Type | Overview |
|---|---|
Simple gift | Distributes a predefined gift product. |
Choice gift | Customers choose a gift from multiple options. |
Repeatable gift | Distributes gifts repeatedly based on purchase amount or quantity. |
Prerequisite: When you create a gift campaign, the app automatically creates a gift bundle product. The gift product name and component products are applied to the bundle product.
Post-order distribution adds the gift component products after the order is created, without adding the gift to the cart.
To distribute gifts through channels other than the Online Store, select “Add channel” and add the channel as follows.
Listed channels: Select “Draft Orders,” “Point of Sale,” or “Subscription apps.”
Other channels: Select “Other channel.” Enter any display name. For the identifier, enter the value shown in parentheses in the “Post-order gift” block on an eligible order.
Prerequisite: Post-order distribution requires additional permissions and automation to be enabled. Open RuffRuff Order Bonus admin → Settings → Automation. Grant the additional permissions, then enable “Distribute gifts after the order.”
Supported gifts: Post-order distribution supports Simple gifts and Repeatable gifts priced at 0.
Automation settings: “Distribute gifts after the order” and “Recover gifts missing from online store orders” are separate settings. Enable or disable each one independently.
Distributes 1 predefined gift.
The available settings are shown below.
Field | Description |
|---|---|
Gift product title | Set the title of the gift bundle product. You can edit it on the product page after creation. |
Components | Set the products and quantities to distribute. You can specify multiple products. |
Distribution method by channel | Set the channels that receive the gift and whether it is distributed in the cart or after the order. |
The available distribution methods for each channel are shown below.
Channel | Distribution method | Details |
|---|---|---|
Online Store | Use settings page configuration | Follows “Automatically add gift to cart” under Settings → Online store (Theme Extensions). |
Online Store | Automatic | Adds the gift to the cart automatically when the conditions are met. |
Online Store | Manual | When the conditions are met, customers add the gift to the cart from the widget button. |
Online Store | After the order | Adds the component products after the order is created, without adding the gift to the cart. |
Added channel | After the order | Adds the component products after an order is created through the selected channel. |
If you remove the Online Store from the list, the campaign will not apply to online store orders.
Customers choose a gift from multiple options.
The available settings are shown below.
Field | Description |
|---|---|
Gift product title | Set the title of the gift bundle product. You can edit it on the product page after creation. |
Variants | Set the gift options. You can assign component products and quantities to each variant. |
Number of selectable variants | Set the maximum number of options a customer can select. Enter at least 1 and no more than the number of configured variants. |
Gift selection trigger | Choose how the gift selection popup opens. |
The available ways to start gift selection are shown below.
Selection trigger | Details |
|---|---|
Manual | When the conditions are met, customers open the popup from the widget button. |
Automatic | The popup opens automatically when the conditions are met. |
Limitation: Choice gifts do not have “Distribution method by channel” settings. They do not support post-order distribution or channels other than the Online Store.
Distributes a gift each time the purchase amount or quantity reaches the configured threshold. Use it for offers such as “1 gift for every 3 items” or “1 gift for every ¥5,000.”
The available settings are shown below.
Field | Description |
|---|---|
Gift product title | Set the title of the gift bundle product. You can edit it on the product page after creation. |
Components | Set the products and quantities to distribute. You can specify multiple products. |
Repeat by | Select “Item quantity” or “Subtotal price” as the repeat unit. |
Applies to | Select “All products,” “Specific collections,” or “Specific products” for the repeat calculation. |
Maximum gift quantity | Set the maximum number of gifts to distribute. Leave this field blank for no limit. |
Distribution method by channel | Set the distribution method for the Online Store and each added channel. |
The available distribution methods for each channel are shown below.
Channel | Distribution method | Details |
|---|---|---|
Online Store | Automatic | Adds the gift to the cart automatically when the conditions are met. |
Online Store | After the order | Adds the component products after the order is created, without adding the gift to the cart. |
Added channel | After the order | Adds the component products after an order is created through the selected channel. |
If you remove the Online Store from the list, the campaign will not apply to online store orders.
The settings for each repeat unit are shown below.
Repeat by | Settings |
|---|---|
Item quantity | Distributes 1 gift for every specified number of eligible items purchased. Example: 1 gift for every 3 items. |
Subtotal price | Distributes 1 gift each time the eligible product subtotal reaches the specified amount. Example: 1 gift for every ¥5,000. |
When “Subtotal price” is selected under “Repeat by,” you can also set the calculation basis to “Before product discounts” or “After product discounts.”
Edit the gift product name or image: Edit the gift product page after creation.
Component product inventory: If a component product is out of stock or otherwise unavailable for purchase, the gift product also becomes unavailable.