> ## Documentation Index
> Fetch the complete documentation index at: https://docs.nova.galaxa.in/llms.txt
> Use this file to discover all available pages before exploring further.

# Shopify Revenue Attribution & Contact Provenance

> How Galaxa Nova tracks every dollar of GMV generated by WhatsApp broadcasts, agent interactions, and customer contact provenance.

# Shopify Revenue Attribution & Contact Provenance

Most marketing and chat tools only report operational vanity metrics like *"Messages Delivered"* or *"Open Rates"*, leaving merchants unable to measure the actual revenue impact of their conversations.

**Galaxa Nova provides native, commerce-first revenue attribution down to the individual customer touchpoint.**

Every WhatsApp broadcast, conversational interaction, post-purchase drip, and abandoned cart recovery nudge is linked directly to completed Shopify orders, acquisition provenance, and gross merchandise value (GMV).

***

## The 72-Hour Attribution Model

```mermaid theme={null}
flowchart LR
    A["Customer Visits Store or Receives Broadcast"] --> B["First Touchpoint & Initial Intent Captured"]
    B --> C["Shopper Interacts with Nova AI or WhatsApp"]
    C --> D["Customer Completes Purchase on Shopify"]
    D --> E["Nova Reconciles Order ID & Amount (< 72h Window)"]
    E --> F["Attributed GMV Logged in Contacts Directory & Analytics"]
```

***

## 1. Customer Contact Provenance

When shoppers interact with Galaxa Nova on your storefront or via WhatsApp, Nova automatically captures comprehensive provenance metadata:

* **Acquisition Touchpoint:** The specific landing page or product URL where the customer first encountered Nova (e.g. `/products/zeb-juke-bar-9900` or `/collections/wireless-earbuds`).
* **First Seen URL:** Full referrer and URL query strings, preserving UTM campaign parameters (`utm_source`, `utm_medium`, `utm_campaign`).
* **Initial Intent:** Semantic classification of the shopper's very first inquiry (e.g. *Product Specification*, *Sizing & Fit*, *Delivery Time*, *Price Inquiry*).
* **Channel:** The primary medium of conversation (`shopify_web`, `whatsapp`, `instagram`).

This provenance enables merchants to identify exactly which high-intent product pages drive the highest conversion volume when paired with conversational assistance.

***

## 2. Deterministic GMV Reconciliation

Nova maps orders from `shopify_attributed_orders` directly to conversation traces using unique session keys:

1. **Order Matching:** When a Shopify order webhook arrives, Nova checks for active conversation sessions within the 72-hour window matching the customer's phone number or checkout session token.
2. **Lifetime Attributed Revenue:** Nova aggregates the total gross merchandise value across all converted orders for that contact, establishing the customer's **Lifetime Attributed GMV**.
3. **Transparent Order History:** Every attributed order number, item total, and conversion timestamp is recorded directly on the contact's record.

***

## 3. Merchant Dashboard Contacts Directory

The **Contacts** view in the [Merchant Dashboard](https://nova.galaxa.in/dashboard.html) provides an 8-column table with full provenance and revenue transparency:

| Column | Description |
| :- | :- |
| **Customer / Phone** | Customer name, verified WhatsApp number, and avatar |
| **Channel** | Originating channel badge (`WhatsApp`, `Shopify Web`, `Instagram`) |
| **Acquisition Touchpoint** | First product or page visited (e.g. `/products/zeb-juke-bar-9900`) |
| **Initial Intent** | Primary category of the customer's first question |
| **Messages** | Total message exchanges between the customer and Nova AI |
| **Attributed GMV** | Formatted INR revenue badge (`₹8,999` in emerald; `₹0` in muted gray) |
| **Status** | Resolution status (`Resolved`, `Pending`, `Escalated`) |
| **Last Active** | Relative timestamp of the customer's most recent interaction |

***

## 4. 1-Click CSV & JSON Data Export

Merchants can export their customer directory at any time:

* **Export CSV:** Downloads `nova_customers_YYYY-MM-DD.csv` with formatted headers, including phone, name, channel, acquisition touchpoint, initial intent, message count, attributed GMV, order count, and last active date.
* **Export JSON:** Generates machine-readable structured JSON including full order arrays and nested provenance metadata for easy ingestion into custom ERPs or external BI tools.

***

## 5. Multi-Channel Revenue Separation & True ROAS

The Nova Dashboard clearly segments where your revenue originated:

* **Broadcast Revenue:** GMV generated from targeted outbound WhatsApp marketing campaigns.
* **Conversational Agent Revenue:** GMV generated when a shopper interacted with the autonomous storefront agent before purchasing.
* **Post-Purchase Drip Revenue:** GMV generated from repeat purchases driven by post-purchase lifecycle sequences.
* **Automated Recovery Revenue:** GMV generated by abandoned cart recovery and COD confirmation triggers.

Because Nova tracks your exact Meta WhatsApp message costs at raw wholesale rates, the dashboard computes your true **Campaign ROAS**:

$\text{ROAS} = \frac{\text{Attributed Shopify GMV (₹)}}{\text{Meta WhatsApp Message Cost (₹)}}$

This enables growth marketers to instantly determine which customer cohorts and templates generate the highest profit margins.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.