TripleWhale integration

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.

If you have enabled TripleWhale tracking on the Integration settings page in the Merchant Portal, 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, 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

• 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

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:

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

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.