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

# Triple Whale

> Connect Triple Whale for ecommerce attribution and analytics.

## What is Triple Whale?

Triple Whale is an ecommerce analytics and attribution platform that helps businesses understand their data and make informed decisions.

## Official Documentation

For more detailed information, visit the [Triple Whale Website](https://www.triplewhale.com/) or the [Triple Whale API Documentation](https://triplewhale.readme.io/).

## Key Benefits of Triplewhale Integration

Triple Whale provides comprehensive analytics and attribution insights to optimize your e-commerce strategies.

* **Analytics**: Gain insights into your e-commerce performance.
* **Attribution**: Understand the impact of your marketing efforts.
* **Data Visualization**: Visualize your data with intuitive dashboards.
* **Scalability**: Easily scale your analytics as your business grows.

## What the agent can do with Triple Whale

Once you connect Triple Whale as an integration (add your API key and shop domain under **Integrations**), Replo's agent can query your Triple Whale data directly through the [Data-Out API](https://triplewhale.readme.io/reference/data-out-api-use-cases). Your shop domain is stored on the connection, so you only ever give the agent a date range or a question.

* **Summary page metrics** — top-line KPIs (blended and per-channel spend, revenue, ROAS, MER, orders, AOV) over a date range, with current-vs-previous comparisons and time series. Ask things like "what was my blended ROAS last week?"
* **Customer-journey attribution** — every order in a range with its touchpoints and first-touch, last-touch, and linear attributed clicks. Ask "which channels drove orders in June?"
* **Custom SQL** — for anything the aggregated views can't express, the agent can run read-only SQL against your Triple Whale data warehouse (custom breakdowns, cohorts, joins). Ask "break down spend by campaign and day for the last 30 days."
* **Compliance data deletion** — submit a GDPR/CCPA request to delete or mask a customer's PII by email and/or phone. This is a **mutating, irreversible** action, so the agent confirms the exact identifiers with you before submitting. Your API key must have the **Compliance: Write** scope (see [Which scopes to enable](#which-scopes-to-enable)).

## Connect the Triple Whale integration

Connecting Triple Whale as an integration is what lets Replo's agent query your data (see [What the agent can do](#what-the-agent-can-do-with-triple-whale) above). Triple Whale connects with an **API key** and your **shop domain** — there's no OAuth sign-in.

<Steps>
  <Step title="Open the Integrations app">
    In Replo, open the [Integrations app](/apps/integrations) and find **Triple
    Whale**.
  </Step>

  <Step title="Enter your API key and shop domain">
    Click **Connect**, then paste your **API Key** and enter your **Shop
    Domain** — the `myshopify.com` store Triple Whale tracks (for example,
    `example.myshopify.com`). The shop domain is stored on the connection, so
    the agent never needs it again.
  </Step>
</Steps>

### Finding your API key

1. Log in to your Triple Whale account.
2. Go to **Data → APIs** and click **Generate** (older accounts: **Settings → API Keys**).
3. Add a description, then **select scopes** — see [Which scopes to enable](#which-scopes-to-enable) below.
4. Click **Generate** and copy the key immediately. Triple Whale only shows it once.

### Which scopes to enable

A Triple Whale API key is scoped to specific endpoints, so the key you create must include a scope for each capability you want the agent to use. Enable these:

| Scope                       | What it lets the agent do                                                                                           | Do you need it?                                                    |
| --------------------------- | ------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------ |
| **Summary Page: Read**      | Read your top-line metrics — blended and per-channel spend, revenue, ROAS, MER, orders, and AOV — over a date range | **Yes** — core analytics                                           |
| **Pixel Attribution: Read** | See which channels and campaigns drove your orders, with full customer-journey attribution                          | **Yes** — attribution                                              |
| **Data Out**                | Answer custom, deeper analytics questions that go beyond the standard metrics above                                 | **Yes** — advanced breakdowns                                      |
| **Compliance: Write**       | Submit GDPR/CCPA requests to delete or mask a customer's data                                                       | **Optional** — only if you want the agent to handle data deletions |

For full analytics coverage, enable **Summary Page: Read**, **Pixel Attribution: Read**, and **Data Out**. Add **Compliance: Write** only if you want the agent to handle GDPR/CCPA deletions.

You don't need Triple Whale's other scopes. The write scopes (**Ads**, **Orders**, **Customers**, **Products**, **PPS**, **Subscriptions**) are for pushing data *into* Triple Whale, and **MCP: Read** is for Triple Whale's own MCP server — Replo uses none of them, so leave them unchecked.

<Note>
  If a scope is missing, that capability stops working and Triple Whale returns a
  "missing scope" authorization error. Scopes can't be added to an existing key,
  so to fix it, generate a new key with the right scopes checked and re-enter it in
  the integration. Advanced breakdowns rely on Triple Whale's **Data Out** scope; if
  it isn't offered when you generate a key, reach out to Triple Whale, since that
  access can be plan-gated.
</Note>

## Add the Triple Whale pixel

Triple Whale's "Triple Pixel" is related to the integration, but you don't need the integration in order to install it: it's just a **headless tracking snippet** that runs on your published site to track the customer journey across ad channels. Install it from the Website Builder's **Scripts & Pixels** settings.

<Steps>
  <Step title="Copy your tracking snippet from Triple Whale">
    In Triple Whale, open **Pixel Settings → Headless Installation** and copy
    the base tracking snippet.
  </Step>

  <Step title="Open Scripts & Pixels in the Website Builder">
    In the [Website Builder](/apps/website-builder), open **Site settings** and
    go to the **Scripts & Pixels** tab.
  </Step>

  <Step title="Add Triple Whale and paste the snippet">
    Find **Triple Whale**, paste the snippet into the **Headless tracking
    snippet** field, and save.
  </Step>
</Steps>

Attribution starts on every page once you publish. See [Adding Scripts](/features/scripts) for more on site-wide pixels.