Key principle

Sales are attributed to one giveaway.

To avoid confusion, it's best to keep only one active giveaway at a time.

Precedence for attribution

When a Shopify order webhook arrives, Giveaway Ninja selects the target giveaway using this workflow:

1. Creates a list of all active, non-expired giveaways
2. Attempts to locate the user by matching the order email with the giveaway email
3. The sale is attributed to the first matched giveaway
4. If no user is found, the app will select the most recent active giveaway with AUTO SIGN-UP enabled

Order processing flow

1. Order placed in Shopify.
2. Webhook received by Giveaway Ninja.
3. Giveaway selected using the precedence above.
4. Purchase Rules evaluated and applied (entries per amount spent, product/variant rules, date boosters, etc.).
5. Klaviyo event fired (optional): if Advanced Klaviyo Integration is configured on the "Make a Purchase" entry action, an event is sent to Klaviyo, where you can set up a Flow using a metric trigger. The event name can be configured in the "Make a Purchase action"; the default name is "Giveaway Ninja Order Entries".
   
   Please note that you need to send at least one event to Klaviyo to view its JSON payload and structure. This can be done by sending a test event when you configure Klaviyo or the "Make a Purchase" action.