This guide walks you through the initial setup for distributing gifts with RuffRuff Order Bonus.
To distribute gifts in the cart: Start with Step 1 on this page.
To distribute gifts after an order: Follow the steps in Distribute gifts after the order.
Enable the app embed to add gifts to the cart and display widgets or product messages.
(1) Open the theme editor from the setup guide
In Shopify admin, go to Apps and open "RuffRuff Order Bonus."
In the setup guide, under "Enable app embed in your live theme," select "Enable app."
(2) Save the app embed
In "App embeds" in the theme editor, enable "RuffRuff Order Bonus," then select "Save."
(1) Open the theme editor for the applicable theme
In Shopify admin, go to Online Store → Themes, then select "Customize" for the applicable theme.
(2) Enable and save the app embed
Under "App embeds," enable "RuffRuff Order Bonus," then select "Save."
Create a campaign from "Gifts" in the app, then configure its overview, active dates, eligibility conditions, and gift.
(1) Open the campaign creation page
Open "Gifts" in the left menu, then select "Create campaign."
(2) Configure the campaign
Configure the following fields.
Campaign overview: Set an internal campaign name.
Active dates: Set the start date and time. The end date and time are optional.
Eligibility conditions: Set the conditions for distributing gifts. If you set no conditions, all customers are eligible.
Gift: Set the gift type (Simple gift, Choice gift, or Repeatable gift) and its component products.
Distribution method by channel: For Simple gifts and Repeatable gifts, select the channels and distribution methods. If you remove Online Store, the campaign does not apply to online store orders.
Restrictions: Set rules to prevent gifts from being distributed outside the conditions or above the allowed quantity.
Display settings: Choose whether to display the widget and product messages on the online store.
Caution: A bundle product for the gift is created automatically when you create the campaign. The cart button is hidden on the gift product page so customers cannot purchase the product directly.
(3) Save the campaign
When you finish configuring the campaign, select "Save." You can edit each field after saving.
When the status is "Active," gifts are distributed during the configured active dates when the conditions are met.
Prerequisite: You need a paid plan to activate a campaign. Before you subscribe, the campaign is saved as Draft.
(1) Activate the campaign
Select "Activate," then select "Save."
While the campaign is "Active" and within its active dates, check the following behavior.
Confirm that the app embed is enabled.
With a cart that meets the conditions, confirm that the gift is added automatically or that the customer can select and claim it.
Confirm the global setting and the applicable channels.
In the details of an order that meets the conditions, confirm that the gift was added.
You can check processing details in the "Post-order gift" block.
For post-order distribution, the gift is not added to the cart.
For troubleshooting steps, see Gift Not Being Distributed.