
=== Coupon ROI Tracker for WooCommerce ===
Contributors:       narolainfotech, roshanrathod0137 , ankit17
Tags:               woocommerce, coupons, roi, analytics, revenue, discount
Requires at least:  5.8
Tested up to:       7.0
Requires PHP:       7.4
Stable tag:         1.1
License:            GPL-2.0+
License URI:        https://www.gnu.org/licenses/gpl-2.0.html

Find out whether your WooCommerce coupons generate real revenue or just
discount orders from customers who were buying anyway.

== Description ==

Every WooCommerce store can see how many times a coupon was used and how
much discount was given. What none of the built in reports tell you is
**whether the coupon actually caused the sale**.

Coupon ROI Tracker answers the one question that matters:

> "Did SAVE10 bring in new customers, or did I just hand money back to
> people who were already going to buy?"

**How it works**

When an order is completed, the plugin checks whether this is the
customer's first ever order. First-time buyers are attributed to the
coupon the discount they received is the acquisition cost. Repeat
buyers who used a coupon are flagged as "wasteful spend" because they
would likely have purchased at full price.

**What you get**

* True ROI % per coupon (new customer revenue vs total discount cost)
* New customer acquisition rate per coupon
* Wasteful discount amount (money spent on repeat buyers)
* Plain-English verdict: Profitable / Break Even / Wasteful
* Date-range filtering
* CSV export for spreadsheet analysis

== Installation ==

1. Upload the plugin folder to /wp-content/plugins/.
2. Activate the plugin through the Plugins menu.
3. Navigate to WooCommerce → Coupon ROI to see your report.

New orders will be tracked automatically from the moment you activate
the plugin. Historical orders are not back-filled (they don't contain
the first-order data needed for accurate attribution).

== Frequently Asked Questions ==

= Does it track guest orders? =
Yes. Guest customers are identified by billing email address.

= What counts as a "first order"? =
Any completed or processing order in WooCommerce with a different order ID
than the current one. Both logged-in users and guests are matched.

= Will it slow down my checkout? =
No. All tracking happens after the order status changes asynchronously.

= Can I export the data? =
Yes. Use the Export CSV button in the report header.

== Changelog ==

= 1.1 =
* Initial release.

== Upgrade Notice ==

= 1.1 =
Initial release.
