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

# Triple Whale source

> Connect Triple Whale to Chartcastr for automated e-commerce metrics charts. Track Blended ROAS, MER, total sales, ad spend, CAC, and AOV delivered to Slack or email.

## Overview

Use Triple Whale as a data source for Chartcastr. Connect your Triple Whale account with an **API key** and Chartcastr will pull Summary Dashboard metrics — Blended ROAS, New Customer ROAS, MER, total and net sales, ad spend, gross profit, contribution margin, CAC, NCPA, AOV, orders, new customers, and more — to generate charts delivered automatically to Slack or email.

Triple Whale is the leading DTC e-commerce analytics and attribution platform. Chartcastr connects with read-only access via Triple Whale's API (`x-api-key`) — no pixel changes required.

<Note>
  Triple Whale is available on Chartcastr's **paid plans**. Free plans can forward a single **Total Sales** metric (delivered without AI analysis).
</Note>

## Setup

<Steps>
  <Step title="Generate a Triple Whale API key">
    Open your [Triple Whale API keys page](https://app.triplewhale.com/api-keys) and click **Generate**. Give the key a description and grant the **Summary Page: Read** scope (Chartcastr only reads summary metrics). Copy the key.
  </Step>

  <Step title="Find your shop domain">
    Your shop domain is the Shopify domain Triple Whale is scoped to (e.g. `example.myshopify.com`). You can find it in your [Triple Whale store settings](https://app.triplewhale.com/store-settings/general).
  </Step>

  <Step title="Connect in Chartcastr">
    In Chartcastr, go to **Admin → Settings → Source Integrations**, find **Triple Whale**, click **Connect**, and paste your API key plus your shop domain. Chartcastr validates the key before saving it (encrypted at rest).
  </Step>

  <Step title="Select a metric">
    Choose which metric to track. Each metric becomes its own source. You can add multiple sources to send different charts on different schedules.
  </Step>

  <Step title="Create a connection">
    Pick or add a destination (Slack channel or email), set the delivery frequency, and optionally enable AI summaries.
  </Step>
</Steps>

## Available Metrics

Chartcastr supports **18 pre-built Triple Whale metrics** across three categories.

<CardGroup cols={2}>
  <Card title="Performance" icon="chart-line">
    Total Sales, Blended ROAS, Triple Whale (Pixel) ROAS, New Customer ROAS, MER, Net Sales, Ad Spend, Gross Profit, and Contribution Margin.
  </Card>

  <Card title="Customers" icon="users">
    Orders, New Customers, CAC, NCPA, Average Order Value, Customer Lifetime Value, Store Conversion Rate, and Repeat Purchase Rate.
  </Card>

  <Card title="Overview" icon="chart-mixed">
    Ad Spend vs Total Sales — a dual-axis view of daily spend against revenue.
  </Card>
</CardGroup>

<Card title="View all available charts" icon="list" href="/integrations/sources/triple-whale/available-charts">
  See the full list of Triple Whale metrics with chart types and descriptions.
</Card>

## Next Steps

<CardGroup cols={2}>
  <Card title="Slack destination" icon="slack" href="/integrations/destinations/slack">
    Deliver Triple Whale charts to your Slack channels with AI summaries in the thread.
  </Card>

  <Card title="Email destination" icon="envelope" href="/integrations/destinations/email">
    Schedule Triple Whale e-commerce reports to any inbox or distribution list.
  </Card>
</CardGroup>