> For the complete documentation index, see [llms.txt](https://docs.getpurpledot.com/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.getpurpledot.com/docs/shopify-stores/pre-order-tracking/triplewhale-integration.md).
# TripleWhale integration
{% hint style="info" %}
This guide applies only when selling pre-orders through Purple Dot's own checkout. Pre-orders sold through the Shopify checkout benefit from the same tracking as your regular sales.
{% endhint %}
If you have enabled TripleWhale tracking on the Integration settings page in the [Merchant Portal](https://www.purpledotprice.com/merchant-portal/integration), the Purple Dot checkout automatically maps mid-funnel milestones (such as starting a checkout) and final purchase actions to Triple Whale via the [Data-In API](https://kb.triplewhale.com/en/articles/10371684-understanding-triple-whale-s-data-in-feature), ensuring that your preorder revenue and funnel conversions are attributed to the correct marketing channels.
### What you need before you start
* A **Triple Whale account** active and connected to your Shopify store.
* The **Triple Pixel** installed and actively tracking your storefront browser sessions.
* [Shopify App Store](https://apps.shopify.com/triplewhale-1?st_source=autocomplete\&surface_detail=autocomplete_apps)
* **Admin / Developer access** to your Triple Whale dashboard to generate API keys.
### Step 1 - Generate an API Key in Triple Whale
* [Triple Whale - Creating and Managing API Keys](https://kb.triplewhale.com/en/articles/8116412-creating-and-managing-api-keys)
Triple Whale secures data ingestion via scoped API Keys. You must generate a key that specifically allows Purple Dot to write order details to your account.
1. Log into your **Triple Whale Dashboard**.
2. Navigate to **Data** → **APIs**.
3. Click **Generate** to create a new API Key.
4. Fill in the configuration details:
* **Description:** Enter `Purple Dot Integration`.
* **Required Scopes:** Select **`Orders: Write`**
5. Click **Generate API Key**.
6. **Copy the API Key immediately** and store it securely. Triple Whale will only show this full string once.
### Step 2 - Add Credentials in Purple Dot
Fetch your store domain as configured in Triple Whale
1. Log into the **Triple Whale dashboard**
2. Go to **Settings → Store**
3. Copy the **domain** on the store details
1. Log in to the **Purple Dot merchant portal**.
2. Go to **Settings → Integrations**.
3. Under **Analytics**, click **Connect** for **Triple Whale**.
4. In the Triple Whale connection modal, enter:
| Field | Value |
| --------------- | ------------------------------------------------- |
| **API Key** | Paste the secure API Key generated in **Step 1**. |
| **Shop Domain** | Enter your permanent Shopify domain. |
**This must match the domain configured in TripleWhale**. |
1. Click **Save**.
Once the connection is saved, Purple Dot passes events automatically when checkout milestones are triggered:
| Purple Dot action | Triple Whale Data-In Layer | Expected Processing Speed |
| --------------------------------- | ----------------------------------------------------------- | -------------------------- |
| **Initiate Checkout** | Data Enrichment for Pixel Attribution (`initiate_checkout`) | Appears inside \~5 minutes |
| **Add Payment Info** | Data Enrichment for Pixel Attribution (`add_payment_info`) | Appears inside \~5 minutes |
| **Pre-order Created / Completed** | Custom Sales Platform Ingestion (`/data-in/orders`) | Appears inside \~5 minutes |
### Step 3 - Verify the Connection & Test Events
Because Triple Whale processes server-side API entries dynamically, incoming events do not stream into a real-time visual "sandbox console." Instead, you can verify your integration using built-in account diagnostic tools.
#### Option A - Check the Custom Account Health Page (Quick Check)
Triple Whale offers a live tracker showing exactly when data packets last arrived.
1. Complete a test checkout flow using your Purple Dot embedded checkout.
2. Inside Triple Whale, navigate to your **Custom Account Health** page.
3. Check the **Orders API** and **Pixel** sections. If the connection is successful, the card will instantly update from *"Not Installed"* to showing the total event count received in the last 24 hours, alongside a **"Last order received: Just Now"** timestamp.
#### Option B - Run a Diagnostic Query in the SQL Editor (Deep Dive)
To confirm that your checkout events (`initiate_checkout`) and final pre-orders are passing the exact customer fields and metadata fields correctly:
1. Go to the **SQL Editor** tab inside your Triple Whale dashboard.
2. Run a simple query to see the most recent incoming records:
```sql
SELECT * FROM orders_table
WHERE event_date = CURRENT_DATE()
ORDER BY created_at DESC
LIMIT 5
```
### Excluding Released Orders from Triple Whale (Preventing Double Counting)
A **Purchase** event is recorded in Triple Whale the exact moment a shopper completes a pre-order via the Purple Dot checkout. Later, when you officially release that pre-order for fulfillment, Purple Dot automatically creates a corresponding order inside Shopify.
Because Triple Whale automatically ingests all new Shopify orders, **this will lead to double-counting your revenue** if it isn't filtered out.
To resolve this and keep your financial data accurate, you must configure a Global Filter in Triple Whale to ignore these released Shopify orders:
* [Triple Whale Global Filters](https://kb.triplewhale.com/en/articles/11386505-global-filters)
#### How to Configure the Global Filter
1. Log into your **Triple Whale** dashboard.
2. Navigate to **Settings** (gear icon) > **Integrations** > **Shopify**.
3. Locate the **Order Filters** or **Global Exclusions** section.
4. Add a new filter rule based on your Purple Dot tags:
* **Filter Type:** Order Tag
* **Condition:** Contains
* **Value:** `purple dot`
5. Click **Save Changes**.
> ⚠️ **Important:** Once this filter is applied, Triple Whale will continue to count the original pre-order revenue captured by Purple Dot on day one, but it will safely ignore the secondary fulfillment duplicate order generated later by Shopify.