# BigQuery Setup
Source: https://support.detrics.io/bigquery/bigquery-setup

Create a destination and connect Detrics to your BigQuery project

<Info>**Last updated:** May 18, 2026</Info>

A **destination** is your BigQuery connection, it tells Detrics which GCP project and dataset to write data to. You set it up once, then create as many transfers as you need pointing to it.

<Note>
  Detrics offers two setup modes, chosen on the first screen of destination creation. **This guide covers Standard Setup**, it grants Detrics the **BigQuery User** role at the project level and is the simplest path for most teams. Security-critical organizations and shared GCP projects can instead use **[Least-Privilege Access](/bigquery/least-privilege-access)**, which scopes Detrics to a single dataset and prevents it from seeing anything else in your project, see that guide for its extra steps. The setup mode **can't be changed** after the destination is created.
</Note>

## Prerequisites

Before creating a destination, you need:

* A Google Cloud Platform (GCP) account
* A GCP project with the **BigQuery API** enabled
* Permission to manage IAM roles in the project (to grant Detrics access)

If you don't have a GCP project yet, create one at [console.cloud.google.com](https://console.cloud.google.com). BigQuery is automatically available in every GCP project, just make sure the BigQuery API is enabled in **APIs & Services**.

## Creating a Destination

1. In the Detrics web app, go to [**Data Warehouse → Destinations**](https://app.detrics.io/data-warehouse/destinations)
2. Click [**New Destination**](https://app.detrics.io/data-warehouse/destinations/new)
3. Fill in the details:

### Destination Name

A label for your reference (e.g., "Production Warehouse", "Client Analytics", "Dev/Testing"). This is only visible in Detrics, not in BigQuery.

### GCP Project ID

The project ID from your Google Cloud Console. You can find this on the [GCP Dashboard](https://console.cloud.google.com/home/dashboard) or in the project selector dropdown. It looks like `my-company-analytics` or `project-id-123456`.

<Note>
  Use the **Project ID**, not the Project Name or Project Number. The Project ID is the lowercase identifier, usually visible under the project name in the GCP console.
</Note>

### Dataset Name

The BigQuery dataset where Detrics will create tables. Use lowercase letters, numbers, and underscores (e.g., `marketing_data`, `warehouse_prod`).

If the dataset doesn't exist, Detrics will create it automatically. If it already exists, Detrics will add tables to it, existing tables are not affected.

### Data Location

The geographic region where your data is physically stored. This is permanent and cannot be changed after the dataset is created.

| Location                              | Type          | Description                                 |
| ------------------------------------- | ------------- | ------------------------------------------- |
| `US`                                  | Multi-region  | Data stored across multiple US data centers |
| `EU`                                  | Multi-region  | Data stored across multiple EU data centers |
| `us-east1`, `us-central1`, etc.       | Single region | Data stored in a specific US region         |
| `europe-west1`, `europe-west2`, etc.  | Single region | Data stored in a specific EU region         |
| `asia-east1`, `asia-southeast1`, etc. | Single region | Data stored in a specific Asia region       |

<Tip>
  For most users, **US** or **EU** multi-region is the best choice. Multi-region gives you higher availability and doesn't restrict which regions can query the data. Choose a specific region only if you have data residency requirements.
</Tip>

### Timezone

The timezone used by all transfers on this destination. The timezone is used for:

* Interpreting schedule times (e.g., "6:00 AM" in which timezone)
* Date boundary calculations

## Granting Access to Detrics

After creating the destination, Detrics displays a **service account email** that needs access to your GCP project. This service account is what Detrics uses to create datasets, tables, and load data.

### Required IAM Roles

Grant the Detrics service account these two roles:

| Role              | Purpose                                                                        |
| ----------------- | ------------------------------------------------------------------------------ |
| **BigQuery User** | Create datasets, create tables, insert data, run queries, and manage load jobs |

### How to Grant Access

1. Go to [Google Cloud Console → IAM & Admin → IAM](https://console.cloud.google.com/iam-admin/iam)
2. Make sure you've selected the correct project in the top dropdown
3. Click **Grant Access**
4. In the **New principals** field, paste the Detrics service account email shown on your destination page
5. In the **Select a role** dropdown, search for and select **BigQuery User**
6. Click **Save**

<Tip>
  For security-conscious organizations or shared GCP projects, see [Least-Privilege Access](/bigquery/least-privilege-access) for a setup that scopes Detrics to a single dataset and prevents it from seeing any other data in your project.
</Tip>

### Sending Instructions to a Teammate

If you don't have GCP admin access, click **Send Instructions** on the destination page. This generates an email with:

* The exact service account email to add
* Step-by-step instructions for granting access
* The specific roles needed

You can send this to your GCP administrator or DevOps team.

## Testing the Connection

After granting access, test the connection:

1. Go to your destination's detail page
2. Click **Test Connection**
3. Detrics runs a series of checks:
   * **Can access the project**: Verifies the service account has basic access
   * **Can create a dataset**: Checks dataset creation permissions (or verifies the existing dataset)
   * **Can create tables**: Verifies table creation within the dataset
   * **Can insert data**: Confirms data loading works
   * **Can query data**: Validates read access

If any check fails, you'll see a specific error message. The most common issue is missing IAM roles, see [Troubleshooting](/bigquery/troubleshooting) for solutions.

Once the test passes, your destination is ready. The status badge changes to **Connected**.

## Managing Destinations

### Editing a Destination

You can update the destination's name and timezone at any time. The GCP project ID, dataset name, and data location cannot be changed after creation (these are BigQuery constraints).

### Multiple Destinations

You can create multiple destinations for different purposes:

* **Production vs. staging**: Test changes in a staging dataset before pointing transfers at production
* **Regional separation**: Keep EU client data in an EU dataset and US client data in a US dataset
* **Team separation**: Different teams or departments with their own datasets

### Sharing a Destination

You can share a destination with other members of your Detrics workspace. Shared users can create transfers using the destination but cannot modify the destination settings. Go to the destination detail page and click **Share** to manage access.

### Deleting a Destination

Deleting a destination in Detrics does **not** delete the BigQuery dataset or any data. It only removes the connection from Detrics. Any transfers using the destination will stop syncing.


# Chunking
Source: https://support.detrics.io/bigquery/chunking

How Detrics splits large syncs into smaller pieces to avoid timeouts and preserve progress

<Info>**Last updated:** May 14, 2026</Info>

When a sync would be too large to fetch in a single API call, many accounts, long date ranges, or detailed entity levels like individual ads, Detrics automatically splits it into smaller pieces called **chunks**. Each chunk fetches a subset of the data, persists it to BigQuery as soon as it finishes, and then the next chunk starts.

This is purely an execution detail. Your BigQuery tables end up with exactly the same data either way; chunking just changes how Detrics gets there.

## Why Chunking Exists

Marketing platforms impose limits on how much data a single API request can return, and even when they don't, very large requests are slow and fragile. Without chunking, a single timeout or transient error would lose the entire sync's progress.

Chunking solves three problems at once:

* **Timeouts**: Each chunk runs in its own request, well under the platform's time limits
* **Memory**: Detrics never holds an entire historical backfill in memory at once
* **Recovery**: If a sync is interrupted, completed chunks are preserved; only the remaining chunks need to be retried on the next run

## How Chunks Are Split

Chunking happens along two axes:

* **Time range**: Long date ranges are split into segments (typically by calendar month)
* **Account batches**: Many accounts are processed in smaller groups

The exact chunk size depends on the platform and the **entity level** of the table. Denser data needs smaller chunks:

| Example                          | Chunk Size                          |
| -------------------------------- | ----------------------------------- |
| Meta Ads, ad-level metrics       | \~1 month × 5 accounts per chunk    |
| Meta Ads, campaign-level metrics | \~12 months × 25 accounts per chunk |
| Google Ads, keyword-level        | Smaller chunks (high cardinality)   |
| Google Ads, account summary      | Larger chunks (low cardinality)     |

If a table's data fits comfortably in a single request, for instance, a short date range with few accounts, **no chunking is performed**, and the run executes as a single fetch. This is normal and expected for small or recently-created tables.

## Chunk Order

Chunks are executed in **recent-first** order: the most recent time windows are fetched before the older ones. This means fresh data lands in BigQuery first, so even if a long initial backfill is paused or interrupted, you still have usable recent data to query.

## What You See in the UI

In the **Run History** of a transfer, each table row shows `X/Y chunks` when chunking was used (e.g., `4/4 chunks` means all 4 chunks completed successfully, `12/13 chunks` means one chunk failed or is still retrying).

If you don't see a chunk count, the table was fetched in a single request, no chunking was needed for that run.

## Chunking and Resyncs

When you trigger a manual resync or when an adaptive retry runs, Detrics replays only the chunks that didn't succeed in the original run. Successful chunks are not refetched, which keeps resyncs fast and minimizes API quota usage. See [Resync and Recovery](/bigquery/resync-and-recovery) for details.


# Column Naming
Source: https://support.detrics.io/bigquery/column-naming

How Detrics normalizes column names to snake_case across all platforms

<Info>**Last updated:** March 18, 2026</Info>

## The Problem

Every marketing platform uses its own naming convention for fields:

```
Google Ads:    campaign.name, ad_group.name, metrics.clicks
Meta Ads:      campaign_name, adset_name, clicks
GA4:           sessionSourceMedium, totalUsers
Pinterest:     CAMPAIGN_NAME, TOTAL_IMPRESSION
Shopify:       orderCount, grossSales
```

Writing SQL across platforms means constantly remembering which convention each platform uses, and dealing with dots, camelCase, and inconsistent capitalization.

## The Solution

Detrics normalizes all column names to **snake\_case** before loading data into BigQuery. This means every platform's fields follow the same convention, and you can write clean cross-platform SQL without worrying about naming differences.

## Normalization Rules

Detrics applies these rules in order:

| Rule                                  | Before            | After             |
| ------------------------------------- | ----------------- | ----------------- |
| Dots become underscores               | `campaign.name`   | `campaign_name`   |
| camelCase splits                      | `campaignName`    | `campaign_name`   |
| ALL\_CAPS lowercased                  | `CAMPAIGN_NAME`   | `campaign_name`   |
| Acronyms lowered                      | `CTR`             | `ctr`             |
| Letter-digit boundaries               | `videoViewsP25`   | `video_views_p25` |
| Consecutive underscores collapsed     | `campaign__name`  | `campaign_name`   |
| Leading/trailing underscores stripped | `_campaign_name_` | `campaign_name`   |
| Digit-leading names prefixed          | `7day_click`      | `_7day_click`     |

## Examples

### Before and After

| Platform   | Original Field                         | BigQuery Column                        |
| ---------- | -------------------------------------- | -------------------------------------- |
| Google Ads | `campaign.name`                        | `campaign_name`                        |
| Google Ads | `metrics.cost_micros`                  | `metrics_cost_micros`                  |
| Meta Ads   | `campaign_name`                        | `campaign_name`                        |
| GA4        | `sessionSourceMedium`                  | `session_source_medium`                |
| GA4        | `totalUsers`                           | `total_users`                          |
| Pinterest  | `CAMPAIGN_NAME`                        | `campaign_name`                        |
| Pinterest  | `TOTAL_IMPRESSION`                     | `total_impression`                     |
| Shopify    | `grossSales`                           | `gross_sales`                          |
| Shopify    | `orderCount`                           | `order_count`                          |
| TikTok     | `campaign_name`                        | `campaign_name`                        |
| Meta Ads   | `offsite_conversion.fb_pixel_purchase` | `offsite_conversion_fb_pixel_purchase` |

### Cross-Platform SQL

With normalized column names, cross-platform queries become straightforward:

```sql theme={null}
-- Compare spend across Meta Ads and Google Ads
SELECT
  'Meta Ads' as platform,
  campaign_name,
  SUM(spend) as total_spend
FROM `project.dataset.meta_ads_campaigns`
WHERE date >= '2026-03-01'
GROUP BY campaign_name

UNION ALL

SELECT
  'Google Ads' as platform,
  campaign_name,
  SUM(spend) as total_spend
FROM `project.dataset.google_ads_campaigns`
WHERE date >= '2026-03-01'
GROUP BY campaign_name

ORDER BY total_spend DESC
```

## System Columns

System columns added by Detrics always use the `_detrics_` prefix and are already in snake\_case:

* `_detrics_account_id`
* `_detrics_row_id`
* `_detrics_sync_id`
* `_detrics_synced_at`

These are never affected by normalization rules and are consistent across all tables.

## Type Mapping

In addition to name normalization, Detrics maps platform data types to BigQuery-native types:

| Detrics Type   | BigQuery Type |
| -------------- | ------------- |
| string         | STRING        |
| float, float64 | FLOAT64       |
| integer, int64 | INT64         |
| date           | DATE          |
| datetime       | DATETIME      |
| timestamp      | TIMESTAMP     |
| boolean        | BOOL          |
| percent        | FLOAT64       |
| currency       | FLOAT64       |
| number         | FLOAT64       |


# Connect to Claude
Source: https://support.detrics.io/bigquery/connect-to-claude

Connect your Detrics BigQuery warehouse to Claude and ask questions about all your marketing data in plain language

<Info>**Last updated:** August 10, 2026</Info>

Once your marketing data lives in BigQuery, you can connect it to **Claude** and ask questions about it in plain language. No SQL, no exports. Claude reads the real rows in your warehouse and answers across every platform, account, and country at once.

It is easy to set up, and you only do it once.

## How to connect

<Steps>
  <Step title="Create an OAuth client in Google Cloud">
    In your GCP project (with the BigQuery API enabled), go to **Google Auth Platform → Clients → Create client** and choose **Web application**.

    * Authorized JavaScript origins: `https://claude.ai`
    * Authorized redirect URI: `https://claude.ai/api/mcp/auth_callback`

    Copy the **Client ID** and **Client Secret**.
  </Step>

  <Step title="Add the BigQuery connector in Claude">
    Open Claude's connector directory, select **Google Cloud BigQuery**, and paste the Client ID and Client Secret.
  </Step>

  <Step title="Authorize and you're done">
    Sign in with a Google account that has access to your BigQuery project and approve. Claude is now connected to your warehouse and ready to answer.
  </Step>
</Steps>

That's the whole setup. From here, just ask.

## What you can do

* Ask questions in plain language across all your platforms, accounts, and countries.
* Let Claude write and run the SQL for you, then explain the result.
* Walk through multi-step analysis, where each answer builds on the last.
* Draft dashboards, reports, and summaries straight from live data.
* Investigate trends, anomalies, and "why did this change" questions in one conversation.

## Manage your warehouse from Claude

Beyond querying, Claude can now build and run your warehouse for you through the Detrics MCP server. Create destinations, build table groups, schedule and run transfers, and query your data, all in natural language.

* **Create destinations.** Set up a BigQuery destination with guided GCP setup, connection tests, and sharing.
* **Build table groups.** Create table groups and tables from pre-built presets, with safe schema updates.
* **Schedule and run transfers.** Create, pause, resume, and trigger syncs, with per-table sync settings.

<Card title="See every warehouse tool" icon="wrench" href="/claude/available-tools">
  Full reference of the MCP tools that let Claude manage your BigQuery warehouse.
</Card>

## Why this matters

### The problem with scattered data

When your numbers live across dozens of spreadsheets and platform dashboards, a few things break:

1. **No single source of truth.** The same metric shows different values depending on which file you open.
2. **Misaligned teams.** Marketing, BI, and finance each work from their own copy and reach different conclusions.
3. **Incomplete reports.** Pulling everything together by hand is slow, so reports end up partial and you lose the big picture.
4. **Slow decisions.** By the time the data is gathered and cleaned, the moment to act has passed.
5. **Unreliable AI answers.** An AI with no grounded data guesses and hallucinates, which leads to bad calls dressed up as confident ones.

### The solution: one centralized warehouse

Detrics syncs every platform and account into a single BigQuery warehouse. The data arrives normalized, deduplicated, and refreshed on the schedule you set. That gives every team and every tool one consistent, current source to work from.

### Why connecting it to Claude is powerful

A centralized warehouse is the foundation. Claude on top of it is the leverage:

* **Grounded answers.** Claude reads your actual rows, so its reasoning is anchored to real numbers instead of guesses.
* **Chain of reasoning.** It can break a hard question into steps, query each one, and combine the results into an answer you can trust.
* **Dashboards on demand.** Describe the view you want and Claude builds the query and the breakdown for you.
* **Real-time decisions.** Ask a question and get the answer now, against data that is already up to date.

### Why Detrics

The hard part is not Claude. It is getting clean, unified, current data into one place. Detrics handles the platform authentication, the API maintenance, the column normalization, the deduplication, and the scheduled refresh. Claude always queries data that is complete and trustworthy, so the answers are too.

<Card title="Set up your warehouse first" icon="database" href="/bigquery/quickstart">
  New to the Data Warehouse? Start here to get your data into BigQuery, then come back to connect Claude.
</Card>


# Creating Transfers
Source: https://support.detrics.io/bigquery/creating-transfers

Connect a table group to a destination with a schedule and start syncing data

<Info>**Last updated:** March 18, 2026</Info>

A **transfer** is the core of the Detrics Data Warehouse pipeline. It binds together:

* A **data source** (your platform connection and accounts)
* A **table group** (what data to fetch)
* A **destination** (where to put it)
* A **schedule** (when to sync)

## Creating a Transfer

1. Go to [**Data Warehouse → Transfers**](https://app.detrics.io/data-warehouse/transfers)
2. Click [**New Transfer**](https://app.detrics.io/data-warehouse/transfers/new)
3. Follow the steps below

### Step 1: Select Data Source

Choose the platform connection to use. This is the same OAuth connection you set up in Detrics for Google Sheets or Looker Studio, no need to reconnect.

### Step 2: Select Accounts

Choose which platform accounts to sync:

* **All accounts**: Syncs every account available under the connection. If new accounts are added to the connection later, they're automatically included
* **Selected accounts**: Pick specific accounts from the list

For platforms with a single account per connection (Shopify, Stripe, WooCommerce, Klaviyo, TiendaNube, HubSpot, TikTok Organic), account selection is skipped, there's only one account to sync.

<Tip>
  **All accounts** is recommended for most use cases. Each row in BigQuery includes `_detrics_account_id`, so you can always filter to specific accounts in your SQL queries. This way, new accounts are automatically picked up without modifying the transfer.
</Tip>

### Step 3: Select Table Group

Choose an existing table group or create a new one. The table group must match the platform you selected in Step 1 (e.g., a Meta Ads table group for a Meta Ads connection).

### Step 4: Choose a Sync Strategy

First, choose a **sync strategy** that sets the initial sync mode for all tables in the transfer:

| Strategy                           | What It Does                                                                                                                                                                  | Best For                                                                        |
| ---------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------- |
| **Replicate Source** (recommended) | Applies smart defaults based on each table's configuration, time-series tables with daily aggregation get **Incremental**, snapshot and non-daily tables get **Full Refresh** | Most use cases. Detrics picks the right mode per table automatically            |
| **Full Refresh All**               | Sets every table to **Full Refresh** mode                                                                                                                                     | When you want a clean, complete replacement of all data on every sync           |
| **Append Full Snapshots**          | Sets every table to **Full Append** mode                                                                                                                                      | When you want to track how all data changes over time by keeping every snapshot |

<Tip>
  **Replicate Source** is recommended for most transfers. It uses platform-specific logic to assign the optimal sync mode to each table, for example, daily ad performance tables get Incremental with a platform-appropriate refresh window, while campaign settings tables get Full Refresh.
</Tip>

#### Customize per-table sync modes

After selecting a strategy, you can override the sync mode for individual tables. The three sync modes are:

* **Incremental**: Best for daily time-series data (spend, impressions, clicks). Deduplicates by date using a refresh window
* **Full Refresh**: Best for snapshot/reference data (campaign settings, product catalogs). Replaces the table on each sync
* **Full Append**: Best for tracking changes over time (metric evolution, audit trails). Appends without removing

For tables assigned Incremental mode, you'll also configure the **refresh window** (how many days to re-fetch on each sync).

See [Sync Modes](/bigquery/sync-modes) for guidance on choosing the right mode.

### Step 5: Select Destination

Choose which BigQuery destination to write data to. The destination must have a **Connected** status (pass the connection test).

### Step 6: Configure Schedule

Set how often the transfer runs:

| Setting          | Options                                           |
| ---------------- | ------------------------------------------------- |
| **Frequency**    | Every 1h, 2h, 3h, 6h, 12h, Daily, Weekly, Monthly |
| **Hour of day**  | 0-23 (for daily, weekly, monthly frequencies)     |
| **Day of week**  | Sun-Sat (for weekly frequency)                    |
| **Day of month** | 1-31 (for monthly frequency)                      |
| **Timezone**     | Set on the destination                            |

See [Scheduling & Refresh Windows](/bigquery/scheduling-and-refresh-windows) for guidance on choosing a frequency.

### Step 7: Additional Settings

* **Transfer name**: A descriptive name (e.g., "Meta Ads - Daily Campaign Metrics")
* **Table name prefix**: Optional prefix added to all BigQuery table names in this transfer (e.g., `meta_ads_` makes tables like `meta_ads_campaign_performance`). If not set, a default prefix based on the platform is used

### Step 8: Create

Click **Create Transfer**. Detrics immediately starts the **initial sync**, which fetches historical data based on each table's configured historical sync range.

## After Creation

### Initial Sync

The first sync fetches historical data. Depending on the number of tables, accounts, and historical range, this can take from a few minutes to over an hour for very large syncs.

You can monitor progress in real time on the transfer detail page:

* Which table is currently syncing
* How many rows have been loaded
* Progress through chunks (for large syncs)

### Subsequent Syncs

After the initial sync, the transfer runs on schedule:

* **Incremental tables** fetch only the refresh window (e.g., last 3 days)
* **Full Refresh tables** re-fetch the full dataset
* **Full Append tables** append the full dataset

## Transfer Status

| Status      | Meaning                                                                            |
| ----------- | ---------------------------------------------------------------------------------- |
| **Active**  | Transfer is running on schedule                                                    |
| **Paused**  | Transfer is paused, no syncs will run until resumed                                |
| **Pausing** | A pause was requested but a sync is currently running, will pause after completion |
| **Error**   | Transfer encountered a system error, check the detail page for specifics           |

### Pausing and Resuming

* **Pause**: Stops scheduled syncs. Data in BigQuery is preserved as-is
* **Resume**: Restarts the schedule. The next sync runs at the next scheduled time (or immediately if the scheduled time has passed)

### Auto-Pause

If a transfer fails **3 consecutive times**, it automatically pauses to prevent unnecessary API calls and error noise. You'll receive an alert (if configured). Check the error details, fix the issue (e.g., re-authenticate the connection, fix BigQuery permissions), then resume.

## Organizing with Folders

You can organize transfers into folders:

* Create folders from the transfer list page
* Drag transfers between folders
* Nest folders for hierarchical organization

This is purely for organization in the Detrics UI, folders don't affect how transfers run or where data lands in BigQuery.

## Sharing Transfers

Share a transfer with other workspace members:

* **View only**: Can see the transfer status and run history
* **Edit**: Can modify settings, trigger syncs, and pause/resume

Go to the transfer detail page and click **Share** to manage access.

## Alerts

Configure email alerts per transfer:

| Alert Type           | When It Fires                                                      |
| -------------------- | ------------------------------------------------------------------ |
| **On failure**       | When a sync fails (any table)                                      |
| **On success**       | When a sync completes successfully                                 |
| **On schema change** | When BigQuery table schema is modified (new columns added/removed) |

Add one or more email addresses to receive alerts. This is useful for monitoring transfers you don't check daily.


# Custom Fields
Source: https://support.detrics.io/bigquery/custom-fields

Discover and sync platform-specific custom dimensions, conversions, and properties

<Info>**Last updated:** March 18, 2026</Info>

## What Are Custom Fields?

Most platforms offer a standard set of metrics and dimensions that every account has access to (e.g., `spend`, `impressions`, `campaign_name`). But some platforms also support **custom fields**, user-defined metrics or dimensions specific to individual accounts.

Examples of custom fields:

* **Google Analytics 4**: Custom dimensions and custom metrics you've defined in your GA4 property
* **Meta Ads**: Custom conversions, custom events, and offline event sets
* **Klaviyo**: Custom conversion metrics tied to your flows and campaigns
* **HubSpot**: Custom properties defined on your contacts, companies, deals, and other CRM objects

Detrics can discover these fields per account and sync them alongside standard fields in your BigQuery tables.

## How Custom Field Discovery Works

1. When editing a table, click **Load Custom Fields** in the field picker
2. Select an account from the dropdown, custom fields are discovered per account since each account may have different custom fields
3. Detrics queries the platform API to discover available custom fields
4. Custom fields appear in the field picker alongside standard fields, marked with a special badge
5. Select the custom fields you want to include in your table

<Note>
  The account you select for discovery is only used to find available fields, it doesn't affect which accounts the transfer syncs. When the transfer runs, Detrics syncs all selected accounts (or all accounts, depending on your setting).
</Note>

## Multi-Account Handling

When a transfer syncs multiple accounts, some accounts may have custom fields that others don't. Detrics handles this gracefully:

* If Account A has custom dimension `user_segment` but Account B doesn't, the column still exists in BigQuery
* Rows from Account A will have values for `user_segment`
* Rows from Account B will have `NULL` for that column
* BigQuery handles sparse columns natively, no performance impact

This means you don't need to worry about field compatibility across accounts. Include whatever custom fields you need, and Detrics will populate them where available.

## Supported Platforms

### Google Analytics 4

GA4 supports custom dimensions and custom metrics that you define in your property settings. These appear in Detrics with their configured parameter name.

Custom dimensions commonly used:

* User-scoped dimensions (e.g., `user_type`, `membership_level`)
* Event-scoped dimensions (e.g., `content_category`, `product_brand`)

Custom metrics commonly used:

* Event count metrics (e.g., `custom_purchase_value`, `video_completions`)

### Meta Ads

Meta Ads supports custom conversions that track specific actions on your website or app. These appear as additional conversion metrics in the field picker.

Examples:

* Custom conversion events mapped to specific pixel events
* Offline conversion sets

### Klaviyo

Klaviyo supports custom conversion metrics tied to your flows and campaigns. These track specific revenue or engagement actions.

## Custom Fields and Column Naming

Custom fields follow the same [column naming rules](/bigquery/column-naming) as standard fields. Field names are normalized to snake\_case in BigQuery. For example, a GA4 custom dimension called `UserSegment` becomes `user_segment` in your BigQuery table.


# FAQ
Source: https://support.detrics.io/bigquery/faq

Frequently asked questions about Detrics Data Warehouse

<Info>**Last updated:** March 18, 2026</Info>

## General

<AccordionGroup>
  <Accordion title="Which data warehouse platforms does Detrics support?">
    Currently, Detrics supports **Google BigQuery** as a destination. BigQuery is the most widely used cloud data warehouse for marketing analytics, and Detrics is optimized for deep integration with it.
  </Accordion>

  <Accordion title="Do I need to create the BigQuery dataset myself?">
    With the **Standard Setup**, no, when you create a destination and specify a dataset name, Detrics creates the dataset automatically in your GCP project (if it doesn't already exist). You just need to make sure the Detrics service account has the right permissions. With [**Least-Privilege Access**](/bigquery/least-privilege-access), you do pre-create the dataset yourself, since Detrics is not granted project-wide dataset-creation rights.
  </Accordion>

  <Accordion title="Which platforms can I sync to BigQuery?">
    Every platform supported by Detrics can be synced to BigQuery. See the [Fields Catalog](/fields-catalog) for the full list of platforms and the metrics and dimensions available for each.
  </Accordion>

  <Accordion title="Can I use the same connections I already have in Detrics?">
    Yes. The Data Warehouse uses the same OAuth connections you've set up for Google Sheets or Looker Studio. No need to re-authenticate your platforms.
  </Accordion>

  <Accordion title="Is the Data Warehouse included in my Detrics plan?">
    The Data Warehouse is available on select plans. Check [Pricing & Plans](/pricing) for current details.
  </Accordion>
</AccordionGroup>

## Data & Syncing

<AccordionGroup>
  <Accordion title="How often does my data sync?">
    You choose the schedule when creating a transfer. Options range from **every hour** to **monthly**. You can also trigger a manual sync at any time.
  </Accordion>

  <Accordion title="How far back can I sync historical data?">
    You can configure the historical sync range per table: 1 month, 3 months, 6 months, 12 months, 24 months, or all time. The available history depends on what the platform API provides, some platforms limit historical data access.
  </Accordion>

  <Accordion title="What happens if a sync fails?">
    If a sync fails, the transfer shows an error status with details about what went wrong (e.g., expired token, BigQuery permission issue, platform API error). Your existing data in BigQuery is not affected, failed syncs don't delete or corrupt previously loaded data. After 3 consecutive failures, the transfer automatically pauses to prevent unnecessary API calls.
  </Accordion>

  <Accordion title="Can I sync multiple ad accounts in one transfer?">
    Yes. When creating a transfer, you can choose **All accounts** (syncs every account under that connection) or **Selected accounts** (pick specific ones). Each account's data is tagged with `_detrics_account_id` so you can filter by account in your SQL queries.
  </Accordion>

  <Accordion title="How does Detrics handle duplicate data?">
    It depends on the sync mode:

    * **Incremental**: Detrics deletes rows within the refresh window for the synced accounts, then inserts fresh data. This prevents duplicates while preserving data outside the window.
    * **Full Refresh**: The entire table is replaced on each sync, so duplicates are impossible.
    * **Full Append**: Rows are appended without deduplication. If you re-sync the same date range, you will get duplicate rows. This mode is designed for use cases where you want to track snapshots over time.
  </Accordion>

  <Accordion title="What happens to my data if I pause a transfer?">
    Nothing. Your data in BigQuery stays exactly as it is. Pausing a transfer simply stops scheduled syncs. When you resume, the next sync picks up where it left off based on the refresh window.
  </Accordion>

  <Accordion title="Will Detrics delete or overwrite my existing BigQuery tables?">
    **No.** Detrics will never modify, delete, or overwrite a table it didn't create. Before writing to any table, Detrics checks for the presence of its four [system columns](/bigquery/system-columns) (`_detrics_account_id`, `_detrics_row_id`, `_detrics_sync_id`, `_detrics_synced_at`). If a table exists but doesn't have these columns, Detrics treats it as a user-created table and **refuses to write to it**, the sync will fail with a clear error message asking you to rename the existing table or change the Detrics table prefix.

    This means it's completely safe to use a shared dataset that contains both Detrics-managed tables and your own tables, views, or materialized queries. Detrics will only ever touch tables that have its system columns.
  </Accordion>

  <Accordion title="What if I already have a table with the same name as a Detrics transfer target?">
    Detrics will detect the conflict and **block the sync** rather than overwrite your data. You'll see a `TABLE_NOT_MANAGED` error explaining that the table exists but wasn't created by Detrics.

    To resolve the conflict, you have two options:

    * **Rename your existing table** in BigQuery (e.g., add a `_backup` suffix), then re-run the sync
    * **Change the table prefix in Detrics**: each transfer has a configurable prefix (defaults to the platform name, e.g., `facebook_ads_`, `ga4_`). Set a custom prefix to avoid the collision

    See [Troubleshooting → Table Not Managed by Detrics](/bigquery/troubleshooting#table-not-managed-by-detrics) for more details.
  </Accordion>

  <Accordion title="Can I sync the same table group to multiple destinations?">
    Yes. You can create multiple transfers using the same table group, each pointing to a different destination. This is useful for maintaining separate production and staging datasets.
  </Accordion>
</AccordionGroup>

## BigQuery & Costs

<AccordionGroup>
  <Accordion title="Does Detrics charge for BigQuery storage or queries?">
    No. BigQuery costs are billed directly by Google through your GCP project. Detrics handles the data pipeline; Google bills you for storage and query compute. For most marketing use cases, BigQuery costs are minimal, often under \$10/month.
  </Accordion>

  <Accordion title="Which sync mode is cheapest in BigQuery?">
    **Incremental** is significantly cheaper for ongoing syncs. It only touches a small window of data (e.g., the last 3 days), which means lower query and storage costs compared to Full Refresh (which replaces the entire table each time). For a table with 12 months of history, an incremental sync with a 3-day window processes roughly 0.8% of the data compared to a full refresh.
  </Accordion>

  <Accordion title="Does BigQuery charge for data loading?">
    No. BigQuery does not charge for loading data via the streaming or load APIs. You're only charged for storage and queries you run against the data.
  </Accordion>

  <Accordion title="Can I control where my data is stored geographically?">
    Yes. When creating a destination, you choose the **data location**, either a multi-region (US, EU) or a specific region (e.g., `us-east1`, `europe-west1`). This is permanent for that dataset and cannot be changed after creation.
  </Accordion>
</AccordionGroup>

## Tables & Fields

<AccordionGroup>
  <Accordion title="Can I add or remove fields from a table after the first sync?">
    Yes. You can edit a table at any time to add new metrics/dimensions or remove existing ones. On the next sync, Detrics will migrate the BigQuery table schema, adding new columns and preserving existing data. Removed fields will no longer receive new data but existing values are preserved.
  </Accordion>

  <Accordion title="What are premade table groups?">
    Premade table groups are presets with pre-configured metrics and dimensions for common use cases. They come in three tiers:

    * **Light**: Essential metrics only, minimal table count
    * **Standard**: Recommended for most use cases, balanced coverage
    * **Enhanced**: Comprehensive coverage with detailed breakdowns

    You can customize any premade group after creating it.
  </Accordion>

  <Accordion title="How does Detrics name columns in BigQuery?">
    All column names are normalized to **snake\_case**. This means `campaignName` becomes `campaign_name`, `campaign.name` becomes `campaign_name`, and `CTR` becomes `ctr`. This ensures consistent naming across all platforms so you can write clean SQL without worrying about each platform's conventions. See [Column Naming](/bigquery/column-naming) for the full rules.
  </Accordion>

  <Accordion title="What are custom fields?">
    Some platforms support user-defined fields that aren't part of the standard catalog. For example, GA4 custom dimensions, Meta Ads custom conversions, or Klaviyo custom metrics. Detrics can discover these fields per account and sync them alongside standard fields. See [Custom Fields](/bigquery/custom-fields) for details.
  </Accordion>
</AccordionGroup>

## Transfers & Scheduling

<AccordionGroup>
  <Accordion title="What happens if I change a transfer's schedule?">
    The new schedule takes effect on the next scheduled run. If you change from daily to hourly, the transfer will start running hourly from the next scheduled time.
  </Accordion>

  <Accordion title="Can I trigger a sync manually?">
    Yes. On any active transfer's detail page, click the **Sync Now** button. This triggers an immediate run without affecting the regular schedule.
  </Accordion>

  <Accordion title="What is a resync and when should I use it?">
    A resync re-fetches data from the platform, optionally clearing existing data first. Use it when:

    * You added new fields to a table and want historical data for those fields
    * You suspect data quality issues and want a clean reload
    * You changed filters and want to re-fetch with the new criteria

    See [Resync & Recovery](/bigquery/resync-and-recovery) for details.
  </Accordion>

  <Accordion title="How does timezone handling work?">
    The timezone is set on the destination. All transfers using that destination follow its timezone. Schedules are interpreted in the destination's timezone, so "Daily at 6:00 AM" means 6:00 AM in that timezone, even when DST changes happen. Detrics handles DST transitions automatically.
  </Accordion>
</AccordionGroup>


# Filter Overrides
Source: https://support.detrics.io/bigquery/filter-overrides

Customize table filters per transfer without duplicating table definitions

<Info>**Last updated:** March 18, 2026</Info>

## What Are Filter Overrides?

Filter overrides let you **reuse the same table group** across multiple transfers with different filtering criteria, without duplicating the table definitions.

### The Problem

Suppose you have a "Campaign Performance" table with metrics like spend, impressions, and conversions. You want three transfers:

* One for **Brand** campaigns (campaign name contains "Brand")
* One for **Performance** campaigns (campaign name contains "Perf")
* One that syncs **all campaigns** (no filter)

Without filter overrides, you'd need to create three nearly identical table groups that differ only in their filters.

### The Solution

With filter overrides, you create **one table group** with no filters (or with default filters), then override the filters at the transfer level:

```
Table Group: "Campaign Performance"
  └── Table: campaign_metrics (no filter)

Transfer 1: "Brand Campaigns"
  └── Override: campaign_name CONTAINS "Brand"

Transfer 2: "Performance Campaigns"
  └── Override: campaign_name CONTAINS "Perf"

Transfer 3: "All Campaigns"
  └── No override (uses table's default — no filter)
```

All three transfers use the same table group but sync different subsets of data.

## How It Works

* Filter overrides are set per **table** per **transfer**, you can override filters for some tables in a group while leaving others at their defaults
* An override **replaces** the table's filters entirely (it doesn't merge with existing filters)
* If no override is set, the table's own filters are used
* Overrides do not modify the original table definition, other transfers using the same table group are unaffected

## Setting Up Filter Overrides

1. Go to a transfer's detail page
2. Navigate to the **Tables** tab
3. Click on a table to see its current filter configuration
4. Click **Override Filters** to set transfer-specific filters
5. Define your custom filter criteria using the same operators available in table configuration

The transfer detail page shows which tables are using default filters and which have overrides applied, marked with a distinct badge.

## Use Cases

### Multi-Brand Agency

An agency managing campaigns for multiple brands under one ad account:

* Table group defines the metrics and dimensions
* Each transfer filters by brand name
* Each transfer points to a different destination (one BigQuery dataset per brand)

### Campaign Type Segmentation

A marketing team that wants separate tables for different campaign objectives:

* One transfer for prospecting campaigns
* One transfer for retargeting campaigns
* One transfer for all campaigns (for totals)

### Regional Segmentation

A global team syncing the same metrics but filtered by country or region:

* Transfer for LATAM markets
* Transfer for US market
* Transfer for EU markets

## Removing an Override

To remove an override and revert to the table's default filters, go to the table's override settings and click **Remove Override**. The next sync will use the table's original filter configuration.


# Glossary
Source: https://support.detrics.io/bigquery/glossary

Key terms and definitions for Detrics Data Warehouse

<Info>**Last updated:** March 18, 2026</Info>

## Core Terms

### Destination

A connection to a BigQuery dataset where your synced data is stored. A destination includes a GCP project ID, dataset name, data location (region), and timezone. You can have multiple destinations for different use cases (e.g., production vs. staging).

### Table Group

A collection of related tables for a single platform. For example, a "Meta Ads - Performance" table group might contain tables for campaign-level metrics, ad-level metrics, and audience breakdowns. Table groups can be created from **premade presets** or built from scratch.

### Table

An individual data definition within a table group. Each table specifies:

* Which **metrics** and **dimensions** to fetch
* The **time aggregation** (daily, weekly, monthly, or total)
* Any **filters** to narrow the data
* The **historical sync range** (how far back to fetch on the first sync)

A table maps directly to one BigQuery table. The **sync mode** for each table is assigned when creating a transfer, see [Transfer](#transfer).

### Transfer

The scheduled pipeline that connects a table group to a destination. A transfer defines:

* Which **data source** (platform connection) to use
* Which **accounts** to sync (all or selected)
* The **sync mode** for each table (incremental, full refresh, or full append)
* The **schedule** (how often to sync)
* The **destination** (where to put the data)

One transfer syncs one platform's data. To sync Meta Ads and Google Ads, you create two transfers.

### Transfer Run

A single execution of a transfer. Each run fetches data, processes it according to the sync mode assigned to each table, and loads it into BigQuery. Runs can be triggered by the schedule, manually, or as part of a resync.

### Sync Mode

How data is written to and maintained in a BigQuery table. Detrics supports three sync modes:

* **Incremental**: Append and deduplicate by date
* **Full Refresh**: Replace the entire table
* **Full Append**: Append without deduplication

See [Sync Modes](/bigquery/sync-modes) for full details.

### Refresh Window

For **Incremental** sync mode only. The number of days Detrics re-fetches and deduplicates on each sync. For example, a 3-day refresh window means each sync fetches the last 3 days and replaces those rows in BigQuery. This handles late-arriving data and attribution adjustments.

### Historical Sync Range

How far back Detrics fetches data on the **first sync** of a transfer. Options range from 1 month to all time. After the initial sync, only the refresh window (incremental) or full dataset (full refresh/append) is fetched on each run.

***

## BigQuery Terms

### Dataset

A BigQuery container that holds tables. When you create a destination, you specify a dataset name. If it doesn't exist, Detrics creates it in your GCP project.

### Data Location

The geographic region where your BigQuery data is physically stored. Options include multi-region locations (US, EU) or specific regions (us-east1, europe-west1, etc.). Once set, a dataset's location cannot be changed.

### Service Account

A Google Cloud identity that Detrics uses to access your BigQuery project. You grant this service account the **BigQuery User** role so Detrics can create datasets, tables, and load data.

***

## Data Terms

### Metrics

Quantitative values that can be summed or averaged. Examples: `spend`, `impressions`, `clicks`, `conversions`, `revenue`, `sessions`.

### Dimensions

Categorical or descriptive values used to group and filter data. Examples: `campaign_name`, `date`, `ad_name`, `country`, `device`, `product_title`.

### Time Aggregation

How data is grouped over time within a table:

* **Daily**: One row per day per dimension combination
* **Weekly**: One row per ISO week
* **Monthly**: One row per calendar month
* **Hourly**: One row per hour (where supported by the platform)
* **Total**: No time breakdown; aggregated across the entire date range

### Filters

Conditions applied to narrow the data fetched from a platform. For example, filtering campaigns where `campaign_name CONTAINS "Brand"` to sync only branded campaigns. Filters can be set at the table level or overridden per transfer.

### Filter Override

A transfer-level setting that replaces a table's default filters with custom filters for that specific transfer. Useful when you want to reuse the same table definition across multiple transfers with different filtering criteria.

### Custom Fields

Platform-specific fields that aren't part of the standard field catalog. Examples include GA4 custom dimensions, Meta Ads custom conversions, and Klaviyo custom metrics. These are discovered per account and synced alongside standard fields.

***

## System Terms

### System Columns

Columns automatically added by Detrics to every BigQuery table:

* `_detrics_account_id`: The platform account ID that owns each row
* `_detrics_row_id`: A content hash for deduplication
* `_detrics_sync_id`: The ID of the transfer run that created the row
* `_detrics_synced_at`: Timestamp of when the row was loaded

See [System Columns](/bigquery/system-columns) for details.

### Sync Log

A metadata table (`_detrics_sync_log`) automatically created in your BigQuery dataset. Records one row per table per transfer run, including status, row count, duration, and error details. Useful for monitoring and auditing.

### Resync

A manual operation that re-fetches data for a transfer. Two options:

* **Resync (retain data)**: Re-fetch the configured date range without deleting existing data outside that range
* **Resync (remove data)**: Delete all existing data for the transfer's accounts, then re-fetch from scratch

### Initial Sync

The first run of a new transfer. Fetches historical data based on each table's configured historical sync range. Subsequent runs use the refresh window (incremental) or re-fetch the full dataset (full refresh/append).

### Chunk

For large syncs, Detrics splits the work into smaller pieces called chunks, by time range, by account batch, or both. Chunking prevents timeouts and allows progress tracking. If a sync is interrupted, completed chunks are preserved.

### Image Persistence

An optional feature that downloads images from temporary platform URLs (e.g., ad creative thumbnails) and stores them in a Google Cloud Storage bucket. This gives you permanent URLs that don't expire, unlike the originals which typically expire within 24 hours.


# How Detrics Syncs Work
Source: https://support.detrics.io/bigquery/how-detrics-syncs-work

Understand the Detrics data pipeline from platform APIs to your BigQuery tables

<Info>**Last updated:** March 18, 2026</Info>

## The Detrics Approach

Detrics follows an **ETL (Extract, Transform, Load)** model for data warehousing. Unlike tools that dump raw API responses into your warehouse and ask you to clean them up, Detrics gives you full control over what gets extracted and how it's structured before it lands in BigQuery.

You decide:

* **Which metrics and dimensions** to include in each table
* **Which filters** to apply at the source
* **How to aggregate over time** (daily, weekly, monthly, or total)
* **Which sync strategy** to use for each table

This means every table in your warehouse contains exactly the data you asked for, clean, normalized, and ready to query.

## The Sync Pipeline

When a transfer runs, whether on schedule or triggered manually, Detrics executes a five-stage pipeline:

### Stage 1: Configuration Resolution

Detrics loads the transfer's configuration: which tables to sync, which accounts, which filters (including any per-transfer filter overrides), the sync mode assigned to each table, and refresh window settings.

### Stage 2: Data Extraction

For each table in the transfer, Detrics calls the platform's API to fetch the requested metrics and dimensions. The date range depends on the sync mode and whether this is the initial sync or a subsequent run:

**Initial sync** (first run after creating a transfer):

* All sync modes fetch the full **historical sync range** configured on each table (e.g., last 3 months, last 12 months, or all time). This backfills your BigQuery tables with historical data.

**Subsequent syncs:**

* **Incremental**: Fetches only the last N days (the refresh window), deduplicates, and preserves everything outside the window
* **Full Refresh**: Fetches the full configured date range and replaces the table
* **Full Append**: Fetches the full configured date range and appends a new snapshot

For large syncs (many accounts, long date ranges, or detailed entity levels like individual ads), Detrics automatically **chunks** the work, splitting by time range and account batches to prevent timeouts and manage memory.

### Stage 3: Transformation

Before loading into BigQuery, Detrics normalizes the data:

* **Column naming**: All field names are converted to `snake_case` for consistent SQL across platforms. See [Column Naming](/bigquery/column-naming)
* **System columns**: Four columns are added to every row: `_detrics_account_id`, `_detrics_row_id`, `_detrics_sync_id`, and `_detrics_synced_at`. See [System Columns](/bigquery/system-columns)
* **Type mapping**: Platform data types are mapped to BigQuery-native types (STRING, FLOAT64, INT64, DATE, TIMESTAMP, BOOL)
* **Row identity**: A SHA-256 hash is computed from each row's content for deduplication tracking

### Stage 4: Schema Migration

If this is the first sync for a table, Detrics creates the BigQuery table with the appropriate schema. On subsequent syncs, if you've added or removed fields, Detrics migrates the schema, adding new columns and preserving existing data.

### Stage 5: Data Loading

Data is loaded into BigQuery according to the sync mode assigned to each table in the transfer:

| Sync Mode        | What Happens                                                                                                                                               |
| ---------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Incremental**  | Delete rows in the refresh window for the synced accounts, then insert fresh data. This is done atomically, if the insert fails, the delete is rolled back |
| **Full Refresh** | Replace the entire table with the new data in one atomic operation                                                                                         |
| **Full Append**  | Append new rows to the existing table without modifying or removing anything                                                                               |

After loading, Detrics records the results in the [sync log](/bigquery/system-columns#sync-log) metadata table and updates the transfer's status.

## Platform Focus

Detrics is built specifically for the platforms used by modern digital marketing teams. This focus allows for deeper integration than general-purpose ETL tools:

### Advertising Platforms

Meta Ads, Google Ads, TikTok Ads, LinkedIn Ads, X Ads, Pinterest Ads, Bing Ads, Mercado Ads, Google DV360, with support for attribution windows, conversion tracking, and ad-level creative data.

### Analytics & SEO

Google Analytics 4 and Google Search Console, with support for custom dimensions and property-level configuration.

### Social Media

Instagram Insights, Facebook Insights, Facebook Public Data, TikTok Organic, organic performance metrics alongside paid data.

### Email Marketing

Klaviyo and Mailchimp, campaign performance, flow analytics, and subscriber metrics.

### CRM

HubSpot, contacts, deals, companies, and other entities with custom properties.

### E-commerce

Shopify, TiendaNube, WooCommerce, Google Merchant Center, orders, products, inventory, and storefront data.

### Payments

Stripe, charges, subscriptions, and payment analytics.

## Chunked Execution

Large syncs are automatically split into smaller chunks to ensure reliability. Chunking happens along two axes:

* **Time range**: Long date ranges are split into monthly segments
* **Account batches**: Many accounts are processed in smaller groups

The chunk strategy varies by platform and entity level. For example, Meta Ads at the ad level uses smaller chunks (1 month × 5 accounts) because ad-level data is denser, while campaign-level data uses larger chunks (12 months × 25 accounts).

Each completed chunk is persisted immediately. If a sync is interrupted (timeout, transient error), completed chunks are preserved, only the remaining chunks need to be retried.

## What Detrics Adds to Your Data

Every table in your warehouse includes four system columns managed by Detrics:

| Column                | Description                                                                |
| --------------------- | -------------------------------------------------------------------------- |
| `_detrics_account_id` | The platform account ID that owns each row (e.g., your Meta ad account ID) |
| `_detrics_row_id`     | A content hash for deduplication tracking                                  |
| `_detrics_sync_id`    | The transfer run ID that created the row                                   |
| `_detrics_synced_at`  | Timestamp of when the row was loaded into BigQuery                         |

These columns let you filter by account, track data freshness, and join with the sync log for auditing. See [System Columns](/bigquery/system-columns) for details.


# Image Persistence
Source: https://support.detrics.io/bigquery/image-persistence

Store permanent copies of ad creative images from platforms with expiring URLs

<Info>**Last updated:** March 18, 2026</Info>

## The Problem with Ephemeral URLs

Some marketing platforms return **temporary URLs** for images and creative assets. Meta Ads, TikTok, and Instagram generate CDN-signed URLs that typically expire within 24 hours. This means:

* Image URLs in your BigQuery data stop working after a day
* If you use these URLs in dashboards or reports, the images break
* Every API call returns a new URL for the same image, even if the content hasn't changed

## How Image Persistence Works

Image Persistence is an optional feature that gives you **permanent URLs** for ad creative images.

When enabled on a destination:

1. After a transfer sync completes, Detrics identifies all image URL fields in the synced data
2. Each image is downloaded from the platform's CDN
3. The image is compressed to an optimized WebP format (approximately 400px wide, \~14KB per image)
4. A content hash is computed, if the same image already exists in your bucket, it's not re-uploaded
5. The image is uploaded to a Google Cloud Storage (GCS) bucket in your project
6. The temporary URL in your BigQuery table is replaced with a permanent `https://storage.googleapis.com/...` URL

### What Gets Processed

Currently, image persistence supports these fields from **Meta Ads**:

* `ad_image_url`: The ad's main creative image
* `ad_image`: Image references embedded in creative data

Support for additional platforms (TikTok, Instagram) is planned.

## Enabling Image Persistence

1. Go to [**Data Warehouse → Destinations**](https://app.detrics.io/data-warehouse/destinations)
2. Open the destination where you want to enable image persistence
3. Click **Enable Image Bucket**
4. Detrics will create a GCS bucket in your project named `detrics-images-{workspace-id}`
5. Grant the Detrics service account **Storage Object Admin** role on the bucket (or project-wide)

<Note>
  The Detrics service account needs the **Storage Object Admin** IAM role to upload images to GCS. This is in addition to the BigQuery roles already granted.
</Note>

<Note>
  The steps above describe the **Standard Setup**. Under **[Least-Privilege Access](/bigquery/least-privilege-access)** you pre-create the bucket yourself and grant a narrower **Storage Object User** role scoped to that bucket, see that guide for the exact steps.
</Note>

## Storage Costs

Image persistence is designed to be cost-effective:

* Images are compressed to WebP format (\~14KB per image)
* Content-based deduplication means the same image is stored only once, even if it appears in multiple rows or across accounts
* Typical monthly cost for a large account: under \$1/month for storage

## How It Affects Deduplication

Image URL fields are marked as **ephemeral** in Detrics. This means:

* URL changes don't affect the `_detrics_row_id` hash
* When a platform returns a new temporary URL for the same image, Detrics doesn't count it as a row change
* This prevents unnecessary row updates in Incremental sync mode

This behavior applies regardless of whether Image Persistence is enabled. Image Persistence adds the permanent URL replacement on top of the dedup exclusion.

## Disabling Image Persistence

You can disable Image Persistence on a destination at any time. Existing images in the GCS bucket are preserved, and their URLs in BigQuery continue to work. New syncs will write the platform's ephemeral URLs instead of permanent ones.


# Interactive Setup Demo
Source: https://support.detrics.io/bigquery/interactive-demo

Click through the full BigQuery setup flow at your own pace

<div>
  <iframe title="Set Up and Troubleshoot a Google Search Console Data Transfer to BigQuery" />
</div>

<Tip>
  Prefer reading? The [Quickstart](/bigquery/quickstart) text guide covers the same steps with written instructions.
</Tip>


# Introduction
Source: https://support.detrics.io/bigquery/introduction

Sync your marketing data directly into Google BigQuery with Detrics Data Warehouse

<Info>**Last updated:** March 18, 2026</Info>

Detrics Data Warehouse syncs your marketing, e-commerce, and analytics data directly into **Google BigQuery**. The data lands in your own dataset, in your own GCP project, on your own terms.

You choose exactly which metrics, dimensions, and platforms to sync. Detrics handles the pipeline: fetching data from platform APIs, normalizing column names, deduplicating rows, and loading everything into BigQuery on a schedule you define.

## Why BigQuery?

<CardGroup>
  <Card title="SQL-Native Analysis" icon="database">
    Query your marketing data with standard SQL. Join campaigns across platforms,
    build custom attribution models, or feed dashboards with live warehouse data.
  </Card>

  <Card title="Your Data, Your Project" icon="lock">
    Data lands in your own GCP project and BigQuery dataset. You own it, you
    control access, and you decide how long to keep it.
  </Card>

  <Card title="Claude-Ready Data" icon="robot">
    Connect your warehouse to Claude via MCP.
    Your marketing data is always structured and ready for AI analysis.
  </Card>

  <Card title="Scale Without Limits" icon="chart-line">
    BigQuery handles petabytes. Whether you have 5 ad accounts or 500, your
    queries stay fast and your storage scales automatically.
  </Card>
</CardGroup>

## What Makes Detrics Different

Detrics is purpose-built for **digital marketing agencies and e-commerce teams**. Unlike general-purpose ETL tools that connect hundreds of data domains, Detrics focuses exclusively on the platforms modern marketing teams actually use:

* **Advertising:** Meta Ads, Google Ads, TikTok Ads, LinkedIn Ads, X Ads, Pinterest Ads, Bing Ads, Mercado Ads, Google DV360
* **Analytics & SEO:** Google Analytics 4, Google Search Console
* **Social Media:** Instagram Insights, Facebook Insights, Facebook Public Data, TikTok Organic
* **Email Marketing:** Klaviyo, Mailchimp
* **CRM:** HubSpot
* **E-commerce:** Shopify, TiendaNube, WooCommerce, Google Merchant Center
* **Payments:** Stripe

This focus means deeper integration with each platform: proper attribution windows for ad platforms, entity-level data for CRMs, product-level detail for e-commerce, and custom field support where platforms offer it.

You control exactly what data flows into your warehouse: which metrics, which dimensions, which filters, and which sync strategy. This is an **ETL** approach: you **extract** the data you need, **transform** it with normalized column names and deduplication, then **load** it into BigQuery ready for analysis.

## How It Works

The Detrics Data Warehouse pipeline has four main components:

```
1. Data Sources (your connected platforms)
        ↓
2. Table Groups & Tables (what data to fetch, how to structure it)
        ↓
3. Transfers (schedule, accounts, destination binding)
        ↓
4. Destination (your BigQuery dataset)
```

1. [**Connect your platforms**](https://app.detrics.io/datasources). Use the same OAuth connections you already have in Detrics (Meta, Google, Shopify, etc.)
2. **Define your tables.** Pick metrics and dimensions, set filters, and configure time aggregation
3. **Create a transfer.** Bind a table group to a destination, select accounts, and set a sync schedule
4. **Query in BigQuery.** Your data appears in clean, snake\_case tables with consistent column naming across all platforms

## Key Capabilities

<AccordionGroup>
  <Accordion title="Three Sync Modes" icon="arrows-rotate">
    Choose how each table syncs: **Incremental** (append and deduplicate by date), **Full Refresh** (replace the entire table), or **Full Append** (append snapshots for historical tracking). Each mode serves different analysis needs.
  </Accordion>

  <Accordion title="Flexible Scheduling" icon="clock">
    Sync as often as every hour or as infrequently as monthly. Set the exact hour, day of week, or day of month, all in your timezone.
  </Accordion>

  <Accordion title="Per-Table Configuration" icon="sliders">
    When creating a transfer, you assign a sync mode to each table, so one transfer can mix daily campaign metrics (incremental) with campaign settings (full refresh). Each table also has its own refresh window, time aggregation, filters, and historical range.
  </Accordion>

  <Accordion title="Consistent Column Naming" icon="text-size">
    All column names are normalized to snake\_case across every platform. No more `campaign.name` vs `campaignName` vs `CAMPAIGN_NAME`. Write cross-platform SQL without worrying about naming conventions.
  </Accordion>

  <Accordion title="Custom Fields" icon="puzzle-piece">
    Platforms like GA4, Meta Ads, and Klaviyo support custom dimensions and conversion metrics. Detrics discovers and syncs them alongside standard fields.
  </Accordion>

  <Accordion title="Real-Time Progress" icon="signal">
    Watch your transfers sync in real time. See which table is loading, how many rows have been processed, and track progress across chunks for large syncs.
  </Accordion>
</AccordionGroup>

## What's Next?

<CardGroup>
  <Card title="Quickstart Guide" icon="rocket" href="/bigquery/quickstart">
    Set up your first BigQuery sync in under 10 minutes, from destination to your first query.
  </Card>

  <Card title="Core Concepts" icon="book" href="/bigquery/how-detrics-syncs-work">
    Understand how the sync pipeline works, what sync modes mean, and how Detrics manages your data.
  </Card>
</CardGroup>


# Least-Privilege Access
Source: https://support.detrics.io/bigquery/least-privilege-access

Grant Detrics the minimum permissions needed to operate, scoped to only the dataset you share

<Info>**Last updated:** May 18, 2026</Info>

For most teams, the [standard setup](/bigquery/bigquery-setup#granting-access-to-detrics) is the simplest path. It grants **BigQuery User** at the project level. But security-conscious organizations, especially those with shared GCP projects or compliance requirements, want to scope a third-party integration as narrowly as possible.

Least-privilege access is the configuration we recommend for enterprise security reviews. With it, Detrics:

* Can fully operate transfers and schema migrations
* Has data access to **only the BigQuery dataset you share with it**, and nothing else
* Cannot see, list, or read any other dataset, table, or bucket in your project, not even their names

It takes a few extra steps to set up compared to the standard path, because you pre-create and share the resources yourself instead of letting Detrics provision them. Those extra steps are exactly what guarantees the scoping.

## Before You Start

Have these ready:

* **A GCP project** where Detrics will load your data.
* **Someone with IAM Admin on the project.** Granting a project-level role requires permission to edit the project's IAM policy (Project IAM Admin or Owner). If that isn't you, you can email these exact steps to whoever manages the project. In Detrics, open the BigQuery destination setup and use **Send setup instructions**.
* **The Detrics service account email.** It's shown on your destination page in Detrics. Create the BigQuery destination in Detrics first, since you'll need this email for the grants below.

<Note>
  The data Detrics loads lives in **your** GCP project, so BigQuery storage and query costs are billed by Google directly to you. This applies to both the standard and least-privilege setups.
</Note>

## Why a Project-Level Grant Is Still Needed

Detrics' write path needs two distinct kinds of permission, and it is important to understand the difference:

1. **The ability to submit jobs to BigQuery.** This covers queries, load jobs, and DML that actually move your marketing data into BigQuery. In BigQuery, *running a job* is a project-level action; it cannot be scoped to a single dataset.
2. **The ability to read and write data.** This *can* be scoped, and under least-privilege it is scoped to only the dataset you share.

So this setup does include one **project-level** role: `roles/bigquery.jobUser`.

<Warning>
  The project-level `BigQuery Job User` role grants **no data access whatsoever**. It does not let Detrics read, list, or even discover any dataset or table in your project. It only allows Detrics to *run jobs*, which is the mechanism BigQuery uses to load data. A job will fail with `Access Denied` unless the service account *also* holds data permissions on the specific dataset it touches.
</Warning>

In other words: the project-level scope is a mechanical requirement for loading data, not a window into your project. All actual data access comes exclusively from the **dataset-level** grant you make on the dataset you share. Combining a project-level `jobUser` with a dataset-level `dataEditor` gives Detrics exactly what it needs and nothing more.

Image storage, if you enable it, works the same way: a **bucket-scoped** grant lets Detrics write creatives to exactly one bucket and nowhere else.

## Required Roles

| Scope                                             | Role                        | What it allows                                                                                                |
| ------------------------------------------------- | --------------------------- | ------------------------------------------------------------------------------------------------------------- |
| **Project**                                       | `roles/bigquery.jobUser`    | Submit BigQuery jobs (queries, load jobs, DML). **No data access: it cannot read, list, or see any dataset.** |
| **Dataset** (only the one you share)              | `roles/bigquery.dataEditor` | Create, read, modify, and delete tables in this dataset. Insert and update data.                              |
| **Bucket** (only if you enable image persistence) | `roles/storage.objectUser`  | Upload, replace, and delete image objects in this one bucket. **No access to any other bucket.**              |

Each Detrics destination writes to exactly one BigQuery dataset. If you set up multiple destinations, repeat the dataset-level grant for each one's dataset.

<Note>
  The dataset (and the image bucket, if you use one) must be **pre-created by you** under this configuration, because Detrics won't have permission to create them automatically. This is one of the extra steps; see [Pre-creating the Resources](#pre-creating-the-resources) for why.
</Note>

## Step-by-Step Setup

### 1. Pre-create the BigQuery Dataset

In Google Cloud Console:

1. Navigate to **BigQuery**
2. Click your project → **Create Dataset**
3. Set the **Dataset ID** (e.g., `detrics_marketing`) and **Data location**
4. Click **Create Dataset**

<Warning>
  A dataset's **Data location is permanent** and cannot be changed after creation. Pick the region you want before clicking Create, and make sure it matches the location you configure in Detrics. To change it later you would have to delete and recreate the dataset.
</Warning>

### 2. Grant `BigQuery Job User` at the Project Level

1. Go to [Google Cloud Console → IAM & Admin → IAM](https://console.cloud.google.com/iam-admin/iam)
2. Make sure the correct project is selected in the top dropdown
3. Click **Grant Access**
4. In **New principals**, paste your Detrics service account email (shown on your destination page)
5. In **Select a role**, search for and select **BigQuery Job User**
6. Click **Save**

<Warning>
  Do **not** grant any other project-level role. In particular, avoid `BigQuery User`, `BigQuery Admin`, basic `Viewer`, basic `Editor`, or basic `Owner`. Any of these *would* grant project-wide data access and defeat the purpose of this setup. `BigQuery Job User` is the only project-level role you need, and it is the only one that grants no data access.
</Warning>

### 3. Grant `BigQuery Data Editor` on Your Dataset

1. In BigQuery Console, click your dataset (the one you created in step 1)
2. Click **SHARING** → **Permissions**
3. Click **ADD PRINCIPAL**
4. Paste the Detrics service account email
5. Select role **BigQuery Data Editor**
6. Click **Save**

If you have multiple Detrics destinations, repeat this step for each destination's dataset. Detrics has data access to a dataset only after you complete this grant for it.

### 4. (Optional) Enable Image Persistence

If you want Detrics to store ad-creative images alongside your data, it is done with a bucket-scoped grant that keeps everything off any project-level Storage role. **Skip this step entirely if you don't use [image persistence](/bigquery/image-persistence).**

1. **Pre-create the bucket.** In [Cloud Storage](https://console.cloud.google.com/storage/browser), click **Create**. Use the bucket name you'll configure in Detrics, pick the same region as your dataset, and enable **Uniform bucket-level access**.
2. **Grant Detrics a bucket-scoped role.** On the bucket's **Permissions** tab, click **Grant Access**, paste your Detrics service account email, select the role **Storage Object User**, and click **Save**.

<Warning>
  Grant **Storage Object User on the bucket only**. Never grant `roles/storage.admin` or any Storage role at the project level. A project-level Storage role would let Detrics see and write every bucket in your project, which defeats the purpose of this setup.
</Warning>

#### Public or private bucket, your call

Detrics stores every creative image in your bucket the same way regardless of this choice. What changes is the **URL form** Detrics writes next to each row — and therefore **who can see the image** in a dashboard or report:

* **Public bucket** → Detrics writes a **public URL** (`https://storage.googleapis.com/…`). The image renders for **anyone** viewing the report, including external or shared viewers. Make it public on the bucket's **Permissions** tab: click **Grant Access**, add the principal `allUsers`, and assign the role **Storage Object Viewer**.
* **Private bucket** → Detrics writes an **authenticated URL** (`https://storage.cloud.google.com/…`). The image renders only for viewers **signed into Google with IAM read access to the bucket** — typically your own team inside BigQuery or Looker. Everyone else gets a Google sign-in screen instead of the image.

We **recommend public**: a public bucket exposes nothing sensitive (it holds only ad creatives, which are already public in each platform's ad library) and is the only option that renders images for external report viewers. Choose private only if your org policy forbids public buckets and your audience is your internal team.

#### Bucket access mode

On the destination's **Image Storage** card you control which URL form Detrics writes:

* **Auto** (default) — Detrics detects whether the bucket is publicly readable (when you create the destination, on every **Test Connection**, and at the start of each sync) and picks the matching URL form for you. If you grant or revoke `allUsers` later, it follows on the next sync.
* **Public** — always write the public URL. Use when you know the bucket is public.
* **Private** — always write the authenticated URL. Use when your bucket is intentionally private.

<Note>
  Switching the mode only affects **new** image rows. URLs already written to BigQuery keep the host they were stored with — re-sync the affected window if you need existing rows updated.
</Note>

### 5. Test the Connection

In Detrics, open your destination and click **Test Connection**. The test runs through these stages:

* BigQuery Connectivity
* Project Access
* Dataset Permissions (verifies your pre-created dataset)
* Table Permissions (creates and deletes a test table inside the dataset)
* Job Permissions (loads and reads a test row)

If you enabled image persistence, the test also verifies it can write to your pre-created bucket. If any stage fails, see [Troubleshooting](#troubleshooting) below.

## What Detrics Can and Cannot Do

With this configuration, Detrics has access to a precise, verifiable subset of your project.

### Can do (within the dataset and bucket you shared, only)

* Create, alter, and drop tables
* Insert, update, and delete rows
* Read data from tables it created
* Run queries that reference only the dataset you shared
* Run [schema migrations](/bigquery/how-detrics-syncs-work#stage-4-schema-migration) using its safe temp-table-then-rename pattern
* Upload, replace, and remove ad-creative images in the granted bucket (*only if image persistence is enabled*)

### Cannot do (anywhere else in your project)

* See the existence or names of datasets you did not share
* List tables or read metadata in datasets you did not share
* Query data from any dataset you did not share
* Create or delete datasets
* Access any other Cloud Storage bucket
* Read IAM policies, billing data, or any other GCP resource

The project-level `BigQuery Job User` role does not change any of this. It grants the ability to run jobs, not to read data. You can confirm exactly what permissions the service account has at any time using the [IAM Policy Troubleshooter](https://console.cloud.google.com/iam-admin/troubleshooter) in the GCP Console.

## Pre-creating the Resources

In the standard setup, Detrics auto-creates the dataset (and the image bucket) on first use. Under least-privilege, those creation permissions are intentionally not granted, because the ability to create datasets is project-wide and would broaden Detrics' reach. So you create the dataset yourself once during setup, and the bucket too if you use image persistence. This is the main reason least-privilege has a few extra steps. Day-to-day operation needs no further intervention from you: Detrics manages tables and rows within the dataset, and image objects within the bucket, on its own.

Each Detrics destination uses its own dataset. If you add another destination later, pre-create its dataset and repeat the dataset-level grant.

## Revoking Access

To disconnect Detrics, remove the role bindings you granted:

1. **Project:** go to **IAM & Admin → IAM**, find the Detrics service account, and remove its `BigQuery Job User` binding.
2. **Dataset:** open the dataset → **SHARING** → **Permissions**, and remove the `BigQuery Data Editor` binding for the service account.
3. **Bucket** (only if you set up image persistence): open the bucket → **Permissions**, and remove the `Storage Object User` binding for the service account.

Once the grants are removed, Detrics can no longer run jobs or touch your data.

<Note>
  **Your existing data is not affected.** Every table and row Detrics already loaded stays exactly where it is. It lives in your dataset, in your project, and it is yours to keep. Revoking access only stops future syncs; it never deletes data.
</Note>

## Troubleshooting

<AccordionGroup>
  <Accordion title="Test fails at Stage 4 (Table Permissions) with 'datasets.create permission denied'">
    The dataset doesn't exist yet and Detrics tried to create it. Pre-create the dataset in BigQuery Console (see Step 1 above) and re-run the test.
  </Accordion>

  <Accordion title="Test fails at Stage 1 (BigQuery Connectivity) with 'jobs.create permission denied'">
    The `BigQuery Job User` role wasn't granted at the project level, or hasn't propagated yet. Confirm the role is assigned in **IAM & Admin → IAM**, then wait \~60 seconds and retry.
  </Accordion>

  <Accordion title="Test fails at Stage 4 (Table Permissions) with 'tables.create permission denied'">
    The `BigQuery Data Editor` role wasn't granted on the dataset itself. Open the dataset in BigQuery Console → **SHARING** → **Permissions** and confirm the service account is listed with **BigQuery Data Editor**.
  </Accordion>

  <Accordion title="Image persistence fails with 'storage.objects.create permission denied'">
    The `Storage Object User` role wasn't granted on the bucket, the bucket doesn't exist yet, or the role hasn't propagated. Open the bucket in Cloud Storage Console → **Permissions** and confirm the service account is listed with **Storage Object User**. If you pre-created the bucket but Detrics still can't reach it, double-check the bucket name matches exactly what you configured on the destination page.
  </Accordion>

  <Accordion title="Ad creatives show up as broken images in reports">
    The bucket is private. Embedded images need a publicly reachable URL. If you want creatives to render inside dashboards, make the bucket public by granting `allUsers` the **Storage Object Viewer** role on the bucket's **Permissions** tab. If you intentionally keep the bucket private, this is expected: the images are still stored, they just won't render embedded.
  </Accordion>

  <Accordion title="Service account can read a dataset or bucket you didn't share">
    This means the service account inherited a broader role from somewhere, most commonly a basic `Viewer`, `Editor`, or `Owner` role at the project level, or an explicit grant on another resource. Audit:

    1. **Project IAM:** confirm the service account has **only** `BigQuery Job User`
    2. **Each suspicious dataset:** open it in BigQuery Console → **SHARING** → **Permissions** and remove the service account if present
    3. **Each suspicious bucket:** open it in Cloud Storage Console → **Permissions** and remove the service account if present
    4. **Inherited roles:** basic project roles (`Viewer`/`Editor`/`Owner`) automatically grant data-level read across all datasets and buckets. Look for "Viewers of project X" or "Editors of project X" entries on dataset and bucket sharing panels, since those are inherited from project-level basic roles
  </Accordion>
</AccordionGroup>

## When to Use This Setup

Choose least-privilege when:

* Your GCP project is shared with other workloads or contains sensitive data
* Your security or compliance team requires least-privilege access for third-party integrations
* You want a defense-in-depth posture even if Detrics' credentials were ever compromised

Choose the [standard setup](/bigquery/bigquery-setup#granting-access-to-detrics) when:

* The GCP project is dedicated to Detrics (no other data lives there)
* You'd rather not pre-create the dataset (and bucket) yourself
* Convenience matters more than scope-limited access in your context

Both setups are fully supported, and both support [image persistence](/bigquery/image-persistence). You can also start with the standard setup and move to least-privilege later: remove the broader project role, pre-create the resources, and add the scoped grants.


# Monitoring & Run History
Source: https://support.detrics.io/bigquery/monitoring-and-history

Track sync progress, review run history, and monitor transfer health

<Info>**Last updated:** March 18, 2026</Info>

## Transfer List View

The **Data Warehouse → Transfers** page shows all your transfers at a glance:

* **Status badge**: Active, Paused, or Error
* **Last run result**: Success, Partial Success, Failed, or Running
* **Last run time**: When the most recent sync completed
* **Row count**: Total rows loaded in the last run
* **Next run**: When the next scheduled sync will execute

## Real-Time Sync Progress

When a transfer is actively syncing, the detail page shows a **live progress panel**:

* **Current table**: Which table in the group is being processed
* **Tables completed**: Progress across all tables (e.g., "3 of 7 tables")
* **Rows loaded**: Running total of rows loaded so far
* **Bytes loaded**: Total data volume processed
* **Chunk progress**: For large syncs, progress within the current table (e.g., "Chunk 4 of 12")
* **Start time**: When the current sync began

The progress updates in near real-time without needing to refresh the page.

## Run History

Each transfer maintains a full history of every sync execution. Access it from the **Run History** tab on the transfer detail page.

### Run Summary

Each run shows:

| Field                         | Description                                                                        |
| ----------------------------- | ---------------------------------------------------------------------------------- |
| **Run type**                  | Scheduled, Manual, Initial Sync, Resync (retain), Resync (remove), or Table Resync |
| **Status**                    | Success, Partial Success, Failed, or Cancelled                                     |
| **Started at / Completed at** | Timestamps                                                                         |
| **Duration**                  | Total sync time                                                                    |
| **Data range**                | Date range of data fetched (e.g., Mar 15-17)                                       |
| **Total rows**                | Rows loaded across all tables                                                      |
| **Total bytes**               | Data volume loaded                                                                 |
| **Tables synced / failed**    | Count of successful vs failed tables                                               |

### Per-Table Results

Expand any run to see results for each table:

* **Row count**: Rows loaded for this table
* **Status**: Success, Failed, or Skipped
* **Sync mode**: Which mode was used
* **Error details**: If the table failed, the specific error message

### Run Types

| Type                | Description                                                        |
| ------------------- | ------------------------------------------------------------------ |
| **Scheduled**       | Triggered automatically by the transfer's schedule                 |
| **Manual**          | Triggered by clicking **Sync Now**                                 |
| **Initial Sync**    | The first sync after creating a transfer (fetches historical data) |
| **Resync (retain)** | Manual resync that re-fetches data without deleting existing rows  |
| **Resync (remove)** | Manual resync that deletes all existing data first                 |
| **Table Resync**    | Resync of a single table within the transfer                       |

## Run Statuses

| Status              | Meaning                                                                                                             |
| ------------------- | ------------------------------------------------------------------------------------------------------------------- |
| **Success**         | All tables synced successfully                                                                                      |
| **Partial Success** | Some tables succeeded, some failed. Data from successful tables is loaded; failed tables retain their previous data |
| **Failed**          | All tables failed. No data was modified in BigQuery                                                                 |
| **Cancelled**       | The sync was stopped mid-execution (e.g., transfer was paused during a run)                                         |
| **Running**         | Sync is currently in progress                                                                                       |

## Action History

The **Actions** tab on the transfer detail page shows an audit log of everything that happened to the transfer:

* Transfer created / updated / deleted
* Syncs started / completed / failed
* Paused / resumed
* Settings changed
* Resyncs triggered

Each action records who performed it and when, making it easy to trace changes.

## Monitoring in BigQuery

You can also monitor sync health directly in BigQuery using the `_detrics_sync_log` table. See [System Columns. Sync Log](/bigquery/system-columns#sync-log) for details and example queries.

### Useful Monitoring Queries

**Check when each table was last synced:**

```sql theme={null}
SELECT
  table_name,
  MAX(completed_at) as last_sync,
  TIMESTAMP_DIFF(CURRENT_TIMESTAMP(), MAX(completed_at), HOUR) as hours_ago
FROM `project.dataset._detrics_sync_log`
WHERE status = 'success'
GROUP BY table_name
ORDER BY hours_ago DESC
```

**See average sync duration by table:**

```sql theme={null}
SELECT
  table_name,
  COUNT(*) as sync_count,
  ROUND(AVG(duration_ms) / 1000, 1) as avg_duration_seconds,
  ROUND(AVG(row_count), 0) as avg_rows
FROM `project.dataset._detrics_sync_log`
WHERE status = 'success'
  AND started_at >= TIMESTAMP_SUB(CURRENT_TIMESTAMP(), INTERVAL 30 DAY)
GROUP BY table_name
ORDER BY avg_duration_seconds DESC
```

**Detect sync failures:**

```sql theme={null}
SELECT
  table_name,
  error_message,
  started_at
FROM `project.dataset._detrics_sync_log`
WHERE status = 'failed'
  AND started_at >= TIMESTAMP_SUB(CURRENT_TIMESTAMP(), INTERVAL 7 DAY)
ORDER BY started_at DESC
```


# Platform-Specific Options
Source: https://support.detrics.io/bigquery/platform-options

Configure attribution windows, entity types, and other platform-specific settings

<Info>**Last updated:** March 18, 2026</Info>

Some platforms have settings that affect how data is fetched and reported. These are configured per table and appear in the **Platform Options** section of the table editor.

## Meta Ads

### Click Attribution Window

Controls how many days after a click a conversion is attributed to the ad. Options:

* 1 day
* 7 days (default)
* 28 days

### View Attribution Window

Controls how many days after a view (impression) a conversion is attributed to the ad. Options:

* 1 day (default)
* 7 days
* 28 days

### Conversion Report Time

When conversions are counted in your reports:

* **Impression time**: Conversions are attributed to the date the ad was shown
* **Conversion time** (default). Conversions are attributed to the date the conversion happened

<Tip>
  For most e-commerce and performance marketing use cases, **7-day click / 1-day view** with **conversion time** reporting gives the most accurate picture of campaign performance.
</Tip>

## Pinterest Ads

### Click Window

Days after a click that conversions are counted. Options: 1, 7, 14, 30, or 60 days.

### View Window

Days after a view that conversions are counted. Options: 1, 7, 14, 30, or 60 days.

### Conversion Report Time

* **Time of ad interaction**: Attributed to when the ad was clicked/viewed
* **Time of conversion**: Attributed to when the conversion occurred

## Klaviyo

### Flow Attribution Model

How revenue attribution is calculated for email flows:

* **Last touch**: Revenue attributed to the most recent email interaction
* **First touch**: Revenue attributed to the first email interaction

## HubSpot

### Entity Type

HubSpot organizes data into entities (object types). When creating a HubSpot table, you select which entity to query:

* **Contacts**: People in your CRM
* **Deals**: Sales opportunities and pipeline
* **Companies**: Organizations in your CRM

Each entity type has its own set of available metrics and dimensions.

### Association Mode

Controls how related records are joined across entities:

* **Primary**: Returns only the primary associated record (e.g., the primary company for a contact)
* **Comma separated**: Returns all associated records as a comma-separated string in one row
* **Row expanded**: Creates one row per association (e.g., if a contact belongs to 3 companies, you get 3 rows)

## How Platform Options Affect Your Data

Platform options are applied at the API request level, they change what data the platform returns. This means:

* Changing attribution windows will change your conversion numbers (because different conversions fall in/out of scope)
* Changing entity types gives you completely different fields
* These changes don't affect data already in BigQuery, only future syncs

<Warning>
  If you change platform options on an existing table, consider running a **resync** to ensure historical data is consistent with the new settings. Otherwise, you'll have data before the change using old settings and data after using new settings.
</Warning>


# Quickstart
Source: https://support.detrics.io/bigquery/quickstart

Set up your first BigQuery sync in under 10 minutes

<Info>**Last updated:** May 18, 2026</Info>

This guide walks you through the full setup: creating a BigQuery destination, defining a table group, and starting your first transfer. By the end, you'll have marketing data flowing into your own BigQuery dataset.

## Prerequisites

Before you begin, make sure you have:

* A **Detrics account** with at least one [connected platform](https://app.detrics.io/datasources) (Meta Ads, Google Ads, Shopify, etc.)
* A **Google Cloud Platform (GCP) project** with BigQuery enabled
* Permission to grant BigQuery access in your GCP project

## Step 1: Create a Destination

A destination is your BigQuery connection, it tells Detrics where to put your data.

1. Go to [**Data Warehouse → Destinations**](https://app.detrics.io/data-warehouse/destinations) in the Detrics web app
2. Click [**New Destination**](https://app.detrics.io/data-warehouse/destinations/new)
3. **Choose the setup mode**: for this quickstart, pick **Standard Setup**. It grants Detrics the **BigQuery User** role at the project level and lets Detrics create the dataset for you, the fastest path, with the fewest steps.
4. Fill in your destination details:
   * **Name**: A label for this destination (e.g., "Production Warehouse" or "Marketing Analytics")
   * **GCP Project ID**: The project ID from your Google Cloud Console (e.g., `my-company-analytics`)
   * **Dataset Name**: The BigQuery dataset where tables will be created (e.g., `marketing_data`). If the dataset doesn't exist, Detrics will create it
   * **Data Location**: Where your data is physically stored (e.g., `US`, `EU`, or a specific region like `us-east1`)
   * **Timezone**: The default timezone for your transfers
5. Click **Create Destination**

<Note>
  Working in a security-critical organization or a shared GCP project? Detrics also offers **[Least-Privilege Access](/bigquery/least-privilege-access)**, which scopes Detrics to a single dataset instead of the whole project. It has a few extra setup steps, follow that guide instead. The setup mode is chosen on this first screen and **can't be changed** after the destination is created.
</Note>

## Step 2: Grant BigQuery Access

After creating the destination, you need to grant Detrics access to your GCP project.

1. Detrics will show you a **service account email** (e.g., `big-query@detrics-production.iam.gserviceaccount.com`)
2. Go to your [Google Cloud Console → IAM](https://console.cloud.google.com/iam-admin/iam)
3. Click **Grant Access**
4. Paste the Detrics service account email as the new principal
5. Assign the **BigQuery User** role
6. Click **Save**

<Note>
  You can also send these instructions to a teammate by clicking **Send Instructions** on the destination page. This sends an email with the exact steps and service account email.
</Note>

## Step 3: Test the Connection

1. Go back to your destination in Detrics
2. Click **Test Connection**
3. Detrics will verify it can create datasets, create tables, insert data, and query your project
4. Once the test passes, your destination is ready

## Step 4: Create a Table Group

A table group defines **what data** you want to sync. It contains one or more tables, each with its own metrics, dimensions, and sync settings.

1. Go to [**Data Warehouse → Tables**](https://app.detrics.io/data-warehouse/tables)
2. Click **New Table Group**
3. Choose the platform (e.g., Meta Ads, Google Analytics 4, Shopify)
4. You'll see two options:
   * **Start from a preset**: Pre-configured table groups with recommended metrics and dimensions. Choose **Standard** for a good starting point
   * **Start from scratch**: Build your own tables with exactly the fields you need
5. Give your table group a name (e.g., "Meta Ads - Campaign Performance")

## Step 5: Configure Your Tables

Each table in the group defines a specific query. For your first sync, the defaults from a preset are a great starting point. If you want to customize:

1. Click on any table in the group to edit it
2. Select your **metrics** (e.g., spend, impressions, clicks, conversions) and **dimensions** (e.g., campaign\_name, date, ad\_name)
3. Set the **time aggregation**, how data is grouped over time:
   * **Daily**: One row per day per dimension combination (most common)
   * **Weekly** / **Monthly**. Aggregated by week or month
   * **Total**: No time breakdown, all-time totals
4. Set the **historical sync range**, how far back to fetch data on the first sync (e.g., last 3 months, last 12 months, or all time)

<Tip>
  For most use cases, **Daily** aggregation and a **3-month** historical range is the best starting point. You'll assign the sync mode (Incremental, Full Refresh, or Full Append) when creating the transfer.
</Tip>

## Step 6: Create a Transfer

A transfer connects your table group to a destination and runs on a schedule.

1. Go to [**Data Warehouse → Transfers**](https://app.detrics.io/data-warehouse/transfers)
2. Click [**New Transfer**](https://app.detrics.io/data-warehouse/transfers/new)
3. Configure the transfer:
   * **Data Source**: Select the connection (e.g., your Meta Ads connection)
   * **Accounts**: Choose **All accounts** or select specific ad accounts, properties, or stores
   * **Table Group**: Select the table group you created in Step 4
   * **Sync Mode**: Assign a sync mode to each table in the group (Incremental, Full Refresh, or Full Append)
   * **Destination**: Select the destination you created in Step 1
   * **Schedule**: How often to sync (e.g., Daily at 6:00 AM in your timezone)
   * **Table Name Prefix**: Optional prefix for BigQuery table names (e.g., `meta_ads_`)
4. Click **Create Transfer**

Detrics will immediately start the **initial sync**, fetching historical data based on your configured range.

## Step 7: Monitor Your Sync

1. Click on your new transfer to see the detail page
2. The **sync progress panel** shows real-time progress: which table is loading, how many rows have been processed, and estimated time remaining
3. Once complete, you'll see a summary with total rows loaded per table

## Step 8: Query Your Data in BigQuery

Open the [BigQuery Console](https://console.cloud.google.com/bigquery) and navigate to your dataset. You'll see tables with names like:

```
your_dataset.meta_ads_campaign_performance
your_dataset.meta_ads_ad_performance
```

Run your first query:

```sql theme={null}
SELECT
  campaign_name,
  SUM(spend) as total_spend,
  SUM(impressions) as total_impressions,
  SUM(link_clicks) as total_clicks,
  ROUND(SUM(spend) / NULLIF(SUM(link_clicks), 0), 2) as cost_per_click
FROM `your-project.your_dataset.meta_ads_campaign_performance`
WHERE date >= DATE_SUB(CURRENT_DATE(), INTERVAL 30 DAY)
GROUP BY campaign_name
ORDER BY total_spend DESC
```

Your marketing data is now in BigQuery, ready for SQL analysis, dashboard connections, or any downstream tool.

## What's Next?

<CardGroup>
  <Card title="Sync Modes" icon="arrows-rotate" href="/bigquery/sync-modes">
    Understand Incremental, Full Refresh, and Full Append, and when to use each one.
  </Card>

  <Card title="Table Groups & Tables" icon="table" href="/bigquery/table-groups-and-tables">
    Learn how to structure your tables, pick fields, and configure filters.
  </Card>

  <Card title="Monitoring & Run History" icon="chart-bar" href="/bigquery/monitoring-and-history">
    Track your syncs, debug failures, and set up alerts.
  </Card>

  <Card title="Troubleshooting" icon="wrench" href="/bigquery/troubleshooting">
    Common errors and how to fix them.
  </Card>
</CardGroup>


# Resync & Recovery
Source: https://support.detrics.io/bigquery/resync-and-recovery

Re-fetch data, recover from errors, and manage historical backfills

<Info>**Last updated:** March 18, 2026</Info>

## When to Resync

A resync re-fetches data from the platform, useful when:

* You **added new fields** to a table and want historical data for those fields
* You **changed filters** and want historical data with the new filter criteria
* You **changed platform options** (e.g., attribution windows) and want consistent historical data
* You suspect **data quality issues** and want a clean reload
* A platform had an **API outage** during a sync and data is incomplete

## Resync Options

Detrics offers two resync modes:

### Resync (Retain Data)

Re-fetches data based on each table's historical sync range **without deleting** existing data outside that range.

* For **Incremental** tables: Deletes and re-inserts within the refresh window (same as a normal sync, but triggers a broader re-fetch)
* For **Full Refresh** tables: Replaces the table with fresh data (same as a normal sync)
* For **Full Append** tables: Appends a new complete snapshot

**Best for:** Adding new fields, fixing recent data quality issues, or recovering from partial sync failures.

### Resync (Remove Data)

**Deletes all existing data** for the transfer's accounts, then re-fetches everything from scratch based on each table's historical sync range.

* All rows with matching `_detrics_account_id` values are deleted first
* Then a full historical sync is performed

**Best for:** Complete data reload after major configuration changes, switching sync modes, or when you want a guaranteed clean slate.

<Warning>
  Resync (Remove Data) permanently deletes existing rows from your BigQuery tables. Make sure you understand the implications before using this option. The deleted data cannot be recovered from Detrics (though BigQuery's time travel feature may let you recover it within 7 days).
</Warning>

## How to Trigger a Resync

### Full Transfer Resync

1. Go to the transfer's detail page
2. Click the **Resync** button
3. Choose **Retain Data** or **Remove Data**
4. Confirm the action

The resync starts immediately and runs as a special transfer run (visible in run history with the "Resync" run type).

### Single Table Resync

If only one table needs re-fetching:

1. Go to the transfer's detail page
2. Navigate to the **Tables** tab
3. Click on the table you want to resync
4. Click **Resync This Table**

This re-fetches data only for the selected table, leaving other tables untouched. Useful when you've modified a single table's configuration.

## Recovery from Errors

### Connection Errors (Expired Token)

If a transfer fails because the platform token expired:

1. Go to [**Workspace → Connections**](https://app.detrics.io/datasources) and reconnect the platform
2. Go back to the transfer and click **Resume** (if auto-paused)
3. The next scheduled sync will use the refreshed token

No resync is needed, the normal schedule will catch up automatically (incremental tables re-fetch the refresh window, which covers the gap).

### BigQuery Permission Errors

If a transfer fails because BigQuery permissions were revoked:

1. Re-grant the Detrics service account the **BigQuery User** role
2. Test the connection on the destination page
3. Resume the transfer

### Partial Success

If a run completes with **Partial Success** (some tables succeeded, some failed):

* Successful tables have their data loaded normally
* Failed tables retain their previous data, nothing is lost
* Check the per-table error details in the run history
* Fix the issue and either wait for the next scheduled sync or trigger a manual sync

### Interrupted Syncs

If a sync is interrupted (timeout, transient error):

* **Completed chunks** are preserved, their data is already in BigQuery
* **Incomplete chunks** will be retried on the next sync
* For Incremental tables, the refresh window naturally covers recent data
* For large initial syncs, consider triggering a manual resync if significant chunks were missed

## Best Practices

* **Start with Retain Data**: Most resync needs are handled without deleting existing data
* **Use Single Table Resync** when only one table's configuration changed
* **Check run history** after a resync to verify the expected row counts
* **Time your resyncs**: Large resyncs consume platform API quota. Run them during off-peak hours when other syncs aren't scheduled


# Scheduling & Refresh Windows
Source: https://support.detrics.io/bigquery/scheduling-and-refresh-windows

Configure when your transfers sync and how much data they refresh

<Info>**Last updated:** March 18, 2026</Info>

## Transfer Schedules

Every transfer runs on a schedule you define. Detrics supports a range of frequencies from hourly to monthly.

### Available Frequencies

| Frequency          | Behavior                                        |
| ------------------ | ----------------------------------------------- |
| **Every hour**     | Runs once per hour, every hour                  |
| **Every 2 hours**  | Runs every 2 hours                              |
| **Every 3 hours**  | Runs every 3 hours                              |
| **Every 6 hours**  | Runs every 6 hours                              |
| **Every 12 hours** | Runs every 12 hours                             |
| **Daily**          | Runs once per day at your chosen hour           |
| **Weekly**         | Runs once per week on your chosen day and hour  |
| **Monthly**        | Runs once per month on your chosen day and hour |

### Timezone Handling

Schedules are interpreted in the timezone set on the destination. If your destination's timezone is `America/New_York` and you schedule a transfer to run daily at 6:00 AM, it will always run at 6:00 AM Eastern time, even when Daylight Saving Time shifts occur.

Detrics handles DST transitions automatically:

* **Spring forward** (clock jumps from 2:00 AM to 3:00 AM): If your scheduled time falls in the skipped hour, Detrics runs at the next valid time
* **Fall back** (clock repeats 1:00-2:00 AM): Detrics runs once at the first occurrence

### Choosing a Frequency

| Use Case                                         | Recommended Frequency |
| ------------------------------------------------ | --------------------- |
| Real-time campaign monitoring during peak events | Every 1-3 hours       |
| Standard daily reporting                         | Daily                 |
| Weekly summary reports                           | Weekly                |
| Monthly rollups or low-volume platforms          | Monthly               |
| Intra-day optimization for active campaigns      | Every 6-12 hours      |

<Tip>
  For most use cases, **Daily** is the best starting point. Platform APIs typically don't finalize data faster than once per day, so syncing more frequently gives you fresher data but the numbers may still shift. Hourly syncs are most useful during active campaign periods when you need rapid feedback.
</Tip>

### Manual Syncs

You can trigger a sync at any time by clicking **Sync Now** on a transfer's detail page. Manual syncs don't affect the regular schedule, the next scheduled run happens at its normal time.

***

## Refresh Windows

The refresh window controls how many days of data Detrics re-fetches on each **Incremental** sync. It only applies to tables assigned the Incremental sync mode on their transfer.

### Why Refresh Windows Matter

Marketing platform data isn't final when it first appears. Several factors can cause numbers to change after the initial report:

* **Attribution delays**: A user clicks an ad today but converts 3 days later. The conversion is attributed back to the click date
* **Data processing lag**: Platforms may take 24-48 hours to finalize metrics
* **Billing adjustments**: Spend figures may be adjusted after the fact

The refresh window ensures Detrics re-fetches this "settling" data and keeps your warehouse accurate.

### Recommended Refresh Windows by Platform

| Platform               | Recommended Window | Why                                                               |
| ---------------------- | ------------------ | ----------------------------------------------------------------- |
| **Google Analytics 4** | 1-2 days           | Data typically finalizes within 48 hours                          |
| **Meta Ads**           | 3-7 days           | Attribution windows can extend up to 7 days depending on settings |
| **Google Ads**         | 3-7 days           | Conversion tracking may update for several days                   |
| **TikTok Ads**         | 2-3 days           | Standard attribution delay                                        |
| **LinkedIn Ads**       | 2-3 days           | Standard attribution delay                                        |
| **Shopify**            | 1-2 days           | Order data is usually immediate                                   |
| **Pinterest Ads**      | 2-7 days           | Depends on attribution window settings                            |

### How the Refresh Window Interacts with Sync Frequency

The refresh window and sync frequency work together:

* **Daily sync, 3-day window**: Each day, Detrics re-fetches the last 3 days. Data older than 3 days is locked and never touched again
* **Hourly sync, 3-day window**: Each hour, Detrics re-fetches the last 3 days. More frequent updates to recent data, but the window stays the same
* **Weekly sync, 7-day window**: Each week, Detrics re-fetches the last 7 days

<Note>
  The refresh window is set per table, not per transfer. This means you can have one table with a 2-day window (for analytics data that finalizes quickly) and another with a 7-day window (for ad data with longer attribution) in the same transfer.
</Note>

### Setting the Refresh Window

When a table is assigned **Incremental** sync mode on a transfer, you'll configure a refresh window setting. The value is in days. If you're not sure, start with the platform's recommended default, you can always adjust later without losing data.

***

## Historical Sync Range

The historical sync range determines how far back Detrics fetches data on the **first sync** of a transfer. This only affects the initial load; subsequent syncs use the refresh window (incremental) or re-fetch the full range (full refresh/append).

### Available Ranges

| Range              | Best For                                            |
| ------------------ | --------------------------------------------------- |
| **Last month**     | Quick testing or recent-data-only use cases         |
| **Last 3 months**  | Standard starting point for most use cases          |
| **Last 6 months**  | Seasonal analysis, quarter-over-quarter comparisons |
| **Last 12 months** | Year-over-year analysis                             |
| **Last 24 months** | Deep historical analysis                            |
| **All time**       | Complete data export from the platform              |

<Warning>
  Longer historical ranges mean larger initial syncs. An "all time" sync for a large Meta Ads account with years of data and dozens of campaigns may take significant time to complete. Start with 3-6 months and expand with a resync if you need more history.
</Warning>

### What Happens After the Initial Sync

After the first sync completes:

* **Incremental tables**: Only the refresh window is re-fetched on each subsequent sync. Historical data outside the window is preserved and never re-fetched
* **Full Refresh tables**: The full date range is re-fetched every time (historical range determines the extent)
* **Full Append tables**: The full date range is re-fetched and appended every time


# Sync Modes
Source: https://support.detrics.io/bigquery/sync-modes

Choose between Incremental, Full Refresh, and Full Append for each table

<Info>**Last updated:** March 18, 2026</Info>

When creating a transfer, you assign a **sync mode** to each table in the table group. The sync mode determines how data is written to and maintained in BigQuery. Choosing the right sync mode for each table is one of the most important decisions you'll make.

## Overview

| Sync Mode        | Behavior                                     | Best For                                                    | BigQuery Cost                              |
| ---------------- | -------------------------------------------- | ----------------------------------------------------------- | ------------------------------------------ |
| **Incremental**  | Delete + insert within a rolling date window | Time-series data (daily ad metrics, analytics)              | Lowest (processes \~1-3% of data per sync) |
| **Full Refresh** | Replace the entire table                     | Snapshot data (campaign settings, product catalogs)         | Higher (replaces full dataset each sync)   |
| **Full Append**  | Append without removing anything             | Tracking changes over time (metric evolution, audit trails) | Table grows indefinitely                   |

***

## Incremental (Append + Dedup)

Incremental is the most common sync mode and the best choice for ongoing daily data.

### How It Works

On each sync, Detrics:

1. Fetches data for the last **N days** (the refresh window, for example the last 3 days)
2. **Deletes** all existing rows in BigQuery that fall within that date window for the synced accounts
3. **Inserts** the fresh data

This is done atomically using a staging table. If the insert fails, the delete is rolled back and your existing data remains untouched.

### Why a Refresh Window?

Marketing platforms don't finalize data instantly. Attribution data, conversion tracking, and billing adjustments can take 1-7 days to settle:

* **Google Analytics 4**: Data typically finalizes within 24-48 hours
* **Meta Ads**: Attribution windows can extend up to 7 days depending on your settings
* **Google Ads**: Conversion data may update for up to 7 days

The refresh window ensures that Detrics re-fetches and corrects this data as it finalizes. A 3-day window covers most platforms' finalization periods.

### When to Use Incremental

* Daily ad performance metrics (spend, impressions, clicks, conversions)
* Analytics data (sessions, pageviews, events)
* Any time-series data where you want the latest values without duplicates

### Constraints

* Time aggregation must be set to **Daily** (one row per day per dimension combination)
* The table must include a date-based dimension

### Example

A table with a 3-day refresh window, syncing daily:

```
Day 1 (Initial sync):  Fetches Mar 1-15 → Inserts all rows
Day 2 (Scheduled sync): Fetches Mar 14-16 → Deletes Mar 14-16, inserts fresh
Day 3 (Scheduled sync): Fetches Mar 15-17 → Deletes Mar 15-17, inserts fresh
```

Data older than the refresh window is never touched. Only the window rows are refreshed.

***

## Full Refresh

Full Refresh replaces the entire BigQuery table on each sync. Simple, predictable, and ideal for data that doesn't have a meaningful time dimension.

### How It Works

On each sync, Detrics:

1. Fetches the full configured date range from the platform
2. **Replaces** the entire BigQuery table with the new data (using BigQuery's `WRITE_TRUNCATE`)

This is atomic at the BigQuery level. The old data is only removed once the new data is fully loaded.

### When to Use Full Refresh

* Campaign settings and structure (campaign names, status, budgets, targeting)
* Product catalogs (Shopify products, Google Merchant Center listings)
* Account-level configuration data
* Any table where you want a clean, current snapshot
* Tables with **Total** time aggregation (no date breakdown)

### Cost Considerations

Full Refresh processes the entire dataset on every sync. For a table with 12 months of daily campaign data across 50 ad accounts, this means re-loading the full dataset each time. Consider using **Incremental** for large historical tables to reduce costs.

### Example

```
Day 1 (Initial sync):   Fetches all data → Creates table with 10,000 rows
Day 2 (Scheduled sync):  Fetches all data → Replaces table with 10,200 rows
Day 3 (Scheduled sync):  Fetches all data → Replaces table with 10,150 rows
```

The table always reflects exactly what the platform API returns right now.

***

## Full Append

Full Append adds new rows on every sync without deleting or updating anything. The table grows over time, preserving every snapshot.

### How It Works

On each sync, Detrics:

1. Fetches the full configured date range from the platform
2. **Appends** all rows to the existing BigQuery table

No rows are ever deleted or updated. Each sync adds a complete snapshot.

### When to Use Full Append

* **Social media follower snapshots**: Take daily snapshots of Instagram followers, Facebook page likes, or TikTok followers to track growth over time
* **Campaign settings change history**: Track when budgets, statuses, or targeting changed on your campaigns and ad sets by comparing snapshots across sync dates
* **E-commerce inventory tracking**: Monitor stock level changes over time for Shopify, WooCommerce, or Google Merchant Center products
* **Tracking metric evolution**: See how lifetime ROAS, total reach, or cumulative spend changed day-over-day by comparing snapshots from different sync dates
* **Audit trails**: Keep a record of what the platform reported at each point in time
* **Non-overlapping data**: When you're sure each sync produces unique rows that don't overlap with previous syncs

### Important Warning

<Warning>
  Full Append tables grow indefinitely. If you sync daily with a 12-month date range, after one year you'll have 365 copies of each data point. Use this mode intentionally and understand the storage implications.
</Warning>

### How to Identify Which Sync Produced Each Row

Every row includes `_detrics_sync_id` and `_detrics_synced_at`, so you can always distinguish between snapshots:

```sql theme={null}
-- Compare campaign spend between two snapshots
SELECT
  a.campaign_name,
  a.spend AS spend_yesterday,
  b.spend AS spend_today,
  b.spend - a.spend AS daily_change
FROM `project.dataset.campaign_metrics` a
JOIN `project.dataset.campaign_metrics` b
  ON a.campaign_name = b.campaign_name
  AND a.date = b.date
WHERE a._detrics_synced_at = '2026-03-16'
  AND b._detrics_synced_at = '2026-03-17'
```

***

## Choosing the Right Sync Mode

Use this decision tree to pick the right mode for each table:

1. **Does this table have daily time-series data?** (metrics that change day by day)
   * Yes → **Incremental**
   * No → Continue to 2

2. **Do you want to track how values change over time?** (e.g., daily snapshots of Instagram followers to track growth)
   * Yes → **Full Append**
   * No → Continue to 3

3. **Is this snapshot/reference data?** (campaign settings, product catalog, entity metadata)
   * Yes → **Full Refresh**

### Quick Reference by Data Type

| Data Type                                           | Recommended Mode            | Why                                                                   |
| --------------------------------------------------- | --------------------------- | --------------------------------------------------------------------- |
| Daily ad performance (spend, impressions, clicks)   | Incremental                 | Deduplicates by date, handles attribution delays                      |
| Campaign/ad group settings (names, status, budgets) | Full Refresh                | No date dimension, want current state                                 |
| Product catalog (Shopify products, inventory)       | Full Refresh                | Want current snapshot                                                 |
| Analytics sessions and events                       | Incremental                 | Daily time-series data                                                |
| Social media followers/reach snapshots              | Full Append                 | Daily snapshots to track follower growth over time                    |
| Campaign/ad set settings change history             | Full Append                 | Track budget changes, status changes, and targeting updates over time |
| E-commerce inventory levels                         | Full Append                 | Track stock level changes over time for products                      |
| Lifetime/all-time metrics (total ROAS, reach)       | Full Refresh or Full Append | Full Refresh for current state; Full Append to track changes          |
| Order history (Shopify, WooCommerce)                | Incremental                 | Time-series, deduplicates by date                                     |
| Email campaign performance                          | Incremental                 | Daily engagement metrics                                              |

## Historical Timeframe & Initial Sync

When you create a transfer, Detrics runs an **initial sync** that fetches historical data. The amount of history fetched is controlled by the **historical sync range** configured on each table (e.g., last 3 months, last 12 months, or all time).

How the initial sync works depends on the sync mode:

* **Incremental**: The initial sync fetches the full historical range and loads it into BigQuery. After this first load, subsequent syncs only fetch the refresh window (for example, the last 3 days) and deduplicate within that window. Data outside the window is preserved and never re-fetched
* **Full Refresh**: The initial sync and all subsequent syncs behave the same way: fetch the full configured date range and replace the table. The historical range determines how far back the data goes on every sync
* **Full Append**: The initial sync fetches the full historical range and appends it. Every subsequent sync also fetches the full range and appends again, creating a new snapshot each time

<Tip>
  For Incremental tables, the historical sync range only matters for the first sync. After that, only the refresh window is re-fetched. For Full Refresh and Full Append, the historical range determines the scope of every sync.
</Tip>

## Mixing Sync Modes in One Transfer

When creating a transfer, you can assign different sync modes to each table. For example, a Meta Ads transfer might include:

* **Campaign Daily Performance** → Incremental (daily metrics)
* **Campaign Settings** → Full Refresh (names, status, budgets)
* **Lifetime ROAS Tracking** → Full Append (track how ROAS evolves)

All three tables sync together on the same schedule, each using its own mode.


# System Columns
Source: https://support.detrics.io/bigquery/system-columns

Understand the columns Detrics adds to every BigQuery table

<Info>**Last updated:** March 18, 2026</Info>

Detrics adds four system columns to every BigQuery table. These columns enable deduplication, multi-account filtering, and sync auditing. They are clearly prefixed with `_detrics_` so they're easy to identify and exclude from analysis when not needed.

## Column Reference

| Column                | Type      | Position      | Description                                   |
| --------------------- | --------- | ------------- | --------------------------------------------- |
| `_detrics_account_id` | STRING    | First column  | The platform account ID that owns the row     |
| `_detrics_row_id`     | STRING    | Second column | SHA-256 content hash of the row's data        |
| `_detrics_sync_id`    | STRING    | Third column  | UUID of the transfer run that created the row |
| `_detrics_synced_at`  | TIMESTAMP | Last column   | When the row was loaded into BigQuery         |

***

## `_detrics_account_id`

Every row is tagged with the platform account ID it belongs to. This is critical for:

* **Multi-account transfers**: When a transfer syncs multiple ad accounts, this column lets you filter or group by account
* **Account-scoped deduplication**: Incremental sync deletes and re-inserts data scoped to specific accounts, so one account's sync never affects another account's data

### Example: Filter by Account

```sql theme={null}
SELECT campaign_name, SUM(spend) as total_spend
FROM `project.dataset.meta_ads_campaigns`
WHERE _detrics_account_id = '709801159698717'
  AND date >= '2026-03-01'
GROUP BY campaign_name
```

### Example: Compare Across Accounts

```sql theme={null}
SELECT
  _detrics_account_id,
  SUM(spend) as total_spend,
  SUM(impressions) as total_impressions
FROM `project.dataset.meta_ads_campaigns`
WHERE date >= '2026-03-01'
GROUP BY _detrics_account_id
ORDER BY total_spend DESC
```

***

## `_detrics_row_id`

A SHA-256 hash computed from all non-system column values plus the account ID. Two rows with identical data produce identical hashes. This column is primarily used internally by Detrics for deduplication tracking.

**What's included in the hash**: All metric values, dimension values, and the account ID.

**What's excluded from the hash**: System columns (`_detrics_row_id`, `_detrics_sync_id`, `_detrics_synced_at`) and ephemeral URL fields (like `ad_image_url`) that change on every API call even when the actual content hasn't changed.

***

## `_detrics_sync_id`

A UUID that identifies the transfer run that created each row. All rows loaded in the same sync share the same `_detrics_sync_id`. This is useful for:

* **Auditing**: Know exactly which sync produced each row
* **Debugging**: If you notice bad data, trace it back to a specific run
* **Full Append analysis**: Distinguish between snapshots taken at different times

### Example: See All Rows from a Specific Sync

```sql theme={null}
SELECT *
FROM `project.dataset.google_ads_campaigns`
WHERE _detrics_sync_id = 'a1b2c3d4-e5f6-7890-abcd-ef1234567890'
```

***

## `_detrics_synced_at`

A UTC timestamp recording when each row was loaded into BigQuery. Always the last column in every table. Useful for:

* **Data freshness checks**: Verify that recent syncs are running on schedule
* **Full Append filtering**: Select only the latest snapshot or compare snapshots across dates

### Example: Check Data Freshness

```sql theme={null}
SELECT
  MAX(_detrics_synced_at) as last_sync,
  TIMESTAMP_DIFF(CURRENT_TIMESTAMP(), MAX(_detrics_synced_at), HOUR) as hours_since_sync
FROM `project.dataset.meta_ads_campaigns`
```

### Example: Get Only the Latest Snapshot (Full Append Tables)

```sql theme={null}
SELECT *
FROM `project.dataset.campaign_lifetime_metrics`
WHERE _detrics_synced_at = (
  SELECT MAX(_detrics_synced_at)
  FROM `project.dataset.campaign_lifetime_metrics`
)
```

***

## Sync Log

In addition to the system columns on each table, Detrics creates a metadata table called `_detrics_sync_log` in your dataset. This table records one row per table per transfer run.

### Sync Log Columns

| Column          | Type      | Description                                                 |
| --------------- | --------- | ----------------------------------------------------------- |
| `sync_id`       | STRING    | Transfer run ID (matches `_detrics_sync_id` in data tables) |
| `table_name`    | STRING    | Name of the BigQuery table                                  |
| `sync_mode`     | STRING    | Sync mode used (incremental, full\_refresh, full\_append)   |
| `status`        | STRING    | Result: success, partial\_success, or failed                |
| `row_count`     | INT64     | Number of rows loaded                                       |
| `duration_ms`   | INT64     | How long the sync took in milliseconds                      |
| `started_at`    | TIMESTAMP | When the sync started                                       |
| `completed_at`  | TIMESTAMP | When the sync finished                                      |
| `error_message` | STRING    | Error details if the sync failed                            |
| `metadata`      | JSON      | Additional context (chunk details, entity level, etc.)      |

### Example: Recent Sync History

```sql theme={null}
SELECT
  table_name,
  sync_mode,
  status,
  row_count,
  ROUND(duration_ms / 1000, 1) as duration_seconds,
  started_at
FROM `project.dataset._detrics_sync_log`
ORDER BY started_at DESC
LIMIT 20
```

### Example: Failed Syncs

```sql theme={null}
SELECT
  table_name,
  error_message,
  started_at
FROM `project.dataset._detrics_sync_log`
WHERE status = 'failed'
ORDER BY started_at DESC
```

***

## Table Ownership Detection

The system columns also serve as a **table ownership fingerprint**. Before writing to any table, Detrics checks that all four `_detrics_*` columns exist. If a table with the target name already exists in the dataset but lacks these columns, Detrics assumes it was created by you (or another tool) and **refuses to write to it**, protecting your data from accidental overwrites.

This means you can safely share a dataset between Detrics-managed tables and your own tables, views, or materialized queries. Detrics will never modify a table it didn't create.

If you encounter this protection, see the [FAQ](/bigquery/faq#what-if-i-already-have-a-table-with-the-same-name-as-a-detrics-transfer-target) for resolution steps.

***

## Column Order in BigQuery

Detrics organizes columns in a consistent order across all tables:

1. `_detrics_account_id` (first)
2. `_detrics_row_id`
3. `_detrics_sync_id`
4. Time columns (e.g., `date`, `week`, `month`)
5. Dimension columns (e.g., `campaign_name`, `ad_name`)
6. Metric columns (e.g., `spend`, `impressions`, `clicks`)
7. `_detrics_synced_at` (last)

This order makes it easy to scan tables in the BigQuery console, system columns are clearly separated from your data.


# Table Groups & Tables
Source: https://support.detrics.io/bigquery/table-groups-and-tables

Define what data to sync by creating table groups and configuring individual tables

<Info>**Last updated:** March 18, 2026</Info>

## What Are Table Groups?

A **table group** is a collection of related tables for a single platform. Each table group belongs to one platform (e.g., Meta Ads, Google Ads, Shopify), and each table in the group defines a specific dataset to sync, with its own metrics, dimensions, filters, and sync settings.

Think of a table group as a schema definition: "For Meta Ads, I want these 4 tables with these specific fields." When you create a transfer, you bind a table group to a destination and a schedule.

### Why Groups?

Table groups let you:

* **Reuse definitions**: The same table group can be used by multiple transfers (e.g., sync the same tables for different accounts or to different destinations)
* **Organize logically**: Group related tables together (campaign metrics + ad metrics + audience breakdowns)
* **Mix sync modes**: When creating a transfer, you assign a sync mode to each table, so you can combine incremental daily metrics with full refresh settings data in one transfer

## Creating a Table Group

1. Go to [**Data Warehouse → Tables**](https://app.detrics.io/data-warehouse/tables)
2. Click **New Table Group**
3. Select the platform (e.g., Meta Ads, Google Analytics 4, Shopify)
4. Choose your starting point:

### Premade Presets

Detrics offers premade table groups with pre-configured metrics and dimensions for common use cases. Presets come in three tiers:

| Tier         | Description                                 | Best For                          |
| ------------ | ------------------------------------------- | --------------------------------- |
| **Light**    | Essential metrics only, minimal tables      | Quick setup, simple reporting     |
| **Standard** | Balanced coverage, recommended defaults     | Most use cases                    |
| **Enhanced** | Comprehensive coverage, detailed breakdowns | Deep analysis, granular reporting |

You can customize any premade group after creating it, add or remove tables and change fields.

### From Scratch

Start with an empty group and build each table manually. Best when you know exactly which fields you need or when working with platforms where premade presets don't cover your use case.

## Configuring Tables

Each table in a group maps to one BigQuery table. Here's what you configure:

### Table Name

The name that will be used for the BigQuery table. Must be unique within the table group. Names are converted to snake\_case automatically (e.g., "Campaign Performance" becomes `campaign_performance`).

If you set a **table name prefix** on the transfer (e.g., `meta_ads_`), the final BigQuery table name will be `meta_ads_campaign_performance`.

### Metrics

Quantitative fields to include, the numbers you want to analyze. Examples:

* **Advertising**: spend, impressions, clicks, conversions, ctr, cpc, cpm, roas
* **E-commerce**: gross\_sales, order\_count, average\_order\_value, refund\_amount
* **Analytics**: sessions, total\_users, new\_users, bounce\_rate, engagement\_rate
* **Email**: email\_opens, email\_clicks, unsubscribes, revenue\_per\_recipient

The field picker shows all available metrics for the selected platform, organized by category. Use the search bar to find specific fields quickly.

### Dimensions

Categorical fields that define the granularity of your data, how rows are grouped. Examples:

* **Common**: campaign\_name, ad\_name, date, country, device
* **E-commerce**: product\_title, product\_type, order\_status
* **Analytics**: source\_medium, landing\_page, page\_path

<Tip>
  The dimensions you choose determine how many rows your table will have. Adding more dimensions creates more granular (and larger) tables. Start with the dimensions you actually need for analysis and add more later if needed.
</Tip>

### Time Aggregation

How data is grouped over time:

| Aggregation | Row Granularity                                    | Example                                       |
| ----------- | -------------------------------------------------- | --------------------------------------------- |
| **Daily**   | One row per day per unique dimension combination   | Campaign "Summer Sale" on 2026-03-15          |
| **Weekly**  | One row per ISO week                               | Campaign "Summer Sale" in week 12             |
| **Monthly** | One row per calendar month                         | Campaign "Summer Sale" in March 2026          |
| **Hourly**  | One row per hour (where supported)                 | Campaign "Summer Sale" at 14:00 on 2026-03-15 |
| **Total**   | One row per unique dimension combination (no date) | Campaign "Summer Sale" all-time total         |

<Note>
  **Incremental** sync mode (assigned at the transfer level) requires **Daily** time aggregation. If you need weekly, monthly, hourly, or total aggregation, use **Full Refresh** or **Full Append**.
</Note>

### Historical Sync Range

How far back to fetch data on the initial sync. Options: 1 month, 3 months, 6 months, 12 months, 24 months, or all time.

### Filters

Optional conditions to narrow the data. For example:

* `campaign_name CONTAINS "Brand"`: Only sync branded campaigns
* `spend GREATER_THAN 0`: Only sync rows with actual spend
* `country EQUALS "US"`: Only sync US data

Available filter operators:

| Operator                   | Description                                                                  |
| -------------------------- | ---------------------------------------------------------------------------- |
| `EQUALS`                   | Exact match                                                                  |
| `DOES_NOT_EQUAL`           | Excludes exact match                                                         |
| `CONTAINS`                 | Substring match                                                              |
| `DOES_NOT_CONTAIN`         | Excludes substring match                                                     |
| `GREATER_THAN`             | Numeric greater than                                                         |
| `LESS_THAN`                | Numeric less than                                                            |
| `GREATER_OR_EQUAL`         | Numeric greater than or equal                                                |
| `SMALLER_OR_EQUAL`         | Numeric less than or equal                                                   |
| `REGEX_CONTAINS`           | Keeps rows matching any `\|`-separated text (full regex on GA4 & Google Ads) |
| `REGEX_CONTAINS_EXACT`     | Exact match against any `\|`-separated text (full regex on GA4 & Google Ads) |
| `REGEX_NOT_CONTAINS_EXACT` | Excludes rows exactly matching any `\|`-separated text                       |

Filters can be combined with **AND** or **OR** logic. The regex operators accept full regular-expression syntax only on **GA4** and **Google Ads**; everywhere else they match a plain `|`-separated list of texts. See [How Filters Work](/core-functionality/filters) for details.

<Tip>
  Filters are applied at the platform API level, not in BigQuery. This means filtered-out rows are never fetched or stored, reducing sync time and storage costs.
</Tip>

## Data Preview

Before creating or saving a table, you can preview the data it will produce. Click **Preview** to fetch a sample of rows using the current configuration. This helps you verify that the right fields and filters are selected before running a full sync.

## Editing Tables After Creation

You can edit any table at any time. Before saving, Detrics shows a **change preview** that classifies each change and warns you about its impact. Here's what happens for each type of change:

### Safe changes

* **Adding new metrics**: New metric columns are added to the BigQuery table on the next sync. Existing rows will have `NULL` for the new columns until they are refreshed within the sync window. No resync is triggered automatically, if you want the new metric backfilled for all historical data, run a manual resync.

### Column drop changes

* **Removing metrics**: The removed column is dropped from the BigQuery table via a schema migration. Existing data in that column is permanently deleted. The remaining columns and their data are preserved.

### Breaking changes (automatic resync)

These changes alter the row granularity of your data, the existing rows become incompatible with the new table structure. When you save a breaking change, Detrics automatically:

1. Marks the table for resync
2. On the next sync, recreates the BigQuery table with the new schema (old data is discarded, not copied, since it has incompatible granularity)
3. Runs a full historical resync to populate the table with fresh data at the correct granularity

* **Adding or removing dimensions**: Dimensions define how rows are grouped. Adding a dimension creates more rows with finer breakdowns; removing one aggregates data into fewer rows. Either way, the old row structure no longer matches.
* **Changing time aggregation**: Changing from Daily to Weekly (or vice versa) changes how data is bucketed over time. The existing rows don't match the new aggregation level. Note: incremental sync mode only supports daily aggregation, so switching to any other aggregation (weekly, monthly, etc.) will also automatically downgrade the sync mode to Full Refresh.

### Configuration changes

These take effect on the next sync without any schema or data migration:

* **Changing filters**: Applied on the next sync. For full data coherency with the new filters, run a historical resync manually.
* **Changing sync mode**: Takes effect on the next sync.
* **Changing refresh window**: Takes effect on the next sync.
* **Changing historical sync range**: Takes effect on the next resync.
* **Changing platform-specific options**: Applied on the next sync.

## Duplicating and Copying

* **Duplicate a table group**: Creates a copy of the entire group with all its tables, useful for creating variations (e.g., same fields but different filters)
* **Copy a table**: Creates a copy of a single table within the same group or to a different group


# Troubleshooting
Source: https://support.detrics.io/bigquery/troubleshooting

Common errors and how to resolve them

<Info>**Last updated:** March 18, 2026</Info>

When a sync fails, Detrics classifies the error by **pipeline stage** to help you identify and fix the issue. This page covers the most common errors and their solutions.

## Dataset Setup Errors

These errors occur when Detrics can't access or create the BigQuery dataset.

<AccordionGroup>
  <Accordion title="Permission Denied. Can't access the GCP project">
    **Error:** `DATASET_PERMISSION_DENIED`

    **Cause:** The Detrics service account doesn't have the required IAM roles in your GCP project.

    **Fix:**

    1. Go to [Google Cloud Console → IAM](https://console.cloud.google.com/iam-admin/iam)
    2. Find the Detrics service account email (shown on your destination page)
    3. Ensure it has the **BigQuery User** role
    4. If the roles are missing, click **Edit** → **Add Another Role** → save
    5. Re-test the connection on the destination page
  </Accordion>

  <Accordion title="Dataset Creation Failed">
    **Error:** `DATASET_CREATION_FAILED`

    **Cause:** The Detrics service account can't create the dataset. This usually means the service account has job-level permissions but not project-level dataset creation rights.

    **Fix:**

    * Ensure the service account has the **BigQuery User** role at the **project level** (not just dataset level)
    * Alternatively, create the dataset manually in BigQuery Console and grant the service account access to it
    * On a [Least-Privilege Access](/bigquery/least-privilege-access) destination this is expected. Detrics never creates the dataset; pre-create it yourself
  </Accordion>

  <Accordion title="Dataset Not Found">
    **Error:** `DATASET_NOT_FOUND`

    **Cause:** The dataset was deleted from BigQuery after the destination was configured.

    **Fix:**

    * If you deleted the dataset intentionally, Detrics will recreate it on the next sync
    * If the dataset name changed, update the destination configuration
    * Re-test the connection on the destination page
  </Accordion>
</AccordionGroup>

## Schema Migration Errors

These errors occur when Detrics can't create or update table schemas in BigQuery.

<AccordionGroup>
  <Accordion title="Schema Type Mismatch">
    **Error:** `SCHEMA_TYPE_MISMATCH`

    **Cause:** A column's data type in the existing BigQuery table doesn't match what Detrics expects. This can happen if the table was manually modified in BigQuery.

    **Fix:**

    * Check the BigQuery table schema and compare it with the fields configured in Detrics
    * If you manually changed a column type in BigQuery, consider deleting the table and letting Detrics recreate it on the next sync
    * If the issue persists, run a **Resync (Remove Data)** to start fresh
  </Accordion>

  <Accordion title="Table Not Managed by Detrics">
    **Error:** `TABLE_NOT_MANAGED`

    **Cause:** A table with the same name already exists in the dataset but wasn't created by Detrics. Detrics won't modify tables it didn't create.

    **Fix:**

    * Rename the existing table in BigQuery, or
    * Change the table name or prefix in Detrics to avoid the conflict
  </Accordion>
</AccordionGroup>

## Data Retrieval Errors

These errors occur when Detrics can't fetch data from the platform API.

<AccordionGroup>
  <Accordion title="Authentication Error. Token Expired">
    **Error:** `DATA_RETRIEVAL_AUTH_ERROR`

    **Cause:** The OAuth token for the platform connection has expired or been revoked.

    **Fix:**

    1. Go to [**Workspace → Connections**](https://app.detrics.io/datasources)
    2. Find the connection and click **Reconnect**
    3. Re-authenticate with the platform
    4. Resume the transfer (if auto-paused)
  </Accordion>

  <Accordion title="Rate Limit Hit">
    **Error:** `DATA_RETRIEVAL_RATE_LIMIT`

    **Cause:** The platform's API rate limit was exceeded. This can happen when you have many transfers syncing the same platform simultaneously, or during peak API usage periods.

    **Fix:**

    * Wait and retry. Detrics automatically retries with backoff, but persistent rate limiting may cause the sync to fail
    * Stagger transfer schedules so multiple transfers for the same platform don't run at the same time
    * Reduce sync frequency if you're hitting limits consistently
  </Accordion>

  <Accordion title="Permission Revoked">
    **Error:** `DATA_RETRIEVAL_PERMISSION`

    **Cause:** Access to one or more accounts was revoked on the platform side (e.g., removed from a Meta Business Manager, lost access to a GA4 property).

    **Fix:**

    * Verify your access to the affected accounts on the platform
    * If access was intentionally revoked, update the transfer to exclude those accounts
    * If access was accidentally revoked, re-grant it on the platform and retry the sync
  </Accordion>

  <Accordion title="Platform API Error">
    **Error:** `DATA_RETRIEVAL_API_ERROR`

    **Cause:** The platform API returned an unexpected error. This is usually a transient issue on the platform's side (e.g., Meta Ads API outage, Google Ads service disruption).

    **Fix:**

    * Wait for the platform to recover and retry the sync
    * Check the platform's status page for any ongoing outages
    * If the error persists, check the specific error message for details
  </Accordion>

  <Accordion title="Request Timeout">
    **Error:** `DATA_RETRIEVAL_TIMEOUT`

    **Cause:** The platform API took too long to respond. Common with very large accounts or complex queries.

    **Fix:**

    * The transfer will automatically retry on the next scheduled sync
    * If timeouts persist, consider reducing the table's historical sync range or adding filters to reduce the data volume
    * For very large accounts, Detrics automatically chunks requests, but some queries may still hit platform-side timeouts
  </Accordion>

  <Accordion title="No Data Available">
    **Error:** `DATA_RETRIEVAL_NO_DATA`

    **Cause:** The platform returned no data for the requested accounts, date range, and fields. This is not necessarily an error, the account may have no activity in the requested period.

    **Fix:**

    * Verify the account has data in the requested date range by checking the platform directly
    * Check that the selected metrics and dimensions are valid for the account type
    * If the account is new, wait until it has data before syncing
  </Accordion>
</AccordionGroup>

## Data Loading Errors

These errors occur when Detrics can't write data to BigQuery.

<AccordionGroup>
  <Accordion title="Type Mismatch During Load">
    **Error:** `BQ_LOAD_TYPE_MISMATCH`

    **Cause:** The data returned by the platform doesn't match the expected BigQuery column types. For example, a field expected to be numeric contains text values.

    **Fix:**

    * This is usually a transient issue caused by unexpected platform data. The next sync often resolves it
    * If it persists, check the specific field mentioned in the error and report it to Detrics support
  </Accordion>

  <Accordion title="BigQuery Quota Exceeded">
    **Error:** `BQ_LOAD_QUOTA_EXCEEDED`

    **Cause:** Your GCP project hit a BigQuery quota limit (e.g., maximum load jobs per day, maximum bytes loaded).

    **Fix:**

    * Check your [BigQuery quotas](https://console.cloud.google.com/iam-admin/quotas) in the GCP Console
    * Request a quota increase if needed
    * Stagger transfer schedules to spread load jobs over time
  </Accordion>

  <Accordion title="BigQuery Permission Denied">
    **Error:** `BQ_LOAD_PERMISSION_DENIED`

    **Cause:** The Detrics service account lost write access to the dataset.

    **Fix:**

    * Re-grant the **BigQuery User** role to the Detrics service account
    * Re-test the connection on the destination page
  </Accordion>
</AccordionGroup>

## System Errors

<AccordionGroup>
  <Accordion title="Lock Timeout">
    **Error:** `SYSTEM_LOCK_TIMEOUT`

    **Cause:** Another sync for the same transfer is already running. Detrics prevents concurrent runs to avoid data conflicts.

    **Fix:**

    * Wait for the current sync to finish
    * If a sync appears stuck, contact Detrics support
  </Accordion>

  <Accordion title="Internal Error">
    **Error:** `SYSTEM_INTERNAL_ERROR`

    **Cause:** An unexpected error occurred in the Detrics pipeline.

    **Fix:**

    * The transfer will automatically retry on the next scheduled sync
    * If the error persists across multiple runs, contact Detrics support with the transfer ID and run ID
  </Accordion>
</AccordionGroup>

## Getting Help

If you can't resolve an error:

1. Note the **transfer ID** and **run ID** from the transfer detail page
2. Check the **per-table error details** in the run history for specific error messages
3. Contact Detrics support via the **Chat with Support** button in the docs, or email [support@detrics.io](mailto:support@detrics.io)


# Changelog
Source: https://support.detrics.io/changelog

Latest updates and releases

<Info>**Last updated:** July 17, 2026</Info>

# Changelog

Stay up to date with the latest changes and improvements to Detrics.

***

## New Platform Integrations

The latest platforms added to Detrics. Connect these data sources to pull analytics into Google Sheets, Looker Studio, BigQuery, and the Detrics web app.

<CardGroup>
  <Card title="Bing Webmaster Tools" icon="microsoft" href="/data-source/bing-webmaster-tools/fields">
    Bing SEO data with field names that mirror Google Search Console: search performance, crawl stats, crawl issues, sitemaps, and blocked URLs.

    *July 2026*
  </Card>

  <Card title="Instantly" icon="paper-plane" href="/data-source/instantly/fields">
    Cold email outreach analytics with **75+ fields** across campaigns, steps, leads, emails, and senders, including replies, opportunities, and meetings.

    *July 2026*
  </Card>

  <Card title="MercadoLibre Organic" icon="store" href="/data-source/mercado-organic/fields">
    Marketplace seller data with **124 fields** covering listings, orders, questions, reviews, reputation, and visits.

    *June 2026*
  </Card>

  <Card title="AppsFlyer" icon="mobile" href="/data-source/appsflyer/fields">
    Mobile attribution with **110+ fields** across aggregate and raw event-level reports: installs, sessions, in-app events, revenue, cost, and ROI.

    *June 2026*
  </Card>
</CardGroup>

Also added in 2026: [Salesforce](/data-source/salesforce/fields), [Snapchat Ads](/data-source/snapchat-ads/fields), [Magento](/data-source/magento-orders/fields), [YouTube Analytics](/data-source/youtube-analytics/fields), [Apple Search Ads](/data-source/apple-search-ads/fields), [VTEX](/data-source/vtex/fields), [Perfit](/data-source/perfit/fields), [Google Business Profile](/data-source/google-business-profile/fields), [Google Merchant Center](/data-source/google-merchant-center/fields), [Mailchimp](/data-source/mailchimp/fields), LinkedIn Pages, [Facebook Public Data](/data-source/facebook-public-data/fields), and [HubSpot](/data-source/hubspot/fields). Details in the monthly sections below.

***

## Major Features

### Detrics Data Warehouse (BigQuery)

*March 2026*

Sync marketing data from 30+ platforms straight into your own BigQuery project. Build table schemas from any platform's fields, schedule daily, weekly, or monthly transfers with full refresh or incremental sync modes, and track every run in a detailed history.

Since launch we've added automatic retries for failed transfer chunks, concurrent historical and daily syncs, a Least Privilege setup mode, image persistence for creative URLs, and ready-made presets across 50+ platforms.

Get started with the [BigQuery quickstart](/bigquery/quickstart).

***

### Detrics MCP Server

*February 2026*

Query your marketing data in natural language from Claude, ChatGPT, Cursor, and other AI assistants. The MCP server exposes 30+ platforms through tools for querying data, listing connections and accounts, and discovering fields.

The **MCP Hub** in the web app handles setup guides per AI client, workspace-scoped API keys, saved **AI Contexts** (reusable data-source configurations your assistant loads automatically), and 39 ready-to-use prompt templates.

Learn more in the [MCP overview](/claude/overview).

***

## Recent Platform Updates

### July 2026

#### New Platforms

* **[Instantly](/data-source/instantly/fields)** - Cold email outreach analytics, available simultaneously in Sheets, BigQuery, the web app, Looker Studio, and MCP
* **[Bing Webmaster Tools](/data-source/bing-webmaster-tools/fields)** - Search performance, crawl stats, and indexing data; field naming mirrors Google Search Console for side-by-side SEO reports

#### Google Search Console Technical SEO

**29 new fields** in three new categories: Page Indexing (index verdict, coverage, canonicals, last crawl), Rich Results, and Sitemaps, plus a Search Type dimension (web, image, video, news, Discover).

#### TikTok Organic Rebuilt

Migrated to TikTok's Business API with **28 new fields**: comments, keyword rankings, watch time, reach, and account totals. Existing connections keep working.

#### More July Updates

* **Meta Ads** - New incrementality attribution window based on conversion lift studies
* **Facebook & Instagram Insights** - Media Viewers metrics, Meta's official replacement for the deprecated Reach metrics
* **Data Warehouse** - Transfer folders, honest per-platform "All time" date ranges, and warnings when a table edit would break a transfer filter
* **Sidebar** - The platform picker now shows every integration, with alias-aware search ("meta", "gsc", "adwords")
* **DV360** - Filter by campaign, insertion order, line item, or creative name without adding the dimension
* **Google Ads** - Migrated to API v24 ahead of Google's sunset; saved queries keep working unchanged

### June 2026

#### New Platforms

* **[AppsFlyer](/data-source/appsflyer/fields)** - Mobile attribution with **27 metrics + 85 dimensions** across aggregate and raw event-level reports
* **[MercadoLibre Organic](/data-source/mercado-organic/fields)** - Seller marketplace data with **124 fields**: listings, orders, questions, reviews, reputation, and visits

#### LinkedIn Ads Creative Fields & Breakdowns

Dimensions grew from 47 to 61: nine creative dimensions (destination URL, CTA, ad text, media type, thumbnails) and five audience breakdowns (Job Title, Member Company, Device Type, Serving Location, Placement).

#### More June Updates

* **DV360** - Filter reports without adding the field as a dimension, keeping unique reach and frequency correct
* **Facebook Insights** - Meta deprecated Page and Post reach and impressions industry-wide on June 15; Detrics removed the dead metrics and shows a clear message on old saved queries
* **Apple Search Ads** - Tokens now refresh automatically, and a new Search Term Analysis template
* **Data Warehouse** - Historical backfills and daily syncs now run at the same time
* **Field expansions** - Meta Ads (offline conversions, app event values), Instagram Insights (comment-level dimensions), Google Ads (Conversion Goals), Shopify (line item tax, inventory), TikTok Ads (province), Mercado Ads (TACoS)

### May 2026

#### New Platforms

* **[Salesforce](/data-source/salesforce/fields)** - CRM analytics with **48 metrics + 329 dimensions**: leads, opportunities, accounts, contacts, and pipeline
* **[Snapchat Ads](/data-source/snapchat-ads/fields)** - **53 metrics + 45 dimensions** with campaign, ad squad, and ad-level reporting
* **[Magento](/data-source/magento-orders/fields)** - Magento 2 orders, line items, and customers with **31 metrics + 68 dimensions**

#### More May Updates

* **Sheets to BigQuery** - An "Open in BigQuery" button on every sidebar query clones its metrics, dimensions, and filters into a warehouse table
* **BigQuery Least Privilege mode** - Pre-create the dataset and bucket yourself and grant Detrics only minimal scoped roles
* **Partial account failures isolated** - Losing access to one account no longer fails the whole query; accessible accounts load and errors name the exact accounts affected
* **GA4 & DV360** - Weekly Sunday-to-Saturday time aggregation, alongside the existing Monday-to-Sunday weeks
* **Meta platforms** - Upgraded to Graph API v25.0 (LTS) so existing connections keep refreshing
* **TikTok Ads** - Gender and age combined breakdown now supported; invalid field combos are blocked up front in the picker
* **Field expansions** - Bing Ads (campaign and ad group labels), Facebook Ads (Product ID and Name), DV360 (Floodlight activity), Google Ads (Viewable Impressions)

### April 2026

#### New Platforms

* **[YouTube Analytics](/data-source/youtube-analytics/fields)** - **45 metrics + 37 dimensions**: views, watch time, subscribers, revenue, demographics, and traffic sources
* **[Apple Search Ads](/data-source/apple-search-ads/fields)** - **23 metrics + 42 dimensions** with multi-organization account selection
* **[VTEX](/data-source/vtex/fields)** - Orders, product catalog, SKU, and inventory with **12 metrics + 44 dimensions**
* **[Perfit](/data-source/perfit/fields)** - Email marketing with **51 metrics + 29 dimensions**, including automations

#### More April Updates

* **Facebook Ads** - Custom conversions show readable names (like "Purchase - Website") instead of numeric IDs
* **Query cancel** - Cancelling a query now aborts the upstream platform call on every platform
* **LinkedIn Pages** - Personal profile analytics alongside Company Pages, with new Post Saves, Post Sends, and Premium CTA Clicks metrics
* **TikTok Ads** - Multi-account queries run about 4.5× faster
* **Facebook Insights** - Followers by city and country, plus a Media Product Type dimension (Reel, photo, album, video)

### March 2026

#### Detrics Data Warehouse (BigQuery) Launched

Our biggest release of the year: sync any platform into your own BigQuery project on a schedule. See [Major Features](#major-features) above.

#### New Platforms

* **[Google Business Profile](/data-source/google-business-profile/fields)** - Location performance, search keywords, reviews, posts, and media with **100+ fields**
* **[Google Merchant Center](/data-source/google-merchant-center/fields)** - **80+ fields** across Performance, Products, and Diagnostics views
* **[Mailchimp](/data-source/mailchimp/fields)** - **70+ fields**: campaign reports, audience stats, and list growth history
* **LinkedIn Pages** - Organization analytics: post performance, follower demographics, and page views
* **[Facebook Public Data](/data-source/facebook-public-data/fields)** - Analyze any public Facebook Page or URL, **62 fields**, without needing an ad account

#### More March Updates

* **HubSpot** - Dynamic field discovery: all your custom properties are auto-discovered, with cross-entity association fields and support for 13 CRM entities plus 5 analytics entities
* **Meta Ads** - Three Advantage+ breakdowns: audience segment, gen AI asset type, and standard enhancements
* **Data Warehouse** - Failed transfer chunks retry automatically with smaller date windows

### February 2026

#### New Platforms

* **[HubSpot](/data-source/hubspot/fields)** - CRM analytics with **105 metrics + 190 dimensions** across contacts, companies, deals, tickets, email campaigns, forms, products, and calls

#### Detrics MCP Server Launched

Query your marketing data from AI assistants in natural language. See [Major Features](#major-features) above.

#### More February Updates

* **Smart upgrade prompts** - Usage tracking against your plan limit with a projected limit date and one-click prorated upgrades
* **Google Sheets auto-formatting** - Query results style themselves as formatted tables: frozen headers, currency and percentage formats, and auto-sized columns
* **Marketplace installs** - Connect Detrics directly from the HubSpot and Klaviyo app marketplaces
* **New dashboards** - HubSpot CRM and Klaviyo dashboards in the web app
* **TikTok Organic** - Opened to all users
* **Stripe** - Expanded to **70 metrics + 218 dimensions** with SaaS reports (MRR, ARR, churn, LTV), cohorts, charges, payouts, and refunds
* **Klaviyo** - 18 Shopify e-commerce metrics and flow series reports with daily, weekly, and monthly intervals

***

## Archive

<AccordionGroup>
  <Accordion title="January 2026">
    ### New Platforms

    * **LinkedIn Pages** - Company Page analytics with 45+ fields (launched pending platform approval)
    * **TikTok Organic** - Video performance analytics with 25+ fields (launched pending platform approval)
    * **Klaviyo** - Email marketing analytics with 35+ fields for campaigns and automated flows
    * **Facebook Pages** - Organic social analytics with 50+ fields

    ### Klaviyo Flow Analytics

    * Flow ID, name, status, and trigger type dimensions
    * `send_channel` dimension to compare campaigns vs flows
    * 3 new template queries for flow analysis

    ### Field Expansions

    | Platform         | New Fields                                                                        |
    | ---------------- | --------------------------------------------------------------------------------- |
    | **Facebook Ads** | Brand awareness metrics: estimated ad recall lift, recall rate, cost per recall   |
    | **WooCommerce**  | 10 order attribution fields (UTM parameters, device type, referrer, session data) |
    | **Shopify**      | POS/Retail dimensions, payment method tracking                                    |
    | **TikTok Ads**   | Campaign automation type, ad text, TikTok item ID                                 |
    | **X Ads**        | Ad name field for promoted tweets                                                 |

    ### Facebook Insights

    * Post Video ID for joining with video analytics
    * Page vs Post validation to prevent incompatible metric combinations
  </Accordion>

  <Accordion title="December 2025">
    ### ShopifyQL Analytics

    Integrated Shopify's ShopifyQL analytics engine: **100+ new metrics** and **50+ new dimensions** including UTM attribution, customer cohorts, conversion metrics, and returns/shipping data. See the [Shopify documentation](/data-source/shopify/fields).

    ### Web App v3

    Completely redesigned web application: searchable data sources page with bulk actions and connection sharing, guided Looker Studio onboarding, self-service billing, a scheduled queries dashboard, and connection replacement without losing query configurations.

    ### GA4 Custom Channel Groups

    Use your custom-defined channel groupings in reports alongside custom dimensions and metrics.

    ### Massive Field Expansions

    | Platform               | Before     | After      | Change      |
    | ---------------------- | ---------- | ---------- | ----------- |
    | **Pinterest Ads**      | 107 fields | 433 fields | +326 fields |
    | **X/Twitter Ads**      | 75 fields  | 154 fields | +79 fields  |
    | **Meta/Facebook Ads**  | 282 fields | 353 fields | +71 fields  |
    | **Bing/Microsoft Ads** | 111 fields | 136 fields | +25 fields  |

    ### Other December Updates

    * **Dimensionless Filtering** - Apply filters without requiring a dimension
    * **Zero-Date Filling** - Time series data fills missing dates automatically
    * **Connection Change** - Switch data source connections on existing queries
    * **New Shopify Order Fields** - Sales channel, POS location, payment gateway, shipping method
  </Accordion>

  <Accordion title="August 2025">
    ### Features

    * **New**: Query Templates for multiple platforms:
      * 20 Google Analytics 4 query templates
      * 15 TikTok Ads query templates
      * 10 Instagram Insights query templates
      * 5 Google Search Console templates
    * **New**: Instagram image fields for enhanced media analytics
    * **New**: Shopify Line Item Variant Quantity field
    * **Improved**: Meta Ads & Instagram API updated to v23.0 for compatibility
    * **Improved**: Looker Studio connectors with integrated Quickstart flow
  </Accordion>

  <Accordion title="July 2025">
    ### Features - **New**: Query Templates feature enabled for all public users -

    **New**: 10 Tiendanube templates added + 20 additional fields - **New**: 10
    Shopify Query Templates added - **New**: 10 Google Ads Query Templates -
    **New**: 10 Meta Ads Query Templates - **Improved**: Sheets are now linked by
    ID instead of Sheet Name - **Improved**: Extended timeframes for Tiendanube,
    TikTok, and Shopify - **Improved**: Tiendanube and Shopify installation flows
    with personalized onboarding
  </Accordion>

  <Accordion title="June 2025">
    ### Features - **New**: Enhanced field totals across platforms: - Pinterest:

    +107 fields - LinkedIn: +125 fields - X Ads: +73 fields - Bing Ads: +106
    fields - **New**: UI modifications including Home section with template
    buttons - **New**: Shopify fields added and existing fields reorganized -
    **Improved**: Multi-account queries show warnings for specific account
    failures
  </Accordion>

  <Accordion title="May 2025">
    ### Features

    * **New**: Trial system for Looker Studio
    * **New**: Usage system for Google Sheets
    * **New**: Default sorting and sorting configuration feature

    ### Infrastructure

    * **Improved**: Infrastructure enhancements to reduce query timeouts
    * **Improved**: Database optimizations for increased app velocity
  </Accordion>

  <Accordion title="April 2025">
    ### Features - **New**: Shopify enhanced fields including order currency,

    pricing, and financial data - **Improved**: Query error handling with
    account-specific warnings
  </Accordion>

  <Accordion title="March 2025">
    ### Features - **New**: Advanced filtering capabilities with regex support -

    **Improved**: Mobile UI optimizations for better responsiveness -
    **Improved**: Attribution window customization for Meta Ads campaigns
  </Accordion>

  <Accordion title="February 2025">
    ### Features - **New**: Tiendanube integration for Latin American e-commerce

    analytics - **Improved**: Onboarding flow with interactive modal guides
  </Accordion>

  <Accordion title="January 2025">
    ### Features - **New**: Stripe integration for payment processing analytics -

    **Improved**: Query scheduling with enhanced daily triggers - **Improved**:
    Performance optimizations reducing query execution time by 40%
  </Accordion>

  <Accordion title="Q4 2024">
    ### Features - **New**: Shopify integration with comprehensive e-commerce

    analytics - **New**: WooCommerce integration for WordPress stores - **New**:
    Collaboration features for team query sharing - **Improved**: Import/Export
    functionality allowing 10x faster dashboard replication
  </Accordion>

  <Accordion title="Q3 2024">
    ### Features - **New**: Looker Studio connector for advanced data

    visualization - **New**: Query duplication feature for rapid dashboard scaling

    * **Improved**: Bulk refresh capabilities for multiple queries
  </Accordion>

  <Accordion title="Q2 2024">
    ### Features - **New**: Template Creation Flow for custom dashboard templates

    * **New**: Template Gallery with pre-built solutions - **New**: Automatic
      pause triggers for cost control - **Improved**: Column ordering and
      customization options
  </Accordion>

  <Accordion title="Q1 2024">
    ### Features - **New**: Advanced filtering system with boolean operators -

    **Improved**: Performance boost with 50% faster data loading - **Improved**:
    Error recovery and graceful handling of API limits
  </Accordion>

  <Accordion title="2023">
    ### December 2023

    * **New**: TikTok Ads enhanced with budget and scheduling dimensions
    * **New**: Instagram Insights breakdowns for detailed performance analysis
    * **Improved**: Facebook Ads dynamic fields for flexible reporting

    ### November 2023

    * **New**: DV360 integration for programmatic advertising
    * **New**: Campaign Manager 360 integration
    * **Improved**: Query optimization reducing API calls by 30%

    ### October 2023

    * **New**: Pinterest Ads integration with full metrics suite
    * **New**: Bing Ads integration for Microsoft advertising
    * **New**: X (Twitter) Ads integration
    * **New**: Query duplication for efficient dashboard creation

    ### September 2023 - Launch

    **Detrics launches with Google Sheets Add-on**, providing automated data synchronization from major advertising platforms to spreadsheets.

    Launch features included:

    * Google Sheets Add-on with intuitive UI
    * Google Analytics 4 & Universal Analytics integrations
    * Google Ads, Facebook Ads, LinkedIn Ads, TikTok Ads integrations
    * Google Search Console & Instagram Insights integrations
    * Import/Export functionality
    * Automated scheduling (hourly, daily, weekly)
    * Multi-account support
  </Accordion>
</AccordionGroup>

***

## Questions or Feedback?

Have questions about these updates? Contact our support team or visit our [documentation](/).


# API Keys
Source: https://support.detrics.io/claude/api-keys

Manage and secure your Detrics API keys for AI agent access

## What are API Keys?

API keys authenticate Claude Code with Detrics. When you register the Detrics MCP server with your agent, the API key is passed as an environment variable so the server can verify your identity and access your workspace data.

Each API key is **scoped to a workspace**, it can only access data from the workspace where it was created.

<Note>
  **API keys are only needed for Claude Code.** If you are using Claude Web, authentication is handled through OAuth, no API key required.
</Note>

## Keeping Your API Keys Safe

<Warning>
  **Treat your API key like a password.** Anyone with your key can access your workspace's marketing data through the Detrics MCP server.

  * **Never share keys publicly**: do not post them on GitHub, forums, Stack Overflow, or in screenshots
  * **Never commit keys to version control**: add them to `.gitignore` or use environment variables
  * **Use environment variables**, not hardcoded values, when referencing keys in scripts or configs
  * **Revoke keys immediately** if you suspect they have been exposed
</Warning>

## Managing API Keys

You can manage your API keys from the Detrics web app at [app.detrics.io/mcp](https://app.detrics.io/mcp), in the **Agent API Keys** section at the bottom of the page.

### Generate a new key

1. Go to [app.detrics.io/mcp](https://app.detrics.io/mcp), or navigate to **AI Agents** in the sidebar
2. Click **+ New Key**
3. Give the key a descriptive name (e.g., "Work laptop", "CI server")
4. Copy the key immediately, it will only be shown once

### Rename a key

1. Go to [app.detrics.io/mcp](https://app.detrics.io/mcp), or navigate to **AI Agents** in the sidebar
2. Click the menu icon next to the key
3. Select **Rename** and enter a new name

### Revoke a key

1. Go to [app.detrics.io/mcp](https://app.detrics.io/mcp), or navigate to **AI Agents** in the sidebar
2. Click the menu icon next to the key
3. Select **Revoke**
4. Confirm the revocation

Once revoked, the key stops working immediately. Any agent using that key will receive "Unauthorized" errors.

## Key Scoping

API keys are scoped to the **workspace** where they were created. This means:

* A key created in "Agency Workspace A" can only access data from that workspace
* It cannot access data from "Agency Workspace B", even if you are a member of both
* If you work across multiple workspaces, you will need a separate key for each one

## If Your Key Is Compromised

If you believe your API key has been exposed:

1. **Revoke the key immediately** from [app.detrics.io/mcp](https://app.detrics.io/mcp)
2. **Generate a new key** with a different name
3. **Update Claude Code** with the new key by removing and re-adding the MCP server (see [Claude Code](/claude/claude-code#updating-your-api-key))
4. **Review your workspace activity** for any unexpected usage


# Available Tools
Source: https://support.detrics.io/claude/available-tools

All MCP tools available through the Detrics MCP server

## MCP Tools

When you connect Detrics to Claude, the following tools become available. Claude calls these automatically based on your prompts, you do not need to invoke them manually.

### Core

<AccordionGroup>
  <Accordion title="query_marketing_data" icon="magnifying-glass-chart">
    Query metrics and dimensions from any connected marketing platform.

    **Parameters:**

    * `platform_api`: The platform identifier (e.g., `facebook_ads`, `google_ads`, `shopify`)
    * `account_id`: The platform account to query
    * `metrics`: Metrics to retrieve (e.g., `spend`, `impressions`, `revenue`)
    * `dimensions`: Dimensions to group by (e.g., `campaign_name`, `date`)
    * `date_range`: Time period for the query
    * `context_id`: Optional [AI Context](/claude/create-ai-context) ID to use pre-configured settings

    **Example prompt:** "What was my Meta Ads ROAS last week?"
  </Accordion>

  <Accordion title="list_connections" icon="link">
    See all platforms connected to your workspace.

    Returns the platform name, connection status, and number of accounts available.

    **Example prompt:** "What platforms do I have connected?"
  </Accordion>

  <Accordion title="list_fields" icon="list">
    Discover available metrics and dimensions for a specific platform.

    **Parameters:**

    * `platform_api`: The platform identifier

    **Example prompt:** "What metrics are available for Shopify?"
  </Accordion>

  <Accordion title="list_accounts" icon="building">
    List all accounts (ad accounts, properties, stores) for a connected platform.

    **Parameters:**

    * `platform_api`: The platform identifier

    **Example prompt:** "Show me my Google Ads accounts"
  </Accordion>

  <Accordion title="list_contexts" icon="layer-group">
    List all [AI Contexts](/claude/create-ai-context) available in your workspace.

    **Example prompt:** "What AI Contexts are available?"
  </Accordion>

  <Accordion title="get_context" icon="file-lines">
    Get the full details of a specific AI Context, including its query configuration.

    **Parameters:**

    * `context_id`: The context identifier

    **Example prompt:** "Show me the details of my weekly performance context"
  </Accordion>

  <Accordion title="connect_platform" icon="plug">
    Initiate an OAuth flow to connect a new marketing platform to your workspace. Returns a URL to complete the authorization.

    **Parameters:**

    * `platform_api`: The platform to connect

    **Example prompt:** "Connect my Pinterest Ads account"
  </Accordion>

  <Accordion title="check_connection_status" icon="circle-check">
    Check whether a platform OAuth connection flow has been completed.

    **Parameters:**

    * `connection_id`: The connection identifier from `connect_platform`

    **Example prompt:** "Did my Pinterest connection go through?"
  </Accordion>
</AccordionGroup>

### Data Warehouse

Beyond querying, Claude can manage your entire BigQuery warehouse. Create destinations, build table groups, schedule and run transfers, and query your data, all in natural language through the Detrics MCP server.

<AccordionGroup>
  <Accordion title="get_warehouse" icon="warehouse">
    Read Data Warehouse state: destinations, transfers, runs, table groups, tables, audit log, shares, presets and schema previews. (read-only)

    **Example prompt:** "Show me the state of my BigQuery warehouse"
  </Accordion>

  <Accordion title="manage_warehouse_destination" icon="database">
    Create and manage BigQuery destinations: guided GCP setup, connection tests, image storage, sharing.

    **Example prompt:** "Create a BigQuery destination in my project acme-analytics"
  </Accordion>

  <Accordion title="manage_warehouse_table" icon="table">
    Create and manage warehouse table groups and tables, including pre-built presets and safe schema updates.

    **Example prompt:** "Build a table group for my Meta Ads data using a preset"
  </Accordion>

  <Accordion title="manage_warehouse_transfer" icon="arrows-rotate">
    Create and manage BigQuery transfers: create, update, pause/resume, trigger syncs, per-table sync settings, sharing.

    **Example prompt:** "Schedule a daily transfer of my Google Ads data to BigQuery"
  </Accordion>
</AccordionGroup>

## Supported Platforms

Detrics connects to 30+ marketing, analytics, and e-commerce platforms. The [Fields Catalog](/fields-catalog/index) has the complete, always-current list of supported platforms and the fields available for each.

## Recommended Workflow

For the best results:

1. **Start with `list_contexts`**: check if there is a pre-built [AI Context](/claude/create-ai-context) for what you need
2. **Use `query_marketing_data` with a `context_id`**: this uses pre-configured settings, saving you from specifying every parameter
3. If no context fits, use `list_fields` to discover available metrics and dimensions, then build your query manually


# Claude Code
Source: https://support.detrics.io/claude/claude-code

Connect Detrics to Claude Code, one command, one API key

<Note>
  If you primarily want to chat with your data (not code), [Claude Web](/claude/claude-web) is the easiest path, no API key needed, just OAuth in 30 seconds.
</Note>

## Prerequisites

* A [Detrics account](https://detrics.io/get-started?utm_source=detrics-support\&utm_medium=claude-code-setup)
* [Claude Code](https://docs.anthropic.com/en/docs/claude-code) installed
* At least one [connected platform](/connect/connect-a-platform) in your Detrics workspace

## Setup

<Steps>
  <Step title="Generate a Detrics API key">
    Go to [app.detrics.io/mcp/api-keys](https://app.detrics.io/mcp/api-keys) and click **Generate New Key**. Copy it, you will need it in the next step.

    <Warning>
      Treat your API key like a password. Never share it publicly or commit it to version control. See [API Keys](/claude/api-keys) for security best practices.
    </Warning>
  </Step>

  <Step title="Register the Detrics MCP server">
    Run the following command in your terminal. Replace `your-api-key` with the key you just generated.

    ```bash theme={null}
    claude mcp add detrics-mcp https://mcp.detrics.io -e DETRICS_API_KEY=your-api-key -t streamable-http
    ```
  </Step>

  <Step title="Start querying">
    Open Claude Code and try a test prompt:

    ```
    What platforms do I have connected in Detrics?
    ```

    Claude Code will call the Detrics MCP server and return your connected platforms. If you see results, you are all set.
  </Step>
</Steps>

## Example prompts

Once connected, try these:

* "What was my total ad spend across all platforms last month?"
* "Compare my Google Ads and Meta Ads ROAS for the last 30 days"
* "Show me my top 5 campaigns by conversions this week"
* "What's my Shopify revenue trend over the last 90 days?"
* "What metrics are available for TikTok Ads?"

Or browse the [Prompt Templates](/claude/use-prompt-templates) for 40+ ready-made marketing prompts.

## Updating your API key

If you need to rotate your API key:

1. Generate a new key at [app.detrics.io/mcp/api-keys](https://app.detrics.io/mcp/api-keys)
2. Remove the existing server: `claude mcp remove detrics-mcp`
3. Re-add with the new key:
   ```bash theme={null}
   claude mcp add detrics-mcp https://mcp.detrics.io -e DETRICS_API_KEY=new-key -t streamable-http
   ```

## Troubleshooting

<AccordionGroup>
  <Accordion title="'Server not found' or 'Connection refused'">
    The MCP server URL may be incorrect.

    **Fix:** Make sure the URL is exactly `https://mcp.detrics.io`. Enter the base URL by itself, with no trailing slash and no `/sse` suffix.
  </Accordion>

  <Accordion title="'Unauthorized' or '401' errors">
    Your API key is missing or invalid.

    **Fix:** Remove and re-add the server, making sure the `-e DETRICS_API_KEY=...` flag is included with your full API key.
  </Accordion>

  <Accordion title="'No connections found' response">
    Your MCP connection works, but there are no platforms connected in your Detrics workspace.

    **Fix:**

    1. Go to [app.detrics.io](https://app.detrics.io) and connect at least one data source
    2. Or ask Claude Code: "Connect my Meta Ads account", it will generate an OAuth link for you
  </Accordion>
</AccordionGroup>

For more issues, see [Troubleshooting](/claude/troubleshooting).


# Claude Web
Source: https://support.detrics.io/claude/claude-web

Set up Detrics in Claude.ai or Claude Desktop in 30 seconds, no API key needed

<Note>
  **Claude Pro or higher required.** MCP custom connectors are available on Claude Pro, Team, and Enterprise plans. The free Claude plan does not support MCP.
</Note>

## Setup

The whole process takes about 30 seconds.

<Steps>
  <Step title="Open the setup guide in Detrics">
    Go to [app.detrics.io/mcp/claude](https://app.detrics.io/mcp/claude). This page shows numbered steps with screenshots for each one.
  </Step>

  <Step title="Open Claude settings">
    In Claude Desktop (or claude.ai), open **Settings** by clicking the gear icon.
  </Step>

  <Step title="Go to Connections">
    In the settings sidebar, click **Connections**. You will see a list of your connected services.
  </Step>

  <Step title="Add a custom connector">
    Scroll to the bottom of the connections list and click **Add custom connector**.

    Enter:

    * **Name:** `Detrics`
    * **URL:** `https://mcp.detrics.io`

    No trailing slash, no `/sse` suffix. Just the base URL.
  </Step>

  <Step title="Click Connect">
    Click **Connect** next to the Detrics connector that appears in your list.
  </Step>

  <Step title="Authorize with your Detrics account">
    You will be redirected to Detrics. Sign in with your account to authorize access. Once authorized, the connection is established.
  </Step>

  <Step title="Verify it works">
    Start a new chat in Claude and ask:

    ```
    What platforms do I have connected?
    ```

    You should see a list of your connected data sources. If you do, you are all set.
  </Step>
</Steps>

## Example prompts

Once connected, try these:

* "What was my total ad spend across all platforms last month?"
* "Compare my Google Ads and Meta Ads ROAS for the last 30 days"
* "Show me my top 5 campaigns by conversions this week"
* "What's my Shopify revenue trend over the last 90 days?"
* "What metrics are available for TikTok Ads?"

Or browse the [Prompt Templates](/claude/use-prompt-templates) for 40+ ready-made marketing prompts.

## Using AI Contexts

AI Contexts let you pre-select which accounts to query. Instead of specifying platform and account every time, you create a Context once and reference it in your prompts.

See [Create an AI Context](/claude/create-ai-context) to set one up.

## Revoking access

To disconnect Detrics from Claude:

1. Go to Claude **Settings > Connections**
2. Find the Detrics connector
3. Click **Disconnect** or **Remove**

This immediately revokes the OAuth token. You can reconnect at any time from [app.detrics.io/mcp/claude](https://app.detrics.io/mcp/claude).

## Troubleshooting

<AccordionGroup>
  <Accordion title="&#x22;Authorization failed&#x22; or stuck on login page">
    Try these steps:

    1. Clear your browser cookies and try again
    2. Make sure you are using a supported Claude plan (Pro, Team, or Enterprise)
    3. Check that your Detrics account is active at [app.detrics.io](https://app.detrics.io)
    4. Try opening the connection flow from a private/incognito window
  </Accordion>

  <Accordion title="&#x22;Connection error&#x22; after authorizing">
    This usually means the MCP server URL was entered incorrectly.

    **Fix:** Make sure the server URL is exactly `https://mcp.detrics.io`. Enter the base URL by itself, with no trailing slash and no `/sse` suffix.
  </Accordion>

  <Accordion title="Claude cannot access Detrics tools">
    The MCP connection may have expired or been disconnected.

    **Fix:**

    1. Go to Claude Settings > Connections
    2. Remove the existing Detrics connection
    3. Reconnect from [app.detrics.io/mcp/claude](https://app.detrics.io/mcp/claude)
  </Accordion>

  <Accordion title="&#x22;No connections found&#x22; response">
    Your Claude connection works, but there are no platforms connected in your Detrics workspace.

    **Fix:**

    1. Go to [app.detrics.io](https://app.detrics.io) and connect at least one data source
    2. Or ask Claude: "Connect my Facebook Ads account", it will generate an OAuth link for you
  </Accordion>
</AccordionGroup>

For more issues, see [Troubleshooting](/claude/troubleshooting).


# Create an AI Context
Source: https://support.detrics.io/claude/create-ai-context

Define which data sources and accounts your AI should query

## What are AI Contexts?

An AI Context is a saved configuration that tells Claude which platforms and accounts to use by default. Instead of specifying account IDs in every prompt, you create a Context once and reference it by name.

**Without an AI Context:**

```
Query my Facebook Ads data for account 1234567890, show me spend and ROAS for the last 30 days
```

**With an AI Context:**

```
Show me my performance report for the last 30 days
```

AI Contexts are shared with all workspace members, making them useful for agencies managing multiple clients or teams with recurring reports.

## Create a Context

<Steps>
  <Step title="Go to AI Contexts">
    Open [app.detrics.io/mcp/contexts](https://app.detrics.io/mcp/contexts), or navigate to **AI Agents > AI Contexts** in the sidebar.

    <Frame>
      <img alt="AI Contexts page showing a list of saved contexts with platform icons and account counts" />
    </Frame>
  </Step>

  <Step title="Click + New Context">
    Click the green **+ New Context** button in the top right corner.

    <Frame>
      <img alt="AI Contexts page with the New Context button highlighted" />
    </Frame>
  </Step>

  <Step title="Name your Context">
    Give it a descriptive name that Claude can understand in natural language.

    **Good names:**

    * "Weekly performance report"
    * "Client A - Meta Ads"
    * "All e-commerce accounts"
    * "Detrics Traffic"

    **Avoid generic names** like "Context 1" or "Test", the clearer the name, the easier it is for your AI to match your prompts to the right context.
  </Step>

  <Step title="Select platforms and accounts">
    Choose which platform connections and accounts this Context should include. You can select multiple platforms and multiple accounts from each platform.

    You can add additional platforms by clicking **+ Add data source**.
  </Step>

  <Step title="Save">
    Click **Save Changes**. Your Context is now available to Claude through the MCP tools.
  </Step>
</Steps>

## Use Contexts in Claude

Once you have created Contexts, reference them by name in your prompts:

```
List my available AI Contexts
```

```
Run the weekly performance report for the last 7 days
```

```
Show me the Client A Meta Ads data for this month
```

Claude will automatically list your Contexts, select the right one, and use it to query your data.

<Tip>
  **Pair Contexts with Prompt Templates** for maximum efficiency. Create a Context for each client or report, then use [Prompt Templates](/claude/use-prompt-templates) with the "Use with Context" button to auto-fill the data scope.
</Tip>

## Managing Contexts

From [app.detrics.io/mcp/contexts](https://app.detrics.io/mcp/contexts) you can:

* **View all Contexts** in your workspace
* **Edit** existing Contexts to update platforms, accounts, or names
* **Delete** Contexts that are no longer needed

Changes take effect immediately. Claude will use the updated configuration on the next query.

## MCP tools for Contexts

Claude uses these MCP tools automatically when working with Contexts:

| Tool                                     | What it does                                             |
| ---------------------------------------- | -------------------------------------------------------- |
| `list_contexts`                          | Lists all Contexts available in your workspace           |
| `get_context`                            | Gets the full details of a specific Context              |
| `query_marketing_data` with `context_id` | Queries data using the Context's pre-configured settings |

See [Available Tools](/claude/available-tools) for the full tool reference.


# Detrics for Claude
Source: https://support.detrics.io/claude/overview

Chat with your marketing data using Claude, the most intelligent AI model for marketing analysis

## Chat with your marketing data

Detrics connects to Claude through the **Model Context Protocol (MCP)**, an open standard that lets AI models interact with external data sources. Once connected, you can query ad spend, ROAS, conversions, revenue, and more across all your platforms using natural language.

Just ask questions in plain language and get answers straight from your live data.

## Two ways to connect

<CardGroup>
  <Card title="Claude Web" icon="bolt" href="/claude/claude-web">
    **Recommended.** Connect via OAuth in \~30 seconds, straight from your browser.
  </Card>

  <Card title="Claude Code" icon="terminal" href="/claude/claude-code">
    Anthropic's CLI coding agent. One command + API key.
  </Card>
</CardGroup>

## What you can do

Once connected, Claude can:

* **Query marketing data**: spend, ROAS, conversions, revenue, CPA, and hundreds of other metrics across 30+ platforms
* **Compare platforms**: side-by-side analysis across Meta Ads, Google Ads, TikTok, Shopify, and more
* **Analyze campaigns**: find top performers, spot anomalies, identify optimization opportunities
* **Browse available fields**: discover every metric and dimension available for each platform
* **Use AI Contexts**: pre-select which accounts to query so you skip the setup in every prompt
* **Use Prompt Templates**: 40+ ready-made marketing analysis prompts you can copy and use immediately
* **Connect new platforms**: add data sources directly from the chat via OAuth
* **Manage your BigQuery warehouse**: create destinations, build table groups, and schedule and run transfers, all from the chat

## How it works

```
Claude (Web or Claude Code)
        |
   Detrics MCP Server (authenticated via OAuth or API key)
        |
   Marketing Platform APIs (Meta, Google, TikTok, Shopify, etc.)
```

**For Claude Web:** You connect through OAuth from the Detrics web app, no API key or installation needed.

**For Claude Code:** You generate an API key, register the Detrics MCP server with a single command, and start querying.

## Next steps

<CardGroup>
  <Card title="Connect Claude Web" icon="bolt" href="/claude/claude-web">
    Get set up in under 30 seconds, our recommended path.
  </Card>

  <Card title="Create an AI Context" icon="layer-group" href="/claude/create-ai-context">
    Pre-select your accounts so every prompt is simpler.
  </Card>

  <Card title="Browse Prompt Templates" icon="grid-2" href="/claude/use-prompt-templates">
    40+ ready-made marketing analysis prompts.
  </Card>

  <Card title="Available Tools" icon="wrench" href="/claude/available-tools">
    Full reference of every MCP tool Detrics exposes.
  </Card>
</CardGroup>


# Troubleshooting
Source: https://support.detrics.io/claude/troubleshooting

Common issues and fixes for the Detrics MCP server

## Claude Code issues

<AccordionGroup>
  <Accordion title="&#x22;detrics already exists&#x22; error">
    This happens when you try to add the Detrics MCP server but it is already registered.

    **Fix:** Remove the existing server first, then re-add it.

    ```bash theme={null}
    claude mcp remove detrics
    claude mcp add detrics-mcp https://mcp.detrics.io -e DETRICS_API_KEY=your-api-key -t streamable-http
    ```
  </Accordion>

  <Accordion title="&#x22;DETRICS_API_KEY is required&#x22; error">
    The MCP server started but could not find your API key in the environment.

    **Causes:**

    * The API key was not passed correctly when adding the server
    * The environment variable name was misspelled

    **Fix:** Remove and re-add the server, making sure the `-e DETRICS_API_KEY=...` flag is included with your full API key.
  </Accordion>

  <Accordion title="&#x22;Unauthorized&#x22; or invalid key error">
    The API key was provided but is not valid.

    **Causes:**

    * The key was revoked from the web app
    * The key was copied incorrectly (missing characters)
    * The key belongs to a different workspace

    **Fix:**

    1. Check if the key is still active at [app.detrics.io/mcp](https://app.detrics.io/mcp)
    2. If revoked, generate a new key and update Claude Code (see [Claude Code](/claude/claude-code#updating-your-api-key))
    3. Make sure you are using a key from the correct workspace
  </Accordion>
</AccordionGroup>

## Claude Web OAuth issues

<AccordionGroup>
  <Accordion title="&#x22;Authorization failed&#x22; or stuck on login page">
    This usually happens when the OAuth flow is interrupted.

    **Fix:**

    1. Clear your browser cookies and try again
    2. Make sure your Detrics account is active at [app.detrics.io](https://app.detrics.io)
    3. Try opening the connection flow in a private/incognito window
    4. Make sure you are on a supported plan (Claude Pro or higher)
  </Accordion>

  <Accordion title="&#x22;Connection error&#x22; when adding the MCP server URL">
    The server URL was entered incorrectly.

    **Fix:** The URL must be exactly:

    ```
    https://mcp.detrics.io
    ```

    Enter the base URL by itself, with no trailing slash, no `/sse` suffix, and no `/mcp` path.
  </Accordion>

  <Accordion title="Claude cannot access Detrics tools">
    The MCP connection may have expired or been removed.

    **Fix:**

    1. Go to Claude **Settings > Connections**
    2. Remove the existing Detrics connection
    3. Reconnect from [app.detrics.io/mcp/claude](https://app.detrics.io/mcp/claude)
  </Accordion>
</AccordionGroup>

## Data query issues

<AccordionGroup>
  <Accordion title="&#x22;No connections found&#x22; response">
    Claude can reach Detrics, but there are no platforms connected in your workspace.

    **Fix:**

    1. Go to [app.detrics.io](https://app.detrics.io) and connect at least one data source
    2. Or ask Claude: "Connect my Facebook Ads account", it will generate an OAuth link for you
  </Accordion>

  <Accordion title="&#x22;Unknown platform_api&#x22; error">
    The platform identifier used in the query does not match any supported platform.

    **Fix:** Use the exact platform identifiers. Ask Claude: "List my connections" to see the correct `platform_api` values for your connected platforms.

    Common identifiers include: `facebook_ads`, `google_ads`, `tiktok_ads`, `shopify`, `google_analytics_4`, `linkedin_ads`, `pinterest_ads`, `bing_ads`, `stripe`.
  </Accordion>

  <Accordion title="Fields not found or invalid field error">
    The metric or dimension name used in a query does not exist for that platform.

    **Fix:** Ask Claude to list available fields first:

    ```
    What metrics and dimensions are available for Google Ads?
    ```

    This calls `list_fields` and returns all valid field names for the platform.
  </Accordion>
</AccordionGroup>

## Still need help?

<Card title="Chat with Support" icon="comments" href="https://support.detrics.io/chat">
  Reach out to our support team for help with any issues not covered here.
</Card>


# Use Prompt Templates
Source: https://support.detrics.io/claude/use-prompt-templates

40+ ready-made marketing analysis prompts, copy or use with your AI context

## What are Prompt Templates?

Prompt Templates are pre-written marketing analysis prompts you can copy and use directly with Claude. They cover the most common reporting tasks so you do not have to figure out how to phrase your questions.

Browse all templates at [app.detrics.io/mcp/templates](https://app.detrics.io/mcp/templates).

<Frame>
  <img alt="Prompt Templates page showing a grid of ready-made marketing analysis prompts with Copy and Use with Context buttons" />
</Frame>

## How to use them

<Steps>
  <Step title="Browse templates">
    Open the [Prompt Templates](https://app.detrics.io/mcp/templates) page in the Detrics web app. Templates are organized by category, performance, ROAS, conversions, e-commerce, and more.
  </Step>

  <Step title="Copy or use with Context">
    Each template has two buttons:

    * **Copy**: copies the prompt text to your clipboard. Paste it into Claude.
    * **Use with Context**: lets you select an [AI Context](/claude/create-ai-context) to automatically scope the prompt to specific accounts and platforms.
  </Step>

  <Step title="Paste and run">
    Paste the prompt in Claude and send it. Claude will call the Detrics MCP tools, fetch your data, and return the analysis.
  </Step>

  <Step title="Customize as needed">
    All templates are starting points. Adjust date ranges, platform names, or account details to match your needs:

    ```
    What was my total ad spend across all platforms last month?
    ```

    Can become:

    ```
    What was my total ad spend on Meta Ads and Google Ads for Q1 2026?
    ```
  </Step>
</Steps>

## Template categories

### Performance Overview

Get a high-level summary of how your marketing is performing.

* "Give me a full performance overview for the last 30 days, spend, ROAS, conversions, and CPA"
* "Summarize my marketing performance this week compared to last week"
* "What was my total ad spend across all platforms last month?"

### Cross-Platform Comparison

Compare performance across different platforms and channels.

* "Compare Google Ads vs Meta Ads spend and ROAS for the last 30 days"
* "Which platform had the best CPA this month?"
* "Show me a breakdown of spend by platform for the last quarter"

### Campaign Analysis

Drill down into specific campaigns.

* "Show me my top 5 campaigns by conversions this week"
* "Which Google Ads campaigns are over budget this month?"
* "List all active Meta Ads campaigns with their spend and ROAS"

### Purchase and ROAS Analysis

Understand revenue attribution and return on ad spend.

* "Analyze my purchase and ROAS funnel for the last 30 days"
* "Compare ROAS across all platforms this month"
* "Which campaigns have the highest return on ad spend?"

### E-commerce and Revenue

Analyze revenue, orders, and product performance.

* "What's my Shopify revenue for the last 30 days?"
* "Compare my total ad spend vs Shopify revenue this month"
* "Show me my average order value trend over the last 90 days"

### Lead Generation

Track lead acquisition performance.

* "Analyze my lead generation results for the last 30 days"
* "Which platforms are generating the most leads?"
* "What's my cost per lead across all channels?"

## Suggested workflow

For the best results when working with Claude:

1. **Start with a performance overview**: get the big picture first
2. **Drill down into problem areas**: use campaign or platform-specific templates to investigate
3. **Set up AI Contexts** for recurring reports, create a Context once, then use simple prompts every time

See [Create an AI Context](/claude/create-ai-context) to streamline your recurring queries.


# Connect a Platform
Source: https://support.detrics.io/connect/connect-a-platform

Step-by-step guide to connecting your marketing platforms to Detrics

Connecting a platform takes less than a minute. The process is the same whether you are using the web app, Google Sheets sidebar, or Looker Studio.

## From the Web App

<Steps>
  <Step title="Go to Data Sources">
    Log in to [app.detrics.io](https://app.detrics.io) and click **Data Sources** in the left sidebar.

    <Frame>
      <img alt="Data Sources page showing all connected platforms" />
    </Frame>

    You will see all available platforms listed with their current connection counts.
  </Step>

  <Step title="Select a Platform">
    Click on the platform you want to connect (e.g., Meta Ads, Google Ads, Shopify). This opens the platform's connection page.
  </Step>

  <Step title="Authorize Access">
    Click the **Connect** button. You will be redirected to the platform's official OAuth authorization page. Sign in with the account that has access to the data you need, and grant Detrics read-only permission.

    <Tip>
      For Meta Ads, make sure you are logged into the Facebook account that has admin or analyst access to the ad accounts you want to query.
    </Tip>
  </Step>

  <Step title="Select Accounts">
    After authorizing, Detrics loads your available accounts. Select the ones you want to work with. You can always add more accounts later.
  </Step>

  <Step title="Start Querying">
    Your connection is ready. You can now use it in Google Sheets, Looker Studio, Claude, or the Data Warehouse.
  </Step>
</Steps>

## From Google Sheets

If you are working in Google Sheets, you can connect platforms directly from the Detrics sidebar.

<Steps>
  <Step title="Open the Sidebar">
    Go to **Extensions > Detrics > Launch Detrics** in your Google Sheet.
  </Step>

  <Step title="Click Connect Data Source">
    In the sidebar, click **Connect Data Source** and choose the platform you want to add.

    <Frame>
      <img alt="Connect Account button in the Detrics sidebar" />
    </Frame>
  </Step>

  <Step title="Choose Your Platform">
    Select the data source from the list of available platforms.

    <Frame>
      <img alt="Selecting a data source" />
    </Frame>
  </Step>

  <Step title="Authorize and Select Accounts">
    Complete the OAuth flow and select the accounts you want to use. The connection is now available in your workspace.
  </Step>
</Steps>

## From Looker Studio

For Looker Studio, connections are created during the connector setup process. See the [Looker Studio Quickstart](/looker-studio/quickstart) for the full walkthrough.

## Platform-Specific Notes

Some platforms have special requirements:

* **Meta Ads / Facebook**: You need admin or analyst access to the ad account. If you manage multiple Business Managers, make sure you authorize with the right Facebook account.
* **Google Ads**: Requires a Google account with access to the Google Ads MCC or individual accounts.
* **Shopify**: Uses a store-level connection. You need store owner or staff access.
* **Stripe / TiendaNube**: These use centralized tokens. One connection per account is shared across all workspaces.

<Warning>
  If a connection fails or shows an error, see [Troubleshooting Connections](/connect/troubleshooting-connections) for solutions.
</Warning>


# How Connections Work
Source: https://support.detrics.io/connect/overview

Understand how Detrics connects to your marketing platforms

Detrics uses **OAuth-based connections** to securely access your marketing platform data. This means you grant Detrics read-only access to your accounts through each platform's official authorization flow, no passwords are stored or shared.

## Key Concepts

### One Connection per Platform

Each platform (Meta Ads, Google Ads, Shopify, etc.) requires its own connection. A single connection can give you access to multiple accounts within that platform. For example, one Meta Ads connection might unlock 10+ ad accounts.

### Workspace-Level Sharing

Connections are created within a **workspace**. By default, all connections are **public**, every team member in your workspace can use them to run queries. You can also restrict a connection so only specific team members have access.

<Note>
  For details on connection sharing and permissions, see [Connection Sharing & Permissions](/workspace/shared-private-connections).
</Note>

### What Data Can Detrics Access?

Detrics requests **read-only access** to your marketing data. It cannot modify campaigns, change budgets, or take any action on your behalf. The specific data available depends on the platform, see the [Fields Catalog](/fields-catalog/index) for a full breakdown by platform.

## Supported Platforms

Detrics connects to 30+ marketing, analytics, and e-commerce platforms. For the complete, always-current list, see the [Fields Catalog](/fields-catalog/index) — the source of truth for every supported platform and its available fields.

## Next Steps

<CardGroup>
  <Card title="Connect a Platform" icon="plug" href="/connect/connect-a-platform">
    Step-by-step guide to connecting your first data source
  </Card>

  <Card title="Troubleshooting" icon="wrench" href="/connect/troubleshooting-connections">
    Fix common connection issues
  </Card>
</CardGroup>


# Troubleshooting Connections
Source: https://support.detrics.io/connect/troubleshooting-connections

Fix common issues when connecting platforms to Detrics

Connection issues usually fall into one of three categories: authorization failures, missing accounts, or expired tokens. Here is how to diagnose and fix them.

## Common Issues

### Authorization Fails or Gets Stuck

**Symptoms:** The OAuth popup closes without completing, or you see a generic error after authorizing.

**Solutions:**

* Disable browser pop-up blockers for `app.detrics.io`
* Clear your browser cookies and try again
* Make sure you are authorizing with the correct account (e.g., the Google account that has Google Ads access, not a personal one)
* Try using an incognito/private browser window

### No Accounts Appear After Connecting

**Symptoms:** The connection succeeds but no ad accounts or properties are listed.

**Solutions:**

* Verify that the account you authorized with actually has access to the data. For example, with Meta Ads, you need admin or analyst role on the ad account.
* For Google Ads, make sure your Google account is linked to the MCC or individual ad account.
* Wait a few seconds and refresh, account loading can sometimes take a moment.

### Connection Shows "Expired" or "Disconnected"

**Symptoms:** A previously working connection stops working, or shows a warning badge.

**Solutions:**

* **Reconnect** the platform from the Data Sources page. Click on the platform, find the expired connection, and click the reconnect button.
* If you recently changed your password on the platform, you will need to reauthorize.
* For Meta/Facebook connections, token expiration can happen if Facebook detects unusual activity. Reconnecting resolves this.

### Data Returns Empty or Errors

**Symptoms:** Queries run but return no data or throw errors.

**Solutions:**

* Check that the account you selected actually has data for the time period you are querying
* Verify the connection is still active in **Data Sources**
* For platform-specific API errors, check the troubleshooting guides below

## Platform-Specific Troubleshooting

For detailed troubleshooting guides per platform, see:

<CardGroup>
  <Card title="Facebook / Meta Ads" icon="bullhorn" href="/data-source/facebook-ads/troubleshooting">
    OAuth issues, Business Manager access, token expiration
  </Card>

  <Card title="Google Ads" icon="rectangle-ad" href="/data-source/google-ads/troubleshooting">
    MCC access, account linking, API errors
  </Card>

  <Card title="TikTok Ads" icon="video" href="/data-source/tiktok-ads/troubleshooting">
    Business Center access, API limitations
  </Card>

  <Card title="LinkedIn Ads" icon="briefcase" href="/data-source/linkedin-ads/troubleshooting">
    Campaign Manager access, permission issues
  </Card>
</CardGroup>

## Still Need Help?

If you have tried the steps above and the issue persists, reach out to support:

* **Email:** [support@detrics.io](mailto:support@detrics.io)
* **Live chat:** Click the chat bubble in the bottom-right corner of [app.detrics.io](https://app.detrics.io)

Include the platform name, the error message (if any), and the email address you used to authorize.


# Data Freshness & Platform Delays
Source: https://support.detrics.io/core-functionality/data-freshness

Why recent numbers shift, and when your data becomes final

Detrics fetches data live from each platform's API, so a query reflects what the platform reports at that moment. The platforms themselves, however, keep adjusting recent numbers. Understanding when data is still settling saves a lot of "why don't these numbers match" confusion.

## Why Recent Numbers Change

* **Attribution windows.** Ad platforms credit conversions to clicks and views that happened days earlier. A purchase today can be attributed to a click from last week, so last week's conversion numbers grow after the fact.
* **Processing delays.** Analytics platforms ingest and process events for hours before totals stabilize. The most recent day is almost always incomplete.
* **Restatements.** Platforms remove invalid traffic and correct errors retroactively, which can also revise numbers downward.

The practical consequence: the same query over a recent date range can return different numbers today and tomorrow, and both are correct snapshots of what the platform reported.

## When Data Becomes Final

Each platform has a window after which historical data stops changing, ranging from a couple of days for analytics sources to roughly a month for ad platforms with long attribution windows. Once a date range falls entirely outside that window, the numbers are stable and queries over it are fully reproducible.

If you need exact period totals for reporting, query the period a few days after it closes, or schedule a refresh so the final numbers overwrite the early snapshot.

## Comparing Detrics with the Platform's UI

When a Detrics number differs from what you see in the platform's own dashboard, check these in order:

1. **Date range**: does the platform UI include today the same way your query does?
2. **Timezone**: Detrics interprets dates in UTC; the platform UI uses the account's timezone
3. **Attribution settings**: the UI may display a different attribution window than the API default
4. **Metric definition**: similarly named metrics can measure different things (for example, "views" vs. "plays" on video metrics)

The per-platform troubleshooting pages in the [Fields Catalog](/fields-catalog) cover known discrepancies for each source.

## Keeping Reports Fresh

For dashboards and recurring reports, schedule automatic refreshes instead of pulling data manually. The scheduler re-runs your query, so settling numbers update on their own.

<CardGroup>
  <Card title="Automate Queries in Sheets" icon="clock" href="/data-destination/google-sheets/how-to-automate-a-query">
    Schedule refreshes for spreadsheet reports
  </Card>

  <Card title="BigQuery Sync Scheduling" icon="database" href="/bigquery/scheduling-and-refresh-windows">
    Refresh windows for warehouse syncs
  </Card>
</CardGroup>


# Date Ranges & Time Aggregation
Source: https://support.detrics.io/core-functionality/date-ranges

Control the period your query covers and how it's broken down over time

Two separate settings control time in a Detrics query:

* The **date range** decides which days are included
* The **time aggregation** decides whether those days are summed into one row or broken down by day, week, or month

## Date Range Presets

| Preset                     | Covers                                     |
| -------------------------- | ------------------------------------------ |
| Today                      | The current day                            |
| Yesterday                  | The previous day                           |
| Last 7 / 14 / 30 / 90 days | A rolling window ending today              |
| This week                  | Monday through today                       |
| This month                 | The 1st through today                      |
| This quarter               | The first day of the quarter through today |
| This year                  | January 1st through today                  |

Presets run up to and including today, so the most recent day is usually still incomplete. If you compare against a platform's UI, check whether it includes today the same way.

## Custom Ranges

Besides presets, you can use:

* **Fixed dates**: an exact start and end date
* **Rolling windows**: "last N days / weeks / months / quarters / years", with the option to include or exclude the current (incomplete) period. Excluding it keeps automated reports comparing only complete periods.

## Time Aggregation

| Option      | What you get                                                                |
| ----------- | --------------------------------------------------------------------------- |
| **All**     | One row per dimension combination, with metrics summed over the whole range |
| **Daily**   | A date column is added, one row per day                                     |
| **Weekly**  | One row per week (some platforms also offer US-style weeks starting Sunday) |
| **Monthly** | One row per month                                                           |
| **Hourly**  | One row per hour, on platforms that support it                              |

Availability varies by platform. Most advertising platforms support all, daily, weekly, and monthly; hourly is available on platforms like Meta Ads, Google Ads, and TikTok Ads; some sources (HubSpot, Mailchimp) only support all because their data isn't time-based.

## Unique Metrics Don't Sum Across Periods

Metrics that count unique people, such as **Reach** or **Frequency**, can't be added up across periods. A person reached on Monday and Tuesday counts once in a weekly reach number, but appears in both daily rows.

In practice:

* Summing 30 daily reach rows overstates your real 30-day reach
* To get true reach for a period, query that period with aggregation **All**
* Some platforms limit how long a single reach window can be; Detrics returns an error instead of a wrong number when a range can't be calculated

## Next Steps

<CardGroup>
  <Card title="Filters" icon="filter" href="/core-functionality/filters">
    Keep only the rows you care about
  </Card>

  <Card title="Data Freshness" icon="clock" href="/core-functionality/data-freshness">
    Why recent numbers shift, and when data becomes final
  </Card>
</CardGroup>


# Dimensions & Metrics
Source: https://support.detrics.io/core-functionality/dimensions-and-metrics

The two building blocks of every Detrics query

Every Detrics query is built from the same two ingredients, regardless of the destination you use:

* **Dimensions** are text attributes that group your data: campaign name, country, device, date
* **Metrics** are the numbers measured for each group: spend, impressions, clicks, conversions

## How They Shape Your Results

Each row in your results is one unique combination of your selected dimensions, with the metrics calculated for that combination.

* Query `Campaign Name` + `Spend`: one row per campaign
* Query `Campaign Name` + `Country` + `Spend`: one row per campaign and country pair
* Query `Spend` with no dimensions: a single totals row

Adding a dimension multiplies the level of detail. Removing dimensions rolls the numbers up.

## Not Every Combination Is Available

Detrics exposes what each platform's API supports, and platforms restrict which fields can be combined. For example, some Meta Ads breakdowns can't be mixed with each other, and some TikTok metrics aren't available with hourly aggregation. When a combination isn't supported, Detrics tells you at query time instead of returning misleading data.

Each platform's page in the [Fields Catalog](/fields-catalog) lists the available fields, and the per-platform troubleshooting pages cover the most common incompatibilities.

## Split a Dimension into Columns

In the Google Sheets sidebar you can mark a dimension as a **split dimension**. Instead of adding rows, its values become column groups. For example, splitting by `Device` turns a long table into one row per campaign with metric columns for Mobile, Desktop, and Tablet side by side.

This is a layout feature for spreadsheets: the underlying data is the same as the row-based version, just pivoted for readability.

## Next Steps

<CardGroup>
  <Card title="Date Ranges & Time Aggregation" icon="calendar" href="/core-functionality/date-ranges">
    Control the period your query covers and how it's broken down over time
  </Card>

  <Card title="Filters" icon="filter" href="/core-functionality/filters">
    Keep only the rows you care about
  </Card>
</CardGroup>


# How Filters Work
Source: https://support.detrics.io/core-functionality/filters

Narrow your query results with dimension and metric filters

Filters let you keep only the rows you care about: campaigns whose name contains a keyword, orders above a certain value, a specific country. They work the same way in every destination (Google Sheets, Looker Studio, Claude, and BigQuery).

## How Filters Work

On most platforms, Detrics fetches your data first and then removes the rows that don't match your filters. Because the filtering happens on the Detrics side, the rules below apply consistently regardless of the data source.

Some platforms have a native filtering module, and Detrics is connected to it: on **Google Ads**, **Google Analytics 4**, **Meta Ads**, and **Shopify**, your filters are translated into the platform's own filtering language and applied at the source whenever possible. The results are the same; the query is just faster because the platform sends only the matching rows.

Native translation is used only when your filters map cleanly to what the platform supports. In particular, filter chains that mix AND and OR are always evaluated by Detrics itself, so the combining rules described below hold on every platform.

There are two kinds of filters:

* **Dimension filters** compare text values (campaign name, country, device)
* **Metric filters** compare numbers (spend, impressions, conversions)

## Dimension Filter Operators

| Operator                     | What it does                                                                                              | Example                                           |
| ---------------------------- | --------------------------------------------------------------------------------------------------------- | ------------------------------------------------- |
| **Contains**                 | Keeps rows where the value includes your text                                                             | `Contains "sale"` matches "Summer sale 2026"      |
| **Does not Contain**         | Removes rows where the value includes your text                                                           | `Does not Contain "test"` removes "test campaign" |
| **Equals**                   | Keeps rows where the value matches your text exactly                                                      | `Equals "US"` matches "US" but not "USA"          |
| **Does not Equal**           | Removes rows where the value matches exactly                                                              | `Does not Equal "Paused"`                         |
| **Regex Contains**           | Keeps rows that contain **any** of several texts, separated by `\|`                                       | `Regex Contains "sale\|promo\|launch"`            |
| **Regex Contains Exact**     | Keeps rows that exactly match **any** of several texts, separated by `\|`                                 | `Regex Contains Exact "US\|MX\|AR"`               |
| **Regex Not Contains Exact** | Removes rows that exactly match **any** of the `\|`-separated texts (the inverse of Regex Contains Exact) | `Regex Not Contains Exact "US\|MX"`               |

<Warning>
  **Matching is case-sensitive.** `Contains "SALE"` will not match a campaign named "Summer Sale 2026". Write the value with the exact casing your platform uses, or cover the variants with Regex Contains: `sale|Sale|SALE`.
</Warning>

### About Regex Contains

Despite the name, Regex Contains does not accept full regular expression syntax. It accepts a list of plain texts separated by `|`, and keeps a row when the value contains any of them. Spaces around each text are ignored, and you can optionally wrap the whole list in parentheses: `(sale|promo)` works the same as `sale|promo`.

On the platforms that use this fallback, regex syntax such as `^`, `$`, `.*`, or character classes is treated as literal text, so `^Brand.*` looks for a value that literally contains "^Brand.\*".

**Regex Contains Exact** uses the same `|` list, but the value must match one of the texts entirely instead of just containing it. **Regex Not Contains Exact** is the inverse: it removes rows that exactly match any text in the list.

<Note>
  **Google Ads and Google Analytics 4 are the exception.** On these two platforms the regex operators are applied natively at the source and accept **full regular expression syntax** (RE2, the same engine Google's own APIs use), matching **case-insensitively**. Metacharacters like `^`, `$`, `.`, `*`, `+`, `?`, `\d`, `[...]`, `{n,m}`, and `|` all work. On every other platform the operators fall back to the plain `|` list described above, so if you need a filter to behave identically everywhere, stick to that list.
</Note>

### Full Regex on GA4 and Google Ads

On GA4 and Google Ads you can write real regular expressions. The one thing to keep straight is **partial vs. exact matching**, because it decides whether you need to wrap the pattern in `.*`:

* **Regex Contains** matches the pattern **anywhere** in the value. `^Brand_` keeps values that start with "Brand\_"; `\d{4}` keeps any value that contains four consecutive digits.
* **Regex Contains Exact** and **Regex Not Contains Exact** require the **whole value** to match. To match "contains X" here, add `.*` on both sides: `.*X.*`.

**Example — exclude campaigns whose name contains `_BND`, or that are a 9-to-21-digit ID:**

* Operator: **Regex Not Contains Exact**
* Value: `.*_BND.*|\d{9,21}`

The `.*` around `_BND` is required because this operator matches the entire value, and `\d{9,21}` matches an all-numeric name between 9 and 21 characters long. The two alternatives are joined with `|`.

## Metric Filter Operators

| Operator             | What it does                                    |
| -------------------- | ----------------------------------------------- |
| **Greater Than**     | Keeps rows where the metric is above your value |
| **Less Than**        | Keeps rows where the metric is below your value |
| **Greater or Equal** | Keeps rows at or above your value               |
| **Smaller or Equal** | Keeps rows at or below your value               |
| **Does not Equal**   | Removes rows where the metric equals your value |

Metric values are compared as numbers. A row with an empty metric counts as `0`, so `Greater Than 0` is a handy way to remove empty rows.

## Combining Filters

You can chain several filters with **AND** / **OR**:

* **AND**: the row must pass both conditions
* **OR**: the row must pass at least one

Conditions are evaluated strictly in order, from left to right. Each condition combines with the accumulated result of everything before it, and there is no grouping with parentheses. Note that this differs from SQL and spreadsheet formulas, where AND takes precedence over OR.

This means the **order of your filters defines the grouping**. Compare these two arrangements of the same three conditions on a campaign name:

| Filters in order                                    | Evaluates as   | Returns                                                 |
| --------------------------------------------------- | -------------- | ------------------------------------------------------- |
| `Contains "A"` AND `Contains "B"` OR `Contains "C"` | (A and B) or C | Campaigns with both A and B, plus every campaign with C |
| `Contains "A"` OR `Contains "C"` AND `Contains "B"` | (A or C) and B | Campaigns with A or C, but only if they also contain B  |

<Tip>
  To express "matches any of these keywords, and always meets this condition", list the OR alternatives first and put the must-have condition last. For the OR part you can also use a single Regex Contains filter (`A|C`) instead of multiple OR cards, which keeps the chain simpler.
</Tip>

## Filtering on Fields Not in Your Query

As a general rule, a filter references a field that is part of the query: if you filter on `Campaign Name`, Campaign Name should be one of your selected dimensions.

Three platforms also support **dimensionless filtering**, where you can filter on a dimension without selecting it:

* Google Analytics 4
* Meta Ads
* Shopify

On these platforms, Detrics fetches the filter field behind the scenes, applies your condition, and leaves it out of the final results. On every other platform, filtering on a field that isn't in the query returns an error asking you to add the field as a dimension.

Dimensionless filters have a couple of extra limits: on Shopify they can't mix AND and OR in the same query, and some operators or field combinations may be rejected depending on the platform. The error message always names the field or operator that needs adjusting.

## Empty Values

* An empty or missing **dimension** is treated as empty text (`""`)
* An empty or missing **metric** is treated as `0`
* **Boolean** dimensions (true/false fields) are the one case-insensitive exception: `true`, `True`, and `TRUE` all match


# Multi-Account Queries
Source: https://support.detrics.io/core-functionality/multi-account-queries

Query several accounts of the same platform in a single query

A single query targets one platform, but it can cover **several accounts** of that platform at once: all your Meta ad accounts, every Shopify store, or a selection of Google Ads accounts under your connection.

## How Results Are Combined

Detrics runs the query against each account and stacks the resulting rows into one table. The rows are **concatenated, never summed across accounts**: if you query total spend with no dimensions across 3 accounts, you get 3 rows (one per account), not one combined row.

To tell the rows apart, add the **Account Name** or **Account ID** dimension. Without it, rows from different accounts look identical and a multi-account daily report becomes ambiguous: three accounts produce three rows for the same date.

## Currencies and Timezones

Each account reports in its own currency and timezone, and Detrics returns the values exactly as the platform reports them, with no currency conversion. Summing spend across a USD account and an ARS account produces a meaningless number; keep mixed-currency accounts in separate rows or convert in your destination.

## Errors on Individual Accounts

If access to one of the accounts was lost (a removed permission or a deactivated account, for example), Detrics still returns the data from the remaining accounts, together with a warning identifying the affected account. Any other error stops the whole query, so you never receive silently incomplete totals. See [Troubleshooting Connections](/connect/troubleshooting-connections) for fixing access issues.

## Next Steps

<CardGroup>
  <Card title="Dimensions & Metrics" icon="table" href="/core-functionality/dimensions-and-metrics">
    The building blocks of every query
  </Card>

  <Card title="Data Freshness" icon="clock" href="/core-functionality/data-freshness">
    Why recent numbers shift, and when data becomes final
  </Card>
</CardGroup>


# Sorting & Column Order
Source: https://support.detrics.io/core-functionality/sorting-and-column-order

Control how rows are ordered and how columns are arranged in your results

## Sorting

You can sort your results by any field in the query, ascending or descending. Up to **three sort levels** can be combined: rows are ordered by your first sort field, ties are broken by the second, and remaining ties by the third.

A typical setup for a campaign report: sort by `Date` ascending first, then by `Spend` descending, so each day lists its biggest spenders on top.

Sorting is applied by Detrics before the data reaches your destination, so the rows arrive already ordered.

<Note>
  In Looker Studio, charts and tables usually re-sort data themselves. Set the sort inside the Looker report; the query-level sort mostly matters for Sheets, Claude, and BigQuery.
</Note>

## Column Order

Columns appear in the order you selected your fields, with dimensions first and metrics after. In the Google Sheets sidebar you can rearrange them by dragging fields before running the query.

Column order is a presentation setting: changing it never changes the values, only where they land.

## Next Steps

<CardGroup>
  <Card title="Multi-Account Queries" icon="layer-group" href="/core-functionality/multi-account-queries">
    Query several accounts of the same platform at once
  </Card>

  <Card title="Filters" icon="filter" href="/core-functionality/filters">
    Keep only the rows you care about
  </Card>
</CardGroup>


# Dashboard Templates
Source: https://support.detrics.io/data-destination/google-sheets/dashboard-templates

Pre-built dashboard templates ready to use in Google Sheets

## Introduction

Save time with our collection of pre-built dashboard templates designed for Google Sheets. These templates are ready to use and can be customized to match your specific reporting needs. Each template includes:

* Pre-configured queries optimized for performance
* Professional layouts with data visualization best practices
* Automatic refresh capabilities
* Easy customization options

Simply select a template below, connect your data sources, and start generating insights immediately.

## Special Events Hourly Report

This template is designed for monitoring and analyzing special events, campaigns, or time-sensitive activities with hourly granularity. Perfect for:

* Black Friday/Cyber Monday campaigns
* Product launches
* Flash sales
* Live events monitoring
* Time-limited promotions

### Key Features

* **Hourly Performance Tracking**: Monitor key metrics updated every hour with automatic data refresh
* **Multi-channel Overview**: Track performance across all connected advertising platforms (template includes Facebook/Meta Ads, Google Ads, and TikTok Ads by default, but more data sources can be added)
* **Flexible Data Views**: Break down performance by individual days (like "today"), all days of the event combined, by individual channels, or view all channels together
* **Campaign-Level Analysis**: Drill down to see all campaigns within a specific channel
* **Dynamic Setup**: Filters to change channels and campaigns being analyzed
* **Automatic Alerts**: Set up threshold-based notifications for critical metrics

Here's what part of the final report looks like once set up:

<Frame>
  <img alt="Special Events Dashboard - Final Report View" />
</Frame>

### How to Use This Template

Follow these steps to set up and use the Special Events Hourly Report template:

<AccordionGroup>
  <Accordion title="Step 1: Duplicate Template File">
    Go to [this template file](https://docs.google.com/spreadsheets/d/1yXgyR0XXvJy9-WV5cy5E1pqCVGFlhoM4pfaVLlvauvc/edit?gid=321005385#gid=321005385) and then **File > Make a Copy > Name your file > Make a Copy**
  </Accordion>

  <Accordion title="Step 2: Open Detrics">
    If you've never installed Detrics before, <a href="/quickstart/google-sheets">install it first</a>. If you've already installed Detrics, continue.

    In your new file, navigate to **Extensions > Detrics > Launch Detrics** in the menu bar

    <Frame>
      <img alt="Open Detrics Sidebar" />
    </Frame>
  </Accordion>

  <Accordion title="Step 3: Connect Data Source">
    If it's the first time you open Detrics, connect at least 1 data source by clicking the **"Connect Data Source"** button. Select one data source from all the available options and complete the authentication process. If you have used Detrics in the past, go to the next step.

    **Note:** The images below are illustrative. You can connect as many data sources as you'd like.

    <Frame>
      <img alt="Connect Data Source" />
    </Frame>

    <Frame>
      <img alt="Select Data Source" />
    </Frame>
  </Accordion>

  <Accordion title="Step 4: Connect Google Sheets">
    Select **"Connect Data Source"** again, scroll down and select **Google Sheets**.

    <Frame>
      <img alt="Connect Google Sheets" />
    </Frame>
  </Accordion>

  <Accordion title="Step 5: Copy Queries">
    Copy the following code:

    <CodeGroup>
      ```json theme={null}
      [{"spreadsheet":{"spreadsheetGoogleId":"1yXgyR0XXvJy9-WV5cy5E1pqCVGFlhoM4pfaVLlvauvc","sheetId":"1654721591","spreadsheetName":"Copy of Cyber daily report","dataplugId":"f941e03d-1dbe-4e89-a279-046f02909a20","sheetName":"DB_Meta","timezone":"America/Buenos_Aires"},"trigger":{"paused":false,"timezone":"America/Buenos_Aires","lastExecutionErrorList":[],"triggerId":"fef728aa-af59-4381-83db-537f0391a333","regularity":"hourly","notificationEmail":"","userId":"","errorNotificationPreference":"none","pauses":[],"executions":[],"dayOfWeek":[0,1,2,3,4,5,6],"dataplugId":"f941e03d-1dbe-4e89-a279-046f02909a20","timeInterval":1},"automationStatus":{"isPaused":false,"statusSource":"TRIGGER","nextScheduledExecutionTime":"2025-10-20 07:14","timezone":"America/Buenos_Aires","connectionStatus":{"isConnected":true,"wasRecentlyReconnected":false},"lastStatusUpdate":"2025-10-20 07:14","primaryStatus":"NEWLY_CREATED","nextUpdate":{"days":0,"hours":16}},"user":{"createdAt":"2023-01-30T10:08:59.000Z","isDeleted":false,"pictureUrl":"https://lh3.googleusercontent.com/a/ACg8ocJZbO_vflt4h-V0yczLXeedGxEEX3OCW0AQlUAeTOHJlQu0IR8=s96-c","name":"ABN Digital","isAdminUser":false,"id":"","stripeCustomerId":"cus_OgVgFs4AVB5EGG","email":"team@abndigital.com.ar","isEmailVerified":true},"dataplug":{"timeframeEndDate":"today","timeAggregation":"hourly","timeframeStartDate":"2025-10-15","destinationOptions":{"appendData":false,"targetCell":""},"splitDimensions":[],"columnsOrder":["date_start","date_stop","hourly_stats_aggregated_by_advertiser_time_zone","campaign_name","spend","inline_link_clicks","impressions","offsite_conversion.fb_pixel_purchase","offsite_conversion.fb_pixel_purchase.value"],"timeframeType":"CUSTOM","filters":[],"timeframePreset":"","userId":"","platform":"facebook","executions":[{"errorMessages":[],"dataplugExecutionId":"aa3fd2ef-7e0b-4de8-a80f-be27311bee0f","dataplugId":"f941e03d-1dbe-4e89-a279-046f02909a20","executionStartTime":"2025-10-14T22:31:57.000Z","executionSource":"google-sheets","executionEndTime":"2025-10-14 19:32","userId":"","status":"OK"},{"errorMessages":[],"dataplugExecutionId":"942172d5-b518-4d2a-ad4a-96e21b563bb0","dataplugId":"f941e03d-1dbe-4e89-a279-046f02909a20","executionStartTime":"2025-10-14T22:01:54.000Z","executionEndTime":"2025-10-14 19:02","executionSource":"google-sheets","userId":"","status":"OK"}],"sorting":[{"sortingPriority":1,"fieldDisplayName":"Date Start","sorting":"desc","fieldId":"date_start"},{"sortingPriority":2,"fieldDisplayName":"Hour","sorting":"asc","fieldId":"hourly_stats_aggregated_by_advertiser_time_zone"}],"platformApiSpecificOptions":{},"dataplugId":"f941e03d-1dbe-4e89-a279-046f02909a20","platformApi":"facebook-ads","metrics":["spend","inline_link_clicks","impressions","offsite_conversion.fb_pixel_purchase","offsite_conversion.fb_pixel_purchase.value"],"platformIds":["200894091059858"],"dataplugName":"Meta_Raw","dimensions":["campaign_name"]}},{"spreadsheet":{"spreadsheetGoogleId":"1yXgyR0XXvJy9-WV5cy5E1pqCVGFlhoM4pfaVLlvauvc","dataplugId":"b5a61b99-f532-4783-aa5a-26fbc9550579","sheetId":"294751110","spreadsheetName":"Copy of Cyber daily report","sheetName":"DB_Google","timezone":"America/Buenos_Aires"},"trigger":{"paused":false,"timezone":"America/Buenos_Aires","triggerId":"6f3fe569-f3be-432e-8788-1f6f88d980b1","lastExecutionErrorList":[],"regularity":"hourly","userId":"","notificationEmail":"","errorNotificationPreference":"none","pauses":[],"executions":[],"dayOfWeek":[0,1,2,3,4,5,6],"timeInterval":1,"dataplugId":"b5a61b99-f532-4783-aa5a-26fbc9550579"},"automationStatus":{"isPaused":false,"statusSource":"TRIGGER","nextScheduledExecutionTime":"2025-10-20 07:14","timezone":"America/Buenos_Aires","connectionStatus":{"isConnected":true,"wasRecentlyReconnected":false},"lastStatusUpdate":"2025-10-20 07:14","primaryStatus":"NEWLY_CREATED","nextUpdate":{"days":0,"hours":16}},"user":{"createdAt":"2023-01-30T10:08:59.000Z","isDeleted":false,"pictureUrl":"https://lh3.googleusercontent.com/a/ACg8ocJZbO_vflt4h-V0yczLXeedGxEEX3OCW0AQlUAeTOHJlQu0IR8=s96-c","name":"ABN Digital","isAdminUser":false,"id":"","stripeCustomerId":"cus_OgVgFs4AVB5EGG","isEmailVerified":true,"email":"team@abndigital.com.ar"},"dataplug":{"timeframeEndDate":"","timeframeStartDate":"","timeAggregation":"hourly","destinationOptions":{"appendData":false,"targetCell":""},"splitDimensions":[],"timeframeType":"PRESET","columnsOrder":["date","hour","campaign.name","cost_micros","impressions","clicks","conversions","conversions_value"],"filters":[],"timeframePreset":"yesterday","userId":"","platform":"google","executions":[{"errorMessages":[],"dataplugExecutionId":"0bb28edd-5690-4fe0-9228-6d2068934512","dataplugId":"b5a61b99-f532-4783-aa5a-26fbc9550579","executionStartTime":"2025-10-14T22:29:14.000Z","executionSource":"google-sheets","executionEndTime":"2025-10-14 19:29","userId":"","status":"OK"},{"errorMessages":["No data was found! Try removing some filters, switch account or expanding the time frame."],"dataplugExecutionId":"3f902dda-ee32-4598-ba39-7f9fdc580f35","dataplugId":"b5a61b99-f532-4783-aa5a-26fbc9550579","executionStartTime":"2025-10-14T22:01:43.000Z","executionEndTime":"2025-10-14 19:01","executionSource":"google-sheets","userId":"","status":"REQUIRE_PARAMETER_CHANGE"}],"platformApiSpecificOptions":{},"sorting":[{"sortingPriority":1,"fieldDisplayName":"Date","sorting":"desc","fieldId":"date"},{"sortingPriority":2,"fieldDisplayName":"Hour","sorting":"asc","fieldId":"hour"}],"platformApi":"google-ads","dataplugId":"b5a61b99-f532-4783-aa5a-26fbc9550579","platformIds":["6021809624"],"metrics":["cost_micros","impressions","clicks","conversions","conversions_value"],"dataplugName":"Google_Raw","dimensions":["campaign.name"]}},{"spreadsheet":{"spreadsheetGoogleId":"1yXgyR0XXvJy9-WV5cy5E1pqCVGFlhoM4pfaVLlvauvc","dataplugId":"78bf5d36-ccc6-4dda-b141-9044367d5d00","sheetId":"550413206","spreadsheetName":"Copy of Cyber daily report","sheetName":"DB_TikTok","timezone":"America/Buenos_Aires"},"trigger":{"paused":false,"timezone":"America/Buenos_Aires","lastExecutionErrorList":[],"triggerId":"b862e2fa-1dac-4ce8-82bb-d11ec512d35e","regularity":"hourly","userId":"","notificationEmail":"","errorNotificationPreference":"none","pauses":[],"executions":[],"dayOfWeek":[0,1,2,3,4,5,6],"timeInterval":1,"dataplugId":"78bf5d36-ccc6-4dda-b141-9044367d5d00"},"automationStatus":{"isPaused":false,"statusSource":"TRIGGER","nextScheduledExecutionTime":"2025-10-20 07:14","timezone":"America/Buenos_Aires","connectionStatus":{"isConnected":true,"wasRecentlyReconnected":false},"lastStatusUpdate":"2025-10-20 07:14","primaryStatus":"NEWLY_CREATED","nextUpdate":{"days":0,"hours":16}},"user":{"createdAt":"2023-01-30T10:08:59.000Z","isDeleted":false,"pictureUrl":"https://lh3.googleusercontent.com/a/ACg8ocJZbO_vflt4h-V0yczLXeedGxEEX3OCW0AQlUAeTOHJlQu0IR8=s96-c","name":"ABN Digital","isAdminUser":false,"id":"","stripeCustomerId":"cus_OgVgFs4AVB5EGG","isEmailVerified":true,"email":"team@abndigital.com.ar"},"dataplug":{"timeframeEndDate":"2025-10-01","timeAggregation":"hourly","timeframeStartDate":"2025-10-01","destinationOptions":{"appendData":false,"targetCell":""},"splitDimensions":[],"columnsOrder":["stat_time_hour","campaign_name","spend","impressions","clicks","complete_payment","total_complete_payment_rate"],"timeframeType":"CUSTOM","filters":[],"timeframePreset":"","userId":"","platform":"tiktok","executions":[{"errorMessages":[],"dataplugExecutionId":"50e51dae-6a8d-4192-b787-b1e28f097459","dataplugId":"78bf5d36-ccc6-4dda-b141-9044367d5d00","executionStartTime":"2025-10-16T15:13:12.000Z","executionEndTime":"2025-10-16 12:13","executionSource":"google-sheets","userId":"","status":"OK"},{"errorMessages":[],"dataplugExecutionId":"aee6054f-0b57-4ede-937c-0b2581a3600c","dataplugId":"78bf5d36-ccc6-4dda-b141-9044367d5d00","executionStartTime":"2025-10-16T15:11:00.000Z","executionSource":"google-sheets","executionEndTime":"2025-10-16 12:11","userId":"","status":"OK"},{"errorMessages":[],"dataplugExecutionId":"29cbe469-7ebb-4e14-945c-2dbb201daec0","dataplugId":"78bf5d36-ccc6-4dda-b141-9044367d5d00","executionStartTime":"2025-10-14T22:35:23.000Z","executionSource":"google-sheets","executionEndTime":"2025-10-14 19:35","userId":"","status":"OK"},{"errorMessages":[],"dataplugExecutionId":"f4c36279-9914-42b1-90e8-b0fa59146a9d","dataplugId":"78bf5d36-ccc6-4dda-b141-9044367d5d00","executionStartTime":"2025-10-14T22:32:56.000Z","executionEndTime":"2025-10-14 19:34","executionSource":"google-sheets","userId":"","status":"OK"},{"errorMessages":[],"dataplugExecutionId":"54046c34-293b-4073-9772-faddf5d9bd65","dataplugId":"78bf5d36-ccc6-4dda-b141-9044367d5d00","executionStartTime":"2025-10-14T22:30:46.000Z","executionSource":"google-sheets","executionEndTime":"2025-10-14 19:31","userId":"","status":"OK"},{"errorMessages":[],"dataplugExecutionId":"fb3993fc-71c8-4798-b9f1-045f5d601d6b","dataplugId":"78bf5d36-ccc6-4dda-b141-9044367d5d00","executionStartTime":"2025-10-14T22:29:51.000Z","executionEndTime":"2025-10-14 19:30","executionSource":"google-sheets","userId":"","status":"OK"},{"errorMessages":[],"dataplugExecutionId":"2c009200-4f67-4717-9de7-7ec0fc5590cc","dataplugId":"78bf5d36-ccc6-4dda-b141-9044367d5d00","executionStartTime":"2025-10-14T22:01:09.000Z","executionSource":"google-sheets","executionEndTime":"2025-10-14 19:01","userId":"","status":"OK"}],"platformApiSpecificOptions":{},"sorting":[{"sortingPriority":1,"fieldDisplayName":"Datetime","sorting":"asc","fieldId":"stat_time_hour"}],"dataplugId":"78bf5d36-ccc6-4dda-b141-9044367d5d00","platformApi":"tiktok-ads","metrics":["spend","impressions","clicks","complete_payment","total_complete_payment_rate"],"platformIds":["7367448039964917761"],"dataplugName":"TikTok_Raw","dimensions":["campaign_name"]}}]
      ```
    </CodeGroup>
  </Accordion>

  <Accordion title="Step 6: Import Queries">
    In the Detrics navigation menu, go to **"See Queries"** and then select **"Import"**. Queries will be created for Facebook (Meta) Ads, Google Ads and TikTok Ads.

    <Frame>
      <img alt="See Queries" />
    </Frame>

    If any of the data sources mentioned above have not been connected to Detrics, a pop-up will showcase which ones need to be connected. Connect by clicking **"Connect Data Source"** from the pop-up. If you don't want to connect, click **"Proceed Anyway"**.

    <Frame>
      <img alt="Connect new data source" />
    </Frame>
  </Accordion>

  <Accordion title="Step 7: Select Accounts">
    For each data source, select the account from which you want to download data. If you don't have accounts for any data source, ignore it.
  </Accordion>

  <Accordion title="Step 8: Run Queries">
    Run the queries by clicking the blue box next to the search bar inside the **"See Queries"** menu

    <Frame>
      <img alt="Run Queries" />
    </Frame>
  </Accordion>

  <Accordion title="Step 9: Edit Dates">
    In the **"See Queries"** section of the Detrics navigation bar, select the pencil icon to enter "edit" mode. Select the **"Time Frame"** dropdown and choose the **"Start date"** you want (we recommend it being the day the event starts) and select **"Today"** as the end date

    <Frame>
      <img alt="Edit timeframe start date" />
    </Frame>

    <Frame>
      <img alt="Edit timeframe end date" />
    </Frame>
  </Accordion>
</AccordionGroup>


# How to Manage Scheduled Queries in Google Sheets
Source: https://support.detrics.io/data-destination/google-sheets/how-to-automate-a-query

Learn how to set up, manage, and optimize automatic data refreshes in your Google Sheets reports

<Info>**Last updated:** August 2, 2025</Info>

# What are Query Schedules

Query Schedules are configurations that can be added to every Query to automatically update your data. You simply set the time and frequency (every X hours, days, months, etc.) for when you want the data to be refreshed. Once configured, you can open your Google Sheet anytime and all your dashboards will display the most recent data possible - no manual updates needed.

Keep reading to learn more about scheduled queries and how to set them up.

## Understanding Scheduled Queries

Scheduled Queries automatically update your data at specified intervals without manual intervention. This ensures your reports always display the latest information from your connected data sources.

### Benefits of Scheduled Queries

<CardGroup>
  <Card title="Automation" icon="robot">
    Save time by eliminating manual data updates
  </Card>

  <Card title="Consistency" icon="clock">
    Ensure data is refreshed at regular intervals
  </Card>

  <Card title="Accuracy" icon="bullseye">
    Always work with the most recent data
  </Card>

  <Card title="Efficiency" icon="rocket">
    Set it and forget it approach to reporting
  </Card>
</CardGroup>

## How to Set Up a Scheduled Query

<Frame>
  <img alt="Query Schedules button in Google Sheets" />
</Frame>

<Info>
  The Query Schedules feature is your gateway to automation. Click this button
  in your Google Sheets sidebar to activate Google Sheet's offline access.
</Info>

There are three instances where you can automate a query:

### Method 1: After Creating a New Query from Scratch

1. Create and run your query in the Detrics sidebar
2. After running the query, a pop-up will appear at the top of the Detrics sidebar
3. Activate the toggle to schedule automatic refreshes
4. Configure your schedule settings

### Method 2: Editing an Existing Query

1. Open the Detrics sidebar in Google Sheets
2. Go to **See Queries**
3. Click on the calendar with refresh icon 📅🔄
4. Set when you want the query to update

<Note>
  Detrics has autosave enabled by default. If you've opted out of autosave,
  remember to save your query edits manually.
</Note>

### Method 3: Creating a New Query from Template

1. Select **Start from Template** in the Detrics sidebar
2. Choose your data source and template
3. Run the template query
4. After running the template, a toggle to schedule will appear
5. Activate the toggle to enable automatic refreshes

Learn more about [using Query templates](/data-destination/google-sheets/how-to-use-query-templates) to streamline your workflow.

<Note>
  Every query needs to set its own refresh schedule. Only queries with scheduled
  refreshes enabled will automatically update - unscheduled queries will remain
  static until manually refreshed.
</Note>

## How to Manage Existing Schedules

1. Open the Detrics sidebar
2. Go to **See Queries**
3. Click on the icon that looks like a calendar with a refresh 📅🔄
4. You can now either:
   * **Edit the schedule**: Adjust frequency, time, or days
   * **Delete the schedule**: Remove the automatic refresh entirely

<Note>
  Editing one Query's schedule doesn't change the settings of other queries.
  Each Query maintains its own independent schedule configuration.
</Note>

<Tip>
  Need further help with scheduled queries? Contact our support team at
  [support@detrics.io](mailto:support@detrics.io)
</Tip>


# How to Create a Google Sheets Report with Detrics
Source: https://support.detrics.io/data-destination/google-sheets/how-to-create-a-report

Step-by-step guide to creating reports in Google Sheets using Detrics

<Info>**Last updated:** August 2, 2025</Info>

# How to Create a Detrics Query in Google Sheets

This guide will walk you through the process of creating a comprehensive report in Google Sheets using Detrics.

<Note>
  Before starting, make sure you have installed Detrics' add-on and connected to
  at least one data source. See our [Google Sheets quickstart
  guide](/quickstart/google-sheets) for setup instructions.
</Note>

## Step 1: Open Google Sheets and Launch Detrics

1. Open a new Google Sheets document ([click here to create one](https://sheets.new))
2. Navigate to **Extensions** → **Detrics** → **Launch sidebar**
3. The Detrics sidebar will appear on the right side of your sheet

<Frame>
  <img alt="Launch Detrics Sidebar" />
</Frame>

## Step 2: Select Your Data Source

1. In the Detrics sidebar, click on **Start from Scratch** to create a Query from scratch or **[Start from Template](/data-destination/google-sheets/how-to-use-query-templates)** to create a Query using Detrics' pre-built templates
2. Select the data source you want to use (e.g., Google Ads, Facebook Ads, etc.)
3. If you haven't connected this source yet, follow the authentication flow

## Step 3: Configure Your Query

### Choose Metrics and Dimensions

1. **Select Metrics**: Choose the metrics you want to include in your report

   * Click on the metrics dropdown
   * Select metrics like impressions, clicks, conversions, cost, etc.
   * You can select multiple metrics for comprehensive reporting

2. **Select Dimensions**: Choose how you want to break down your data
   * Common dimensions include date, campaign, ad group, etc.
   * Dimensions help you segment and analyze your data

### Set Date Range

1. Click on the date range selector
2. Choose from preset ranges (Last 7 days, Last 30 days, etc.) or set a custom range
3. You can also use dynamic date ranges that update automatically

### Apply Filters (Optional)

1. Click on **Add Filter** to narrow down your data
2. Select the field you want to filter by
3. Choose the operator (equals, contains, greater than, etc.)
4. Enter the filter value

## Step 4: Choose Output Location

1. Select where you want the data to appear in your spreadsheet
2. The default location is cell A1 of the tab linked to the Query
3. You can select a different location:
   * Current cell location
   * A different specific cell reference (e.g., B5)

## Step 5: Run the Query

1. Review your query configuration
2. Click **Run Query** to fetch the data
3. Detrics will populate your sheet with the requested data

## Step 6: Format and Customize Your Report

### Apply Formatting

1. Select the data range
2. Use Google Sheets formatting options:
   * Apply number formats for currencies and percentages
   * Add conditional formatting to highlight trends
   * Adjust column widths for better readability

### Create Charts and Visualizations

1. Select your data
2. Go to **Insert** → **Chart**
3. Choose appropriate chart types:
   * Line charts for trends over time
   * Bar charts for comparisons
   * Pie charts for proportions

## Step 7: Set Up Automatic Refresh

1. In the Detrics sidebar, click on the query you created
2. Select **Schedule Refresh**
3. Choose refresh frequency:
   * Daily
   * Weekly
   * Monthly
   * Custom schedule
4. Set the specific time for refresh
5. Click **Save Schedule**

Learn more about [managing Scheduled Queries](/data-destination/google-sheets/how-to-automate-a-query) to optimize your automatic updates.

<Tip>
  **Need help?** If you encounter any issues creating your report, please reach
  out to [support@detrics.io](mailto:support@detrics.io)
</Tip>


# How to Import/Export Queries Fast
Source: https://support.detrics.io/data-destination/google-sheets/how-to-import-export-queries

Quickly transfer Queries between Sheets with Detrics' import/export functionality

<Info>**Last updated:** August 2, 2025</Info>

# How to Import/Export Queries Fast

Import/Export is essentially a **copy-paste function for your Queries** between Google Sheets files. It's designed for people who manage multiple files.

## How To Import/Export Queries

<Steps>
  <Step title="Export from Source File">
    1. Open Detrics sidebar on the file that contains the Queries you want to export
    2. Go to **See Queries**
    3. Click on **Export** (will have an arrow pointing up ↑)
  </Step>

  <Step title="Import to Destination File">
    1. Open Detrics sidebar in the file where you want the Queries imported
    2. Go to **See Queries**
    3. Click on **Import**
  </Step>

  <Step title="Configure Your New Queries">
    Done! All Queries are now copied to the new file. Final steps:

    * Change accounts associated to each Query
    * Run Queries to populate your data
    * Schedule automatic refresh for each Query
  </Step>
</Steps>

<Note>
  To learn more about how to schedule automatic refresh, check our [tutorial on
  managing scheduled
  refreshes](/data-destination/google-sheets/how-to-automate-a-query).
</Note>

<Tip>
  Need help with import/export? Contact our support team at [support@detrics.io](mailto:support@detrics.io)
</Tip>


# How to Use Query Templates
Source: https://support.detrics.io/data-destination/google-sheets/how-to-use-query-templates

Save time with pre-built query templates that eliminate the need to manually select metrics and dimensions

<Info>**Last updated:** August 2, 2025</Info>

# What are Query Templates

Query templates are **pre-built Queries** that enable you to quickly import data by simply selecting a topic (like **Campaign Overview** or **Ad Performance**) based on your chosen data source. These templates come with **metrics, dimensions, and time frames already configured** - it's completely **plug and play**. This **saves you significant time** by eliminating the need to manually select metrics and dimensions, and **prevents running into compatibility issues** between different data fields.

## Benefits of Using Query Templates

The main benefit is **saving significant time**. How?

<CardGroup>
  <Card title="No Manual Selection" icon="hand-pointer">
    Skip selecting individual metrics and dimensions. Everything is
    pre-configured and ready to use.
  </Card>

  <Card title="Zero Compatibility Issues" icon="shield-check">
    No more trial and error with incompatible field combinations. Templates are
    pre-tested to work perfectly.
  </Card>

  <Card title="Instant Data Import" icon="bolt">
    Just pick your topic and run. What normally takes 5-10 minutes now takes
    seconds.
  </Card>
</CardGroup>

## Using Query Templates

### Step-by-Step Guide to Create a Query with Detrics Templates

<Steps>
  <Step title="Open Detrics Sidebar">
    In Google Sheets, go to **Extensions → Detrics → Open sidebar**
  </Step>

  <Step title="Choose Start from Template">
    Instead of clicking "New Query", select **Start from Template** to access
    pre-built configurations
  </Step>

  <Step title="Select Your Data Source">
    Choose which platform you want to import data from:

    * Google Ads
    * Meta Ads
    * Google Analytics
    * And more...
  </Step>

  <Step title="Browse Available Templates">
    View templates available for your selected data source:

    * **Campaign Performance** - Track key campaign metrics
    * **Budget Tracker** - Monitor spending and ROI
    * **Conversion Analysis** - Deep dive into conversion data
    * **Creative Performance** - Analyze ad creative effectiveness
  </Step>

  <Step title="Select and Apply Template">
    Click on the template that matches your needs. The template will automatically
    configure:

    * All necessary metrics
    * Compatible dimensions
    * Appropriate date ranges
    * Relevant filters
  </Step>

  <Step title="Customize if Needed">
    While templates work great out of the box, you can still:

    * Adjust the date range to your needs
    * Add additional metrics or dimensions if desired
    * Modify filters to focus on specific data
    * Change the output location in your sheet
  </Step>

  <Step title="Run the Query">
    Click **Run Query** to import your data. The template ensures everything
    works smoothly without compatibility issues.
  </Step>
</Steps>

## Customizing Templates

### Editing Template Settings

While templates come pre-configured, you have flexibility to customize them:

1. **Date Range**: Adjust to any period you need
2. **Additional Metrics**: Add extra metrics to the pre-selected ones
3. **Extra Dimensions**: Include additional breakdown dimensions
4. **Filters**: Apply filters to focus on specific campaigns, ad groups, etc.
5. **Output Location**: Choose where in your sheet the data appears

### Template Names

Each template has a descriptive name that tells you:

* What type of report it creates
* Which metrics it focuses on
* The intended use case

Templates typically focus on:

* **Campaign Overview** - High-level campaign metrics and performance
* **Ad Performance** - Detailed analysis of individual ad effectiveness
* **Traffic Sources** - Breakdown of where your traffic comes from
* **Conversion Analysis** - Deep dive into conversion metrics and funnel performance
* **Budget & Spend** - Track spending patterns and budget utilization
* **Audience Demographics** - Understand who your ads are reaching

## Go the Extra Mile

<CardGroup>
  <Card title="Import/Export Queries" icon="arrow-right-arrow-left" href="/data-destination/google-sheets/how-to-import-export-queries">
    Export Queries to other sheets so you don't have to recreate Queries from
    scratch.
  </Card>

  <Card title="Troubleshooting Guide" icon="clock" href="/data-destination/google-sheets/how-to-automate-a-query">
    Set up automatic data updates for your template Queries. Keep your reports
    fresh without lifting a finger.
  </Card>
</CardGroup>

<Tip>
  **Need help?** If you encounter issues with templates or have questions about
  available options, please reach out to [support@detrics.io](mailto:support@detrics.io)
</Tip>


# Google Sheets Supported Data Sources
Source: https://support.detrics.io/data-destination/google-sheets/supported-data-sources

Supported Data Sources for Google Sheets integration

Google Sheets supports all available data platforms in Detrics. Connect and import data from any of these sources directly into your spreadsheets.

## Supported Platforms

### Advertising Platforms

**Facebook (Meta) Ads**\
To learn more about metrics and dimensions supported by this Data Destination, check the [Facebook (Meta) Ads metrics and dimensions guide](/data-source/facebook-ads/fields).

**Google Ads**\
To learn more about metrics and dimensions supported by this Data Destination, check the [Google Ads metrics and dimensions guide](/data-source/google-ads/fields).

**TikTok Ads**\
To learn more about metrics and dimensions supported by this Data Destination, check the [TikTok Ads metrics and dimensions guide](/data-source/tiktok-ads/fields).

**LinkedIn Ads**\
To learn more about metrics and dimensions supported by this Data Destination, check the [LinkedIn Ads metrics and dimensions guide](/data-source/linkedin-ads/fields).

**X Ads**\
To learn more about metrics and dimensions supported by this Data Destination, check the [X Ads metrics and dimensions guide](/data-source/x-ads/fields).

**Pinterest Ads**\
To learn more about metrics and dimensions supported by this Data Destination, check the [Pinterest Ads metrics and dimensions guide](/data-source/pinterest-ads/fields).

**Bing Ads**\
To learn more about metrics and dimensions supported by this Data Destination, check the [Bing Ads metrics and dimensions guide](/data-source/bing-ads/fields).

**Mercado Ads**\
To learn more about metrics and dimensions supported by this Data Destination, check the [Mercado Ads metrics and dimensions guide](/data-source/mercado-ads/fields).

**Google Display & Video 360**\
To learn more about metrics and dimensions supported by this Data Destination, check the [Google Display & Video 360 metrics and dimensions guide](/data-source/google-dv360/fields).

### Web Analytics & Organic Traffic

**Google Analytics 4**\
To learn more about metrics and dimensions supported by this Data Destination, check the [Google Analytics 4 metrics and dimensions guide](/data-source/google-analytics-4/fields).

**Google Search Console**\
To learn more about metrics and dimensions supported by this Data Destination, check the [Google Search Console metrics and dimensions guide](/data-source/google-search-console/fields).

### Organic Social

**Instagram Insights**\
To learn more about metrics and dimensions supported by this Data Destination, check the [Instagram Insights metrics and dimensions guide](/data-source/instagram-insights/fields).

**Facebook Insights**\
To learn more about metrics and dimensions supported by this Data Destination, check the [Facebook Insights metrics and dimensions guide](/data-source/facebook-insights/fields).

**Facebook Public Data**\
To learn more about metrics and dimensions supported by this Data Destination, check the [Facebook Public Data metrics and dimensions guide](/data-source/facebook-public-data/fields).

**TikTok Organic**\
To learn more about metrics and dimensions supported by this Data Destination, check the [TikTok Organic metrics and dimensions guide](/data-source/tiktok-organic/fields).

### CRM & Email

**Klaviyo**\
To learn more about metrics and dimensions supported by this Data Destination, check the [Klaviyo metrics and dimensions guide](/data-source/klaviyo/fields).

**HubSpot**\
To learn more about metrics and dimensions supported by this Data Destination, check the [HubSpot metrics and dimensions guide](/data-source/hubspot/fields).

**Mailchimp**\
To learn more about metrics and dimensions supported by this Data Destination, check the [Mailchimp metrics and dimensions guide](/data-source/mailchimp/fields).

**Google Merchant Center**\
To learn more about metrics and dimensions supported by this Data Destination, check the [Google Merchant Center metrics and dimensions guide](/data-source/google-merchant-center/fields).

### E-commerce & Payments

**Shopify**\
To learn more about metrics and dimensions supported by this Data Destination, check the [Shopify metrics and dimensions guide](/data-source/shopify/fields).

**WooCommerce**\
To learn more about metrics and dimensions supported by this Data Destination, check the [WooCommerce metrics and dimensions guide](/data-source/woocommerce/fields).

**Tiendanube (Nuvemshop)**\
To learn more about metrics and dimensions supported by this Data Destination, check the [Tiendanube metrics and dimensions guide](/data-source/tiendanube/fields).

**Stripe**\
To learn more about metrics and dimensions supported by this Data Destination, check the [Stripe metrics and dimensions guide](/data-source/stripe/fields).

## Explore Metrics and Dimensions

Ready to see what data you can pull from each platform? Explore the available metrics and dimensions for each data source in our comprehensive guides.


# Troubleshooting
Source: https://support.detrics.io/data-destination/google-sheets/troubleshooting

Common issues and solutions for Google Sheets integration

<Info>**Last updated:** August 2, 2025</Info>

## How to clear Detrics cache

If the app is showing unexpected errors or not responding, try cleaning your cache by following this video tutorial:

<video>
  Your browser does not support the video tag.
</video>

## Problem with install button in Get Started sheet

In some cases, the install button in the Get Started sheet may not work as expected. If you're unable to install Detrics using the in-sheet button, you can install the add-on directly from the Google Workspace Marketplace.

### Step-by-step installation guide

Follow these steps to install and launch Detrics from the Google Workspace Marketplace:

**Step 1: Install from the Marketplace**

Visit the [Detrics Google Workspace Marketplace page](https://workspace.google.com/marketplace/app/detrics_ppc_marketing_analytics_ecommerc/731617833254) and click the **Install** button.

<img alt="Detrics Google Workspace Marketplace page with Install button" />

**Step 2: Select your Google account**

Choose the Google account you want to use with Detrics and click on it to continue.

<img alt="Google account selection screen" />

**Step 3: Review account permissions**

Google will show you what information Detrics will access (your name, profile picture, and email address). Click **Continue** to proceed.

<img alt="Google account permissions screen" />

**Step 4: Grant application permissions**

Review the permissions that Detrics needs to function:

* See, edit, create and delete all your Google Sheets spreadsheets
* Connect to an external service
* Display and run third-party web content in prompts and sidebars

Click **Allow** to grant these permissions.

<img alt="Application permissions screen" />

**Step 5: Complete the installation**

You'll see a confirmation message that Detrics has been installed. Click **DONE** to finish the setup.

<img alt="Installation success message" />

**Step 6: Launch Detrics in Google Sheets**

Open any Google Sheet and navigate to **Extensions** > **Detrics - PPC, Marketing Analytics & Ecommerce** > **Launch Detrics** to start using the add-on.

<img alt="Launch Detrics from Extensions menu" />

<Note>
  If you're experiencing errors with a specific data source, please visit the
  troubleshooting section for that particular data source for more targeted
  solutions.
</Note>

<Tip>
  **Need help?** If errors persist after following these steps, please reach out
  to [support@detrics.io](mailto:support@detrics.io)
</Tip>


# Understanding Query Usage
Source: https://support.detrics.io/data-destination/google-sheets/understanding-query-usage

Learn how your monthly query usage is calculated and tracked

<Info>
  **Last updated:** July 30, 2025
</Info>

## How are your monthly Queries calculated?

Detrics calculates your Query usage based on the total number of Query executions performed in our Google Sheets Add on.

## What counts as a Query in our Google Sheets add on

<Frame>
  <img alt="Detrics Google Sheets Query Count Example" />
</Frame>

## How to see how many Queries I made

You can see how many Queries you've made this month in our [web application](https://app.detrics.io?utm_source=detrics-support\&utm_medium=understanding-query-usage).


# Understanding the 6-Minute Limit in Looker Studio
Source: https://support.detrics.io/data-destination/looker-studio/6-minutes-limit

Learn why data requests fail and how to work with large datasets effectively

<Info>**Last updated:** December 5, 2025</Info>

If you're seeing an error in Looker Studio due to a request taking too long, you've hit a platform limitation. This guide explains why it happens and how to work around it.

## Why Does This Happen?

Looker Studio uses Google Apps Script to fetch data from connectors. Google enforces a **strict 6-minute execution limit** on all Apps Script functions. This is a Google platform limitation, not a Detrics limitation.

When your data request takes longer than 6 minutes to process, Google terminates the request and Looker Studio displays an error.

<Note>
  This limit applies to **all** community connectors in Looker Studio, not just Detrics.
</Note>

## What Causes Requests to Exceed the Limit?

Several factors can cause your requests to approach or exceed the 6-minute limit:

| Factor                   | Impact    | Example                                                      |
| ------------------------ | --------- | ------------------------------------------------------------ |
| **Large time frames**    | High      | Requesting 12 months of daily data vs. 30 days               |
| **Multiple accounts**    | High      | Pulling data from 20+ ad accounts in one chart               |
| **Ad-level granularity** | Very High | Requesting individual ad data instead of campaign-level      |
| **Complex platforms**    | Medium    | Meta Ads and TikTok Ads typically have more data per request |
| **No filters applied**   | Medium    | Fetching all campaigns vs. only active ones                  |

<Warning>
  **Meta Ads** and **TikTok Ads** are particularly prone to exceeding this limit due to their data volume and API response times. If you're working with these platforms and large accounts, consider the solutions below.
</Warning>

## Quick Fixes

Try these adjustments to reduce request time:

<Steps>
  <Step title="Reduce your time frame">
    Instead of "Last 12 months", try "Last 30 days" or "Last 7 days". You can always create separate charts for historical comparisons.
  </Step>

  <Step title="Reduce the number of accounts">
    If you're pulling data from multiple accounts, split them across separate data sources or pages.
  </Step>

  <Step title="Avoid ad-level data">
    Use campaign or ad set level granularity instead of individual ads. Ad-level data significantly increases response times.
  </Step>

  <Step title="Apply filters">
    Filter by campaign status (active only), specific campaign names, or other criteria to reduce the data volume.
  </Step>
</Steps>

## The Best Solution for Large Data Volumes

For large accounts, many accounts, or when you need historical data, the most reliable approach is to use **Google Sheets as an intermediary layer** between your data sources and Looker Studio.

<Steps>
  <Step title="Data Sources" icon="database">
    Facebook Ads, Google Ads, TikTok Ads, etc.
  </Step>

  <Step title="Detrics for Google Sheets" icon="arrow-right">
    Pull data with scheduled queries (no time limits)
  </Step>

  <Step title="Google Sheets" icon="table">
    Data stored and refreshed automatically
  </Step>

  <Step title="Looker Studio" icon="chart-line">
    Instant data loading from Sheets
  </Step>
</Steps>

### Why This Works Better

| Direct Connector                     | Sheets → Looker                               |
| ------------------------------------ | --------------------------------------------- |
| 6-minute limit per request           | No time limit - queries run in background     |
| Data fetched on every dashboard load | Data cached in Sheets, Looker reads instantly |
| Fails with large datasets            | Handles any data volume                       |
| One account per data source          | Combine multiple accounts in one sheet        |

### How to Set It Up

<Steps>
  <Step title="Get your data into Google Sheets">
    Use [Detrics for Google Sheets](/quickstart/google-sheets) to create queries that pull your marketing data. Set them to refresh automatically on a schedule.
  </Step>

  <Step title="Connect Sheets to Looker Studio">
    In Looker Studio, add a new data source and select "Google Sheets". Choose the spreadsheet containing your Detrics data.

    <Frame>
      <img alt="Connect Google Sheets as a data source in Looker Studio" />
    </Frame>
  </Step>

  <Step title="Build your dashboard">
    Create your visualizations using the Sheets data source. Since the data is already in Sheets, Looker loads it instantly.
  </Step>
</Steps>

<Tip>
  **Pro tip**: Schedule your Sheets queries to refresh overnight. Your Looker Studio dashboards will have fresh data every morning with zero wait time.
</Tip>

## Benefits of the Sheets Approach

<CardGroup>
  <Card title="No Time Limits" icon="clock">
    Sheets queries run in the background without the 6-minute limit. Large historical pulls complete successfully.
  </Card>

  <Card title="Faster Dashboards" icon="bolt">
    Looker reads from Sheets instantly. No waiting for API calls every time you view the dashboard.
  </Card>

  <Card title="Combine Data Sources" icon="layer-group">
    Merge data from multiple platforms and accounts in a single sheet, then visualize in Looker.
  </Card>

  <Card title="Custom Calculations" icon="calculator">
    Add formulas in Sheets to create custom metrics before they reach Looker Studio.
  </Card>
</CardGroup>

## When to Use Each Approach

| Scenario                          | Recommended Approach    |
| --------------------------------- | ----------------------- |
| Small accounts, short date ranges | Direct Looker connector |
| Real-time data needed (hourly)    | Direct Looker connector |
| Large accounts (Meta, TikTok)     | Sheets → Looker         |
| Historical data (3+ months)       | Sheets → Looker         |
| Multiple accounts combined        | Sheets → Looker         |
| 50+ accounts                      | Sheets → Looker         |

## Still Experiencing Issues?

If you've tried these solutions and still encounter problems:

1. Check your internet connection stability
2. Try refreshing during off-peak hours
3. Contact [support@detrics.io](mailto:support@detrics.io) with details about your setup

<Tip>
  **Need help setting up the Sheets workflow?** Our support team can guide you through the process. Reach out at [support@detrics.io](mailto:support@detrics.io)
</Tip>


# How to build dashboards 10x faster in Looker Studio
Source: https://support.detrics.io/data-destination/looker-studio/how-to-work-faster

Performance optimization techniques to dramatically speed up your dashboard creation workflow

<Info>**Last updated:** August 12, 2025</Info>

Building dashboards in Looker Studio can be frustratingly slow if you don't know these critical performance techniques. By following these simple strategies, you can reduce your dashboard creation time by up to 90%.

## The #1 Performance Killer: Live Data Updates

Every time you add a new chart, modify a table, add columns, or make any change to your dashboard, Looker Studio automatically fetches fresh data from the connector's servers. This constant data fetching is the primary reason why dashboard building feels slow.

<Note>
  **Without optimization**: Each change triggers a data fetch that can take 5-30 seconds depending on your data source and volume.

  **With optimization**: Changes are instant, allowing you to iterate rapidly.
</Note>

## Strategy 1: Pause Auto-Refresh (Most Important!)

The single most impactful optimization is to pause data updates while building your dashboard.

### How to Pause Updates:

<Steps>
  <Step title="Locate the refresh button">
    Find the refresh icon in the top toolbar of Looker Studio
  </Step>

  <Step title="Pause auto-refresh">
    Click the refresh icon and select "Pause auto-refresh"

    <Frame>
      <img alt="Pause updates button in Looker Studio" />
    </Frame>
  </Step>

  <Step title="Build your dashboard">
    Now you can:

    * Add new charts instantly
    * Modify table columns without waiting
    * Adjust filters and date ranges immediately
    * Rearrange components freely
    * Change chart types on the fly
  </Step>

  <Step title="Resume when ready">
    Only resume auto-refresh when you're ready to test with real data
  </Step>
</Steps>

<Tip>
  **Pro tip**: Keep auto-refresh paused during your entire building session. Only enable it when you need to verify the final result or test specific functionality.
</Tip>

## Strategy 2: Use Minimal Date Ranges

While building your dashboard, limit the amount of data being processed by using the smallest possible date range.

### Implementation:

1. **Add a date range control** to your dashboard immediately

2. **Set it to "Yesterday"** or "Last 7 days" while building

   <Frame>
     <img alt="Set date range to yesterday for faster performance" />
   </Frame>

3. **Why this works**:
   * Yesterday's data = 1 day of processing
   * Last 30 days = 30x more data to process
   * Last year = 365x more data to process

<Note>
  Using yesterday's data is particularly effective because:

  * It's a complete dataset (unlike "today" which is partial)
  * It loads extremely fast (minimal data volume)
  * It's recent enough to show realistic patterns
</Note>

## Performance Comparison

Here's what you can expect with these optimizations:

| Action              | Without Optimization | With Optimization | Time Saved |
| ------------------- | -------------------- | ----------------- | ---------- |
| Adding a new chart  | 10-30 seconds        | Instant           | 95-100%    |
| Adding table column | 5-15 seconds         | Instant           | 95-100%    |
| Changing chart type | 10-20 seconds        | Instant           | 95-100%    |
| Applying filter     | 5-20 seconds         | Instant           | 95-100%    |

<Tip>
  **Time saved**: Following these strategies, a dashboard that normally takes 2-3 hours to build can be completed in 15-30 minutes.
</Tip>

<Note>
  Questions about performance or need help optimizing your dashboards? Contact [support@detrics.io](mailto:support@detrics.io)
</Note>


# Looker Studio Supported Data Sources
Source: https://support.detrics.io/data-destination/looker-studio/supported-data-sources

Supported Data Sources for Looker Studio integration

Looker Studio integration supports a curated selection of data platforms optimized for visual reporting and dashboard creation.

## Supported Platforms

### Advertising Platforms

**Facebook (Meta) Ads**\
To learn more about metrics and dimensions supported by this Data Destination, check the [Facebook (Meta) Ads metrics and dimensions guide](/data-source/facebook-ads/fields).

**Google Ads**\
To learn more about metrics and dimensions supported by this Data Destination, check the [Google Ads metrics and dimensions guide](/data-source/google-ads/fields).

**TikTok Ads**\
To learn more about metrics and dimensions supported by this Data Destination, check the [TikTok Ads metrics and dimensions guide](/data-source/tiktok-ads/fields).

**LinkedIn Ads**\
To learn more about metrics and dimensions supported by this Data Destination, check the [LinkedIn Ads metrics and dimensions guide](/data-source/linkedin-ads/fields).

**X Ads**\
To learn more about metrics and dimensions supported by this Data Destination, check the [X Ads metrics and dimensions guide](/data-source/x-ads/fields).

**Bing Ads**\
To learn more about metrics and dimensions supported by this Data Destination, check the [Bing Ads metrics and dimensions guide](/data-source/bing-ads/fields).

**Google Display & Video 360**\
To learn more about metrics and dimensions supported by this Data Destination, check the [Google Display & Video 360 metrics and dimensions guide](/data-source/google-dv360/fields).

### Web Analytics & Organic Traffic

**Google Analytics 4**\
To learn more about metrics and dimensions supported by this Data Destination, check the [Google Analytics 4 metrics and dimensions guide](/data-source/google-analytics-4/fields).

### Organic Social

**Instagram Insights**\
To learn more about metrics and dimensions supported by this Data Destination, check the [Instagram Insights metrics and dimensions guide](/data-source/instagram-insights/fields).

### E-commerce

**Shopify**\
To learn more about metrics and dimensions supported by this Data Destination, check the [Shopify metrics and dimensions guide](/data-source/shopify/fields).

## Platform Limitations

The following platforms are available in Google Sheets but not yet supported in Looker Studio:

* Pinterest Ads
* Mercado Ads
* Google Search Console
* Tiendanube (Nuvemshop)
* Stripe

## Explore Metrics and Dimensions

Ready to see what data you can pull from each platform? Explore the available metrics and dimensions for each data source in our comprehensive guides.


# Looker Studio Troubleshooting Guide
Source: https://support.detrics.io/data-destination/looker-studio/troubleshooting

Solutions for common issues

<Info>**Last updated:** August 12, 2025</Info>

This guide addresses common scenarios where users can't find specific features or
accounts in Looker Studio connectors.

## Platform-Specific Issues

### Shopify: Connecting Additional Stores

**Issue:** You've connected one Shopify store and want to add another, but can't find the option to connect a new store in the Looker connector.

**Solution:**

1. Install the Detrics Shopify app on all stores you want to connect
2. Visit the [Shopify App Store](https://apps.shopify.com/detrics?utm_source=detrics-support\&utm_medium=looker-studio-troubleshooting)
3. Install the app on your additional stores
4. Return to the Looker Studio connector and refresh the page
5. Your new stores will appear in the account selection dropdown

<Note>
  Each Shopify store needs the Detrics app installed before it can be connected
  to Looker Studio.
</Note>

### Google Analytics 4: Custom Dimensions and Metrics

**Issue:** You need custom dimensions and metrics from Google Analytics 4, but can't find them in the Looker Studio connector.

**Solution:**
Custom dimensions and metrics are an advanced feature available through our Google Sheets integration:

1. Visit [Detrics Google Sheets](https://detrics.io/get-started?utm_source=detrics-support\&utm_medium=looker-studio-troubleshooting)
2. Install the Google Sheets Add-on
3. Connect your GA4 account there for access to custom fields
4. Create queries with your custom dimensions and metrics

### Facebook Ads: Custom Pixel Events

**Issue:** Looking for custom Facebook Pixel events data in Looker Studio but can't find them.

**Solution:**
Custom Pixel events are available through our Google Sheets integration:

1. Go to [Detrics Google Sheets](https://detrics.io/get-started?utm_source=detrics-support\&utm_medium=looker-studio-troubleshooting)
2. Install the Google Sheets Add-on
3. Connect your Facebook Ads account
4. Access custom Pixel events through the advanced query builder

### TikTok Ads: Missing Ad Accounts

**Issue:** Can't find your TikTok ad account in the Looker Studio connector dropdown.

**Solution:**
To refresh the list of available TikTok ad accounts:

1. Visit [Detrics Google Sheets](https://detrics.io/get-started?utm_source=detrics-support\&utm_medium=looker-studio-troubleshooting)
2. Install the Google Sheets Add-on
3. Reconnect your TikTok Ads account
4. This will refresh the permissions and available accounts
5. Return to Looker Studio - your accounts should now be visible


# Adobe Analytics Metrics & Dimensions
Source: https://support.detrics.io/data-source/adobe-analytics/fields

Complete reference for Adobe Analytics dimensions and metrics

<Info>
  **Last updated:** August 6, 2026
</Info>

<div>
  <div>
    66 dimensions
  </div>

  <div>
    13 metrics
  </div>
</div>

This reference covers all available dimensions and metrics for Adobe Analytics data through Detrics. Use this guide to understand what data you can extract and how to structure your queries.

<div>
  <span>Supported destinations:</span>

  <div>
    Google Sheets
  </div>

  <div>
    Claude
  </div>

  <div>
    BigQuery
  </div>
</div>

## Dimensions

Dimensions are the attributes you can use to segment and group your Adobe Analytics data.

### Report Suite

|                            |                                                                                                                             |
| -------------------------- | --------------------------------------------------------------------------------------------------------------------------- |
| <div>Report Suite ID</div> | The report suite identifier (RSID) the data comes from.<br /><br />**Field Name:** `reportSuiteId`<br />**Type:** dimension |
| <div>Report Suite</div>    | Friendly name of the report suite.<br /><br />**Field Name:** `reportSuiteName`<br />**Type:** dimension                    |

### Pages & Content

|                                  |                                                                                                                            |
| -------------------------------- | -------------------------------------------------------------------------------------------------------------------------- |
| <div>Page</div>                  | The page name or URL of the viewed page.<br /><br />**Field Name:** `page`<br />**Type:** dimension                        |
| <div>Page Name</div>             | The value of s.pageName for the viewed page.<br /><br />**Field Name:** `pageName`<br />**Type:** dimension                |
| <div>Site Section</div>          | The site section (s.channel) the hit belongs to.<br /><br />**Field Name:** `siteSection`<br />**Type:** dimension         |
| <div>Server</div>                | The reporting server that captured the hit.<br /><br />**Field Name:** `server`<br />**Type:** dimension                   |
| <div>Domain</div>                | The visitor's ISP domain.<br /><br />**Field Name:** `domain`<br />**Type:** dimension                                     |
| <div>Top Level Domain</div>      | The top-level domain of the visitor's ISP.<br /><br />**Field Name:** `topLevelDomain`<br />**Type:** dimension            |
| <div>Entry Page</div>            | The first page of the visit.<br /><br />**Field Name:** `entryPage`<br />**Type:** dimension                               |
| <div>Entry Page (Original)</div> | The original entry page attributed to the visitor.<br /><br />**Field Name:** `entryPageOriginal`<br />**Type:** dimension |
| <div>Entry Page (DW)</div>       | Data Warehouse variant of entry page.<br /><br />**Field Name:** `entryPageDw`<br />**Type:** dimension                    |
| <div>Path Length</div>           | Number of pages viewed during the visit.<br /><br />**Field Name:** `pathLength`<br />**Type:** dimension                  |
| <div>Custom Link</div>           | Custom link (s.tl link tracking) name.<br /><br />**Field Name:** `linkCustom`<br />**Type:** dimension                    |
| <div>Download Link</div>         | Download link that was clicked.<br /><br />**Field Name:** `linkDownload`<br />**Type:** dimension                         |
| <div>Exit Link</div>             | Exit link that was clicked.<br /><br />**Field Name:** `linkExit`<br />**Type:** dimension                                 |

### Geography

|                              |                                                                                                                       |
| ---------------------------- | --------------------------------------------------------------------------------------------------------------------- |
| <div>Country</div>           | Country derived from the visitor's IP address.<br /><br />**Field Name:** `geoCountry`<br />**Type:** dimension       |
| <div>Region</div>            | Region / state derived from the visitor's IP address.<br /><br />**Field Name:** `geoRegion`<br />**Type:** dimension |
| <div>City</div>              | City derived from the visitor's IP address.<br /><br />**Field Name:** `geoCity`<br />**Type:** dimension             |
| <div>DMA</div>               | Designated Market Area (US) derived from IP.<br /><br />**Field Name:** `geoDMA`<br />**Type:** dimension             |
| <div>ZIP / Postal Code</div> | Postal code derived from the visitor's IP address.<br /><br />**Field Name:** `zip`<br />**Type:** dimension          |
| <div>Language</div>          | The visitor's browser language.<br /><br />**Field Name:** `language`<br />**Type:** dimension                        |

### Technology

|                                      |                                                                                                                       |
| ------------------------------------ | --------------------------------------------------------------------------------------------------------------------- |
| <div>Browser</div>                   | The visitor's web browser.<br /><br />**Field Name:** `browser`<br />**Type:** dimension                              |
| <div>Browser Type</div>              | The browser family / rendering engine.<br /><br />**Field Name:** `browserType`<br />**Type:** dimension              |
| <div>Browser Width</div>             | Browser viewport width in pixels.<br /><br />**Field Name:** `browserWidth`<br />**Type:** dimension                  |
| <div>Browser Height</div>            | Browser viewport height in pixels.<br /><br />**Field Name:** `browserHeight`<br />**Type:** dimension                |
| <div>Browser Width (Bucketed)</div>  | Browser width grouped into buckets.<br /><br />**Field Name:** `browserWidthBucketed`<br />**Type:** dimension        |
| <div>Browser Height (Bucketed)</div> | Browser height grouped into buckets.<br /><br />**Field Name:** `browserHeightBucketed`<br />**Type:** dimension      |
| <div>Operating System</div>          | The visitor's operating system.<br /><br />**Field Name:** `operatingSystem`<br />**Type:** dimension                 |
| <div>Connection Type</div>           | The visitor's connection type (e.g. LAN, modem).<br /><br />**Field Name:** `connectionType`<br />**Type:** dimension |
| <div>Cookies Enabled</div>           | Whether the visitor accepts cookies.<br /><br />**Field Name:** `cookiesEnabled`<br />**Type:** dimension             |
| <div>JavaScript Enabled</div>        | Whether the visitor has JavaScript enabled.<br /><br />**Field Name:** `javaScriptEnabled`<br />**Type:** dimension   |
| <div>JavaScript Version</div>        | The visitor's JavaScript version.<br /><br />**Field Name:** `javaScriptVersion`<br />**Type:** dimension             |
| <div>Monitor Color Depth</div>       | The visitor's monitor color depth.<br /><br />**Field Name:** `monitorColorDepth`<br />**Type:** dimension            |
| <div>Monitor Resolution</div>        | The visitor's monitor resolution.<br /><br />**Field Name:** `monitorResolution`<br />**Type:** dimension             |

### Mobile

|                                |                                                                                                                     |
| ------------------------------ | ------------------------------------------------------------------------------------------------------------------- |
| <div>Mobile Device Type</div>  | Type of mobile device (phone, tablet, etc.).<br /><br />**Field Name:** `mobileDeviceType`<br />**Type:** dimension |
| <div>Mobile Device Name</div>  | Specific mobile device model.<br /><br />**Field Name:** `mobileDeviceName`<br />**Type:** dimension                |
| <div>Mobile Manufacturer</div> | Mobile device manufacturer.<br /><br />**Field Name:** `mobileManufacturer`<br />**Type:** dimension                |
| <div>Mobile Carrier</div>      | Mobile network carrier.<br /><br />**Field Name:** `mobileCarrier`<br />**Type:** dimension                         |
| <div>Mobile OS</div>           | Mobile operating system.<br /><br />**Field Name:** `mobileOS`<br />**Type:** dimension                             |
| <div>Mobile Screen Size</div>  | Mobile device screen size.<br /><br />**Field Name:** `mobileScreenSize`<br />**Type:** dimension                   |

### Traffic Sources

|                                        |                                                                                                                                    |
| -------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------- |
| <div>Referrer</div>                    | The full referring URL.<br /><br />**Field Name:** `referrer`<br />**Type:** dimension                                             |
| <div>Referrer Type</div>               | The referrer classification (search, social, typed, etc.).<br /><br />**Field Name:** `referrerType`<br />**Type:** dimension      |
| <div>Referring Domain</div>            | The referring domain.<br /><br />**Field Name:** `referringDomain`<br />**Type:** dimension                                        |
| <div>Referring Domain (Original)</div> | Original referring domain attributed to the visitor.<br /><br />**Field Name:** `referringDomainOriginal`<br />**Type:** dimension |

### Search

|                                    |                                                                                                                 |
| ---------------------------------- | --------------------------------------------------------------------------------------------------------------- |
| <div>Search Engine</div>           | Search engine that referred the visitor.<br /><br />**Field Name:** `searchEngine`<br />**Type:** dimension     |
| <div>Search Engine - Paid</div>    | Search engine for paid entries.<br /><br />**Field Name:** `searchEnginePaid`<br />**Type:** dimension          |
| <div>Search Engine - Natural</div> | Search engine for organic entries.<br /><br />**Field Name:** `searchEngineNatural`<br />**Type:** dimension    |
| <div>Search Keyword</div>          | Keyword used in the referring search.<br /><br />**Field Name:** `searchEngineKeyword`<br />**Type:** dimension |

### Marketing & Channels

|                                       |                                                                                                                            |
| ------------------------------------- | -------------------------------------------------------------------------------------------------------------------------- |
| <div>Campaign</div>                   | Tracking code / campaign (s.campaign).<br /><br />**Field Name:** `campaign`<br />**Type:** dimension                      |
| <div>Tracking Code</div>              | Marketing channel tracking code.<br /><br />**Field Name:** `trackingCode`<br />**Type:** dimension                        |
| <div>Product</div>                    | Product name (s.products).<br /><br />**Field Name:** `product`<br />**Type:** dimension                                   |
| <div>Category</div>                   | Product category.<br /><br />**Field Name:** `category`<br />**Type:** dimension                                           |
| <div>Customer Loyalty</div>           | Customer loyalty segment.<br /><br />**Field Name:** `customerLoyalty`<br />**Type:** dimension                            |
| <div>First Touch Channel</div>        | Marketing channel of the first touch.<br /><br />**Field Name:** `firstTouchChannel`<br />**Type:** dimension              |
| <div>First Touch Channel Detail</div> | Detail of the first-touch marketing channel.<br /><br />**Field Name:** `firstTouchChannelDetail`<br />**Type:** dimension |
| <div>Last Touch Channel</div>         | Marketing channel of the last touch.<br /><br />**Field Name:** `lastTouchChannel`<br />**Type:** dimension                |
| <div>Last Touch Channel Detail</div>  | Detail of the last-touch marketing channel.<br /><br />**Field Name:** `lastTouchChannelDetail`<br />**Type:** dimension   |

### Visitor Behavior

|                                       |                                                                                                                       |
| ------------------------------------- | --------------------------------------------------------------------------------------------------------------------- |
| <div>Visit Number</div>               | The visitor's sequential visit count.<br /><br />**Field Name:** `visitNumber`<br />**Type:** dimension               |
| <div>Days Before First Purchase</div> | Days elapsed before the first purchase.<br /><br />**Field Name:** `daysBeforeFirstPurchase`<br />**Type:** dimension |
| <div>Days Since Last Purchase</div>   | Days elapsed since the last purchase.<br /><br />**Field Name:** `daysSinceLastPurchase`<br />**Type:** dimension     |
| <div>Days Since Last Visit</div>      | Days elapsed since the previous visit.<br /><br />**Field Name:** `daysSinceLastVisit`<br />**Type:** dimension       |

### Video

|                               |                                                                                            |
| ----------------------------- | ------------------------------------------------------------------------------------------ |
| <div>Video</div>              | Video name.<br /><br />**Field Name:** `video`<br />**Type:** dimension                    |
| <div>Video Ad</div>           | Video ad name.<br /><br />**Field Name:** `videoAd`<br />**Type:** dimension               |
| <div>Video Segment</div>      | Video segment.<br /><br />**Field Name:** `videoSegment`<br />**Type:** dimension          |
| <div>Video Content Type</div> | Video content type.<br /><br />**Field Name:** `videoContentType`<br />**Type:** dimension |
| <div>Video Players</div>      | Video player.<br /><br />**Field Name:** `videoPlayers`<br />**Type:** dimension           |

## Metrics

Metrics are the numerical values you can measure and analyze from your Adobe Analytics campaigns.

### Traffic

|                                  |                                                                                                          |
| -------------------------------- | -------------------------------------------------------------------------------------------------------- |
| <div>Visits</div>                | Number of visits (sessions).<br /><br />**Field Name:** `visits`<br />**Type:** metric                   |
| <div>Visits (All Visitors)</div> | Visits counted across all visitors.<br /><br />**Field Name:** `visitsAllVisitors`<br />**Type:** metric |
| <div>Visitors</div>              | Number of unique visitors.<br /><br />**Field Name:** `visitors`<br />**Type:** metric                   |
| <div>Page Views</div>            | Number of page views.<br /><br />**Field Name:** `pageViews`<br />**Type:** metric                       |

### Engagement

|                               |                                                                                                         |
| ----------------------------- | ------------------------------------------------------------------------------------------------------- |
| <div>Item Time Spent</div>    | Time spent (seconds) per item.<br /><br />**Field Name:** `itemTimeSpent`<br />**Type:** metric         |
| <div>Campaign Instances</div> | Number of campaign click-throughs.<br /><br />**Field Name:** `campaignInstances`<br />**Type:** metric |

### Commerce

|                          |                                                                                                     |
| ------------------------ | --------------------------------------------------------------------------------------------------- |
| <div>Revenue</div>       | Total revenue (report-suite currency).<br /><br />**Field Name:** `revenue`<br />**Type:** metric   |
| <div>Orders</div>        | Number of orders.<br /><br />**Field Name:** `orders`<br />**Type:** metric                         |
| <div>Units</div>         | Number of units sold.<br /><br />**Field Name:** `units`<br />**Type:** metric                      |
| <div>Carts</div>         | Number of carts opened.<br /><br />**Field Name:** `carts`<br />**Type:** metric                    |
| <div>Cart Views</div>    | Number of cart views.<br /><br />**Field Name:** `cartViews`<br />**Type:** metric                  |
| <div>Cart Removals</div> | Number of items removed from carts.<br /><br />**Field Name:** `cartRemovals`<br />**Type:** metric |
| <div>Checkouts</div>     | Number of checkouts.<br /><br />**Field Name:** `checkouts`<br />**Type:** metric                   |

***

## Related

<CardGroup>
  <Card title="Fields Catalog" icon="book" href="/fields-catalog">
    Browse all platforms
  </Card>

  <Card title="Google Analytics 4 Fields" icon="chart-bar" href="/data-source/google-analytics-4/fields">
    Google Analytics 4 metrics & dimensions
  </Card>

  <Card title="Google Search Console Fields" icon="chart-bar" href="/data-source/google-search-console/fields">
    Google Search Console metrics & dimensions
  </Card>

  <Card title="Facebook Insights Fields" icon="chart-bar" href="/data-source/facebook-insights/fields">
    Facebook Insights metrics & dimensions
  </Card>
</CardGroup>


# Apple Search Ads Metrics & Dimensions
Source: https://support.detrics.io/data-source/apple-search-ads/fields

Complete reference for Apple Search Ads dimensions and metrics

<Info>
  **Last updated:** August 6, 2026
</Info>

<div>
  <div>
    42 dimensions
  </div>

  <div>
    23 metrics
  </div>
</div>

This reference covers all available dimensions and metrics for Apple Search Ads data through Detrics. Use this guide to understand what data you can extract and how to structure your queries.

<div>
  <span>Supported destinations:</span>

  <div>
    Google Sheets
  </div>

  <div>
    Claude
  </div>

  <div>
    BigQuery
  </div>
</div>

## Dimensions

Dimensions are the attributes you can use to segment and group your Apple Search Ads data.

### Account

|                         |                                                                                                                    |
| ----------------------- | ------------------------------------------------------------------------------------------------------------------ |
| <div>Account Name</div> | Name of the Apple Search Ads account<br /><br />**Field Name:** `accountName`<br />**Type:** dimension             |
| <div>Account ID</div>   | Unique identifier for the Apple Search Ads account<br /><br />**Field Name:** `accountId`<br />**Type:** dimension |
| <div>Currency</div>     | Currency used by the account<br /><br />**Field Name:** `currency`<br />**Type:** dimension                        |

### Campaign

|                                    |                                                                                                                                                        |
| ---------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------ |
| <div>Campaign Name</div>           | Name of the campaign<br /><br />**Field Name:** `campaignName`<br />**Type:** dimension                                                                |
| <div>Campaign ID</div>             | Unique identifier for the campaign<br /><br />**Field Name:** `campaignId`<br />**Type:** dimension                                                    |
| <div>Campaign Status</div>         | Current status of the campaign (ENABLED, PAUSED)<br /><br />**Field Name:** `campaignStatus`<br />**Type:** dimension                                  |
| <div>Campaign Serving Status</div> | Serving status of the campaign<br /><br />**Field Name:** `campaignServingStatus`<br />**Type:** dimension                                             |
| <div>Campaign Display Status</div> | Display status of the campaign<br /><br />**Field Name:** `campaignDisplayStatus`<br />**Type:** dimension                                             |
| <div>Countries or Regions</div>    | Countries or regions targeted by the campaign<br /><br />**Field Name:** `countriesOrRegions`<br />**Type:** dimension                                 |
| <div>Ad Channel Type</div>         | Ad channel type (SEARCH, DISPLAY)<br /><br />**Field Name:** `adChannelType`<br />**Type:** dimension                                                  |
| <div>Supply Sources</div>          | Supply sources for the campaign (APPSTORE\_SEARCH\_RESULTS, APPSTORE\_SEARCH\_TAB)<br /><br />**Field Name:** `supplySources`<br />**Type:** dimension |
| <div>Campaign Daily Budget</div>   | Daily budget amount for the campaign<br /><br />**Field Name:** `campaignDailyBudget`<br />**Type:** dimension                                         |
| <div>Campaign Total Budget</div>   | Total budget amount for the campaign<br /><br />**Field Name:** `campaignTotalBudget`<br />**Type:** dimension                                         |
| <div>Bidding Strategy</div>        | Bidding strategy type for the campaign<br /><br />**Field Name:** `biddingStrategy`<br />**Type:** dimension                                           |

### Ad Group

|                                      |                                                                                                                                      |
| ------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------ |
| <div>Ad Group Name</div>             | Name of the ad group<br /><br />**Field Name:** `adGroupName`<br />**Type:** dimension                                               |
| <div>Ad Group ID</div>               | Unique identifier for the ad group<br /><br />**Field Name:** `adGroupId`<br />**Type:** dimension                                   |
| <div>Ad Group Status</div>           | Current status of the ad group<br /><br />**Field Name:** `adGroupStatus`<br />**Type:** dimension                                   |
| <div>Ad Group Serving Status</div>   | Serving status of the ad group<br /><br />**Field Name:** `adGroupServingStatus`<br />**Type:** dimension                            |
| <div>Automated Keywords Opt-In</div> | Whether automated keywords are enabled for the ad group<br /><br />**Field Name:** `automatedKeywordsOptIn`<br />**Type:** dimension |

### Ad

|                              |                                                                                                    |
| ---------------------------- | -------------------------------------------------------------------------------------------------- |
| <div>Ad ID</div>             | Unique identifier for the ad<br /><br />**Field Name:** `adId`<br />**Type:** dimension            |
| <div>Ad Name</div>           | Name of the ad<br /><br />**Field Name:** `adName`<br />**Type:** dimension                        |
| <div>Creative Type</div>     | Type of creative used in the ad<br /><br />**Field Name:** `creativeType`<br />**Type:** dimension |
| <div>Ad Status</div>         | Current status of the ad<br /><br />**Field Name:** `adStatus`<br />**Type:** dimension            |
| <div>Ad Display Status</div> | Display status of the ad<br /><br />**Field Name:** `adDisplayStatus`<br />**Type:** dimension     |
| <div>Ad Language</div>       | Language of the ad creative<br /><br />**Field Name:** `adLanguage`<br />**Type:** dimension       |

### Keyword

|                                   |                                                                                                          |
| --------------------------------- | -------------------------------------------------------------------------------------------------------- |
| <div>Keyword</div>                | The keyword text<br /><br />**Field Name:** `keyword`<br />**Type:** dimension                           |
| <div>Keyword ID</div>             | Unique identifier for the keyword<br /><br />**Field Name:** `keywordId`<br />**Type:** dimension        |
| <div>Keyword Status</div>         | Current status of the keyword<br /><br />**Field Name:** `keywordStatus`<br />**Type:** dimension        |
| <div>Keyword Display Status</div> | Display status of the keyword<br /><br />**Field Name:** `keywordDisplayStatus`<br />**Type:** dimension |

### Search Term

|                               |                                                                                                                                                            |
| ----------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------- |
| <div>Search Term Text</div>   | The actual search term that triggered the ad<br /><br />**Field Name:** `searchTermText`<br />**Type:** dimension                                          |
| <div>Search Term Source</div> | Source of the search term (AUTO or TARGETED)<br /><br />**Field Name:** `searchTermSource`<br />**Type:** dimension                                        |
| <div>Match Type</div>         | Match type of the keyword (EXACT, BROAD, or AUTO for Search Match traffic with no keyword)<br /><br />**Field Name:** `matchType`<br />**Type:** dimension |

### App

|                                 |                                                                                                                       |
| ------------------------------- | --------------------------------------------------------------------------------------------------------------------- |
| <div>App Name</div>             | Name of the app being advertised<br /><br />**Field Name:** `appName`<br />**Type:** dimension                        |
| <div>App ID</div>               | Unique App Store identifier (Adam ID)<br /><br />**Field Name:** `appId`<br />**Type:** dimension                     |
| <div>App Primary Category</div> | Primary category of the app in the App Store<br /><br />**Field Name:** `appPrimaryCategory`<br />**Type:** dimension |

### Device

|                         |                                                                                              |
| ----------------------- | -------------------------------------------------------------------------------------------- |
| <div>Device Class</div> | Device type (IPHONE, IPAD)<br /><br />**Field Name:** `deviceClass`<br />**Type:** dimension |

### Geo

|                              |                                                                                                                 |
| ---------------------------- | --------------------------------------------------------------------------------------------------------------- |
| <div>Country or Region</div> | Country or region where the ad was served<br /><br />**Field Name:** `countryOrRegion`<br />**Type:** dimension |
| <div>Country Code</div>      | ISO country code<br /><br />**Field Name:** `countryCode`<br />**Type:** dimension                              |
| <div>Admin Area</div>        | Administrative area (state or province)<br /><br />**Field Name:** `adminArea`<br />**Type:** dimension         |
| <div>Locality</div>          | City or locality<br /><br />**Field Name:** `locality`<br />**Type:** dimension                                 |

### Demographics

|                      |                                                                                                      |
| -------------------- | ---------------------------------------------------------------------------------------------------- |
| <div>Gender</div>    | Gender demographic of the audience<br /><br />**Field Name:** `gender`<br />**Type:** dimension      |
| <div>Age Range</div> | Age range demographic of the audience<br /><br />**Field Name:** `ageRange`<br />**Type:** dimension |

## Metrics

Metrics are the numerical values you can measure and analyze from your Apple Search Ads campaigns.

### Performance

|                           |                                                                                                                              |
| ------------------------- | ---------------------------------------------------------------------------------------------------------------------------- |
| <div>Impressions</div>    | Number of times the ad was displayed<br /><br />**Field Name:** `impressions`<br />**Type:** metric                          |
| <div>Taps</div>           | Number of times the ad was tapped<br /><br />**Field Name:** `taps`<br />**Type:** metric                                    |
| <div>Installs</div>       | Number of installs attributed to taps on the ad<br /><br />**Field Name:** `tapInstalls`<br />**Type:** metric               |
| <div>Total Installs</div> | Total installs including both tap and view-through installs<br /><br />**Field Name:** `totalInstalls`<br />**Type:** metric |
| <div>View Installs</div>  | Number of installs attributed to viewing the ad<br /><br />**Field Name:** `viewInstalls`<br />**Type:** metric              |

### Cost

|                                   |                                                                                                                         |
| --------------------------------- | ----------------------------------------------------------------------------------------------------------------------- |
| <div>Cost</div>                   | Total spend in the local currency<br /><br />**Field Name:** `localSpend`<br />**Type:** metric                         |
| <div>Cost per Tap</div>           | Average cost per tap<br /><br />**Field Name:** `avgCPT`<br />**Type:** metric                                          |
| <div>Cost per Mille</div>         | Average cost per 1,000 impressions<br /><br />**Field Name:** `avgCPM`<br />**Type:** metric                            |
| <div>Cost per Install</div>       | Average cost per tap-through install<br /><br />**Field Name:** `tapInstallCPI`<br />**Type:** metric                   |
| <div>Total Cost per Install</div> | Average cost per install including view-through installs<br /><br />**Field Name:** `totalAvgCPI`<br />**Type:** metric |

### Rates

|                               |                                                                                                                                  |
| ----------------------------- | -------------------------------------------------------------------------------------------------------------------------------- |
| <div>Tap-through Rate</div>   | Percentage of impressions that resulted in a tap<br /><br />**Field Name:** `ttr`<br />**Type:** metric                          |
| <div>Conversion Rate</div>    | Percentage of taps that resulted in an install<br /><br />**Field Name:** `conversionRate`<br />**Type:** metric                 |
| <div>Install Rate</div>       | Percentage of taps that resulted in a tap-through install<br /><br />**Field Name:** `tapInstallRate`<br />**Type:** metric      |
| <div>Total Install Rate</div> | Percentage of taps that resulted in any install (tap + view)<br /><br />**Field Name:** `totalInstallRate`<br />**Type:** metric |

### Downloads

|                                |                                                                                                                          |
| ------------------------------ | ------------------------------------------------------------------------------------------------------------------------ |
| <div>New Downloads</div>       | Number of new downloads attributed to taps<br /><br />**Field Name:** `tapNewDownloads`<br />**Type:** metric            |
| <div>Re-downloads</div>        | Number of re-downloads attributed to taps<br /><br />**Field Name:** `tapRedownloads`<br />**Type:** metric              |
| <div>View New Downloads</div>  | Number of new downloads attributed to viewing the ad<br /><br />**Field Name:** `viewNewDownloads`<br />**Type:** metric |
| <div>View Re-downloads</div>   | Number of re-downloads attributed to viewing the ad<br /><br />**Field Name:** `viewRedownloads`<br />**Type:** metric   |
| <div>Total New Downloads</div> | Total new downloads from both taps and views<br /><br />**Field Name:** `totalNewDownloads`<br />**Type:** metric        |
| <div>Total Re-downloads</div>  | Total re-downloads from both taps and views<br /><br />**Field Name:** `totalRedownloads`<br />**Type:** metric          |

### Pre-orders

|                             |                                                                                                                          |
| --------------------------- | ------------------------------------------------------------------------------------------------------------------------ |
| <div>Pre-orders Tap</div>   | Number of pre-orders placed attributed to taps<br /><br />**Field Name:** `tapPreOrdersPlaced`<br />**Type:** metric     |
| <div>Pre-orders View</div>  | Number of pre-orders placed attributed to views<br /><br />**Field Name:** `viewPreOrdersPlaced`<br />**Type:** metric   |
| <div>Total Pre-orders</div> | Total pre-orders placed from both taps and views<br /><br />**Field Name:** `totalPreOrdersPlaced`<br />**Type:** metric |

***

## Related

<CardGroup>
  <Card title="Fields Catalog" icon="book" href="/fields-catalog">
    Browse all platforms
  </Card>

  <Card title="Google Ads Fields" icon="chart-bar" href="/data-source/google-ads/fields">
    Google Ads metrics & dimensions
  </Card>

  <Card title="Meta Ads Fields" icon="chart-bar" href="/data-source/facebook-ads/fields">
    Meta Ads metrics & dimensions
  </Card>

  <Card title="TikTok Ads Fields" icon="chart-bar" href="/data-source/tiktok-ads/fields">
    TikTok Ads metrics & dimensions
  </Card>
</CardGroup>


# AppsFlyer Metrics & Dimensions
Source: https://support.detrics.io/data-source/appsflyer/fields

Complete reference for AppsFlyer dimensions and metrics

<Info>
  **Last updated:** August 6, 2026
</Info>

<div>
  <div>
    85 dimensions
  </div>

  <div>
    27 metrics
  </div>
</div>

This reference covers all available dimensions and metrics for AppsFlyer data through Detrics. Use this guide to understand what data you can extract and how to structure your queries.

<div>
  <span>Supported destinations:</span>

  <div>
    Google Sheets
  </div>

  <div>
    Claude
  </div>

  <div>
    BigQuery
  </div>
</div>

## Dimensions

Dimensions are the attributes you can use to segment and group your AppsFlyer data.

### App

|                      |                                                                                                                                    |
| -------------------- | ---------------------------------------------------------------------------------------------------------------------------------- |
| <div>App ID</div>    | The app the data belongs to (iOS App Store ID or Android package name)<br /><br />**Field Name:** `appId`<br />**Type:** dimension |
| <div>App Name</div>  | Display name of the app<br /><br />**Field Name:** `appName`<br />**Type:** dimension                                              |
| <div>Bundle ID</div> | App bundle identifier<br /><br />**Field Name:** `bundleId`<br />**Type:** dimension                                               |

### Attribution

|                                        |                                                                                                                                                |
| -------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------- |
| <div>Media Source</div>                | The media source / partner (pid) that drove the traffic<br /><br />**Field Name:** `mediaSource`<br />**Type:** dimension                      |
| <div>Campaign</div>                    | The campaign name reported by the media source<br /><br />**Field Name:** `campaign`<br />**Type:** dimension                                  |
| <div>Agency / PMD</div>                | The agency or PMD (af\_prt) that managed the campaign (aggregate surface)<br /><br />**Field Name:** `agency`<br />**Type:** dimension         |
| <div>Attributed Touch Type</div>       | Type of the attributed touch (click, impression)<br /><br />**Field Name:** `attributedTouchType`<br />**Type:** dimension                     |
| <div>Attributed Touch Time</div>       | Timestamp of the attributed touch<br /><br />**Field Name:** `attributedTouchTime`<br />**Type:** dimension                                    |
| <div>Partner</div>                     | Integrated partner that drove the install/event<br /><br />**Field Name:** `partner`<br />**Type:** dimension                                  |
| <div>Channel</div>                     | Marketing channel reported by the media source<br /><br />**Field Name:** `channel`<br />**Type:** dimension                                   |
| <div>Keywords</div>                    | Keywords reported by the media source<br /><br />**Field Name:** `keywords`<br />**Type:** dimension                                           |
| <div>Campaign ID</div>                 | Campaign identifier reported by the media source<br /><br />**Field Name:** `campaignId`<br />**Type:** dimension                              |
| <div>Adset</div>                       | Ad set name reported by the media source<br /><br />**Field Name:** `adset`<br />**Type:** dimension                                           |
| <div>Adset ID</div>                    | Ad set identifier reported by the media source<br /><br />**Field Name:** `adsetId`<br />**Type:** dimension                                   |
| <div>Ad</div>                          | Ad name reported by the media source<br /><br />**Field Name:** `ad`<br />**Type:** dimension                                                  |
| <div>Ad ID</div>                       | Ad identifier reported by the media source<br /><br />**Field Name:** `adId`<br />**Type:** dimension                                          |
| <div>Ad Type</div>                     | Type of the ad<br /><br />**Field Name:** `adType`<br />**Type:** dimension                                                                    |
| <div>Site ID</div>                     | Publisher site identifier<br /><br />**Field Name:** `siteId`<br />**Type:** dimension                                                         |
| <div>Sub Site ID</div>                 | Publisher sub-site identifier<br /><br />**Field Name:** `subSiteId`<br />**Type:** dimension                                                  |
| <div>Is Retargeting</div>              | Whether the record is a retargeting (re-engagement) conversion<br /><br />**Field Name:** `isRetargeting`<br />**Type:** dimension             |
| <div>Retargeting Conversion Type</div> | Type of retargeting conversion (re-attribution, re-engagement)<br /><br />**Field Name:** `retargetingConversionType`<br />**Type:** dimension |
| <div>Attribution Lookback</div>        | Attribution lookback window applied<br /><br />**Field Name:** `attributionLookback`<br />**Type:** dimension                                  |
| <div>Reengagement Window</div>         | Re-engagement window applied<br /><br />**Field Name:** `reengagementWindow`<br />**Type:** dimension                                          |
| <div>Is Primary Attribution</div>      | Whether this is the primary attribution record<br /><br />**Field Name:** `isPrimaryAttribution`<br />**Type:** dimension                      |
| <div>Original URL</div>                | Original attribution URL<br /><br />**Field Name:** `originalUrl`<br />**Type:** dimension                                                     |
| <div>HTTP Referrer</div>               | HTTP referrer of the click<br /><br />**Field Name:** `httpReferrer`<br />**Type:** dimension                                                  |

### Contributors

|                                       |                                                                                                                                        |
| ------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------- |
| <div>Contributor 1 Partner</div>      | First assisting partner in multi-touch attribution<br /><br />**Field Name:** `contributor1Partner`<br />**Type:** dimension           |
| <div>Contributor 1 Media Source</div> | First assisting media source in multi-touch attribution<br /><br />**Field Name:** `contributor1MediaSource`<br />**Type:** dimension  |
| <div>Contributor 1 Campaign</div>     | First assisting campaign in multi-touch attribution<br /><br />**Field Name:** `contributor1Campaign`<br />**Type:** dimension         |
| <div>Contributor 1 Touch Type</div>   | Touch type of the first assisting contributor<br /><br />**Field Name:** `contributor1TouchType`<br />**Type:** dimension              |
| <div>Contributor 1 Touch Time</div>   | Touch time of the first assisting contributor<br /><br />**Field Name:** `contributor1TouchTime`<br />**Type:** dimension              |
| <div>Contributor 2 Partner</div>      | Second assisting partner in multi-touch attribution<br /><br />**Field Name:** `contributor2Partner`<br />**Type:** dimension          |
| <div>Contributor 2 Media Source</div> | Second assisting media source in multi-touch attribution<br /><br />**Field Name:** `contributor2MediaSource`<br />**Type:** dimension |
| <div>Contributor 2 Campaign</div>     | Second assisting campaign in multi-touch attribution<br /><br />**Field Name:** `contributor2Campaign`<br />**Type:** dimension        |
| <div>Contributor 2 Touch Type</div>   | Touch type of the second assisting contributor<br /><br />**Field Name:** `contributor2TouchType`<br />**Type:** dimension             |
| <div>Contributor 2 Touch Time</div>   | Touch time of the second assisting contributor<br /><br />**Field Name:** `contributor2TouchTime`<br />**Type:** dimension             |
| <div>Contributor 3 Partner</div>      | Third assisting partner in multi-touch attribution<br /><br />**Field Name:** `contributor3Partner`<br />**Type:** dimension           |
| <div>Contributor 3 Media Source</div> | Third assisting media source in multi-touch attribution<br /><br />**Field Name:** `contributor3MediaSource`<br />**Type:** dimension  |
| <div>Contributor 3 Campaign</div>     | Third assisting campaign in multi-touch attribution<br /><br />**Field Name:** `contributor3Campaign`<br />**Type:** dimension         |
| <div>Contributor 3 Touch Type</div>   | Touch type of the third assisting contributor<br /><br />**Field Name:** `contributor3TouchType`<br />**Type:** dimension              |
| <div>Contributor 3 Touch Time</div>   | Touch time of the third assisting contributor<br /><br />**Field Name:** `contributor3TouchTime`<br />**Type:** dimension              |

### Geo

|                         |                                                                                                                            |
| ----------------------- | -------------------------------------------------------------------------------------------------------------------------- |
| <div>Country</div>      | Country where the install/event occurred (aggregate surface)<br /><br />**Field Name:** `country`<br />**Type:** dimension |
| <div>Country Code</div> | ISO country code (raw surface)<br /><br />**Field Name:** `countryCode`<br />**Type:** dimension                           |
| <div>Region</div>       | Region of the user<br /><br />**Field Name:** `region`<br />**Type:** dimension                                            |
| <div>State</div>        | State / province of the user<br /><br />**Field Name:** `state`<br />**Type:** dimension                                   |
| <div>City</div>         | City of the user<br /><br />**Field Name:** `city`<br />**Type:** dimension                                                |
| <div>Postal Code</div>  | Postal code of the user<br /><br />**Field Name:** `postalCode`<br />**Type:** dimension                                   |
| <div>DMA</div>          | Designated Market Area<br /><br />**Field Name:** `dma`<br />**Type:** dimension                                           |
| <div>IP</div>           | IP address of the user<br /><br />**Field Name:** `ip`<br />**Type:** dimension                                            |

### Device

|                        |                                                                                                       |
| ---------------------- | ----------------------------------------------------------------------------------------------------- |
| <div>Platform</div>    | Device platform (ios, android)<br /><br />**Field Name:** `platform`<br />**Type:** dimension         |
| <div>Device Type</div> | Device type / model<br /><br />**Field Name:** `deviceType`<br />**Type:** dimension                  |
| <div>OS Version</div>  | Operating system version<br /><br />**Field Name:** `osVersion`<br />**Type:** dimension              |
| <div>App Version</div> | App version at the time of the event<br /><br />**Field Name:** `appVersion`<br />**Type:** dimension |
| <div>SDK Version</div> | AppsFlyer SDK version<br /><br />**Field Name:** `sdkVersion`<br />**Type:** dimension                |
| <div>Carrier</div>     | Mobile carrier<br /><br />**Field Name:** `carrier`<br />**Type:** dimension                          |
| <div>Operator</div>    | Mobile network operator<br /><br />**Field Name:** `operator`<br />**Type:** dimension                |
| <div>Language</div>    | Device language<br /><br />**Field Name:** `language`<br />**Type:** dimension                        |
| <div>WIFI</div>        | Whether the device was on WiFi<br /><br />**Field Name:** `wifi`<br />**Type:** dimension             |
| <div>User Agent</div>  | Device user agent string<br /><br />**Field Name:** `userAgent`<br />**Type:** dimension              |

### User IDs

|                                  |                                                                                                               |
| -------------------------------- | ------------------------------------------------------------------------------------------------------------- |
| <div>AppsFlyer ID</div>          | Unique AppsFlyer device identifier<br /><br />**Field Name:** `appsflyerId`<br />**Type:** dimension          |
| <div>Customer User ID</div>      | Your own user identifier set via the SDK<br /><br />**Field Name:** `customerUserId`<br />**Type:** dimension |
| <div>Advertising ID (GAID)</div> | Google Advertising ID<br /><br />**Field Name:** `advertisingId`<br />**Type:** dimension                     |
| <div>IDFA</div>                  | iOS Identifier for Advertisers<br /><br />**Field Name:** `idfa`<br />**Type:** dimension                     |
| <div>IDFV</div>                  | iOS Identifier for Vendors<br /><br />**Field Name:** `idfv`<br />**Type:** dimension                         |
| <div>Android ID</div>            | Android device identifier<br /><br />**Field Name:** `androidId`<br />**Type:** dimension                     |
| <div>IMEI</div>                  | Device IMEI (legacy)<br /><br />**Field Name:** `imei`<br />**Type:** dimension                               |

### Event

|                                   |                                                                                                                     |
| --------------------------------- | ------------------------------------------------------------------------------------------------------------------- |
| <div>Event Name</div>             | Name of the in-app event<br /><br />**Field Name:** `eventName`<br />**Type:** dimension                            |
| <div>Event Time</div>             | Timestamp of the in-app event<br /><br />**Field Name:** `eventTime`<br />**Type:** dimension                       |
| <div>Install Time</div>           | Timestamp of the install<br /><br />**Field Name:** `installTime`<br />**Type:** dimension                          |
| <div>Event Value</div>            | Raw event value payload (JSON string)<br /><br />**Field Name:** `eventValue`<br />**Type:** dimension              |
| <div>Event Revenue Currency</div> | Currency of the event revenue<br /><br />**Field Name:** `eventRevenueCurrency`<br />**Type:** dimension            |
| <div>Event Source</div>           | Source of the event (SDK, S2S)<br /><br />**Field Name:** `eventSource`<br />**Type:** dimension                    |
| <div>Is Receipt Validated</div>   | Whether the purchase receipt was validated<br /><br />**Field Name:** `isReceiptValidated`<br />**Type:** dimension |

### Cost

|                          |                                                                                                                       |
| ------------------------ | --------------------------------------------------------------------------------------------------------------------- |
| <div>Cost Model</div>    | Cost model reported by the media source (CPI, CPC, …)<br /><br />**Field Name:** `costModel`<br />**Type:** dimension |
| <div>Cost Currency</div> | Currency of the reported cost<br /><br />**Field Name:** `costCurrency`<br />**Type:** dimension                      |

### Ad Revenue

|                                 |                                                                                                                        |
| ------------------------------- | ---------------------------------------------------------------------------------------------------------------------- |
| <div>Mediation Network</div>    | Ad mediation network (ad revenue surface)<br /><br />**Field Name:** `mediationNetwork`<br />**Type:** dimension       |
| <div>Monetization Network</div> | Ad monetization network (ad revenue surface)<br /><br />**Field Name:** `monetizationNetwork`<br />**Type:** dimension |
| <div>Segment</div>              | Ad revenue segment<br /><br />**Field Name:** `segment`<br />**Type:** dimension                                       |
| <div>Ad Unit</div>              | Ad unit identifier (ad revenue surface)<br /><br />**Field Name:** `adUnit`<br />**Type:** dimension                   |
| <div>Placement</div>            | Ad placement (ad revenue surface)<br /><br />**Field Name:** `placement`<br />**Type:** dimension                      |

### Custom Parameters

|                        |                                                                                        |
| ---------------------- | -------------------------------------------------------------------------------------- |
| <div>Sub Param 1</div> | Custom sub-parameter 1<br /><br />**Field Name:** `subParam1`<br />**Type:** dimension |
| <div>Sub Param 2</div> | Custom sub-parameter 2<br /><br />**Field Name:** `subParam2`<br />**Type:** dimension |
| <div>Sub Param 3</div> | Custom sub-parameter 3<br /><br />**Field Name:** `subParam3`<br />**Type:** dimension |
| <div>Sub Param 4</div> | Custom sub-parameter 4<br /><br />**Field Name:** `subParam4`<br />**Type:** dimension |
| <div>Sub Param 5</div> | Custom sub-parameter 5<br /><br />**Field Name:** `subParam5`<br />**Type:** dimension |

## Metrics

Metrics are the numerical values you can measure and analyze from your AppsFlyer campaigns.

### Performance (Aggregate)

|                        |                                                                                                                          |
| ---------------------- | ------------------------------------------------------------------------------------------------------------------------ |
| <div>Impressions</div> | Number of ad impressions reported by the media source<br /><br />**Field Name:** `impressions`<br />**Type:** metric     |
| <div>Clicks</div>      | Number of ad clicks reported by the media source<br /><br />**Field Name:** `clicks`<br />**Type:** metric               |
| <div>Installs</div>    | Number of attributed app installs<br /><br />**Field Name:** `installs`<br />**Type:** metric                            |
| <div>Sessions</div>    | Number of app sessions<br /><br />**Field Name:** `sessions`<br />**Type:** metric                                       |
| <div>Loyal Users</div> | Users who completed enough sessions to be considered loyal<br /><br />**Field Name:** `loyalUsers`<br />**Type:** metric |

### Rates (Aggregate)

|                                   |                                                                                                                                            |
| --------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------ |
| <div>CTR</div>                    | Click-through rate (clicks / impressions)<br /><br />**Field Name:** `ctr`<br />**Type:** metric                                           |
| <div>Conversion Rate</div>        | Install conversion rate (installs / clicks)<br /><br />**Field Name:** `conversionRate`<br />**Type:** metric                              |
| <div>Loyal Users / Installs</div> | Share of installs that became loyal users (loyal users / installs)<br /><br />**Field Name:** `loyalUsersPerInstall`<br />**Type:** metric |

### Revenue (Aggregate)

|                          |                                                                                                              |
| ------------------------ | ------------------------------------------------------------------------------------------------------------ |
| <div>Total Revenue</div> | Total revenue attributed to the media source<br /><br />**Field Name:** `totalRevenue`<br />**Type:** metric |
| <div>ARPU</div>          | Average revenue per user (total revenue / installs)<br /><br />**Field Name:** `arpu`<br />**Type:** metric  |
| <div>ROI</div>           | Return on investment ((revenue - cost) / cost)<br /><br />**Field Name:** `roi`<br />**Type:** metric        |

### Cost (Aggregate)

|                         |                                                                                                                              |
| ----------------------- | ---------------------------------------------------------------------------------------------------------------------------- |
| <div>Total Cost</div>   | Total media cost (requires AppsFlyer cost integration / ROI360)<br /><br />**Field Name:** `totalCost`<br />**Type:** metric |
| <div>Average eCPI</div> | Effective cost per install (total cost / installs)<br /><br />**Field Name:** `averageEcpi`<br />**Type:** metric            |

### Installs (Raw)

|                             |                                                                                                                 |
| --------------------------- | --------------------------------------------------------------------------------------------------------------- |
| <div>Installs (count)</div> | Raw count of install rows (installs raw report)<br /><br />**Field Name:** `installCount`<br />**Type:** metric |

### In-App Events (Raw)

|                                |                                                                                                              |
| ------------------------------ | ------------------------------------------------------------------------------------------------------------ |
| <div>Events (count)</div>      | Raw count of in-app event rows<br /><br />**Field Name:** `eventCount`<br />**Type:** metric                 |
| <div>Event Revenue</div>       | Sum of in-app event revenue (event currency)<br /><br />**Field Name:** `eventRevenue`<br />**Type:** metric |
| <div>Event Revenue (USD)</div> | Sum of in-app event revenue in USD<br /><br />**Field Name:** `eventRevenueUsd`<br />**Type:** metric        |

### Uninstalls (Raw)

|                               |                                                                                               |
| ----------------------------- | --------------------------------------------------------------------------------------------- |
| <div>Uninstalls (count)</div> | Raw count of uninstall rows<br /><br />**Field Name:** `uninstallCount`<br />**Type:** metric |

### Reinstalls (Raw)

|                               |                                                                                               |
| ----------------------------- | --------------------------------------------------------------------------------------------- |
| <div>Reinstalls (count)</div> | Raw count of reinstall rows<br /><br />**Field Name:** `reinstallCount`<br />**Type:** metric |

### Re-engagement Installs (Raw)

|                                           |                                                                                                                               |
| ----------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------- |
| <div>Re-engagement Installs (count)</div> | Raw count of re-engagement (retargeting) install rows<br /><br />**Field Name:** `retargetInstallCount`<br />**Type:** metric |

### Re-engagement Events (Raw)

|                                         |                                                                                                                                  |
| --------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------- |
| <div>Re-engagement Events (count)</div> | Raw count of re-engagement (retargeting) in-app event rows<br /><br />**Field Name:** `retargetEventCount`<br />**Type:** metric |
| <div>Re-engagement Event Revenue</div>  | Sum of re-engagement (retargeting) event revenue<br /><br />**Field Name:** `retargetEventRevenue`<br />**Type:** metric         |

### Ad Revenue (Raw)

|                                      |                                                                                                             |
| ------------------------------------ | ----------------------------------------------------------------------------------------------------------- |
| <div>Ad Revenue Events (count)</div> | Raw count of ad-revenue rows<br /><br />**Field Name:** `adRevenueCount`<br />**Type:** metric              |
| <div>Ad Revenue</div>                | Sum of ad revenue (event currency)<br /><br />**Field Name:** `adRevenue`<br />**Type:** metric             |
| <div>Ad Revenue (USD)</div>          | Sum of ad revenue in USD<br /><br />**Field Name:** `adRevenueUsd`<br />**Type:** metric                    |
| <div>Ad Impressions</div>            | Sum of ad impressions (ad revenue surface)<br /><br />**Field Name:** `adImpressions`<br />**Type:** metric |

### Cost (Raw)

|                 |                                                                                                                                  |
| --------------- | -------------------------------------------------------------------------------------------------------------------------------- |
| <div>Cost</div> | Sum of media cost from the raw export (valid with any raw category)<br /><br />**Field Name:** `costValue`<br />**Type:** metric |

***

## Related

<CardGroup>
  <Card title="Fields Catalog" icon="book" href="/fields-catalog">
    Browse all platforms
  </Card>

  <Card title="Apple Search Ads Fields" icon="chart-bar" href="/data-source/apple-search-ads/fields">
    Apple Search Ads metrics & dimensions
  </Card>

  <Card title="Meta Ads Fields" icon="chart-bar" href="/data-source/facebook-ads/fields">
    Meta Ads metrics & dimensions
  </Card>

  <Card title="Google Ads Fields" icon="chart-bar" href="/data-source/google-ads/fields">
    Google Ads metrics & dimensions
  </Card>
</CardGroup>


# Bing Ads Metrics & Dimensions
Source: https://support.detrics.io/data-source/bing-ads/fields

Complete reference for Bing Ads dimensions and metrics

<Info>
  **Last updated:** August 6, 2026
</Info>

<div>
  <div>
    53 dimensions
  </div>

  <div>
    85 metrics
  </div>
</div>

This reference covers all available dimensions and metrics for Bing Ads data through Detrics. Use this guide to understand what data you can extract and how to structure your queries.

<div>
  <span>Supported destinations:</span>

  <div>
    Google Sheets
  </div>

  <div>
    Looker Studio
  </div>

  <div>
    Claude
  </div>

  <div>
    BigQuery
  </div>
</div>

## Dimensions

Dimensions are the attributes you can use to segment and group your Bing Ads data.

### Most Used

|                            |                                                                                                                                         |
| -------------------------- | --------------------------------------------------------------------------------------------------------------------------------------- |
| <div>Account Id</div>      | <br /><br />**Field Name:** `AccountId`<br />**Type:** dimension                                                                        |
| <div>Account Name</div>    | <br /><br />**Field Name:** `AccountName`<br />**Type:** dimension                                                                      |
| <div>Campaign Id</div>     | <br /><br />**Field Name:** `CampaignId`<br />**Type:** dimension                                                                       |
| <div>Campaign Name</div>   | <br /><br />**Field Name:** `CampaignName`<br />**Type:** dimension                                                                     |
| <div>Campaign Labels</div> | Labels applied to the campaign (semicolon-separated when multiple)<br /><br />**Field Name:** `CampaignLabels`<br />**Type:** dimension |
| <div>Ad Group Id</div>     | <br /><br />**Field Name:** `AdGroupId`<br />**Type:** dimension                                                                        |
| <div>Ad Group Name</div>   | <br /><br />**Field Name:** `AdGroupName`<br />**Type:** dimension                                                                      |
| <div>Ad Group Labels</div> | Labels applied to the ad group (semicolon-separated when multiple)<br /><br />**Field Name:** `AdGroupLabels`<br />**Type:** dimension  |

### Ad

|                             |                                                                                                                                       |
| --------------------------- | ------------------------------------------------------------------------------------------------------------------------------------- |
| <div>Ad Id</div>            | <br /><br />**Field Name:** `AdId`<br />**Type:** dimension                                                                           |
| <div>Ad Type</div>          | The type of ad<br /><br />**Field Name:** `AdType`<br />**Type:** dimension                                                           |
| <div>Ad Title</div>         | The title/headline of the ad<br /><br />**Field Name:** `AdTitle`<br />**Type:** dimension                                            |
| <div>Ad Description</div>   | The first ad description that appears below the path in your ad<br /><br />**Field Name:** `AdDescription`<br />**Type:** dimension   |
| <div>Ad Description 2</div> | The second ad description that appears below the path in your ad<br /><br />**Field Name:** `AdDescription2`<br />**Type:** dimension |
| <div>Headline</div>         | The headline of the ad<br /><br />**Field Name:** `Headline`<br />**Type:** dimension                                                 |
| <div>Long Headline</div>    | The long headline of the ad<br /><br />**Field Name:** `LongHeadline`<br />**Type:** dimension                                        |
| <div>Ad Status</div>        | Status of the ad<br /><br />**Field Name:** `AdStatus`<br />**Type:** dimension                                                       |
| <div>Ad Labels</div>        | Labels of the ad<br /><br />**Field Name:** `AdLabels`<br />**Type:** dimension                                                       |
| <div>Language</div>         | Language of the ad<br /><br />**Field Name:** `Language`<br />**Type:** dimension                                                     |

### Budget

|                                  |                                                                                         |
| -------------------------------- | --------------------------------------------------------------------------------------- |
| <div>Campaign Daily Budget</div> | <br /><br />**Field Name:** `CampaignDailyBudget`<br />**Type:** dimension              |
| <div>Campaign Budget Type</div>  | <br /><br />**Field Name:** `CampaignBudgetType`<br />**Type:** dimension               |
| <div>Budget Name</div>           | Name of the budget<br /><br />**Field Name:** `BudgetName`<br />**Type:** dimension     |
| <div>Budget Status</div>         | Status of the budget<br /><br />**Field Name:** `BudgetStatus`<br />**Type:** dimension |

### Breakdowns

|                                 |                                                                                                                                        |
| ------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------- |
| <div>Ad Distribution</div>      | The network where your ads show (Search, Audience, Cross-network)<br /><br />**Field Name:** `AdDistribution`<br />**Type:** dimension |
| <div>Network</div>              | Network of the ad<br /><br />**Field Name:** `Network`<br />**Type:** dimension                                                        |
| <div>Delivered Match Type</div> | Type of delivered match<br /><br />**Field Name:** `DeliveredMatchType`<br />**Type:** dimension                                       |
| <div>Device OS</div>            | Operating system of the device<br /><br />**Field Name:** `DeviceOS`<br />**Type:** dimension                                          |
| <div>Device Type</div>          | Type of the device<br /><br />**Field Name:** `DeviceType`<br />**Type:** dimension                                                    |
| <div>Top vs Other</div>         | Indicates whether the ad appeared in top or other positions<br /><br />**Field Name:** `TopVsOther`<br />**Type:** dimension           |
| <div>Bid Match Type</div>       | The keyword bid match type (Broad, Exact, Phrase)<br /><br />**Field Name:** `BidMatchType`<br />**Type:** dimension                   |

### URLs

|                              |                                                                                                              |
| ---------------------------- | ------------------------------------------------------------------------------------------------------------ |
| <div>Final URL</div>         | Final URL of the ad<br /><br />**Field Name:** `FinalUrl`<br />**Type:** dimension                           |
| <div>Display URL</div>       | URL displayed in the ad<br /><br />**Field Name:** `DisplayUrl`<br />**Type:** dimension                     |
| <div>Final Mobile URL</div>  | Final mobile URL of the ad<br /><br />**Field Name:** `FinalMobileUrl`<br />**Type:** dimension              |
| <div>Final App URL</div>     | Final app URL of the ad<br /><br />**Field Name:** `FinalAppUrl`<br />**Type:** dimension                    |
| <div>Final URL Suffix</div>  | Suffix of the final URL<br /><br />**Field Name:** `FinalUrlSuffix`<br />**Type:** dimension                 |
| <div>Tracking Template</div> | The tracking template used for the ad<br /><br />**Field Name:** `TrackingTemplate`<br />**Type:** dimension |

### Status

|                            |                                                                       |
| -------------------------- | --------------------------------------------------------------------- |
| <div>Account Status</div>  | <br /><br />**Field Name:** `AccountStatus`<br />**Type:** dimension  |
| <div>Campaign Status</div> | <br /><br />**Field Name:** `CampaignStatus`<br />**Type:** dimension |
| <div>Ad Group Status</div> | <br /><br />**Field Name:** `AdGroupStatus`<br />**Type:** dimension  |

### Types

|                          |                                                                     |
| ------------------------ | ------------------------------------------------------------------- |
| <div>Campaign Type</div> | <br /><br />**Field Name:** `CampaignType`<br />**Type:** dimension |

### Additional

|                             |                                                                                           |
| --------------------------- | ----------------------------------------------------------------------------------------- |
| <div>Account Number</div>   | Number of the account<br /><br />**Field Name:** `AccountNumber`<br />**Type:** dimension |
| <div>Customer Id</div>      | <br /><br />**Field Name:** `CustomerId`<br />**Type:** dimension                         |
| <div>Base Campaign Id</div> | <br /><br />**Field Name:** `BaseCampaignId`<br />**Type:** dimension                     |
| <div>Customer Name</div>    | <br /><br />**Field Name:** `CustomerName`<br />**Type:** dimension                       |
| <div>Currency Code</div>    | <br /><br />**Field Name:** `CurrencyCode`<br />**Type:** dimension                       |

### Search Terms

|                                  |                                                                                                                                |
| -------------------------------- | ------------------------------------------------------------------------------------------------------------------------------ |
| <div>Search Query</div>          | The search term used by your audience when your ad was shown<br /><br />**Field Name:** `SearchQuery`<br />**Type:** dimension |
| <div>Keyword</div>               | The keyword text that matched the search query<br /><br />**Field Name:** `Keyword`<br />**Type:** dimension                   |
| <div>Keyword Id</div>            | Microsoft Advertising keyword identifier<br /><br />**Field Name:** `KeywordId`<br />**Type:** dimension                       |
| <div>Keyword Status</div>        | The status of the keyword<br /><br />**Field Name:** `KeywordStatus`<br />**Type:** dimension                                  |
| <div>Ad Group Criterion Id</div> | Ad group criterion identifier<br /><br />**Field Name:** `AdGroupCriterionId`<br />**Type:** dimension                         |

### Keywords

|                              |                                                                                                                  |
| ---------------------------- | ---------------------------------------------------------------------------------------------------------------- |
| <div>Keyword Labels</div>    | Labels applied to the keyword<br /><br />**Field Name:** `KeywordLabels`<br />**Type:** dimension                |
| <div>Bid Strategy Type</div> | The bid strategy type used for the keyword<br /><br />**Field Name:** `BidStrategyType`<br />**Type:** dimension |

### Conversion Goals

|                      |                                                                                                                                                                                             |
| -------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| <div>Goal</div>      | The name of the conversion goal you set up in Microsoft Advertising<br /><br />**Field Name:** `Goal`<br />**Type:** dimension                                                              |
| <div>Goal Type</div> | The type of conversion goal: AppInstall, Duration, Event, InStoreTransaction, OfflineConversion, PagesViewedPerVisit, or Url<br /><br />**Field Name:** `GoalType`<br />**Type:** dimension |

## Metrics

Metrics are the numerical values you can measure and analyze from your Bing Ads campaigns.

### Most Used

|                        |                                                                                                                               |
| ---------------------- | ----------------------------------------------------------------------------------------------------------------------------- |
| <div>Spend</div>       | Total amount spent on your ads<br /><br />**Field Name:** `Spend`<br />**Type:** metric                                       |
| <div>Impressions</div> | Number of times your ads were shown<br /><br />**Field Name:** `Impressions`<br />**Type:** metric                            |
| <div>Clicks</div>      | Number of clicks on your ads<br /><br />**Field Name:** `Clicks`<br />**Type:** metric                                        |
| <div>CTR</div>         | Click-through Rate<br /><br />**Field Name:** `Ctr`<br />**Type:** metric                                                     |
| <div>CPC</div>         | The average cost per click (CPC)<br /><br />**Field Name:** `AverageCpc`<br />**Type:** metric                                |
| <div>CPM</div>         | The total advertising cost divided by the number of impressions<br /><br />**Field Name:** `AverageCpm`<br />**Type:** metric |

### Conversions

|                                               |                                                                                                                                 |
| --------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------- |
| <div>Conversions</div>                        | Primary conversion of your campaign<br /><br />**Field Name:** `Conversions`<br />**Type:** metric                              |
| <div>All Conversions</div>                    | Total number of all conversions<br /><br />**Field Name:** `AllConversions`<br />**Type:** metric                               |
| <div>Conversion Rate</div>                    | <br /><br />**Field Name:** `ConversionRate`<br />**Type:** metric                                                              |
| <div>Cost per Conversion</div>                | <br /><br />**Field Name:** `CostPerConversion`<br />**Type:** metric                                                           |
| <div>Purchases</div>                          | Number of purchases<br /><br />**Field Name:** `Purchases`<br />**Type:** metric                                                |
| <div>Sales</div>                              | Number of sales<br /><br />**Field Name:** `Sales`<br />**Type:** metric                                                        |
| <div>Assists</div>                            | Number of conversions your ads assisted<br /><br />**Field Name:** `Assists`<br />**Type:** metric                              |
| <div>Subscriptions</div>                      | Number of subscriptions<br /><br />**Field Name:** `Subscriptions`<br />**Type:** metric                                        |
| <div>All Conversion Rate</div>                | Conversion rate for all conversions<br /><br />**Field Name:** `AllConversionRate`<br />**Type:** metric                        |
| <div>View Through Conversions</div>           | Number of conversions from view-through interactions<br /><br />**Field Name:** `ViewThroughConversions`<br />**Type:** metric  |
| <div>View Through Conversions Qualified</div> | Number of qualified view-through conversions<br /><br />**Field Name:** `ViewThroughConversionsQualified`<br />**Type:** metric |
| <div>View Through Rate</div>                  | Rate of view-through conversions<br /><br />**Field Name:** `ViewThroughRate`<br />**Type:** metric                             |
| <div>All Conversions Qualified</div>          | Total number of qualified conversions<br /><br />**Field Name:** `AllConversionsQualified`<br />**Type:** metric                |
| <div>All Cost Per Conversion</div>            | Average cost per all conversions<br /><br />**Field Name:** `AllCostPerConversion`<br />**Type:** metric                        |

### Revenue

|                                       |                                                                                                                |
| ------------------------------------- | -------------------------------------------------------------------------------------------------------------- |
| <div>Revenue</div>                    | Total revenue generated<br /><br />**Field Name:** `Revenue`<br />**Type:** metric                             |
| <div>ROAS</div>                       | Return on ad spend for conversions<br /><br />**Field Name:** `ReturnOnAdSpend`<br />**Type:** metric          |
| <div>All Return On Ad Spend</div>     | Return on ad spend for all conversions<br /><br />**Field Name:** `AllReturnOnAdSpend`<br />**Type:** metric   |
| <div>All Revenue</div>                | Total revenue from all conversions<br /><br />**Field Name:** `AllRevenue`<br />**Type:** metric               |
| <div>All Revenue Per Conversion</div> | Average revenue per all conversions<br /><br />**Field Name:** `AllRevenuePerConversion`<br />**Type:** metric |
| <div>View Through Revenue</div>       | Revenue from view-through conversions<br /><br />**Field Name:** `ViewThroughRevenue`<br />**Type:** metric    |
| <div>Revenue Per Assist</div>         | Average revenue per assist<br /><br />**Field Name:** `RevenuePerAssist`<br />**Type:** metric                 |
| <div>Revenue Per Conversion</div>     | Average revenue per conversion<br /><br />**Field Name:** `RevenuePerConversion`<br />**Type:** metric         |
| <div>Revenue Per Install</div>        | Average revenue per install<br /><br />**Field Name:** `RevenuePerInstall`<br />**Type:** metric               |
| <div>Revenue Per Sale</div>           | Average revenue per sale<br /><br />**Field Name:** `RevenuePerSale`<br />**Type:** metric                     |

### CTR

|                                     |                                                                                                                 |
| ----------------------------------- | --------------------------------------------------------------------------------------------------------------- |
| <div>Expected CTR</div>             | Expected click-through rate<br /><br />**Field Name:** `ExpectedCtr`<br />**Type:** metric                      |
| <div>Quality Score</div>            | Quality score of the ad<br /><br />**Field Name:** `QualityScore`<br />**Type:** metric                         |
| <div>Historical Expected CTR</div>  | Historical expected click-through rate<br /><br />**Field Name:** `HistoricalExpectedCtr`<br />**Type:** metric |
| <div>Historical Quality Score</div> | Historical quality score of the ad<br /><br />**Field Name:** `HistoricalQualityScore`<br />**Type:** metric    |
| <div>Historical Ad Relevance</div>  | Historical ad relevance score<br /><br />**Field Name:** `HistoricalAdRelevance`<br />**Type:** metric          |

### Call Tracking

|                              |                                                                                                      |
| ---------------------------- | ---------------------------------------------------------------------------------------------------- |
| <div>Phone Calls</div>       | Number of phone calls<br /><br />**Field Name:** `PhoneCalls`<br />**Type:** metric                  |
| <div>Phone Impressions</div> | Number of phone call impressions<br /><br />**Field Name:** `PhoneImpressions`<br />**Type:** metric |
| <div>PTR</div>               | Phone-through rate<br /><br />**Field Name:** `Ptr`<br />**Type:** metric                            |

### Impression Share

|                                                 |                                                                                                                                                                |
| ----------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| <div>Impressions Lost to Budget</div>           | <br /><br />**Field Name:** `ImpressionLostToBudgetPercent`<br />**Type:** metric                                                                              |
| <div>Impressions Lost to Rank</div>             | <br /><br />**Field Name:** `ImpressionLostToRankAggPercent`<br />**Type:** metric                                                                             |
| <div>Impressions Share</div>                    | <br /><br />**Field Name:** `ImpressionSharePercent`<br />**Type:** metric                                                                                     |
| <div>Top Impressions Share Lost to Budget</div> | <br /><br />**Field Name:** `TopImpressionShareLostToBudgetPercent`<br />**Type:** metric                                                                      |
| <div>Top Impression Share Lost to Rank</div>    | <br /><br />**Field Name:** `TopImpressionShareLostToRankPercent`<br />**Type:** metric                                                                        |
| <div>Top Impressions Share</div>                | <br /><br />**Field Name:** `TopImpressionSharePercent`<br />**Type:** metric                                                                                  |
| <div>Absolute Top Impression Rate</div>         | How often your ad was in the first position as a percentage of impressions<br /><br />**Field Name:** `AbsoluteTopImpressionRatePercent`<br />**Type:** metric |
| <div>Top Impression Rate</div>                  | How often your ad was in the mainline (top placement above search results)<br /><br />**Field Name:** `TopImpressionRatePercent`<br />**Type:** metric         |

### Video

|                                              |                                                                                                                                   |
| -------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------- |
| <div>CPV</div>                               | Average total spend divided by video views<br /><br />**Field Name:** `AverageCPV`<br />**Type:** metric                          |
| <div>Video Views</div>                       | Number of times your video ads were viewed<br /><br />**Field Name:** `VideoViews`<br />**Type:** metric                          |
| <div>Video Views at 25%</div>                | Number of times your video ads were viewed at least 25%<br /><br />**Field Name:** `VideoViewsAt25Percent`<br />**Type:** metric  |
| <div>Video Views at 50%</div>                | Number of times your video ads were viewed at least 50%<br /><br />**Field Name:** `VideoViewsAt50Percent`<br />**Type:** metric  |
| <div>Video Views at 75%</div>                | Number of times your video ads were viewed at least 75%<br /><br />**Field Name:** `VideoViewsAt75Percent`<br />**Type:** metric  |
| <div>Video Completion Rate</div>             | Percentage of video views that were completed<br /><br />**Field Name:** `VideoCompletionRate`<br />**Type:** metric              |
| <div>Average Watch Time Per Impression</div> | Average time spent watching video per impression<br /><br />**Field Name:** `AverageWatchTimePerImpression`<br />**Type:** metric |
| <div>Average Watch Time Per Video View</div> | Average time spent watching video per view<br /><br />**Field Name:** `AverageWatchTimePerVideoView`<br />**Type:** metric        |

### New Customers

|                                         |                                                                                                                    |
| --------------------------------------- | ------------------------------------------------------------------------------------------------------------------ |
| <div>New Customer CPA</div>             | Cost per acquisition for new customers<br /><br />**Field Name:** `NewCustomerCPA`<br />**Type:** metric           |
| <div>New Customer Conversion Rate</div> | Conversion rate for new customers<br /><br />**Field Name:** `NewCustomerConversionRate`<br />**Type:** metric     |
| <div>New Customer Conversions</div>     | Number of conversions from new customers<br /><br />**Field Name:** `NewCustomerConversions`<br />**Type:** metric |
| <div>New Customer ROAS</div>            | Return on ad spend for new customers<br /><br />**Field Name:** `NewCustomerReturnOnAdSpend`<br />**Type:** metric |
| <div>New Customer Revenue</div>         | Revenue from new customers<br /><br />**Field Name:** `NewCustomerRevenue`<br />**Type:** metric                   |

### App

|                                           |                                                                                                                       |
| ----------------------------------------- | --------------------------------------------------------------------------------------------------------------------- |
| <div>Installs</div>                       | Number of app installs<br /><br />**Field Name:** `Installs`<br />**Type:** metric                                    |
| <div>App Installs</div>                   | Number of app installations<br /><br />**Field Name:** `AppInstalls`<br />**Type:** metric                            |
| <div>Downloads</div>                      | Number of app downloads<br /><br />**Field Name:** `Downloads`<br />**Type:** metric                                  |
| <div>Post Click Download Rate</div>       | Rate of downloads after clicking<br /><br />**Field Name:** `PostClickDownloadRate`<br />**Type:** metric             |
| <div>Post Click Install Rate</div>        | Rate of installs after clicking<br /><br />**Field Name:** `PostClickInstallRate`<br />**Type:** metric               |
| <div>Post Install Purchase Rate</div>     | Rate of purchases after installing<br /><br />**Field Name:** `PostInstallPurchaseRate`<br />**Type:** metric         |
| <div>Post Install Subscription Rate</div> | Rate of subscriptions after installing<br /><br />**Field Name:** `PostInstallSubscriptionRate`<br />**Type:** metric |
| <div>Cost Per Download</div>              | Average cost per download<br /><br />**Field Name:** `CostPerDownload`<br />**Type:** metric                          |
| <div>Cost Per Install</div>               | Average cost per install<br /><br />**Field Name:** `CostPerInstall`<br />**Type:** metric                            |

### Low Quality Traffic

|                                              |                                                                                                                                           |
| -------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------- |
| <div>Low Quality Clicks</div>                | Number of low quality clicks<br /><br />**Field Name:** `LowQualityClicks`<br />**Type:** metric                                          |
| <div>Low Quality Clicks Percent</div>        | Percentage of low quality clicks<br /><br />**Field Name:** `LowQualityClicksPercent`<br />**Type:** metric                               |
| <div>Low Quality Conversion Rate</div>       | Conversion rate for low quality clicks<br /><br />**Field Name:** `LowQualityConversionRate`<br />**Type:** metric                        |
| <div>Low Quality Conversions</div>           | Number of conversions from low quality clicks<br /><br />**Field Name:** `LowQualityConversions`<br />**Type:** metric                    |
| <div>Low Quality Conversions Qualified</div> | Number of qualified conversions from low quality clicks<br /><br />**Field Name:** `LowQualityConversionsQualified`<br />**Type:** metric |
| <div>Low Quality General Clicks</div>        | Number of low quality general clicks<br /><br />**Field Name:** `LowQualityGeneralClicks`<br />**Type:** metric                           |
| <div>Low Quality Impressions</div>           | Number of low quality impressions<br /><br />**Field Name:** `LowQualityImpressions`<br />**Type:** metric                                |
| <div>Low Quality Impressions Percent</div>   | Percentage of low quality impressions<br /><br />**Field Name:** `LowQualityImpressionsPercent`<br />**Type:** metric                     |
| <div>Low Quality Sophisticated Clicks</div>  | Number of low quality sophisticated clicks<br /><br />**Field Name:** `LowQualitySophisticatedClicks`<br />**Type:** metric               |

### Position

|                             |                                                                                                                |
| --------------------------- | -------------------------------------------------------------------------------------------------------------- |
| <div>Average Position</div> | The average position of the ad on a webpage<br /><br />**Field Name:** `AveragePosition`<br />**Type:** metric |

### Keywords

|                                    |                                                                                                                        |
| ---------------------------------- | ---------------------------------------------------------------------------------------------------------------------- |
| <div>Current Max CPC</div>         | The current maximum CPC bid for the keyword<br /><br />**Field Name:** `CurrentMaxCpc`<br />**Type:** metric           |
| <div>First Page Bid</div>          | The estimated bid required for first page placement<br /><br />**Field Name:** `FirstPageBid`<br />**Type:** metric    |
| <div>Mainline Bid</div>            | The estimated bid required for mainline placement<br /><br />**Field Name:** `MainlineBid`<br />**Type:** metric       |
| <div>Mainline 1 Bid</div>          | The estimated bid required for first mainline position<br /><br />**Field Name:** `Mainline1Bid`<br />**Type:** metric |
| <div>Quality Impact</div>          | The impact of quality score on ad performance<br /><br />**Field Name:** `QualityImpact`<br />**Type:** metric         |
| <div>Ad Relevance</div>            | How closely related your ad is to the keyword<br /><br />**Field Name:** `AdRelevance`<br />**Type:** metric           |
| <div>Landing Page Experience</div> | The quality of your landing page experience<br /><br />**Field Name:** `LandingPageExperience`<br />**Type:** metric   |

***

## Related

<CardGroup>
  <Card title="Fields Catalog" icon="book" href="/fields-catalog">
    Browse all platforms
  </Card>

  <Card title="Google Ads Fields" icon="chart-bar" href="/data-source/google-ads/fields">
    Google Ads metrics & dimensions
  </Card>

  <Card title="Meta Ads Fields" icon="chart-bar" href="/data-source/facebook-ads/fields">
    Meta Ads metrics & dimensions
  </Card>

  <Card title="TikTok Ads Fields" icon="chart-bar" href="/data-source/tiktok-ads/fields">
    TikTok Ads metrics & dimensions
  </Card>
</CardGroup>


# Bing Webmaster Tools Metrics & Dimensions
Source: https://support.detrics.io/data-source/bing-webmaster-tools/fields

Complete reference for Bing Webmaster Tools dimensions and metrics

<Info>
  **Last updated:** August 6, 2026
</Info>

<div>
  <div>
    16 dimensions
  </div>

  <div>
    22 metrics
  </div>
</div>

This reference covers all available dimensions and metrics for Bing Webmaster Tools data through Detrics. Use this guide to understand what data you can extract and how to structure your queries.

<div>
  <span>Supported destinations:</span>

  <div>
    Google Sheets
  </div>

  <div>
    Claude
  </div>

  <div>
    BigQuery
  </div>
</div>

## Dimensions

Dimensions are the attributes you can use to segment and group your Bing Webmaster Tools data.

### Most Used

|                     |                                                                                                                                                                                           |
| ------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| <div>Site URL</div> | The verified site (property) the data belongs to.<br /><br />**Field Name:** `SITE_URL`<br />**Type:** dimension                                                                          |
| <div>Query</div>    | The search query that surfaced your site on Bing. Selecting this returns the top queries report.<br /><br />**Field Name:** `QUERY`<br />**Type:** dimension                              |
| <div>Page</div>     | The page URL that appeared in Bing search results. Selecting this returns the top pages report. Cannot be combined with Query.<br /><br />**Field Name:** `PAGE`<br />**Type:** dimension |

### Crawl Issues

|                            |                                                                                                                                                                     |
| -------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| <div>Issue URL</div>       | URL where Bing discovered a crawl issue. Returns the crawl issues report.<br /><br />**Field Name:** `ISSUE_URL`<br />**Type:** dimension                           |
| <div>Issue Type</div>      | Type of issue Bing found while crawling the URL (e.g. blocked by robots.txt, HTTP error, malware).<br /><br />**Field Name:** `ISSUE_TYPE`<br />**Type:** dimension |
| <div>Issue HTTP Code</div> | The last HTTP status code Bing received when crawling the URL.<br /><br />**Field Name:** `ISSUE_HTTP_CODE`<br />**Type:** dimension                                |

### Sitemaps

|                              |                                                                                                                                                        |
| ---------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------ |
| <div>Feed URL</div>          | URL of a submitted sitemap or feed. Returns the sitemaps report.<br /><br />**Field Name:** `FEED_URL`<br />**Type:** dimension                        |
| <div>Feed Type</div>         | The feed format — Sitemap, Sitemap Index, Atom, RSS, Text, etc.<br /><br />**Field Name:** `FEED_TYPE`<br />**Type:** dimension                        |
| <div>Feed Status</div>       | Current processing status of the sitemap/feed in Bing.<br /><br />**Field Name:** `FEED_STATUS`<br />**Type:** dimension                               |
| <div>Compressed</div>        | Whether the submitted sitemap/feed is compressed (Yes/No).<br /><br />**Field Name:** `FEED_COMPRESSED`<br />**Type:** dimension                       |
| <div>Submitted Date</div>    | Date the sitemap/feed was last submitted to Bing (blank if never submitted).<br /><br />**Field Name:** `FEED_SUBMITTED_DATE`<br />**Type:** dimension |
| <div>Last Crawled Date</div> | Date Bing last crawled the sitemap/feed.<br /><br />**Field Name:** `FEED_LAST_CRAWLED_DATE`<br />**Type:** dimension                                  |

### Blocked URLs

|                         |                                                                                                                                                   |
| ----------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------- |
| <div>Blocked URL</div>  | A URL or directory blocked from Bing’s index. Returns the blocked URLs report.<br /><br />**Field Name:** `BLOCKED_URL`<br />**Type:** dimension  |
| <div>Entity Type</div>  | Whether the block applies to a single page or a directory.<br /><br />**Field Name:** `BLOCKED_ENTITY_TYPE`<br />**Type:** dimension              |
| <div>Request Type</div> | The kind of block requested (e.g. cache-only removal or a full block).<br /><br />**Field Name:** `BLOCKED_REQUEST_TYPE`<br />**Type:** dimension |
| <div>Blocked Date</div> | Date the URL was blocked.<br /><br />**Field Name:** `BLOCKED_DATE`<br />**Type:** dimension                                                      |

## Metrics

Metrics are the numerical values you can measure and analyze from your Bing Webmaster Tools campaigns.

### Most Used

|                                    |                                                                                                                                                                                                                                    |
| ---------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| <div>Impressions</div>             | Number of times a link to your site appeared in Bing search results.<br /><br />**Field Name:** `impressions`<br />**Type:** metric                                                                                                |
| <div>Clicks</div>                  | Number of times a link to your site was clicked from Bing search results.<br /><br />**Field Name:** `clicks`<br />**Type:** metric                                                                                                |
| <div>Avg Impression Position</div> | Impression-weighted average position of your site in Bing results. Only available with the Query or Page dimension.<br /><br />**Field Name:** `avgImpressionPosition`<br />**Type:** metric                                       |
| <div>Avg Click Position</div>      | Click-weighted average position of your clicked results. Only available with the Query or Page dimension. Bing frequently leaves this unpopulated (returns 0).<br /><br />**Field Name:** `avgClickPosition`<br />**Type:** metric |

### Crawl Stats

|                                  |                                                                                                                                                                              |
| -------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| <div>Crawled Pages</div>         | Number of pages Bing crawled. Returns the crawl stats report (daily time-series).<br /><br />**Field Name:** `crawledPages`<br />**Type:** metric                            |
| <div>Pages In Index</div>        | Total number of your pages stored in Bing’s index (running total — shows the latest value over the range).<br /><br />**Field Name:** `pagesInIndex`<br />**Type:** metric   |
| <div>Inbound Links</div>         | Total number of inbound links pointing to your site (running total — shows the latest value over the range).<br /><br />**Field Name:** `inboundLinks`<br />**Type:** metric |
| <div>Crawl Errors</div>          | Number of errors encountered while crawling.<br /><br />**Field Name:** `crawlErrors`<br />**Type:** metric                                                                  |
| <div>HTTP 2xx</div>              | Number of crawled pages that returned an HTTP 2xx status.<br /><br />**Field Name:** `httpCode2xx`<br />**Type:** metric                                                     |
| <div>HTTP 301</div>              | Number of pages returning HTTP 301 (moved permanently).<br /><br />**Field Name:** `httpCode301`<br />**Type:** metric                                                       |
| <div>HTTP 302</div>              | Number of pages returning HTTP 302 (moved temporarily).<br /><br />**Field Name:** `httpCode302`<br />**Type:** metric                                                       |
| <div>HTTP 4xx</div>              | Number of crawled pages that returned an HTTP 4xx status.<br /><br />**Field Name:** `httpCode4xx`<br />**Type:** metric                                                     |
| <div>HTTP 5xx</div>              | Number of crawled pages that returned an HTTP 5xx status.<br /><br />**Field Name:** `httpCode5xx`<br />**Type:** metric                                                     |
| <div>Other HTTP Codes</div>      | Number of crawled pages returning any other HTTP status code.<br /><br />**Field Name:** `httpCodeOther`<br />**Type:** metric                                               |
| <div>Blocked By Robots.txt</div> | Number of pages Bing was blocked from crawling by robots.txt.<br /><br />**Field Name:** `blockedByRobotsTxt`<br />**Type:** metric                                          |
| <div>Pages With Malware</div>    | Number of crawled pages flagged as containing malware.<br /><br />**Field Name:** `pagesWithMalware`<br />**Type:** metric                                                   |
| <div>Connection Timeouts</div>   | Number of pages where the crawl request timed out.<br /><br />**Field Name:** `connectionTimeouts`<br />**Type:** metric                                                     |
| <div>DNS Failures</div>          | Number of pages that failed to crawl due to a DNS failure.<br /><br />**Field Name:** `dnsFailures`<br />**Type:** metric                                                    |

### Crawl Issues

|                          |                                                                                                                                   |
| ------------------------ | --------------------------------------------------------------------------------------------------------------------------------- |
| <div>Inbound Links</div> | Number of inbound links to the URL that has the crawl issue.<br /><br />**Field Name:** `issueInboundLinks`<br />**Type:** metric |

### Sitemaps

|                              |                                                                                                                                         |
| ---------------------------- | --------------------------------------------------------------------------------------------------------------------------------------- |
| <div>File Size (bytes)</div> | Size of the submitted sitemap/feed file, in bytes.<br /><br />**Field Name:** `feedFileSize`<br />**Type:** metric                      |
| <div>URL Count</div>         | Number of URLs contained in the sitemap (or sitemaps in an index file).<br /><br />**Field Name:** `feedUrlCount`<br />**Type:** metric |

### Blocked URLs

|                              |                                                                                                                                                                       |
| ---------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| <div>Blocked URL Count</div> | Number of blocked URLs, counted per the selected dimension (e.g. by entity type or request type).<br /><br />**Field Name:** `blockedUrlsCount`<br />**Type:** metric |

***

## Related

<CardGroup>
  <Card title="Fields Catalog" icon="book" href="/fields-catalog">
    Browse all platforms
  </Card>

  <Card title="Google Search Console Fields" icon="chart-bar" href="/data-source/google-search-console/fields">
    Google Search Console metrics & dimensions
  </Card>

  <Card title="Google Analytics 4 Fields" icon="chart-bar" href="/data-source/google-analytics-4/fields">
    Google Analytics 4 metrics & dimensions
  </Card>

  <Card title="Bing Ads Fields" icon="chart-bar" href="/data-source/bing-ads/fields">
    Bing Ads metrics & dimensions
  </Card>
</CardGroup>


# Criteo Ads Metrics & Dimensions
Source: https://support.detrics.io/data-source/criteo-ads/fields

Complete reference for Criteo Ads dimensions and metrics

<Info>
  **Last updated:** August 7, 2026
</Info>

<div>
  <div>
    38 dimensions
  </div>

  <div>
    58 metrics
  </div>
</div>

This reference covers all available dimensions and metrics for Criteo Ads data through Detrics. Use this guide to understand what data you can extract and how to structure your queries.

<div>
  <span>Supported destinations:</span>

  <div>
    Google Sheets
  </div>

  <div>
    Claude
  </div>

  <div>
    BigQuery
  </div>
</div>

## Dimensions

Dimensions are the attributes you can use to segment and group your Criteo Ads data.

### Most Used

|                            |                                                                                                                     |
| -------------------------- | ------------------------------------------------------------------------------------------------------------------- |
| <div>Advertiser ID</div>   | Numeric Criteo advertiser identifier.<br /><br />**Field Name:** `advertiserId`<br />**Type:** dimension            |
| <div>Advertiser Name</div> | Display name of the Criteo advertiser account.<br /><br />**Field Name:** `advertiserName`<br />**Type:** dimension |
| <div>Campaign ID</div>     | Numeric Criteo campaign identifier.<br /><br />**Field Name:** `campaignId`<br />**Type:** dimension                |
| <div>Campaign Name</div>   | Display name of the campaign.<br /><br />**Field Name:** `campaignName`<br />**Type:** dimension                    |
| <div>Ad Set ID</div>       | Numeric Criteo ad set identifier.<br /><br />**Field Name:** `adsetId`<br />**Type:** dimension                     |
| <div>Ad Set Name</div>     | Display name of the ad set.<br /><br />**Field Name:** `adsetName`<br />**Type:** dimension                         |
| <div>Ad ID</div>           | Numeric Criteo ad identifier.<br /><br />**Field Name:** `adId`<br />**Type:** dimension                            |
| <div>Ad Name</div>         | Display name of the ad.<br /><br />**Field Name:** `adName`<br />**Type:** dimension                                |

### Attribution

|                                |                                                                                                                                                           |
| ------------------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------- |
| <div>Device</div>              | Device the impression/click was served on (Desktop, Mobile, Tablet, Other).<br /><br />**Field Name:** `device`<br />**Type:** dimension                  |
| <div>OS</div>                  | Operating system (Android, iOS, Windows, macOS, Other).<br /><br />**Field Name:** `os`<br />**Type:** dimension                                          |
| <div>Channel</div>             | Overarching channel (Display, Social, Retail Media, etc.). See Ad Channel for finer detail.<br /><br />**Field Name:** `channel`<br />**Type:** dimension |
| <div>Ad Channel</div>          | Fine-grained channel — e.g. WebDisplay, InAppDisplay, Facebook, Instagram, Pinterest.<br /><br />**Field Name:** `adChannel`<br />**Type:** dimension     |
| <div>Social Platform</div>     | Social platform the impression was served on (Facebook, Instagram, Pinterest).<br /><br />**Field Name:** `socialPlatform`<br />**Type:** dimension       |
| <div>Marketing Objective</div> | High-level marketing objective (Consideration, Conversion, etc.).<br /><br />**Field Name:** `marketingObjective`<br />**Type:** dimension                |
| <div>Goal</div>                | Specific optimization goal configured on the campaign.<br /><br />**Field Name:** `goal`<br />**Type:** dimension                                         |

### Product Feed

|                          |                                                                                                                         |
| ------------------------ | ----------------------------------------------------------------------------------------------------------------------- |
| <div>Category ID</div>   | Criteo product-catalog category identifier.<br /><br />**Field Name:** `categoryId`<br />**Type:** dimension            |
| <div>Category Name</div> | Human-readable name of the product-catalog category.<br /><br />**Field Name:** `categoryName`<br />**Type:** dimension |
| <div>Coupon ID</div>     | Numeric identifier for the coupon (creative overlay).<br /><br />**Field Name:** `couponId`<br />**Type:** dimension    |
| <div>Coupon Name</div>   | Human-readable coupon name.<br /><br />**Field Name:** `couponName`<br />**Type:** dimension                            |

### Ad Set Settings

|                                       |                                                                                                                                                                                                        |
| ------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| <div>Ad Set Status</div>              | Ad set status (Active, Inactive, Deleted).<br /><br />**Field Name:** `adsetStatus`<br />**Type:** dimension                                                                                           |
| <div>Ad Set Delivery Status</div>     | Current delivery state (Delivering, NotDelivering, DraftUnknown).<br /><br />**Field Name:** `adsetDeliveryStatus`<br />**Type:** dimension                                                            |
| <div>Ad Set Start Date</div>          | Configured start date of the ad set.<br /><br />**Field Name:** `adsetStartDate`<br />**Type:** dimension                                                                                              |
| <div>Ad Set End Date</div>            | Configured end date of the ad set (empty if open-ended).<br /><br />**Field Name:** `adsetEndDate`<br />**Type:** dimension                                                                            |
| <div>Ad Set Objective</div>           | The optimization objective configured on the ad set.<br /><br />**Field Name:** `adsetObjective`<br />**Type:** dimension                                                                              |
| <div>Ad Set Media Type</div>          | Media type (Display, Video, etc.).<br /><br />**Field Name:** `adsetMediaType`<br />**Type:** dimension                                                                                                |
| <div>Currency</div>                   | ISO currency code the advertiser account is billed in.<br /><br />**Field Name:** `accountCurrency`<br />**Type:** dimension                                                                           |
| <div>Ad Set Bid Type</div>            | Bidding strategy configured on the ad set (Manual, TargetCPO, TargetROAS, etc.).<br /><br />**Field Name:** `adsetBidStrategy`<br />**Type:** dimension                                                |
| <div>Budget Strategy</div>            | Budget cap type (Capped or Uncapped).<br /><br />**Field Name:** `budgetStrategy`<br />**Type:** dimension                                                                                             |
| <div>Budget Renewal</div>             | How often the budget resets (Daily, Weekly, Monthly, Lifetime).<br /><br />**Field Name:** `budgetRenewal`<br />**Type:** dimension                                                                    |
| <div>Budget Delivery Smoothing</div>  | Smoothing mode (AsFastAsPossible, Smooth) controlling pacing across the day/period.<br /><br />**Field Name:** `budgetDeliverySmoothing`<br />**Type:** dimension                                      |
| <div>Budget Delivery Week</div>       | Delivery-week configuration for weekly budgets.<br /><br />**Field Name:** `budgetDeliveryWeek`<br />**Type:** dimension                                                                               |
| <div>Targeted Environments</div>      | Environments (Web, InApp) the ad set is configured to serve on.<br /><br />**Field Name:** `targetedEnvironments`<br />**Type:** dimension                                                             |
| <div>Targeted Devices</div>           | Devices (Desktop, Mobile, Tablet, Other) targeted by the ad set.<br /><br />**Field Name:** `targetedDevices`<br />**Type:** dimension                                                                 |
| <div>Targeted Operating Systems</div> | Operating systems (Android, iOS, Windows, macOS) targeted by the ad set.<br /><br />**Field Name:** `targetedOperatingSystems`<br />**Type:** dimension                                                |
| <div>Targeted Countries</div>         | ISO country codes targeted by the ad set (semicolon-separated).<br /><br />**Field Name:** `targetedCountries`<br />**Type:** dimension                                                                |
| <div>Targeted Subdivisions</div>      | Sub-national regions (states, provinces) targeted by the ad set.<br /><br />**Field Name:** `targetedSubdivisions`<br />**Type:** dimension                                                            |
| <div>Targeted Zip Codes</div>         | Zip / postal codes targeted by the ad set.<br /><br />**Field Name:** `targetedZipCodes`<br />**Type:** dimension                                                                                      |
| <div>Frequency Cap Period</div>       | Frequency-cap period (Daily, Weekly, Monthly, Lifetime, Advanced). "Advanced" custom rules return -1 for Maximum Impressions.<br /><br />**Field Name:** `frequencyCapPeriod`<br />**Type:** dimension |

## Metrics

Metrics are the numerical values you can measure and analyze from your Criteo Ads campaigns.

### Volume

|                                    |                                                                                                                                              |
| ---------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------- |
| <div>Impressions</div>             | Total impressions (Criteo "Displays") delivered.<br /><br />**Field Name:** `impressions`<br />**Type:** metric                              |
| <div>Clicks</div>                  | Total clicks recorded on Criteo ads.<br /><br />**Field Name:** `clicks`<br />**Type:** metric                                               |
| <div>Exposed Users</div>           | Unique users that saw at least one impression.<br /><br />**Field Name:** `exposedUsers`<br />**Type:** metric                               |
| <div>Audience</div>                | Total addressable audience size for the ad set.<br /><br />**Field Name:** `audience`<br />**Type:** metric                                  |
| <div>Reach</div>                   | Share of the audience that saw at least one impression (0–100 %).<br /><br />**Field Name:** `reach`<br />**Type:** metric                   |
| <div>Frequency</div>               | Average number of impressions per exposed user.<br /><br />**Field Name:** `frequency`<br />**Type:** metric                                 |
| <div>Potential Displays</div>      | Number of display opportunities Criteo could have won.<br /><br />**Field Name:** `potentialDisplays`<br />**Type:** metric                  |
| <div>Overall Competition Win</div> | Share of display auctions Criteo won across all channels (0–100 %).<br /><br />**Field Name:** `overallCompetitionWin`<br />**Type:** metric |

### Cost & Efficiency

|                                     |                                                                                                                                          |
| ----------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------- |
| <div>Cost</div>                     | Total advertiser cost in the advertiser's own currency.<br /><br />**Field Name:** `cost`<br />**Type:** metric                          |
| <div>CPC</div>                      | Cost per click (Cost / Clicks).<br /><br />**Field Name:** `cpc`<br />**Type:** metric                                                   |
| <div>eCPC</div>                     | Effective cost per click as computed by Criteo.<br /><br />**Field Name:** `ecpc`<br />**Type:** metric                                  |
| <div>eCPM</div>                     | Effective cost per 1,000 impressions.<br /><br />**Field Name:** `ecpm`<br />**Type:** metric                                            |
| <div>CTR</div>                      | Click-through rate (Clicks / Impressions) as a percentage.<br /><br />**Field Name:** `ctr`<br />**Type:** metric                        |
| <div>Cost of Sale (COS)</div>       | Cost / Revenue as a percentage.<br /><br />**Field Name:** `costOfSale`<br />**Type:** metric                                            |
| <div>Cost per Order (CPO)</div>     | Cost / Sales.<br /><br />**Field Name:** `costPerOrder`<br />**Type:** metric                                                            |
| <div>Advertiser Value</div>         | Custom advertiser value reported through Criteo's value optimization.<br /><br />**Field Name:** `advertiserValue`<br />**Type:** metric |
| <div>Cost of Advertiser Value</div> | Cost / Advertiser Value.<br /><br />**Field Name:** `costOfAdvertiserValue`<br />**Type:** metric                                        |

### Conversion

|                            |                                                                                                                                          |
| -------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------- |
| <div>Sales</div>           | Total sales attributed under the advertiser's configured attribution rules.<br /><br />**Field Name:** `sales`<br />**Type:** metric     |
| <div>Revenue</div>         | Total revenue attributed under the advertiser's configured attribution rules.<br /><br />**Field Name:** `revenue`<br />**Type:** metric |
| <div>ROAS</div>            | Return on ad spend (Revenue / Cost).<br /><br />**Field Name:** `roas`<br />**Type:** metric                                             |
| <div>Conversion Rate</div> | Sales / Clicks as a percentage.<br /><br />**Field Name:** `conversionRate`<br />**Type:** metric                                        |
| <div>Average Cart</div>    | Revenue / Sales.<br /><br />**Field Name:** `averageCart`<br />**Type:** metric                                                          |

### Visit Quality

|                                     |                                                                                                                                            |
| ----------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------ |
| <div>Visits</div>                   | Total site visits driven by Criteo clicks.<br /><br />**Field Name:** `visits`<br />**Type:** metric                                       |
| <div>Qualified Visits</div>         | Visits that met Criteo's "qualified" criteria (multi-page, non-bounce).<br /><br />**Field Name:** `qualifiedVisits`<br />**Type:** metric |
| <div>Cost per Visit</div>           | Cost / Visits.<br /><br />**Field Name:** `costPerVisit`<br />**Type:** metric                                                             |
| <div>Cost per Qualified Visit</div> | Cost / Qualified Visits.<br /><br />**Field Name:** `costPerQualifiedVisit`<br />**Type:** metric                                          |
| <div>Bounce Rate</div>              | Share of visits that bounced (0–100 %).<br /><br />**Field Name:** `bounceRate`<br />**Type:** metric                                      |

### Viewability

|                                  |                                                                                                                               |
| -------------------------------- | ----------------------------------------------------------------------------------------------------------------------------- |
| <div>Viewable Displays</div>     | Impressions counted as viewable per MRC standards.<br /><br />**Field Name:** `viewableDisplays`<br />**Type:** metric        |
| <div>Non-Viewable Displays</div> | Impressions counted as non-viewable per MRC standards.<br /><br />**Field Name:** `nonViewableDisplays`<br />**Type:** metric |
| <div>Untrackable Displays</div>  | Impressions where viewability could not be measured.<br /><br />**Field Name:** `untrackableDisplays`<br />**Type:** metric   |
| <div>Invalid Displays</div>      | Impressions filtered out as invalid traffic.<br /><br />**Field Name:** `invalidDisplays`<br />**Type:** metric               |
| <div>Invalid Clicks</div>        | Clicks filtered out as invalid traffic.<br /><br />**Field Name:** `invalidClicks`<br />**Type:** metric                      |

### App

|                                         |                                                                                                                                 |
| --------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------- |
| <div>App Installs</div>                 | Post-click app installs attributed to Criteo.<br /><br />**Field Name:** `appInstalls`<br />**Type:** metric                    |
| <div>Cost per Install</div>             | Cost / App Installs.<br /><br />**Field Name:** `costPerInstall`<br />**Type:** metric                                          |
| <div>Install Rate</div>                 | App Installs / Clicks as a percentage.<br /><br />**Field Name:** `installRate`<br />**Type:** metric                           |
| <div>Post-Install Sales</div>           | Sales attributed to post-install actions in the app.<br /><br />**Field Name:** `postInstallSales`<br />**Type:** metric        |
| <div>Post-Install Order Value</div>     | Revenue from post-install actions in the app.<br /><br />**Field Name:** `postInstallOrderValue`<br />**Type:** metric          |
| <div>Post-Install Conversion Rate</div> | Post-Install Sales / App Installs as a percentage.<br /><br />**Field Name:** `postInstallConversionRate`<br />**Type:** metric |
| <div>Post-Install Cost of Sale</div>    | Cost / Post-Install Order Value as a percentage.<br /><br />**Field Name:** `postInstallCostOfSale`<br />**Type:** metric       |
| <div>Post-Install Cost per Order</div>  | Cost / Post-Install Sales.<br /><br />**Field Name:** `postInstallCostPerOrder`<br />**Type:** metric                           |
| <div>Post-Install ROAS</div>            | Post-Install Order Value / Cost.<br /><br />**Field Name:** `postInstallRoas`<br />**Type:** metric                             |

### Omnichannel

|                                |                                                                                                                            |
| ------------------------------ | -------------------------------------------------------------------------------------------------------------------------- |
| <div>Omnichannel Sales</div>   | Sales blended across online + offline touchpoints.<br /><br />**Field Name:** `omnichannelSales`<br />**Type:** metric     |
| <div>Omnichannel Revenue</div> | Revenue blended across online + offline touchpoints.<br /><br />**Field Name:** `omnichannelRevenue`<br />**Type:** metric |
| <div>Omnichannel ROAS</div>    | Omnichannel Revenue / Cost.<br /><br />**Field Name:** `omnichannelRoas`<br />**Type:** metric                             |

### Video

|                                    |                                                                                                                                                          |
| ---------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------- |
| <div>Video Started</div>           | Video plays that started.<br /><br />**Field Name:** `videoStarted`<br />**Type:** metric                                                                |
| <div>Video First Quartile</div>    | Videos watched to at least 25 %.<br /><br />**Field Name:** `videoFirstQuartile`<br />**Type:** metric                                                   |
| <div>Video Midpoint</div>          | Videos watched to at least 50 %.<br /><br />**Field Name:** `videoMidpoint`<br />**Type:** metric                                                        |
| <div>Video Third Quartile</div>    | Videos watched to at least 75 %.<br /><br />**Field Name:** `videoThirdQuartile`<br />**Type:** metric                                                   |
| <div>Video Completed</div>         | Videos watched to completion.<br /><br />**Field Name:** `videoCompleted`<br />**Type:** metric                                                          |
| <div>Video AVOC</div>              | Audible & Visible on Completion — plays that were fully audible and viewable at completion.<br /><br />**Field Name:** `videoAvoc`<br />**Type:** metric |
| <div>Video Start Rate</div>        | Video Started / Impressions as a percentage.<br /><br />**Field Name:** `videoStartRate`<br />**Type:** metric                                           |
| <div>Video Completion Rate</div>   | Video Completed / Video Started as a percentage.<br /><br />**Field Name:** `videoCompletionRate`<br />**Type:** metric                                  |
| <div>Video Average View Rate</div> | Average watched share across all video starts (0–100 %).<br /><br />**Field Name:** `videoAverageViewRate`<br />**Type:** metric                         |
| <div>Video CPV</div>               | Cost per video view (Cost / Video Started).<br /><br />**Field Name:** `videoCpv`<br />**Type:** metric                                                  |
| <div>Video CPCV</div>              | Cost per completed video view (Cost / Video Completed).<br /><br />**Field Name:** `videoCpcv`<br />**Type:** metric                                     |

### Ad Set Settings

|                                |                                                                                                                                                                        |
| ------------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| <div>Ad Set Bid Value</div>    | Configured bid value for the ad set (in advertiser currency).<br /><br />**Field Name:** `adsetBidValue`<br />**Type:** metric                                         |
| <div>Budget Amount</div>       | Configured budget amount (in advertiser currency).<br /><br />**Field Name:** `budgetAmount`<br />**Type:** metric                                                     |
| <div>Maximum Impressions</div> | Frequency cap value. Returns -1 when Frequency Cap Period is "Advanced" (custom multi-rule cap).<br /><br />**Field Name:** `maximumImpressions`<br />**Type:** metric |

***

## Related

<CardGroup>
  <Card title="Fields Catalog" icon="book" href="/fields-catalog">
    Browse all platforms
  </Card>

  <Card title="Meta Ads Fields" icon="chart-bar" href="/data-source/facebook-ads/fields">
    Meta Ads metrics & dimensions
  </Card>

  <Card title="Google Ads Fields" icon="chart-bar" href="/data-source/google-ads/fields">
    Google Ads metrics & dimensions
  </Card>

  <Card title="TikTok Ads Fields" icon="chart-bar" href="/data-source/tiktok-ads/fields">
    TikTok Ads metrics & dimensions
  </Card>
</CardGroup>


# Meta Ads Metrics & Dimensions
Source: https://support.detrics.io/data-source/facebook-ads/fields

Complete reference for Meta Ads (Facebook Ads) dimensions and metrics

<Info>
  **Last updated:** August 6, 2026
</Info>

<div>
  <div>
    125 dimensions
  </div>

  <div>
    247 metrics
  </div>
</div>

This reference covers all available dimensions and metrics for Meta Ads data through Detrics. Use this guide to understand what data you can extract and how to structure your queries.

<div>
  <span>Supported destinations:</span>

  <div>
    Google Sheets
  </div>

  <div>
    Looker Studio
  </div>

  <div>
    Claude
  </div>

  <div>
    BigQuery
  </div>
</div>

## Dimensions

Dimensions are the attributes you can use to segment and group your Meta Ads data.

### Most Used

|                              |                                                                                                                                                                                                                                                 |
| ---------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| <div>Account ID</div>        | The Unique Identifier for the Meta Ads Account.<br /><br />**Field Name:** `account_id`<br />**Type:** dimension                                                                                                                                |
| <div>Account Name</div>      | The name you see in the Ad's Manager for the ad accounts selected.<br /><br />**Field Name:** `account_name`<br />**Type:** dimension                                                                                                           |
| <div>Campaign ID</div>       | The Unique Identifiers for your Campaigns. You need to select this field to select dimensions from the 'Campaign' category.<br /><br />**Field Name:** `campaign_id`<br />**Type:** dimension                                                   |
| <div>Campaign Name</div>     | The name you see in the Ad Manager Campaigns report.<br /><br />**Field Name:** `campaign_name`<br />**Type:** dimension                                                                                                                        |
| <div>Ad Set ID</div>         | The Unique Identifiers for your Ad Sets. You need to select this field to select dimensions from the 'Ad Set' category.<br /><br />**Field Name:** `adset_id`<br />**Type:** dimension                                                          |
| <div>Ad Set Name</div>       | The name you see in the Ad Manager Ad Set level report.<br /><br />**Field Name:** `adset_name`<br />**Type:** dimension                                                                                                                        |
| <div>Ad ID</div>             | The Unique Identifiers for your Ads. You need to select this field to select dimensions from the 'Ad' category.<br /><br />**Field Name:** `ad_id`<br />**Type:** dimension                                                                     |
| <div>Ad Name</div>           | The name you see in the Ad Manager Ad level reports.<br /><br />**Field Name:** `ad_name`<br />**Type:** dimension                                                                                                                              |
| <div>Product ID & Name</div> | The product ID & Name of the associated products.<br /><br />**Field Name:** `product_id`<br />**Type:** dimension                                                                                                                              |
| <div>Result Name</div>       | The optimization goal for the ad set (e.g., landing page views, reach, video views). Only available at campaign level and below. Split to Columns to avoid spend duplication.<br /><br />**Field Name:** `result_name`<br />**Type:** dimension |

### Demographics

|                         |                                                                                                                                 |
| ----------------------- | ------------------------------------------------------------------------------------------------------------------------------- |
| <div>Country Code</div> | Breakdown dimension's metrics to the country level.<br /><br />**Field Name:** `country`<br />**Type:** dimension               |
| <div>Region</div>       | Breakdown dimension's metrics to the country's region level.<br /><br />**Field Name:** `region`<br />**Type:** dimension       |
| <div>Age</div>          | Breakdown dimension's metrics to age brackets from 18-24 to 65+.<br /><br />**Field Name:** `age`<br />**Type:** dimension      |
| <div>Gender</div>       | Breakdown dimension's metrics to genders: male, female or unknown.<br /><br />**Field Name:** `gender`<br />**Type:** dimension |

### Placement

|                               |                                                                                                                                                                                                                                                                                                                                               |
| ----------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| <div>Publisher Platform</div> | Breakdown results by publisher platform: facebook, instagram, messenger, audience\_network.<br /><br />**Field Name:** `publisher_platform`<br />**Type:** dimension                                                                                                                                                                          |
| <div>Platform Position</div>  | Breakdown results by the position that your ads have within the platform: messenger\_inbox, facebook\_reels, facebook\_reels\_overlay, facebook\_stories, instream\_video, search and more.. You have to select the 'Publisher Platform' field to get this dimension.<br /><br />**Field Name:** `platform_position`<br />**Type:** dimension |

### Device

|                              |                                                                                                                                                                                          |
| ---------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| <div>Device Platform</div>   | Breakdown result by Meta's platform: desktop, mobile\_app, mobile\_web.<br /><br />**Field Name:** `device_platform`<br />**Type:** dimension                                            |
| <div>Impression Device</div> | Breakdown result by the user's device: desktop, android\_smartphone, ipad, iphone, android\_tablet, ipod, other.<br /><br />**Field Name:** `impression_device`<br />**Type:** dimension |

### Advantage+ Campaigns

|                                      |                                                                                                                                                                                                                                                                                                                                                  |
| ------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| <div>Audience Segment</div>          | Breakdown by audience segment for Advantage+ Sales campaigns. Shows how spend and results are distributed across Existing Customers, New Audience (Prospecting), and Unknown segments. Requires Advantage+ Sales campaign type. Cannot be combined with other breakdowns.<br /><br />**Field Name:** `user_segment_key`<br />**Type:** dimension |
| <div>Gen AI Asset Type</div>         | Breakdown by whether the creative asset was AI-generated or original. Shows performance comparison between creatives made with Meta AI tools (Background Generation, Image Expansion, Text Generation) vs. original uploaded content.<br /><br />**Field Name:** `gen_ai_asset_type`<br />**Type:** dimension                                    |
| <div>Standard Enhancement Type</div> | Breakdown by Standard Enhancement (Advantage+ Creative) modifications. Shows whether Meta automatically applied enhancements to your creatives (brightness/contrast adjustments, aspect ratio changes, text overlays) vs. delivering the original version.<br /><br />**Field Name:** `creative_relaxation_asset_type`<br />**Type:** dimension  |

### Target

|                              |                                                                                                                                                                                                                                     |
| ---------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| <div>Optimization Goal</div> | The target KPI of your campaign: Unknown Optimization Goal, IMPRESSIONS, LANDING\_PAGE\_VIEWS, REPLIES, REACH, THRUPLAY, NONE, AD\_RECALL\_LIFT and more...<br /><br />**Field Name:** `optimization_goal`<br />**Type:** dimension |

### Account

|                                                |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
| ---------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| <div>Account Status</div>                      | The current status of your Ad Account. These can be: ACTIVE, DISABLED, UNSETTLED, PENDING\_RISK\_REVIEW, PENDING\_SETTLEMENT, IN\_GRACE\_PERIOD, PENDING\_CLOSURE, CLOSED, ANY\_ACTIVE, ANY\_CLOSED.<br /><br />**Field Name:** `account_status`<br />**Type:** dimension                                                                                                                                                                                                                                                 |
| <div>Account Currency</div>                    | The currency set in your ad account.<br /><br />**Field Name:** `account_currency`<br />**Type:** dimension                                                                                                                                                                                                                                                                                                                                                                                                               |
| <div>Account Age</div>                         | Amount of time the ad account has been open, in days.<br /><br />**Field Name:** `account_age`<br />**Type:** dimension                                                                                                                                                                                                                                                                                                                                                                                                   |
| <div>Account Balance</div>                     | Bill amount due for this Ad Account.<br /><br />**Field Name:** `account_balance`<br />**Type:** dimension                                                                                                                                                                                                                                                                                                                                                                                                                |
| <div>Account Timezone Name</div>               | Name of the time zone for this ad account.<br /><br />**Field Name:** `account_timezone_name`<br />**Type:** dimension                                                                                                                                                                                                                                                                                                                                                                                                    |
| <div>Account Timezone Offset from UTC</div>    | Time zone difference from UTC (Coordinated Universal Time).<br /><br />**Field Name:** `account_timezone_offset_hours_utc`<br />**Type:** dimension                                                                                                                                                                                                                                                                                                                                                                       |
| <div>Account Business Country Code</div>       | Country code for the business address associated with this ad account.<br /><br />**Field Name:** `account_business_country_code`<br />**Type:** dimension                                                                                                                                                                                                                                                                                                                                                                |
| <div>Account Spend Cap</div>                   | The maximum amount that can be spent by this Ad Account. When the amount is reached, all delivery stops. A value of 0 means no spending cap. Value specified in the basic unit of the currency, e.g., 'cents' for USD.<br /><br />**Field Name:** `account_spend_cap`<br />**Type:** dimension                                                                                                                                                                                                                            |
| <div>Account Amount Spent</div>                | Current amount spent by the account with respect to spend cap, or total amount in the absence of spend cap.<br /><br />**Field Name:** `account_amount_spent`<br />**Type:** dimension                                                                                                                                                                                                                                                                                                                                    |
| <div>Account Can Create Brand Lift Study</div> | Indicates whether a new automated brand lift study can be created under this Ad Account.<br /><br />**Field Name:** `account_can_create_brand_lift_study`<br />**Type:** dimension                                                                                                                                                                                                                                                                                                                                        |
| <div>Account Created Time</div>                | The time the account was created in ISO 8601 format.<br /><br />**Field Name:** `account_created_time`<br />**Type:** dimension                                                                                                                                                                                                                                                                                                                                                                                           |
| <div>Account Disable Reason</div>              | The reason why the account was disabled. Possible reasons include: NONE, ADS\_INTEGRITY\_POLICY, ADS\_IP\_REVIEW, RISK\_PAYMENT, GRAY\_ACCOUNT\_SHUT\_DOWN, ADS\_AFC\_REVIEW, BUSINESS\_INTEGRITY\_RAR, PERMANENT\_CLOSE, UNUSED\_RESELLER\_ACCOUNT, UNUSED\_ACCOUNT, UMBRELLA\_AD\_ACCOUNT, BUSINESS\_MANAGER\_INTEGRITY\_POLICY, MISREPRESENTED\_AD\_ACCOUNT, AOAB\_DESHARE\_LEGAL\_ENTITY, CTX\_THREAD\_REVIEW, COMPROMISED\_AD\_ACCOUNT.<br /><br />**Field Name:** `account_disable_reason`<br />**Type:** dimension |

### Custom Events

|                              |                                                                                                                                                                                                                            |
| ---------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| <div>Custom Event Name</div> | Custom events measured by your App or Meta Pixel. Select together with the "Custom Event Count" metric. Split to Columns to avoid spend duplication.<br /><br />**Field Name:** `conversion_name`<br />**Type:** dimension |

### Campaign

|                                          |                                                                                                                                                                                                                                                                                                                                              |
| ---------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| <div>Campaign Status</div>               | <br /><br />**Field Name:** `campaign_status`<br />**Type:** dimension                                                                                                                                                                                                                                                                       |
| <div>Campaign Effective Status</div>     | <br /><br />**Field Name:** `campaign_effective_status`<br />**Type:** dimension                                                                                                                                                                                                                                                             |
| <div>Campaign Daily Budget</div>         | Campaign Daily Budget. If it is null then the budget is set at the ad set level.<br /><br />**Field Name:** `campaign_daily_budget`<br />**Type:** dimension                                                                                                                                                                                 |
| <div>Campaign Lifetime Budget</div>      | Campaign Lifetime Budget. If it is null then the budget is set at the ad set level.<br /><br />**Field Name:** `campaign_lifetime_budget`<br />**Type:** dimension                                                                                                                                                                           |
| <div>Campaign Budget Remaining</div>     | Remaining budget for the campaign. If it is null then the budget is set at the ad set level.<br /><br />**Field Name:** `campaign_budget_remaining`<br />**Type:** dimension                                                                                                                                                                 |
| <div>Campaign Objective</div>            | The Campaign's objective. These can be: PRODUCT\_CATALOG\_SALES, OUTCOME\_AWARENESS, LINK\_CLICKS, OUTCOME\_SALES, OUTCOME\_ENGAGEMENT, OUTCOME\_LEADS, VIDEO\_VIEWS, CONVERSIONS and more..<br /><br />**Field Name:** `objective`<br />**Type:** dimension                                                                                 |
| <div>Frequency Buckets</div>             | The number of times individuals were shown ads from your campaign. The data is segmented into buckets: 1, 2, 3, 4, 6-10. These numbers show how many times, on average, your audience is seeing your ads. You have to choose the 'reach' metric to get this dimension.<br /><br />**Field Name:** `frequency_value`<br />**Type:** dimension |
| <div>Campaign Bid Strategy</div>         | The bidding strategy used for the campaign.<br /><br />**Field Name:** `campaign_bid_strategy`<br />**Type:** dimension                                                                                                                                                                                                                      |
| <div>Campaign Buying Type</div>          | The buying type of the campaign.<br /><br />**Field Name:** `campaign_buying_type`<br />**Type:** dimension                                                                                                                                                                                                                                  |
| <div>Campaign Primary Attribution</div>  | The primary attribution model used for the campaign.<br /><br />**Field Name:** `campaign_primary_attribution`<br />**Type:** dimension                                                                                                                                                                                                      |
| <div>Campaign Smart Promotion Type</div> | The type of smart promotion used in the campaign.<br /><br />**Field Name:** `campaign_smart_promotion_type`<br />**Type:** dimension                                                                                                                                                                                                        |
| <div>Campaign Spend Cap</div>            | The maximum amount that can be spent on the campaign.<br /><br />**Field Name:** `campaign_spend_cap`<br />**Type:** dimension                                                                                                                                                                                                               |
| <div>Campaign Created Time</div>         | The time when the campaign was created.<br /><br />**Field Name:** `campaign_created_time`<br />**Type:** dimension                                                                                                                                                                                                                          |
| <div>Campaign Start Time</div>           | The time when the campaign started.<br /><br />**Field Name:** `campaign_start_time`<br />**Type:** dimension                                                                                                                                                                                                                                |
| <div>Campaign End Time</div>             | The time when the campaign ended or is scheduled to end.<br /><br />**Field Name:** `campaign_stop_time`<br />**Type:** dimension                                                                                                                                                                                                            |
| <div>Campaign Updated Time</div>         | The last time the campaign was updated.<br /><br />**Field Name:** `campaign_updated_time`<br />**Type:** dimension                                                                                                                                                                                                                          |

### Ad Set

|                                                  |                                                                                                                                                                                    |
| ------------------------------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| <div>Ad Set Status</div>                         | The status of the ad set.<br /><br />**Field Name:** `adset_status`<br />**Type:** dimension                                                                                       |
| <div>Ad Set Effective Status</div>               | The effective status of the ad set.<br /><br />**Field Name:** `adset_effective_status`<br />**Type:** dimension                                                                   |
| <div>Ad Set Daily Budget</div>                   | Ad Set Daily Budget. If it is null then the budget is set at the campaign level.<br /><br />**Field Name:** `adset_daily_budget`<br />**Type:** dimension                          |
| <div>Ad Set Lifetime Budget</div>                | The lifetime budget set for the ad set. If it is null then the budget is set at the campaign level.<br /><br />**Field Name:** `adset_lifetime_budget`<br />**Type:** dimension    |
| <div>Ad Set Budget Remaining</div>               | The remaining budget for the ad set. If it is null then the budget is set at the campaign level.<br /><br />**Field Name:** `adset_budget_remaining`<br />**Type:** dimension      |
| <div>Ad Set Objective</div>                      | The objective of the ad set.<br /><br />**Field Name:** `adset_objective`<br />**Type:** dimension                                                                                 |
| <div>Ad Set Bid Strategy</div>                   | The bidding strategy used for the ad set.<br /><br />**Field Name:** `adset_bid_strategy`<br />**Type:** dimension                                                                 |
| <div>Ad Set Spend Cap</div>                      | The maximum amount that can be spent on the ad set.<br /><br />**Field Name:** `adset_spend_cap`<br />**Type:** dimension                                                          |
| <div>Ad Set Created Time</div>                   | The time when the ad set was created.<br /><br />**Field Name:** `adset_created_time`<br />**Type:** dimension                                                                     |
| <div>Ad Set Start Time</div>                     | The time when the ad set started.<br /><br />**Field Name:** `adset_start_time`<br />**Type:** dimension                                                                           |
| <div>Ad Set End Time</div>                       | The time when the ad set ended or is scheduled to end.<br /><br />**Field Name:** `adset_end_time`<br />**Type:** dimension                                                        |
| <div>Ad Set Updated Time</div>                   | The last time the ad set was updated.<br /><br />**Field Name:** `adset_updated_time`<br />**Type:** dimension                                                                     |
| <div>Ad Set Billing Event</div>                  | The billing event for this ad set, such as IMPRESSIONS, CLICKS, LINK\_CLICKS, etc.<br /><br />**Field Name:** `adset_billing_event`<br />**Type:** dimension                       |
| <div>Ad Set Campaign Attribution</div>           | Indicates a campaign's attribution type, e.g., SKAN or AEM for app ads campaigns.<br /><br />**Field Name:** `adset_campaign_attribution`<br />**Type:** dimension                 |
| <div>Ad Set Destination Type</div>               | The destination type of the ad set, such as WEBSITE, APP, MESSENGER, INSTAGRAM\_DIRECT, etc.<br /><br />**Field Name:** `adset_destination_type`<br />**Type:** dimension          |
| <div>Ad Set Attribution Spec</div>               | The conversion attribution spec used for attributing conversions for optimization.<br /><br />**Field Name:** `adset_attribution_spec`<br />**Type:** dimension                    |
| <div>Ad Set Lifetime Impressions</div>           | The lifetime number of impressions for the ad set. Available for campaigns with buying\_type=FIXED\_CPM.<br /><br />**Field Name:** `adset_lifetime_imps`<br />**Type:** dimension |
| <div>Ad Set Multi-Optimization Goal Weight</div> | The weight for multiple optimization goals within the ad set.<br /><br />**Field Name:** `adset_multi_optimization_goal_weight`<br />**Type:** dimension                           |
| <div>Ad Set Optimization Goal</div>              | The optimization goal of the ad set, such as REACH, LINK\_CLICKS, IMPRESSIONS, etc.<br /><br />**Field Name:** `adset_optimization_goal`<br />**Type:** dimension                  |
| <div>Ad Set Optimization Sub Event</div>         | The sub-event for a specific optimization goal, like a Sound-On event for a video view goal.<br /><br />**Field Name:** `adset_optimization_sub_event`<br />**Type:** dimension    |
| <div>Ad Set Pacing Type</div>                    | Defines the pacing type, such as standard pacing or scheduling-based pacing.<br /><br />**Field Name:** `adset_pacing_type`<br />**Type:** dimension                               |

### Ad Set Targeting

|                                                                |                                                                                                                                                                                                                                   |
| -------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| <div>Ad Set Targeting Age Max</div>                            | The maximum age targeted by the ad set.<br /><br />**Field Name:** `adset_targeting_age_max`<br />**Type:** dimension                                                                                                             |
| <div>Ad Set Targeting Age Min</div>                            | The minimum age targeted by the ad set.<br /><br />**Field Name:** `adset_targeting_age_min`<br />**Type:** dimension                                                                                                             |
| <div>Ad Set Targeting Interests</div>                          | The interests targeted by the ad set, based on user preferences and behavior.<br /><br />**Field Name:** `adset_targeting_interests`<br />**Type:** dimension                                                                     |
| <div>Ad Set Targeting Behaviors</div>                          | The behaviors targeted by the ad set, indicating actions or habits of the users.<br /><br />**Field Name:** `adset_targeting_behaviors`<br />**Type:** dimension                                                                  |
| <div>Ad Set Targeting Custom Audiences</div>                   | Custom audiences targeted by the ad set, based on lists uploaded by advertisers.<br /><br />**Field Name:** `adset_targeting_custom_audiences`<br />**Type:** dimension                                                           |
| <div>Ad Set Targeting Geo Countries</div>                      | Countries targeted by the ad set based on geographic location.<br /><br />**Field Name:** `adset_targeting_geo_countries`<br />**Type:** dimension                                                                                |
| <div>Ad Set Targeting Geo Regions</div>                        | Regions targeted by the ad set within a specific country or group of countries.<br /><br />**Field Name:** `adset_targeting_geo_regions`<br />**Type:** dimension                                                                 |
| <div>Ad Set Targeting Geo Cities</div>                         | Cities targeted by the ad set based on geographic location.<br /><br />**Field Name:** `adset_targeting_geo_cities`<br />**Type:** dimension                                                                                      |
| <div>Ad Set Targeting Included Locations</div>                 | All locations included in the ad set targeting (countries, regions, cities and custom radius pins), as shown under Locations → Included.<br /><br />**Field Name:** `adset_targeting_included_locations`<br />**Type:** dimension |
| <div>Ad Set Targeting Geo Location Types</div>                 | The location types targeted by the ad set, such as home, work, or travel locations.<br /><br />**Field Name:** `adset_targeting_geo_location_types`<br />**Type:** dimension                                                      |
| <div>Ad Set Targeting Publisher Platforms</div>                | The publisher platforms targeted by the ad set, like Facebook, Instagram, Messenger, etc.<br /><br />**Field Name:** `adset_targeting_publisher_platforms`<br />**Type:** dimension                                               |
| <div>Ad Set Targeting Device Platforms</div>                   | The device platforms targeted by the ad set, such as desktop, mobile, or tablet.<br /><br />**Field Name:** `adset_targeting_device_platforms`<br />**Type:** dimension                                                           |
| <div>Ad Set Targeting Instagram Positions</div>                | The positions within Instagram targeted by the ad set, like feed, stories, reels, etc.<br /><br />**Field Name:** `adset_targeting_instagram_positions`<br />**Type:** dimension                                                  |
| <div>Ad Set Targeting Facebook Positions</div>                 | The positions within Facebook targeted by the ad set, such as news feed, right column, etc.<br /><br />**Field Name:** `adset_targeting_facebook_positions`<br />**Type:** dimension                                              |
| <div>Ad Set Targeting Brand Safety Content Filter Levels</div> | The content filter levels used to ensure brand safety for the ad set.<br /><br />**Field Name:** `adset_targeting_brand_safety_content_filter_levels`<br />**Type:** dimension                                                    |

### Ad

|                                   |                                                                                                                                                                                                                               |
| --------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| <div>Ad Status</div>              | The status of the ad.<br /><br />**Field Name:** `ad_status`<br />**Type:** dimension                                                                                                                                         |
| <div>Ad Effective Status</div>    | The effective status of the ad.<br /><br />**Field Name:** `ad_effective_status`<br />**Type:** dimension                                                                                                                     |
| <div>Ad Format</div>              | The format of the ad.<br /><br />**Field Name:** `ad_format`<br />**Type:** dimension                                                                                                                                         |
| <div>Ad Image URL</div>           | The URL of the ad image. Video thumbnail for video ads.<br /><br />**Field Name:** `ad_image_url`<br />**Type:** dimension                                                                                                    |
| <div>Ad Image</div>               | The image URL wrapped in a sheets IMAGE function.<br /><br />**Field Name:** `ad_image`<br />**Type:** dimension                                                                                                              |
| <div>Ad URL Tags</div>            | The URL tags associated with the ad.<br /><br />**Field Name:** `url_tags`<br />**Type:** dimension                                                                                                                           |
| <div>Ad Creative Body</div>       | Text associated with the ad.<br /><br />**Field Name:** `instagram_copy`<br />**Type:** dimension                                                                                                                             |
| <div>Ad Instagram Post ID</div>   | The API ID of the Instagram post.<br /><br />**Field Name:** `instagram_post_api_id`<br />**Type:** dimension                                                                                                                 |
| <div>Ad Call To Action Type</div> | The type of call-to-action used in the ad.<br /><br />**Field Name:** `call_to_action_type`<br />**Type:** dimension                                                                                                          |
| <div>Ad Destination URL</div>     | The destination URL of the ad.<br /><br />**Field Name:** `ad_destination_url`<br />**Type:** dimension                                                                                                                       |
| <div>Ad Optimization Type</div>   | The type of optimization used for the ad.<br /><br />**Field Name:** `ad_optimization_type`<br />**Type:** dimension                                                                                                          |
| <div>Ad Source Ad ID</div>        | The ID of the source ad that this ad was copied from.<br /><br />**Field Name:** `source_ad_id`<br />**Type:** dimension                                                                                                      |
| <div>Ad Created Time</div>        | The time when the ad was created.<br /><br />**Field Name:** `ad_created_time`<br />**Type:** dimension                                                                                                                       |
| <div>Ad Updated Time</div>        | The time when the ad was last updated. When querying without metrics, this field is used to filter ads based on the timeframe selected in your request.<br /><br />**Field Name:** `ad_updated_time`<br />**Type:** dimension |
| <div>Ad Conversion Domain</div>   | The domain where conversions happen for this ad, e.g., example.com.<br /><br />**Field Name:** `ad_conversion_domain`<br />**Type:** dimension                                                                                |
| <div>Ad Creative ID</div>         | The ID of the ad creative used by this ad.<br /><br />**Field Name:** `ad_creative_id`<br />**Type:** dimension                                                                                                               |

### Ad Creative

|                                            |                                                                                                                                       |
| ------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------- |
| <div>Ad Creative Title</div>               | The title of the ad creative.<br /><br />**Field Name:** `ad_creative_title`<br />**Type:** dimension                                 |
| <div>Ad Creative Name</div>                | The name of the ad creative.<br /><br />**Field Name:** `ad_creative_name`<br />**Type:** dimension                                   |
| <div>Ad Creative Type</div>                | The type of the ad creative.<br /><br />**Field Name:** `ad_creative_type`<br />**Type:** dimension                                   |
| <div>Ad Creative Instagram Permalink</div> | The Instagram permalink URL of the ad creative.<br /><br />**Field Name:** `ad_creative_instagram_permalink`<br />**Type:** dimension |

### Ad Previews

|                                      |                                                                                                                     |
| ------------------------------------ | ------------------------------------------------------------------------------------------------------------------- |
| <div>Ad Shareable Preview Link</div> | A shareable link to preview the ad.<br /><br />**Field Name:** `ad_preview_shareable_link`<br />**Type:** dimension |
| <div>Ad Mobile Feed Preview</div>    | <br /><br />**Field Name:** `ad_preview_mobile_feed_url`<br />**Type:** dimension                                   |
| <div>Ad Desktop Feed Preview</div>   | <br /><br />**Field Name:** `ad_preview_desktop_feed_url`<br />**Type:** dimension                                  |
| <div>Ad Reel Preview</div>           | <br /><br />**Field Name:** `ad_preview_instagram_reel_url`<br />**Type:** dimension                                |

### Video Ads

|                            |                                                                                                           |
| -------------------------- | --------------------------------------------------------------------------------------------------------- |
| <div>Ad Video Title</div>  | The name of the video file.<br /><br />**Field Name:** `ad_video_title`<br />**Type:** dimension          |
| <div>Ad Video URL</div>    | The URL of the video.<br /><br />**Field Name:** `ad_video_url`<br />**Type:** dimension                  |
| <div>Ad Video Length</div> | The length of the video in seconds.<br /><br />**Field Name:** `ad_video_length`<br />**Type:** dimension |

### Ad Audience & Placement

|                                          |                                                                                      |
| ---------------------------------------- | ------------------------------------------------------------------------------------ |
| <div>Ad Min Age</div>                    | <br /><br />**Field Name:** `ad_min_age`<br />**Type:** dimension                    |
| <div>Ad Max Age</div>                    | <br /><br />**Field Name:** `ad_max_age`<br />**Type:** dimension                    |
| <div>Ad Publisher Platforms</div>        | <br /><br />**Field Name:** `ad_publisher_platforms`<br />**Type:** dimension        |
| <div>Ad Facebook Positions</div>         | <br /><br />**Field Name:** `ad_facebook_positions`<br />**Type:** dimension         |
| <div>Ad Instagram Positions</div>        | <br /><br />**Field Name:** `ad_instagram_positions`<br />**Type:** dimension        |
| <div>Ad Messenger Positions</div>        | <br /><br />**Field Name:** `ad_messenger_positions`<br />**Type:** dimension        |
| <div>Ad Audience Network Positions</div> | <br /><br />**Field Name:** `ad_audience_network_positions`<br />**Type:** dimension |

### Ad Recommendations

|                                         |                                                                                     |
| --------------------------------------- | ----------------------------------------------------------------------------------- |
| <div>Ad Recommendation Title</div>      | <br /><br />**Field Name:** `ad_recommendation_title`<br />**Type:** dimension      |
| <div>Ad Recommendation Message</div>    | <br /><br />**Field Name:** `ad_recommendation_message`<br />**Type:** dimension    |
| <div>Ad Recommendation Importance</div> | <br /><br />**Field Name:** `ad_recommendation_importance`<br />**Type:** dimension |
| <div>Ad Recommendation Confidence</div> | <br /><br />**Field Name:** `ad_recommendation_confidence`<br />**Type:** dimension |

## Metrics

Metrics are the numerical values you can measure and analyze from your Meta Ads campaigns.

### Most Used

|                               |                                                                                                                                                                                                                   |
| ----------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| <div>Amount Spent</div>       | Amount spent on your ads.<br /><br />**Field Name:** `spend`<br />**Type:** metric                                                                                                                                |
| <div>Clicks</div>             | The number of clicks on your ads.<br /><br />**Field Name:** `clicks`<br />**Type:** metric                                                                                                                       |
| <div>Inline Link Clicks</div> | Number of clicks on the link within the ad.<br /><br />**Field Name:** `inline_link_clicks`<br />**Type:** metric                                                                                                 |
| <div>Impressions</div>        | Number of times your ads were shown.<br /><br />**Field Name:** `impressions`<br />**Type:** metric                                                                                                               |
| <div>Reach</div>              | Number of unique users who saw the ad.<br /><br />**Field Name:** `reach`<br />**Type:** metric                                                                                                                   |
| <div>Frequency</div>          | Average number of times each user saw the ad.<br /><br />**Field Name:** `frequency`<br />**Type:** metric                                                                                                        |
| <div>Landing Page Views</div> | Number of times the landing page was viewed after a user clicked on the ad.<br /><br />**Field Name:** `landing_page_view`<br />**Type:** metric                                                                  |
| <div>Results</div>            | The number of times your ad achieved its optimization goal (e.g., landing page views, reach, video views). Only available at campaign level and below.<br /><br />**Field Name:** `results`<br />**Type:** metric |
| <div>Cost per Result</div>    | The average cost per result based on the ad set optimization goal. Only available at campaign level and below.<br /><br />**Field Name:** `cost_per_result`<br />**Type:** metric                                 |

### Brand Awareness

|                                                       |                                                                                                                                                                                                                                                                                    |
| ----------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| <div>Estimated Ad Recall Lift (People)</div>          | The estimated number of additional people who may remember seeing your ads, if asked, within 2 days. This metric is only available for campaigns using the Brand Awareness objective.<br /><br />**Field Name:** `estimated_ad_recallers`<br />**Type:** metric                    |
| <div>Estimated Ad Recall Lift Rate</div>              | The rate at which an estimated number of additional people, when asked, would remember seeing your ads within 2 days. This metric is only available for campaigns using the Brand Awareness objective.<br /><br />**Field Name:** `estimated_ad_recall_rate`<br />**Type:** metric |
| <div>Cost per Estimated Ad Recall Lift (People)</div> | The average cost per estimated additional person who may remember seeing your ads. This metric is only available for campaigns using the Brand Awareness objective.<br /><br />**Field Name:** `cost_per_estimated_ad_recallers`<br />**Type:** metric                             |

### Videos

|                                            |                                                                                                                                                                                                                                                                                   |
| ------------------------------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| <div>Video Views</div>                     | The number of times your video starts to play (video plays of at least 1ms). Shown in Meta Ads Manager as "Visualizaciones" / "Views". This is counted for each impression of a video and excludes replays.<br /><br />**Field Name:** `video_play_actions`<br />**Type:** metric |
| <div>3 Seconds Video View</div>            | Number of times the video was viewed for at least 3 seconds.<br /><br />**Field Name:** `video_view`<br />**Type:** metric                                                                                                                                                        |
| <div>ThruPlay Actions</div>                | Number of times the video was played to completion or for at least 15 seconds.<br /><br />**Field Name:** `video_thruplay_watched_actions`<br />**Type:** metric                                                                                                                  |
| <div>Cost per ThruPlay</div>               | The average cost per video thruplay (when a viewer watches 15 seconds or 97% of your video).<br /><br />**Field Name:** `cost_per_thruplay`<br />**Type:** metric                                                                                                                 |
| <div>Video Watches at 25%</div>            | Number of times at least 25% of the video was watched.<br /><br />**Field Name:** `video_p25_watched_actions`<br />**Type:** metric                                                                                                                                               |
| <div>Video Watches at 50%</div>            | Number of times at least 50% of the video was watched.<br /><br />**Field Name:** `video_p50_watched_actions`<br />**Type:** metric                                                                                                                                               |
| <div>Video Watches at 75%</div>            | Number of times at least 75% of the video was watched.<br /><br />**Field Name:** `video_p75_watched_actions`<br />**Type:** metric                                                                                                                                               |
| <div>Video Watches at 95%</div>            | The number of times your video was played at 95% of its length, including plays that skipped to this point.<br /><br />**Field Name:** `video_p95_watched_actions`<br />**Type:** metric                                                                                          |
| <div>Video Watches at 100%</div>           | Number of times the video was watched completely.<br /><br />**Field Name:** `video_p100_watched_actions`<br />**Type:** metric                                                                                                                                                   |
| <div>Video Avg Watch Time (secs)</div>     | The average time a video was played, including any time spent replaying the video for a single impression.<br /><br />**Field Name:** `video_avg_time_watched_actions`<br />**Type:** metric                                                                                      |
| <div>Full View Impressions</div>           | The number of Full Views on your Page's posts as a result of your ad.<br /><br />**Field Name:** `full_view_impressions`<br />**Type:** metric                                                                                                                                    |
| <div>Full View Reach</div>                 | The number of people who performed a Full View on your Page's post as a result of your ad.<br /><br />**Field Name:** `full_view_reach`<br />**Type:** metric                                                                                                                     |
| <div>Cost per Video View</div>             | The average cost for each video view.<br /><br />**Field Name:** `cost_per_video_view`<br />**Type:** metric                                                                                                                                                                      |
| <div>Cost per Video Play</div>             | The average cost for each video play.<br /><br />**Field Name:** `cost_per_video_play`<br />**Type:** metric                                                                                                                                                                      |
| <div>2-second Continuous Video Plays</div> | The number of times your video was watched for at least 2 continuous seconds.<br /><br />**Field Name:** `video_continuous_2_sec_watched_actions`<br />**Type:** metric                                                                                                           |

### Website (Pixel)

|                                                   |                                                                                                                                                                            |
| ------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| <div>Website Contacts</div>                       | Number of contacts or inquiries made through your website.<br /><br />**Field Name:** `contact_website`<br />**Type:** metric                                              |
| <div>Website Leads</div>                          | Number of potential customers who have shown interest from your website.<br /><br />**Field Name:** `offsite_conversion.fb_pixel_lead`<br />**Type:** metric               |
| <div>Website Adds to Cart</div>                   | Number of times a product was added to the cart from your website.<br /><br />**Field Name:** `offsite_conversion.fb_pixel_add_to_cart`<br />**Type:** metric              |
| <div>Website Adds of payment Info</div>           | Number of times payment information was added on your website.<br /><br />**Field Name:** `offsite_conversion.fb_pixel_add_payment_info`<br />**Type:** metric             |
| <div>Website Adds to Wishlist</div>               | Number of times a product was added to the wishlist from your website.<br /><br />**Field Name:** `offsite_conversion.fb_pixel_add_to_wishlist`<br />**Type:** metric      |
| <div>Website Registrations Completed</div>        | Number of times a user completed a registration form on your website.<br /><br />**Field Name:** `offsite_conversion.fb_pixel_complete_registration`<br />**Type:** metric |
| <div>Website Checkouts Initiated</div>            | Number of times a user started the checkout process on your website.<br /><br />**Field Name:** `offsite_conversion.fb_pixel_initiate_checkout`<br />**Type:** metric      |
| <div>Website Purchases</div>                      | Number of purchases made on your website.<br /><br />**Field Name:** `offsite_conversion.fb_pixel_purchase`<br />**Type:** metric                                          |
| <div>Website Searches</div>                       | Number of times a search was made on your website.<br /><br />**Field Name:** `offsite_conversion.fb_pixel_search`<br />**Type:** metric                                   |
| <div>Website Content Views</div>                  | Number of times content was viewed on your website.<br /><br />**Field Name:** `offsite_conversion.fb_pixel_view_content`<br />**Type:** metric                            |
| <div>Website Custom Conversions</div>             | All Custom Events from your website.<br /><br />**Field Name:** `offsite_conversion.fb_pixel_custom`<br />**Type:** metric                                                 |
| <div>Website Submit Application</div>             | Number of times an application was submitted on your website.<br /><br />**Field Name:** `submit_application_website`<br />**Type:** metric                                |
| <div>Website Recurring Subscription</div>         | Number of recurring subscription payments made on your website.<br /><br />**Field Name:** `recurring_subscription_payment_website`<br />**Type:** metric                  |
| <div>Website Subscribe</div>                      | Number of times a subscription was made on your website.<br /><br />**Field Name:** `subscribe_website`<br />**Type:** metric                                              |
| <div>Website Cancel Subscription</div>            | Number of times a subscription was cancelled on your website.<br /><br />**Field Name:** `cancel_subscription_website`<br />**Type:** metric                               |
| <div>Website Donate</div>                         | Number of times a donation was made on your website.<br /><br />**Field Name:** `donate_website`<br />**Type:** metric                                                     |
| <div>Website Start Trial</div>                    | Number of times a trial was started on your website.<br /><br />**Field Name:** `start_trial_website`<br />**Type:** metric                                                |
| <div>Website Find Location</div>                  | <br /><br />**Field Name:** `find_location_website`<br />**Type:** metric                                                                                                  |
| <div>Cost per Website Purchase</div>              | The average cost for each website purchase.<br /><br />**Field Name:** `cost_per_website_purchase`<br />**Type:** metric                                                   |
| <div>Cost per Website Lead</div>                  | The average cost for each website lead.<br /><br />**Field Name:** `cost_per_website_lead`<br />**Type:** metric                                                           |
| <div>Cost per Website Add to Cart</div>           | The average cost for each website add to cart.<br /><br />**Field Name:** `cost_per_website_add_to_cart`<br />**Type:** metric                                             |
| <div>Cost per Website View Content</div>          | The average cost for each website view content.<br /><br />**Field Name:** `cost_per_website_view_content`<br />**Type:** metric                                           |
| <div>Cost per Website Add Payment Info</div>      | The average cost for each website add payment info.<br /><br />**Field Name:** `cost_per_website_add_payment_info`<br />**Type:** metric                                   |
| <div>Cost per Website Add to Wishlist</div>       | The average cost for each website add to wishlist.<br /><br />**Field Name:** `cost_per_website_add_to_wishlist`<br />**Type:** metric                                     |
| <div>Cost per Website Complete Registration</div> | The average cost for each website registration completed.<br /><br />**Field Name:** `cost_per_website_complete_registration`<br />**Type:** metric                        |
| <div>Cost per Website Search</div>                | The average cost for each website search.<br /><br />**Field Name:** `cost_per_website_search`<br />**Type:** metric                                                       |
| <div>Cost per Website Initiate Checkout</div>     | The average cost for each website initiate checkout.<br /><br />**Field Name:** `cost_per_website_initiate_checkout`<br />**Type:** metric                                 |
| <div>Cost per Website Custom Conversion</div>     | The average cost for each website custom conversion.<br /><br />**Field Name:** `cost_per_website_custom_conversion`<br />**Type:** metric                                 |
| <div>Cost per Landing Page View</div>             | The average cost for each landing page view.<br /><br />**Field Name:** `cost_per_landing_page_view`<br />**Type:** metric                                                 |
| <div>Cost per Website Find Location</div>         | The average cost for each find location on website.<br /><br />**Field Name:** `cost_per_find_location_website`<br />**Type:** metric                                      |
| <div>Cost per Website Submit Application</div>    | The average cost for each website submit application.<br /><br />**Field Name:** `cost_per_submit_application_website`<br />**Type:** metric                               |
| <div>Cost per Website Contact</div>               | The average cost for each website contact.<br /><br />**Field Name:** `cost_per_contact_website`<br />**Type:** metric                                                     |
| <div>Cost per Website Donate</div>                | The average cost for each website donate.<br /><br />**Field Name:** `cost_per_donate_website`<br />**Type:** metric                                                       |
| <div>Cost per Website Schedule</div>              | The average cost for each website schedule.<br /><br />**Field Name:** `cost_per_schedule_website`<br />**Type:** metric                                                   |
| <div>Cost per Website Start Trial</div>           | The average cost for each website start trial.<br /><br />**Field Name:** `cost_per_start_trial_website`<br />**Type:** metric                                             |
| <div>Cost per Website Subscribe</div>             | The average cost for each website subscribe.<br /><br />**Field Name:** `cost_per_subscribe_website`<br />**Type:** metric                                                 |
| <div>Website Schedule</div>                       | Website Appointments Scheduled<br /><br />**Field Name:** `schedule_website`<br />**Type:** metric                                                                         |
| <div>Pixel Website Customize Products</div>       | <br /><br />**Field Name:** `customize_product_website`<br />**Type:** metric                                                                                              |

### Offline Conversions

|                                               |                                                                                                                                                                                                                       |
| --------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| <div>Offline Purchases</div>                  | Number of offline purchases attributed to your ads (e.g. uploaded via an offline events / CSV set).<br /><br />**Field Name:** `offline_conversion.purchase`<br />**Type:** metric                                    |
| <div>Offline Other Conversions</div>          | Number of other (non-standard) offline conversions attributed to your ads (e.g. uploaded via an offline events / CSV set).<br /><br />**Field Name:** `offline_conversion.other`<br />**Type:** metric                |
| <div>Offline Purchases Conversion Value</div> | The total value of offline purchases attributed to your ads (e.g. uploaded via an offline events / CSV set).<br /><br />**Field Name:** `offline_conversion.purchase.value`<br />**Type:** metric                     |
| <div>Offline Other Conversions Value</div>    | The total value of other (non-standard) offline conversions attributed to your ads (e.g. uploaded via an offline events / CSV set).<br /><br />**Field Name:** `offline_conversion.other.value`<br />**Type:** metric |

### Messaging

|                                                    |                                                                                                                                                                                                                                                                                                                |
| -------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| <div>New Messaging Conversations</div>             | Number of times a first reply was sent in a conversation on Meta.<br /><br />**Field Name:** `onsite_conversion.messaging_first_reply`<br />**Type:** metric                                                                                                                                                   |
| <div>Messaging Conversations Started</div>         | Number of conversations that were started on Meta products.<br /><br />**Field Name:** `onsite_conversion.messaging_conversation_started_7d`<br />**Type:** metric                                                                                                                                             |
| <div>Blocked Messaging Conversations</div>         | Number of users who have blocked messaging on Meta<br /><br />**Field Name:** `onsite_conversion.messaging_block`<br />**Type:** metric                                                                                                                                                                        |
| <div>Messaging Subscription</div>                  | The number of times an account has subscribed to receive marketing messages from your business, attributed to your ad. If an account has subscribed to multiple topics, it will be counted again for each topic<br /><br />**Field Name:** `onsite_conversion.messaging_user_subscribed`<br />**Type:** metric |
| <div>Cost per Lead</div>                           | The average cost for each lead.<br /><br />**Field Name:** `cost_per_lead`<br />**Type:** metric                                                                                                                                                                                                               |
| <div>Cost per Lead Form</div>                      | The average cost for each lead form submission.<br /><br />**Field Name:** `cost_per_lead_form`<br />**Type:** metric                                                                                                                                                                                          |
| <div>Cost per Messaging Conversation Started</div> | The average cost for each messaging conversation started.<br /><br />**Field Name:** `cost_per_messaging_conversation_started`<br />**Type:** metric                                                                                                                                                           |
| <div>Cost per Messaging First Reply</div>          | The average cost for each messaging first reply.<br /><br />**Field Name:** `cost_per_messaging_first_reply`<br />**Type:** metric                                                                                                                                                                             |

### Custom Events

|                               |                                                                                                                                                                 |
| ----------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| <div>Custom Event Count</div> | Custom events measured by your App or Meta Pixel. Select "Custom Event Name" in dimensions.<br /><br />**Field Name:** `conversion_count`<br />**Type:** metric |

### Website Conversion Value (Pixel)

|                                                  |                                                                                                                                                                        |
| ------------------------------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| <div>Website Leads Conversion Value</div>        | The total value of leads from your website.<br /><br />**Field Name:** `offsite_conversion.fb_pixel_lead.value`<br />**Type:** metric                                  |
| <div>Website Adds to Cart Conversion Value</div> | The total value of products added to cart from your website.<br /><br />**Field Name:** `offsite_conversion.fb_pixel_add_to_cart.value`<br />**Type:** metric          |
| <div>Website Add Payment Info Value</div>        | The total value of payment information added on your website.<br /><br />**Field Name:** `offsite_conversion.fb_pixel_add_payment_info.value`<br />**Type:** metric    |
| <div>Website Add To Wishlist Value</div>         | The total value of products added to wishlist from your website.<br /><br />**Field Name:** `offsite_conversion.fb_pixel_add_to_wishlist.value`<br />**Type:** metric  |
| <div>Website Complete Registration Value</div>   | The total value of completed registrations on your website.<br /><br />**Field Name:** `offsite_conversion.fb_pixel_complete_registration.value`<br />**Type:** metric |
| <div>Website Initiate Checkout Value</div>       | The total value of initiated checkouts on your website.<br /><br />**Field Name:** `offsite_conversion.fb_pixel_initiate_checkout.value`<br />**Type:** metric         |
| <div>Website Purchases Conversion Value</div>    | The total value of purchases made on your website.<br /><br />**Field Name:** `offsite_conversion.fb_pixel_purchase.value`<br />**Type:** metric                       |

### App Actions

|                                                                |                                                                                                                                                                                       |
| -------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| <div>Mobile App Purchases Conversion Value</div>               | The total value of purchases made in your mobile app.<br /><br />**Field Name:** `app_custom_event.fb_mobile_purchase.value`<br />**Type:** metric                                    |
| <div>Mobile App Adds to Cart Conversion Value</div>            | The total value of items added to cart in your mobile app.<br /><br />**Field Name:** `app_custom_event.fb_mobile_add_to_cart.value`<br />**Type:** metric                            |
| <div>Mobile App Checkouts Initiated Conversion Value</div>     | The total value of checkouts initiated in your mobile app.<br /><br />**Field Name:** `app_custom_event.fb_mobile_initiated_checkout.value`<br />**Type:** metric                     |
| <div>Mobile App Adds of Payment Info Conversion Value</div>    | The total value associated with payment info added in your mobile app.<br /><br />**Field Name:** `app_custom_event.fb_mobile_add_payment_info.value`<br />**Type:** metric           |
| <div>Mobile App Registrations Completed Conversion Value</div> | The total value associated with registrations completed in your mobile app.<br /><br />**Field Name:** `app_custom_event.fb_mobile_complete_registration.value`<br />**Type:** metric |
| <div>Mobile App Achievements Unlocked</div>                    | <br /><br />**Field Name:** `app_custom_event.fb_mobile_achievement_unlocked`<br />**Type:** metric                                                                                   |
| <div>Mobile App Sessions</div>                                 | <br /><br />**Field Name:** `app_custom_event.fb_mobile_activate_app`<br />**Type:** metric                                                                                           |
| <div>Mobile App Adds of Payment Info</div>                     | <br /><br />**Field Name:** `app_custom_event.fb_mobile_add_payment_info`<br />**Type:** metric                                                                                       |
| <div>Mobile App Adds to Cart</div>                             | <br /><br />**Field Name:** `app_custom_event.fb_mobile_add_to_cart`<br />**Type:** metric                                                                                            |
| <div>Mobile App Adds to Wishlist</div>                         | <br /><br />**Field Name:** `app_custom_event.fb_mobile_add_to_wishlist`<br />**Type:** metric                                                                                        |
| <div>Mobile App Registrations Completed</div>                  | <br /><br />**Field Name:** `app_custom_event.fb_mobile_complete_registration`<br />**Type:** metric                                                                                  |
| <div>Mobile App Content Views</div>                            | <br /><br />**Field Name:** `app_custom_event.fb_mobile_content_view`<br />**Type:** metric                                                                                           |
| <div>Mobile App Checkouts Initiated</div>                      | <br /><br />**Field Name:** `app_custom_event.fb_mobile_initiated_checkout`<br />**Type:** metric                                                                                     |
| <div>Mobile App Levels Completed</div>                         | <br /><br />**Field Name:** `app_custom_event.fb_mobile_level_achieved`<br />**Type:** metric                                                                                         |
| <div>Mobile App Purchases</div>                                | <br /><br />**Field Name:** `app_custom_event.fb_mobile_purchase`<br />**Type:** metric                                                                                               |
| <div>Mobile App Ratings Submitted</div>                        | <br /><br />**Field Name:** `app_custom_event.fb_mobile_rate`<br />**Type:** metric                                                                                                   |
| <div>Mobile App Searches</div>                                 | <br /><br />**Field Name:** `app_custom_event.fb_mobile_search`<br />**Type:** metric                                                                                                 |
| <div>Mobile App Credits Spent</div>                            | <br /><br />**Field Name:** `app_custom_event.fb_mobile_spent_credits`<br />**Type:** metric                                                                                          |
| <div>Mobile App Tutorials Completed</div>                      | <br /><br />**Field Name:** `app_custom_event.fb_mobile_tutorial_completion`<br />**Type:** metric                                                                                    |
| <div>Other Mobile App Actions</div>                            | <br /><br />**Field Name:** `app_custom_event.other`<br />**Type:** metric                                                                                                            |

### Catalog & Cross-Channel Value

|                                               |                                                                                                                                                                                   |
| --------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| <div>Omni Purchase Conversion Value</div>     | The total value of purchases across all channels (web, app and in-store) attributed to your ads.<br /><br />**Field Name:** `omni_purchase.value`<br />**Type:** metric           |
| <div>Catalog Purchases Conversion Value</div> | The total purchase value attributed to your product catalog (catalog / collaborative ads).<br /><br />**Field Name:** `catalog_segment_value.omni_purchase`<br />**Type:** metric |

### App Metrics

|                                                     |                                                                                                                                                                     |
| --------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| <div>Mobile App Install</div>                       | Number of mobile app installs.<br /><br />**Field Name:** `mobile_app_install`<br />**Type:** metric                                                                |
| <div>Mobile App Start Trial</div>                   | Number of times a trial was started through the mobile app.<br /><br />**Field Name:** `start_trial_mobile_app`<br />**Type:** metric                               |
| <div>Mobile App Submit Application</div>            | Number of times an application was submitted through the mobile app.<br /><br />**Field Name:** `submit_application_mobile_app`<br />**Type:** metric               |
| <div>Mobile App Recurring Subscription</div>        | Number of recurring subscription payments made through the mobile app.<br /><br />**Field Name:** `recurring_subscription_payment_mobile_app`<br />**Type:** metric |
| <div>Mobile App Subscribe</div>                     | Number of times a subscription was made through the mobile app.<br /><br />**Field Name:** `subscribe_mobile_app`<br />**Type:** metric                             |
| <div>Mobile App Cancel Subscription</div>           | Number of times a subscription was cancelled through the mobile app.<br /><br />**Field Name:** `cancel_subscription_mobile_app`<br />**Type:** metric              |
| <div>Mobile App Contact</div>                       | Number of contacts or inquiries made through the mobile app.<br /><br />**Field Name:** `contact_mobile_app`<br />**Type:** metric                                  |
| <div>Mobile App Donate</div>                        | Number of times a donation was made through the mobile app.<br /><br />**Field Name:** `donate_mobile_app`<br />**Type:** metric                                    |
| <div>Mobile App Find Location</div>                 | Number of times a user found your location through the mobile app.<br /><br />**Field Name:** `find_location_mobile_app`<br />**Type:** metric                      |
| <div>Mobile App Schedule</div>                      | Number of times a schedule was made through the mobile app.<br /><br />**Field Name:** `schedule_mobile_app`<br />**Type:** metric                                  |
| <div>Cost per Mobile App Install</div>              | The average cost for each mobile app install.<br /><br />**Field Name:** `cost_per_mobile_app_install`<br />**Type:** metric                                        |
| <div>Cost per Mobile App Purchase</div>             | The average cost for each mobile app purchase.<br /><br />**Field Name:** `cost_per_mobile_app_purchase`<br />**Type:** metric                                      |
| <div>Cost per Mobile App Add to Cart</div>          | The average cost for each mobile app add to cart.<br /><br />**Field Name:** `cost_per_mobile_app_add_to_cart`<br />**Type:** metric                                |
| <div>Cost per Mobile App Add to Wishlist</div>      | The average cost for each mobile app add to wishlist.<br /><br />**Field Name:** `cost_per_mobile_app_add_to_wishlist`<br />**Type:** metric                        |
| <div>Cost per Mobile App Checkout Initiated</div>   | The average cost for each mobile app checkout initiated.<br /><br />**Field Name:** `cost_per_mobile_app_checkout_initiated`<br />**Type:** metric                  |
| <div>Cost per Mobile App Content View</div>         | The average cost for each mobile app content view.<br /><br />**Field Name:** `cost_per_mobile_app_content_view`<br />**Type:** metric                              |
| <div>Cost per Mobile App Registration</div>         | The average cost for each mobile app registration completed.<br /><br />**Field Name:** `cost_per_mobile_app_registration_completed`<br />**Type:** metric          |
| <div>Cost per Mobile App Search</div>               | The average cost for each mobile app search.<br /><br />**Field Name:** `cost_per_mobile_app_search`<br />**Type:** metric                                          |
| <div>Cost per Mobile App Payment Info Add</div>     | The average cost for each mobile app payment info add.<br /><br />**Field Name:** `cost_per_mobile_app_payment_info_add`<br />**Type:** metric                      |
| <div>Cost per Mobile App Level Completed</div>      | The average cost for each mobile app level completed.<br /><br />**Field Name:** `cost_per_mobile_app_level_completed`<br />**Type:** metric                        |
| <div>Cost per Mobile App Achievement Unlocked</div> | The average cost for each mobile app achievement unlocked.<br /><br />**Field Name:** `cost_per_mobile_app_achievement_unlocked`<br />**Type:** metric              |
| <div>Cost per Mobile App Tutorial Completed</div>   | The average cost for each mobile app tutorial completed.<br /><br />**Field Name:** `cost_per_mobile_app_tutorial_completed`<br />**Type:** metric                  |
| <div>Cost per Mobile App Credit Spent</div>         | The average cost for each mobile app credit spent.<br /><br />**Field Name:** `cost_per_mobile_app_credit_spent`<br />**Type:** metric                              |
| <div>Cost per Mobile App Rating Submitted</div>     | The average cost for each mobile app rating submitted.<br /><br />**Field Name:** `cost_per_mobile_app_rating_submitted`<br />**Type:** metric                      |
| <div>Cost per Mobile App Activate</div>             | The average cost for each mobile app activation.<br /><br />**Field Name:** `cost_per_mobile_app_activate`<br />**Type:** metric                                    |
| <div>Cost per App Install</div>                     | The average cost for each app install.<br /><br />**Field Name:** `cost_per_app_install`<br />**Type:** metric                                                      |
| <div>Cost per Game Play</div>                       | The average cost for each game play.<br /><br />**Field Name:** `cost_per_game_play`<br />**Type:** metric                                                          |
| <div>Cost per Credit Spent</div>                    | The average cost for each credit spent.<br /><br />**Field Name:** `cost_per_credit_spent`<br />**Type:** metric                                                    |
| <div>Cost per App Use</div>                         | The average cost for each app use.<br /><br />**Field Name:** `cost_per_app_use`<br />**Type:** metric                                                              |
| <div>Ad Click Mobile App</div>                      | <br /><br />**Field Name:** `ad_click_mobile_app`<br />**Type:** metric                                                                                             |
| <div>Ad Impression Mobile App</div>                 | <br /><br />**Field Name:** `ad_impression_mobile_app`<br />**Type:** metric                                                                                        |
| <div>App Install</div>                              | <br /><br />**Field Name:** `app_install`<br />**Type:** metric                                                                                                     |
| <div>App Use</div>                                  | <br /><br />**Field Name:** `app_use`<br />**Type:** metric                                                                                                         |
| <div>App Credit Spent</div>                         | <br /><br />**Field Name:** `credit_spent`<br />**Type:** metric                                                                                                    |
| <div>App Games Plays</div>                          | <br /><br />**Field Name:** `games_plays`<br />**Type:** metric                                                                                                     |
| <div>Customize Product Mobile App</div>             | <br /><br />**Field Name:** `customize_product_mobile_app`<br />**Type:** metric                                                                                    |

### On-Facebook Conversions

|                                                  |                                                                                                                                                                                 |
| ------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| <div>On-Facebook Leads</div>                     | Number of potential customers who have shown interest on a Meta product: instagram, facebook.<br /><br />**Field Name:** `onsite_conversion.lead_grouped`<br />**Type:** metric |
| <div>On-Facebook Workflow Completions</div>      | Number of users who completed a flow on Meta<br /><br />**Field Name:** `onsite_conversion.flow_complete`<br />**Type:** metric                                                 |
| <div>On-Facebook Adds to Wishlist</div>          | Total number of add to whishlists made on Meta Products.<br /><br />**Field Name:** `onsite_conversion.add_to_wishlist`<br />**Type:** metric                                   |
| <div>On-Facebook Adds To Cart</div>              | Total number of add to carts made on Meta Products.<br /><br />**Field Name:** `onsite_conversion.add_to_cart`<br />**Type:** metric                                            |
| <div>On-Facebook Initiate Checkout</div>         | Total number of checkouts initiated on Meta Products.<br /><br />**Field Name:** `onsite_conversion.initiate_checkout`<br />**Type:** metric                                    |
| <div>On-Facebook Purchases</div>                 | Number of purchases made on Meta<br /><br />**Field Name:** `onsite_conversion.purchase`<br />**Type:** metric                                                                  |
| <div>On-Facebook Submit Application</div>        | Number of times an application was submitted on Meta.<br /><br />**Field Name:** `submit_application_on_facebook`<br />**Type:** metric                                         |
| <div>On-Facebook Donate</div>                    | Number of times a donation was made on Meta.<br /><br />**Field Name:** `donate_on_facebook`<br />**Type:** metric                                                              |
| <div>On-Facebook Purchase Conversion Value</div> | Total number of the purchase value from On Facebook purchases.<br /><br />**Field Name:** `onsite_conversion.purchase.value`<br />**Type:** metric                              |
| <div>Cost per On-site Purchase</div>             | The average cost for each on-site purchase.<br /><br />**Field Name:** `cost_per_onsite_purchase`<br />**Type:** metric                                                         |
| <div>Cost per On-site Add to Cart</div>          | The average cost for each on-site add to cart.<br /><br />**Field Name:** `cost_per_onsite_add_to_cart`<br />**Type:** metric                                                   |
| <div>Cost per On-site Initiate Checkout</div>    | The average cost for each on-site initiate checkout.<br /><br />**Field Name:** `cost_per_onsite_initiate_checkout`<br />**Type:** metric                                       |

### Facebook & Instagram Post

|                                     |                                                                                                                                         |
| ----------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------- |
| <div>Post Comments</div>            | Number of comments made on Instagram or Facebook posts.<br /><br />**Field Name:** `comment`<br />**Type:** metric                      |
| <div>Post Reaction</div>            | Number of reactions on Instagram or Facebook posts.<br /><br />**Field Name:** `post_reaction`<br />**Type:** metric                    |
| <div>Post Saves</div>               | Number of times an Instagram or Facebook post was saved.<br /><br />**Field Name:** `onsite_conversion.post_save`<br />**Type:** metric |
| <div>Post Shares</div>              | Number of times an Instagram or Facebook post was shared.<br /><br />**Field Name:** `post`<br />**Type:** metric                       |
| <div>Post Engagement</div>          | Number of engagements on Instagram or Facebook posts.<br /><br />**Field Name:** `post_engagement`<br />**Type:** metric                |
| <div>Cost per Page Engagement</div> | The average cost for each page engagement.<br /><br />**Field Name:** `cost_per_page_engagement`<br />**Type:** metric                  |
| <div>Cost per Post Engagement</div> | The average cost for each post engagement.<br /><br />**Field Name:** `cost_per_post_engagement`<br />**Type:** metric                  |
| <div>Cost per Page Like</div>       | The average cost for each page like.<br /><br />**Field Name:** `cost_per_page_like`<br />**Type:** metric                              |
| <div>Cost per Post Comment</div>    | The average cost for each post comment.<br /><br />**Field Name:** `cost_per_post_comment`<br />**Type:** metric                        |
| <div>Cost per Post Reaction</div>   | The average cost for each post reaction.<br /><br />**Field Name:** `cost_per_post_reaction`<br />**Type:** metric                      |
| <div>Cost per Photo View</div>      | The average cost for each photo view.<br /><br />**Field Name:** `cost_per_photo_view`<br />**Type:** metric                            |
| <div>Cost per Check-in</div>        | The average cost for each check-in.<br /><br />**Field Name:** `cost_per_checkin`<br />**Type:** metric                                 |
| <div>Like</div>                     | Number of likes on Instagram or Facebook posts<br /><br />**Field Name:** `like`<br />**Type:** metric                                  |

### Ratios

|                                              |                                                                                                                                                                                    |
| -------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| <div>CPC</div>                               | Cost Per Click - The amount you pay for each click on your ads.<br /><br />**Field Name:** `cpc`<br />**Type:** metric                                                             |
| <div>CTR</div>                               | Click Through Rate - The percentage of people who see your ad and then click on it.<br /><br />**Field Name:** `ctr`<br />**Type:** metric                                         |
| <div>CTR (Link Click)</div>                  | The percentage of times people saw your ad and performed an inline link click.<br /><br />**Field Name:** `inline_link_click_ctr`<br />**Type:** metric                            |
| <div>CPM</div>                               | Cost per 1,000 Impressions - The amount you pay for a thousand impressions of your ad.<br /><br />**Field Name:** `cpm`<br />**Type:** metric                                      |
| <div>CPM (Reach)</div>                       | Cost per 1,000 People Reached - The amount you pay for a thousand people reached.<br /><br />**Field Name:** `cpp`<br />**Type:** metric                                           |
| <div>Cost per Inline Link Click</div>        | The average cost for each inline link click.<br /><br />**Field Name:** `cost_per_inline_link_click`<br />**Type:** metric                                                         |
| <div>Cost per Unique Click</div>             | The average cost for each unique click (one click per unique person).<br /><br />**Field Name:** `cost_per_unique_click`<br />**Type:** metric                                     |
| <div>Cost per Unique Inline Link Click</div> | The average cost for each unique inline link click (one inline link click per unique person).<br /><br />**Field Name:** `cost_per_unique_inline_link_click`<br />**Type:** metric |
| <div>Cost per Outbound Click</div>           | The average cost for each outbound click (clicks that take people off Facebook-owned properties).<br /><br />**Field Name:** `cost_per_outbound_click`<br />**Type:** metric       |
| <div>Cost per Unique Outbound Click</div>    | The average cost for each unique outbound click (one outbound click per unique person).<br /><br />**Field Name:** `cost_per_unique_outbound_click`<br />**Type:** metric          |

### Return on Ad Spend

|                                     |                                                                                                                                                         |
| ----------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------- |
| <div>Overall Purchase ROAS</div>    | Return on ad spend for all purchase conversion events across website, app, and onsite.<br /><br />**Field Name:** `purchase_roas`<br />**Type:** metric |
| <div>Website Purchase ROAS</div>    | Return on ad spend for website purchase conversion events.<br /><br />**Field Name:** `website_purchase_roas`<br />**Type:** metric                     |
| <div>Mobile App Purchase ROAS</div> | Return on ad spend for mobile app purchase conversion events.<br /><br />**Field Name:** `mobile_app_purchase_roas`<br />**Type:** metric               |

### Ad Rankings

|                                    |                                                                                                                                                          |
| ---------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------- |
| <div>Quality Ranking</div>         | Indicates relative ad quality in comparison to other ads targeting the same audience.<br /><br />**Field Name:** `quality_ranking`<br />**Type:** metric |
| <div>Engagement Rate Ranking</div> | Determines the ad's likelihood to engage users in relation to competing ads.<br /><br />**Field Name:** `engagement_rate_ranking`<br />**Type:** metric  |

### Offline Metrics

|                                                   |                                                                                                        |
| ------------------------------------------------- | ------------------------------------------------------------------------------------------------------ |
| <div>Find Location Offline</div>                  | Offline App Location Searches<br /><br />**Field Name:** `find_location_offline`<br />**Type:** metric |
| <div>Subscribe Offline</div>                      | Offline Subscriptions<br /><br />**Field Name:** `subscribe_offline`<br />**Type:** metric             |
| <div>Schedule Offline</div>                       | Offline App Appointments Scheduled<br /><br />**Field Name:** `schedule_offline`<br />**Type:** metric |
| <div>Start Trial Offline</div>                    | <br /><br />**Field Name:** `start_trial_offline`<br />**Type:** metric                                |
| <div>Submit Application Offline</div>             | <br /><br />**Field Name:** `submit_application_offline`<br />**Type:** metric                         |
| <div>Recurring Subscription Payment Offline</div> | <br /><br />**Field Name:** `recurring_subscription_payment_offline`<br />**Type:** metric             |
| <div>Cancel Subscription Offline</div>            | <br /><br />**Field Name:** `cancel_subscription_offline`<br />**Type:** metric                        |
| <div>Contact Offline</div>                        | <br /><br />**Field Name:** `contact_offline`<br />**Type:** metric                                    |
| <div>Customize Product Offline</div>              | <br /><br />**Field Name:** `customize_product_offline`<br />**Type:** metric                          |

### Total Metrics

|                                                 |                                                                                                                                                        |
| ----------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------ |
| <div>Schedule Total</div>                       | Appointments scheduled<br /><br />**Field Name:** `schedule_total`<br />**Type:** metric                                                               |
| <div>Find Location Total</div>                  | Number of times a user found your store's location from your website.<br /><br />**Field Name:** `find_location_total`<br />**Type:** metric           |
| <div>Start Trial Total</div>                    | <br /><br />**Field Name:** `start_trial_total`<br />**Type:** metric                                                                                  |
| <div>Submit Application Total</div>             | <br /><br />**Field Name:** `submit_application_total`<br />**Type:** metric                                                                           |
| <div>Contact Total</div>                        | <br /><br />**Field Name:** `contact_total`<br />**Type:** metric                                                                                      |
| <div>Customize Product Total</div>              | <br /><br />**Field Name:** `customize_product_total`<br />**Type:** metric                                                                            |
| <div>Donate Total</div>                         | <br /><br />**Field Name:** `donate_total`<br />**Type:** metric                                                                                       |
| <div>Subscribe Total</div>                      | <br /><br />**Field Name:** `subscribe_total`<br />**Type:** metric                                                                                    |
| <div>Recurring Subscription Payment Total</div> | <br /><br />**Field Name:** `recurring_subscription_payment_total`<br />**Type:** metric                                                               |
| <div>Cancel Subscription Total</div>            | <br /><br />**Field Name:** `cancel_subscription_total`<br />**Type:** metric                                                                          |
| <div>Lead Total</div>                           | All offsite leads plus all On-Facebook leads<br /><br />**Field Name:** `lead`<br />**Type:** metric                                                   |
| <div>Lead Gen Grouped Total</div>               | On-Facebook leads coming from Messenger and Instant Forms<br /><br />**Field Name:** `leadgen_grouped`<br />**Type:** metric                           |
| <div>Cost per Contact Total</div>               | The average cost for each contact across all channels.<br /><br />**Field Name:** `cost_per_contact_total`<br />**Type:** metric                       |
| <div>Cost per Find Location Total</div>         | The average cost for each find location across all channels.<br /><br />**Field Name:** `cost_per_find_location_total`<br />**Type:** metric           |
| <div>Cost per Schedule Total</div>              | The average cost for each schedule across all channels.<br /><br />**Field Name:** `cost_per_schedule_total`<br />**Type:** metric                     |
| <div>Cost per Submit Application Total</div>    | The average cost for each submit application across all channels.<br /><br />**Field Name:** `cost_per_submit_application_total`<br />**Type:** metric |
| <div>Cost per Start Trial Total</div>           | The average cost for each start trial across all channels.<br /><br />**Field Name:** `cost_per_start_trial_total`<br />**Type:** metric               |
| <div>Cost per Subscribe Total</div>             | The average cost for each subscribe across all channels.<br /><br />**Field Name:** `cost_per_subscribe_total`<br />**Type:** metric                   |
| <div>Cost per Donate Total</div>                | The average cost for each donate across all channels.<br /><br />**Field Name:** `cost_per_donate_total`<br />**Type:** metric                         |
| <div>Cost per Customize Product Total</div>     | The average cost for each customize product across all channels.<br /><br />**Field Name:** `cost_per_customize_product_total`<br />**Type:** metric   |

### Click to Call

|                                               |                                                                                           |
| --------------------------------------------- | ----------------------------------------------------------------------------------------- |
| <div>Estimated Call Confirmation Clicks</div> | <br /><br />**Field Name:** `click_to_call_call_confirm`<br />**Type:** metric            |
| <div>Messenger Calls Placed</div>             | <br /><br />**Field Name:** `click_to_call_native_call_placed`<br />**Type:** metric      |
| <div>20-second Messenger Calls</div>          | <br /><br />**Field Name:** `click_to_call_native_20s_call_connect`<br />**Type:** metric |
| <div>60-second Messenger Calls</div>          | <br /><br />**Field Name:** `click_to_call_native_60s_call_connect`<br />**Type:** metric |

### Omni Channel

|                                                |                                                                                                                                                              |
| ---------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| <div>Omni App Install</div>                    | The estimated number of people who installed the app across all channels.<br /><br />**Field Name:** `omni_app_install`<br />**Type:** metric                |
| <div>Omni Purchase</div>                       | The estimated number of people who completed at least one purchase across all channels.<br /><br />**Field Name:** `omni_purchase`<br />**Type:** metric     |
| <div>Omni Add to Cart</div>                    | The estimated number of people who added items to cart across all channels.<br /><br />**Field Name:** `omni_add_to_cart`<br />**Type:** metric              |
| <div>Omni Complete Registration</div>          | The estimated number of people who completed registration across all channels.<br /><br />**Field Name:** `omni_complete_registration`<br />**Type:** metric |
| <div>Omni View Content</div>                   | The estimated number of people who viewed content across all channels.<br /><br />**Field Name:** `omni_view_content`<br />**Type:** metric                  |
| <div>Omni Search</div>                         | The estimated number of people who performed searches across all channels.<br /><br />**Field Name:** `omni_search`<br />**Type:** metric                    |
| <div>Omni Initiated Checkout</div>             | The estimated number of people who initiated checkout across all channels.<br /><br />**Field Name:** `omni_initiated_checkout`<br />**Type:** metric        |
| <div>Omni Achievement Unlocked</div>           | The estimated number of people who unlocked achievement across all channels.<br /><br />**Field Name:** `omni_achievement_unlocked`<br />**Type:** metric    |
| <div>Omni Activate App</div>                   | The estimated number of people who activated the app across all channels.<br /><br />**Field Name:** `omni_activate_app`<br />**Type:** metric               |
| <div>Omni Level Achieved</div>                 | The estimated number of people who completed level across all channels.<br /><br />**Field Name:** `omni_level_achieved`<br />**Type:** metric               |
| <div>Omni Rate</div>                           | The estimated number of people who submitted ratings across all channels.<br /><br />**Field Name:** `omni_rate`<br />**Type:** metric                       |
| <div>Omni Spend Credits</div>                  | The estimated number of people who spent credits across all channels.<br /><br />**Field Name:** `omni_spend_credits`<br />**Type:** metric                  |
| <div>Omni Tutorial Completion</div>            | The estimated number of people who completed tutorials across all channels.<br /><br />**Field Name:** `omni_tutorial_completion`<br />**Type:** metric      |
| <div>Omni Custom</div>                         | The estimated number of people who performed custom actions across all channels.<br /><br />**Field Name:** `omni_custom`<br />**Type:** metric              |
| <div>Cost per Omni Purchase</div>              | The average cost for each omni purchase.<br /><br />**Field Name:** `cost_per_omni_purchase`<br />**Type:** metric                                           |
| <div>Cost per Omni Add to Cart</div>           | The average cost for each omni add to cart.<br /><br />**Field Name:** `cost_per_omni_add_to_cart`<br />**Type:** metric                                     |
| <div>Cost per Omni View Content</div>          | The average cost for each omni view content.<br /><br />**Field Name:** `cost_per_omni_view_content`<br />**Type:** metric                                   |
| <div>Cost per Omni Complete Registration</div> | The average cost for each omni complete registration.<br /><br />**Field Name:** `cost_per_omni_complete_registration`<br />**Type:** metric                 |
| <div>Cost per Omni Search</div>                | The average cost for each omni search.<br /><br />**Field Name:** `cost_per_omni_search`<br />**Type:** metric                                               |
| <div>Cost per Omni Initiate Checkout</div>     | The average cost for each omni initiate checkout.<br /><br />**Field Name:** `cost_per_omni_initiated_checkout`<br />**Type:** metric                        |
| <div>Cost per Omni App Install</div>           | The average cost for each omni app install.<br /><br />**Field Name:** `cost_per_omni_app_install`<br />**Type:** metric                                     |

### Clicks

|                                      |                                                                                                                                                                        |
| ------------------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| <div>Unique Clicks</div>             | The number of unique people who clicked on your ads. This metric is estimated.<br /><br />**Field Name:** `unique_clicks`<br />**Type:** metric                        |
| <div>Unique Inline Link Clicks</div> | The number of unique people who performed an inline link click. This metric is estimated.<br /><br />**Field Name:** `unique_inline_link_clicks`<br />**Type:** metric |
| <div>Outbound Clicks</div>           | The number of clicks on links that take people off Facebook-owned properties.<br /><br />**Field Name:** `outbound_clicks`<br />**Type:** metric                       |
| <div>Unique Outbound Clicks</div>    | The number of unique people who performed an outbound click. This metric is estimated.<br /><br />**Field Name:** `unique_outbound_clicks`<br />**Type:** metric       |

### Instagram

|                                   |                                                                                                                                                                                          |
| --------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| <div>Inline Post Engagement</div> | The total number of actions that people take involving your ads (including likes, comments, shares, and more).<br /><br />**Field Name:** `inline_post_engagement`<br />**Type:** metric |

### Other

|                                   |                                                                                                                                                                                                      |
| --------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| <div>Social Spend</div>           | The amount spent on ads shown with social information, such as when someone engages with your ad and this is shown to their friends.<br /><br />**Field Name:** `social_spend`<br />**Type:** metric |
| <div>Page Engagement</div>        | <br /><br />**Field Name:** `page_engagement`<br />**Type:** metric                                                                                                                                  |
| <div>Check-in</div>               | <br /><br />**Field Name:** `checkin`<br />**Type:** metric                                                                                                                                          |
| <div>Page Photo Views</div>       | <br /><br />**Field Name:** `photo_view`<br />**Type:** metric                                                                                                                                       |
| <div>Event Responses (RSVP)</div> | <br /><br />**Field Name:** `rsvp`<br />**Type:** metric                                                                                                                                             |

***

## Related

<CardGroup>
  <Card title="Fields Catalog" icon="book" href="/fields-catalog">
    Browse all platforms
  </Card>

  <Card title="Google Ads Fields" icon="chart-bar" href="/data-source/google-ads/fields">
    Google Ads metrics & dimensions
  </Card>

  <Card title="TikTok Ads Fields" icon="chart-bar" href="/data-source/tiktok-ads/fields">
    TikTok Ads metrics & dimensions
  </Card>

  <Card title="LinkedIn Ads Fields" icon="chart-bar" href="/data-source/linkedin-ads/fields">
    LinkedIn Ads metrics & dimensions
  </Card>
</CardGroup>


# Facebook Ads (Meta Ads) Troubleshooting
Source: https://support.detrics.io/data-source/facebook-ads/troubleshooting

Complete troubleshooting guide for Facebook Ads integration

<Info>**Last updated:** August 11, 2025</Info>

Having trouble connecting your Facebook Ads account to Detrics? This comprehensive guide will help you diagnose and resolve the most common connection issues.

## Understanding Facebook Access Expiration

Access to Facebook can expire for various reasons. These are the most common causes of connection issues:

<CardGroup>
  <Card title="Password Changes" icon="key">
    Changing your Facebook password automatically revokes access tokens for
    connected third-party applications.
  </Card>

  <Card title="Meta Security Reviews" icon="shield">
    Meta may revoke access during routine security reviews, especially for
    recently connected applications like Detrics.
  </Card>

  <Card title="Token Expiration" icon="clock">
    Access tokens have built-in expiration dates and need periodic renewal to
    maintain connection.
  </Card>
</CardGroup>

**Solution:** When access expires, you'll need to **reconnect your Facebook Ads account to Detrics** through the connection setup process. This re-establishes the authentication and renews the access tokens.

**Important:** Once you reconnect Meta Ads, all your existing queries and Looker Studio dashboards linked to your Meta accounts will automatically start working again. The reconnection process fixes all connections at once - you don't need to recreate your queries or dashboards.

## Fix Persistent Connection Issues (Full Reset)

If reconnecting doesn't resolve your issues, follow these steps for a complete reset. This will fix all your Meta Ads queries and dashboards at once.

<Steps>
  <Step title="Remove Facebook App Connection">
    Go to [Facebook Business Tools
    Settings](https://www.facebook.com/settings?tab=business_tools) and click on
    "Remove" next to the Detrics app.

    <img alt="Facebook Business Tools - Remove Detrics App" />
  </Step>

  <Step title="Open Google Sheets">
    Open a new Google Spreadsheet or [click here](https://sheets.new) to create a
    new sheet directly.
  </Step>

  <Step title="Launch Detrics">
    Fire up Detrics: Select *Extensions* > *Detrics* > *Launch*

    <img alt="Google Sheets Extensions Menu - Detrics Launch" />
  </Step>

  <Step title="Connect Data Source">
    Click on *"Connect Data Source"*

    <img alt="Detrics Connect Data Source Button" />
  </Step>

  <Step title="Reconnect Facebook Ads">
    Select Facebook Ads and complete the reconnection process to re-establish
    access.

    <img alt="Detrics Facebook Ads Reconnection" />
  </Step>
</Steps>

## Shared Connection Between Google Sheets and Looker Studio

Google Sheets and Looker Studio share the same Meta Ads connection. This means:

* **Single reconnection fixes both platforms:** When you reconnect Meta Ads through Google Sheets, your Looker Studio dashboards are automatically fixed too
* **No duplicate setup needed:** You only need to reconnect once, regardless of which platform you primarily use

### Alternative: Reconnect Through Looker Studio

Looker Studio users can also reconnect Meta Ads directly through Looker Studio:

1. Open your Looker Studio dashboard that uses Meta Ads data
2. Click on any chart showing connection errors
3. Select "Reconnect" when prompted
4. Complete the Meta Ads authentication process
5. All your Meta Ads queries in both Looker Studio and Google Sheets will be restored

<Tip>
  **Need help?** If errors persist after following these steps, please reach out
  to [support@detrics.io](mailto:support@detrics.io)
</Tip>

## Meta Server Instability

### Understanding Meta's API Limitations

<Warning>
  **Error message:** "⚠️ Meta servers are experiencing high load"
</Warning>

Meta's API can become unstable when processing certain types of data requests, particularly:

**Large Data Requests:**

* **Ad-level data** with extensive timeframes
* **Hourly or daily aggregations** over long periods
* **Multiple accounts** with detailed breakdowns

### Quick Solutions

When you encounter this error, try these solutions in order:

<Steps>
  <Step title="Reduce Timeframe">
    **Start with a smaller date range:**

    * Instead of 6 months, try 1 month
    * For hourly data, limit to 7 days
    * For daily data, limit to 30 days
  </Step>

  <Step title="Switch to Campaign Level">
    **Use higher-level aggregations:**

    * Campaign level instead of Ad level
    * Ad Set level instead of Ad level
    * This significantly reduces API load
  </Step>

  <Step title="Change Time Aggregation">
    **Adjust your time grouping:**

    * Switch from "Hourly" to "Daily"
    * Switch from "Daily" to "All Time"
    * Use "Weekly" or "Monthly" for long timeframes
  </Step>

  <Step title="Split Your Query">
    **For large datasets, create multiple queries:**

    * Split by date ranges (e.g., monthly queries)
    * Split by account (one account per query)
    * Combine results afterward in your spreadsheet
  </Step>
</Steps>

<Info>
  **Still having issues?** If none of these solutions work, please try again in a few hours. These server instability issues typically last from a few hours to 24-48 hours in the most extreme cases.
</Info>

### Why This Happens

Meta's API has several limitations that can trigger this error:

| Factor                        | Impact                                                                              | Solution                                                                                           |
| ----------------------------- | ----------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------- |
| **Random Meta instability**   | Meta's servers occasionally fail to process requests regardless of query complexity | Wait and retry in a few hours                                                                      |
| **Ad-level complexity**       | Each ad requires multiple API calls                                                 | Use Campaign or Ad Set level                                                                       |
| **Long timeframes**           | Exponentially more data to process                                                  | Limit to 30-90 days                                                                                |
| **Granular time aggregation** | Hourly/daily creates more data points                                               | Use weekly/monthly for long periods                                                                |
| **Multiple breakdowns**       | Each dimension multiplies data volume                                               | Reduce dimensions temporarily (e.g., age, gender, country, platform position, publisher platforms) |

### Best Practices to Avoid This Error

To avoid encountering this instability, we recommend implementing a **Historical + Dynamic sheet strategy**:

#### The 3-Sheet Strategy

Set up three sheets to separate your data:

1. **"Meta Ads Combined"** - Your main reporting sheet with all data
2. **"Meta Ads Dynamic"** - Recent data that updates daily
3. **"Meta Ads Historical"** - Archived data that doesn't change

#### How to Implement This Strategy

<Steps>
  <Step title="Create Your Historical Sheet">
    Export all your historical data (e.g., all 2024 data and 2025 data up to the previous month) to the "Meta Ads Historical" sheet. This data is "golden" - it won't change because Meta's longest attribution window is 28 days.
  </Step>

  <Step title="Set Up Your Dynamic Query">
    Create a smaller query in "Meta Ads Dynamic" that only pulls recent data (from
    the previous month onwards). This smaller timeframe rarely triggers Meta's
    instability errors.
  </Step>

  <Step title="Combine Both Sheets">
    In your "Meta Ads Combined" sheet, use this formula to merge both datasets:

    ```
    =QUERY({
      'Meta Ads Historical'!A2:Z;
      'Meta Ads Dynamic'!A2:Z
    }, "SELECT * WHERE Col1 is not null", 0)
    ```

    This gives you complete data without the load issues.
  </Step>

  <Step title="Maintain Your Setup">
    Every 6 months, or when you notice instability errors becoming more frequent, move older data from Dynamic to Historical. This keeps your dynamic query small and fast.
  </Step>
</Steps>

<Tip>
  **Example:** If you have a 2-year ad-level daily query that fails:

  * Historical sheet: All data up to June 2025
  * Dynamic sheet: July 2025 onwards
  * Combined sheet: Merges both for complete reporting

  When you encounter issues again in 1-2 years, simply repeat this optimization process.
</Tip>

<Tip>
  **Need help implementing the 3-sheet strategy?** Our support team can guide
  you through the setup process and help optimize your Meta Ads queries for
  maximum stability. Reach out to [support@detrics.io](mailto:support@detrics.io) with your specific use case
  and we'll provide personalized recommendations.
</Tip>


# Facebook Insights Metrics & Dimensions
Source: https://support.detrics.io/data-source/facebook-insights/fields

Complete reference for Facebook Page Insights dimensions and metrics

<Info>
  **Last updated:** August 6, 2026
</Info>

<div>
  <div>
    44 dimensions
  </div>

  <div>
    69 metrics
  </div>
</div>

This reference covers all available dimensions and metrics for Facebook Insights data through Detrics. Use this guide to understand what data you can extract and how to structure your queries.

<div>
  <span>Supported destinations:</span>

  <div>
    Google Sheets
  </div>

  <div>
    Looker Studio
  </div>

  <div>
    Claude
  </div>

  <div>
    BigQuery
  </div>
</div>

## Dimensions

Dimensions are the attributes you can use to segment and group your Facebook Insights data.

### Page

|                              |                                                                                                         |
| ---------------------------- | ------------------------------------------------------------------------------------------------------- |
| <div>Page ID</div>           | The unique identifier of the page<br /><br />**Field Name:** `pageId`<br />**Type:** dimension          |
| <div>Page Name</div>         | The name of the page<br /><br />**Field Name:** `pageName`<br />**Type:** dimension                     |
| <div>Page Link</div>         | The URL link to the page<br /><br />**Field Name:** `pageLink`<br />**Type:** dimension                 |
| <div>Page Category</div>     | The category of the page<br /><br />**Field Name:** `pageCategory`<br />**Type:** dimension             |
| <div>Page Description</div>  | The description of the page<br /><br />**Field Name:** `pageDescription`<br />**Type:** dimension       |
| <div>Page About</div>        | The about section of the page<br /><br />**Field Name:** `pageAbout`<br />**Type:** dimension           |
| <div>Page Phone</div>        | The phone number of the page<br /><br />**Field Name:** `pagePhone`<br />**Type:** dimension            |
| <div>Page Website</div>      | The website URL of the page<br /><br />**Field Name:** `pageWebsite`<br />**Type:** dimension           |
| <div>Page Hours</div>        | The business hours of the page<br /><br />**Field Name:** `pageHours`<br />**Type:** dimension          |
| <div>Page City</div>         | The city where the page is located<br /><br />**Field Name:** `pageCity`<br />**Type:** dimension       |
| <div>Page Country</div>      | The country where the page is located<br /><br />**Field Name:** `pageCountry`<br />**Type:** dimension |
| <div>Page Emails</div>       | The email addresses of the page<br /><br />**Field Name:** `pageEmails`<br />**Type:** dimension        |
| <div>Page Picture</div>      | The profile picture URL of the page<br /><br />**Field Name:** `pagePicture`<br />**Type:** dimension   |
| <div>Page Is Published</div> | Whether the page is published<br /><br />**Field Name:** `pageIsPublished`<br />**Type:** dimension     |

### Post

|                                        |                                                                                                                                                                                   |
| -------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| <div>Post ID</div>                     | The unique identifier of the post<br /><br />**Field Name:** `postId`<br />**Type:** dimension                                                                                    |
| <div>Post Message</div>                | The message content of the post<br /><br />**Field Name:** `postMessage`<br />**Type:** dimension                                                                                 |
| <div>Post Created Time</div>           | The time the post was created<br /><br />**Field Name:** `postCreatedTime`<br />**Type:** dimension                                                                               |
| <div>Post Permalink URL</div>          | The permanent link URL to the post<br /><br />**Field Name:** `postPermalinkUrl`<br />**Type:** dimension                                                                         |
| <div>Post Status Type</div>            | The type of status update (e.g. mobile\_status\_update, added\_photos, added\_video)<br /><br />**Field Name:** `postStatusType`<br />**Type:** dimension                         |
| <div>Post Author Name</div>            | The name of the user or page that created the post<br /><br />**Field Name:** `postFromName`<br />**Type:** dimension                                                             |
| <div>Post Author ID</div>              | The ID of the user or page that created the post<br /><br />**Field Name:** `postFromId`<br />**Type:** dimension                                                                 |
| <div>Post Full Picture URL</div>       | The full-sized picture URL attached to the post<br /><br />**Field Name:** `postFullPicture`<br />**Type:** dimension                                                             |
| <div>Post Attachment Type</div>        | The type of attachment (e.g. photo, video, link)<br /><br />**Field Name:** `postAttachmentType`<br />**Type:** dimension                                                         |
| <div>Post Attachment URL</div>         | The URL of the attachment<br /><br />**Field Name:** `postAttachmentUrl`<br />**Type:** dimension                                                                                 |
| <div>Post Attachment Description</div> | The description of the attachment<br /><br />**Field Name:** `postAttachmentDescription`<br />**Type:** dimension                                                                 |
| <div>Media Product Type</div>          | The type of content: REEL, PHOTO, ALBUM, or VIDEO. Derived from the post permalink and attachment type<br /><br />**Field Name:** `postMediaProductType`<br />**Type:** dimension |
| <div>Post Video ID</div>               | The video ID for video posts. Empty for non-video posts. Use this to join with video-level data<br /><br />**Field Name:** `postVideoId`<br />**Type:** dimension                 |
| <div>Post Is Published</div>           | Whether the post is published<br /><br />**Field Name:** `postIsPublished`<br />**Type:** dimension                                                                               |
| <div>Post Is Hidden</div>              | Whether the post is hidden from timeline<br /><br />**Field Name:** `postIsHidden`<br />**Type:** dimension                                                                       |
| <div>Post Is Expired</div>             | Whether the post has expired<br /><br />**Field Name:** `postIsExpired`<br />**Type:** dimension                                                                                  |

### Post Comment

|                           |                                                                                                          |
| ------------------------- | -------------------------------------------------------------------------------------------------------- |
| <div>Comment ID</div>     | The unique identifier of the comment<br /><br />**Field Name:** `postCommentId`<br />**Type:** dimension |
| <div>Comment Text</div>   | The comment text<br /><br />**Field Name:** `postCommentText`<br />**Type:** dimension                   |
| <div>Comment Author</div> | Author of the comment<br /><br />**Field Name:** `postCommentAuthor`<br />**Type:** dimension            |
| <div>Comment Date</div>   | Date of the comment<br /><br />**Field Name:** `postCommentDate`<br />**Type:** dimension                |
| <div>Comment Time</div>   | Time of the comment<br /><br />**Field Name:** `postCommentTime`<br />**Type:** dimension                |

### Followers Demographics

|                              |                                                                                                                                                                                                |
| ---------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| <div>Followers City</div>    | City where followers are located. Auto-added when using the Followers Count by City metric<br /><br />**Field Name:** `followersCity`<br />**Type:** dimension                                 |
| <div>Followers Country</div> | Country code where followers are located (e.g. AR, US, BR). Auto-added when using the Followers Count by Country metric<br /><br />**Field Name:** `followersCountry`<br />**Type:** dimension |

### Lead

|                              |                                                                                                            |
| ---------------------------- | ---------------------------------------------------------------------------------------------------------- |
| <div>Lead ID</div>           | The unique identifier of the lead<br /><br />**Field Name:** `leadId`<br />**Type:** dimension             |
| <div>Form ID</div>           | The ID of the lead form<br /><br />**Field Name:** `formId`<br />**Type:** dimension                       |
| <div>Form Name</div>         | The name of the lead form<br /><br />**Field Name:** `formName`<br />**Type:** dimension                   |
| <div>Lead Created Time</div> | The time the lead was created<br /><br />**Field Name:** `leadCreatedTime`<br />**Type:** dimension        |
| <div>Lead Ad ID</div>        | The ID of the ad that generated the lead<br /><br />**Field Name:** `leadAdId`<br />**Type:** dimension    |
| <div>Lead Field Name</div>   | The field name from the lead form<br /><br />**Field Name:** `leadName`<br />**Type:** dimension           |
| <div>Lead Field Value</div>  | The field value submitted in the lead form<br /><br />**Field Name:** `leadValue`<br />**Type:** dimension |

## Metrics

Metrics are the numerical values you can measure and analyze from your Facebook Insights campaigns.

### Page Posts

|                                         |                                                                                                                                                                                |
| --------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| <div>Organic Impressions of Posts</div> | The number of times your Page's posts entered a person's screen through organic distribution<br /><br />**Field Name:** `page_posts_impressions_organic`<br />**Type:** metric |

### Page Engagement

|                                  |                                                                                                                                                                              |
| -------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| <div>Page Post Engagements</div> | The number of times people have engaged with your posts through likes, comments and shares and more<br /><br />**Field Name:** `page_post_engagements`<br />**Type:** metric |

### Page

|                           |                                                                                                                                                                                                                    |
| ------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| <div>Page Fan Count</div> | The number of fans (likes) on the page. Returns a single snapshot of the current count. For historical daily tracking, use Page Followers instead<br /><br />**Field Name:** `pageFanCount`<br />**Type:** metric  |
| <div>Page Followers</div> | The total number of followers of your Facebook Page (follows minus unfollows). Available as a daily time series to track follower growth over time<br /><br />**Field Name:** `page_follows`<br />**Type:** metric |

### Page Views

|                                           |                                                                                                                                                                                                                                                                                                            |
| ----------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| <div>Page Visits</div>                    | The number of times a Page's profile has been viewed by logged in and logged out people<br /><br />**Field Name:** `page_views_total`<br />**Type:** metric                                                                                                                                                |
| <div>Page Media Views</div>               | The number of times your content was played or displayed. Content includes videos, posts, stories and ads<br /><br />**Field Name:** `page_media_view`<br />**Type:** metric                                                                                                                               |
| <div>Page Media Views Paid</div>          | The number times paid distribution such as ads promoting your page was played or displayed<br /><br />**Field Name:** `page_media_view_paid`<br />**Type:** metric                                                                                                                                         |
| <div>Page Media Views Organic</div>       | The number of times your organic content was played or displayed. Content includes videos, posts, stories<br /><br />**Field Name:** `page_media_view_organic`<br />**Type:** metric                                                                                                                       |
| <div>Page Media Views Followers</div>     | The number of times your content was played by or displayed to page followers<br /><br />**Field Name:** `page_media_view_followers`<br />**Type:** metric                                                                                                                                                 |
| <div>Page Media Views Non-Followers</div> | The number of times your content was played by or displayed to non-followers<br /><br />**Field Name:** `page_media_view_non_followers`<br />**Type:** metric                                                                                                                                              |
| <div>Page Media Viewers</div>             | The number of unique people who viewed any content from your Page. Meta's successor to the deprecated Reach metric — values may differ slightly from historical Reach as counting is now based on views rendered on screen<br /><br />**Field Name:** `page_total_media_view_unique`<br />**Type:** metric |

### Followers Demographics

|                                       |                                                                                                                                                                                                            |
| ------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| <div>Followers Count by City</div>    | Lifetime follower count broken down by city. Each city becomes a separate row with the followersCity dimension auto-added<br /><br />**Field Name:** `page_follows_city`<br />**Type:** metric             |
| <div>Followers Count by Country</div> | Lifetime follower count broken down by country. Each country becomes a separate row with the followersCountry dimension auto-added<br /><br />**Field Name:** `page_follows_country`<br />**Type:** metric |

### Page Reactions

|                                  |                                                                                                                                         |
| -------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------- |
| <div>Page Reactions: Like</div>  | Daily total post "like" reactions of a page<br /><br />**Field Name:** `page_actions_post_reactions_like_total`<br />**Type:** metric   |
| <div>Page Reactions: Love</div>  | Daily total post "love" reactions of a page<br /><br />**Field Name:** `page_actions_post_reactions_love_total`<br />**Type:** metric   |
| <div>Page Reactions: Wow</div>   | Daily total post "wow" reactions of a page<br /><br />**Field Name:** `page_actions_post_reactions_wow_total`<br />**Type:** metric     |
| <div>Page Reactions: Haha</div>  | Daily total post "haha" reactions of a page<br /><br />**Field Name:** `page_actions_post_reactions_haha_total`<br />**Type:** metric   |
| <div>Page Reactions: Sorry</div> | Daily total post "sorry" reactions of a page<br /><br />**Field Name:** `page_actions_post_reactions_sorry_total`<br />**Type:** metric |
| <div>Page Reactions: Anger</div> | Daily total post "anger" reactions of a page<br /><br />**Field Name:** `page_actions_post_reactions_anger_total`<br />**Type:** metric |

### Page Video

|                                        |                                                                                                                                                                           |
| -------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| <div>Total Video Views</div>           | Total number of times page's videos have been viewed for more than 3 seconds<br /><br />**Field Name:** `page_video_views`<br />**Type:** metric                          |
| <div>Unique Video Views</div>          | Total number of times page's videos have been played for unique people for more than 3 seconds<br /><br />**Field Name:** `page_video_views_unique`<br />**Type:** metric |
| <div>Organic Video Views</div>         | Total number of times page's videos have been viewed for more than 3 seconds by organic reach<br /><br />**Field Name:** `page_video_views_organic`<br />**Type:** metric |
| <div>Paid Video Views</div>            | Total number of times page's promoted videos have been viewed for more than 3 seconds<br /><br />**Field Name:** `page_video_views_paid`<br />**Type:** metric            |
| <div>Auto-Played Video Views</div>     | The number of times your videos automatically played for at least 3 seconds<br /><br />**Field Name:** `page_video_views_autoplayed`<br />**Type:** metric                |
| <div>Clicked to Play Video Views</div> | The number of times your videos played for at least 3 seconds after people clicked play<br /><br />**Field Name:** `page_video_views_click_to_play`<br />**Type:** metric |

### Page Video 30s

|                                            |                                                                                                                                                                                                |
| ------------------------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| <div>Total 30s Video Views</div>           | Total number of times page's videos have been viewed for more than 30 seconds<br /><br />**Field Name:** `page_video_complete_views_30s`<br />**Type:** metric                                 |
| <div>Unique 30s Video Views</div>          | The number of people who viewed your Page's videos for at least 30 seconds<br /><br />**Field Name:** `page_video_complete_views_30s_unique`<br />**Type:** metric                             |
| <div>Organic 30s Video Views</div>         | The number of times your Page's videos played for at least 30 seconds by organic reach<br /><br />**Field Name:** `page_video_complete_views_30s_organic`<br />**Type:** metric                |
| <div>Paid 30s Video Views</div>            | The number of times your Page's promoted videos played for at least 30 seconds<br /><br />**Field Name:** `page_video_complete_views_30s_paid`<br />**Type:** metric                           |
| <div>Auto-Played 30s Video Views</div>     | The number of times your Page's automatically played videos played for at least 30 seconds<br /><br />**Field Name:** `page_video_complete_views_30s_autoplayed`<br />**Type:** metric         |
| <div>Clicked to Play 30s Video Views</div> | The number of times your Page's videos played for at least 30 seconds after people clicked play<br /><br />**Field Name:** `page_video_complete_views_30s_click_to_play`<br />**Type:** metric |

### Messaging

|                                                  |                                                                                                                                                                                                                                           |
| ------------------------------------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| <div>New Conversations (Unique)</div>            | The number of messaging conversations on Facebook Messenger that began with people who had never messaged with your business before<br /><br />**Field Name:** `page_messages_new_conversations_unique`<br />**Type:** metric             |
| <div>Blocked Conversations Count (Unique)</div>  | The number of conversations with the Page that have been blocked<br /><br />**Field Name:** `page_messages_blocked_conversations_unique`<br />**Type:** metric                                                                            |
| <div>Reported Conversations Count (Unique)</div> | The number of conversations from your Page that have been reported by people for reasons such as spam, or containing inappropriate content<br /><br />**Field Name:** `page_messages_reported_conversations_unique`<br />**Type:** metric |

### Post Actions

|                              |                                                                                                                                                        |
| ---------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------ |
| <div>Post Total Clicks</div> | The number of times people clicked on anywhere in your posts without generating a story<br /><br />**Field Name:** `post_clicks`<br />**Type:** metric |
| <div>Post Link Clicks</div>  | The number of link clicks on the post from post\_clicks\_by\_type<br /><br />**Field Name:** `postLinkClicks`<br />**Type:** metric                    |
| <div>Post Other Clicks</div> | The number of other clicks on the post from post\_clicks\_by\_type<br /><br />**Field Name:** `postOtherClicks`<br />**Type:** metric                  |
| <div>Post Photo Views</div>  | The number of photo views on the post from post\_clicks\_by\_type<br /><br />**Field Name:** `postPhotoViews`<br />**Type:** metric                    |
| <div>Likes on Post</div>     | The number of likes on the post from post\_activity\_by\_action\_type<br /><br />**Field Name:** `postLikesOnPost`<br />**Type:** metric               |
| <div>Comments on Post</div>  | The number of comments on the post from post\_activity\_by\_action\_type<br /><br />**Field Name:** `postCommentsOnPost`<br />**Type:** metric         |
| <div>Shares on Post</div>    | The number of shares on the post from post\_activity\_by\_action\_type<br /><br />**Field Name:** `postSharesOnPost`<br />**Type:** metric             |

### Post Reactions

|                                     |                                                                                                               |
| ----------------------------------- | ------------------------------------------------------------------------------------------------------------- |
| <div>Total Post Reactions</div>     | Total post reactions by type<br /><br />**Field Name:** `postReactionsTotal`<br />**Type:** metric            |
| <div>Total Post Comments</div>      | Total comments on the post<br /><br />**Field Name:** `postCommentsTotal`<br />**Type:** metric               |
| <div>Post Reactions: Like</div>     | Total "like" reactions of a post<br /><br />**Field Name:** `postReactionsLike`<br />**Type:** metric         |
| <div>Post Reactions: Love</div>     | Total "love" reactions of a post<br /><br />**Field Name:** `postReactionsLove`<br />**Type:** metric         |
| <div>Post Reactions: Wow</div>      | Total "wow" reactions of a post<br /><br />**Field Name:** `postReactionsWow`<br />**Type:** metric           |
| <div>Post Reactions: Haha</div>     | Total "haha" reactions of a post<br /><br />**Field Name:** `postReactionsHaha`<br />**Type:** metric         |
| <div>Post Reactions: Sad</div>      | Total "sad" reactions of a post<br /><br />**Field Name:** `postReactionsSad`<br />**Type:** metric           |
| <div>Post Reactions: Angry</div>    | Total "angry" reactions of a post<br /><br />**Field Name:** `postReactionsAngry`<br />**Type:** metric       |
| <div>Post Reactions: Thankful</div> | Total "thankful" reactions of a post<br /><br />**Field Name:** `postReactionsThankful`<br />**Type:** metric |
| <div>Post Reactions: Pride</div>    | Total "pride" reactions of a post<br /><br />**Field Name:** `postReactionsPride`<br />**Type:** metric       |
| <div>Post Reactions: Care</div>     | Total "care" reactions of a post<br /><br />**Field Name:** `postReactionsCare`<br />**Type:** metric         |

### Post Views

|                               |                                                                                                                                                                                                 |
| ----------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| <div>Post Media Viewers</div> | The number of unique people who viewed media on this post. Meta's successor to the deprecated Post Reach metric<br /><br />**Field Name:** `post_total_media_view_unique`<br />**Type:** metric |

### Post Video

|                                                |                                                                                                                                                                                                                               |
| ---------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| <div>Total Post Video Views</div>              | The number of times your video was viewed for 3 seconds or more<br /><br />**Field Name:** `post_video_views`<br />**Type:** metric                                                                                           |
| <div>Organic Post Video Views</div>            | The number of times your video was viewed for 3 seconds or more by organic reach<br /><br />**Field Name:** `post_video_views_organic`<br />**Type:** metric                                                                  |
| <div>Paid Post Video Views</div>               | The number of times your promoted video was viewed for 3 seconds or more<br /><br />**Field Name:** `post_video_views_paid`<br />**Type:** metric                                                                             |
| <div>Unique Post Video Views</div>             | The number of unique people who viewed your video for 3 seconds or more<br /><br />**Field Name:** `post_video_views_unique`<br />**Type:** metric                                                                            |
| <div>Autoplayed Post Video Views</div>         | The number of times your video was auto-played and viewed for 3 seconds or more<br /><br />**Field Name:** `post_video_views_autoplayed`<br />**Type:** metric                                                                |
| <div>Clicked-to-Play Post Video Views</div>    | The number of times a user clicked to play your video and viewed it for 3 seconds or more<br /><br />**Field Name:** `post_video_views_clicked_to_play`<br />**Type:** metric                                                 |
| <div>Organic Complete Video Views</div>        | The number of times your videos played from the beginning to 95%, or more, of its length, by organic reach<br /><br />**Field Name:** `post_video_complete_views_organic`<br />**Type:** metric                               |
| <div>Unique Organic Complete Video Views</div> | The number of people who viewed your videos from the beginning to 95%, or more, of its length, by organic reach<br /><br />**Field Name:** `post_video_complete_views_organic_unique`<br />**Type:** metric                   |
| <div>Paid Complete Video Views</div>           | The number of times your promoted videos played from the beginning to 95%, or more, of its length<br /><br />**Field Name:** `post_video_complete_views_paid`<br />**Type:** metric                                           |
| <div>Unique Paid Complete Video Views</div>    | The number of people who viewed your promoted videos from the beginning to 95%, or more, of its length<br /><br />**Field Name:** `post_video_complete_views_paid_unique`<br />**Type:** metric                               |
| <div>Total Video Views with Sound On</div>     | Number of times your video was viewed with sound on for 3 seconds or viewed to the end, whichever happened first<br /><br />**Field Name:** `post_video_views_sound_on`<br />**Type:** metric                                 |
| <div>Organic Video View Time (s)</div>         | The total time, in milliseconds, your videos played by organic reach. Returns 0 for reshared videos<br /><br />**Field Name:** `post_video_view_time_organic`<br />**Type:** metric                                           |
| <div>Paid Video View Time (s)</div>            | The number of times your promoted videos played for at least 3 seconds, or for nearly their total length if they are shorter than 3 seconds<br /><br />**Field Name:** `post_video_view_time_paid`<br />**Type:** metric      |
| <div>Total 60s Video Views</div>               | The number of times your videos played for at least 60 seconds. This metric is counted only for videos that are 60 seconds or longer<br /><br />**Field Name:** `post_video_views_60s_excludes_shorter`<br />**Type:** metric |
| <div>Total 15s Video Views</div>               | The number of times your videos played for at least 15 seconds, or for nearly their total length if they are shorter than 15 seconds<br /><br />**Field Name:** `post_video_views_15s`<br />**Type:** metric                  |

### Lead

|                             |                                                                                                             |
| --------------------------- | ----------------------------------------------------------------------------------------------------------- |
| <div>Form Leads Count</div> | The number of leads collected by the form<br /><br />**Field Name:** `formLeadsCount`<br />**Type:** metric |

***

## Related

<CardGroup>
  <Card title="Fields Catalog" icon="book" href="/fields-catalog">
    Browse all platforms
  </Card>

  <Card title="Instagram Insights Fields" icon="chart-bar" href="/data-source/instagram-insights/fields">
    Instagram Insights metrics & dimensions
  </Card>

  <Card title="Facebook Public Data Fields" icon="chart-bar" href="/data-source/facebook-public-data/fields">
    Facebook Public Data metrics & dimensions
  </Card>

  <Card title="TikTok Organic Fields" icon="chart-bar" href="/data-source/tiktok-organic/fields">
    TikTok Organic metrics & dimensions
  </Card>
</CardGroup>


# Facebook Public Data Metrics & Dimensions
Source: https://support.detrics.io/data-source/facebook-public-data/fields

Complete reference for Facebook Public Data dimensions and metrics

<Info>
  **Last updated:** August 6, 2026
</Info>

<div>
  <div>
    41 dimensions
  </div>

  <div>
    21 metrics
  </div>
</div>

This reference covers all available dimensions and metrics for Facebook Public Data data through Detrics. Use this guide to understand what data you can extract and how to structure your queries.

<div>
  <span>Supported destinations:</span>

  <div>
    Google Sheets
  </div>

  <div>
    Claude
  </div>

  <div>
    BigQuery
  </div>
</div>

## Dimensions

Dimensions are the attributes you can use to segment and group your Facebook Public Data data.

### Page

|                        |                                                                                                        |
| ---------------------- | ------------------------------------------------------------------------------------------------------ |
| <div>Page Name</div>   | The name of the Facebook Page<br /><br />**Field Name:** `pageName`<br />**Type:** dimension           |
| <div>Description</div> | The description of the Facebook Page<br /><br />**Field Name:** `description`<br />**Type:** dimension |
| <div>Page Link</div>   | The direct link to the Facebook Page<br /><br />**Field Name:** `link`<br />**Type:** dimension        |

### Page Info

|                             |                                                                                                                            |
| --------------------------- | -------------------------------------------------------------------------------------------------------------------------- |
| <div>Username</div>         | The username (vanity URL) of the Facebook Page<br /><br />**Field Name:** `username`<br />**Type:** dimension              |
| <div>Category</div>         | The category of the Facebook Page<br /><br />**Field Name:** `category`<br />**Type:** dimension                           |
| <div>About</div>            | The about section of the Facebook Page<br /><br />**Field Name:** `about`<br />**Type:** dimension                         |
| <div>Website</div>          | The website URL listed on the Facebook Page<br /><br />**Field Name:** `website`<br />**Type:** dimension                  |
| <div>Page ID</div>          | The unique identifier of the Facebook Page<br /><br />**Field Name:** `pageId`<br />**Type:** dimension                    |
| <div>Founded</div>          | The year the business/organization was founded<br /><br />**Field Name:** `founded`<br />**Type:** dimension               |
| <div>Mission</div>          | The mission statement of the Facebook Page<br /><br />**Field Name:** `mission`<br />**Type:** dimension                   |
| <div>Company Overview</div> | Company overview text from the Facebook Page<br /><br />**Field Name:** `companyOverview`<br />**Type:** dimension         |
| <div>General Info</div>     | General information about the Facebook Page<br /><br />**Field Name:** `generalInfo`<br />**Type:** dimension              |
| <div>Products</div>         | Products listed on the Facebook Page<br /><br />**Field Name:** `products`<br />**Type:** dimension                        |
| <div>Is Published</div>     | Whether the Facebook Page is published<br /><br />**Field Name:** `isPublished`<br />**Type:** dimension                   |
| <div>Is Verified</div>      | Whether the Facebook Page is verified<br /><br />**Field Name:** `isVerified`<br />**Type:** dimension                     |
| <div>Cover Photo URL</div>  | URL of the cover photo on the Facebook Page<br /><br />**Field Name:** `coverSource`<br />**Type:** dimension              |
| <div>City</div>             | City from the location of the Facebook Page<br /><br />**Field Name:** `locationCity`<br />**Type:** dimension             |
| <div>Country</div>          | Country from the location of the Facebook Page<br /><br />**Field Name:** `locationCountry`<br />**Type:** dimension       |
| <div>Latitude</div>         | Latitude from the location of the Facebook Page<br /><br />**Field Name:** `locationLatitude`<br />**Type:** dimension     |
| <div>Longitude</div>        | Longitude from the location of the Facebook Page<br /><br />**Field Name:** `locationLongitude`<br />**Type:** dimension   |
| <div>Street</div>           | Street address from the location of the Facebook Page<br /><br />**Field Name:** `locationStreet`<br />**Type:** dimension |
| <div>Zip Code</div>         | Zip code from the location of the Facebook Page<br /><br />**Field Name:** `locationZip`<br />**Type:** dimension          |

### Post

|                             |                                                                                                                                   |
| --------------------------- | --------------------------------------------------------------------------------------------------------------------------------- |
| <div>Post ID</div>          | The unique identifier of the post<br /><br />**Field Name:** `postId`<br />**Type:** dimension                                    |
| <div>Status Type</div>      | The type of the post status (e.g., added\_photos, shared\_story)<br /><br />**Field Name:** `statusType`<br />**Type:** dimension |
| <div>Permalink URL</div>    | The permanent URL link to the post<br /><br />**Field Name:** `permalinkUrl`<br />**Type:** dimension                             |
| <div>Full Picture URL</div> | URL of the full-size picture attached to the post<br /><br />**Field Name:** `fullPicture`<br />**Type:** dimension               |
| <div>Message</div>          | The text message content of the post<br /><br />**Field Name:** `message`<br />**Type:** dimension                                |
| <div>Story</div>            | The story text generated by Facebook for the post<br /><br />**Field Name:** `story`<br />**Type:** dimension                     |
| <div>From Name</div>        | The name of the user or page that created the post<br /><br />**Field Name:** `fromName`<br />**Type:** dimension                 |
| <div>From ID</div>          | The ID of the user or page that created the post<br /><br />**Field Name:** `fromId`<br />**Type:** dimension                     |
| <div>Created Time</div>     | The date and time when the post was created<br /><br />**Field Name:** `createdTime`<br />**Type:** dimension                     |
| <div>Created Date</div>     | The date when the post was created (without time)<br /><br />**Field Name:** `createdDate`<br />**Type:** dimension               |
| <div>Updated Time</div>     | The date and time when the post was last updated<br /><br />**Field Name:** `updatedTime`<br />**Type:** dimension                |
| <div>Updated Date</div>     | The date when the post was last updated (without time)<br /><br />**Field Name:** `updatedDate`<br />**Type:** dimension          |
| <div>Place</div>            | The place/location tagged in the post<br /><br />**Field Name:** `place`<br />**Type:** dimension                                 |

### URL Engagement

|                                   |                                                                                                                        |
| --------------------------------- | ---------------------------------------------------------------------------------------------------------------------- |
| <div>URL</div>                    | The URL being analyzed for engagement<br /><br />**Field Name:** `url`<br />**Type:** dimension                        |
| <div>OG Object ID</div>           | The Open Graph object ID associated with the URL<br /><br />**Field Name:** `ogObjectId`<br />**Type:** dimension      |
| <div>OG Object Title</div>        | The Open Graph title of the URL<br /><br />**Field Name:** `ogObjectTitle`<br />**Type:** dimension                    |
| <div>OG Object Type</div>         | The Open Graph object type (e.g., article, website)<br /><br />**Field Name:** `ogObjectType`<br />**Type:** dimension |
| <div>OG Object Description</div>  | The Open Graph description of the URL<br /><br />**Field Name:** `ogObjectDescription`<br />**Type:** dimension        |
| <div>OG Object Updated Time</div> | When the Open Graph object was last updated<br /><br />**Field Name:** `ogObjectUpdatedTime`<br />**Type:** dimension  |

## Metrics

Metrics are the numerical values you can measure and analyze from your Facebook Public Data campaigns.

### Page Info

|                           |                                                                                                                                                                 |
| ------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| <div>Likes</div>          | The total number of people who have liked the Page<br /><br />**Field Name:** `fan_count`<br />**Type:** metric                                                 |
| <div>Page Followers</div> | The total number of people who follow the Page<br /><br />**Field Name:** `followers_count`<br />**Type:** metric                                               |
| <div>Talking About</div>  | The number of people talking about the Page (shares, likes, comments in the last 7 days)<br /><br />**Field Name:** `talking_about_count`<br />**Type:** metric |

### Post

|                            |                                                                                                                  |
| -------------------------- | ---------------------------------------------------------------------------------------------------------------- |
| <div>Posts</div>           | The total number of posts<br /><br />**Field Name:** `posts`<br />**Type:** metric                               |
| <div>Post Likes</div>      | The number of likes on the post<br /><br />**Field Name:** `likes_count`<br />**Type:** metric                   |
| <div>Love Reactions</div>  | The number of Love reactions on the post<br /><br />**Field Name:** `reactions_love`<br />**Type:** metric       |
| <div>Wow Reactions</div>   | The number of Wow reactions on the post<br /><br />**Field Name:** `reactions_wow`<br />**Type:** metric         |
| <div>Haha Reactions</div>  | The number of Haha reactions on the post<br /><br />**Field Name:** `reactions_haha`<br />**Type:** metric       |
| <div>Sad Reactions</div>   | The number of Sad reactions on the post<br /><br />**Field Name:** `reactions_sad`<br />**Type:** metric         |
| <div>Angry Reactions</div> | The number of Angry reactions on the post<br /><br />**Field Name:** `reactions_angry`<br />**Type:** metric     |
| <div>Total Reactions</div> | The total number of all reactions on the post<br /><br />**Field Name:** `reactions_count`<br />**Type:** metric |
| <div>Comments</div>        | The number of comments on the post<br /><br />**Field Name:** `comments_count`<br />**Type:** metric             |
| <div>Shares</div>          | The number of shares of the post<br /><br />**Field Name:** `shares_count`<br />**Type:** metric                 |

### Post Averages

|                               |                                                                                                          |
| ----------------------------- | -------------------------------------------------------------------------------------------------------- |
| <div>Likes Per Post</div>     | Average number of likes per post<br /><br />**Field Name:** `likesPerPost`<br />**Type:** metric         |
| <div>Reactions Per Post</div> | Average number of reactions per post<br /><br />**Field Name:** `reactionsPerPost`<br />**Type:** metric |
| <div>Comments Per Post</div>  | Average number of comments per post<br /><br />**Field Name:** `commentsPerPost`<br />**Type:** metric   |
| <div>Shares Per Post</div>    | Average number of shares per post<br /><br />**Field Name:** `sharesPerPost`<br />**Type:** metric       |

### URL Engagement

|                                     |                                                                                                                                             |
| ----------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------- |
| <div>URL Comment Count</div>        | The number of comments on the URL across Facebook<br /><br />**Field Name:** `urlCommentCount`<br />**Type:** metric                        |
| <div>URL Share Count</div>          | The number of times the URL has been shared on Facebook<br /><br />**Field Name:** `urlShareCount`<br />**Type:** metric                    |
| <div>URL Reaction Count</div>       | The number of reactions on the URL across Facebook<br /><br />**Field Name:** `urlReactionCount`<br />**Type:** metric                      |
| <div>URL Comment Plugin Count</div> | The number of comments from the Facebook comment plugin on the URL<br /><br />**Field Name:** `urlCommentPluginCount`<br />**Type:** metric |

***

## Related

<CardGroup>
  <Card title="Fields Catalog" icon="book" href="/fields-catalog">
    Browse all platforms
  </Card>

  <Card title="Facebook Insights Fields" icon="chart-bar" href="/data-source/facebook-insights/fields">
    Facebook Insights metrics & dimensions
  </Card>

  <Card title="Instagram Insights Fields" icon="chart-bar" href="/data-source/instagram-insights/fields">
    Instagram Insights metrics & dimensions
  </Card>

  <Card title="TikTok Organic Fields" icon="chart-bar" href="/data-source/tiktok-organic/fields">
    TikTok Organic metrics & dimensions
  </Card>
</CardGroup>


# Google Ads Metrics & Dimensions
Source: https://support.detrics.io/data-source/google-ads/fields

Complete reference for Google Ads dimensions and metrics

<Info>
  **Last updated:** August 6, 2026
</Info>

<div>
  <div>
    192 dimensions
  </div>

  <div>
    92 metrics
  </div>
</div>

This reference covers all available dimensions and metrics for Google Ads data through Detrics. Use this guide to understand what data you can extract and how to structure your queries.

<div>
  <span>Supported destinations:</span>

  <div>
    Google Sheets
  </div>

  <div>
    Looker Studio
  </div>

  <div>
    Claude
  </div>

  <div>
    BigQuery
  </div>
</div>

## Dimensions

Dimensions are the attributes you can use to segment and group your Google Ads data.

### Most Used

|                          |                                                                                                                                                                                |
| ------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| <div>Account ID</div>    | Unique ID of the Ad Account<br /><br />**Field Name:** `customer.id`<br />**Type:** dimension                                                                                  |
| <div>Account Name</div>  | The name of the Google Ads account as it is displayed in Ads Manager.<br /><br />**Field Name:** `customer.descriptive_name`<br />**Type:** dimension                          |
| <div>Campaign ID</div>   | The unique identifier for your campaign.<br /><br />**Field Name:** `campaign.id`<br />**Type:** dimension                                                                     |
| <div>Campaign Name</div> | The current name of the campaign.<br /><br />**Field Name:** `campaign.name`<br />**Type:** dimension                                                                          |
| <div>Ad Group ID</div>   | Returns Asset Group ID for PMAX Campaigns<br /><br />**Field Name:** `ad_group.id`<br />**Type:** dimension                                                                    |
| <div>Ad Group Name</div> | Returns Asset Group Name for PMAX Campaigns<br /><br />**Field Name:** `ad_group.name`<br />**Type:** dimension                                                                |
| <div>Ad ID</div>         | Important Note: If you choose this dimension, you won't get data for your Performance Max campaigns.<br /><br />**Field Name:** `ad_group_ad.ad.id`<br />**Type:** dimension   |
| <div>Ad Name</div>       | Important Note: If you choose this dimension, you won't get data for your Performance Max campaigns.<br /><br />**Field Name:** `ad_group_ad.ad.name`<br />**Type:** dimension |

### Conversions

|                                       |                                                                                                                                                                                                                             |
| ------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| <div>Conversion Action Category</div> | <br /><br />**Field Name:** `segments.conversion_action_category`<br />**Type:** dimension                                                                                                                                  |
| <div>Conversion Action Name</div>     | <br /><br />**Field Name:** `segments.conversion_action_name`<br />**Type:** dimension                                                                                                                                      |
| <div>External Conversion Source</div> | Conversion attribution source: ANALYTICS, FIREBASE, THIRD\_PARTY\_APP\_ANALYTICS, GOOGLE\_PLAY, SALESFORCE, UPLOAD, WEBSITE, etc.<br /><br />**Field Name:** `segments.external_conversion_source`<br />**Type:** dimension |
| <div>New vs Returning Customers</div> | Segments conversions by customer type: NEW, RETURNING, UNKNOWN<br /><br />**Field Name:** `segments.new_versus_returning_customers`<br />**Type:** dimension                                                                |

### Performance Max Asset Groups

|                                    |                                                                                                                                                                                                                                                                                                                                                                                                               |
| ---------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| <div>Asset Group Id</div>          | Instead of Ad Groups, P. Max campaigns have Asset Groups. Returns Ad Group ID for the rest of campaign types.<br /><br />**Field Name:** `asset_group.id`<br />**Type:** dimension                                                                                                                                                                                                                            |
| <div>Asset Group Name</div>        | Inside Asset Groups, there's Assets (search for 'Asset' to find related dimensions). Returns Ad Group Name for the rest of campaign types.<br /><br />**Field Name:** `asset_group.name`<br />**Type:** dimension                                                                                                                                                                                             |
| <div>Asset Group Ad Strength</div> | Below you'll find the 'Campaign's Asset ID', the field you can combine with 'Campaign Name' or 'Campaign ID' dimensions and get metrics on the Asset level.<br /><br />**Field Name:** `asset_group.ad_strength`<br />**Type:** dimension                                                                                                                                                                     |
| <div>Asset Group Status</div>      | Create a separate query with Asset's dimensions and link the tables. Note: You can't fetch the 'Campaign Asset ID' together with Asset Group dimensions. To get the full picture: you have to create two tables and link them: Asset & Asset Group Dimensions and Campaign Level with 'Campaign Asset ID' including metrics.<br /><br />**Field Name:** `asset_group.primary_status`<br />**Type:** dimension |

### Campaign Status

|                                           |                                                                                                                                                                     |
| ----------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| <div>Status</div>                         | Can be: ENABLED, PAUSED, REMOVED<br /><br />**Field Name:** `campaign.status`<br />**Type:** dimension                                                              |
| <div>Serving Status</div>                 | Can be: ENDED, NONE, PENDING, SERVING, SUSPENDED.<br /><br />**Field Name:** `campaign.serving_status`<br />**Type:** dimension                                     |
| <div>Start Date</div>                     | <br /><br />**Field Name:** `campaign.start_date`<br />**Type:** dimension                                                                                          |
| <div>End Date</div>                       | <br /><br />**Field Name:** `campaign.end_date`<br />**Type:** dimension                                                                                            |
| <div>Optimization Score</div>             | <br /><br />**Field Name:** `campaign.optimization_score`<br />**Type:** dimension                                                                                  |
| <div>Ad Serving Optimization Status</div> | Can be: CONVERSION\_OPTIMIZE, OPTIMIZE, ROTATE, ROTATE\_INDEFINITELY.<br /><br />**Field Name:** `campaign.ad_serving_optimization_status`<br />**Type:** dimension |

### Campaign Configuration

|                                         |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
| --------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| <div>Bidding Strategy Type</div>        | Can be: COMMISSION, ENHANCED\_CPC, INVALID, MANUAL\_CPA, MANUAL\_CPC, MANUAL\_CPM, MANUAL\_CPV, MAXIMIZE\_CONVERSIONS, MAXIMIZE\_CONVERSION\_VALUE, PAGE\_ONE\_PROMOTED, PERCENT\_CPC, TARGET\_CPA, TARGET\_CPM, TARGET\_IMPRESSION\_SHARE, TARGET\_OUTRANK\_SHARE, TARGET\_ROAS, TARGET\_SPEND.<br /><br />**Field Name:** `campaign.bidding_strategy_type`<br />**Type:** dimension                                                                                                                                                                  |
| <div>Advertising Channel Type</div>     | Can be: DISCOVERY, DISPLAY, HOTEL, LOCAL, LOCAL\_SERVICES, MULTI\_CHANNEL, PERFORMANCE\_MAX, SEARCH, SHOPPING, SMART, TRAVEL, UNKNOWN, UNSPECIFIED, VIDEO.<br /><br />**Field Name:** `campaign.advertising_channel_type`<br />**Type:** dimension                                                                                                                                                                                                                                                                                                     |
| <div>Advertising Channel Sub Type</div> | Can be: APP\_CAMPAIGN\_FOR\_ENGAGEMENT, APP\_CAMPAIGN\_FOR\_PRE\_REGISTRATION, DISPLAY\_EXPRESS, DISPLAY\_GMAIL\_AD, DISPLAY\_MOBILE\_APP, DISPLAY\_SMART\_CAMPAIGN, LOCAL\_CAMPAIGN, SEARCH\_EXPRESS, SEARCH\_MOBILE\_APP, SHOPPING\_COMPARISON\_LISTING\_ADS, SHOPPING\_SMART\_ADS, SMART\_CAMPAIGN, TRAVEL\_ACTIVITIES, UNKNOWN, UNSPECIFIED, VIDEO\_ACTION, VIDEO\_NON\_SKIPPABLE, VIDEO\_OUTSTREAM, VIDEO\_REACH\_TARGET\_FREQUENCY, VIDEO\_SEQUENCE.<br /><br />**Field Name:** `campaign.advertising_channel_sub_type`<br />**Type:** dimension |
| <div>Labels</div>                       | Comma concatenated labels.<br /><br />**Field Name:** `campaign.labels`<br />**Type:** dimension                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
| <div>Conversion Goals</div>             | The set of conversion actions used for selective optimization on this campaign (returned as conversion action resource names).<br /><br />**Field Name:** `campaign.selective_optimization.conversion_actions`<br />**Type:** dimension                                                                                                                                                                                                                                                                                                                |

### Ad Group

|                                      |                                                                                   |
| ------------------------------------ | --------------------------------------------------------------------------------- |
| <div>Ad Group Status</div>           | <br /><br />**Field Name:** `ad_group.status`<br />**Type:** dimension            |
| <div>Ad Group Type</div>             | <br /><br />**Field Name:** `ad_group.type`<br />**Type:** dimension              |
| <div>Ad Group Ad Rotation Mode</div> | <br /><br />**Field Name:** `ad_group.ad_rotation_mode`<br />**Type:** dimension  |
| <div>Ad Group Target CPM</div>       | <br /><br />**Field Name:** `ad_group.target_cpm_micros`<br />**Type:** dimension |
| <div>Ad Group Target ROAS</div>      | <br /><br />**Field Name:** `ad_group.target_roas`<br />**Type:** dimension       |
| <div>Ad Group Target CPA</div>       | <br /><br />**Field Name:** `ad_group.target_cpa_micros`<br />**Type:** dimension |
| <div>Ad Group Final URL Suffix</div> | <br /><br />**Field Name:** `ad_group.final_url_suffix`<br />**Type:** dimension  |

### Ad

|                                |                                                                                                                                                                                                                                      |
| ------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| <div>Status</div>              | <br /><br />**Field Name:** `ad_group_ad.status`<br />**Type:** dimension                                                                                                                                                            |
| <div>Approval Status</div>     | <br /><br />**Field Name:** `ad_group_ad.policy_summary.approval_status`<br />**Type:** dimension                                                                                                                                    |
| <div>Review Status</div>       | <br /><br />**Field Name:** `ad_group_ad.policy_summary.review_status`<br />**Type:** dimension                                                                                                                                      |
| <div>Strength</div>            | <br /><br />**Field Name:** `ad_group_ad.ad_strength`<br />**Type:** dimension                                                                                                                                                       |
| <div>Type</div>                | <br /><br />**Field Name:** `ad_group_ad.ad.type`<br />**Type:** dimension                                                                                                                                                           |
| <div>Headlines</div>           | <br /><br />**Field Name:** `ad_group_ad.ad.headlines`<br />**Type:** dimension                                                                                                                                                      |
| <div>Descriptions</div>        | <br /><br />**Field Name:** `ad_group_ad.ad.descriptions`<br />**Type:** dimension                                                                                                                                                   |
| <div>Paths</div>               | <br /><br />**Field Name:** `ad_group_ad.ad.paths`<br />**Type:** dimension                                                                                                                                                          |
| <div>Image URL</div>           | <br /><br />**Field Name:** `ad_group_ad.ad.image_ad.image_url`<br />**Type:** dimension                                                                                                                                             |
| <div>Final URLs</div>          | <br /><br />**Field Name:** `ad_group_ad.ad.final_urls`<br />**Type:** dimension                                                                                                                                                     |
| <div>Ad Destination Type</div> | Where ads direct users: APP\_DEEP\_LINK, APP\_STORE, PHONE\_CALL, MAP\_DIRECTIONS, LOCATION\_LISTING, MESSAGE, LEAD\_FORM, YOUTUBE, WEBSITE, etc.<br /><br />**Field Name:** `segments.ad_destination_type`<br />**Type:** dimension |

### Video Ads

|                           |                                                                                                                                                        |
| ------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------ |
| <div>Video Title</div>    | When selected, only video ads campaigns will be imported.<br /><br />**Field Name:** `video.title`<br />**Type:** dimension                            |
| <div>Channel ID</div>     | Use this field to create a Video Channel URL: youtube.com/channel/\<Channel ID><br /><br />**Field Name:** `video.channel_id`<br />**Type:** dimension |
| <div>Video Duration</div> | Duration in seconds.<br /><br />**Field Name:** `video.duration_millis`<br />**Type:** dimension                                                       |

### Keyword

|                                   |                                                                                                                                                                                                                     |
| --------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| <div>Keyword ID</div>             | Unique identifier for this keyword.<br /><br />**Field Name:** `keyword.id`<br />**Type:** dimension                                                                                                                |
| <div>Keyword Text</div>           | The text of the keyword (at most 80 characters and 10 words)<br /><br />**Field Name:** `keyword.text`<br />**Type:** dimension                                                                                     |
| <div>Keyword Match Type</div>     | Can be: BROAD, EXACT, PHRASE.<br /><br />**Field Name:** `keyword.match_type`<br />**Type:** dimension                                                                                                              |
| <div>Keyword Status</div>         | Can be: ENABLED, PAUSED, REMOVED.<br /><br />**Field Name:** `keyword.status`<br />**Type:** dimension                                                                                                              |
| <div>Keyword Is Negativized</div> | Important Note: Always choose 'No time Grouping' in the Timeframe to get negativized keywords.<br /><br />**Field Name:** `keyword.is_negativized`<br />**Type:** dimension                                         |
| <div>Quality Score</div>          | Real-time Quality Score (1-10) for keywords. Use with keyword dimensions and no time grouping for best results.<br /><br />**Field Name:** `ad_group_criterion.quality_info.quality_score`<br />**Type:** dimension |

### Demographics

|                      |                                                                        |
| -------------------- | ---------------------------------------------------------------------- |
| <div>Gender</div>    | <br /><br />**Field Name:** `gender.type`<br />**Type:** dimension     |
| <div>Age Range</div> | <br /><br />**Field Name:** `age_range.type`<br />**Type:** dimension  |
| <div>Device</div>    | <br /><br />**Field Name:** `segments.device`<br />**Type:** dimension |

### Location

|                                   |                                                                                                                                                               |
| --------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| <div>Country Code</div>           | <br /><br />**Field Name:** `country.code`<br />**Type:** dimension                                                                                           |
| <div>Country Name</div>           | <br /><br />**Field Name:** `country.name`<br />**Type:** dimension                                                                                           |
| <div>Location Region</div>        | The region/state where the ad was shown or interacted with.<br /><br />**Field Name:** `location.region`<br />**Type:** dimension                             |
| <div>Location State</div>         | The state where the ad was shown or interacted with.<br /><br />**Field Name:** `location.state`<br />**Type:** dimension                                     |
| <div>Location Metro</div>         | The metropolitan area (DMA) where the ad was shown or interacted with.<br /><br />**Field Name:** `location.metro`<br />**Type:** dimension                   |
| <div>Location County</div>        | The county where the ad was shown or interacted with.<br /><br />**Field Name:** `location.county`<br />**Type:** dimension                                   |
| <div>Location City</div>          | The city name where the ad was shown or interacted with.<br /><br />**Field Name:** `location.city`<br />**Type:** dimension                                  |
| <div>Location Postal Code</div>   | The postal code where the ad was shown or interacted with.<br /><br />**Field Name:** `location.postal_code`<br />**Type:** dimension                         |
| <div>Location Most Specific</div> | The most specific location name available for this geographic area.<br /><br />**Field Name:** `location.most_specific`<br />**Type:** dimension              |
| <div>Location Type</div>          | The type of geographic location: CITY, METRO, REGION, STATE, COUNTRY, POSTAL\_CODE, etc.<br /><br />**Field Name:** `location.type`<br />**Type:** dimension  |
| <div>Location Is Targeting</div>  | Whether this location is from targeting settings (true) or user location (false).<br /><br />**Field Name:** `location.is_targeting`<br />**Type:** dimension |

### Placement

|                        |                                                                                                                                                                                 |
| ---------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| <div>Click Type</div>  | <br /><br />**Field Name:** `segments.click_type`<br />**Type:** dimension                                                                                                      |
| <div>Search Slot</div> | Shows ad position: SEARCH\_TOP, SEARCH\_OTHER, CONTENT, SEARCH\_PARTNER\_TOP, SEARCH\_PARTNER\_OTHER, MIXED<br /><br />**Field Name:** `segments.slot`<br />**Type:** dimension |
| <div>Network</div>     | <br /><br />**Field Name:** `segments.ad_network_type`<br />**Type:** dimension                                                                                                 |

### Search Terms

|                                   |                                                                                                                                                                                                                              |
| --------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| <div>Search Term</div>            | Search term metric totals might not match campaign or account level totals. Use these reports to get a sense of search terms performance.<br /><br />**Field Name:** `search_term_view.search_term`<br />**Type:** dimension |
| <div>Search Term Status</div>     | <br /><br />**Field Name:** `search_term_view.status`<br />**Type:** dimension                                                                                                                                               |
| <div>Search Term Match Type</div> | <br /><br />**Field Name:** `segments.search_term_match_type`<br />**Type:** dimension                                                                                                                                       |

### Asset Group Listing Groups

|                                                |                                                                                                                                                                                                                                                                  |
| ---------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| <div>Listing Group Filter ID</div>             | Unique identifier of the listing group filter node.<br /><br />**Field Name:** `asset_group_listing_group_filter.id`<br />**Type:** dimension                                                                                                                    |
| <div>Listing Group Filter Type</div>           | Can be: SUBDIVSION, UNIT\_INCLUDED, UNIT\_EXCLUDED<br /><br />**Field Name:** `asset_group_listing_group_filter.type`<br />**Type:** dimension                                                                                                                   |
| <div>Listing Group Filter Listing Source</div> | Can be: SHOPPING, UNKNOWN, UNSPECIFIED, WEBPAGE<br /><br />**Field Name:** `asset_group_listing_group_filter.listing_source`<br />**Type:** dimension                                                                                                            |
| <div>Listing Group Filter Case Value</div>     | The case value for this listing group filter node. It can be product's: bidding category, brand, channel, condition, custom attribute, item id or type.<br /><br />**Field Name:** `asset_group_listing_group_filter.custom_case_value`<br />**Type:** dimension |
| <div>Listing Group Filter Parent ID</div>      | The ID of the parent listing group.<br /><br />**Field Name:** `asset_group_listing_group_filter.parent_listing_group_filter`<br />**Type:** dimension                                                                                                           |

### Asset & Campaign Link

|                                                     |                                                                                                                                                                                                                                 |
| --------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| <div>Campaign's Asset ID</div>                      | This is the ID of the Asset in the P. Max campaign. Use this field to link Campaign Asset's Metrics with P. Max Asset dimensions.<br /><br />**Field Name:** `segments.asset_interaction_target.asset`<br />**Type:** dimension |
| <div>Campaign Asset Interaction on this Asset</div> | Indicates whether the interaction metrics occurred on the asset itself or a different asset or ad unit.<br /><br />**Field Name:** `segments.asset_interaction_target.interaction_on_this_asset`<br />**Type:** dimension       |

### Top Asset Combination

|                                       |                                                                                                                                                                                                                    |
| ------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| <div>Top Combination Number</div>     | Google provides 6 top combinations for each asset type and asset group. This number indicates the order in this list.<br /><br />**Field Name:** `asset_group_top_combination_view.index`<br />**Type:** dimension |
| <div>Top Combination Type</div>       | The type of the asset's combination: VIDEO, TEXT and IMAGE.<br /><br />**Field Name:** `asset_group_top_combination_view.combination_type`<br />**Type:** dimension                                                |
| <div>Top Combination Asset ID</div>   | The Asset ID of the asset group asset within the combination group.<br /><br />**Field Name:** `asset_group_top_combination_view.asset_id`<br />**Type:** dimension                                                |
| <div>Top Combination Asset Type</div> | The served asset type.<br /><br />**Field Name:** `asset_group_top_combination_view.served_asset_field_type`<br />**Type:** dimension                                                                              |

### Campaign Shopping Settings

|                                    |                                                                                                                                                                                                                                                                                                                                                                                                       |
| ---------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| <div>Advertising Partner IDs</div> | The ads account IDs of advertising partners cooperating within the campaign.<br /><br />**Field Name:** `campaign.shopping_setting.advertising_partner_ids`<br />**Type:** dimension                                                                                                                                                                                                                  |
| <div>Campaign Priority</div>       | Priority of the campaign. Campaigns with numerically higher priorities take precedence over those with lower priorities. This field is required for Shopping campaigns, with values between 0 and 2, inclusive. This field is optional for Smart Shopping campaigns, but must be equal to 3 if set.<br /><br />**Field Name:** `campaign.shopping_setting.campaign_priority`<br />**Type:** dimension |
| <div>Disable Product Feed</div>    | Disable the optional product feed. This field is currently supported only for Demand Gen campaigns.<br /><br />**Field Name:** `campaign.shopping_setting.disable_product_feed`<br />**Type:** dimension                                                                                                                                                                                              |
| <div>Enable Local Products</div>   | Whether to include local products.<br /><br />**Field Name:** `campaign.shopping_setting.enable_local`<br />**Type:** dimension                                                                                                                                                                                                                                                                       |
| <div>Feed Label</div>              | Feed label of products to include in the campaign. Only one of feed\_label or sales\_country can be set. If used instead of sales\_country, the feed\_label field accepts country codes in the same format for example: 'XX'. Otherwise can be any string used for feed label in Google Merchant Center.<br /><br />**Field Name:** `campaign.shopping_setting.feed_label`<br />**Type:** dimension   |
| <div>Merchant Center ID</div>      | ID of the Merchant Center account.<br /><br />**Field Name:** `campaign.shopping_setting.merchant_id`<br />**Type:** dimension                                                                                                                                                                                                                                                                        |
| <div>Use vehicle inventory</div>   | Whether to target Vehicle Listing inventory. This field is supported only in Smart Shopping Campaigns.<br /><br />**Field Name:** `campaign.shopping_setting.use_vehicle_inventory`<br />**Type:** dimension                                                                                                                                                                                          |

### Campaign Budget

|                                           |                                                                                                    |
| ----------------------------------------- | -------------------------------------------------------------------------------------------------- |
| <div>Budget ID</div>                      | <br /><br />**Field Name:** `campaign_budget.id`<br />**Type:** dimension                          |
| <div>Budget Name</div>                    | <br /><br />**Field Name:** `campaign_budget.name`<br />**Type:** dimension                        |
| <div>Daily Budget</div>                   | <br /><br />**Field Name:** `campaign_budget.amount_micros`<br />**Type:** dimension               |
| <div>Lifetime Budget</div>                | <br /><br />**Field Name:** `campaign_budget.total_amount_micros`<br />**Type:** dimension         |
| <div>Status</div>                         | <br /><br />**Field Name:** `campaign_budget.status`<br />**Type:** dimension                      |
| <div>Type</div>                           | <br /><br />**Field Name:** `campaign_budget.type`<br />**Type:** dimension                        |
| <div>Delivery Method</div>                | <br /><br />**Field Name:** `campaign_budget.delivery_method`<br />**Type:** dimension             |
| <div>Is Explicitly Shared</div>           | <br /><br />**Field Name:** `campaign_budget.explicitly_shared`<br />**Type:** dimension           |
| <div>Budget Period</div>                  | <br /><br />**Field Name:** `campaign_budget.period`<br />**Type:** dimension                      |
| <div>Number of Associated Campaigns</div> | <br /><br />**Field Name:** `campaign_budget.reference_count`<br />**Type:** dimension             |
| <div>Aligned Bidding Strategy ID</div>    | <br /><br />**Field Name:** `campaign_budget.aligned_bidding_strategy_id`<br />**Type:** dimension |

### Targets

|                               |                                                                                                   |
| ----------------------------- | ------------------------------------------------------------------------------------------------- |
| <div>Manual CPA</div>         | <br /><br />**Field Name:** `campaign.manual_cpa`<br />**Type:** dimension                        |
| <div>Manual CPM</div>         | <br /><br />**Field Name:** `campaign.manual_cpm`<br />**Type:** dimension                        |
| <div>Manual CPV</div>         | <br /><br />**Field Name:** `campaign.manual_cpv`<br />**Type:** dimension                        |
| <div>Target CPA</div>         | <br /><br />**Field Name:** `campaign.target_cpa.target_cpa_micros`<br />**Type:** dimension      |
| <div>Target CPA Ceiling</div> | <br /><br />**Field Name:** `campaign.target_cpa.cpc_bid_ceiling_micros`<br />**Type:** dimension |
| <div>Target CPA Floor</div>   | <br /><br />**Field Name:** `campaign.target_cpa.cpc_bid_floor_micros`<br />**Type:** dimension   |
| <div>Target ROAS</div>        | <br /><br />**Field Name:** `campaign.target_roas.target_roas`<br />**Type:** dimension           |
| <div>Target Spend</div>       | <br /><br />**Field Name:** `campaign.target_spend.target_spend_micros`<br />**Type:** dimension  |

### Asset Group Asset

|                             |                                                                                        |
| --------------------------- | -------------------------------------------------------------------------------------- |
| <div>Asset ID</div>         | <br /><br />**Field Name:** `asset_group_asset.id`<br />**Type:** dimension            |
| <div>Asset Name</div>       | <br /><br />**Field Name:** `asset_group_asset.asset`<br />**Type:** dimension         |
| <div>Asset Status</div>     | <br /><br />**Field Name:** `asset_group_asset.status`<br />**Type:** dimension        |
| <div>Asset Field Type</div> | <br /><br />**Field Name:** `asset_group_asset.field_type`<br />**Type:** dimension    |
| <div>Asset Source</div>     | <br /><br />**Field Name:** `asset_group_asset.source`<br />**Type:** dimension        |
| <div>Asset Image Url</div>  | <br /><br />**Field Name:** `asset.image_asset.full_size.url`<br />**Type:** dimension |
| <div>Asset Type</div>       | <br /><br />**Field Name:** `asset.type`<br />**Type:** dimension                      |

### Ad Assets

|                                       |                                                                                                                                                                                             |
| ------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| <div>Ad Asset Field Type</div>        | The asset's role in the ad (HEADLINE, DESCRIPTION, MARKETING\_IMAGE, YOUTUBE\_VIDEO, …).<br /><br />**Field Name:** `ad_group_ad_asset_view.field_type`<br />**Type:** dimension            |
| <div>Ad Asset Performance Label</div> | Google's performance rating for the asset within the ad: BEST, GOOD, LOW, LEARNING, PENDING.<br /><br />**Field Name:** `ad_group_ad_asset_view.performance_label`<br />**Type:** dimension |
| <div>Ad Asset Enabled</div>           | Whether the asset is linked to the latest version of the ad.<br /><br />**Field Name:** `ad_group_ad_asset_view.enabled`<br />**Type:** dimension                                           |
| <div>Ad Asset Pinned Field</div>      | The pin position of the asset (Responsive Search Ads).<br /><br />**Field Name:** `ad_group_ad_asset_view.pinned_field`<br />**Type:** dimension                                            |
| <div>Ad Asset Source</div>            | Source of the asset: ADVERTISER or AUTOMATICALLY\_CREATED.<br /><br />**Field Name:** `ad_group_ad_asset_view.source`<br />**Type:** dimension                                              |
| <div>Asset Id</div>                   | The unique ID of the asset.<br /><br />**Field Name:** `asset.id`<br />**Type:** dimension                                                                                                  |
| <div>Asset Name</div>                 | The name of the asset.<br /><br />**Field Name:** `asset.name`<br />**Type:** dimension                                                                                                     |
| <div>Asset Text</div>                 | The text of a text asset (RSA headlines / descriptions).<br /><br />**Field Name:** `asset.text_asset.text`<br />**Type:** dimension                                                        |
| <div>Asset YouTube Video Id</div>     | The YouTube video ID of a video asset.<br /><br />**Field Name:** `asset.youtube_video_asset.youtube_video_id`<br />**Type:** dimension                                                     |
| <div>Asset YouTube Video Title</div>  | The title of the YouTube video asset.<br /><br />**Field Name:** `asset.youtube_video_asset.youtube_video_title`<br />**Type:** dimension                                                   |
| <div>Asset Final Urls</div>           | The landing page URLs of the asset.<br /><br />**Field Name:** `asset.final_urls`<br />**Type:** dimension                                                                                  |
| <div>Asset Final Mobile Urls</div>    | The mobile landing page URLs of the asset.<br /><br />**Field Name:** `asset.final_mobile_urls`<br />**Type:** dimension                                                                    |

### Product

|                                        |                                                                                             |
| -------------------------------------- | ------------------------------------------------------------------------------------------- |
| <div>Product Aggregator Id</div>       | <br /><br />**Field Name:** `segments.product_aggregator_id`<br />**Type:** dimension       |
| <div>Product Brand</div>               | <br /><br />**Field Name:** `segments.product_brand`<br />**Type:** dimension               |
| <div>Product Category Level 1</div>    | <br /><br />**Field Name:** `segments.product_category_level1`<br />**Type:** dimension     |
| <div>Product Category Level 2</div>    | <br /><br />**Field Name:** `segments.product_category_level2`<br />**Type:** dimension     |
| <div>Product Category Level 3</div>    | <br /><br />**Field Name:** `segments.product_category_level3`<br />**Type:** dimension     |
| <div>Product Category Level 4</div>    | <br /><br />**Field Name:** `segments.product_category_level4`<br />**Type:** dimension     |
| <div>Product Category Level 5</div>    | <br /><br />**Field Name:** `segments.product_category_level5`<br />**Type:** dimension     |
| <div>Product Channel</div>             | <br /><br />**Field Name:** `segments.product_channel`<br />**Type:** dimension             |
| <div>Product Channel Exclusivity</div> | <br /><br />**Field Name:** `segments.product_channel_exclusivity`<br />**Type:** dimension |
| <div>Product Condition</div>           | <br /><br />**Field Name:** `segments.product_condition`<br />**Type:** dimension           |
| <div>Product Country</div>             | <br /><br />**Field Name:** `segments.product_country`<br />**Type:** dimension             |
| <div>Product Custom Attribute 0</div>  | <br /><br />**Field Name:** `segments.product_custom_attribute0`<br />**Type:** dimension   |
| <div>Product Custom Attribute 1</div>  | <br /><br />**Field Name:** `segments.product_custom_attribute1`<br />**Type:** dimension   |
| <div>Product Custom Attribute 2</div>  | <br /><br />**Field Name:** `segments.product_custom_attribute2`<br />**Type:** dimension   |
| <div>Product Custom Attribute 3</div>  | <br /><br />**Field Name:** `segments.product_custom_attribute3`<br />**Type:** dimension   |
| <div>Product Custom Attribute 4</div>  | <br /><br />**Field Name:** `segments.product_custom_attribute4`<br />**Type:** dimension   |
| <div>Product Item Id</div>             | <br /><br />**Field Name:** `segments.product_item_id`<br />**Type:** dimension             |
| <div>Product Merchant Id</div>         | <br /><br />**Field Name:** `segments.product_merchant_id`<br />**Type:** dimension         |
| <div>Product Store Id</div>            | <br /><br />**Field Name:** `segments.product_store_id`<br />**Type:** dimension            |
| <div>Product Title</div>               | <br /><br />**Field Name:** `segments.product_title`<br />**Type:** dimension               |
| <div>Product Type L1</div>             | <br /><br />**Field Name:** `segments.product_type_l1`<br />**Type:** dimension             |
| <div>Product Type L2</div>             | <br /><br />**Field Name:** `segments.product_type_l2`<br />**Type:** dimension             |
| <div>Product Type L3</div>             | <br /><br />**Field Name:** `segments.product_type_l3`<br />**Type:** dimension             |
| <div>Product Type L4</div>             | <br /><br />**Field Name:** `segments.product_type_l4`<br />**Type:** dimension             |
| <div>Product Type L5</div>             | <br /><br />**Field Name:** `segments.product_type_l5`<br />**Type:** dimension             |

### Account

|                                       |                                                                                                                        |
| ------------------------------------- | ---------------------------------------------------------------------------------------------------------------------- |
| <div>Currency Code</div>              | <br /><br />**Field Name:** `customer.currency_code`<br />**Type:** dimension                                          |
| <div>Timezone</div>                   | <br /><br />**Field Name:** `customer.time_zone`<br />**Type:** dimension                                              |
| <div>Has Auto Tagging Enabled</div>   | <br /><br />**Field Name:** `customer.auto_tagging_enabled`<br />**Type:** dimension                                   |
| <div>Is Manager Account</div>         | <br /><br />**Field Name:** `customer.manager`<br />**Type:** dimension                                                |
| <div>Status</div>                     | <br /><br />**Field Name:** `customer.status`<br />**Type:** dimension                                                 |
| <div>Is Test Account</div>            | <br /><br />**Field Name:** `customer.test_account`<br />**Type:** dimension                                           |
| <div>Optimization Score</div>         | <br /><br />**Field Name:** `customer.optimization_score`<br />**Type:** dimension                                     |
| <div>Optimization Score Weight</div>  | <br /><br />**Field Name:** `customer.optimization_score_weight`<br />**Type:** dimension                              |
| <div>Has Partners Badge</div>         | <br /><br />**Field Name:** `customer.has_partners_badge`<br />**Type:** dimension                                     |
| <div>Global Site Tag</div>            | <br /><br />**Field Name:** `customer.remarketing_setting.google_global_site_tag`<br />**Type:** dimension             |
| <div>Conversion Tracking Status</div> | <br /><br />**Field Name:** `customer.conversion_tracking_setting.conversion_tracking_status`<br />**Type:** dimension |
| <div>Final URL Suffix</div>           | <br /><br />**Field Name:** `customer.final_url_suffix`<br />**Type:** dimension                                       |

### Campaign Negativized Keywords

|                                        |                                                                                                                                   |
| -------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------- |
| <div>Negative Keyword Text</div>       | Keywords negativized at the campaign level<br /><br />**Field Name:** `campaign.negative_keyword.text`<br />**Type:** dimension   |
| <div>Negative Keyword Match Type</div> | Match Type of the negativized keyword.<br /><br />**Field Name:** `campaign.negative_keyword.match_type`<br />**Type:** dimension |

### Conversion Properties

|                                                     |                                                                                                                                                                                                                                                                                            |
| --------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| <div>Conversion Adjustment</div>                    | This segments your conversion columns by the original conversion and conversion value versus the delta if conversions were adjusted.<br /><br />**Field Name:** `segments.conversion_adjustment`<br />**Type:** dimension                                                                  |
| <div>Conversions Attribution Event Type</div>       | Conversion attribution event type. Can be: IMPRESSION, INTERACTION<br /><br />**Field Name:** `segments.conversion_attribution_event_type`<br />**Type:** dimension                                                                                                                        |
| <div>Conversions Lag Bucket</div>                   | The number of days between the impression and the conversion.<br /><br />**Field Name:** `segments.conversion_lag_bucket`<br />**Type:** dimension                                                                                                                                         |
| <div>Conversions or Adjustment Lag Bucket</div>     | The number of days between the impression and the conversion or between the impression and adjustments to the conversion.<br /><br />**Field Name:** `segments.conversion_or_adjustment_lag_bucket`<br />**Type:** dimension                                                               |
| <div>Conversions Value Rule Primary Dimension</div> | Primary dimension of applied conversion value rules. Shows the total recorded value of conversions and adjustments based on value rules. (compatible with conversion value metrics)<br /><br />**Field Name:** `segments.conversion_value_rule_primary_dimension`<br />**Type:** dimension |

### Account Budget

|                                                        |                                                                                                                                                        |
| ------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------ |
| <div>Account Budget Id</div>                           | <br /><br />**Field Name:** `account_budget.id`<br />**Type:** dimension                                                                               |
| <div>Account Budget Name</div>                         | The name of the account budget.<br /><br />**Field Name:** `account_budget.name`<br />**Type:** dimension                                              |
| <div>Account Budget Status</div>                       | The status of the account budget.<br /><br />**Field Name:** `account_budget.status`<br />**Type:** dimension                                          |
| <div>Account Budget Start Date Time</div>              | The approved start date and time for the account budget.<br /><br />**Field Name:** `account_budget.approved_start_date_time`<br />**Type:** dimension |
| <div>Account Budget End Date Time</div>                | The approved end date and time for the account budget.<br /><br />**Field Name:** `account_budget.approved_end_date_time`<br />**Type:** dimension     |
| <div>Account Budget Notes</div>                        | Notes for the account budget.<br /><br />**Field Name:** `account_budget.notes`<br />**Type:** dimension                                               |
| <div>Account Budget Adjusted Spending Limit Type</div> | <br /><br />**Field Name:** `account_budget.adjusted_spending_limit_type`<br />**Type:** dimension                                                     |
| <div>Account Budget Spending Limit Type</div>          | <br /><br />**Field Name:** `account_budget.approved_spending_limit_type`<br />**Type:** dimension                                                     |
| <div>Account Budget End Time Type</div>                | <br /><br />**Field Name:** `account_budget.approved_end_time_type`<br />**Type:** dimension                                                           |
| <div>Account Budget Purchase Order Number</div>        | <br /><br />**Field Name:** `account_budget.purchase_order_number`<br />**Type:** dimension                                                            |

### Change History

|                                  |                                                                                                                                                                                                              |
| -------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| <div>Changed By</div>            | Email of the user who made the change.<br /><br />**Field Name:** `change_event.user_email`<br />**Type:** dimension                                                                                         |
| <div>Change Source</div>         | Where the change was made from (e.g. Google Ads web interface, API). Only changes made through the web UI or API are tracked.<br /><br />**Field Name:** `change_event.client_type`<br />**Type:** dimension |
| <div>Changed Resource Type</div> | Type of resource that changed (e.g. CAMPAIGN, AD\_GROUP, AD\_GROUP\_AD, CAMPAIGN\_BUDGET, AD\_GROUP\_CRITERION).<br /><br />**Field Name:** `change_event.change_resource_type`<br />**Type:** dimension     |
| <div>Changed Resource</div>      | Resource name (identifier) of the specific item that changed.<br /><br />**Field Name:** `change_event.change_resource_name`<br />**Type:** dimension                                                        |
| <div>Change Type</div>           | Whether the resource was created, updated or removed.<br /><br />**Field Name:** `change_event.resource_change_operation`<br />**Type:** dimension                                                           |
| <div>Changed Fields</div>        | List of fields that were modified in the change.<br /><br />**Field Name:** `change_event.changed_fields`<br />**Type:** dimension                                                                           |
| <div>Previous Value</div>        | Values of the changed fields before the change (empty when the resource was newly created).<br /><br />**Field Name:** `change_event.old_value`<br />**Type:** dimension                                     |
| <div>New Value</div>             | Values of the changed fields after the change.<br /><br />**Field Name:** `change_event.new_value`<br />**Type:** dimension                                                                                  |

## Metrics

Metrics are the numerical values you can measure and analyze from your Google Ads campaigns.

### Most Used

|                                  |                                                                                                                                                                                                                                                                                |
| -------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| <div>Cost</div>                  | Google Ads's investment over the selected time frame.<br /><br />**Field Name:** `cost_micros`<br />**Type:** metric                                                                                                                                                           |
| <div>Impressions</div>           | Total number of times ads have been served.<br /><br />**Field Name:** `impressions`<br />**Type:** metric                                                                                                                                                                     |
| <div>Viewable Impressions</div>  | The number of times your ads appeared and were viewable. An ad is counted as viewable when at least 50% of its area was on screen for at least 1 second for Display ads or 2 seconds for video ads.<br /><br />**Field Name:** `active_view_impressions`<br />**Type:** metric |
| <div>Clicks</div>                | Total number of ad clicks.<br /><br />**Field Name:** `clicks`<br />**Type:** metric                                                                                                                                                                                           |
| <div>Conversions</div>           | Indicates the number of conversions configured as primary attributed to your ad interactions.<br /><br />**Field Name:** `conversions`<br />**Type:** metric                                                                                                                   |
| <div>All Conversions</div>       | Aggregates all conversions, including primary and secondary conversions.<br /><br />**Field Name:** `all_conversions`<br />**Type:** metric                                                                                                                                    |
| <div>Conversions Value</div>     | Specifies the total assigned value of conversions.<br /><br />**Field Name:** `conversions_value`<br />**Type:** metric                                                                                                                                                        |
| <div>All Conversions Value</div> | Specifies the total assigned value of all conversions.<br /><br />**Field Name:** `all_conversions_value`<br />**Type:** metric                                                                                                                                                |

### Reach & Frequency

|                                                  |                                                                                                                                                                                                                                                                                                            |
| ------------------------------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| <div>Unique Users</div>                          | The number of unique users who saw your ad. Available only at the campaign level on the following campaign types - Display, Video, Discovery and App. Daily and Monthly time groupings available only.<br /><br />**Field Name:** `unique_users`<br />**Type:** metric                                     |
| <div>Average Impression Frequency Per User</div> | The average number of times a unique user saw your ad. Available only at the campaign level on the following campaign types - Display, Video, Discovery and App. Daily and Monthly time groupings available only.<br /><br />**Field Name:** `average_impression_frequency_per_user`<br />**Type:** metric |

### Videos

|                                 |                                                                                                                                                            |
| ------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------- |
| <div>Video Views</div>          | Quantifies the total number of video ad views.<br /><br />**Field Name:** `video_views`<br />**Type:** metric                                              |
| <div>Video 25% View</div>       | Denotes the percentage of video plays that reach 25% of their length.<br /><br />**Field Name:** `video_quartile_p25_rate`<br />**Type:** metric           |
| <div>Video 50% View</div>       | Denotes the percentage of video plays that reach 50% of their length.<br /><br />**Field Name:** `video_quartile_p50_rate`<br />**Type:** metric           |
| <div>Video 75% View</div>       | Denotes the percentage of video plays that reach 75% of their length.<br /><br />**Field Name:** `video_quartile_p75_rate`<br />**Type:** metric           |
| <div>Video 100% View</div>      | Denotes the percentage of video plays that reach 100% of their length.<br /><br />**Field Name:** `video_quartile_p100_rate`<br />**Type:** metric         |
| <div>Video Played to 25%</div>  | The number of video views where the viewer watched at least 25% of your video.<br /><br />**Field Name:** `video_quartile_p25_views`<br />**Type:** metric |
| <div>Video Played to 50%</div>  | The number of video views where the viewer watched at least 50% of your video.<br /><br />**Field Name:** `video_quartile_p50_views`<br />**Type:** metric |
| <div>Video Played to 75%</div>  | The number of video views where the viewer watched at least 75% of your video.<br /><br />**Field Name:** `video_quartile_p75_views`<br />**Type:** metric |
| <div>Video Played to 100%</div> | The number of video views where the viewer watched 100% of your video.<br /><br />**Field Name:** `video_quartile_p100_views`<br />**Type:** metric        |

### Search

|                                          |                                                                                                                                                                                                                                                                            |
| ---------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| <div>Top Impression %</div>              | Displays the percentage of ads served above organic search results.<br /><br />**Field Name:** `top_impression_percentage`<br />**Type:** metric                                                                                                                           |
| <div>Absolute Top Impression %</div>     | Shows the percentage of ads served in the first position above organic search results.<br /><br />**Field Name:** `absolute_top_impression_percentage`<br />**Type:** metric                                                                                               |
| <div>Search Click Share</div>            | Represents the number of clicks you've received on the Search Network divided by the estimated number of clicks you were eligible to receive. <br /><br />**Field Name:** `search_click_share`<br />**Type:** metric                                                       |
| <div>Exact Match I.S.</div>              | Denotes the impressions received divided by the estimated number of impressions eligible to receivefor search terms that matchedyour keywords exactly or were close variants.<br /><br />**Field Name:** `search_exact_match_impression_share`<br />**Type:** metric       |
| <div>Impression Share</div>              | Indicates the impressions you've received on the Search Network divided by the estimated number of impressions you were eligible toreceive.<br /><br />**Field Name:** `search_impression_share`<br />**Type:** metric                                                     |
| <div>Top Impression Share</div>          | Specifies the impressions you've received in the top location(above organic search results) divided by the estimated number ofimpressions you were eligible to receive in the top location.<br /><br />**Field Name:** `search_top_impression_share`<br />**Type:** metric |
| <div>Absolute Top I.S.</div>             | Refers to the percentage of the customer's Shopping or Search ad impressions that are shown in the most prominent Shopping position. <br /><br />**Field Name:** `search_absolute_top_impression_share`<br />**Type:** metric                                              |
| <div>Budget Lost I.S.</div>              | Denotes the estimated percentage of times that your ad was eligible to show on the Search Network but didn 't due to a low budget.<br /><br />**Field Name:** `search_budget_lost_impression_share`<br />**Type:** metric                                                  |
| <div>Budget Lost Top I.S.</div>          | Specifies the number estimating how often your ad didn't show anywhere above the organic search results due to a low budget.<br /><br />**Field Name:** `search_budget_lost_top_impression_share`<br />**Type:** metric                                                    |
| <div>Budget Lost Absolute Top I.S.</div> | Indicates the number estimating how often your ad wasn't the very first ad above the organic search results due to a low budget.<br /><br />**Field Name:** `search_budget_lost_absolute_top_impression_share`<br />**Type:** metric                                       |
| <div>Rank Lost I.S.</div>                | Reflects the estimated percentage of impressions on the Search Network that your ads didn 't receive due to poor Ad Rank.<br /><br />**Field Name:** `search_rank_lost_impression_share`<br />**Type:** metric                                                             |
| <div>Rank Lost Top I.S.</div>            | Shows the number estimating how often your ad didn't show anywhere above the organic search results due to poor Ad Rank.<br /><br />**Field Name:** `search_rank_lost_top_impression_share`<br />**Type:** metric                                                          |
| <div>Rank Lost Absolute Top I.S.</div>   | Denotes the number estimating how often your ad wasn't the very first ad above the organic search results due to poor Ad Rank.<br /><br />**Field Name:** `search_rank_lost_absolute_top_impression_share`<br />**Type:** metric                                           |
| <div>Content Impression Share</div>      | Specifies the percentage of total achievable impressions on Google Display Network.<br /><br />**Field Name:** `content_impression_share`<br />**Type:** metric                                                                                                            |
| <div>Content Budget Lost I.S.</div>      | Reflects the proportion of potential impressions on Google Display Network lost due to budget constraints.<br /><br />**Field Name:** `content_budget_lost_impression_share`<br />**Type:** metric                                                                         |
| <div>Content Rank Lost I.S.</div>        | Indicates the proportion of potential impressions on Google Display Network lost due to low ad rank.<br /><br />**Field Name:** `content_rank_lost_impression_share`<br />**Type:** metric                                                                                 |

### Ratios

|                                     |                                                                                                                                                                                                                                                                                                                                              |
| ----------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| <div>CTR</div>                      | Displays the ratio of ad clicks to ad impressions.<br /><br />**Field Name:** `ctr`<br />**Type:** metric                                                                                                                                                                                                                                    |
| <div>CPC</div>                      | Shows the average cost incurred per ad click.<br /><br />**Field Name:** `average_cpc`<br />**Type:** metric                                                                                                                                                                                                                                 |
| <div>CPM</div>                      | Specifies the average cost per thousand ad impressions.<br /><br />**Field Name:** `average_cpm`<br />**Type:** metric                                                                                                                                                                                                                       |
| <div>CPV</div>                      | Average cost-per-view (avg. CPV) is the average amount you paid each time someone viewed your video ad. A view is counted when someone watches 30 seconds of your video ad (or the duration if it's shorter than 30 seconds) or interacts with the ad, whichever comes first.<br /><br />**Field Name:** `average_cpv`<br />**Type:** metric |
| <div>View Through Conversions</div> | Captures the number of conversions following a user's ad impression but no click.<br /><br />**Field Name:** `view_through_conversions`<br />**Type:** metric                                                                                                                                                                                |
| <div>Bounce Rate</div>              | Calculates the percentage of single-page sessions with no subsequent user interaction.<br /><br />**Field Name:** `bounce_rate`<br />**Type:** metric                                                                                                                                                                                        |
| <div>Average Cost</div>             | The average amount you pay per interaction. This amount is the total cost of your ads divided by the total number of interactions.<br /><br />**Field Name:** `average_cost`<br />**Type:** metric                                                                                                                                           |

### Product

|                                          |                                                                                          |
| ---------------------------------------- | ---------------------------------------------------------------------------------------- |
| <div>Average Order Value</div>           | <br /><br />**Field Name:** `average_order_value_micros`<br />**Type:** metric           |
| <div>Cost of Goods Sold</div>            | <br /><br />**Field Name:** `cost_of_goods_sold_micros`<br />**Type:** metric            |
| <div>Gross Profit Margin</div>           | <br /><br />**Field Name:** `gross_profit_margin`<br />**Type:** metric                  |
| <div>Gross Profit</div>                  | <br /><br />**Field Name:** `gross_profit_micros`<br />**Type:** metric                  |
| <div>Revenue</div>                       | <br /><br />**Field Name:** `revenue_micros`<br />**Type:** metric                       |
| <div>Cross Sell Cost of Goods Sold</div> | <br /><br />**Field Name:** `cross_sell_cost_of_goods_sold_micros`<br />**Type:** metric |
| <div>Cross Sell Gross Profit</div>       | <br /><br />**Field Name:** `cross_sell_gross_profit_micros`<br />**Type:** metric       |
| <div>Cross Sell Revenue</div>            | <br /><br />**Field Name:** `cross_sell_revenue_micros`<br />**Type:** metric            |
| <div>Cross Sell Units Sold</div>         | <br /><br />**Field Name:** `cross_sell_units_sold`<br />**Type:** metric                |
| <div>Lead Cost of Goods Sold</div>       | <br /><br />**Field Name:** `lead_cost_of_goods_sold_micros`<br />**Type:** metric       |
| <div>Lead Gross Profit</div>             | <br /><br />**Field Name:** `lead_gross_profit_micros`<br />**Type:** metric             |
| <div>Lead Revenue</div>                  | <br /><br />**Field Name:** `lead_revenue_micros`<br />**Type:** metric                  |
| <div>Lead Units Sold</div>               | <br /><br />**Field Name:** `lead_units_sold`<br />**Type:** metric                      |
| <div>Units Sold</div>                    | <br /><br />**Field Name:** `units_sold`<br />**Type:** metric                           |
| <div>Orders</div>                        | <br /><br />**Field Name:** `orders`<br />**Type:** metric                               |

### Keyword

|                                         |                                                                                                                                              |
| --------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------- |
| <div>Historical Quality Score</div>     | The historical quality score.<br /><br />**Field Name:** `historical_quality_score`<br />**Type:** metric                                    |
| <div>Historical Creative Q.S.</div>     | The creative historical quality score.<br /><br />**Field Name:** `historical_creative_quality_score`<br />**Type:** metric                  |
| <div>Historical Predicted CTR</div>     | The historical search predicted click through rate (CTR).<br /><br />**Field Name:** `historical_search_predicted_ctr`<br />**Type:** metric |
| <div>Historical Landing Page Q.S.</div> | The quality of historical landing page experience.<br /><br />**Field Name:** `historical_landing_page_quality_score`<br />**Type:** metric  |

### Engagement

|                             |                                                                                                                                                                                                                                   |
| --------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| <div>Engagement</div>       | The number of engagements. An engagement occurs when a viewer expands your Lightbox ad.<br /><br />**Field Name:** `engagements`<br />**Type:** metric                                                                            |
| <div>Engagement Rate</div>  | How often people engage with your ad after it's shown to them. This is the number of ad expansions divided by the number of times your ad is shown.<br /><br />**Field Name:** `engagement_rate`<br />**Type:** metric            |
| <div>Interactions</div>     | The number of interactions. An interaction is the main user action associated with an ad format—clicks for text and shopping ads, views for video ads, and so on.<br /><br />**Field Name:** `interactions`<br />**Type:** metric |
| <div>Interaction Rate</div> | How often people interact with your ad after it is shown to them. This is the number of interactions divided by the number of times your ad is shown.<br /><br />**Field Name:** `interaction_rate`<br />**Type:** metric         |

### Conversions

|                                                     |                                                                                                                                                                                                                                                                                                    |
| --------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| <div>All Conversions by Conversions Date</div>      | The total number of conversions. When this column is selected with date, the values in date column means the conversion date.<br /><br />**Field Name:** `all_conversions_by_conversion_date`<br />**Type:** metric                                                                                |
| <div>All Conversions Value by Conversion Date</div> | The value of all conversions. When this column is selected with date, the values in date column means the conversion date.<br /><br />**Field Name:** `all_conversions_value_by_conversion_date`<br />**Type:** metric                                                                             |
| <div>Conversions by Conversion Date</div>           | The number of conversions. When this column is selected with date, the values in date column means the conversion date.<br /><br />**Field Name:** `conversions_by_conversion_date`<br />**Type:** metric                                                                                          |
| <div>Conversions Value by Conversion Date</div>     | The value of conversions. When this column is selected with date, the values in date column means the conversion date.<br /><br />**Field Name:** `conversions_value_by_conversion_date`<br />**Type:** metric                                                                                     |
| <div>New Customer Lifetime Value</div>              | All of new customers' lifetime conversion value. This will include the additional conversion value from new customers for both biddable and non-biddable conversions.<br /><br />**Field Name:** `all_new_customer_lifetime_value`<br />**Type:** metric                                           |
| <div>All Conversions from Interactions Rate</div>   | All conversions from interactions (as opposed to view through conversions) divided by the number of ad interactions.<br /><br />**Field Name:** `all_conversions_from_interactions_rate`<br />**Type:** metric                                                                                     |
| <div>All Conversions Value per Interaction</div>    | The value of all conversions from interactions divided by the total number of interactions.<br /><br />**Field Name:** `all_conversions_from_interactions_value_per_interaction`<br />**Type:** metric                                                                                             |
| <div>Conversions from Interactions Rate</div>       | Conversions from interactions divided by the number of ad interactions. This only includes conversion actions which include\_in\_conversions\_metric attribute is set to true.<br /><br />**Field Name:** `conversions_from_interactions_rate`<br />**Type:** metric                               |
| <div>Conversions Value per Interaction</div>        | The value of conversions from interactions divided by the number of ad interactions. This only includes conversion actions which include\_in\_conversions\_metric attribute is set to true.<br /><br />**Field Name:** `conversions_from_interactions_value_per_interaction`<br />**Type:** metric |
| <div>Cost per All Conversions</div>                 | The cost of ad interactions divided by all conversions.<br /><br />**Field Name:** `cost_per_all_conversions`<br />**Type:** metric                                                                                                                                                                |
| <div>Cost per Conversion</div>                      | The cost of ad interactions divided by conversions. This only includes conversion actions which include\_in\_conversions\_metric attribute is set to true.<br /><br />**Field Name:** `cost_per_conversion`<br />**Type:** metric                                                                  |
| <div>Cross-device Conversions</div>                 | Conversions from when a customer clicks on a Google Ads ad on one device, then converts on a different device or browser. Cross-device conversions are already included in all\_conversions.<br /><br />**Field Name:** `cross_device_conversions`<br />**Type:** metric                           |
| <div>Cross-device Conversions Value</div>           | The sum of the value of cross-device conversions.<br /><br />**Field Name:** `cross_device_conversions_value`<br />**Type:** metric                                                                                                                                                                |
| <div>Value per All Conversions</div>                | The value of all conversions divided by the number of all conversions.<br /><br />**Field Name:** `value_per_all_conversions`<br />**Type:** metric                                                                                                                                                |
| <div>Value per Conversion</div>                     | The value of conversions divided by the number of conversions. This only includes conversion actions which include\_in\_conversions\_metric attribute is set to true.<br /><br />**Field Name:** `value_per_conversion`<br />**Type:** metric                                                      |

### Local Actions

|                                                     |                                                                                                                                                                                                                                                                             |
| --------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| <div>All Conversions from Call Button</div>         | The number of times people clicked the 'Call' button to call a store during or after clicking an ad.<br /><br />**Field Name:** `all_conversions_from_click_to_call`<br />**Type:** metric                                                                                  |
| <div>All Conversions from Directions</div>          | The number of times people clicked a 'Get directions' button to navigate to a store after clicking an ad.<br /><br />**Field Name:** `all_conversions_from_directions`<br />**Type:** metric                                                                                |
| <div>All Conversions from Menu View</div>           | The number of times people clicked a link to view a store's menu after clicking an ad. This metric applies to feed items only.<br /><br />**Field Name:** `all_conversions_from_menu`<br />**Type:** metric                                                                 |
| <div>All Conversions from Store Orders</div>        | The number of times people placed an order at a store after clicking an ad. This metric applies to feed items only.<br /><br />**Field Name:** `all_conversions_from_order`<br />**Type:** metric                                                                           |
| <div>All Conversions from Other Store Actions</div> | The number of other conversions (for example, posting a review or saving a location for a store) that occurred after people clicked an ad. This metric applies to feed items only.<br /><br />**Field Name:** `all_conversions_from_other_engagement`<br />**Type:** metric |
| <div>All Conversions from Store Visits</div>        | Estimated number of times people visited a store after clicking an ad. This metric applies to feed items only.<br /><br />**Field Name:** `all_conversions_from_store_visit`<br />**Type:** metric                                                                          |
| <div>All Conversions from Store Website</div>       | The number of times that people were taken to a store's URL after clicking an ad. This metric applies to feed items only.<br /><br />**Field Name:** `all_conversions_from_store_website`<br />**Type:** metric                                                             |

### Account Budget

|                                                   |                                                                                                                                                      |
| ------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------- |
| <div>Account Budget Amount Served</div>           | The total amount served for the account budget.<br /><br />**Field Name:** `account_budget.amount_served_micros`<br />**Type:** metric               |
| <div>Account Budget Adjusted Spending Limit</div> | The adjusted spending limit for the account budget.<br /><br />**Field Name:** `account_budget.adjusted_spending_limit_micros`<br />**Type:** metric |
| <div>Account Budget Spending Limit</div>          | The approved spending limit for the account budget.<br /><br />**Field Name:** `account_budget.approved_spending_limit_micros`<br />**Type:** metric |
| <div>Account Budget Proposed Spending Limit</div> | The proposed spending limit for the account budget.<br /><br />**Field Name:** `account_budget.proposed_spending_limit_micros`<br />**Type:** metric |
| <div>Account Budget Total Adjustments</div>       | The total adjustments for the account budget.<br /><br />**Field Name:** `account_budget.total_adjustments_micros`<br />**Type:** metric             |

***

## Related

<CardGroup>
  <Card title="Fields Catalog" icon="book" href="/fields-catalog">
    Browse all platforms
  </Card>

  <Card title="Meta Ads Fields" icon="chart-bar" href="/data-source/facebook-ads/fields">
    Meta Ads metrics & dimensions
  </Card>

  <Card title="TikTok Ads Fields" icon="chart-bar" href="/data-source/tiktok-ads/fields">
    TikTok Ads metrics & dimensions
  </Card>

  <Card title="LinkedIn Ads Fields" icon="chart-bar" href="/data-source/linkedin-ads/fields">
    LinkedIn Ads metrics & dimensions
  </Card>
</CardGroup>


# Google Ads Troubleshooting
Source: https://support.detrics.io/data-source/google-ads/troubleshooting

Complete troubleshooting guide for Google Ads integration

<Info>**Last updated:** July 28, 2025</Info>

Having trouble connecting your Google Ads account to Detrics? This comprehensive guide will help you diagnose and resolve the most common connection issues.

## Understanding Google Access Expiration

Google disconnections typically occur when you first start using Detrics. The exact reason for these initial disconnections is unclear, but they commonly happen during the early stages of using the platform. Once this initial issue is resolved through reconnection, you won't need to reconnect again.

**Solution:** When access expires, you'll need to **reconnect your Google Ads account to Detrics** through the connection setup process. This re-establishes the authentication and renews the access tokens.

**Important:** Once you reconnect Google Ads, all your existing queries and Looker Studio dashboards linked to your Google accounts will automatically start working again. The reconnection process fixes all connections at once - you don't need to recreate your queries or dashboards.

**Note: While these steps illustrate Google Ads case, they work for all Google products (Google Analytics 4 and Google Sheets).**

## Fix Persistent Connection Issues (Full Reset)

If reconnecting doesn't resolve your issues, follow these steps for a complete reset. This will fix all your Google Ads queries and dashboards at once.

<Steps>
  <Step title="Remove Google App Connection">
    Go to [Google Account Permissions](https://myaccount.google.com/permissions)
    and revoke access to the Detrics app.

    <Frame>
      <div>
        <img alt="Google Account Permissions" />

        <img alt="Revoke Detrics Access" />
      </div>
    </Frame>
  </Step>

  <Step title="Open Google Sheets">
    Open a new Google Spreadsheet or [click here](https://sheets.new) to create
    a new sheet directly.
  </Step>

  <Step title="Launch Detrics">
    Fire up Detrics: Select *Extensions* > *Detrics* > *Launch*

    <Frame>
      <img alt="Google Sheets Extensions Menu - Detrics Launch" />
    </Frame>
  </Step>

  <Step title="Connect Data Source">
    Click on *"Connect Data Source"*

    <Frame>
      <img alt="Detrics Connect Data Source Button" />
    </Frame>
  </Step>

  <Step title="Select Data Source">
    Choose Google Ads from the list of available data sources.

    <Frame>
      <img alt="Select Google Ads Data Source" />
    </Frame>
  </Step>

  <Step title="Reconnect Google Ads">
    Complete the reconnection process to re-establish access.

    <Frame>
      <img alt="Google Ads Reconnection" />
    </Frame>
  </Step>

  <Step title="Connect Google Sheets">
    Reconnect Google Sheets to complete the process.

    <Frame>
      <img alt="Connect Google Sheets" />
    </Frame>
  </Step>
</Steps>

<Warning>
  **⚠️ IMPORTANT:** After completing this process, you must reconnect ALL Google products you use with Detrics:

  * Google Analytics 4
  * DV360
  * Google Sheets
  * Google Ads
  * Google Search Console

  Failure to reconnect all products will result in incomplete data synchronization.
</Warning>

## Shared Connection Between Google Sheets and Looker Studio

Google Sheets and Looker Studio share the same Google Ads connection. This means:

* **Single reconnection fixes both platforms:** When you reconnect Google Ads through Google Sheets, your Looker Studio dashboards are automatically fixed too
* **No duplicate setup needed:** You only need to reconnect once, regardless of which platform you primarily use

### Alternative: Reconnect Through Looker Studio

Looker Studio users can also reconnect Google Ads directly through Looker Studio:

1. Open your Looker Studio dashboard that uses Google Ads data
2. Click on any chart showing connection errors
3. Select "Reconnect" when prompted
4. Complete the Google Ads authentication process
5. All your Google Ads queries in both Looker Studio and Google Sheets will be restored

<Tip>
  **Need help?** If errors persist after following these steps, please reach out
  to [support@detrics.io](mailto:support@detrics.io)
</Tip>


# Google Analytics 4 Metrics & Dimensions
Source: https://support.detrics.io/data-source/google-analytics-4/fields

Complete reference for Google Analytics 4 dimensions and metrics

<Info>
  **Last updated:** August 6, 2026
</Info>

<div>
  <div>
    168 dimensions
  </div>

  <div>
    84 metrics
  </div>
</div>

This reference covers all available dimensions and metrics for Google Analytics 4 data through Detrics. Use this guide to understand what data you can extract and how to structure your queries.

<div>
  <span>Supported destinations:</span>

  <div>
    Google Sheets
  </div>

  <div>
    Looker Studio
  </div>

  <div>
    Claude
  </div>

  <div>
    BigQuery
  </div>
</div>

## Dimensions

Dimensions are the attributes you can use to segment and group your Google Analytics 4 data.

### Traffic Sources

|                                          |                                                                                                                                                                                                                                                                                                                                                                              |
| ---------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| <div>Session Source</div>                | The source that initiated a session on your website or app. For example,if people visit from google.com,your traffic sourceis 'google'. Attribution Model: Last Click.<br /><br />**Field Name:** `sessionSource`<br />**Type:** dimension                                                                                                                                   |
| <div>Session Medium</div>                | The medium that initiated a session on your website or app. It is the category of the traffic source.For example,if people visit yourwebsite from google 's organic search results, the medium would be 'organic'. Attribution Model: Last Click.<br /><br />**Field Name:** `sessionMedium`<br />**Type:** dimension                                                        |
| <div>Session Campaign ID</div>           | The ID of the marketing campaign driving traffic to your website or app. You can send the campaign ID using UTM parameters on your ad 's links. Attribution Model: Last Click.<br /><br />**Field Name:** `sessionCampaignId`<br />**Type:** dimension                                                                                                                       |
| <div>Session Campaign Name</div>         | The name of the marketing campaign driving traffic to your website or app. You can send the campaign name using UTM parameters on your ad 's links. Attribution Model: Last Click.<br /><br />**Field Name:** `sessionCampaignName`<br />**Type:** dimension                                                                                                                 |
| <div>Session Content</div>               | The ad content that led to a session. Populated by the utm\_content parameter. Attribution Model: Last Click.<br /><br />**Field Name:** `sessionManualAdContent`<br />**Type:** dimension                                                                                                                                                                                   |
| <div>Session Default Channel Group</div> | The default channel group is based primarily on source and medium.GA4 defined traffic categories which includes 'Direct','Organic Search ', 'Paid Social ', 'OrganicSocial ', 'Email ', 'Affiliates ', 'Referral ', 'Paid Search ', 'Video ', and 'Display'. Attribution Model: Last Click.<br /><br />**Field Name:** `sessionDefaultChannelGroup`<br />**Type:** dimension |
| <div>Session Source / Medium</div>       | The combined values of the source and medium dimensions. It is very common to see those two values together. Attribution Model: Last Click.<br /><br />**Field Name:** `sessionSourceMedium`<br />**Type:** dimension                                                                                                                                                        |
| <div>Session Manual Term</div>           | The term that led to a session. Populated by the utm\_term parameter. Attribution Model: Last Click.<br /><br />**Field Name:** `sessionManualTerm`<br />**Type:** dimension                                                                                                                                                                                                 |

### Account

|                          |                                                                                                                            |
| ------------------------ | -------------------------------------------------------------------------------------------------------------------------- |
| <div>Account ID</div>    | <br /><br />**Field Name:** `accountId`<br />**Type:** dimension                                                           |
| <div>Account Name</div>  | <br /><br />**Field Name:** `accountName`<br />**Type:** dimension                                                         |
| <div>Property ID</div>   | <br /><br />**Field Name:** `propertyId`<br />**Type:** dimension                                                          |
| <div>Property Name</div> | <br /><br />**Field Name:** `propertyName`<br />**Type:** dimension                                                        |
| <div>Stream ID</div>     | The numeric data stream identifier for your app or website.<br /><br />**Field Name:** `streamId`<br />**Type:** dimension |
| <div>Stream Name</div>   | The data stream name for your app or website.<br /><br />**Field Name:** `streamName`<br />**Type:** dimension             |

### Events

|                          |                                                                                                                                                                                        |
| ------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| <div>Event Name</div>    | <br /><br />**Field Name:** `eventName`<br />**Type:** dimension                                                                                                                       |
| <div>Is Conversion</div> | <br /><br />**Field Name:** `isConversionEvent`<br />**Type:** dimension                                                                                                               |
| <div>Is Key Event</div>  | The string "true" if the event is a key event. Marking an event as a key event affects reports from time of creation.<br /><br />**Field Name:** `isKeyEvent`<br />**Type:** dimension |
| <div>Method</div>        | The method by which an event was triggered. Populated by the event parameter method.<br /><br />**Field Name:** `method`<br />**Type:** dimension                                      |

### First Click Attribution

|                                                  |                                                                                                                                                                                                                                                                                                                                                                                                                                |
| ------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| <div>Default Channel Group</div>                 | The default channel group that first acquired the user. Default channel group is based primarily on source and medium. An enumeration which includes 'Direct', 'Organic Search', 'Paid Social', 'Organic Social', 'Email', 'Affiliates', 'Referral', 'Paid Search', 'Video', and 'Display'.<br /><br />**Field Name:** `firstUserDefaultChannelGroup`<br />**Type:** dimension                                                 |
| <div>Campaign ID</div>                           | ID of the marketing campaign that first acquired the user.<br /><br />**Field Name:** `firstUserCampaignId`<br />**Type:** dimension                                                                                                                                                                                                                                                                                           |
| <div>Campaign Name</div>                         | Name of the marketing campaign that first acquired the user.<br /><br />**Field Name:** `firstUserCampaignName`<br />**Type:** dimension                                                                                                                                                                                                                                                                                       |
| <div>Source</div>                                | The utm\_source that first acquired the user.<br /><br />**Field Name:** `firstUserSource`<br />**Type:** dimension                                                                                                                                                                                                                                                                                                            |
| <div>Medium</div>                                | The utm\_medium that first acquired the user.<br /><br />**Field Name:** `firstUserMedium`<br />**Type:** dimension                                                                                                                                                                                                                                                                                                            |
| <div>First User Google Ads Account Name</div>    | The Account name from Google Ads that first acquired the user.<br /><br />**Field Name:** `firstUserGoogleAdsAccountName`<br />**Type:** dimension                                                                                                                                                                                                                                                                             |
| <div>First User Google Ads Ad Group ID</div>     | The Ad Group Id in Google Ads that first acquired the user.<br /><br />**Field Name:** `firstUserGoogleAdsAdGroupId`<br />**Type:** dimension                                                                                                                                                                                                                                                                                  |
| <div>First User Google Ads Ad Group Name</div>   | The Ad Group Name in Google Ads that first acquired the user.<br /><br />**Field Name:** `firstUserGoogleAdsAdGroupName`<br />**Type:** dimension                                                                                                                                                                                                                                                                              |
| <div>First User Google Ads Ad Network Type</div> | The advertising network that first acquired the user. An enumeration which includes Google search, Search partners, Google Display Network, YouTube Search, YouTube Videos, Cross-network, Social, and (universal campaign).<br /><br />**Field Name:** `firstUserGoogleAdsAdNetworkType`<br />**Type:** dimension                                                                                                             |
| <div>First User Google Ads Campaign ID</div>     | Identifier of the Google Ads marketing campaign that first acquired the user.<br /><br />**Field Name:** `firstUserGoogleAdsCampaignId`<br />**Type:** dimension                                                                                                                                                                                                                                                               |
| <div>First User Google Ads Campaign Name</div>   | Name of the Google Ads marketing campaign that first acquired the user.<br /><br />**Field Name:** `firstUserGoogleAdsCampaignName`<br />**Type:** dimension                                                                                                                                                                                                                                                                   |
| <div>First User Google Ads Campaign Type</div>   | The campaign type of the Google Ads campaign that first acquired the user. Campaign types determine where customers see your ads and the settings and options available to you in Google Ads. Campaign type is an enumeration that includes: Search, Display, Shopping, Video, Demand Gen, App, Smart, Hotel, Local, and Performance Max.<br /><br />**Field Name:** `firstUserGoogleAdsCampaignType`<br />**Type:** dimension |
| <div>First User Google Ads Creative ID</div>     | The ID of the Google Ads creative that first acquired the user. Creative IDs identify individual ads.<br /><br />**Field Name:** `firstUserGoogleAdsCreativeId`<br />**Type:** dimension                                                                                                                                                                                                                                       |
| <div>First User Google Ads Customer ID</div>     | The Customer ID from Google Ads that first acquired the user. Customer IDs in Google Ads uniquely identify Google Ads accounts.<br /><br />**Field Name:** `firstUserGoogleAdsCustomerId`<br />**Type:** dimension                                                                                                                                                                                                             |
| <div>First User Google Ads Keyword Text</div>    | The matched keyword that first acquired the user. Keywords are words or phrases describing your product or service that you choose to get your ad in front of the right customers.<br /><br />**Field Name:** `firstUserGoogleAdsKeyword`<br />**Type:** dimension                                                                                                                                                             |
| <div>First User Google Ads Query</div>           | The search query that first acquired the user.<br /><br />**Field Name:** `firstUserGoogleAdsQuery`<br />**Type:** dimension                                                                                                                                                                                                                                                                                                   |

### Google Ads Traffic Sources

|                                               |                                                                                                                                                                                                                                                                                                             |
| --------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| <div>Session Google Ads Account Name</div>    | The Account name from Google Ads that led to the session. Corresponds to customer.descriptive\_name in the Google Ads API.<br /><br />**Field Name:** `sessionGoogleAdsAccountName`<br />**Type:** dimension                                                                                                |
| <div>Session Google Ads Ad Group ID</div>     | The Ad Group Id in Google Ads for a session.<br /><br />**Field Name:** `sessionGoogleAdsAdGroupId`<br />**Type:** dimension                                                                                                                                                                                |
| <div>Session Google Ads Ad Group Name</div>   | The Ad Group Name in Google Ads for a session.<br /><br />**Field Name:** `sessionGoogleAdsAdGroupName`<br />**Type:** dimension                                                                                                                                                                            |
| <div>Session Google Ads Ad Network Type</div> | The advertising network that led to the session. An enumeration which includes Google search, Search partners, Google Display Network, YouTube Search, YouTube Videos, Cross-network, Social, and (universal campaign).<br /><br />**Field Name:** `sessionGoogleAdsAdNetworkType`<br />**Type:** dimension |
| <div>Session Google Ads Campaign ID</div>     | The Campaign ID for the Google Ads Campaign that led to this session.<br /><br />**Field Name:** `sessionGoogleAdsCampaignId`<br />**Type:** dimension                                                                                                                                                      |
| <div>Session Google Ads Campaign Name</div>   | The Campaign name for the Google Ads Campaign that led to this session.<br /><br />**Field Name:** `sessionGoogleAdsCampaignName`<br />**Type:** dimension                                                                                                                                                  |
| <div>Session Google Ads Campaign Type</div>   | The campaign type for the Google Ads campaign that led to this session. Campaign types determine where customers see your ads and the settings and options available to you in Google Ads.<br /><br />**Field Name:** `sessionGoogleAdsCampaignType`<br />**Type:** dimension                               |
| <div>Session Google Ads Creative ID</div>     | The ID of the Google Ads creative that led to a session on your website or app. Creative IDs identify individual ads.<br /><br />**Field Name:** `sessionGoogleAdsCreativeId`<br />**Type:** dimension                                                                                                      |
| <div>Session Google Ads Customer ID</div>     | The Customer ID from Google Ads that led to the session. Customer IDs in Google Ads uniquely identify Google Ads accounts.<br /><br />**Field Name:** `sessionGoogleAdsCustomerId`<br />**Type:** dimension                                                                                                 |
| <div>Session Google Ads Keyword Text</div>    | The matched keyword that led to the session. Keywords are words or phrases describing your product or service that you choose to get your ad in front of the right customers.<br /><br />**Field Name:** `sessionGoogleAdsKeyword`<br />**Type:** dimension                                                 |
| <div>Session Google Ads Query</div>           | The search query that led to the session.<br /><br />**Field Name:** `sessionGoogleAdsQuery`<br />**Type:** dimension                                                                                                                                                                                       |

### Data Driven Attribution

|                                       |                                                                                                                                                                                                                                                                                                        |
| ------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| <div>Default Channel Group</div>      | These dimensions are compatible only with Conversion Events metrics. The default attribution model is data driven on all GA4 properties by default, but you can change it to First or Last click on the admin configuration.<br /><br />**Field Name:** `defaultChannelGroup`<br />**Type:** dimension |
| <div>Campaign ID</div>                | The identifier of the marketing campaign. Present only for Conversion Events. Includes Google Ads Campaigns, Manual Campaigns & other Campaigns.<br /><br />**Field Name:** `campaignId`<br />**Type:** dimension                                                                                      |
| <div>Campaign Name</div>              | The name of the marketing campaign. Present only for Conversion Events. Includes Google Ads Campaigns, Manual Campaigns, & other Campaigns.<br /><br />**Field Name:** `campaignName`<br />**Type:** dimension                                                                                         |
| <div>Ad Group ID</div>                | The ad group id attributed to the Conversion Event.<br /><br />**Field Name:** `googleAdsAdGroupId`<br />**Type:** dimension                                                                                                                                                                           |
| <div>Source</div>                     | The source attributed to the Conversion Event.<br /><br />**Field Name:** `source`<br />**Type:** dimension                                                                                                                                                                                            |
| <div>Medium</div>                     | The medium attributed to the Conversion Event.<br /><br />**Field Name:** `medium`<br />**Type:** dimension                                                                                                                                                                                            |
| <div>Manual Term</div>                | The term attributed to the Conversion Event. Populated by the utm\_term parameter.<br /><br />**Field Name:** `manualTerm`<br />**Type:** dimension                                                                                                                                                    |
| <div>Manual Ad Content</div>          | TThe ad content attributed to the Conversion Event. Populated by the utm\_content parameter.<br /><br />**Field Name:** `manualAdContent`<br />**Type:** dimension                                                                                                                                     |
| <div>Google Ads Account Name</div>    | The Account name from Google Ads for the campaign that led to the key event. Corresponds to customer.descriptive\_name in the Google Ads API.<br /><br />**Field Name:** `googleAdsAccountName`<br />**Type:** dimension                                                                               |
| <div>Google Ads Ad Group Name</div>   | The ad group name attributed to the key event.<br /><br />**Field Name:** `googleAdsAdGroupName`<br />**Type:** dimension                                                                                                                                                                              |
| <div>Google Ads Ad Network Type</div> | The advertising network type of the key event. An enumeration which includes Google search, Search partners, Google Display Network, YouTube Search, YouTube Videos, Cross-network, Social, and (universal campaign).<br /><br />**Field Name:** `googleAdsAdNetworkType`<br />**Type:** dimension     |
| <div>Google Ads Campaign ID</div>     | The campaign ID for the Google Ads campaign attributed to the key event.<br /><br />**Field Name:** `googleAdsCampaignId`<br />**Type:** dimension                                                                                                                                                     |
| <div>Google Ads Campaign Name</div>   | The campaign name for the Google Ads campaign attributed to the key event.<br /><br />**Field Name:** `googleAdsCampaignName`<br />**Type:** dimension                                                                                                                                                 |
| <div>Google Ads Campaign Type</div>   | The campaign type for the Google Ads campaign attributed to the key event. Campaign types determine where customers see your ads and the settings and options available to you in Google Ads.<br /><br />**Field Name:** `googleAdsCampaignType`<br />**Type:** dimension                              |
| <div>Google Ads Creative ID</div>     | The ID of the Google Ads creative attributed to the key event. Creative IDs identify individual ads.<br /><br />**Field Name:** `googleAdsCreativeId`<br />**Type:** dimension                                                                                                                         |
| <div>Google Ads Customer ID</div>     | The Customer ID from Google Ads for the campaign that led to the key event. Customer IDs in Google Ads uniquely identify Google Ads accounts.<br /><br />**Field Name:** `googleAdsCustomerId`<br />**Type:** dimension                                                                                |
| <div>Google Ads Keyword Text</div>    | The matched keyword that led to the key event. Keywords are words or phrases describing your product or service that you choose to get your ad in front of the right customers.<br /><br />**Field Name:** `googleAdsKeyword`<br />**Type:** dimension                                                 |
| <div>Google Ads Query</div>           | The search query that led to the key event.<br /><br />**Field Name:** `googleAdsQuery`<br />**Type:** dimension                                                                                                                                                                                       |

### Page Tracking

|                                        |                                                                                                                                                                                                                                                                                                                                                                                                                           |
| -------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| <div>Host Name</div>                   | Includes the subdomain and domain names of a URL; for example, the Host Name of [www.example.com/contact.html](http://www.example.com/contact.html) is [www.example.com](http://www.example.com)<br /><br />**Field Name:** `hostName`<br />**Type:** dimension                                                                                                                                                           |
| <div>Page Path</div>                   | The portion of the URL between the hostname and query string for web pages visited; for example, the pagePath portion of [https://www.example.com/store/contact-us?query\_string=true](https://www.example.com/store/contact-us?query_string=true) is /store/contact-us<br /><br />**Field Name:** `pagePath`<br />**Type:** dimension                                                                                    |
| <div>Page Title</div>                  | The web page titles used on your site.<br /><br />**Field Name:** `pageTitle`<br />**Type:** dimension                                                                                                                                                                                                                                                                                                                    |
| <div>Landing Page + Query String</div> | The page path + query string associated with the first pageview in a session.<br /><br />**Field Name:** `landingPagePlusQueryString`<br />**Type:** dimension                                                                                                                                                                                                                                                            |
| <div>Page Referrer</div>               | The full referring URL including the hostname and path. This referring URL is the user's previous URL and can be this website's domain or other domains. Populated by the event parameter 'page\_referrer'.<br /><br />**Field Name:** `pageReferrer`<br />**Type:** dimension                                                                                                                                            |
| <div>File Extension</div>              | The extension of the downloaded file (for example, pdf or txt). Automatically populated if Enhanced Measurement is enabled.<br /><br />**Field Name:** `fileExtension`<br />**Type:** dimension                                                                                                                                                                                                                           |
| <div>File Name</div>                   | The page path of the downloaded file (for example, /menus/dinner-menu.pdf). Automatically populated if Enhanced Measurement is enabled.<br /><br />**Field Name:** `fileName`<br />**Type:** dimension                                                                                                                                                                                                                    |
| <div>Full Page URL</div>               | The hostname, page path, and query string for web pages visited; for example, the fullPageUrl portion of [https://www.example.com/store/contact-us?query\_string=true](https://www.example.com/store/contact-us?query_string=true) is [www.example.com/store/contact-us?query\_string=true](http://www.example.com/store/contact-us?query_string=true).<br /><br />**Field Name:** `fullPageUrl`<br />**Type:** dimension |
| <div>Link Classes</div>                | The HTML class attribute for an outbound link. Automatically populated if Enhanced Measurement is enabled.<br /><br />**Field Name:** `linkClasses`<br />**Type:** dimension                                                                                                                                                                                                                                              |
| <div>Link Domain</div>                 | The destination domain of the outbound link. Automatically populated if Enhanced Measurement is enabled.<br /><br />**Field Name:** `linkDomain`<br />**Type:** dimension                                                                                                                                                                                                                                                 |
| <div>Link ID</div>                     | The HTML ID attribute for an outbound link or file download. Automatically populated if Enhanced Measurement is enabled.<br /><br />**Field Name:** `linkId`<br />**Type:** dimension                                                                                                                                                                                                                                     |
| <div>Link Text</div>                   | The link text of the file download. Automatically populated if Enhanced Measurement is enabled.<br /><br />**Field Name:** `linkText`<br />**Type:** dimension                                                                                                                                                                                                                                                            |
| <div>Link URL</div>                    | The full URL for an outbound link or file download. Automatically populated if Enhanced Measurement is enabled.<br /><br />**Field Name:** `linkUrl`<br />**Type:** dimension                                                                                                                                                                                                                                             |
| <div>Outbound</div>                    | Returns true if the link led to a site that is not a part of the property's domain. Automatically populated if Enhanced Measurement is enabled.<br /><br />**Field Name:** `outbound`<br />**Type:** dimension                                                                                                                                                                                                            |
| <div>Percent Scrolled</div>            | The percentage down the page that the user has scrolled (for example, 90). Automatically populated if Enhanced Measurement is enabled.<br /><br />**Field Name:** `percentScrolled`<br />**Type:** dimension                                                                                                                                                                                                              |
| <div>Search Term</div>                 | The term searched by the user. Automatically populated if Enhanced Measurement is enabled.<br /><br />**Field Name:** `searchTerm`<br />**Type:** dimension                                                                                                                                                                                                                                                               |

### E-commerce

|                                  |                                                                                                                                                 |
| -------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------- |
| <div>Transaction ID</div>        | <br /><br />**Field Name:** `transactionId`<br />**Type:** dimension                                                                            |
| <div>Order Coupon</div>          | <br /><br />**Field Name:** `orderCoupon`<br />**Type:** dimension                                                                              |
| <div>Shipping Tier</div>         | <br /><br />**Field Name:** `shippingTier`<br />**Type:** dimension                                                                             |
| <div>Currency</div>              | The local currency code (based on ISO 4217 standard) of the eCommerce event.<br /><br />**Field Name:** `currencyCode`<br />**Type:** dimension |
| <div>Virtual Currency Name</div> | The name of a virtual currency with which the user is interacting.<br /><br />**Field Name:** `virtualCurrencyName`<br />**Type:** dimension    |

### Geography

|                         |                                                                                                                                                                          |
| ----------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| <div>Continent</div>    | <br /><br />**Field Name:** `continent`<br />**Type:** dimension                                                                                                         |
| <div>Country</div>      | <br /><br />**Field Name:** `country`<br />**Type:** dimension                                                                                                           |
| <div>Region</div>       | <br /><br />**Field Name:** `region`<br />**Type:** dimension                                                                                                            |
| <div>City</div>         | <br /><br />**Field Name:** `city`<br />**Type:** dimension                                                                                                              |
| <div>City ID</div>      | The geographic ID of the city from which the user activity originated, derived from their IP address.<br /><br />**Field Name:** `cityId`<br />**Type:** dimension       |
| <div>Continent ID</div> | The geographic ID of the continent from which the user activity originated.<br /><br />**Field Name:** `continentId`<br />**Type:** dimension                            |
| <div>Country ID</div>   | The geographic ID of the country from which the user activity originated, derived from their IP address.<br /><br />**Field Name:** `countryId`<br />**Type:** dimension |

### Device

|                                          |                                                                                                                                                                                                                                  |
| ---------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| <div>Device Category</div>               | <br /><br />**Field Name:** `deviceCategory`<br />**Type:** dimension                                                                                                                                                            |
| <div>Operating System</div>              | <br /><br />**Field Name:** `operatingSystem`<br />**Type:** dimension                                                                                                                                                           |
| <div>Browser</div>                       | <br /><br />**Field Name:** `browser`<br />**Type:** dimension                                                                                                                                                                   |
| <div>Mobile Device Branding</div>        | <br /><br />**Field Name:** `mobileDeviceBranding`<br />**Type:** dimension                                                                                                                                                      |
| <div>Mobile Device Model</div>           | <br /><br />**Field Name:** `mobileDeviceModel`<br />**Type:** dimension                                                                                                                                                         |
| <div>Device Model</div>                  | The mobile device model (example: iPhone 10,6).<br /><br />**Field Name:** `deviceModel`<br />**Type:** dimension                                                                                                                |
| <div>Device</div>                        | The branded device name (examples: Galaxy S10 or P30 Pro).<br /><br />**Field Name:** `mobileDeviceMarketingName`<br />**Type:** dimension                                                                                       |
| <div>OS Version</div>                    | The operating system versions used by visitors to your website or app. For example, Android 10's version is 10, and iOS 13.5.1's version is 13.5.1.<br /><br />**Field Name:** `operatingSystemVersion`<br />**Type:** dimension |
| <div>Operating System with Version</div> | The operating system and version. For example, Android 10 or Windows 7.<br /><br />**Field Name:** `operatingSystemWithVersion`<br />**Type:** dimension                                                                         |

### User Characteristics

|                                   |                                                                                                                                                                                                                                                                                                          |
| --------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| <div>Age</div>                    | <br /><br />**Field Name:** `userAgeBracket`<br />**Type:** dimension                                                                                                                                                                                                                                    |
| <div>Gender</div>                 | <br /><br />**Field Name:** `userGender`<br />**Type:** dimension                                                                                                                                                                                                                                        |
| <div>Language</div>               | <br /><br />**Field Name:** `language`<br />**Type:** dimension                                                                                                                                                                                                                                          |
| <div>Interests</div>              | Interests demonstrated by users who are higher in the shopping funnel. Users can be counted in multiple interest categories. For example, Shoppers, Lifestyles & Hobbies/Pet Lovers, or Travel/Travel Buffs/Beachbound Travelers.<br /><br />**Field Name:** `brandingInterest`<br />**Type:** dimension |
| <div>New / Returning</div>        | New users have 0 previous sessions, and returning users have 1 or more previous sessions. This dimension returns two values: new or returning.<br /><br />**Field Name:** `newVsReturning`<br />**Type:** dimension                                                                                      |
| <div>Language Code</div>          | The language setting (ISO 639) of the user's browser or device. For example, en-us.<br /><br />**Field Name:** `languageCode`<br />**Type:** dimension                                                                                                                                                   |
| <div>Signed in with User ID</div> | The string "yes" if the user signed in with the User-ID feature.<br /><br />**Field Name:** `signedInWithUserId`<br />**Type:** dimension                                                                                                                                                                |

### Store Items

|                               |                                                                                                                                                                                                                  |
| ----------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| <div>Item ID</div>            | <br /><br />**Field Name:** `itemId`<br />**Type:** dimension                                                                                                                                                    |
| <div>Item Brand</div>         | <br /><br />**Field Name:** `itemBrand`<br />**Type:** dimension                                                                                                                                                 |
| <div>Item Category</div>      | <br /><br />**Field Name:** `itemCategory`<br />**Type:** dimension                                                                                                                                              |
| <div>Item Name</div>          | <br /><br />**Field Name:** `itemName`<br />**Type:** dimension                                                                                                                                                  |
| <div>Item Variant</div>       | <br /><br />**Field Name:** `itemVariant`<br />**Type:** dimension                                                                                                                                               |
| <div>Item Affiliation</div>   | <br /><br />**Field Name:** `itemAffiliation`<br />**Type:** dimension                                                                                                                                           |
| <div>Item Category 2</div>    | The hierarchical category in which the item is classified. For example, in Apparel/Mens/Summer/Shirts/T-shirts, Mens is the item category 2.<br /><br />**Field Name:** `itemCategory2`<br />**Type:** dimension |
| <div>Item Category 3</div>    | The hierarchical category in which the item is classified.<br /><br />**Field Name:** `itemCategory3`<br />**Type:** dimension                                                                                   |
| <div>Item Category 4</div>    | The hierarchical category in which the item is classified.<br /><br />**Field Name:** `itemCategory4`<br />**Type:** dimension                                                                                   |
| <div>Item Category 5</div>    | The hierarchical category in which the item is classified.<br /><br />**Field Name:** `itemCategory5`<br />**Type:** dimension                                                                                   |
| <div>Item List ID</div>       | The ID of the item list.<br /><br />**Field Name:** `itemListId`<br />**Type:** dimension                                                                                                                        |
| <div>Item List Name</div>     | The name of the item list.<br /><br />**Field Name:** `itemListName`<br />**Type:** dimension                                                                                                                    |
| <div>Item List Position</div> | The position of an item in a list.<br /><br />**Field Name:** `itemListPosition`<br />**Type:** dimension                                                                                                        |
| <div>Item Location ID</div>   | The physical location associated with the item.<br /><br />**Field Name:** `itemLocationID`<br />**Type:** dimension                                                                                             |

### App Info

|                                       |                                                                                                                                                       |
| ------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------- |
| <div>App Version</div>                | <br /><br />**Field Name:** `appVersion`<br />**Type:** dimension                                                                                     |
| <div>Screen Resolution</div>          | <br /><br />**Field Name:** `screenResolution`<br />**Type:** dimension                                                                               |
| <div>Platform</div>                   | The platform on which your app or website ran; for example, web, iOS, or Android.<br /><br />**Field Name:** `platform`<br />**Type:** dimension      |
| <div>Platform / Device Category</div> | The platform and type of device on which your website or mobile app ran.<br /><br />**Field Name:** `platformDeviceCategory`<br />**Type:** dimension |

### Ads

|                      |                                                                                                                                                                                                              |
| -------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| <div>Ad Format</div> | Describes the way ads looked and where they were located. Typical formats include Interstitial, Banner, Rewarded, and Native advanced.<br /><br />**Field Name:** `adFormat`<br />**Type:** dimension        |
| <div>Ad Source</div> | The source network that served the ad. Typical sources include AdMob Network, Liftoff, Facebook Audience Network, and Mediated house ads.<br /><br />**Field Name:** `adSourceName`<br />**Type:** dimension |
| <div>Ad Unit</div>   | The name you chose to describe this Ad unit. Ad units are containers you place in your apps to show ads to users.<br /><br />**Field Name:** `adUnitName`<br />**Type:** dimension                           |

### Audience

|                                   |                                                                                                                                                                                                                                                                                     |
| --------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| <div>Audience ID</div>            | The numeric identifier of an Audience. Users are reported in the audiences to which they belonged during the report's date range. Current user behavior does not affect historical audience membership in reports.<br /><br />**Field Name:** `audienceId`<br />**Type:** dimension |
| <div>Audience Name</div>          | The given name of an Audience. Users are reported in the audiences to which they belonged during the report's date range. Current user behavior does not affect historical audience membership in reports.<br /><br />**Field Name:** `audienceName`<br />**Type:** dimension       |
| <div>Audience Resource Name</div> | The resource name of this audience. Resource names contain both collection & resource identifiers to uniquely identify a resource.<br /><br />**Field Name:** `audienceResourceName`<br />**Type:** dimension                                                                       |

### Campaign Manager 360

|                                   |                                                                                                                                                                                                                                            |
| --------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| <div>CM360 Account ID</div>       | The CM360 Account ID that led to the key event. Identifies the CM360 Account.<br /><br />**Field Name:** `cm360AccountId`<br />**Type:** dimension                                                                                         |
| <div>CM360 Account Name</div>     | The CM360 Account Name that led to the key event. A CM360 account consists of advertisers, sites, campaigns, and user profiles.<br /><br />**Field Name:** `cm360AccountName`<br />**Type:** dimension                                     |
| <div>CM360 Advertiser ID</div>    | The CM360 Advertiser ID that led to the key event. A CM360 Advertiser contains a group of campaigns, creative assets, and other settings.<br /><br />**Field Name:** `cm360AdvertiserId`<br />**Type:** dimension                          |
| <div>CM360 Advertiser Name</div>  | The CM360 Advertiser Name that led to the key event. A CM360 Advertiser contains a group of campaigns, creative assets, and other settings.<br /><br />**Field Name:** `cm360AdvertiserName`<br />**Type:** dimension                      |
| <div>CM360 Campaign ID</div>      | The CM360 Campaign ID that led to the key event. A CM360 campaign can be configured to specify when your ads run, what landing pages are used, and other properties.<br /><br />**Field Name:** `cm360CampaignId`<br />**Type:** dimension |
| <div>CM360 Campaign Name</div>    | The CM360 Campaign Name that led to the key event.<br /><br />**Field Name:** `cm360CampaignName`<br />**Type:** dimension                                                                                                                 |
| <div>CM360 Creative ID</div>      | The CM360 Creative ID that led to the key event. Identifies a CM360 creative.<br /><br />**Field Name:** `cm360CreativeId`<br />**Type:** dimension                                                                                        |
| <div>CM360 Creative Name</div>    | The CM360 Creative Name that led to the key event.<br /><br />**Field Name:** `cm360CreativeName`<br />**Type:** dimension                                                                                                                 |
| <div>CM360 Creative Type</div>    | The CM360 Creative Type that led to the key event. A category of CM360 creatives like "Display" or "Tracking".<br /><br />**Field Name:** `cm360CreativeType`<br />**Type:** dimension                                                     |
| <div>CM360 Creative Version</div> | The CM360 Creative Version that led to the key event.<br /><br />**Field Name:** `cm360CreativeVersion`<br />**Type:** dimension                                                                                                           |
| <div>CM360 Medium</div>           | The CM360 Medium that led to the key event. The CM360 medium is also referred to as the placement cost structure.<br /><br />**Field Name:** `cm360Medium`<br />**Type:** dimension                                                        |
| <div>CM360 Source</div>           | The CM360 Source that led to the key event.<br /><br />**Field Name:** `cm360Source`<br />**Type:** dimension                                                                                                                              |
| <div>CM360 Source / Medium</div>  | The CM360 Source Medium that led to the key event. A combination of the source and medium.<br /><br />**Field Name:** `cm360SourceMedium`<br />**Type:** dimension                                                                         |

### Display & Video 360

|                                       |                                                                                                                                                                                                                 |
| ------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| <div>DV360 Advertiser ID</div>        | The DV360 Advertiser ID that led to the key event. Identifies the DV360 advertiser.<br /><br />**Field Name:** `dv360AdvertiserId`<br />**Type:** dimension                                                     |
| <div>DV360 Advertiser Name</div>      | The DV360 Advertiser Name that led to the key event. DV360 advertisers represent real-life businesses that run advertising campaigns.<br /><br />**Field Name:** `dv360AdvertiserName`<br />**Type:** dimension |
| <div>DV360 Campaign ID</div>          | The DV360 Campaign ID that led to the key event. Identifies the DV360 campaign.<br /><br />**Field Name:** `dv360CampaignId`<br />**Type:** dimension                                                           |
| <div>DV360 Campaign Name</div>        | The DV360 Campaign Name that led to the key event.<br /><br />**Field Name:** `dv360CampaignName`<br />**Type:** dimension                                                                                      |
| <div>DV360 Creative ID</div>          | The DV360 Creative ID that led to the key event.<br /><br />**Field Name:** `dv360CreativeId`<br />**Type:** dimension                                                                                          |
| <div>DV360 Creative Name</div>        | The DV360 Creative Name that led to the key event.<br /><br />**Field Name:** `dv360CreativeName`<br />**Type:** dimension                                                                                      |
| <div>DV360 Insertion Order ID</div>   | The DV360 Insertion Order ID that led to the key event.<br /><br />**Field Name:** `dv360InsertionOrderId`<br />**Type:** dimension                                                                             |
| <div>DV360 Insertion Order Name</div> | The DV360 Insertion Order Name that led to the key event.<br /><br />**Field Name:** `dv360InsertionOrderName`<br />**Type:** dimension                                                                         |
| <div>DV360 Line Item ID</div>         | The DV360 Line Item ID that led to the key event.<br /><br />**Field Name:** `dv360LineItemId`<br />**Type:** dimension                                                                                         |
| <div>DV360 Line Item Name</div>       | The DV360 Line Item Name that led to the key event.<br /><br />**Field Name:** `dv360LineItemName`<br />**Type:** dimension                                                                                     |

### Games

|                           |                                                                                                                                                                  |
| ------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| <div>Achievement ID</div> | The achievement ID in a game for an event. Populated by the event parameter achievement\_id.<br /><br />**Field Name:** `achievementId`<br />**Type:** dimension |
| <div>Character</div>      | The player character in a game for an event. Populated by the event parameter character.<br /><br />**Field Name:** `character`<br />**Type:** dimension         |
| <div>Group ID</div>       | The player group ID in a game for an event. Populated by the event parameter group\_id.<br /><br />**Field Name:** `groupId`<br />**Type:** dimension            |
| <div>Level</div>          | The player's level in a game. Populated by the event parameter level.<br /><br />**Field Name:** `level`<br />**Type:** dimension                                |

### Promotions

|                                         |                                                                                                                                                     |
| --------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------- |
| <div>Item Promotion Creative Name</div> | The name of the item-promotion creative.<br /><br />**Field Name:** `itemPromotionCreativeName`<br />**Type:** dimension                            |
| <div>Item Promotion Creative Slot</div> | The name of the promotional creative slot associated with the item.<br /><br />**Field Name:** `itemPromotionCreativeSlot`<br />**Type:** dimension |
| <div>Item Promotion ID</div>            | The ID of the item promotion.<br /><br />**Field Name:** `itemPromotionId`<br />**Type:** dimension                                                 |
| <div>Item Promotion Name</div>          | The name of the promotion for the item.<br /><br />**Field Name:** `itemPromotionName`<br />**Type:** dimension                                     |

### Media

|                           |                                                                                                                                                                                                     |
| ------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| <div>Video Provider</div> | The source of the video (for example, YouTube). Automatically populated for embedded videos if Enhanced Measurement is enabled.<br /><br />**Field Name:** `videoProvider`<br />**Type:** dimension |
| <div>Video Title</div>    | The title of the video. Automatically populated for embedded videos if Enhanced Measurement is enabled.<br /><br />**Field Name:** `videoTitle`<br />**Type:** dimension                            |
| <div>Video URL</div>      | The URL of the video. Automatically populated for embedded videos if Enhanced Measurement is enabled.<br /><br />**Field Name:** `videoUrl`<br />**Type:** dimension                                |
| <div>Visible</div>        | Returns true if the content is visible. Automatically populated for embedded videos if Enhanced Measurement is enabled.<br /><br />**Field Name:** `visible`<br />**Type:** dimension               |

### Configuration

|                                  |                                                                                                                                  |
| -------------------------------- | -------------------------------------------------------------------------------------------------------------------------------- |
| <div>Test Data Filter ID</div>   | The numeric identifier of a data filter in testing state.<br /><br />**Field Name:** `testDataFilterId`<br />**Type:** dimension |
| <div>Test Data Filter Name</div> | The name of data filters in testing state.<br /><br />**Field Name:** `testDataFilterName`<br />**Type:** dimension              |

## Metrics

Metrics are the numerical values you can measure and analyze from your Google Analytics 4 campaigns.

### User Engagement

|                                     |                                                                                                                                                                                                                           |
| ----------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| <div>Sessions</div>                 | A session is initiated when an app is opened in the  foreground or when a webpage is opened.By default, a sessions ends after 30 minutes of user inactivity. <br /><br />**Field Name:** `sessions`<br />**Type:** metric |
| <div>Total Users</div>              | The number of distinct users who have interacted with your website or app.<br /><br />**Field Name:** `totalUsers`<br />**Type:** metric                                                                                  |
| <div>Engaged Sessions</div>         | An engaged session is defined as a session that: lasted 10 seconds or longer, had one or more key events fired or had two or more pageviews.<br /><br />**Field Name:** `engagedSessions`<br />**Type:** metric           |
| <div>Average Session Duration</div> | The average duration in seconds of user's sessions.<br /><br />**Field Name:** `averageSessionDuration`<br />**Type:** metric                                                                                             |
| <div>Engagement Rate</div>          | The percentage of engaged sessions (Engaged sessions divided by Sessions).<br /><br />**Field Name:** `engagementRate`<br />**Type:** metric                                                                              |
| <div>Bounce Rate</div>              | The percentage of sessions that were not engaged ((Sessions Minus Engaged sessions) divided by Sessions).<br /><br />**Field Name:** `bounceRate`<br />**Type:** metric                                                   |
| <div>DAU / MAU</div>                | The rolling percent of 30-day active users who are also 1-day active users.<br /><br />**Field Name:** `dauPerMau`<br />**Type:** metric                                                                                  |
| <div>DAU / WAU</div>                | The rolling percent of 7-day active users who are also 1-day active users.<br /><br />**Field Name:** `dauPerWau`<br />**Type:** metric                                                                                   |
| <div>Sessions per User</div>        | The average number of sessions per user (Sessions divided by Active Users).<br /><br />**Field Name:** `sessionsPerUser`<br />**Type:** metric                                                                            |
| <div>User Engagement Duration</div> | The total amount of time (in seconds) your website or app was in the foreground of users' devices.<br /><br />**Field Name:** `userEngagementDuration`<br />**Type:** metric                                              |
| <div>WAU / MAU</div>                | The rolling percent of 30-day active users who are also 7-day active users.<br /><br />**Field Name:** `wauPerMau`<br />**Type:** metric                                                                                  |

### E-commerce

|                                               |                                                                                                                                                                                                                                                                |
| --------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| <div>E-commerce Purchases</div>               | <br /><br />**Field Name:** `ecommercePurchases`<br />**Type:** metric                                                                                                                                                                                         |
| <div>Transactions</div>                       | <br /><br />**Field Name:** `transactions`<br />**Type:** metric                                                                                                                                                                                               |
| <div>Purchase Revenue</div>                   | <br /><br />**Field Name:** `purchaseRevenue`<br />**Type:** metric                                                                                                                                                                                            |
| <div>Checkouts</div>                          | <br /><br />**Field Name:** `checkouts`<br />**Type:** metric                                                                                                                                                                                                  |
| <div>Add To Carts</div>                       | <br /><br />**Field Name:** `addToCarts`<br />**Type:** metric                                                                                                                                                                                                 |
| <div>Conversions</div>                        | <br /><br />**Field Name:** `conversions`<br />**Type:** metric                                                                                                                                                                                                |
| <div>User Conversion Rate</div>               | <br /><br />**Field Name:** `userConversionRate`<br />**Type:** metric                                                                                                                                                                                         |
| <div>Purchaser Conversion Rate</div>          | <br /><br />**Field Name:** `purchaserConversionRate`<br />**Type:** metric                                                                                                                                                                                    |
| <div>First Time Purchaser C.R.</div>          | <br /><br />**Field Name:** `firstTimePurchaserConversionRate`<br />**Type:** metric                                                                                                                                                                           |
| <div>Average Purchase Revenue</div>           | The average purchase revenue in the transaction group of events.<br /><br />**Field Name:** `averagePurchaseRevenue`<br />**Type:** metric                                                                                                                     |
| <div>ARPPU</div>                              | Average revenue per paying user (ARPPU) is the total purchase revenue per active user that logged a purchase event. The summary metric is for the time period selected.<br /><br />**Field Name:** `averagePurchaseRevenuePerPayingUser`<br />**Type:** metric |
| <div>Average Purchase Revenue per User</div>  | The average purchase revenue per active user that logged any event. The summary metric is for the time period selected.<br /><br />**Field Name:** `averagePurchaseRevenuePerUser`<br />**Type:** metric                                                       |
| <div>ARPU</div>                               | Average revenue per active user (ARPU). The summary metric is for the time period selected. ARPU uses Total Revenue and includes AdMob estimated earnings.<br /><br />**Field Name:** `averageRevenuePerUser`<br />**Type:** metric                            |
| <div>First Time Purchasers</div>              | The number of users that completed their first purchase event.<br /><br />**Field Name:** `firstTimePurchasers`<br />**Type:** metric                                                                                                                          |
| <div>First-Time Purchasers per New User</div> | The average number of first-time purchasers per new user.<br /><br />**Field Name:** `firstTimePurchasersPerNewUser`<br />**Type:** metric                                                                                                                     |
| <div>Gross Purchase Revenue</div>             | The sum of revenue from purchases made in your app or site.<br /><br />**Field Name:** `grossPurchaseRevenue`<br />**Type:** metric                                                                                                                            |
| <div>Purchase-to-View Rate</div>              | The number of users who purchased a product divided by the number of users who viewed the same product.<br /><br />**Field Name:** `purchaseToViewRate`<br />**Type:** metric                                                                                  |
| <div>Purchaser Rate</div>                     | The percentage of active users who made one or more purchase transactions.<br /><br />**Field Name:** `purchaserRate`<br />**Type:** metric                                                                                                                    |
| <div>Refund Amount</div>                      | The total refunded transaction revenues.<br /><br />**Field Name:** `refundAmount`<br />**Type:** metric                                                                                                                                                       |
| <div>Total Purchasers</div>                   | The number of users that logged purchase events for the time period selected.<br /><br />**Field Name:** `totalPurchasers`<br />**Type:** metric                                                                                                               |
| <div>Total Revenue</div>                      | The sum of revenue from purchases, subscriptions, and advertising minus refunded transaction revenue.<br /><br />**Field Name:** `totalRevenue`<br />**Type:** metric                                                                                          |
| <div>Transactions per Purchaser</div>         | The average number of transactions per purchaser.<br /><br />**Field Name:** `transactionsPerPurchaser`<br />**Type:** metric                                                                                                                                  |

### User Acquisition

|                                |                                                                                                                                                     |
| ------------------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------- |
| <div>New Users</div>           | <br /><br />**Field Name:** `newUsers`<br />**Type:** metric                                                                                        |
| <div>Active Users</div>        | <br /><br />**Field Name:** `activeUsers`<br />**Type:** metric                                                                                     |
| <div>1-day Active Users</div>  | The number of distinct active users on your site or app within a 1 day period.<br /><br />**Field Name:** `active1DayUsers`<br />**Type:** metric   |
| <div>28-day Active Users</div> | The number of distinct active users on your site or app within a 28 day period.<br /><br />**Field Name:** `active28DayUsers`<br />**Type:** metric |
| <div>7-day Active Users</div>  | The number of distinct active users on your site or app within a 7 day period.<br /><br />**Field Name:** `active7DayUsers`<br />**Type:** metric   |

### Advertiser Performance

|                                   |                                                                                                                                     |
| --------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------- |
| <div>Ad Clicks</div>              | <br /><br />**Field Name:** `advertiserAdClicks`<br />**Type:** metric                                                              |
| <div>Ad Impressions</div>         | <br /><br />**Field Name:** `advertiserAdImpressions`<br />**Type:** metric                                                         |
| <div>Ad Cost</div>                | <br /><br />**Field Name:** `advertiserAdCost`<br />**Type:** metric                                                                |
| <div>Ad Cost per Click</div>      | <br /><br />**Field Name:** `advertiserAdCostPerClick`<br />**Type:** metric                                                        |
| <div>Ad Cost per Conversion</div> | <br /><br />**Field Name:** `advertiserAdCostPerConversion`<br />**Type:** metric                                                   |
| <div>Return on Ad Spend</div>     | <br /><br />**Field Name:** `returnOnAdSpend`<br />**Type:** metric                                                                 |
| <div>Total Ad Revenue</div>       | <br /><br />**Field Name:** `totalAdRevenue`<br />**Type:** metric                                                                  |
| <div>Ad Unit Exposure</div>       | The time that an ad unit was exposed to a user, in milliseconds.<br /><br />**Field Name:** `adUnitExposure`<br />**Type:** metric  |
| <div>Ad Cost per Key Event</div>  | Cost per key event is ad cost divided by key events.<br /><br />**Field Name:** `advertiserAdCostPerKeyEvent`<br />**Type:** metric |

### App Performance

|                                  |                                                                        |
| -------------------------------- | ---------------------------------------------------------------------- |
| <div>Crash Affected Users</div>  | <br /><br />**Field Name:** `crashAffectedUsers`<br />**Type:** metric |
| <div>Crash Free Users Rate</div> | <br /><br />**Field Name:** `crashFreeUsersRate`<br />**Type:** metric |

### Events

|                                   |                                                                                                                                                              |
| --------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| <div>Event Count</div>            | <br /><br />**Field Name:** `eventCount`<br />**Type:** metric                                                                                               |
| <div>Event Value</div>            | <br /><br />**Field Name:** `eventValue`<br />**Type:** metric                                                                                               |
| <div>Event Count Per User</div>   | <br /><br />**Field Name:** `eventCountPerUser`<br />**Type:** metric                                                                                        |
| <div>Events Per Session</div>     | <br /><br />**Field Name:** `eventsPerSession`<br />**Type:** metric                                                                                         |
| <div>Key Events</div>             | The count of key events. Marking an event as a key event affects reports from time of creation.<br /><br />**Field Name:** `keyEvents`<br />**Type:** metric |
| <div>Session Key Event Rate</div> | The percentage of sessions in which any key event was triggered.<br /><br />**Field Name:** `sessionKeyEventRate`<br />**Type:** metric                      |
| <div>User Key Event Rate</div>    | The percentage of users who triggered any key event.<br /><br />**Field Name:** `userKeyEventRate`<br />**Type:** metric                                     |

### Store Items

|                                         |                                                                                                                                                                                                                    |
| --------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| <div>Item Revenue</div>                 | <br /><br />**Field Name:** `itemRevenue`<br />**Type:** metric                                                                                                                                                    |
| <div>Items Added To Cart</div>          | <br /><br />**Field Name:** `itemsAddedToCart`<br />**Type:** metric                                                                                                                                               |
| <div>Items Checked Out</div>            | <br /><br />**Field Name:** `itemsCheckedOut`<br />**Type:** metric                                                                                                                                                |
| <div>Items Purchased</div>              | <br /><br />**Field Name:** `itemsPurchased`<br />**Type:** metric                                                                                                                                                 |
| <div>Items Viewed</div>                 | <br /><br />**Field Name:** `itemsViewed`<br />**Type:** metric                                                                                                                                                    |
| <div>Cart-to-View Rate</div>            | The number of users who added a product(s) to their cart divided by the number of users who viewed the same product(s).<br /><br />**Field Name:** `cartToViewRate`<br />**Type:** metric                          |
| <div>Gross Item Revenue</div>           | The total revenue from items only. Gross item revenue is the product of its price and quantity. Item revenue excludes tax and shipping values.<br /><br />**Field Name:** `grossItemRevenue`<br />**Type:** metric |
| <div>Item Discount Amount</div>         | The monetary value of item discounts in eCommerce events.<br /><br />**Field Name:** `itemDiscountAmount`<br />**Type:** metric                                                                                    |
| <div>Item-list Click Events</div>       | The number of times users clicked an item when it appeared in a list.<br /><br />**Field Name:** `itemListClickEvents`<br />**Type:** metric                                                                       |
| <div>Item List Click Through Rate</div> | The number of users who selected a list divided by the number of users who viewed the same list.<br /><br />**Field Name:** `itemListClickThroughRate`<br />**Type:** metric                                       |
| <div>Item-list View Events</div>        | The number of times the item list was viewed.<br /><br />**Field Name:** `itemListViewEvents`<br />**Type:** metric                                                                                                |
| <div>Item Refund Amount</div>           | The total refunded transaction revenue from items only.<br /><br />**Field Name:** `itemRefundAmount`<br />**Type:** metric                                                                                        |
| <div>Item View Events</div>             | The number of times the item details were viewed.<br /><br />**Field Name:** `itemViewEvents`<br />**Type:** metric                                                                                                |
| <div>Items Clicked in List</div>        | The number of units clicked in list for a single item.<br /><br />**Field Name:** `itemsClickedInList`<br />**Type:** metric                                                                                       |
| <div>Items Viewed in List</div>         | The number of units viewed in list for a single item.<br /><br />**Field Name:** `itemsViewedInList`<br />**Type:** metric                                                                                         |

### Promotions

|                                              |                                                                                                                                                                                             |
| -------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| <div>Promotion Clicks</div>                  | <br /><br />**Field Name:** `promotionClicks`<br />**Type:** metric                                                                                                                         |
| <div>Promotion Views</div>                   | <br /><br />**Field Name:** `promotionViews`<br />**Type:** metric                                                                                                                          |
| <div>Item Promotion Click Through Rate</div> | The number of users who selected a promotion divided by the number of users who viewed the same promotion.<br /><br />**Field Name:** `itemPromotionClickThroughRate`<br />**Type:** metric |
| <div>Items Clicked in Promotion</div>        | The number of units clicked in promotion for a single item.<br /><br />**Field Name:** `itemsClickedInPromotion`<br />**Type:** metric                                                      |
| <div>Items Viewed in Promotion</div>         | The number of units viewed in promotion for a single item.<br /><br />**Field Name:** `itemsViewedInPromotion`<br />**Type:** metric                                                        |

### Screen/Page Views

|                                          |                                                                               |
| ---------------------------------------- | ----------------------------------------------------------------------------- |
| <div>Screen/Page Views</div>             | <br /><br />**Field Name:** `screenPageViews`<br />**Type:** metric           |
| <div>Screen/Page Views Per Session</div> | <br /><br />**Field Name:** `screenPageViewsPerSession`<br />**Type:** metric |
| <div>Screen/Page Views Per User</div>    | <br /><br />**Field Name:** `screenPageViewsPerUser`<br />**Type:** metric    |

### Scrolling

|                           |                                                                   |
| ------------------------- | ----------------------------------------------------------------- |
| <div>Scrolled Users</div> | <br /><br />**Field Name:** `scrolledUsers`<br />**Type:** metric |

### Shipping and Tax

|                            |                                                                    |
| -------------------------- | ------------------------------------------------------------------ |
| <div>Shipping Amount</div> | <br /><br />**Field Name:** `shippingAmount`<br />**Type:** metric |
| <div>Tax Amount</div>      | <br /><br />**Field Name:** `taxAmount`<br />**Type:** metric      |

### Publisher Ads

|                                     |                                                                                                                |
| ----------------------------------- | -------------------------------------------------------------------------------------------------------------- |
| <div>Publisher Ad Clicks</div>      | The number of ad\_click events.<br /><br />**Field Name:** `publisherAdClicks`<br />**Type:** metric           |
| <div>Publisher Ad Impressions</div> | The number of ad\_impression events.<br /><br />**Field Name:** `publisherAdImpressions`<br />**Type:** metric |

***

## Related

<CardGroup>
  <Card title="Fields Catalog" icon="book" href="/fields-catalog">
    Browse all platforms
  </Card>

  <Card title="Google Search Console Fields" icon="chart-bar" href="/data-source/google-search-console/fields">
    Google Search Console metrics & dimensions
  </Card>
</CardGroup>


# Google Business Profile Metrics & Dimensions
Source: https://support.detrics.io/data-source/google-business-profile/fields

Complete reference for Google Business Profile dimensions and metrics

<Info>
  **Last updated:** August 6, 2026
</Info>

<div>
  <div>
    82 dimensions
  </div>

  <div>
    23 metrics
  </div>
</div>

This reference covers all available dimensions and metrics for Google Business Profile data through Detrics. Use this guide to understand what data you can extract and how to structure your queries.

<div>
  <span>Supported destinations:</span>

  <div>
    Google Sheets
  </div>

  <div>
    Claude
  </div>

  <div>
    BigQuery
  </div>
</div>

## Dimensions

Dimensions are the attributes you can use to segment and group your Google Business Profile data.

### Search Keywords

|                           |                                                                                                                          |
| ------------------------- | ------------------------------------------------------------------------------------------------------------------------ |
| <div>Search Keyword</div> | Search keyword that triggered the business listing<br /><br />**Field Name:** `search_keywords`<br />**Type:** dimension |

### Location

|                                       |                                                                                                                                       |
| ------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------- |
| <div>Location ID</div>                | Unique identifier for the business location<br /><br />**Field Name:** `location_id`<br />**Type:** dimension                         |
| <div>Location Name</div>              | Name of the business location<br /><br />**Field Name:** `location_name`<br />**Type:** dimension                                     |
| <div>Location Name & ID</div>         | Combined location name and ID<br /><br />**Field Name:** `location_name_id`<br />**Type:** dimension                                  |
| <div>Location Description</div>       | Description of the business location<br /><br />**Field Name:** `location_description`<br />**Type:** dimension                       |
| <div>Language Code</div>              | Language code for the location listing<br /><br />**Field Name:** `location_language_code`<br />**Type:** dimension                   |
| <div>Store Code</div>                 | Store code for the business location<br /><br />**Field Name:** `location_store_code`<br />**Type:** dimension                        |
| <div>Primary Phone</div>              | Primary phone number for the location<br /><br />**Field Name:** `location_primary_phone`<br />**Type:** dimension                    |
| <div>Additional Phones</div>          | Additional phone numbers for the location<br /><br />**Field Name:** `location_additional_phones`<br />**Type:** dimension            |
| <div>Regular Hours</div>              | Regular business hours for the location<br /><br />**Field Name:** `location_regular_hours`<br />**Type:** dimension                  |
| <div>Special Hours</div>              | Special business hours for the location<br /><br />**Field Name:** `location_special_hours`<br />**Type:** dimension                  |
| <div>Website URL</div>                | Website URL for the business location<br /><br />**Field Name:** `location_website_url`<br />**Type:** dimension                      |
| <div>AdWords Phone</div>              | Phone number used in AdWords ads<br /><br />**Field Name:** `location_adwords_ad_phone`<br />**Type:** dimension                      |
| <div>Labels</div>                     | Labels assigned to the location<br /><br />**Field Name:** `location_labels`<br />**Type:** dimension                                 |
| <div>Coordinates</div>                | Geographic coordinates of the location<br /><br />**Field Name:** `location_coordinates`<br />**Type:** dimension                     |
| <div>Latitude</div>                   | Latitude of the business location<br /><br />**Field Name:** `location_latitude`<br />**Type:** dimension                             |
| <div>Longitude</div>                  | Longitude of the business location<br /><br />**Field Name:** `location_longitude`<br />**Type:** dimension                           |
| <div>Attributes</div>                 | Business attributes for the location<br /><br />**Field Name:** `location_attributes`<br />**Type:** dimension                        |
| <div>Price Lists</div>                | Price lists for the business location<br /><br />**Field Name:** `location_price_lists`<br />**Type:** dimension                      |
| <div>Place ID</div>                   | Google Place ID for the location<br /><br />**Field Name:** `location_place_id`<br />**Type:** dimension                              |
| <div>Maps URL</div>                   | Google Maps URL for the location<br /><br />**Field Name:** `location_maps_url`<br />**Type:** dimension                              |
| <div>Status</div>                     | Verification or listing status of the location<br /><br />**Field Name:** `location_status`<br />**Type:** dimension                  |
| <div>Opening Year</div>               | Year the business opened<br /><br />**Field Name:** `location_opening_year`<br />**Type:** dimension                                  |
| <div>Opening Month</div>              | Month the business opened<br /><br />**Field Name:** `location_opening_month`<br />**Type:** dimension                                |
| <div>Opening Day</div>                | Day the business opened<br /><br />**Field Name:** `location_opening_day`<br />**Type:** dimension                                    |
| <div>Category ID</div>                | Primary category ID for the location<br /><br />**Field Name:** `location_category_id`<br />**Type:** dimension                       |
| <div>Category Name</div>              | Primary category name for the location<br /><br />**Field Name:** `location_category_name`<br />**Type:** dimension                   |
| <div>Additional Categories</div>      | Additional business categories for the location<br /><br />**Field Name:** `location_additional_categories`<br />**Type:** dimension  |
| <div>Address</div>                    | Street address of the location<br /><br />**Field Name:** `location_address_lines`<br />**Type:** dimension                           |
| <div>City</div>                       | City of the business location<br /><br />**Field Name:** `location_address_locality`<br />**Type:** dimension                         |
| <div>State/Province</div>             | State or province of the business location<br /><br />**Field Name:** `location_address_administrative_area`<br />**Type:** dimension |
| <div>Postal Code</div>                | Postal code of the business location<br /><br />**Field Name:** `location_address_postal_code`<br />**Type:** dimension               |
| <div>Country</div>                    | Country of the business location<br /><br />**Field Name:** `location_address_country`<br />**Type:** dimension                       |
| <div>Service Area Business Type</div> | Type of service area business<br /><br />**Field Name:** `location_service_area_business_type`<br />**Type:** dimension               |
| <div>Account ID</div>                 | Google Business Profile account ID<br /><br />**Field Name:** `location_account_id`<br />**Type:** dimension                          |
| <div>Account Name</div>               | Google Business Profile account name<br /><br />**Field Name:** `location_account_name`<br />**Type:** dimension                      |

### Reviews

|                                |                                                                                                                          |
| ------------------------------ | ------------------------------------------------------------------------------------------------------------------------ |
| <div>Review ID</div>           | Unique identifier for the review<br /><br />**Field Name:** `review_id`<br />**Type:** dimension                         |
| <div>Star Rating</div>         | Star rating given by the reviewer<br /><br />**Field Name:** `review_star_rating`<br />**Type:** dimension               |
| <div>Reviewer Name</div>       | Name of the person who left the review<br /><br />**Field Name:** `review_reviewer_name`<br />**Type:** dimension        |
| <div>Review Comment</div>      | Text content of the review<br /><br />**Field Name:** `review_comment`<br />**Type:** dimension                          |
| <div>Reply Comment</div>       | Business owner reply to the review<br /><br />**Field Name:** `review_reply_comment`<br />**Type:** dimension            |
| <div>Review Created At</div>   | Timestamp when the review was created<br /><br />**Field Name:** `review_create_time`<br />**Type:** dimension           |
| <div>Review Created Date</div> | Date when the review was created<br /><br />**Field Name:** `review_create_date`<br />**Type:** dimension                |
| <div>Review Updated At</div>   | Timestamp when the review was last updated<br /><br />**Field Name:** `review_update_time`<br />**Type:** dimension      |
| <div>Review Updated Date</div> | Date when the review was last updated<br /><br />**Field Name:** `review_update_date`<br />**Type:** dimension           |
| <div>Reply Updated At</div>    | Timestamp when the reply was last updated<br /><br />**Field Name:** `review_reply_update_time`<br />**Type:** dimension |

### Posts

|                                     |                                                                                                                             |
| ----------------------------------- | --------------------------------------------------------------------------------------------------------------------------- |
| <div>Post ID</div>                  | Unique identifier for the post<br /><br />**Field Name:** `post_id`<br />**Type:** dimension                                |
| <div>Post Language</div>            | Language code of the post<br /><br />**Field Name:** `post_language_code`<br />**Type:** dimension                          |
| <div>Post Created At</div>          | Timestamp when the post was created<br /><br />**Field Name:** `post_create_time`<br />**Type:** dimension                  |
| <div>Post Updated At</div>          | Timestamp when the post was last updated<br /><br />**Field Name:** `post_update_time`<br />**Type:** dimension             |
| <div>Post Summary</div>             | Summary text of the post<br /><br />**Field Name:** `post_summary`<br />**Type:** dimension                                 |
| <div>Call to Action Type</div>      | Type of call to action on the post<br /><br />**Field Name:** `post_call_to_action_type`<br />**Type:** dimension           |
| <div>Call to Action URL</div>       | URL linked to the call to action<br /><br />**Field Name:** `post_call_to_action_url`<br />**Type:** dimension              |
| <div>Post State</div>               | Current state of the post (e.g., live, rejected)<br /><br />**Field Name:** `post_state`<br />**Type:** dimension           |
| <div>Post Search URL</div>          | URL to the post in Google Search<br /><br />**Field Name:** `post_search_url`<br />**Type:** dimension                      |
| <div>Post Topic Type</div>          | Topic type of the post (e.g., standard, event, offer)<br /><br />**Field Name:** `post_topic_type`<br />**Type:** dimension |
| <div>Post Media ID</div>            | Media ID attached to the post<br /><br />**Field Name:** `post_media_id`<br />**Type:** dimension                           |
| <div>Post Media Format</div>        | Format of the media attached to the post<br /><br />**Field Name:** `post_media_format`<br />**Type:** dimension            |
| <div>Post Media URL</div>           | Google-hosted URL of the post media<br /><br />**Field Name:** `post_media_google_url`<br />**Type:** dimension             |
| <div>Offer Coupon Code</div>        | Coupon code for offer posts<br /><br />**Field Name:** `post_offer_coupon_code`<br />**Type:** dimension                    |
| <div>Offer Redeem URL</div>         | URL to redeem the offer online<br /><br />**Field Name:** `post_offer_redeem_online_url`<br />**Type:** dimension           |
| <div>Offer Terms & Conditions</div> | Terms and conditions for the offer<br /><br />**Field Name:** `post_offer_terms_conditions`<br />**Type:** dimension        |
| <div>Event Title</div>              | Title of the event post<br /><br />**Field Name:** `post_event_title`<br />**Type:** dimension                              |
| <div>Event Start Time</div>         | Start time of the event<br /><br />**Field Name:** `post_event_schedule_start_time`<br />**Type:** dimension                |
| <div>Event End Time</div>           | End time of the event<br /><br />**Field Name:** `post_event_schedule_end_time`<br />**Type:** dimension                    |

### Media

|                                |                                                                                                             |
| ------------------------------ | ----------------------------------------------------------------------------------------------------------- |
| <div>Media ID</div>            | Unique identifier for the media item<br /><br />**Field Name:** `media_id`<br />**Type:** dimension         |
| <div>Media Format</div>        | Format of the media (e.g., photo, video)<br /><br />**Field Name:** `media_format`<br />**Type:** dimension |
| <div>Media Category</div>      | Category of the media item<br /><br />**Field Name:** `media_category`<br />**Type:** dimension             |
| <div>Media URL</div>           | Google-hosted URL of the media<br /><br />**Field Name:** `media_google_url`<br />**Type:** dimension       |
| <div>Media Thumbnail URL</div> | Thumbnail URL of the media<br /><br />**Field Name:** `media_thumbnail_url`<br />**Type:** dimension        |
| <div>Media Width</div>         | Width of the media in pixels<br /><br />**Field Name:** `media_width`<br />**Type:** dimension              |
| <div>Media Height</div>        | Height of the media in pixels<br /><br />**Field Name:** `media_height`<br />**Type:** dimension            |

### Customer Media

|                                             |                                                                                                                                                             |
| ------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------- |
| <div>Customer Media ID</div>                | Unique identifier for customer-uploaded media<br /><br />**Field Name:** `customer_media_id`<br />**Type:** dimension                                       |
| <div>Customer Media Format</div>            | Format of the customer-uploaded media<br /><br />**Field Name:** `customer_media_format`<br />**Type:** dimension                                           |
| <div>Customer Media URL</div>               | Google-hosted URL of the customer media<br /><br />**Field Name:** `customer_media_google_url`<br />**Type:** dimension                                     |
| <div>Customer Media Thumbnail URL</div>     | Thumbnail URL of the customer media<br /><br />**Field Name:** `customer_media_thumbnail_url`<br />**Type:** dimension                                      |
| <div>Customer Media Width</div>             | Width of the customer media in pixels<br /><br />**Field Name:** `customer_media_width`<br />**Type:** dimension                                            |
| <div>Customer Media Height</div>            | Height of the customer media in pixels<br /><br />**Field Name:** `customer_media_height`<br />**Type:** dimension                                          |
| <div>Customer Media Profile Name</div>      | Profile name of the customer who uploaded the media<br /><br />**Field Name:** `customer_media_attribution_profile_name`<br />**Type:** dimension           |
| <div>Customer Media Profile Photo URL</div> | Profile photo URL of the customer who uploaded the media<br /><br />**Field Name:** `customer_media_attribution_profile_photo_url`<br />**Type:** dimension |
| <div>Customer Media Takedown URL</div>      | URL to request takedown of customer media<br /><br />**Field Name:** `customer_media_attribution_takedown_url`<br />**Type:** dimension                     |
| <div>Customer Media Profile URL</div>       | Profile URL of the customer who uploaded the media<br /><br />**Field Name:** `customer_media_attribution_profile_url`<br />**Type:** dimension             |

## Metrics

Metrics are the numerical values you can measure and analyze from your Google Business Profile campaigns.

### Performance

|                                   |                                                                                                                               |
| --------------------------------- | ----------------------------------------------------------------------------------------------------------------------------- |
| <div>Views - Maps Desktop</div>   | Number of views on Google Maps from desktop devices<br /><br />**Field Name:** `views_maps_desktop`<br />**Type:** metric     |
| <div>Views - Maps Mobile</div>    | Number of views on Google Maps from mobile devices<br /><br />**Field Name:** `views_maps_mobile`<br />**Type:** metric       |
| <div>Views - Search Desktop</div> | Number of views on Google Search from desktop devices<br /><br />**Field Name:** `views_search_desktop`<br />**Type:** metric |
| <div>Views - Search Mobile</div>  | Number of views on Google Search from mobile devices<br /><br />**Field Name:** `views_search_mobile`<br />**Type:** metric   |
| <div>Views - Maps Total</div>     | Total number of views on Google Maps<br /><br />**Field Name:** `views_maps`<br />**Type:** metric                            |
| <div>Views - Search Total</div>   | Total number of views on Google Search<br /><br />**Field Name:** `views_search`<br />**Type:** metric                        |
| <div>Views - Total</div>          | Total number of views across Maps and Search<br /><br />**Field Name:** `views_total`<br />**Type:** metric                   |

### Actions

|                                         |                                                                                                                    |
| --------------------------------------- | ------------------------------------------------------------------------------------------------------------------ |
| <div>Actions - Website Clicks</div>     | Number of clicks to the business website<br /><br />**Field Name:** `actions_website`<br />**Type:** metric        |
| <div>Actions - Phone Calls</div>        | Number of phone call actions<br /><br />**Field Name:** `actions_phone`<br />**Type:** metric                      |
| <div>Actions - Driving Directions</div> | Number of driving direction requests<br /><br />**Field Name:** `actions_driving_directions`<br />**Type:** metric |
| <div>Actions - Messages</div>           | Number of messages sent to the business<br /><br />**Field Name:** `actions_messages`<br />**Type:** metric        |
| <div>Actions - Bookings</div>           | Number of booking actions<br /><br />**Field Name:** `actions_bookings`<br />**Type:** metric                      |
| <div>Actions - Food Menu Clicks</div>   | Number of food menu click actions<br /><br />**Field Name:** `actions_food_menu_clicks`<br />**Type:** metric      |
| <div>Actions - Food Orders</div>        | Number of food order actions<br /><br />**Field Name:** `actions_food_orders`<br />**Type:** metric                |
| <div>Actions - Total</div>              | Total number of actions taken on the listing<br /><br />**Field Name:** `actions_total`<br />**Type:** metric      |

### Search Keywords

|                               |                                                                                                                    |
| ----------------------------- | ------------------------------------------------------------------------------------------------------------------ |
| <div>Search Impressions</div> | Number of impressions for the search keyword<br /><br />**Field Name:** `search_impressions`<br />**Type:** metric |

### Reviews

|                                           |                                                                                                                                 |
| ----------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------- |
| <div>Total Review Count</div>             | Total number of reviews in the selected period<br /><br />**Field Name:** `review_total_count`<br />**Type:** metric            |
| <div>Average Star Rating</div>            | Average star rating of reviews in the selected period<br /><br />**Field Name:** `review_avg_star_rating`<br />**Type:** metric |
| <div>Total Review Count (Lifetime)</div>  | Total number of reviews for the location (all time)<br /><br />**Field Name:** `total_review_count`<br />**Type:** metric       |
| <div>Average Star Rating (Lifetime)</div> | Average star rating for the location (all time)<br /><br />**Field Name:** `total_review_star_rating`<br />**Type:** metric     |

### Posts

|                       |                                                                               |
| --------------------- | ----------------------------------------------------------------------------- |
| <div>Post Count</div> | Number of posts<br /><br />**Field Name:** `post_count`<br />**Type:** metric |

### Media

|                              |                                                                                                  |
| ---------------------------- | ------------------------------------------------------------------------------------------------ |
| <div>Media Total Count</div> | Total number of media items<br /><br />**Field Name:** `media_total_count`<br />**Type:** metric |

### Customer Media

|                                       |                                                                                                                             |
| ------------------------------------- | --------------------------------------------------------------------------------------------------------------------------- |
| <div>Customer Media Total Count</div> | Total number of customer-uploaded media items<br /><br />**Field Name:** `customer_media_total_count`<br />**Type:** metric |

***

## Related

<CardGroup>
  <Card title="Fields Catalog" icon="book" href="/fields-catalog">
    Browse all platforms
  </Card>

  <Card title="Google Search Console Fields" icon="chart-bar" href="/data-source/google-search-console/fields">
    Google Search Console metrics & dimensions
  </Card>

  <Card title="Google Analytics 4 Fields" icon="chart-bar" href="/data-source/google-analytics-4/fields">
    Google Analytics 4 metrics & dimensions
  </Card>

  <Card title="Facebook Insights Fields" icon="chart-bar" href="/data-source/facebook-insights/fields">
    Facebook Insights metrics & dimensions
  </Card>
</CardGroup>


# Google DV360 Metrics & Dimensions
Source: https://support.detrics.io/data-source/google-dv360/fields

Complete reference for Google DV360 dimensions and metrics

<Info>
  **Last updated:** August 6, 2026
</Info>

<div>
  <div>
    62 dimensions
  </div>

  <div>
    114 metrics
  </div>
</div>

This reference covers all available dimensions and metrics for Google DV360 data through Detrics. Use this guide to understand what data you can extract and how to structure your queries.

<div>
  <span>Supported destinations:</span>

  <div>
    Google Sheets
  </div>

  <div>
    Looker Studio
  </div>

  <div>
    Claude
  </div>

  <div>
    BigQuery
  </div>
</div>

## Dimensions

Dimensions are the attributes you can use to segment and group your Google DV360 data.

### Advertiser

|                              |                                                                                      |
| ---------------------------- | ------------------------------------------------------------------------------------ |
| <div>Advertiser ID</div>     | <br /><br />**Field Name:** `ADVERTISER`<br />**Type:** dimension                    |
| <div>Partner ID</div>        | <br /><br />**Field Name:** `PARTNER`<br />**Type:** dimension                       |
| <div>Advertiser Name</div>   | <br /><br />**Field Name:** `ADVERTISER_NAME`<br />**Type:** dimension               |
| <div>Advertiser Status</div> | <br /><br />**Field Name:** `ADVERTISER_INTEGRATION_STATUS`<br />**Type:** dimension |
| <div>Currency Code</div>     | <br /><br />**Field Name:** `ADVERTISER_CURRENCY`<br />**Type:** dimension           |
| <div>Country</div>           | <br /><br />**Field Name:** `COUNTRY`<br />**Type:** dimension                       |
| <div>Region</div>            | <br /><br />**Field Name:** `REGION_NAME`<br />**Type:** dimension                   |
| <div>City</div>              | <br /><br />**Field Name:** `CITY_NAME`<br />**Type:** dimension                     |

### Campaign

|                          |                                                                        |
| ------------------------ | ---------------------------------------------------------------------- |
| <div>Campaign ID</div>   | <br /><br />**Field Name:** `MEDIA_PLAN`<br />**Type:** dimension      |
| <div>Campaign Name</div> | <br /><br />**Field Name:** `MEDIA_PLAN_NAME`<br />**Type:** dimension |

### Floodlight

|                                                    |                                                                                                                                                                                              |
| -------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| <div>Floodlight Activity</div>                     | The name of the Floodlight activity that recorded the conversion.<br /><br />**Field Name:** `FLOODLIGHT_ACTIVITY`<br />**Type:** dimension                                                  |
| <div>Floodlight Activity Conversion Category</div> | The conversion category of the Floodlight activity (e.g. page view, purchase, begin checkout).<br /><br />**Field Name:** `FLOODLIGHT_ACTIVITY_CONVERSION_CATEGORY`<br />**Type:** dimension |

### Creative

|                                      |                                                                                                                                                                                                                                                                                                                                                             |
| ------------------------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| <div>Creative ID</div>               | <br /><br />**Field Name:** `CREATIVE_ID`<br />**Type:** dimension                                                                                                                                                                                                                                                                                          |
| <div>Creative Name</div>             | <br /><br />**Field Name:** `CREATIVE`<br />**Type:** dimension                                                                                                                                                                                                                                                                                             |
| <div>Creative Preview URL</div>      | Direct link to the creative image — the ad image for image/native creatives, or the video thumbnail for YouTube video creatives. Blank for third-party-served and hosted-video-file creatives. In the Data Warehouse this can be stored to your own bucket as a permanent image.<br /><br />**Field Name:** `CREATIVE_PREVIEW_URL`<br />**Type:** dimension |
| <div>Creative Preview Image</div>    | The creative image wrapped in a Google Sheets =IMAGE() function so it renders inline in the sheet. Sheets only (not supported in Looker Studio).<br /><br />**Field Name:** `CREATIVE_PREVIEW_IMAGE`<br />**Type:** dimension                                                                                                                               |
| <div>Creative Landing Page URL</div> | The ad's click-through destination URL (including any UTM parameters). Blank for third-party creatives that carry the click in their tag.<br /><br />**Field Name:** `CREATIVE_LANDING_PAGE_URL`<br />**Type:** dimension                                                                                                                                   |
| <div>Creative Hosting Source</div>   | Whether the creative is hosted by DV360 or served by a third party (Hosted / Third Party).<br /><br />**Field Name:** `CREATIVE_HOSTING_SOURCE`<br />**Type:** dimension                                                                                                                                                                                    |
| <div>Creative Approval Status</div>  | DV360 review/approval state for the creative (e.g. Approved Servable, Pending Servable, Rejected Not Servable).<br /><br />**Field Name:** `CREATIVE_APPROVAL_STATUS`<br />**Type:** dimension                                                                                                                                                              |
| <div>Creative Duration (s)</div>     | Length of the video creative in seconds. Blank for non-video creatives.<br /><br />**Field Name:** `CREATIVE_DURATION`<br />**Type:** dimension                                                                                                                                                                                                             |
| <div>Creative Created At</div>       | When the creative was created in DV360.<br /><br />**Field Name:** `CREATIVE_CREATE_TIME`<br />**Type:** dimension                                                                                                                                                                                                                                          |
| <div>Creative Updated At</div>       | When the creative was last modified in DV360.<br /><br />**Field Name:** `CREATIVE_UPDATE_TIME`<br />**Type:** dimension                                                                                                                                                                                                                                    |
| <div>Creative Status</div>           | <br /><br />**Field Name:** `CREATIVE_STATUS`<br />**Type:** dimension                                                                                                                                                                                                                                                                                      |
| <div>Creative Type</div>             | <br /><br />**Field Name:** `CREATIVE_TYPE`<br />**Type:** dimension                                                                                                                                                                                                                                                                                        |
| <div>Creative Height</div>           | <br /><br />**Field Name:** `CREATIVE_HEIGHT`<br />**Type:** dimension                                                                                                                                                                                                                                                                                      |
| <div>Creative Width</div>            | <br /><br />**Field Name:** `CREATIVE_WIDTH`<br />**Type:** dimension                                                                                                                                                                                                                                                                                       |
| <div>Creative Source</div>           | <br /><br />**Field Name:** `CREATIVE_SOURCE`<br />**Type:** dimension                                                                                                                                                                                                                                                                                      |

### Insertion Order

|                                            |                                                                                                           |
| ------------------------------------------ | --------------------------------------------------------------------------------------------------------- |
| <div>Insertion Order ID</div>              | <br /><br />**Field Name:** `INSERTION_ORDER`<br />**Type:** dimension                                    |
| <div>Insertion Order Name</div>            | <br /><br />**Field Name:** `INSERTION_ORDER_NAME`<br />**Type:** dimension                               |
| <div>Insertion Order Status</div>          | <br /><br />**Field Name:** `INSERTION_ORDER_STATUS`<br />**Type:** dimension                             |
| <div>Other Insertion Order (Overlap)</div> | Only valid with Overlap metrics<br /><br />**Field Name:** `OTHER_CAMPAIGN_NAME`<br />**Type:** dimension |

### Line Item

|                                      |                                                                                  |
| ------------------------------------ | -------------------------------------------------------------------------------- |
| <div>Line Item ID</div>              | <br /><br />**Field Name:** `LINE_ITEM`<br />**Type:** dimension                 |
| <div>Line Item Name</div>            | <br /><br />**Field Name:** `LINE_ITEM_NAME`<br />**Type:** dimension            |
| <div>Line Item Start Date</div>      | <br /><br />**Field Name:** `LINE_ITEM_START_DATE`<br />**Type:** dimension      |
| <div>Line Item Budget</div>          | <br /><br />**Field Name:** `LINE_ITEM_BUDGET`<br />**Type:** dimension          |
| <div>Line Item Status</div>          | <br /><br />**Field Name:** `LINE_ITEM_STATUS`<br />**Type:** dimension          |
| <div>Line Item Daily Frequency</div> | <br /><br />**Field Name:** `LINE_ITEM_DAILY_FREQUENCY`<br />**Type:** dimension |
| <div>Line Item Type</div>            | <br /><br />**Field Name:** `LINE_ITEM_TYPE`<br />**Type:** dimension            |

### Device

|                                        |                                                                                                                                                                    |
| -------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| <div>Device Make</div>                 | <br /><br />**Field Name:** `DEVICE_MAKE`<br />**Type:** dimension                                                                                                 |
| <div>Device Type</div>                 | <br /><br />**Field Name:** `DEVICE_TYPE`<br />**Type:** dimension                                                                                                 |
| <div>Device Model</div>                | <br /><br />**Field Name:** `DEVICE_MODEL`<br />**Type:** dimension                                                                                                |
| <div>Environment</div>                 | The inventory environment where the impression served (e.g. Web, App, Web optimized for device).<br /><br />**Field Name:** `PAGE_LAYOUT`<br />**Type:** dimension |
| <div>Other Device Type (Overlap)</div> | <br /><br />**Field Name:** `OTHER_DEVICE_TYPE`<br />**Type:** dimension                                                                                           |

### Demographics (YouTube)

|                             |                                                                                                                                                                                                |
| --------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| <div>Age (YouTube)</div>    | Viewer age bracket for YouTube & Partners inventory (18-24, 25-34, …, 65+, Unknown). Only available for YouTube line items.<br /><br />**Field Name:** `TRUEVIEW_AGE`<br />**Type:** dimension |
| <div>Gender (YouTube)</div> | Viewer gender for YouTube & Partners inventory (Female / Male / Unknown). Only available for YouTube line items.<br /><br />**Field Name:** `TRUEVIEW_GENDER`<br />**Type:** dimension         |

### Channel

|                         |                                                                     |
| ----------------------- | ------------------------------------------------------------------- |
| <div>Channel ID</div>   | <br /><br />**Field Name:** `CHANNEL_ID`<br />**Type:** dimension   |
| <div>Channel Name</div> | <br /><br />**Field Name:** `CHANNEL_NAME`<br />**Type:** dimension |
| <div>Channel Type</div> | <br /><br />**Field Name:** `CHANNEL_TYPE`<br />**Type:** dimension |

### App Url

|                             |                                                                         |
| --------------------------- | ----------------------------------------------------------------------- |
| <div>APP URL</div>          | <br /><br />**Field Name:** `APP_URL`<br />**Type:** dimension          |
| <div>APP URL Excluded</div> | <br /><br />**Field Name:** `APP_URL_EXCLUDED`<br />**Type:** dimension |
| <div>APP URL ID</div>       | <br /><br />**Field Name:** `SITE_ID`<br />**Type:** dimension          |

### Inventory

|                                          |                                                                                      |
| ---------------------------------------- | ------------------------------------------------------------------------------------ |
| <div>Inventory Source ID</div>           | <br /><br />**Field Name:** `INVENTORY_SOURCE_ID`<br />**Type:** dimension           |
| <div>Inventory Source Name</div>         | <br /><br />**Field Name:** `INVENTORY_SOURCE_NAME`<br />**Type:** dimension         |
| <div>Inventory Entity Status</div>       | <br /><br />**Field Name:** `INVENTORY_ENTITY_STATUS`<br />**Type:** dimension       |
| <div>Inventory Source Type</div>         | <br /><br />**Field Name:** `INVENTORY_SOURCE_TYPE`<br />**Type:** dimension         |
| <div>Inventory Source Product Type</div> | <br /><br />**Field Name:** `INVENTORY_SOURCE_PRODUCT_TYPE`<br />**Type:** dimension |
| <div>Inventory Exchange</div>            | <br /><br />**Field Name:** `INVENTORY_EXCHANGE`<br />**Type:** dimension            |
| <div>Inventory Rate Type</div>           | <br /><br />**Field Name:** `INVENTORY_RATE_TYPE`<br />**Type:** dimension           |
| <div>Inventory Rate Curency Code</div>   | <br /><br />**Field Name:** `INVENTORY_RATE_CURRENCY_CODE`<br />**Type:** dimension  |
| <div>Inventory Start Date</div>          | <br /><br />**Field Name:** `INVENTORY_START_DATE`<br />**Type:** dimension          |
| <div>Inventory End Date</div>            | <br /><br />**Field Name:** `INVENTORY_END_DATE`<br />**Type:** dimension            |
| <div>Inventory Update Time</div>         | <br /><br />**Field Name:** `INVENTORY_UPDATE_TIME`<br />**Type:** dimension         |

## Metrics

Metrics are the numerical values you can measure and analyze from your Google DV360 campaigns.

### Budget

|                                    |                                                                                         |
| ---------------------------------- | --------------------------------------------------------------------------------------- |
| <div>Media Cost</div>              | <br /><br />**Field Name:** `METRIC_MEDIA_COST_ADVERTISER`<br />**Type:** metric        |
| <div>Media Cost (USD)</div>        | <br /><br />**Field Name:** `METRIC_MEDIA_COST_USD`<br />**Type:** metric               |
| <div>Profit</div>                  | <br /><br />**Field Name:** `METRIC_PROFIT_ADVERTISER`<br />**Type:** metric            |
| <div>Profit (USD)</div>            | <br /><br />**Field Name:** `METRIC_PROFIT_USD`<br />**Type:** metric                   |
| <div>Revenue</div>                 | <br /><br />**Field Name:** `METRIC_REVENUE_ADVERTISER`<br />**Type:** metric           |
| <div>Revenue (USD)</div>           | <br /><br />**Field Name:** `METRIC_REVENUE_USD`<br />**Type:** metric                  |
| <div>Total Media Cost </div>       | <br /><br />**Field Name:** `METRIC_TOTAL_MEDIA_COST_ADVERTISER`<br />**Type:** metric  |
| <div>Total Media Cost (USD)</div>  | <br /><br />**Field Name:** `METRIC_TOTAL_MEDIA_COST_USD`<br />**Type:** metric         |
| <div>Media Cost eCPA</div>         | <br /><br />**Field Name:** `METRIC_MEDIA_COST_ECPA_ADVERTISER`<br />**Type:** metric   |
| <div>Media Cost eCPA (USD)</div>   | <br /><br />**Field Name:** `METRIC_MEDIA_COST_ECPA_USD`<br />**Type:** metric          |
| <div>Media Cost eCPAPC</div>       | <br /><br />**Field Name:** `METRIC_MEDIA_COST_ECPAPC_ADVERTISER`<br />**Type:** metric |
| <div>Media Cost eCPAPC (USD)</div> | <br /><br />**Field Name:** `METRIC_MEDIA_COST_ECPAPC_USD`<br />**Type:** metric        |
| <div>Media Cost eCPAPV</div>       | <br /><br />**Field Name:** `METRIC_MEDIA_COST_ECPAPV_ADVERTISER`<br />**Type:** metric |
| <div>Media Cost eCPAPV (USD)</div> | <br /><br />**Field Name:** `METRIC_MEDIA_COST_ECPAPV_USD`<br />**Type:** metric        |
| <div>Revenue eCPC</div>            | <br /><br />**Field Name:** `METRIC_REVENUE_ECPC_ADVERTISER`<br />**Type:** metric      |
| <div>Revenue eCPC (USD)</div>      | <br /><br />**Field Name:** `METRIC_REVENUE_ECPC_USD`<br />**Type:** metric             |
| <div>Revenue eCPM</div>            | <br /><br />**Field Name:** `METRIC_REVENUE_ECPM_ADVERTISER`<br />**Type:** metric      |
| <div>Revenue eCPM (USD)</div>      | <br /><br />**Field Name:** `METRIC_REVENUE_ECPM_USD`<br />**Type:** metric             |

### Interactions

|                                           |                                                                                           |
| ----------------------------------------- | ----------------------------------------------------------------------------------------- |
| <div>Clicks</div>                         | <br /><br />**Field Name:** `METRIC_CLICKS`<br />**Type:** metric                         |
| <div>Impressions</div>                    | <br /><br />**Field Name:** `METRIC_IMPRESSIONS`<br />**Type:** metric                    |
| <div>Total Conversions</div>              | <br /><br />**Field Name:** `METRIC_TOTAL_CONVERSIONS`<br />**Type:** metric              |
| <div>Post Click Conversion</div>          | <br /><br />**Field Name:** `METRIC_LAST_CLICKS`<br />**Type:** metric                    |
| <div>Post View Conversions</div>          | <br /><br />**Field Name:** `METRIC_LAST_IMPRESSIONS`<br />**Type:** metric               |
| <div>Impressions to Conversion Rate</div> | <br /><br />**Field Name:** `METRIC_IMPRESSIONS_TO_CONVERSION_RATE`<br />**Type:** metric |

### Performance

|                                     |                                                                                 |
| ----------------------------------- | ------------------------------------------------------------------------------- |
| <div>Billable Impressions</div>     | <br /><br />**Field Name:** `METRIC_BILLABLE_IMPRESSIONS`<br />**Type:** metric |
| <div>Click-Through Rate (CTR)</div> | <br /><br />**Field Name:** `METRIC_CTR`<br />**Type:** metric                  |
| <div>Engagements</div>              | <br /><br />**Field Name:** `METRIC_ENGAGEMENTS`<br />**Type:** metric          |
| <div>Engagement Rate</div>          | <br /><br />**Field Name:** `METRIC_ENGAGEMENT_RATE`<br />**Type:** metric      |

### Video

|                                |                                                                                                                                                                                                                                                  |
| ------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| <div>TrueView: Views</div>     | TrueView views. A view is counted when someone chooses to watch or engage with your video ad in a YouTube & partners or Demand Gen line item, or watches the entire ad.<br /><br />**Field Name:** `METRIC_TRUEVIEW_VIEWS`<br />**Type:** metric |
| <div>Video Plays</div>         | <br /><br />**Field Name:** `METRIC_RICH_MEDIA_VIDEO_PLAYS`<br />**Type:** metric                                                                                                                                                                |
| <div>Video 25% Complete</div>  | <br /><br />**Field Name:** `METRIC_RICH_MEDIA_VIDEO_FIRST_QUARTILE_COMPLETES`<br />**Type:** metric                                                                                                                                             |
| <div>Video 50% Complete</div>  | <br /><br />**Field Name:** `METRIC_RICH_MEDIA_VIDEO_MIDPOINTS`<br />**Type:** metric                                                                                                                                                            |
| <div>Video 75% Complete</div>  | <br /><br />**Field Name:** `METRIC_RICH_MEDIA_VIDEO_THIRD_QUARTILE_COMPLETES`<br />**Type:** metric                                                                                                                                             |
| <div>Video 100% Complete</div> | <br /><br />**Field Name:** `METRIC_RICH_MEDIA_VIDEO_COMPLETIONS`<br />**Type:** metric                                                                                                                                                          |
| <div>Video Pauses</div>        | <br /><br />**Field Name:** `METRIC_RICH_MEDIA_VIDEO_PAUSES`<br />**Type:** metric                                                                                                                                                               |
| <div>Video Mutes</div>         | <br /><br />**Field Name:** `METRIC_RICH_MEDIA_VIDEO_MUTES`<br />**Type:** metric                                                                                                                                                                |
| <div>Video Skips</div>         | <br /><br />**Field Name:** `METRIC_RICH_MEDIA_VIDEO_SKIPS`<br />**Type:** metric                                                                                                                                                                |
| <div>Video Full Screens</div>  | <br /><br />**Field Name:** `METRIC_RICH_MEDIA_VIDEO_FULL_SCREENS`<br />**Type:** metric                                                                                                                                                         |

### Reach

|                                                               |                                                                                                               |
| ------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------- |
| <div>Unique Reach Click</div>                                 | <br /><br />**Field Name:** `METRIC_UNIQUE_REACH_CLICK_REACH`<br />**Type:** metric                           |
| <div>Unique Reach Impression</div>                            | <br /><br />**Field Name:** `METRIC_UNIQUE_REACH_IMPRESSION_REACH`<br />**Type:** metric                      |
| <div>Unique Reach Average Impression Frequency</div>          | <br /><br />**Field Name:** `METRIC_UNIQUE_REACH_AVERAGE_IMPRESSION_FREQUENCY`<br />**Type:** metric          |
| <div>Unique Reach Average Viewable Impression Frequency</div> | <br /><br />**Field Name:** `METRIC_UNIQUE_REACH_AVERAGE_VIEWABLE_IMPRESSION_FREQUENCY`<br />**Type:** metric |
| <div>Unique Reach Incremental Total </div>                    | <br /><br />**Field Name:** `METRIC_UNIQUE_REACH_INCREMENTAL_TOTAL_REACH`<br />**Type:** metric               |
| <div>Unique Total Reach</div>                                 | <br /><br />**Field Name:** `METRIC_UNIQUE_REACH_TOTAL_REACH`<br />**Type:** metric                           |
| <div>Unique Viewable Impression Reach</div>                   | <br /><br />**Field Name:** `METRIC_UNIQUE_REACH_VIEWABLE_IMPRESSION_REACH`<br />**Type:** metric             |

### Overlap

|                                                      |                                                                                                                     |
| ---------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------- |
| <div>Overlap Reach Click</div>                       | <br /><br />**Field Name:** `METRIC_VIRTUAL_PEOPLE_OVERLAP_CLICK_REACH`<br />**Type:** metric                       |
| <div>Overlap Total Reach</div>                       | <br /><br />**Field Name:** `METRIC_VIRTUAL_PEOPLE_OVERLAP_TOTAL_REACH`<br />**Type:** metric                       |
| <div>Overlap Total Reach Percent</div>               | <br /><br />**Field Name:** `METRIC_VIRTUAL_PEOPLE_OVERLAP_TOTAL_REACH_PERCENT`<br />**Type:** metric               |
| <div>Overlap Viewable Impression Reach</div>         | <br /><br />**Field Name:** `METRIC_VIRTUAL_PEOPLE_OVERLAP_VIEWABLE_IMPRESSION_REACH`<br />**Type:** metric         |
| <div>Overlap Viewable Impression Reach Percent</div> | <br /><br />**Field Name:** `METRIC_VIRTUAL_PEOPLE_OVERLAP_VIEWABLE_IMPRESSION_REACH_PERCENT`<br />**Type:** metric |
| <div>Overlap Impression Reach Percent</div>          | <br /><br />**Field Name:** `METRIC_VIRTUAL_PEOPLE_OVERLAP_IMPRESSION_REACH_PERCENT`<br />**Type:** metric          |
| <div>Overlap Click Reach Percent</div>               | <br /><br />**Field Name:** `METRIC_VIRTUAL_PEOPLE_OVERLAP_CLICK_REACH_PERCENT`<br />**Type:** metric               |
| <div>Overlap Impression Reach</div>                  | <br /><br />**Field Name:** `METRIC_VIRTUAL_PEOPLE_OVERLAP_IMPRESSION_REACH`<br />**Type:** metric                  |

### Inventory

|                           |                                                                                                   |
| ------------------------- | ------------------------------------------------------------------------------------------------- |
| <div>Inventory Rate</div> | Valid with inventory dimensions<br /><br />**Field Name:** `INVENTORY_RATE`<br />**Type:** metric |

### Active View

|                                                     |                                                                                                             |
| --------------------------------------------------- | ----------------------------------------------------------------------------------------------------------- |
| <div>Average Viewable Time (Seconds)</div>          | <br /><br />**Field Name:** `METRIC_ACTIVE_VIEW_AVERAGE_VIEWABLE_TIME`<br />**Type:** metric                |
| <div>Custom Metric Measurable Impressions</div>     | <br /><br />**Field Name:** `METRIC_ACTIVE_VIEW_CUSTOM_METRIC_MEASURABLE_IMPRESSIONS`<br />**Type:** metric |
| <div>Custom Metric Viewable Impressions</div>       | <br /><br />**Field Name:** `METRIC_ACTIVE_VIEW_CUSTOM_METRIC_VIEWABLE_IMPRESSIONS`<br />**Type:** metric   |
| <div>Custom Metric Viewable Rate</div>              | <br /><br />**Field Name:** `METRIC_ACTIVE_VIEW_CUSTOM_METRIC_VIEWABLE_RATE`<br />**Type:** metric          |
| <div>Impression Distribution (Not Measurable)</div> | <br /><br />**Field Name:** `METRIC_ACTIVE_VIEW_DISTRIBUTION_UNMEASURABLE`<br />**Type:** metric            |
| <div>Impression Distribution (Not Viewable)</div>   | <br /><br />**Field Name:** `METRIC_ACTIVE_VIEW_DISTRIBUTION_UNVIEWABLE`<br />**Type:** metric              |
| <div>Impression Distribution (Viewable)</div>       | <br /><br />**Field Name:** `METRIC_ACTIVE_VIEW_DISTRIBUTION_VIEWABLE`<br />**Type:** metric                |
| <div>Eligible Impressions</div>                     | <br /><br />**Field Name:** `METRIC_ACTIVE_VIEW_ELIGIBLE_IMPRESSIONS`<br />**Type:** metric                 |
| <div>Measurable Impressions</div>                   | <br /><br />**Field Name:** `METRIC_ACTIVE_VIEW_MEASURABLE_IMPRESSIONS`<br />**Type:** metric               |
| <div>% Measurable Impressions</div>                 | <br /><br />**Field Name:** `METRIC_ACTIVE_VIEW_PCT_MEASURABLE_IMPRESSIONS`<br />**Type:** metric           |
| <div>% Viewable Impressions</div>                   | <br /><br />**Field Name:** `METRIC_ACTIVE_VIEW_PCT_VIEWABLE_IMPRESSIONS`<br />**Type:** metric             |
| <div>% of Ever Muted</div>                          | <br /><br />**Field Name:** `METRIC_ACTIVE_VIEW_PERCENT_EVER_MUTED`<br />**Type:** metric                   |
| <div>% Fully On-Screen 2 sec</div>                  | <br /><br />**Field Name:** `METRIC_ACTIVE_VIEW_PERCENT_FULLY_ON_SCREEN_2_SEC`<br />**Type:** metric        |
| <div>% Full-Screen</div>                            | <br /><br />**Field Name:** `METRIC_ACTIVE_VIEW_PERCENT_FULL_SCREEN`<br />**Type:** metric                  |
| <div>% In Background</div>                          | <br /><br />**Field Name:** `METRIC_ACTIVE_VIEW_PERCENT_IN_BACKGROUND`<br />**Type:** metric                |
| <div>% of Ad Played</div>                           | <br /><br />**Field Name:** `METRIC_ACTIVE_VIEW_PERCENT_OF_AD_PLAYED`<br />**Type:** metric                 |
| <div>Not Measurable Impressions</div>               | <br /><br />**Field Name:** `METRIC_ACTIVE_VIEW_UNMEASURABLE_IMPRESSIONS`<br />**Type:** metric             |
| <div>Not Viewable Impressions</div>                 | <br /><br />**Field Name:** `METRIC_ACTIVE_VIEW_UNVIEWABLE_IMPRESSIONS`<br />**Type:** metric               |
| <div>Viewable Impressions</div>                     | <br /><br />**Field Name:** `METRIC_ACTIVE_VIEW_VIEWABLE_IMPRESSIONS`<br />**Type:** metric                 |

### Active View: Audible

|                                                                                                |                                                                                                                                                 |
| ---------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------- |
| <div>% of Audible (Unmuted) for 2 sec Impressions</div>                                        | <br /><br />**Field Name:** `METRIC_ACTIVE_VIEW_PERCENT_AUDIBLE_2_SEC`<br />**Type:** metric                                                    |
| <div>% of Audible (Unmuted) for 30 sec Impressions</div>                                       | <br /><br />**Field Name:** `METRIC_ACTIVE_VIEW_PERCENT_AUDIBLE_30_SEC`<br />**Type:** metric                                                   |
| <div>% of Audible and Background Impressions</div>                                             | <br /><br />**Field Name:** `METRIC_ACTIVE_VIEW_PERCENT_AUDIBLE_AND_BACKGROUND`<br />**Type:** metric                                           |
| <div>% Audible Impressions</div>                                                               | <br /><br />**Field Name:** `METRIC_ACTIVE_VIEW_PERCENT_AUDIBLE_IMPRESSIONS`<br />**Type:** metric                                              |
| <div>% of Complete Audible Impressions</div>                                                   | <br /><br />**Field Name:** `METRIC_ACTIVE_VIEW_PERCENT_COMPLETE_AUDIBLE`<br />**Type:** metric                                                 |
| <div>% of First Quartile Audible Impressions</div>                                             | <br /><br />**Field Name:** `METRIC_ACTIVE_VIEW_PERCENT_FIRST_QUARTILE_AUDIBLE`<br />**Type:** metric                                           |
| <div>% of Midpoint Audible Impressions</div>                                                   | <br /><br />**Field Name:** `METRIC_ACTIVE_VIEW_PERCENT_MIDPOINT_AUDIBLE`<br />**Type:** metric                                                 |
| <div>% Play Time Audible</div>                                                                 | <br /><br />**Field Name:** `METRIC_ACTIVE_VIEW_PERCENT_PLAY_TIME_AUDIBLE`<br />**Type:** metric                                                |
| <div>% of Third Quartile Audible Impressions</div>                                             | <br /><br />**Field Name:** `METRIC_ACTIVE_VIEW_PERCENT_THIRD_QUARTILE_AUDIBLE`<br />**Type:** metric                                           |
| <div>Audible (Unmuted) for 2 sec Impressions</div>                                             | <br /><br />**Field Name:** `METRIC_ACTIVE_VIEW_AUDIBLE_2_SEC_IMPRESSIONS`<br />**Type:** metric                                                |
| <div>Audible and Background Impressions</div>                                                  | <br /><br />**Field Name:** `METRIC_ACTIVE_VIEW_AUDIBLE_AND_BACKGROUND_IMPRESSIONS`<br />**Type:** metric                                       |
| <div>Audible & Fully On-Screen for Half of Duration (15 sec. cap) Impressions</div>            | <br /><br />**Field Name:** `METRIC_ACTIVE_VIEW_AUDIBLE_FULLY_ON_SCREEN_HALF_OF_DURATION_IMPRESSIONS`<br />**Type:** metric                     |
| <div>Audible & Fully On-Screen for Half of Duration (15 sec. cap) Measurable Impressions</div> | <br /><br />**Field Name:** `METRIC_ACTIVE_VIEW_AUDIBLE_FULLY_ON_SCREEN_HALF_OF_DURATION_MEASURABLE_IMPRESSIONS`<br />**Type:** metric          |
| <div>Audible & Fully On-Screen for Half of Duration (15 sec. cap) Rate</div>                   | <br /><br />**Field Name:** `METRIC_ACTIVE_VIEW_AUDIBLE_FULLY_ON_SCREEN_HALF_OF_DURATION_RATE`<br />**Type:** metric                            |
| <div>Audible & Fully On-Screen for Half of Duration (TrueView) Impressions</div>               | <br /><br />**Field Name:** `METRIC_ACTIVE_VIEW_AUDIBLE_FULLY_ON_SCREEN_HALF_OF_DURATION_TRUEVIEW_IMPRESSIONS`<br />**Type:** metric            |
| <div>Audible & Fully On-Screen for Half of Duration (TrueView) Measurable Impressions</div>    | <br /><br />**Field Name:** `METRIC_ACTIVE_VIEW_AUDIBLE_FULLY_ON_SCREEN_HALF_OF_DURATION_TRUEVIEW_MEASURABLE_IMPRESSIONS`<br />**Type:** metric |
| <div>Audible & Fully On-Screen for Half of Duration (TrueView) Rate</div>                      | <br /><br />**Field Name:** `METRIC_ACTIVE_VIEW_AUDIBLE_FULLY_ON_SCREEN_HALF_OF_DURATION_TRUEVIEW_RATE`<br />**Type:** metric                   |
| <div>Audible Measurable Impressions</div>                                                      | <br /><br />**Field Name:** `METRIC_ACTIVE_VIEW_AUDIBLE_MEASURABLE_IMPRESSIONS`<br />**Type:** metric                                           |

### Active View: Audible & Visible

|                                                                |                                                                                                                                  |
| -------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------- |
| <div>% Audible and Visible at Start</div>                      | <br /><br />**Field Name:** `METRIC_ACTIVE_VIEW_PERCENT_AUDIBLE_VISIBLE_AT_START`<br />**Type:** metric                          |
| <div>% Audible and Visible at First Quartile</div>             | <br /><br />**Field Name:** `METRIC_ACTIVE_VIEW_PERCENT_AUDIBLE_VISIBLE_FIRST_QUAR`<br />**Type:** metric                        |
| <div>% Audible and Visible at Completion</div>                 | <br /><br />**Field Name:** `METRIC_ACTIVE_VIEW_PERCENT_AUDIBLE_VISIBLE_ON_COMPLETE`<br />**Type:** metric                       |
| <div>% Audible and Visible at Midpoint</div>                   | <br /><br />**Field Name:** `METRIC_ACTIVE_VIEW_PERCENT_AUDIBLE_VISIBLE_SECOND_QUAR`<br />**Type:** metric                       |
| <div>% Audible and Visible at Third Quartile</div>             | <br /><br />**Field Name:** `METRIC_ACTIVE_VIEW_PERCENT_AUDIBLE_VISIBLE_THIRD_QUAR`<br />**Type:** metric                        |
| <div>% of Completed Impressions Audible and Visible</div>      | <br /><br />**Field Name:** `METRIC_ACTIVE_VIEW_PERCENT_OF_COMPLETED_IMPRESSIONS_AUDIBLE_AND_VISIBLE`<br />**Type:** metric      |
| <div>% of First Quartile Impressions Audible and Visible</div> | <br /><br />**Field Name:** `METRIC_ACTIVE_VIEW_PERCENT_OF_FIRST_QUARTILE_IMPRESSIONS_AUDIBLE_AND_VISIBLE`<br />**Type:** metric |
| <div>% of Midpoint Impressions Audible and Visible</div>       | <br /><br />**Field Name:** `METRIC_ACTIVE_VIEW_PERCENT_OF_MIDPOINT_IMPRESSIONS_AUDIBLE_AND_VISIBLE`<br />**Type:** metric       |
| <div>% of Third Quartile Impressions Audible and Visible</div> | <br /><br />**Field Name:** `METRIC_ACTIVE_VIEW_PERCENT_OF_THIRD_QUARTILE_IMPRESSIONS_AUDIBLE_AND_VISIBLE`<br />**Type:** metric |
| <div>% Play Time Audible and Visible</div>                     | <br /><br />**Field Name:** `METRIC_ACTIVE_VIEW_PERCENT_PLAY_TIME_AUDIBLE_AND_VISIBLE`<br />**Type:** metric                     |
| <div>Impressions Audible and Visible at Completion</div>       | <br /><br />**Field Name:** `METRIC_ACTIVE_VIEW_AUDIBLE_VISIBLE_ON_COMPLETE_IMPRESSIONS`<br />**Type:** metric                   |

### Active View: Visible

|                                                    |                                                                                                                      |
| -------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------- |
| <div>% of Completed Impressions Visible</div>      | <br /><br />**Field Name:** `METRIC_ACTIVE_VIEW_PERCENT_OF_COMPLETED_IMPRESSIONS_VISIBLE`<br />**Type:** metric      |
| <div>% of First Quartile Impressions Visible</div> | <br /><br />**Field Name:** `METRIC_ACTIVE_VIEW_PERCENT_OF_FIRST_QUARTILE_IMPRESSIONS_VISIBLE`<br />**Type:** metric |
| <div>% of Midpoint Impressions Visible</div>       | <br /><br />**Field Name:** `METRIC_ACTIVE_VIEW_PERCENT_OF_MIDPOINT_IMPRESSIONS_VISIBLE`<br />**Type:** metric       |
| <div>% of Third Quartile Impressions Visible</div> | <br /><br />**Field Name:** `METRIC_ACTIVE_VIEW_PERCENT_OF_THIRD_QUARTILE_IMPRESSIONS_VISIBLE`<br />**Type:** metric |
| <div>% Play Time Visible</div>                     | <br /><br />**Field Name:** `METRIC_ACTIVE_VIEW_PERCENT_PLAY_TIME_VISIBLE`<br />**Type:** metric                     |
| <div>% Visible 10 Seconds</div>                    | <br /><br />**Field Name:** `METRIC_ACTIVE_VIEW_PERCENT_VIEWABLE_FOR_TIME_THRESHOLD`<br />**Type:** metric           |
| <div>% Visible at Start</div>                      | <br /><br />**Field Name:** `METRIC_ACTIVE_VIEW_PERCENT_VISIBLE_AT_START`<br />**Type:** metric                      |
| <div>% Visible at First Quartile</div>             | <br /><br />**Field Name:** `METRIC_ACTIVE_VIEW_PERCENT_VISIBLE_FIRST_QUAR`<br />**Type:** metric                    |
| <div>% Visible at Completion</div>                 | <br /><br />**Field Name:** `METRIC_ACTIVE_VIEW_PERCENT_VISIBLE_ON_COMPLETE`<br />**Type:** metric                   |
| <div>% Visible at Midpoint</div>                   | <br /><br />**Field Name:** `METRIC_ACTIVE_VIEW_PERCENT_VISIBLE_SECOND_QUAR`<br />**Type:** metric                   |
| <div>% Visible at Third Quartile</div>             | <br /><br />**Field Name:** `METRIC_ACTIVE_VIEW_PERCENT_VISIBLE_THIRD_QUAR`<br />**Type:** metric                    |
| <div>Impressions Visible 10 Seconds</div>          | <br /><br />**Field Name:** `METRIC_ACTIVE_VIEW_VIEWABLE_FOR_TIME_THRESHOLD`<br />**Type:** metric                   |

***

## Related

<CardGroup>
  <Card title="Fields Catalog" icon="book" href="/fields-catalog">
    Browse all platforms
  </Card>

  <Card title="Google Ads Fields" icon="chart-bar" href="/data-source/google-ads/fields">
    Google Ads metrics & dimensions
  </Card>

  <Card title="Meta Ads Fields" icon="chart-bar" href="/data-source/facebook-ads/fields">
    Meta Ads metrics & dimensions
  </Card>

  <Card title="TikTok Ads Fields" icon="chart-bar" href="/data-source/tiktok-ads/fields">
    TikTok Ads metrics & dimensions
  </Card>
</CardGroup>


# Google Merchant Center Metrics & Dimensions
Source: https://support.detrics.io/data-source/google-merchant-center/fields

Complete reference for Google Merchant Center dimensions and metrics

<Info>
  **Last updated:** August 6, 2026
</Info>

<div>
  <div>
    71 dimensions
  </div>

  <div>
    18 metrics
  </div>
</div>

This reference covers all available dimensions and metrics for Google Merchant Center data through Detrics. Use this guide to understand what data you can extract and how to structure your queries.

<div>
  <span>Supported destinations:</span>

  <div>
    Google Sheets
  </div>

  <div>
    Claude
  </div>

  <div>
    BigQuery
  </div>
</div>

## Dimensions

Dimensions are the attributes you can use to segment and group your Google Merchant Center data.

### Account

|                         |                                                                                                |
| ----------------------- | ---------------------------------------------------------------------------------------------- |
| <div>Account ID</div>   | Merchant Center account ID<br /><br />**Field Name:** `accountId`<br />**Type:** dimension     |
| <div>Account Name</div> | Merchant Center account name<br /><br />**Field Name:** `accountName`<br />**Type:** dimension |

### Performance

|                                  |                                                                                                                    |
| -------------------------------- | ------------------------------------------------------------------------------------------------------------------ |
| <div>Product ID</div>            | Unique identifier of the product offer<br /><br />**Field Name:** `offerId`<br />**Type:** dimension               |
| <div>Title</div>                 | Product title from the performance report<br /><br />**Field Name:** `title`<br />**Type:** dimension              |
| <div>Brand</div>                 | Product brand<br /><br />**Field Name:** `brand`<br />**Type:** dimension                                          |
| <div>Program</div>               | Shopping program (e.g., Free listings, Shopping ads)<br /><br />**Field Name:** `program`<br />**Type:** dimension |
| <div>Customer Country Code</div> | Country code of the customer<br /><br />**Field Name:** `customerCountryCode`<br />**Type:** dimension             |
| <div>Currency Code</div>         | Currency code for monetary values<br /><br />**Field Name:** `currencyCode`<br />**Type:** dimension               |

### Product Category

|                                         |                                                                                                              |
| --------------------------------------- | ------------------------------------------------------------------------------------------------------------ |
| <div>Product Category (1st Level)</div> | Top-level Google product category<br /><br />**Field Name:** `productCategoryL1`<br />**Type:** dimension    |
| <div>Product Category (2nd Level)</div> | Second-level Google product category<br /><br />**Field Name:** `productCategoryL2`<br />**Type:** dimension |
| <div>Product Category (3rd Level)</div> | Third-level Google product category<br /><br />**Field Name:** `productCategoryL3`<br />**Type:** dimension  |
| <div>Product Category (4th Level)</div> | Fourth-level Google product category<br /><br />**Field Name:** `productCategoryL4`<br />**Type:** dimension |
| <div>Product Category (5th Level)</div> | Fifth-level Google product category<br /><br />**Field Name:** `productCategoryL5`<br />**Type:** dimension  |

### Product Type

|                                     |                                                                                                                       |
| ----------------------------------- | --------------------------------------------------------------------------------------------------------------------- |
| <div>Product Type (1st Level)</div> | Top-level product type defined by the merchant<br /><br />**Field Name:** `productTypeL1`<br />**Type:** dimension    |
| <div>Product Type (2nd Level)</div> | Second-level product type defined by the merchant<br /><br />**Field Name:** `productTypeL2`<br />**Type:** dimension |
| <div>Product Type (3rd Level)</div> | Third-level product type defined by the merchant<br /><br />**Field Name:** `productTypeL3`<br />**Type:** dimension  |
| <div>Product Type (4th Level)</div> | Fourth-level product type defined by the merchant<br /><br />**Field Name:** `productTypeL4`<br />**Type:** dimension |
| <div>Product Type (5th Level)</div> | Fifth-level product type defined by the merchant<br /><br />**Field Name:** `productTypeL5`<br />**Type:** dimension  |

### Custom Label

|                           |                                                                                                          |
| ------------------------- | -------------------------------------------------------------------------------------------------------- |
| <div>Custom Label 0</div> | Custom label 0 for Shopping campaigns<br /><br />**Field Name:** `customLabel0`<br />**Type:** dimension |
| <div>Custom Label 1</div> | Custom label 1 for Shopping campaigns<br /><br />**Field Name:** `customLabel1`<br />**Type:** dimension |
| <div>Custom Label 2</div> | Custom label 2 for Shopping campaigns<br /><br />**Field Name:** `customLabel2`<br />**Type:** dimension |
| <div>Custom Label 3</div> | Custom label 3 for Shopping campaigns<br /><br />**Field Name:** `customLabel3`<br />**Type:** dimension |
| <div>Custom Label 4</div> | Custom label 4 for Shopping campaigns<br /><br />**Field Name:** `customLabel4`<br />**Type:** dimension |

### Products

|                                    |                                                                                                                             |
| ---------------------------------- | --------------------------------------------------------------------------------------------------------------------------- |
| <div>Product ID</div>              | Unique product identifier in Merchant Center<br /><br />**Field Name:** `productId`<br />**Type:** dimension                |
| <div>Item ID</div>                 | Item ID as defined in the product feed<br /><br />**Field Name:** `itemId`<br />**Type:** dimension                         |
| <div>Title</div>                   | Product title from the feed<br /><br />**Field Name:** `productTitle`<br />**Type:** dimension                              |
| <div>Description</div>             | Product description from the feed<br /><br />**Field Name:** `productDescription`<br />**Type:** dimension                  |
| <div>Product Link</div>            | URL to the product landing page<br /><br />**Field Name:** `productLink`<br />**Type:** dimension                           |
| <div>Image Link</div>              | URL to the product image<br /><br />**Field Name:** `imageLink`<br />**Type:** dimension                                    |
| <div>Brand</div>                   | Product brand from the feed<br /><br />**Field Name:** `productBrand`<br />**Type:** dimension                              |
| <div>Condition</div>               | Product condition (new, refurbished, used)<br /><br />**Field Name:** `condition`<br />**Type:** dimension                  |
| <div>Availability</div>            | Product availability status<br /><br />**Field Name:** `availability`<br />**Type:** dimension                              |
| <div>Feed Label</div>              | Feed label for the product<br /><br />**Field Name:** `feedLabel`<br />**Type:** dimension                                  |
| <div>Language</div>                | Product language<br /><br />**Field Name:** `language`<br />**Type:** dimension                                             |
| <div>Source</div>                  | Product data source<br /><br />**Field Name:** `source`<br />**Type:** dimension                                            |
| <div>MPN</div>                     | Manufacturer Part Number<br /><br />**Field Name:** `mpn`<br />**Type:** dimension                                          |
| <div>GTIN</div>                    | Global Trade Item Number<br /><br />**Field Name:** `gtin`<br />**Type:** dimension                                         |
| <div>Product Type</div>            | Merchant-defined product type<br /><br />**Field Name:** `productType`<br />**Type:** dimension                             |
| <div>Target Country</div>          | Target country for the product listing<br /><br />**Field Name:** `targetCountry`<br />**Type:** dimension                  |
| <div>Google Product Category</div> | Google product category assigned to the product<br /><br />**Field Name:** `googleProductCategory`<br />**Type:** dimension |
| <div>Item Group ID</div>           | ID for grouping product variants<br /><br />**Field Name:** `itemGroupId`<br />**Type:** dimension                          |
| <div>Shipping Label</div>          | Shipping label for the product<br /><br />**Field Name:** `shippingLabel`<br />**Type:** dimension                          |
| <div>Channel</div>                 | Sales channel (online, local)<br /><br />**Field Name:** `channel`<br />**Type:** dimension                                 |

### Product Custom Label

|                           |                                                                                                            |
| ------------------------- | ---------------------------------------------------------------------------------------------------------- |
| <div>Custom Label 0</div> | Custom label 0 from product feed<br /><br />**Field Name:** `productCustomLabel0`<br />**Type:** dimension |
| <div>Custom Label 1</div> | Custom label 1 from product feed<br /><br />**Field Name:** `productCustomLabel1`<br />**Type:** dimension |
| <div>Custom Label 2</div> | Custom label 2 from product feed<br /><br />**Field Name:** `productCustomLabel2`<br />**Type:** dimension |
| <div>Custom Label 3</div> | Custom label 3 from product feed<br /><br />**Field Name:** `productCustomLabel3`<br />**Type:** dimension |
| <div>Custom Label 4</div> | Custom label 4 from product feed<br /><br />**Field Name:** `productCustomLabel4`<br />**Type:** dimension |

### Product Pricing

|                         |                                                                                                |
| ----------------------- | ---------------------------------------------------------------------------------------------- |
| <div>Price</div>        | Product price<br /><br />**Field Name:** `price`<br />**Type:** dimension                      |
| <div>Currency</div>     | Product price currency<br /><br />**Field Name:** `productCurrency`<br />**Type:** dimension   |
| <div>Tax Category</div> | Tax category for the product<br /><br />**Field Name:** `taxCategory`<br />**Type:** dimension |

### Diagnostics

|                                   |                                                                                                                       |
| --------------------------------- | --------------------------------------------------------------------------------------------------------------------- |
| <div>Product ID</div>             | Product ID in the diagnostics report<br /><br />**Field Name:** `diagnosticProductId`<br />**Type:** dimension        |
| <div>Title</div>                  | Product title in the diagnostics report<br /><br />**Field Name:** `diagnosticTitle`<br />**Type:** dimension         |
| <div>Link</div>                   | Product link in the diagnostics report<br /><br />**Field Name:** `diagnosticLink`<br />**Type:** dimension           |
| <div>Destination</div>            | Product listing destination<br /><br />**Field Name:** `destination`<br />**Type:** dimension                         |
| <div>Status</div>                 | Product approval status<br /><br />**Field Name:** `status`<br />**Type:** dimension                                  |
| <div>Approved Countries</div>     | Countries where the product is approved<br /><br />**Field Name:** `approvedCountries`<br />**Type:** dimension       |
| <div>Pending Countries</div>      | Countries where the product is pending review<br /><br />**Field Name:** `pendingCountries`<br />**Type:** dimension  |
| <div>Disapproved Countries</div>  | Countries where the product is disapproved<br /><br />**Field Name:** `disapprovedCountries`<br />**Type:** dimension |
| <div>Creation Date</div>          | Date the product was created<br /><br />**Field Name:** `creationDate`<br />**Type:** dimension                       |
| <div>Last Update Date</div>       | Date the product was last updated<br /><br />**Field Name:** `lastUpdateDate`<br />**Type:** dimension                |
| <div>Google Expiration Date</div> | Date the product will expire in Google<br /><br />**Field Name:** `googleExpirationDate`<br />**Type:** dimension     |

### Product Issues

|                                       |                                                                                                                          |
| ------------------------------------- | ------------------------------------------------------------------------------------------------------------------------ |
| <div>Issue Code</div>                 | Code identifying the product issue<br /><br />**Field Name:** `issueCode`<br />**Type:** dimension                       |
| <div>Issue Servability</div>          | Severity of the product issue<br /><br />**Field Name:** `issueServability`<br />**Type:** dimension                     |
| <div>Issue Resolution</div>           | How the issue can be resolved<br /><br />**Field Name:** `issueResolution`<br />**Type:** dimension                      |
| <div>Issue Attribute Name</div>       | Product attribute that caused the issue<br /><br />**Field Name:** `issueAttributeName`<br />**Type:** dimension         |
| <div>Issue Destination</div>          | Destination affected by the issue<br /><br />**Field Name:** `issueDestination`<br />**Type:** dimension                 |
| <div>Issue Description</div>          | Description of the product issue<br /><br />**Field Name:** `issueDescription`<br />**Type:** dimension                  |
| <div>Issue Detail</div>               | Detailed information about the issue<br /><br />**Field Name:** `issueDetail`<br />**Type:** dimension                   |
| <div>Issue Documentation</div>        | Link to documentation about resolving the issue<br /><br />**Field Name:** `issueDocumentation`<br />**Type:** dimension |
| <div>Issue Applicable Countries</div> | Countries affected by the issue<br /><br />**Field Name:** `issueApplicableCountries`<br />**Type:** dimension           |

## Metrics

Metrics are the numerical values you can measure and analyze from your Google Merchant Center campaigns.

### Performance

|                             |                                                                                                          |
| --------------------------- | -------------------------------------------------------------------------------------------------------- |
| <div>Impressions</div>      | Number of times products were shown<br /><br />**Field Name:** `impressions`<br />**Type:** metric       |
| <div>Clicks</div>           | Number of clicks on product listings<br /><br />**Field Name:** `clicks`<br />**Type:** metric           |
| <div>CTR</div>              | Click-through rate (clicks / impressions)<br /><br />**Field Name:** `ctr`<br />**Type:** metric         |
| <div>Conversions</div>      | Number of conversions<br /><br />**Field Name:** `conversions`<br />**Type:** metric                     |
| <div>Conversion Rate</div>  | Conversion rate (conversions / clicks)<br /><br />**Field Name:** `conversionRate`<br />**Type:** metric |
| <div>Conversion Value</div> | Total value of conversions<br /><br />**Field Name:** `conversionValue`<br />**Type:** metric            |

### E-Commerce

|                               |                                                                                                       |
| ----------------------------- | ----------------------------------------------------------------------------------------------------- |
| <div>Orders</div>             | Number of orders<br /><br />**Field Name:** `orders`<br />**Type:** metric                            |
| <div>Ordered Items</div>      | Number of items ordered<br /><br />**Field Name:** `orderedItems`<br />**Type:** metric               |
| <div>Ordered Item Sales</div> | Total sales from ordered items<br /><br />**Field Name:** `orderedItemSales`<br />**Type:** metric    |
| <div>Shipped Items</div>      | Number of items shipped<br /><br />**Field Name:** `shippedItems`<br />**Type:** metric               |
| <div>Shipped Orders</div>     | Number of orders shipped<br /><br />**Field Name:** `shippedOrders`<br />**Type:** metric             |
| <div>Unshipped Items</div>    | Number of items not yet shipped<br /><br />**Field Name:** `unshippedItems`<br />**Type:** metric     |
| <div>Unshipped Orders</div>   | Number of orders not yet shipped<br /><br />**Field Name:** `unshippedOrders`<br />**Type:** metric   |
| <div>Returned Items</div>     | Number of items returned<br /><br />**Field Name:** `returnedItems`<br />**Type:** metric             |
| <div>Return Rate</div>        | Rate of returned items<br /><br />**Field Name:** `returnRate`<br />**Type:** metric                  |
| <div>Average Order Size</div> | Average number of items per order<br /><br />**Field Name:** `averageOrderSize`<br />**Type:** metric |

### Products

|                               |                                                                                                          |
| ----------------------------- | -------------------------------------------------------------------------------------------------------- |
| <div>Number of Products</div> | Total number of products in the feed<br /><br />**Field Name:** `numberOfProducts`<br />**Type:** metric |

### Diagnostics

|                               |                                                                                                                              |
| ----------------------------- | ---------------------------------------------------------------------------------------------------------------------------- |
| <div>Number of Products</div> | Number of products with diagnostic information<br /><br />**Field Name:** `numberOfDiagnosticProducts`<br />**Type:** metric |

***

## Related

<CardGroup>
  <Card title="Fields Catalog" icon="book" href="/fields-catalog">
    Browse all platforms
  </Card>

  <Card title="Klaviyo Fields" icon="chart-bar" href="/data-source/klaviyo/fields">
    Klaviyo metrics & dimensions
  </Card>

  <Card title="HubSpot Fields" icon="chart-bar" href="/data-source/hubspot/fields">
    HubSpot metrics & dimensions
  </Card>

  <Card title="Mailchimp Fields" icon="chart-bar" href="/data-source/mailchimp/fields">
    Mailchimp metrics & dimensions
  </Card>
</CardGroup>


# Google Search Console Metrics & Dimensions
Source: https://support.detrics.io/data-source/google-search-console/fields

Complete reference for Google Search Console dimensions and metrics

<Info>
  **Last updated:** August 6, 2026
</Info>

<div>
  <div>
    29 dimensions
  </div>

  <div>
    10 metrics
  </div>
</div>

This reference covers all available dimensions and metrics for Google Search Console data through Detrics. Use this guide to understand what data you can extract and how to structure your queries.

<div>
  <span>Supported destinations:</span>

  <div>
    Google Sheets
  </div>

  <div>
    Claude
  </div>

  <div>
    BigQuery
  </div>
</div>

## Dimensions

Dimensions are the attributes you can use to segment and group your Google Search Console data.

### Most Used

|                        |                                                                                                                                                                                                               |
| ---------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| <div>Account URL</div> | <br /><br />**Field Name:** `SITE_URL`<br />**Type:** dimension                                                                                                                                               |
| <div>Device</div>      | <br /><br />**Field Name:** `DEVICE`<br />**Type:** dimension                                                                                                                                                 |
| <div>Page</div>        | <br /><br />**Field Name:** `PAGE`<br />**Type:** dimension                                                                                                                                                   |
| <div>Country</div>     | <br /><br />**Field Name:** `COUNTRY`<br />**Type:** dimension                                                                                                                                                |
| <div>Query</div>       | <br /><br />**Field Name:** `QUERY`<br />**Type:** dimension                                                                                                                                                  |
| <div>Search Type</div> | Where the impression happened: web search, image search, video search, news, Google Discover, or Google News. Adds one row per search type.<br /><br />**Field Name:** `SEARCH_TYPE`<br />**Type:** dimension |

### Single Selection Metric

|                              |                                                                                                                                                                                                               |
| ---------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| <div>Search Appearance</div> | Only compatible with the 'Account URL' metric and 'No Time Grouping'. It can also be used as a filter combined with other dimensions.<br /><br />**Field Name:** `SEARCH_APPEARANCE`<br />**Type:** dimension |

### Page Indexing

|                               |                                                                                                                                                                                                                          |
| ----------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| <div>Inspected URL</div>      | The page inspected via the URL Inspection API. The top pages of your property (by clicks in the selected period) are inspected, up to 100 per query.<br /><br />**Field Name:** `INSPECTED_URL`<br />**Type:** dimension |
| <div>Index Verdict</div>      | Overall index status verdict for the page: PASS, NEUTRAL, or FAIL.<br /><br />**Field Name:** `INDEX_VERDICT`<br />**Type:** dimension                                                                                   |
| <div>Coverage State</div>     | Whether the page is indexed and how, e.g. 'Submitted and indexed' or 'Crawled - currently not indexed'.<br /><br />**Field Name:** `COVERAGE_STATE`<br />**Type:** dimension                                             |
| <div>Robots.txt State</div>   | Whether robots.txt allows Google to crawl the page.<br /><br />**Field Name:** `ROBOTS_TXT_STATE`<br />**Type:** dimension                                                                                               |
| <div>Indexing State</div>     | Whether indexing is allowed for the page (e.g. blocked by a noindex directive).<br /><br />**Field Name:** `INDEXING_STATE`<br />**Type:** dimension                                                                     |
| <div>Last Crawl Time</div>    | When Googlebot last crawled the page.<br /><br />**Field Name:** `LAST_CRAWL_TIME`<br />**Type:** dimension                                                                                                              |
| <div>Page Fetch State</div>   | Whether Google could fetch the page on its last crawl (e.g. SUCCESSFUL, SOFT\_404, ACCESS\_DENIED).<br /><br />**Field Name:** `PAGE_FETCH_STATE`<br />**Type:** dimension                                               |
| <div>Google Canonical</div>   | The canonical URL Google selected for the page.<br /><br />**Field Name:** `GOOGLE_CANONICAL`<br />**Type:** dimension                                                                                                   |
| <div>User Canonical</div>     | The canonical URL declared by your page.<br /><br />**Field Name:** `USER_CANONICAL`<br />**Type:** dimension                                                                                                            |
| <div>Canonical Mismatch</div> | True when Google selected a different canonical than the one your page declares — a common technical SEO issue.<br /><br />**Field Name:** `CANONICAL_MISMATCH`<br />**Type:** dimension                                 |
| <div>Crawled As</div>         | The user agent Google used to crawl the page (MOBILE or DESKTOP).<br /><br />**Field Name:** `CRAWLED_AS`<br />**Type:** dimension                                                                                       |
| <div>Referring Sitemaps</div> | Sitemaps that list this page, as reported by Google.<br /><br />**Field Name:** `REFERRING_SITEMAPS`<br />**Type:** dimension                                                                                            |

### Rich Results

|                                       |                                                                                                                                                                                                                                                      |
| ------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| <div>Rich Results Verdict</div>       | Overall structured data verdict for the page: PASS means all rich result items are valid, FAIL means at least one has errors. Empty when the page has no structured data.<br /><br />**Field Name:** `RICH_RESULTS_VERDICT`<br />**Type:** dimension |
| <div>Rich Result Type</div>           | Type of rich result detected on the page: Breadcrumbs, Review snippets, Videos, FAQ, etc. Same types as the Enhancements reports in Google Search Console.<br /><br />**Field Name:** `RICH_RESULT_TYPE`<br />**Type:** dimension                    |
| <div>Rich Result Item</div>           | Name of the individual structured data item detected on the page.<br /><br />**Field Name:** `RICH_RESULT_ITEM_NAME`<br />**Type:** dimension                                                                                                        |
| <div>Rich Result Issue</div>          | Validation issue found in the structured data item, e.g. 'Missing field "uploadDate"'. Empty when the item is valid.<br /><br />**Field Name:** `RICH_RESULT_ISSUE`<br />**Type:** dimension                                                         |
| <div>Rich Result Issue Severity</div> | Severity of the issue: ERROR makes the item invalid for rich results, WARNING does not.<br /><br />**Field Name:** `RICH_RESULT_ISSUE_SEVERITY`<br />**Type:** dimension                                                                             |

### Sitemaps

|                                    |                                                                                                                                         |
| ---------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------- |
| <div>Sitemap Path</div>            | URL of the sitemap submitted to Google Search Console.<br /><br />**Field Name:** `SITEMAP_PATH`<br />**Type:** dimension               |
| <div>Sitemap Type</div>            | Type of the sitemap: 'Sitemap index' or 'sitemap'.<br /><br />**Field Name:** `SITEMAP_TYPE`<br />**Type:** dimension                   |
| <div>Sitemap Is Pending</div>      | True while Google has not yet processed the submitted sitemap.<br /><br />**Field Name:** `SITEMAP_IS_PENDING`<br />**Type:** dimension |
| <div>Sitemap Last Submitted</div>  | When the sitemap was last submitted to Google.<br /><br />**Field Name:** `SITEMAP_LAST_SUBMITTED`<br />**Type:** dimension             |
| <div>Sitemap Last Downloaded</div> | When Google last downloaded the sitemap.<br /><br />**Field Name:** `SITEMAP_LAST_DOWNLOADED`<br />**Type:** dimension                  |

## Metrics

Metrics are the numerical values you can measure and analyze from your Google Search Console campaigns.

### Most Used

|                        |                                                                 |
| ---------------------- | --------------------------------------------------------------- |
| <div>CTR</div>         | <br /><br />**Field Name:** `ctr`<br />**Type:** metric         |
| <div>Impressions</div> | <br /><br />**Field Name:** `impressions`<br />**Type:** metric |
| <div>Position</div>    | <br /><br />**Field Name:** `position`<br />**Type:** metric    |
| <div>Clicks</div>      | <br /><br />**Field Name:** `clicks`<br />**Type:** metric      |

### Rich Results

|                                 |                                                                                                                                                                                            |
| ------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| <div>Rich Result Items</div>    | Number of structured data items Google detected (breadcrumbs, review snippets, videos, etc.).<br /><br />**Field Name:** `richResultItems`<br />**Type:** metric                           |
| <div>Rich Result Errors</div>   | Number of ERROR-severity structured data issues. Items with errors are not eligible for rich results in Google Search.<br /><br />**Field Name:** `richResultErrors`<br />**Type:** metric |
| <div>Rich Result Warnings</div> | Number of WARNING-severity structured data issues.<br /><br />**Field Name:** `richResultWarnings`<br />**Type:** metric                                                                   |

### Sitemaps

|                                   |                                                                                                                                  |
| --------------------------------- | -------------------------------------------------------------------------------------------------------------------------------- |
| <div>Sitemap Errors</div>         | Number of errors Google found while processing the sitemap.<br /><br />**Field Name:** `sitemapErrors`<br />**Type:** metric     |
| <div>Sitemap Warnings</div>       | Number of warnings Google found while processing the sitemap.<br /><br />**Field Name:** `sitemapWarnings`<br />**Type:** metric |
| <div>Sitemap Submitted URLs</div> | Number of URLs submitted in the sitemap.<br /><br />**Field Name:** `sitemapSubmittedUrls`<br />**Type:** metric                 |

***

## Related

<CardGroup>
  <Card title="Fields Catalog" icon="book" href="/fields-catalog">
    Browse all platforms
  </Card>

  <Card title="Google Analytics 4 Fields" icon="chart-bar" href="/data-source/google-analytics-4/fields">
    Google Analytics 4 metrics & dimensions
  </Card>
</CardGroup>


# HubSpot Metrics & Dimensions
Source: https://support.detrics.io/data-source/hubspot/fields

Complete reference for HubSpot CRM dimensions and metrics

<Info>
  **Last updated:** August 6, 2026
</Info>

<div>
  <div>
    189 dimensions
  </div>

  <div>
    105 metrics
  </div>
</div>

This reference covers all available dimensions and metrics for HubSpot data through Detrics. Use this guide to understand what data you can extract and how to structure your queries.

<div>
  <span>Supported destinations:</span>

  <div>
    Google Sheets
  </div>

  <div>
    Claude
  </div>

  <div>
    BigQuery
  </div>
</div>

## Dimensions

Dimensions are the attributes you can use to segment and group your HubSpot data.

### Account

|                             |                                                                                                                       |
| --------------------------- | --------------------------------------------------------------------------------------------------------------------- |
| <div>Account ID</div>       | The unique identifier for the HubSpot account<br /><br />**Field Name:** `accountId`<br />**Type:** dimension         |
| <div>Account name</div>     | The name of the HubSpot account<br /><br />**Field Name:** `accountName`<br />**Type:** dimension                     |
| <div>Account timezone</div> | The timezone configured for the HubSpot account<br /><br />**Field Name:** `accountTimezone`<br />**Type:** dimension |
| <div>Account currency</div> | The default currency for the HubSpot account<br /><br />**Field Name:** `accountCurrency`<br />**Type:** dimension    |

### Contact

|                                           |                                                                                                                                                          |
| ----------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------- |
| <div>Contact ID</div>                     | The unique identifier for the contact in HubSpot<br /><br />**Field Name:** `contactId`<br />**Type:** dimension                                         |
| <div>Contact email</div>                  | The primary email address of the contact<br /><br />**Field Name:** `contactEmail`<br />**Type:** dimension                                              |
| <div>Contact first name</div>             | The first name of the contact<br /><br />**Field Name:** `contactFirstName`<br />**Type:** dimension                                                     |
| <div>Contact last name</div>              | The last name of the contact<br /><br />**Field Name:** `contactLastName`<br />**Type:** dimension                                                       |
| <div>Contact full name</div>              | The full name of the contact (first + last)<br /><br />**Field Name:** `contactFullName`<br />**Type:** dimension                                        |
| <div>Contact phone</div>                  | The primary phone number of the contact<br /><br />**Field Name:** `contactPhone`<br />**Type:** dimension                                               |
| <div>Contact mobile phone</div>           | The mobile phone number of the contact<br /><br />**Field Name:** `contactMobilePhone`<br />**Type:** dimension                                          |
| <div>Contact company</div>                | The company name associated with the contact<br /><br />**Field Name:** `contactCompany`<br />**Type:** dimension                                        |
| <div>Contact job title</div>              | The job title of the contact<br /><br />**Field Name:** `contactJobTitle`<br />**Type:** dimension                                                       |
| <div>Contact lifecycle stage</div>        | The lifecycle stage of the contact (e.g., subscriber, lead, customer)<br /><br />**Field Name:** `contactLifecycleStage`<br />**Type:** dimension        |
| <div>Contact lead status</div>            | The lead status of the contact (e.g., new, open, in progress)<br /><br />**Field Name:** `contactLeadStatus`<br />**Type:** dimension                    |
| <div>Contact city</div>                   | The city from the contact's address<br /><br />**Field Name:** `contactCity`<br />**Type:** dimension                                                    |
| <div>Contact state</div>                  | The state or region from the contact's address<br /><br />**Field Name:** `contactState`<br />**Type:** dimension                                        |
| <div>Contact country</div>                | The country from the contact's address<br /><br />**Field Name:** `contactCountry`<br />**Type:** dimension                                              |
| <div>Contact zip</div>                    | The zip or postal code from the contact's address<br /><br />**Field Name:** `contactZip`<br />**Type:** dimension                                       |
| <div>Contact owner ID</div>               | The ID of the HubSpot user who owns this contact<br /><br />**Field Name:** `contactOwnerId`<br />**Type:** dimension                                    |
| <div>Contact owner name</div>             | The name of the HubSpot user who owns this contact<br /><br />**Field Name:** `contactOwnerName`<br />**Type:** dimension                                |
| <div>Contact create date</div>            | The date the contact was created in HubSpot<br /><br />**Field Name:** `contactCreateDate`<br />**Type:** dimension                                      |
| <div>Contact last modified date</div>     | The date the contact was last modified<br /><br />**Field Name:** `contactLastModifiedDate`<br />**Type:** dimension                                     |
| <div>Contact last activity date</div>     | The date of the last activity on the contact<br /><br />**Field Name:** `contactLastActivityDate`<br />**Type:** dimension                               |
| <div>Contact source</div>                 | The original traffic source that created the contact (e.g., organic, paid, referral)<br /><br />**Field Name:** `contactSource`<br />**Type:** dimension |
| <div>Contact source detail 1</div>        | Additional detail about the contact source<br /><br />**Field Name:** `contactSourceData1`<br />**Type:** dimension                                      |
| <div>Contact source detail 2</div>        | Further detail about the contact source<br /><br />**Field Name:** `contactSourceData2`<br />**Type:** dimension                                         |
| <div>Contact subscriber date</div>        | The date the contact entered the subscriber lifecycle stage<br /><br />**Field Name:** `contactSubscriberDate`<br />**Type:** dimension                  |
| <div>Contact lead date</div>              | The date the contact entered the lead lifecycle stage<br /><br />**Field Name:** `contactLeadDate`<br />**Type:** dimension                              |
| <div>Contact MQL date</div>               | The date the contact became a marketing qualified lead<br /><br />**Field Name:** `contactMarketingQualifiedLeadDate`<br />**Type:** dimension           |
| <div>Contact SQL date</div>               | The date the contact became a sales qualified lead<br /><br />**Field Name:** `contactSalesQualifiedLeadDate`<br />**Type:** dimension                   |
| <div>Contact opportunity date</div>       | The date the contact entered the opportunity stage<br /><br />**Field Name:** `contactOpportunityDate`<br />**Type:** dimension                          |
| <div>Contact customer date</div>          | The date the contact became a customer<br /><br />**Field Name:** `contactCustomerDate`<br />**Type:** dimension                                         |
| <div>Contact evangelist date</div>        | The date the contact entered the evangelist lifecycle stage<br /><br />**Field Name:** `contactEvangelistDate`<br />**Type:** dimension                  |
| <div>Contact close date</div>             | The date the contact record was closed<br /><br />**Field Name:** `contactCloseDate`<br />**Type:** dimension                                            |
| <div>Contact first conversion</div>       | The name of the first form or event that converted this contact<br /><br />**Field Name:** `contactFirstConversion`<br />**Type:** dimension             |
| <div>Contact first conversion date</div>  | The date of the first form or event that converted this contact<br /><br />**Field Name:** `contactFirstConversionDate`<br />**Type:** dimension         |
| <div>Contact recent conversion</div>      | The name of the most recent form or event that converted this contact<br /><br />**Field Name:** `contactRecentConversion`<br />**Type:** dimension      |
| <div>Contact recent conversion date</div> | The date of the most recent form or event that converted this contact<br /><br />**Field Name:** `contactRecentConversionDate`<br />**Type:** dimension  |
| <div>Contact first page seen</div>        | The URL of the first page the contact visited on your site<br /><br />**Field Name:** `contactFirstPageSeen`<br />**Type:** dimension                    |
| <div>Contact last page seen</div>         | The URL of the last page the contact visited on your site<br /><br />**Field Name:** `contactLastPageSeen`<br />**Type:** dimension                      |
| <div>Contact first referrer</div>         | The URL of the first website that referred the contact to your site<br /><br />**Field Name:** `contactFirstReferrer`<br />**Type:** dimension           |
| <div>Contact last referrer</div>          | The URL of the last website that referred the contact to your site<br /><br />**Field Name:** `contactLastReferrer`<br />**Type:** dimension             |
| <div>Contact IP country</div>             | The country determined by the contact's IP address<br /><br />**Field Name:** `contactIpCountry`<br />**Type:** dimension                                |

### Company

|                                                |                                                                                                                                                      |
| ---------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------- |
| <div>Company ID</div>                          | The unique identifier for the company in HubSpot<br /><br />**Field Name:** `companyId`<br />**Type:** dimension                                     |
| <div>Company name</div>                        | The name of the company<br /><br />**Field Name:** `companyName`<br />**Type:** dimension                                                            |
| <div>Company domain</div>                      | The primary domain name of the company<br /><br />**Field Name:** `companyDomain`<br />**Type:** dimension                                           |
| <div>Company industry</div>                    | The industry the company belongs to<br /><br />**Field Name:** `companyIndustry`<br />**Type:** dimension                                            |
| <div>Company type</div>                        | The type of company (e.g., prospect, partner, reseller, vendor)<br /><br />**Field Name:** `companyType`<br />**Type:** dimension                    |
| <div>Company city</div>                        | The city from the company's address<br /><br />**Field Name:** `companyCity`<br />**Type:** dimension                                                |
| <div>Company state</div>                       | The state or region from the company's address<br /><br />**Field Name:** `companyState`<br />**Type:** dimension                                    |
| <div>Company country</div>                     | The country from the company's address<br /><br />**Field Name:** `companyCountry`<br />**Type:** dimension                                          |
| <div>Company zip</div>                         | The zip or postal code from the company's address<br /><br />**Field Name:** `companyZip`<br />**Type:** dimension                                   |
| <div>Company phone</div>                       | The primary phone number of the company<br /><br />**Field Name:** `companyPhone`<br />**Type:** dimension                                           |
| <div>Company website</div>                     | The website URL of the company<br /><br />**Field Name:** `companyWebsite`<br />**Type:** dimension                                                  |
| <div>Company lifecycle stage</div>             | The lifecycle stage of the company<br /><br />**Field Name:** `companyLifecycleStage`<br />**Type:** dimension                                       |
| <div>Company lead status</div>                 | The lead status of the company<br /><br />**Field Name:** `companyLeadStatus`<br />**Type:** dimension                                               |
| <div>Company owner ID</div>                    | The ID of the HubSpot user who owns this company<br /><br />**Field Name:** `companyOwnerId`<br />**Type:** dimension                                |
| <div>Company owner name</div>                  | The name of the HubSpot user who owns this company<br /><br />**Field Name:** `companyOwnerName`<br />**Type:** dimension                            |
| <div>Company create date</div>                 | The date the company was created in HubSpot<br /><br />**Field Name:** `companyCreateDate`<br />**Type:** dimension                                  |
| <div>Company last modified date</div>          | The date the company was last modified<br /><br />**Field Name:** `companyLastModifiedDate`<br />**Type:** dimension                                 |
| <div>Company last activity date</div>          | The date of the last activity on the company<br /><br />**Field Name:** `companyLastActivityDate`<br />**Type:** dimension                           |
| <div>Company source</div>                      | The original traffic source that created the company<br /><br />**Field Name:** `companySource`<br />**Type:** dimension                             |
| <div>Company description</div>                 | A text description of the company<br /><br />**Field Name:** `companyDescription`<br />**Type:** dimension                                           |
| <div>Company address</div>                     | The street address of the company<br /><br />**Field Name:** `companyAddress`<br />**Type:** dimension                                               |
| <div>Company close date</div>                  | The date the company record was closed<br /><br />**Field Name:** `companyCloseDate`<br />**Type:** dimension                                        |
| <div>Company last contacted date</div>         | The date the company was last contacted<br /><br />**Field Name:** `companyLastContactedDate`<br />**Type:** dimension                               |
| <div>Company next activity date</div>          | The date of the next scheduled activity on the company<br /><br />**Field Name:** `companyNextActivityDate`<br />**Type:** dimension                 |
| <div>Company last activity date (direct)</div> | The date of the last direct activity on the company record<br /><br />**Field Name:** `companyLastActivityDateDirect`<br />**Type:** dimension       |
| <div>Company owner assigned date</div>         | The date the current owner was assigned to the company<br /><br />**Field Name:** `companyOwnerAssignedDate`<br />**Type:** dimension                |
| <div>Company first contact create date</div>   | The create date of the first contact associated with the company<br /><br />**Field Name:** `companyFirstContactCreateDate`<br />**Type:** dimension |
| <div>Company first deal create date</div>      | The create date of the first deal associated with the company<br /><br />**Field Name:** `companyFirstDealCreateDate`<br />**Type:** dimension       |
| <div>Company year founded</div>                | The year the company was founded<br /><br />**Field Name:** `companyYearFounded`<br />**Type:** dimension                                            |

### Deal

|                                     |                                                                                                                                              |
| ----------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------- |
| <div>Deal ID</div>                  | The unique identifier for the deal in HubSpot<br /><br />**Field Name:** `dealId`<br />**Type:** dimension                                   |
| <div>Deal name</div>                | The name of the deal<br /><br />**Field Name:** `dealName`<br />**Type:** dimension                                                          |
| <div>Deal stage ID</div>            | The internal ID of the current deal stage<br /><br />**Field Name:** `dealStage`<br />**Type:** dimension                                    |
| <div>Deal stage name</div>          | The display name of the current deal stage<br /><br />**Field Name:** `dealStageName`<br />**Type:** dimension                               |
| <div>Deal pipeline ID</div>         | The internal ID of the deal pipeline<br /><br />**Field Name:** `dealPipeline`<br />**Type:** dimension                                      |
| <div>Deal pipeline name</div>       | The display name of the deal pipeline<br /><br />**Field Name:** `dealPipelineName`<br />**Type:** dimension                                 |
| <div>Deal type</div>                | The type of deal (e.g., new business, existing business)<br /><br />**Field Name:** `dealType`<br />**Type:** dimension                      |
| <div>Deal description</div>         | A text description of the deal<br /><br />**Field Name:** `dealDescription`<br />**Type:** dimension                                         |
| <div>Deal owner ID</div>            | The ID of the HubSpot user who owns this deal<br /><br />**Field Name:** `dealOwnerId`<br />**Type:** dimension                              |
| <div>Deal owner name</div>          | The name of the HubSpot user who owns this deal<br /><br />**Field Name:** `dealOwnerName`<br />**Type:** dimension                          |
| <div>Deal create date</div>         | The date the deal was created in HubSpot<br /><br />**Field Name:** `dealCreateDate`<br />**Type:** dimension                                |
| <div>Deal last modified date</div>  | The date the deal was last modified<br /><br />**Field Name:** `dealLastModifiedDate`<br />**Type:** dimension                               |
| <div>Deal close date</div>          | The expected or actual close date of the deal<br /><br />**Field Name:** `dealCloseDate`<br />**Type:** dimension                            |
| <div>Deal closed won date</div>     | The date the deal was marked as closed won<br /><br />**Field Name:** `dealClosedWonDate`<br />**Type:** dimension                           |
| <div>Deal closed lost reason</div>  | The reason the deal was lost<br /><br />**Field Name:** `dealClosedLostReason`<br />**Type:** dimension                                      |
| <div>Deal closed won reason</div>   | The reason the deal was won<br /><br />**Field Name:** `dealClosedWonReason`<br />**Type:** dimension                                        |
| <div>Deal source</div>              | The original traffic source for the deal<br /><br />**Field Name:** `dealSource`<br />**Type:** dimension                                    |
| <div>Deal source detail 1</div>     | Additional detail about the deal source<br /><br />**Field Name:** `dealSourceData1`<br />**Type:** dimension                                |
| <div>Deal source detail 2</div>     | Further detail about the deal source<br /><br />**Field Name:** `dealSourceData2`<br />**Type:** dimension                                   |
| <div>Deal priority</div>            | The priority level of the deal<br /><br />**Field Name:** `dealPriority`<br />**Type:** dimension                                            |
| <div>Deal currency</div>            | The currency code for the deal (e.g., USD, EUR)<br /><br />**Field Name:** `dealCurrency`<br />**Type:** dimension                           |
| <div>Deal stage probability</div>   | The probability percentage associated with the current deal stage<br /><br />**Field Name:** `dealStageProbability`<br />**Type:** dimension |
| <div>Deal last activity date</div>  | The date of the last direct activity on the deal<br /><br />**Field Name:** `dealLastActivityDate`<br />**Type:** dimension                  |
| <div>Deal last contacted date</div> | The date the deal was last contacted<br /><br />**Field Name:** `dealLastContactedDate`<br />**Type:** dimension                             |
| <div>Deal next activity date</div>  | The date of the next scheduled activity on the deal<br /><br />**Field Name:** `dealNextActivityDate`<br />**Type:** dimension               |
| <div>Deal owner assigned date</div> | The date the current owner was assigned to the deal<br /><br />**Field Name:** `dealOwnerAssignedDate`<br />**Type:** dimension              |

### Ticket

|                                            |                                                                                                                                     |
| ------------------------------------------ | ----------------------------------------------------------------------------------------------------------------------------------- |
| <div>Ticket ID</div>                       | The unique identifier for the ticket in HubSpot<br /><br />**Field Name:** `ticketId`<br />**Type:** dimension                      |
| <div>Ticket name</div>                     | The subject/name of the support ticket<br /><br />**Field Name:** `ticketName`<br />**Type:** dimension                             |
| <div>Ticket status</div>                   | The current status of the ticket in its pipeline<br /><br />**Field Name:** `ticketStatus`<br />**Type:** dimension                 |
| <div>Ticket pipeline ID</div>              | The internal ID of the ticket pipeline<br /><br />**Field Name:** `ticketPipeline`<br />**Type:** dimension                         |
| <div>Ticket pipeline name</div>            | The display name of the ticket pipeline<br /><br />**Field Name:** `ticketPipelineName`<br />**Type:** dimension                    |
| <div>Ticket category</div>                 | The category of the support ticket<br /><br />**Field Name:** `ticketCategory`<br />**Type:** dimension                             |
| <div>Ticket priority</div>                 | The priority level of the ticket (e.g., low, medium, high)<br /><br />**Field Name:** `ticketPriority`<br />**Type:** dimension     |
| <div>Ticket description</div>              | The content/description of the support ticket<br /><br />**Field Name:** `ticketDescription`<br />**Type:** dimension               |
| <div>Ticket owner ID</div>                 | The ID of the HubSpot user who owns this ticket<br /><br />**Field Name:** `ticketOwnerId`<br />**Type:** dimension                 |
| <div>Ticket owner name</div>               | The name of the HubSpot user who owns this ticket<br /><br />**Field Name:** `ticketOwnerName`<br />**Type:** dimension             |
| <div>Ticket create date</div>              | The date the ticket was created in HubSpot<br /><br />**Field Name:** `ticketCreateDate`<br />**Type:** dimension                   |
| <div>Ticket last modified date</div>       | The date the ticket was last modified<br /><br />**Field Name:** `ticketLastModifiedDate`<br />**Type:** dimension                  |
| <div>Ticket close date</div>               | The date the ticket was closed<br /><br />**Field Name:** `ticketCloseDate`<br />**Type:** dimension                                |
| <div>Ticket source</div>                   | The source/channel the ticket was created from<br /><br />**Field Name:** `ticketSource`<br />**Type:** dimension                   |
| <div>Ticket last activity date</div>       | The date of the last activity on the ticket<br /><br />**Field Name:** `ticketLastActivityDate`<br />**Type:** dimension            |
| <div>Ticket last contacted date</div>      | The date the ticket was last contacted<br /><br />**Field Name:** `ticketLastContactedDate`<br />**Type:** dimension                |
| <div>Ticket last customer reply date</div> | The date of the last customer reply on the ticket<br /><br />**Field Name:** `ticketLastCustomerReplyDate`<br />**Type:** dimension |
| <div>Ticket next activity date</div>       | The date of the next scheduled activity on the ticket<br /><br />**Field Name:** `ticketNextActivityDate`<br />**Type:** dimension  |
| <div>Ticket owner assigned date</div>      | The date the current owner was assigned to the ticket<br /><br />**Field Name:** `ticketOwnerAssignedDate`<br />**Type:** dimension |
| <div>Ticket first agent reply date</div>   | The date of the first agent reply on the ticket<br /><br />**Field Name:** `ticketFirstAgentReplyDate`<br />**Type:** dimension     |

### Email Campaign

|                                         |                                                                                                                                        |
| --------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------- |
| <div>Campaign ID</div>                  | The unique identifier for the email campaign<br /><br />**Field Name:** `emailCampaignId`<br />**Type:** dimension                     |
| <div>Campaign name</div>                | The name of the email campaign<br /><br />**Field Name:** `emailCampaignName`<br />**Type:** dimension                                 |
| <div>Campaign subject</div>             | The subject line of the email campaign<br /><br />**Field Name:** `emailCampaignSubject`<br />**Type:** dimension                      |
| <div>Campaign type</div>                | The type of email campaign (e.g., regular, automated)<br /><br />**Field Name:** `emailCampaignType`<br />**Type:** dimension          |
| <div>Campaign subtype</div>             | The subtype of the email campaign<br /><br />**Field Name:** `emailCampaignSubtype`<br />**Type:** dimension                           |
| <div>Campaign app name</div>            | The application that created the email campaign<br /><br />**Field Name:** `emailCampaignAppName`<br />**Type:** dimension             |
| <div>Campaign content ID</div>          | The content ID associated with the email campaign<br /><br />**Field Name:** `emailCampaignContentId`<br />**Type:** dimension         |
| <div>Campaign group ID</div>            | The group ID for the email campaign<br /><br />**Field Name:** `emailCampaignGroupId`<br />**Type:** dimension                         |
| <div>Campaign app ID</div>              | The application ID that created the campaign<br /><br />**Field Name:** `emailCampaignAppId`<br />**Type:** dimension                  |
| <div>Campaign recipients included</div> | The number of recipients included in the email campaign<br /><br />**Field Name:** `emailCampaignNumIncluded`<br />**Type:** dimension |

### Form

|                              |                                                                                                                   |
| ---------------------------- | ----------------------------------------------------------------------------------------------------------------- |
| <div>Form ID</div>           | The unique identifier for the form<br /><br />**Field Name:** `formId`<br />**Type:** dimension                   |
| <div>Form name</div>         | The name of the form<br /><br />**Field Name:** `formName`<br />**Type:** dimension                               |
| <div>Form type</div>         | The type of form (e.g., regular, pop-up, embedded)<br /><br />**Field Name:** `formType`<br />**Type:** dimension |
| <div>Form created date</div> | The date the form was created<br /><br />**Field Name:** `formCreatedDate`<br />**Type:** dimension               |
| <div>Form updated date</div> | The date the form was last updated<br /><br />**Field Name:** `formUpdatedDate`<br />**Type:** dimension          |

### Product

|                                       |                                                                                                                                                            |
| ------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------- |
| <div>Product ID</div>                 | The unique identifier for the product in HubSpot<br /><br />**Field Name:** `productId`<br />**Type:** dimension                                           |
| <div>Product name</div>               | The name of the product<br /><br />**Field Name:** `productName`<br />**Type:** dimension                                                                  |
| <div>Product SKU</div>                | The stock keeping unit identifier for the product<br /><br />**Field Name:** `productSku`<br />**Type:** dimension                                         |
| <div>Product description</div>        | The description of the product<br /><br />**Field Name:** `productDescription`<br />**Type:** dimension                                                    |
| <div>Product price</div>              | The unit price of the product<br /><br />**Field Name:** `productPrice`<br />**Type:** dimension                                                           |
| <div>Product cost of goods</div>      | The cost of goods sold for the product<br /><br />**Field Name:** `productCostOfGoods`<br />**Type:** dimension                                            |
| <div>Product billing period</div>     | The recurring billing period for the product (e.g., monthly, annually)<br /><br />**Field Name:** `productRecurringBillingPeriod`<br />**Type:** dimension |
| <div>Product create date</div>        | The date the product was created<br /><br />**Field Name:** `productCreateDate`<br />**Type:** dimension                                                   |
| <div>Product last modified date</div> | The date the product was last modified<br /><br />**Field Name:** `productLastModifiedDate`<br />**Type:** dimension                                       |

### Line Item

|                                         |                                                                                                                                                |
| --------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------- |
| <div>Line item ID</div>                 | The unique identifier for the line item<br /><br />**Field Name:** `lineItemId`<br />**Type:** dimension                                       |
| <div>Line item name</div>               | The name of the line item<br /><br />**Field Name:** `lineItemName`<br />**Type:** dimension                                                   |
| <div>Line item SKU</div>                | The stock keeping unit for the line item<br /><br />**Field Name:** `lineItemSku`<br />**Type:** dimension                                     |
| <div>Line item description</div>        | The description of the line item<br /><br />**Field Name:** `lineItemDescription`<br />**Type:** dimension                                     |
| <div>Line item create date</div>        | The date the line item was created<br /><br />**Field Name:** `lineItemCreateDate`<br />**Type:** dimension                                    |
| <div>Line item last modified date</div> | The date the line item was last modified<br /><br />**Field Name:** `lineItemLastModifiedDate`<br />**Type:** dimension                        |
| <div>Line item product ID</div>         | The ID of the product associated with this line item<br /><br />**Field Name:** `lineItemProductId`<br />**Type:** dimension                   |
| <div>Line item billing start date</div> | The start date for recurring billing on this line item<br /><br />**Field Name:** `lineItemRecurringBillingStartDate`<br />**Type:** dimension |
| <div>Line item billing end date</div>   | The end date for recurring billing on this line item<br /><br />**Field Name:** `lineItemRecurringBillingEndDate`<br />**Type:** dimension     |
| <div>Line item billing frequency</div>  | The recurring billing frequency for this line item<br /><br />**Field Name:** `lineItemBillingFrequency`<br />**Type:** dimension              |

### Activity

|                                        |                                                                                                                                       |
| -------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------- |
| <div>Activity ID</div>                 | The unique identifier for the activity<br /><br />**Field Name:** `activityId`<br />**Type:** dimension                               |
| <div>Activity type</div>               | The type of activity (call, meeting, task, or note)<br /><br />**Field Name:** `activityType`<br />**Type:** dimension                |
| <div>Activity title</div>              | The title or subject of the activity<br /><br />**Field Name:** `activityTitle`<br />**Type:** dimension                              |
| <div>Activity body</div>               | The body or description of the activity<br /><br />**Field Name:** `activityBody`<br />**Type:** dimension                            |
| <div>Activity owner ID</div>           | The ID of the HubSpot user who owns the activity<br /><br />**Field Name:** `activityOwnerId`<br />**Type:** dimension                |
| <div>Activity owner name</div>         | The name of the HubSpot user who owns the activity<br /><br />**Field Name:** `activityOwnerName`<br />**Type:** dimension            |
| <div>Activity create date</div>        | The date the activity was created<br /><br />**Field Name:** `activityCreateDate`<br />**Type:** dimension                            |
| <div>Activity last modified date</div> | The date the activity was last modified<br /><br />**Field Name:** `activityLastModifiedDate`<br />**Type:** dimension                |
| <div>Activity timestamp</div>          | The timestamp when the activity occurred<br /><br />**Field Name:** `activityTimestamp`<br />**Type:** dimension                      |
| <div>Call direction</div>              | The direction of the call (inbound or outbound)<br /><br />**Field Name:** `callDirection`<br />**Type:** dimension                   |
| <div>Call duration (seconds)</div>     | The duration of the call in seconds<br /><br />**Field Name:** `callDuration`<br />**Type:** dimension                                |
| <div>Call status</div>                 | The status of the call (e.g., completed, no answer, busy)<br /><br />**Field Name:** `callStatus`<br />**Type:** dimension            |
| <div>Call disposition</div>            | The outcome or disposition of the call<br /><br />**Field Name:** `callDisposition`<br />**Type:** dimension                          |
| <div>Meeting title</div>               | The title of the meeting<br /><br />**Field Name:** `meetingTitle`<br />**Type:** dimension                                           |
| <div>Meeting outcome</div>             | The outcome of the meeting (e.g., scheduled, completed, no show)<br /><br />**Field Name:** `meetingOutcome`<br />**Type:** dimension |
| <div>Meeting start time</div>          | The start time of the meeting<br /><br />**Field Name:** `meetingStartTime`<br />**Type:** dimension                                  |
| <div>Meeting end time</div>            | The end time of the meeting<br /><br />**Field Name:** `meetingEndTime`<br />**Type:** dimension                                      |
| <div>Meeting location</div>            | The location of the meeting<br /><br />**Field Name:** `meetingLocation`<br />**Type:** dimension                                     |
| <div>Task subject</div>                | The subject of the task<br /><br />**Field Name:** `taskSubject`<br />**Type:** dimension                                             |
| <div>Task status</div>                 | The status of the task (e.g., not started, in progress, completed)<br /><br />**Field Name:** `taskStatus`<br />**Type:** dimension   |
| <div>Task priority</div>               | The priority level of the task<br /><br />**Field Name:** `taskPriority`<br />**Type:** dimension                                     |
| <div>Task type</div>                   | The type of task (e.g., todo, call, email)<br /><br />**Field Name:** `taskType`<br />**Type:** dimension                             |

### Blog Post

|                                   |                                                                                                                                 |
| --------------------------------- | ------------------------------------------------------------------------------------------------------------------------------- |
| <div>Blog post ID</div>           | The unique identifier for the blog post<br /><br />**Field Name:** `blogPostId`<br />**Type:** dimension                        |
| <div>Blog post title</div>        | The title of the blog post<br /><br />**Field Name:** `blogPostTitle`<br />**Type:** dimension                                  |
| <div>Blog post slug</div>         | The URL slug for the blog post<br /><br />**Field Name:** `blogPostSlug`<br />**Type:** dimension                               |
| <div>Blog post author</div>       | The author of the blog post<br /><br />**Field Name:** `blogPostAuthor`<br />**Type:** dimension                                |
| <div>Blog post state</div>        | The publish state of the blog post (e.g., draft, published)<br /><br />**Field Name:** `blogPostState`<br />**Type:** dimension |
| <div>Blog post URL</div>          | The full URL of the blog post<br /><br />**Field Name:** `blogPostUrl`<br />**Type:** dimension                                 |
| <div>Blog post publish date</div> | The date the blog post was published<br /><br />**Field Name:** `blogPostPublishDate`<br />**Type:** dimension                  |
| <div>Blog post create date</div>  | The date the blog post was created<br /><br />**Field Name:** `blogPostCreateDate`<br />**Type:** dimension                     |
| <div>Blog post update date</div>  | The date the blog post was last updated<br /><br />**Field Name:** `blogPostUpdateDate`<br />**Type:** dimension                |

### Web Analytics

|                                 |                                                                                                                                              |
| ------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------- |
| <div>Traffic source</div>       | The source of the website traffic (e.g., organic search, direct, social)<br /><br />**Field Name:** `trafficSource`<br />**Type:** dimension |
| <div>Traffic country</div>      | The country of the website visitor<br /><br />**Field Name:** `trafficCountry`<br />**Type:** dimension                                      |
| <div>Traffic UTM campaign</div> | The UTM campaign parameter from the traffic source<br /><br />**Field Name:** `trafficUtmCampaign`<br />**Type:** dimension                  |
| <div>Traffic UTM medium</div>   | The UTM medium parameter from the traffic source<br /><br />**Field Name:** `trafficUtmMedium`<br />**Type:** dimension                      |
| <div>Traffic UTM source</div>   | The UTM source parameter from the traffic source<br /><br />**Field Name:** `trafficUtmSource`<br />**Type:** dimension                      |

## Metrics

Metrics are the numerical values you can measure and analyze from your HubSpot campaigns.

### Contact

|                                             |                                                                                                                                          |
| ------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------- |
| <div>Number of contacts</div>               | The total number of contacts returned<br /><br />**Field Name:** `contactCount`<br />**Type:** metric                                    |
| <div>Contact associated deals</div>         | The number of deals associated with the contact<br /><br />**Field Name:** `contactNumAssociatedDeals`<br />**Type:** metric             |
| <div>Contact notes</div>                    | The number of notes on the contact record<br /><br />**Field Name:** `contactNumNotes`<br />**Type:** metric                             |
| <div>Contact page views</div>               | The number of page views tracked for this contact<br /><br />**Field Name:** `contactNumPageViews`<br />**Type:** metric                 |
| <div>Contact visits</div>                   | The number of website visits tracked for this contact<br /><br />**Field Name:** `contactNumVisits`<br />**Type:** metric                |
| <div>Contact days to close</div>            | The number of days it took for the contact to become a customer<br /><br />**Field Name:** `contactDaysToClose`<br />**Type:** metric    |
| <div>Contact total revenue</div>            | The total revenue attributed to this contact<br /><br />**Field Name:** `contactTotalRevenue`<br />**Type:** metric                      |
| <div>Contact recent deal amount</div>       | The amount of the contact's most recent deal<br /><br />**Field Name:** `contactRecentDealAmount`<br />**Type:** metric                  |
| <div>Contact HubSpot score</div>            | The HubSpot lead scoring value for the contact<br /><br />**Field Name:** `contactHubSpotScore`<br />**Type:** metric                    |
| <div>Contact times contacted</div>          | The number of times the contact has been contacted<br /><br />**Field Name:** `contactTimesContacted`<br />**Type:** metric              |
| <div>Contact sales activities</div>         | The total number of sales activities on the contact record<br /><br />**Field Name:** `contactSalesActivities`<br />**Type:** metric     |
| <div>Contact event completions</div>        | The number of analytics event completions for the contact<br /><br />**Field Name:** `contactEventCompletions`<br />**Type:** metric     |
| <div>Contact sends since last engaged</div> | The number of email sends since the contact last engaged<br /><br />**Field Name:** `contactSendsSinceLastEngaged`<br />**Type:** metric |

### Company

|                                        |                                                                                                                                                     |
| -------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------- |
| <div>Number of companies</div>         | The total number of companies returned<br /><br />**Field Name:** `companyCount`<br />**Type:** metric                                              |
| <div>Company employees</div>           | The number of employees at the company<br /><br />**Field Name:** `companyNumberOfEmployees`<br />**Type:** metric                                  |
| <div>Company annual revenue</div>      | The annual revenue of the company<br /><br />**Field Name:** `companyAnnualRevenue`<br />**Type:** metric                                           |
| <div>Company associated contacts</div> | The number of contacts associated with this company<br /><br />**Field Name:** `companyNumAssociatedContacts`<br />**Type:** metric                 |
| <div>Company associated deals</div>    | The number of deals associated with this company<br /><br />**Field Name:** `companyNumAssociatedDeals`<br />**Type:** metric                       |
| <div>Company notes</div>               | The number of notes on the company record<br /><br />**Field Name:** `companyNumNotes`<br />**Type:** metric                                        |
| <div>Company total deal value</div>    | The total value of all deals associated with this company<br /><br />**Field Name:** `companyTotalDealValue`<br />**Type:** metric                  |
| <div>Company days to close</div>       | The average number of days to close deals for this company<br /><br />**Field Name:** `companyDaysToClose`<br />**Type:** metric                    |
| <div>Company total revenue</div>       | The total revenue from deals associated with this company<br /><br />**Field Name:** `companyTotalRevenue`<br />**Type:** metric                    |
| <div>Company recent deal amount</div>  | The amount of the company's most recent deal<br /><br />**Field Name:** `companyRecentDealAmount`<br />**Type:** metric                             |
| <div>Company Facebook fans</div>       | The number of Facebook fans or likes for the company page<br /><br />**Field Name:** `companyFacebookFans`<br />**Type:** metric                    |
| <div>Company Twitter followers</div>   | The number of Twitter followers for the company<br /><br />**Field Name:** `companyTwitterFollowers`<br />**Type:** metric                          |
| <div>Company page views</div>          | The number of page views tracked for contacts associated with this company<br /><br />**Field Name:** `companyPageViews`<br />**Type:** metric      |
| <div>Company sessions</div>            | The number of website sessions from contacts associated with this company<br /><br />**Field Name:** `companySessions`<br />**Type:** metric        |
| <div>Company form submissions</div>    | The number of form submissions from contacts associated with this company<br /><br />**Field Name:** `companyFormSubmissions`<br />**Type:** metric |

### Deal

|                                         |                                                                                                                                          |
| --------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------- |
| <div>Number of deals</div>              | The total number of deals returned<br /><br />**Field Name:** `dealCount`<br />**Type:** metric                                          |
| <div>Deal amount</div>                  | The monetary amount of the deal<br /><br />**Field Name:** `dealAmount`<br />**Type:** metric                                            |
| <div>Deal amount (home currency)</div>  | The deal amount converted to the account home currency<br /><br />**Field Name:** `dealAmountInHomeCurrency`<br />**Type:** metric       |
| <div>Deal forecast amount</div>         | The weighted forecast amount based on deal probability<br /><br />**Field Name:** `dealForecastAmount`<br />**Type:** metric             |
| <div>Deal days to close</div>           | The number of days from deal creation to close<br /><br />**Field Name:** `dealDaysToClose`<br />**Type:** metric                        |
| <div>Deal associated contacts</div>     | The number of contacts associated with this deal<br /><br />**Field Name:** `dealNumAssociatedContacts`<br />**Type:** metric            |
| <div>Deal notes</div>                   | The number of notes on the deal record<br /><br />**Field Name:** `dealNumNotes`<br />**Type:** metric                                   |
| <div>Deals closed won</div>             | The number of deals that have been closed as won<br /><br />**Field Name:** `dealClosedWonCount`<br />**Type:** metric                   |
| <div>Deal MRR</div>                     | Monthly recurring revenue associated with the deal<br /><br />**Field Name:** `dealMrr`<br />**Type:** metric                            |
| <div>Deal ARR</div>                     | Annual recurring revenue associated with the deal<br /><br />**Field Name:** `dealArr`<br />**Type:** metric                             |
| <div>Deal ACV</div>                     | Annual contract value of the deal<br /><br />**Field Name:** `dealAcv`<br />**Type:** metric                                             |
| <div>Deal TCV</div>                     | Total contract value of the deal<br /><br />**Field Name:** `dealTcv`<br />**Type:** metric                                              |
| <div>Deal amount closed won</div>       | The total monetary amount of deals that have been closed as won<br /><br />**Field Name:** `dealAmountClosedWon`<br />**Type:** metric   |
| <div>Deal amount closed lost</div>      | The total monetary amount of deals that have been closed as lost<br /><br />**Field Name:** `dealAmountClosedLost`<br />**Type:** metric |
| <div>Deals closed lost</div>            | The number of deals that have been closed as lost<br /><br />**Field Name:** `dealClosedLostCount`<br />**Type:** metric                 |
| <div>Deal hit rate</div>                | The percentage of deals closed won out of total closed deals<br /><br />**Field Name:** `dealHitRate`<br />**Type:** metric              |
| <div>Deal avg days to close (won)</div> | The average number of days to close deals that were won<br /><br />**Field Name:** `dealAvgDaysToCloseWon`<br />**Type:** metric         |
| <div>Deal recurring revenue</div>       | The recurring revenue amount associated with the deal<br /><br />**Field Name:** `dealRecurringRevenueAmount`<br />**Type:** metric      |

### Ticket

|                                                  |                                                                                                                                              |
| ------------------------------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------- |
| <div>Number of tickets</div>                     | The total number of tickets returned<br /><br />**Field Name:** `ticketCount`<br />**Type:** metric                                          |
| <div>Ticket time to close (hours)</div>          | The time in hours from ticket creation to close<br /><br />**Field Name:** `ticketTimeToClose`<br />**Type:** metric                         |
| <div>Ticket time to first response (hours)</div> | The time in hours from ticket creation to the first agent reply<br /><br />**Field Name:** `ticketTimeToFirstResponse`<br />**Type:** metric |
| <div>Ticket notes</div>                          | The number of notes on the ticket record<br /><br />**Field Name:** `ticketNumNotes`<br />**Type:** metric                                   |
| <div>Ticket times contacted</div>                | The number of times the ticket has been contacted<br /><br />**Field Name:** `ticketTimesContacted`<br />**Type:** metric                    |
| <div>Ticket number of replies</div>              | The total number of replies on the ticket record<br /><br />**Field Name:** `ticketNumberOfReplies`<br />**Type:** metric                    |

### Email Campaign

|                                |                                                                                                                                        |
| ------------------------------ | -------------------------------------------------------------------------------------------------------------------------------------- |
| <div>Emails sent</div>         | Total number of emails sent in the campaign<br /><br />**Field Name:** `emailSent`<br />**Type:** metric                               |
| <div>Emails processed</div>    | Total number of emails processed by the email service<br /><br />**Field Name:** `emailProcessed`<br />**Type:** metric                |
| <div>Emails delivered</div>    | Total number of emails successfully delivered<br /><br />**Field Name:** `emailDelivered`<br />**Type:** metric                        |
| <div>Emails opened</div>       | Total number of unique email opens<br /><br />**Field Name:** `emailOpened`<br />**Type:** metric                                      |
| <div>Emails clicked</div>      | Total number of unique email link clicks<br /><br />**Field Name:** `emailClicked`<br />**Type:** metric                               |
| <div>Emails bounced</div>      | Total number of emails that bounced<br /><br />**Field Name:** `emailBounced`<br />**Type:** metric                                    |
| <div>Emails hard bounced</div> | Number of emails that permanently failed delivery<br /><br />**Field Name:** `emailHardBounced`<br />**Type:** metric                  |
| <div>Emails soft bounced</div> | Number of emails that temporarily failed delivery<br /><br />**Field Name:** `emailSoftBounced`<br />**Type:** metric                  |
| <div>Emails dropped</div>      | Number of emails dropped before sending<br /><br />**Field Name:** `emailDropped`<br />**Type:** metric                                |
| <div>Emails deferred</div>     | Number of emails deferred by the receiving server<br /><br />**Field Name:** `emailDeferred`<br />**Type:** metric                     |
| <div>Unsubscribes</div>        | Number of recipients who unsubscribed from the campaign<br /><br />**Field Name:** `emailUnsubscribed`<br />**Type:** metric           |
| <div>Spam reports</div>        | Number of recipients who reported the email as spam<br /><br />**Field Name:** `emailSpamReport`<br />**Type:** metric                 |
| <div>Email replies</div>       | Number of replies received to the campaign<br /><br />**Field Name:** `emailReply`<br />**Type:** metric                               |
| <div>MTA dropped</div>         | Number of emails dropped by the mail transfer agent<br /><br />**Field Name:** `emailMtaDropped`<br />**Type:** metric                 |
| <div>Delivery rate</div>       | Percentage of sent emails that were successfully delivered<br /><br />**Field Name:** `emailDeliveredRate`<br />**Type:** metric       |
| <div>Open rate</div>           | Percentage of delivered emails that were opened<br /><br />**Field Name:** `emailOpenRate`<br />**Type:** metric                       |
| <div>Click rate</div>          | Percentage of delivered emails that received a click<br /><br />**Field Name:** `emailClickRate`<br />**Type:** metric                 |
| <div>Click-through rate</div>  | Percentage of opened emails that received a click<br /><br />**Field Name:** `emailClickThroughRate`<br />**Type:** metric             |
| <div>Bounce rate</div>         | Percentage of sent emails that bounced<br /><br />**Field Name:** `emailBounceRate`<br />**Type:** metric                              |
| <div>Hard bounce rate</div>    | Percentage of sent emails that hard bounced<br /><br />**Field Name:** `emailHardBounceRate`<br />**Type:** metric                     |
| <div>Soft bounce rate</div>    | Percentage of sent emails that soft bounced<br /><br />**Field Name:** `emailSoftBounceRate`<br />**Type:** metric                     |
| <div>Unsubscribe rate</div>    | Percentage of delivered emails that resulted in an unsubscribe<br /><br />**Field Name:** `emailUnsubscribeRate`<br />**Type:** metric |
| <div>Spam report rate</div>    | Percentage of delivered emails reported as spam<br /><br />**Field Name:** `emailSpamReportRate`<br />**Type:** metric                 |
| <div>Drop rate</div>           | Percentage of emails that were dropped before sending<br /><br />**Field Name:** `emailDroppedRate`<br />**Type:** metric              |
| <div>Number of campaigns</div> | The total number of email campaigns returned<br /><br />**Field Name:** `emailCampaignCount`<br />**Type:** metric                     |

### Form

|                                      |                                                                                                                                             |
| ------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------- |
| <div>Form submissions (total)</div>  | The total number of submissions for the form<br /><br />**Field Name:** `formSubmissionCount`<br />**Type:** metric                         |
| <div>Number of forms</div>           | The total number of forms returned<br /><br />**Field Name:** `formCount`<br />**Type:** metric                                             |
| <div>Form submissions (period)</div> | The number of form submissions during the selected time period<br /><br />**Field Name:** `formSubmissionCountPeriod`<br />**Type:** metric |

### Product

|                               |                                                                                                       |
| ----------------------------- | ----------------------------------------------------------------------------------------------------- |
| <div>Number of products</div> | The total number of products returned<br /><br />**Field Name:** `productCount`<br />**Type:** metric |

### Line Item

|                                    |                                                                                                                         |
| ---------------------------------- | ----------------------------------------------------------------------------------------------------------------------- |
| <div>Number of line items</div>    | The total number of line items returned<br /><br />**Field Name:** `lineItemCount`<br />**Type:** metric                |
| <div>Line item quantity</div>      | The quantity of the line item<br /><br />**Field Name:** `lineItemQuantity`<br />**Type:** metric                       |
| <div>Line item unit price</div>    | The unit price of the line item<br /><br />**Field Name:** `lineItemPrice`<br />**Type:** metric                        |
| <div>Line item amount</div>        | The total amount for the line item (price x quantity)<br /><br />**Field Name:** `lineItemAmount`<br />**Type:** metric |
| <div>Line item cost of goods</div> | The cost of goods sold for the line item<br /><br />**Field Name:** `lineItemCostOfGoods`<br />**Type:** metric         |

### Activity

|                                          |                                                                                                                 |
| ---------------------------------------- | --------------------------------------------------------------------------------------------------------------- |
| <div>Number of activities</div>          | The total number of activities returned<br /><br />**Field Name:** `activityCount`<br />**Type:** metric        |
| <div>Number of calls</div>               | The number of call activities<br /><br />**Field Name:** `callCount`<br />**Type:** metric                      |
| <div>Number of meetings</div>            | The number of meeting activities<br /><br />**Field Name:** `meetingCount`<br />**Type:** metric                |
| <div>Number of tasks</div>               | The number of task activities<br /><br />**Field Name:** `taskCount`<br />**Type:** metric                      |
| <div>Number of notes</div>               | The number of note activities<br /><br />**Field Name:** `noteCount`<br />**Type:** metric                      |
| <div>Total call duration (seconds)</div> | The total duration of all calls in seconds<br /><br />**Field Name:** `callTotalDuration`<br />**Type:** metric |

### Blog Post

|                                 |                                                                                                          |
| ------------------------------- | -------------------------------------------------------------------------------------------------------- |
| <div>Number of blog posts</div> | The total number of blog posts returned<br /><br />**Field Name:** `blogPostCount`<br />**Type:** metric |

### Web Analytics

|                                       |                                                                                                                                                 |
| ------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------- |
| <div>Sessions</div>                   | The total number of website sessions<br /><br />**Field Name:** `trafficSessions`<br />**Type:** metric                                         |
| <div>Page views</div>                 | The total number of page views<br /><br />**Field Name:** `trafficPageViews`<br />**Type:** metric                                              |
| <div>Visitors</div>                   | The number of unique visitors<br /><br />**Field Name:** `trafficVisitors`<br />**Type:** metric                                                |
| <div>Bounce rate</div>                | The percentage of sessions where visitors left after viewing only one page<br /><br />**Field Name:** `trafficBounceRate`<br />**Type:** metric |
| <div>New visitor rate</div>           | The percentage of sessions from new visitors<br /><br />**Field Name:** `trafficNewVisitorSessionRate`<br />**Type:** metric                    |
| <div>Avg page views per session</div> | The average number of pages viewed per session<br /><br />**Field Name:** `trafficAvgPageViews`<br />**Type:** metric                           |
| <div>Avg session length</div>         | The average length of a session in seconds<br /><br />**Field Name:** `trafficAvgSessionLength`<br />**Type:** metric                           |
| <div>Entrances</div>                  | The number of times a page was the first page viewed in a session<br /><br />**Field Name:** `trafficEntrances`<br />**Type:** metric           |
| <div>Exits</div>                      | The number of times a page was the last page viewed in a session<br /><br />**Field Name:** `trafficExits`<br />**Type:** metric                |
| <div>Submissions</div>                | The number of form submissions from website visitors<br /><br />**Field Name:** `trafficSubmissions`<br />**Type:** metric                      |
| <div>Contacts created</div>           | The number of new contacts created from website traffic<br /><br />**Field Name:** `trafficContacts`<br />**Type:** metric                      |
| <div>Session-to-contact rate</div>    | The percentage of sessions that resulted in a new contact<br /><br />**Field Name:** `trafficSessionToContactRate`<br />**Type:** metric        |

***

## Related

<CardGroup>
  <Card title="Fields Catalog" icon="book" href="/fields-catalog">
    Browse all platforms
  </Card>

  <Card title="Klaviyo Fields" icon="chart-bar" href="/data-source/klaviyo/fields">
    Klaviyo metrics & dimensions
  </Card>

  <Card title="Mailchimp Fields" icon="chart-bar" href="/data-source/mailchimp/fields">
    Mailchimp metrics & dimensions
  </Card>

  <Card title="Google Merchant Center Fields" icon="chart-bar" href="/data-source/google-merchant-center/fields">
    Google Merchant Center metrics & dimensions
  </Card>
</CardGroup>


# Detrics HubSpot Integration: Setup Guide
Source: https://support.detrics.io/data-source/hubspot/setup-guide

How to install, configure, and start using the Detrics HubSpot integration to send your CRM data to Google Sheets, Looker Studio, Claude, and BigQuery.

The **Detrics HubSpot Integration** connects your HubSpot CRM to Google Sheets, Looker Studio, Claude, and BigQuery. Once connected, your contacts, companies, deals, tickets, and marketing data become queryable from the tools your team already uses, on a schedule you define.

This guide walks you through installation, the permissions Detrics requests, the user journey after connecting, and how to disconnect when you no longer need the integration.

## What you can do with the Detrics HubSpot Integration

* **Pull CRM data into spreadsheets.** Build pipeline reports, lifecycle analyses, and revenue dashboards in Google Sheets without copy-pasting.
* **Power Looker Studio dashboards.** Auto-refreshing visualizations of contacts, deals, companies, and email campaigns.
* **Ask questions in Claude.** Query your HubSpot data with natural language via the Detrics MCP connector.
* **Sync to BigQuery.** Schedule full and incremental syncs of HubSpot objects into your data warehouse for SQL access and downstream pipelines.

A complete list of available HubSpot dimensions and metrics is in the [HubSpot Metrics & Dimensions reference](/data-source/hubspot/fields).

## Prerequisites

Before you install the integration, make sure you have:

* A **HubSpot account** on any plan (Free, Starter, Professional, or Enterprise). Core CRM data (contacts, companies, deals, and owners) is available on all plans. Some advanced data (e.g., marketing analytics, workflows) requires a Professional or Enterprise plan and is fetched only when your portal supports it.
* A HubSpot user with **Super Admin** permission, or **App Marketplace Access** explicitly granted. HubSpot requires this permission to install any third-party app.
* A **Google account**, which you will use to sign up for Detrics.

## Installation

The Detrics HubSpot Integration is installed and configured from inside the Detrics web app at [app.detrics.io](https://app.detrics.io). Follow the steps below.

<Steps>
  <Step title="Sign up for Detrics">
    Go to [app.detrics.io](https://app.detrics.io) and sign up with your Google account. Detrics is free to start, with no credit card required. If you already have a Detrics account, just sign in.

    <Frame>
      <img alt="Sign in to Detrics with Google" />
    </Frame>
  </Step>

  <Step title="Open Data Sources">
    Once you are signed in, click **Data Sources** in the left sidebar. This page lists every platform you can connect to Detrics.
  </Step>

  <Step title="Select HubSpot">
    Find **HubSpot** in the list of available data sources and click on it. This opens the HubSpot connection page inside Detrics.
  </Step>

  <Step title="Click Connect">
    Click the **Connect** button. Detrics redirects you to HubSpot's official OAuth authorization page.

    <Tip>
      Make sure you are signed into HubSpot with a user that has Super Admin permission (or App Marketplace Access). If you are signed in with multiple HubSpot accounts in your browser, HubSpot will ask you to choose which portal you want to connect.
    </Tip>

    <Frame>
      <img alt="HubSpot OAuth authorization screen for Detrics" />
    </Frame>
  </Step>

  <Step title="Authorize the requested permissions">
    Review the permissions Detrics is requesting and click **Connect app** on
    HubSpot's screen. See [Permissions Detrics
    requests](#permissions-detrics-requests) below for a full breakdown of every
    scope and why we need it. All access is **read-only**. Detrics cannot modify
    your HubSpot records, send emails, or take any action on your behalf.
  </Step>

  <Step title="You're connected">
    HubSpot redirects you back to Detrics. Your HubSpot portal now appears in your connected data sources, and you can immediately start querying it from any destination (Sheets, Looker Studio, Claude, or BigQuery).

    <Frame>
      <img alt="HubSpot connected on the Detrics Data Sources page" />
    </Frame>
  </Step>
</Steps>

## Permissions Detrics requests

Detrics asks for the minimum HubSpot scopes needed to retrieve the data exposed in the [HubSpot Metrics & Dimensions reference](/data-source/hubspot/fields). All scopes are **read-only**. Detrics never requests write, delete, or send permissions.

### Required scopes

These scopes are requested on every install. They cover the core CRM objects every Detrics HubSpot query depends on.

| HubSpot scope                | What Detrics uses it for                                                                                                         |
| ---------------------------- | -------------------------------------------------------------------------------------------------------------------------------- |
| `oauth`                      | Required by HubSpot for any OAuth-based integration. Identifies the authenticated portal.                                        |
| `crm.objects.contacts.read`  | Read your contacts so we can surface contact dimensions and counts (lifecycle stage, source, create date, total contacts, etc.). |
| `crm.schemas.contacts.read`  | Read your contact property definitions so custom contact fields are correctly typed in your reports.                             |
| `crm.objects.companies.read` | Read your companies so we can surface company dimensions and metrics (industry, domain, total revenue, associated deals, etc.).  |
| `crm.schemas.companies.read` | Read your company property definitions so custom company fields are correctly typed.                                             |
| `crm.objects.deals.read`     | Read your deals so we can surface pipeline reporting (stage, amount, close date, win rate, etc.).                                |
| `crm.schemas.deals.read`     | Read your deal property definitions so custom deal fields are correctly typed.                                                   |
| `crm.objects.owners.read`    | Read the HubSpot users who own contacts, companies, and deals so owner names appear in your reports instead of opaque IDs.       |

### Optional scopes

Detrics also requests the following optional scopes. HubSpot **silently drops** any optional scope your portal does not support (for example, if your plan does not include marketing tools), so requesting them does not block install on lower-tier HubSpot plans.

| HubSpot scope           | What Detrics uses it for                                                                                              |
| ----------------------- | --------------------------------------------------------------------------------------------------------------------- |
| `business-intelligence` | Read marketing campaign performance and engagement metrics (sends, opens, clicks, etc.) for email campaign reporting. |
| `content`               | Read marketing emails and blog posts so they appear as queryable dimensions alongside engagement metrics.             |
| `e-commerce`            | Read line items and products so you can analyze deal composition and product-level revenue.                           |
| `forms`                 | Read form definitions and submissions so form-driven funnel analysis is available.                                    |
| `tickets`               | Read support tickets so you can build ticket-volume, response-time, and customer-service dashboards.                  |

If your HubSpot plan does not include one of the optional data types above, the corresponding fields will simply not return data, and the rest of the integration is unaffected.

## Using your HubSpot data after connecting

Once your HubSpot portal is connected, you can query the same data from any Detrics destination:

<CardGroup>
  <Card title="Google Sheets" icon="table" href="/google-sheets/quickstart">
    Pull HubSpot data into a spreadsheet, build reports, and schedule automatic refreshes.
  </Card>

  <Card title="Looker Studio" icon="chart-line" href="/looker-studio/quickstart">
    Power Looker Studio dashboards with live HubSpot CRM and marketing data.
  </Card>

  <Card title="Claude" icon="robot" href="/claude/overview">
    Ask natural-language questions about your HubSpot data using the Detrics MCP
    connector.
  </Card>

  <Card title="BigQuery" icon="database" href="/bigquery/quickstart">
    Sync HubSpot objects to BigQuery on a schedule for SQL access and downstream pipelines.
  </Card>
</CardGroup>

For the full list of HubSpot dimensions and metrics you can query, see the [HubSpot Metrics & Dimensions reference](/data-source/hubspot/fields).

## Pricing

Detrics is free to start and offers paid plans for teams with higher query volumes and more destinations. The Detrics HubSpot Integration works on every Detrics plan and is included in your standard Detrics subscription, with no separate add-on cost.

See the [Detrics pricing page](https://detrics.io/pricing) for current plans and limits.

## Data handling and security

* **Read-only access.** Detrics requests read-only scopes from HubSpot and cannot modify, delete, or send anything from your HubSpot portal.
* **Encryption.** Access and refresh tokens are encrypted at rest in the Detrics database, and all traffic between Detrics and HubSpot uses HTTPS.
* **Token lifecycle.** HubSpot access tokens expire every 30 minutes. Detrics refreshes them automatically using the refresh token issued at install. Refresh tokens are revoked the moment you disconnect (see below).
* **Data retention.** Detrics caches recent query results to speed up repeated requests and to power scheduled refreshes. Cached data is associated with your Detrics workspace and is not shared with any third party.

For more detail, see the [Detrics data security page](https://detrics.io/data-security).

## Uninstalling and disconnecting

You can disconnect the Detrics HubSpot Integration at any time from either side:

### From inside Detrics

1. Sign in to [app.detrics.io](https://app.detrics.io).
2. Open **Data Sources** in the left sidebar.
3. Click your HubSpot connection and select **Disconnect**.

Detrics immediately revokes the refresh token with HubSpot and stops all future syncs for that portal.

### From inside HubSpot

1. In HubSpot, click the **Settings** gear in the top navigation.
2. Go to **Integrations → Connected Apps**.
3. Find **Detrics**, open its menu, and click **Uninstall**.

Uninstalling from HubSpot also revokes the tokens Detrics holds, so any scheduled syncs that depend on this portal will stop.

### Requesting deletion of cached data

Disconnecting revokes the tokens and stops new syncs, but cached query results may remain in Detrics until they expire. To request immediate deletion of all cached HubSpot data associated with your workspace, email [support@detrics.io](mailto:support@detrics.io) with the subject line "HubSpot data deletion request" and the Detrics workspace name.

## Support

If you run into any issue installing or using the Detrics HubSpot Integration:

* Email us at [support@detrics.io](mailto:support@detrics.io).
* Visit [support.detrics.io](https://support.detrics.io) for help articles and to open a ticket.
* For general connection problems, see [Troubleshooting Connections](/connect/troubleshooting-connections).


# Instagram Insights Metrics & Dimensions
Source: https://support.detrics.io/data-source/instagram-insights/fields

Complete reference for Instagram Insights dimensions and metrics

<Info>
  **Last updated:** August 6, 2026
</Info>

<div>
  <div>
    28 dimensions
  </div>

  <div>
    32 metrics
  </div>
</div>

This reference covers all available dimensions and metrics for Instagram Insights data through Detrics. Use this guide to understand what data you can extract and how to structure your queries.

<div>
  <span>Supported destinations:</span>

  <div>
    Google Sheets
  </div>

  <div>
    Looker Studio
  </div>

  <div>
    Claude
  </div>

  <div>
    BigQuery
  </div>
</div>

## Dimensions

Dimensions are the attributes you can use to segment and group your Instagram Insights data.

### Account

|                       |                                                                                                                                                |
| --------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------- |
| <div>Account ID</div> | Hover over complex dimensions and metrics to uncover detailed explanations 😉<br /><br />**Field Name:** `account_id`<br />**Type:** dimension |
| <div>Username</div>   | The username of the Instagram account.<br /><br />**Field Name:** `username`<br />**Type:** dimension                                          |
| <div>Website</div>    | The website link of the account.<br /><br />**Field Name:** `website`<br />**Type:** dimension                                                 |
| <div>Biography</div>  | The account's biography.<br /><br />**Field Name:** `biography`<br />**Type:** dimension                                                       |

### Account Metrics Breakdowns

|                        |                                                                                                                                                                                                                  |
| ---------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| <div>Media Type</div>  | Break down results by the surface where viewers viewed or interacted with your account's media. Can be: AD, FEED, REELS, STORY.<br /><br />**Field Name:** `account_media_product_type`<br />**Type:** dimension |
| <div>Follow Type</div> | Break down results by followers or non-followers. Only compatible with metrics: Follows and Unfollows, Reach.<br /><br />**Field Name:** `account_follow_type`<br />**Type:** dimension                          |

### Account Demographics

|                    |                                                                                                                                                                 |
| ------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| <div>Country</div> | Can't be selected with other demographic dimensions. Combine with 'Account Demographics' metrics.<br /><br />**Field Name:** `country`<br />**Type:** dimension |
| <div>City</div>    | Can't be selected with other demographic dimensions. Combine with 'Account Demographics' metrics.<br /><br />**Field Name:** `city`<br />**Type:** dimension    |
| <div>Age</div>     | Can be combined with Gender. Combine with 'Account Demographics' metrics.<br /><br />**Field Name:** `age`<br />**Type:** dimension                             |
| <div>Gender</div>  | Can be combined with Age. Combine with 'Account Demographics' metrics.<br /><br />**Field Name:** `gender`<br />**Type:** dimension                             |

### Media

|                               |                                                                                                                                                                                                      |
| ----------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| <div>Media ID</div>           | The unique identifier for this media item. You can use this ID to link organic and paid metrics from the Facebook Ads Integration.<br /><br />**Field Name:** `media_id`<br />**Type:** dimension    |
| <div>Shortcode</div>          | Another unique identifier for the media item. You can find it the final part of the item's permalink.<br /><br />**Field Name:** `shortcode`<br />**Type:** dimension                                |
| <div>Media Product Type</div> | Wether the media item is a REELS item or FEED item. Feed items include: single image posts, carousel posts and video posts.<br /><br />**Field Name:** `media_product_type`<br />**Type:** dimension |
| <div>Media Type</div>         | Wether the media contains a video, an image or multiple images.<br /><br />**Field Name:** `media_type`<br />**Type:** dimension                                                                     |
| <div>Permalink</div>          | The permanent link for the published media. It contains the shortcode which acts as another unique identifier.<br /><br />**Field Name:** `permalink`<br />**Type:** dimension                       |
| <div>Caption</div>            | The media item's caption.<br /><br />**Field Name:** `caption`<br />**Type:** dimension                                                                                                              |
| <div>Media Image</div>        | The image content of the media item.<br /><br />**Field Name:** `media_image`<br />**Type:** dimension                                                                                               |
| <div>Thumbnail Image</div>    | The thumbnail image of the media item.<br /><br />**Field Name:** `thumbnail_image`<br />**Type:** dimension                                                                                         |
| <div>Media URL</div>          | An URL to the media file of the publication.<br /><br />**Field Name:** `media_url`<br />**Type:** dimension                                                                                         |
| <div>Thumbnail URL</div>      | The URL of the published image or a snapshot of the video.<br /><br />**Field Name:** `thumbnail_url`<br />**Type:** dimension                                                                       |
| <div>Date Published</div>     | The date where the media item was published.<br /><br />**Field Name:** `timestamp`<br />**Type:** dimension                                                                                         |
| <div>Post Username</div>      | The username of the account that published the post. Useful when querying multiple accounts at once.<br /><br />**Field Name:** `media_owner_username`<br />**Type:** dimension                      |
| <div>Shared to Feed</div>     | Whether a Reel is also shown on the main profile feed. Only applies to Reels.<br /><br />**Field Name:** `is_shared_to_feed`<br />**Type:** dimension                                                |
| <div>Comments Enabled</div>   | Whether commenting is enabled on the post.<br /><br />**Field Name:** `is_comment_enabled`<br />**Type:** dimension                                                                                  |

### Comments

|                           |                                                                                                                                                                                                                                                                      |
| ------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| <div>Comment</div>        | The text of each comment on your posts. Returns one row per comment, alongside any Media dimensions you select (Permalink, Caption, etc.). Cannot be combined with metrics or Account dimensions.<br /><br />**Field Name:** `comment_text`<br />**Type:** dimension |
| <div>Comment Date</div>   | The date and time the comment was posted.<br /><br />**Field Name:** `comment_timestamp`<br />**Type:** dimension                                                                                                                                                    |
| <div>Comment ID</div>     | The unique identifier of the comment.<br /><br />**Field Name:** `comment_id`<br />**Type:** dimension                                                                                                                                                               |
| <div>Comment Hidden</div> | Whether the comment is hidden/moderated (true or false).<br /><br />**Field Name:** `comment_hidden`<br />**Type:** dimension                                                                                                                                        |

## Metrics

Metrics are the numerical values you can measure and analyze from your Instagram Insights campaigns.

### Comments

|                          |                                                                                                                                                                                                  |
| ------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| <div>Comment Likes</div> | The number of likes on each comment. Returns one row per comment alongside the comment dimensions (Comment, Comment Date).<br /><br />**Field Name:** `comment_like_count`<br />**Type:** metric |

### Account Lifetime

|                        |                                                                                                                                                                                                                 |
| ---------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| <div>Followers</div>   | Total number of followers at the time the query is being executed. There's no way of going to the past and checking the amount of followers.<br /><br />**Field Name:** `followers_count`<br />**Type:** metric |
| <div>Media Count</div> | Total number of media items published at the time the query is being executed.<br /><br />**Field Name:** `media_count`<br />**Type:** metric                                                                   |
| <div>Follows</div>     | Total number of followed accounts at the time the query is being executed.<br /><br />**Field Name:** `follows_count`<br />**Type:** metric                                                                     |

### Account Metrics (All Time)

|                                       |                                                                                                                                                                                              |
| ------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| <div>Account Likes</div>              | The number of likes on your posts, reels, and videos. Compatible with Media Type breakdown.<br /><br />**Field Name:** `account_likes`<br />**Type:** metric                                 |
| <div>Account Shares</div>             | Compatible with Media Type breakdown.<br /><br />**Field Name:** `account_shares`<br />**Type:** metric                                                                                      |
| <div>Account Saves</div>              | Compatible with Media Type breakdown.<br /><br />**Field Name:** `account_saves`<br />**Type:** metric                                                                                       |
| <div>Account Comments</div>           | Compatible with Media Type breakdown.<br /><br />**Field Name:** `account_comments`<br />**Type:** metric                                                                                    |
| <div>Account Total Interactions</div> | The total number of interactions of posts, stories, reels, videos and live videos, including organic and paid.<br /><br />**Field Name:** `account_total_interactions`<br />**Type:** metric |
| <div>Account Profile Views</div>      | Total number of users who have viewed the your profile<br /><br />**Field Name:** `profile_views`<br />**Type:** metric                                                                      |
| <div>Account Website Clicks</div>     | The number of times that the link to your website was tapped.<br /><br />**Field Name:** `website_clicks`<br />**Type:** metric                                                              |
| <div>Account Views</div>              | The number of times your content was played or displayed. Content includes reels, posts, stories.<br /><br />**Field Name:** `account_views`<br />**Type:** metric                           |

### Account Metrics (Daily)

|                                             |                                                                                                                                                                                                                                                            |
| ------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| <div>Account Reach</div>                    | The number of unique accounts that have seen your content, at least once, including in ads. These metrics support both 'All Time' and 'Daily'<br /><br />**Field Name:** `account_reach`<br />**Type:** metric                                             |
| <div>Account Impressions (Deprecated)</div> | The number of times your posts, stories, reels, videos and live videos were on screen, including in ads. (Replaced by 'Account Views' which is not compatible with daily breakdown)<br /><br />**Field Name:** `account_impressions`<br />**Type:** metric |

### Account Demographics

|                                                |                                                                                                                                                                                                                        |
| ---------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| <div>Follower Demographics Count</div>         | Only valid with 'Account Demographics' dimensions. Counts the number of followers for each demographic dimension.<br /><br />**Field Name:** `follower_demographics`<br />**Type:** metric                             |
| <div>Reached Audience Demographics Count</div> | Only valid with 'Account Demographics' dimensions. Counts the number of reached followers for each demographic dimension.<br /><br />**Field Name:** `reached_audience_demographics`<br />**Type:** metric             |
| <div>Engaged Audience Demographics Count</div> | Only valid with 'Account Demographics' dimensions. Counts the number of reached and engaged followers for each demographic dimension.<br /><br />**Field Name:** `engaged_audience_demographics`<br />**Type:** metric |

### Account Follow Type

|                                          |                                                                                                                                |
| ---------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------ |
| <div>Account Follows And Unfollows</div> | Only compatible with 'Follow Type' dimension.<br /><br />**Field Name:** `account_follows_and_unfollows`<br />**Type:** metric |

### Media

|                                       |                                                                                                                                                                                                                                                                                                                       |
| ------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| <div>Likes</div>                      | Total amount of organic likes for the media. By media we mean: Reels, Image post, Video post or Carousel Post. This is a lifetime metric, i.e. it is not affected by the selected timeframe.<br /><br />**Field Name:** `likes`<br />**Type:** metric                                                                 |
| <div>Comments</div>                   | Total amount of organic comments for the media. This is a lifetime metric, i.e. it is not affected by the selected timeframe.<br /><br />**Field Name:** `comments`<br />**Type:** metric                                                                                                                             |
| <div>Saved</div>                      | Total number of unique accounts that have saved the media object organically. This is a lifetime metric, i.e. it is not affected by the selected timeframe.<br /><br />**Field Name:** `saved`<br />**Type:** metric                                                                                                  |
| <div>Impressions (Deprecated)</div>   | Total number of times the media item has been seen organically. This is a lifetime metric, i.e. it is not affected by the selected timeframe. (Replaced by the "Views" metric)<br /><br />**Field Name:** `impressions`<br />**Type:** metric                                                                         |
| <div>Reach</div>                      | Unique users that saw your publications organically. This is a lifetime metric, i.e. it is not affected by the selected timeframe.<br /><br />**Field Name:** `reach`<br />**Type:** metric                                                                                                                           |
| <div>Total Interactions</div>         | Total engagement on the post: likes + comments + saves + shares. Available for all post types including Reels. This is a lifetime metric, i.e. it is not affected by the selected timeframe.<br /><br />**Field Name:** `total_interactions`<br />**Type:** metric                                                    |
| <div>Follows From Post</div>          | New accounts that followed you from this post. Only available for feed posts (image, video, carousel) — returns 0 for Reels. This is a lifetime metric, i.e. it is not affected by the selected timeframe.<br /><br />**Field Name:** `follows`<br />**Type:** metric                                                 |
| <div>Profile Visits From Post</div>   | Profile visits driven by this post. Only available for feed posts (image, video, carousel) — returns 0 for Reels. This is a lifetime metric, i.e. it is not affected by the selected timeframe.<br /><br />**Field Name:** `profile_visits`<br />**Type:** metric                                                     |
| <div>Profile Activity From Post</div> | Actions taken on your profile (e.g. taps on contact/CTA buttons) driven by this post. Only available for feed posts (image, video, carousel) — returns 0 for Reels. This is a lifetime metric, i.e. it is not affected by the selected timeframe.<br /><br />**Field Name:** `profile_activity`<br />**Type:** metric |
| <div>Views</div>                      | The number of times your content was played or displayed. Content includes reels, posts, stories. This is a lifetime metric, i.e. it is not affected by the selected timeframe.<br /><br />**Field Name:** `views`<br />**Type:** metric                                                                              |

### Reels

|                                     |                                                                                                                                                                                                                                                                                                                                                                        |
| ----------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| <div>Reel Plays (Deprecated)</div>  | The number of times that your video starts to play after an impression has already been counted. This is defined as organic video sessions with 1 ms or more of playback and excludes replays. This is a lifetime metric, i.e. it is not affected by the selected timeframe. (Replaced by the "Views" metric)<br /><br />**Field Name:** `plays`<br />**Type:** metric |
| <div>Reels Average Watch Time</div> | The average amount of time spent playing the reel. This is calculated by the watch time divided by the number of plays. (in seconds) This is a lifetime metric, i.e. it is not affected by the selected timeframe.<br /><br />**Field Name:** `ig_reels_avg_watch_time`<br />**Type:** metric                                                                          |
| <div>Reels Total View Time</div>    | The total amount of time the reel was played, including any time spent replaying the reel. (in seconds) This is a lifetime metric, i.e. it is not affected by the selected timeframe.<br /><br />**Field Name:** `ig_reels_video_view_total_time`<br />**Type:** metric                                                                                                |

### Reels & Images

|                   |                                                                                                                                                                                                                                                         |
| ----------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| <div>Shares</div> | The number of organic shares of your reel or image post. This metric is not available for videos and carousels. This is a lifetime metric, i.e. it is not affected by the selected timeframe.<br /><br />**Field Name:** `shares`<br />**Type:** metric |

***

## Related

<CardGroup>
  <Card title="Fields Catalog" icon="book" href="/fields-catalog">
    Browse all platforms
  </Card>

  <Card title="Facebook Insights Fields" icon="chart-bar" href="/data-source/facebook-insights/fields">
    Facebook Insights metrics & dimensions
  </Card>

  <Card title="Facebook Public Data Fields" icon="chart-bar" href="/data-source/facebook-public-data/fields">
    Facebook Public Data metrics & dimensions
  </Card>

  <Card title="TikTok Organic Fields" icon="chart-bar" href="/data-source/tiktok-organic/fields">
    TikTok Organic metrics & dimensions
  </Card>
</CardGroup>


# Instantly Metrics & Dimensions
Source: https://support.detrics.io/data-source/instantly/fields

Complete reference for Instantly cold email dimensions and metrics

<Info>
  **Last updated:** August 6, 2026
</Info>

<div>
  <div>
    50 dimensions
  </div>

  <div>
    28 metrics
  </div>
</div>

This reference covers all available dimensions and metrics for Instantly data through Detrics. Use this guide to understand what data you can extract and how to structure your queries.

<div>
  <span>Supported destinations:</span>

  <div>
    Google Sheets
  </div>

  <div>
    Claude
  </div>

  <div>
    BigQuery
  </div>
</div>

## Dimensions

Dimensions are the attributes you can use to segment and group your Instantly data.

### Account

|                         |                                                                                             |
| ----------------------- | ------------------------------------------------------------------------------------------- |
| <div>Account ID</div>   | Instantly workspace ID<br /><br />**Field Name:** `account_id`<br />**Type:** dimension     |
| <div>Account Name</div> | Instantly workspace name<br /><br />**Field Name:** `account_name`<br />**Type:** dimension |

### Campaign Analytics

|                                  |                                                                                                                                                                                                               |
| -------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| <div>Campaign ID</div>           | Unique identifier for the Instantly campaign<br /><br />**Field Name:** `campaign_id`<br />**Type:** dimension                                                                                                |
| <div>Campaign Name</div>         | Name of the cold email campaign<br /><br />**Field Name:** `campaign_name`<br />**Type:** dimension                                                                                                           |
| <div>Campaign Status</div>       | Current campaign status (Draft, Active, Paused, Completed, Running Subsequences, Account Suspended, Accounts Unhealthy, Bounce Protect)<br /><br />**Field Name:** `campaign_status`<br />**Type:** dimension |
| <div>Campaign Is Evergreen</div> | Whether the campaign runs continuously as new leads are added<br /><br />**Field Name:** `campaign_is_evergreen`<br />**Type:** dimension                                                                     |
| <div>Campaign Created Date</div> | Date and time when the campaign was created<br /><br />**Field Name:** `campaign_created_datetime`<br />**Type:** dimension                                                                                   |
| <div>Step Number</div>           | Sequence step number. Selecting step dimensions switches the report to step-level analytics (time aggregation "All" only)<br /><br />**Field Name:** `step_number`<br />**Type:** dimension                   |
| <div>Step Variant</div>          | A/B test variant of the sequence step (time aggregation "All" only)<br /><br />**Field Name:** `step_variant`<br />**Type:** dimension                                                                        |

### Leads

|                                 |                                                                                                                                                                                                                                 |
| ------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| <div>Lead ID</div>              | Unique identifier for the lead<br /><br />**Field Name:** `lead_id`<br />**Type:** dimension                                                                                                                                    |
| <div>Lead Email</div>           | Email address of the lead<br /><br />**Field Name:** `lead_email`<br />**Type:** dimension                                                                                                                                      |
| <div>Lead First Name</div>      | First name of the lead<br /><br />**Field Name:** `lead_first_name`<br />**Type:** dimension                                                                                                                                    |
| <div>Lead Last Name</div>       | Last name of the lead<br /><br />**Field Name:** `lead_last_name`<br />**Type:** dimension                                                                                                                                      |
| <div>Lead Company Name</div>    | Company the lead works for<br /><br />**Field Name:** `lead_company_name`<br />**Type:** dimension                                                                                                                              |
| <div>Lead Company Domain</div>  | Company website domain of the lead<br /><br />**Field Name:** `lead_company_domain`<br />**Type:** dimension                                                                                                                    |
| <div>Lead Website</div>         | Website of the lead<br /><br />**Field Name:** `lead_website`<br />**Type:** dimension                                                                                                                                          |
| <div>Lead Job Title</div>       | Job title of the lead<br /><br />**Field Name:** `lead_job_title`<br />**Type:** dimension                                                                                                                                      |
| <div>Lead Phone</div>           | Phone number of the lead<br /><br />**Field Name:** `lead_phone`<br />**Type:** dimension                                                                                                                                       |
| <div>Lead Status</div>          | Campaign status of the lead (Active, Paused, Completed, Bounced, Unsubscribed, Skipped)<br /><br />**Field Name:** `lead_status`<br />**Type:** dimension                                                                       |
| <div>Lead Interest Status</div> | Interest classification of the lead (Interested, Meeting Booked, Meeting Completed, Won, Not Interested, Wrong Person, Lost, No Show, Out of Office)<br /><br />**Field Name:** `lead_interest_status`<br />**Type:** dimension |
| <div>Lead LinkedIn</div>        | LinkedIn profile URL of the lead<br /><br />**Field Name:** `lead_linkedin`<br />**Type:** dimension                                                                                                                            |
| <div>Lead Location</div>        | Location of the lead<br /><br />**Field Name:** `lead_location`<br />**Type:** dimension                                                                                                                                        |
| <div>Lead List ID</div>         | ID of the lead list the lead belongs to<br /><br />**Field Name:** `lead_list_id`<br />**Type:** dimension                                                                                                                      |
| <div>Lead List Name</div>       | Name of the lead list the lead belongs to<br /><br />**Field Name:** `lead_list_name`<br />**Type:** dimension                                                                                                                  |
| <div>Lead Campaign ID</div>     | ID of the campaign the lead is enrolled in<br /><br />**Field Name:** `lead_campaign_id`<br />**Type:** dimension                                                                                                               |
| <div>Lead Upload Method</div>   | How the lead was added (manual, API, CSV import, etc.)<br /><br />**Field Name:** `lead_upload_method`<br />**Type:** dimension                                                                                                 |
| <div>Lead Email Provider</div>  | Email service provider detected for the lead's address (Google, Microsoft, Zoho, Yahoo, etc.)<br /><br />**Field Name:** `lead_esp_code`<br />**Type:** dimension                                                               |
| <div>Lead Created Date</div>    | Date and time when the lead was created<br /><br />**Field Name:** `lead_created_datetime`<br />**Type:** dimension                                                                                                             |
| <div>Lead Updated Date</div>    | Date and time when the lead was last updated<br /><br />**Field Name:** `lead_updated_datetime`<br />**Type:** dimension                                                                                                        |

### Emails

|                                 |                                                                                                                                              |
| ------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------- |
| <div>Email ID</div>             | Unique identifier for the email activity record<br /><br />**Field Name:** `email_id`<br />**Type:** dimension                               |
| <div>Email Date</div>           | Date and time when the email was sent or received<br /><br />**Field Name:** `email_datetime`<br />**Type:** dimension                       |
| <div>Email Direction</div>      | Direction of the email (Sent from campaign, Received, Sent, Scheduled)<br /><br />**Field Name:** `email_direction`<br />**Type:** dimension |
| <div>Email Subject</div>        | Subject line of the email<br /><br />**Field Name:** `email_subject`<br />**Type:** dimension                                                |
| <div>Email Body</div>           | Plain-text body of the email<br /><br />**Field Name:** `email_body_text`<br />**Type:** dimension                                           |
| <div>Email From</div>           | Sender address of the email<br /><br />**Field Name:** `email_from`<br />**Type:** dimension                                                 |
| <div>Email To</div>             | Recipient address of the email<br /><br />**Field Name:** `email_to`<br />**Type:** dimension                                                |
| <div>Email Sender Account</div> | Sender inbox (Instantly account) that sent the email<br /><br />**Field Name:** `email_sender_account`<br />**Type:** dimension              |
| <div>Email Campaign ID</div>    | ID of the campaign the email belongs to<br /><br />**Field Name:** `email_campaign_id`<br />**Type:** dimension                              |
| <div>Email Campaign Name</div>  | Name of the campaign the email belongs to<br /><br />**Field Name:** `email_campaign_name`<br />**Type:** dimension                          |
| <div>Email Lead</div>           | Lead email address the message was exchanged with<br /><br />**Field Name:** `email_lead_email`<br />**Type:** dimension                     |
| <div>Email Step</div>           | Sequence step that produced the email<br /><br />**Field Name:** `email_step`<br />**Type:** dimension                                       |
| <div>Email Thread ID</div>      | Conversation thread the email belongs to<br /><br />**Field Name:** `email_thread_id`<br />**Type:** dimension                               |

### Sender Accounts

|                                   |                                                                                                                                                                                  |
| --------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| <div>Sender Email</div>           | Email address of the sender inbox<br /><br />**Field Name:** `sender_email`<br />**Type:** dimension                                                                             |
| <div>Sender First Name</div>      | First name configured on the sender inbox<br /><br />**Field Name:** `sender_first_name`<br />**Type:** dimension                                                                |
| <div>Sender Last Name</div>       | Last name configured on the sender inbox<br /><br />**Field Name:** `sender_last_name`<br />**Type:** dimension                                                                  |
| <div>Sender Status</div>          | Status of the sender inbox (Active, Paused, Maintenance, Connection Error, Soft Bounce Error, Sending Error)<br /><br />**Field Name:** `sender_status`<br />**Type:** dimension |
| <div>Sender Warmup Status</div>   | Warmup status of the sender inbox (Active, Paused, Banned, Spam Folder Unknown, Permanent Suspension)<br /><br />**Field Name:** `sender_warmup_status`<br />**Type:** dimension |
| <div>Sender Provider</div>        | Email provider of the sender inbox (Google, Microsoft, AWS, Custom IMAP/SMTP, etc.)<br /><br />**Field Name:** `sender_provider`<br />**Type:** dimension                        |
| <div>Sender Tracking Domain</div> | Custom tracking domain configured for the sender inbox<br /><br />**Field Name:** `sender_tracking_domain`<br />**Type:** dimension                                              |
| <div>Sender Created Date</div>    | Date and time when the sender inbox was connected<br /><br />**Field Name:** `sender_created_datetime`<br />**Type:** dimension                                                  |

## Metrics

Metrics are the numerical values you can measure and analyze from your Instantly campaigns.

### Campaign Analytics

|                                |                                                                                                                                                   |
| ------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------- |
| <div>Emails Sent</div>         | Total emails sent by the campaign<br /><br />**Field Name:** `emails_sent`<br />**Type:** metric                                                  |
| <div>Contacted</div>           | Total leads contacted by the campaign<br /><br />**Field Name:** `contacted`<br />**Type:** metric                                                |
| <div>New Leads Contacted</div> | Leads contacted for the first time in the selected period<br /><br />**Field Name:** `new_leads_contacted`<br />**Type:** metric                  |
| <div>Replies</div>             | Total replies received<br /><br />**Field Name:** `replies`<br />**Type:** metric                                                                 |
| <div>Unique Replies</div>      | Unique leads that replied<br /><br />**Field Name:** `replies_unique`<br />**Type:** metric                                                       |
| <div>Automatic Replies</div>   | Automatic replies received (out-of-office, autoresponders)<br /><br />**Field Name:** `replies_automatic`<br />**Type:** metric                   |
| <div>Opens</div>               | Total email opens (requires open tracking enabled in Instantly)<br /><br />**Field Name:** `opens`<br />**Type:** metric                          |
| <div>Unique Opens</div>        | Unique leads that opened an email (requires open tracking enabled in Instantly)<br /><br />**Field Name:** `opens_unique`<br />**Type:** metric   |
| <div>Clicks</div>              | Total link clicks (requires click tracking enabled in Instantly)<br /><br />**Field Name:** `clicks`<br />**Type:** metric                        |
| <div>Unique Clicks</div>       | Unique leads that clicked a link (requires click tracking enabled in Instantly)<br /><br />**Field Name:** `clicks_unique`<br />**Type:** metric  |
| <div>Opportunities</div>       | Opportunities generated by the campaign<br /><br />**Field Name:** `opportunities`<br />**Type:** metric                                          |
| <div>Bounced</div>             | Emails that bounced (time aggregation "All" only)<br /><br />**Field Name:** `bounced`<br />**Type:** metric                                      |
| <div>Unsubscribed</div>        | Leads that unsubscribed (time aggregation "All" only)<br /><br />**Field Name:** `unsubscribed`<br />**Type:** metric                             |
| <div>Completed Leads</div>     | Leads that finished the sequence (time aggregation "All" only)<br /><br />**Field Name:** `completed_leads`<br />**Type:** metric                 |
| <div>Total Leads</div>         | Total leads in the campaign (time aggregation "All" only)<br /><br />**Field Name:** `leads_total`<br />**Type:** metric                          |
| <div>Opportunity Value</div>   | Total value of opportunities generated (time aggregation "All" only)<br /><br />**Field Name:** `opportunity_value`<br />**Type:** metric         |
| <div>Interested</div>          | Leads marked as interested (time aggregation "All" only)<br /><br />**Field Name:** `interested`<br />**Type:** metric                            |
| <div>Meetings Booked</div>     | Meetings booked (time aggregation "All" only)<br /><br />**Field Name:** `meetings_booked`<br />**Type:** metric                                  |
| <div>Meetings Completed</div>  | Meetings completed (time aggregation "All" only)<br /><br />**Field Name:** `meetings_completed`<br />**Type:** metric                            |
| <div>Closed</div>              | Deals closed (time aggregation "All" only)<br /><br />**Field Name:** `closed`<br />**Type:** metric                                              |
| <div>Reply Rate</div>          | Unique replies divided by new leads contacted (0–1 ratio)<br /><br />**Field Name:** `reply_rate`<br />**Type:** metric                           |
| <div>Bounce Rate</div>         | Bounced emails divided by contacted leads (0–1 ratio, time aggregation "All" only)<br /><br />**Field Name:** `bounce_rate`<br />**Type:** metric |

### Leads

|                         |                                                                                                                           |
| ----------------------- | ------------------------------------------------------------------------------------------------------------------------- |
| <div>Lead Opens</div>   | Number of email opens by the lead<br /><br />**Field Name:** `lead_open_count`<br />**Type:** metric                      |
| <div>Lead Replies</div> | Number of replies from the lead<br /><br />**Field Name:** `lead_reply_count`<br />**Type:** metric                       |
| <div>Lead Clicks</div>  | Number of link clicks by the lead<br /><br />**Field Name:** `lead_click_count`<br />**Type:** metric                     |
| <div>Leads Count</div>  | Number of leads (1 per row — sum to count leads per group)<br /><br />**Field Name:** `leads_count`<br />**Type:** metric |

### Emails

|                         |                                                                                                                              |
| ----------------------- | ---------------------------------------------------------------------------------------------------------------------------- |
| <div>Emails Count</div> | Number of emails (1 per row — sum to count emails per group)<br /><br />**Field Name:** `emails_count`<br />**Type:** metric |

### Sender Accounts

|                                |                                                                                                                        |
| ------------------------------ | ---------------------------------------------------------------------------------------------------------------------- |
| <div>Sender Warmup Score</div> | Warmup health score of the sender inbox (0–100)<br /><br />**Field Name:** `sender_warmup_score`<br />**Type:** metric |

***

## Related

<CardGroup>
  <Card title="Fields Catalog" icon="book" href="/fields-catalog">
    Browse all platforms
  </Card>

  <Card title="HubSpot Fields" icon="chart-bar" href="/data-source/hubspot/fields">
    HubSpot metrics & dimensions
  </Card>

  <Card title="Mailchimp Fields" icon="chart-bar" href="/data-source/mailchimp/fields">
    Mailchimp metrics & dimensions
  </Card>

  <Card title="Klaviyo Fields" icon="chart-bar" href="/data-source/klaviyo/fields">
    Klaviyo metrics & dimensions
  </Card>
</CardGroup>


# Klaviyo Metrics & Dimensions
Source: https://support.detrics.io/data-source/klaviyo/fields

Complete reference for Klaviyo email marketing dimensions and metrics

<Info>
  **Last updated:** August 6, 2026
</Info>

<div>
  <div>
    27 dimensions
  </div>

  <div>
    34 metrics
  </div>
</div>

This reference covers all available dimensions and metrics for Klaviyo data through Detrics. Use this guide to understand what data you can extract and how to structure your queries.

<div>
  <span>Supported destinations:</span>

  <div>
    Google Sheets
  </div>

  <div>
    Looker Studio
  </div>

  <div>
    Claude
  </div>

  <div>
    BigQuery
  </div>
</div>

## Dimensions

Dimensions are the attributes you can use to segment and group your Klaviyo data.

### Account

|                         |                                                                                                                |
| ----------------------- | -------------------------------------------------------------------------------------------------------------- |
| <div>Account ID</div>   | The unique identifier for the Klaviyo account<br /><br />**Field Name:** `account_id`<br />**Type:** dimension |
| <div>Account name</div> | The Klaviyo account/organization name<br /><br />**Field Name:** `account_name`<br />**Type:** dimension       |

### Campaign

|                                         |                                                                                                                                                 |
| --------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------- |
| <div>Campaign ID</div>                  | The unique identifier for the email campaign<br /><br />**Field Name:** `campaign_id`<br />**Type:** dimension                                  |
| <div>Campaign name</div>                | The name of the email campaign<br /><br />**Field Name:** `campaign_name`<br />**Type:** dimension                                              |
| <div>Campaign status</div>              | The current status of the campaign (e.g., sent, draft)<br /><br />**Field Name:** `campaign_status`<br />**Type:** dimension                    |
| <div>Campaign send date & time</div>    | The date and time when the campaign was sent (YYYY-MM-DD HH:MM:SS)<br /><br />**Field Name:** `campaign_send_datetime`<br />**Type:** dimension |
| <div>Campaign created date & time</div> | The date and time when the campaign was created<br /><br />**Field Name:** `campaign_created_datetime`<br />**Type:** dimension                 |

### Email Content

|                         |                                                                                                                   |
| ----------------------- | ----------------------------------------------------------------------------------------------------------------- |
| <div>Subject</div>      | The email subject line<br /><br />**Field Name:** `campaign_subject`<br />**Type:** dimension                     |
| <div>Preview text</div> | The email preview text shown in inbox<br /><br />**Field Name:** `campaign_preview_text`<br />**Type:** dimension |
| <div>From email</div>   | The sender email address<br /><br />**Field Name:** `campaign_from_email`<br />**Type:** dimension                |
| <div>From name</div>    | The sender display name<br /><br />**Field Name:** `campaign_from_name`<br />**Type:** dimension                  |
| <div>Message type</div> | The type of message (e.g., email)<br /><br />**Field Name:** `campaign_message_type`<br />**Type:** dimension     |
| <div>Template ID</div>  | The ID of the email template used<br /><br />**Field Name:** `campaign_template_id`<br />**Type:** dimension      |

### Flow

|                                     |                                                                                                                                                |
| ----------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------- |
| <div>Flow ID</div>                  | The unique identifier for the automated flow<br /><br />**Field Name:** `flow_id`<br />**Type:** dimension                                     |
| <div>Flow name</div>                | The name of the automated email flow<br /><br />**Field Name:** `flow_name`<br />**Type:** dimension                                           |
| <div>Flow status</div>              | The current status of the flow (draft, live, manual)<br /><br />**Field Name:** `flow_status`<br />**Type:** dimension                         |
| <div>Flow trigger type</div>        | The type of trigger that starts the flow (e.g., list, metric, segment)<br /><br />**Field Name:** `flow_trigger_type`<br />**Type:** dimension |
| <div>Flow created date & time</div> | The date and time when the flow was created<br /><br />**Field Name:** `flow_created_datetime`<br />**Type:** dimension                        |
| <div>Flow updated date & time</div> | The date and time when the flow was last updated<br /><br />**Field Name:** `flow_updated_datetime`<br />**Type:** dimension                   |
| <div>Flow message ID</div>          | The unique identifier for the specific message within the flow<br /><br />**Field Name:** `flow_message_id`<br />**Type:** dimension           |
| <div>Flow message name</div>        | The name of the specific message within the flow<br /><br />**Field Name:** `flow_message_name`<br />**Type:** dimension                       |

### Source

|                         |                                                                                                                                             |
| ----------------------- | ------------------------------------------------------------------------------------------------------------------------------------------- |
| <div>Send channel</div> | The channel type - distinguishes campaigns from flows (campaign or flow)<br /><br />**Field Name:** `send_channel`<br />**Type:** dimension |

### Lists & Segments

|                                               |                                                                                                                       |
| --------------------------------------------- | --------------------------------------------------------------------------------------------------------------------- |
| <div>List / Segment ID</div>                  | The unique identifier of the list or segment<br /><br />**Field Name:** `list_id`<br />**Type:** dimension            |
| <div>List / Segment name</div>                | The name of the list or segment<br /><br />**Field Name:** `list_name`<br />**Type:** dimension                       |
| <div>Audience type (List or Segment)</div>    | Whether the audience is a List or a Segment<br /><br />**Field Name:** `list_type`<br />**Type:** dimension           |
| <div>List / Segment created date & time</div> | When the list or segment was created<br /><br />**Field Name:** `list_created_datetime`<br />**Type:** dimension      |
| <div>List / Segment updated date & time</div> | When the list or segment was last updated<br /><br />**Field Name:** `list_updated_datetime`<br />**Type:** dimension |

## Metrics

Metrics are the numerical values you can measure and analyze from your Klaviyo campaigns.

### Delivery

|                              |                                                                                                                         |
| ---------------------------- | ----------------------------------------------------------------------------------------------------------------------- |
| <div>Email recipients</div>  | Total number of recipients the email was sent to<br /><br />**Field Name:** `total_recipients`<br />**Type:** metric    |
| <div>Emails received</div>   | Number of emails successfully delivered to recipients<br /><br />**Field Name:** `received_email`<br />**Type:** metric |
| <div>Emails bounced</div>    | Number of emails that bounced (hard or soft bounces)<br /><br />**Field Name:** `bounced_email`<br />**Type:** metric   |
| <div>Email bounce rate</div> | Percentage of emails that bounced (bounced / recipients)<br /><br />**Field Name:** `bounce_rate`<br />**Type:** metric |
| <div>Emails dropped</div>    | Number of emails that were dropped before sending<br /><br />**Field Name:** `dropped_email`<br />**Type:** metric      |

### Engagement

|                                    |                                                                                                                                        |
| ---------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------- |
| <div>Emails opened</div>           | Total number of email opens (can include multiple opens per person)<br /><br />**Field Name:** `opened_email`<br />**Type:** metric    |
| <div>Emails opened (unique)</div>  | Number of unique recipients who opened the email<br /><br />**Field Name:** `opened_email_unique`<br />**Type:** metric                |
| <div>Email open rate</div>         | Percentage of recipients who opened the email (unique opens / recipients)<br /><br />**Field Name:** `open_rate`<br />**Type:** metric |
| <div>Emails clicked</div>          | Total number of clicks on links in the email<br /><br />**Field Name:** `clicked_email`<br />**Type:** metric                          |
| <div>Emails clicked (unique)</div> | Number of unique recipients who clicked a link in the email<br /><br />**Field Name:** `clicked_email_unique`<br />**Type:** metric    |
| <div>Email click rate</div>        | Percentage of recipients who clicked a link (unique clicks / recipients)<br /><br />**Field Name:** `click_rate`<br />**Type:** metric |

### Unsubscribe & Spam

|                                  |                                                                                                                                           |
| -------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------- |
| <div>Emails marked as spam</div> | Number of recipients who marked the email as spam<br /><br />**Field Name:** `marked_email_as_spam`<br />**Type:** metric                 |
| <div>Email spam rate</div>       | Percentage of recipients who marked as spam (spam / recipients)<br /><br />**Field Name:** `spam_rate`<br />**Type:** metric              |
| <div>Unsubscribes</div>          | Number of recipients who unsubscribed<br /><br />**Field Name:** `unsubscribed`<br />**Type:** metric                                     |
| <div>Unsubscribe rate</div>      | Percentage of recipients who unsubscribed (unsubscribes / recipients)<br /><br />**Field Name:** `unsubscribe_rate`<br />**Type:** metric |

### Shopify eCommerce

|                                       |                                                                                                                                                                    |
| ------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| <div>Placed Order (count)</div>       | Total number of orders placed attributed to this email (Shopify integration)<br /><br />**Field Name:** `shopify_placed_order`<br />**Type:** metric               |
| <div>Placed Order (value)</div>       | Total revenue from orders placed attributed to this email (Shopify integration)<br /><br />**Field Name:** `shopify_placed_order_value`<br />**Type:** metric      |
| <div>Placed Order (unique)</div>      | Number of unique recipients who placed an order (Shopify integration)<br /><br />**Field Name:** `shopify_placed_order_unique`<br />**Type:** metric               |
| <div>Ordered Product (count)</div>    | Total number of products ordered attributed to this email (Shopify integration)<br /><br />**Field Name:** `shopify_ordered_product`<br />**Type:** metric         |
| <div>Ordered Product (value)</div>    | Total value of products ordered attributed to this email (Shopify integration)<br /><br />**Field Name:** `shopify_ordered_product_value`<br />**Type:** metric    |
| <div>Checkout Started (count)</div>   | Number of checkouts started attributed to this email (Shopify integration)<br /><br />**Field Name:** `shopify_checkout_started`<br />**Type:** metric             |
| <div>Checkout Started (value)</div>   | Total value of checkouts started attributed to this email (Shopify integration)<br /><br />**Field Name:** `shopify_checkout_started_value`<br />**Type:** metric  |
| <div>Cancelled Order (count)</div>    | Number of cancelled orders attributed to this email (Shopify integration)<br /><br />**Field Name:** `shopify_cancelled_order`<br />**Type:** metric               |
| <div>Cancelled Order (value)</div>    | Total value of cancelled orders attributed to this email (Shopify integration)<br /><br />**Field Name:** `shopify_cancelled_order_value`<br />**Type:** metric    |
| <div>Fulfilled Order (count)</div>    | Number of fulfilled orders attributed to this email (Shopify integration)<br /><br />**Field Name:** `shopify_fulfilled_order`<br />**Type:** metric               |
| <div>Fulfilled Order (value)</div>    | Total value of fulfilled orders attributed to this email (Shopify integration)<br /><br />**Field Name:** `shopify_fulfilled_order_value`<br />**Type:** metric    |
| <div>Refunded Order (count)</div>     | Number of refunded orders attributed to this email (Shopify integration)<br /><br />**Field Name:** `shopify_refunded_order`<br />**Type:** metric                 |
| <div>Refunded Order (value)</div>     | Total value of refunded orders attributed to this email (Shopify integration)<br /><br />**Field Name:** `shopify_refunded_order_value`<br />**Type:** metric      |
| <div>Average Order Value</div>        | Average order value (total order value / number of orders) attributed to this email<br /><br />**Field Name:** `shopify_average_order_value`<br />**Type:** metric |
| <div>Checkout-to-Order Rate</div>     | Percentage of started checkouts that resulted in a placed order<br /><br />**Field Name:** `shopify_checkout_start_to_order_rate`<br />**Type:** metric            |
| <div>Checkout Completed (count)</div> | Number of completed checkouts (same as placed orders)<br /><br />**Field Name:** `shopify_checkout_completed`<br />**Type:** metric                                |
| <div>Conversion Rate</div>            | Percentage of unique recipients who placed an order (unique orders / recipients)<br /><br />**Field Name:** `shopify_conversion_rate`<br />**Type:** metric        |
| <div>Revenue per Recipient</div>      | Average revenue per email recipient (total order value / recipients)<br /><br />**Field Name:** `shopify_revenue_per_recipient`<br />**Type:** metric              |

### Lists & Segments

|                          |                                                                                                                                                                                                            |
| ------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| <div>Members count</div> | Current number of profiles in the list or segment. Snapshot of right now - to track growth, schedule a daily query with append mode.<br /><br />**Field Name:** `list_profile_count`<br />**Type:** metric |

***

## Related

<CardGroup>
  <Card title="Fields Catalog" icon="book" href="/fields-catalog">
    Browse all platforms
  </Card>

  <Card title="HubSpot Fields" icon="chart-bar" href="/data-source/hubspot/fields">
    HubSpot metrics & dimensions
  </Card>

  <Card title="Mailchimp Fields" icon="chart-bar" href="/data-source/mailchimp/fields">
    Mailchimp metrics & dimensions
  </Card>

  <Card title="Google Merchant Center Fields" icon="chart-bar" href="/data-source/google-merchant-center/fields">
    Google Merchant Center metrics & dimensions
  </Card>
</CardGroup>


# LinkedIn Ads Metrics & Dimensions
Source: https://support.detrics.io/data-source/linkedin-ads/fields

Complete reference for LinkedIn Ads dimensions and metrics

<Info>
  **Last updated:** August 6, 2026
</Info>

<div>
  <div>
    61 dimensions
  </div>

  <div>
    103 metrics
  </div>
</div>

This reference covers all available dimensions and metrics for LinkedIn Ads data through Detrics. Use this guide to understand what data you can extract and how to structure your queries.

<div>
  <span>Supported destinations:</span>

  <div>
    Google Sheets
  </div>

  <div>
    Looker Studio
  </div>

  <div>
    Claude
  </div>

  <div>
    BigQuery
  </div>
</div>

## Dimensions

Dimensions are the attributes you can use to segment and group your LinkedIn Ads data.

### Most Used

|                                |                                                                                                                                                                             |
| ------------------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| <div>Account ID</div>          | Advertiser Account Unique Identifier.<br /><br />**Field Name:** `account.id`<br />**Type:** dimension                                                                      |
| <div>Account Name</div>        | Advertiser Account Name.<br /><br />**Field Name:** `account.name`<br />**Type:** dimension                                                                                 |
| <div>Campaign Group ID</div>   | Unique Identifier of the upper level in the campaigns hierarchy. It can contain multiple campaigns.<br /><br />**Field Name:** `campaign_group.id`<br />**Type:** dimension |
| <div>Campaign Group Name</div> | Name of the upper level in the campaigns hierarchy. It can contain multiple campaigns.<br /><br />**Field Name:** `campaign_group.name`<br />**Type:** dimension            |
| <div>Campaign ID</div>         | Unique Identifier of the mid level in the campaigns hierarchy. It can contain multiple ads.<br /><br />**Field Name:** `campaign.id`<br />**Type:** dimension               |
| <div>Campaign Name</div>       | Name of the mid level in the campaigns hierarchy. It can contain multiple ads.<br /><br />**Field Name:** `campaign.name`<br />**Type:** dimension                          |
| <div>Ad ID</div>               | Unique Identifier of the lowest level in the campaigns hierarchy.<br /><br />**Field Name:** `ad.id`<br />**Type:** dimension                                               |
| <div>Ad Name</div>             | Name of the lowest level in the campaigns hierarchy.<br /><br />**Field Name:** `ad.name`<br />**Type:** dimension                                                          |
| <div>Ad URL</div>              | The URL to visualize this Ad's data.<br /><br />**Field Name:** `ad.url`<br />**Type:** dimension                                                                           |

### Creative

|                                              |                                                                                                                                                                                                                                |
| -------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| <div>Creative Title</div>                    | The title or text of the LinkedIn post being promoted by this ad creative. Resolved from the post referenced by the ad.<br /><br />**Field Name:** `ad.creative_title`<br />**Type:** dimension                                |
| <div>Creative Destination URL</div>          | Destination URL the ad sends users to (landing page of the promoted post).<br /><br />**Field Name:** `ad.creative_url`<br />**Type:** dimension                                                                               |
| <div>Creative CTA Label</div>                | Call-to-action button of the promoted post, e.g. LEARN\_MORE or REGISTER.<br /><br />**Field Name:** `ad.creative_cta_label`<br />**Type:** dimension                                                                          |
| <div>Creative Description</div>              | Description of the article promoted by the ad (article ads only).<br /><br />**Field Name:** `ad.creative_description`<br />**Type:** dimension                                                                                |
| <div>Creative Text</div>                     | Full text (commentary) of the LinkedIn post being promoted by this ad creative.<br /><br />**Field Name:** `ad.creative_text`<br />**Type:** dimension                                                                         |
| <div>Creative Media Type</div>               | Type of the promoted content: ARTICLE, IMAGE, VIDEO, MULTI\_IMAGE, CAROUSEL, DOCUMENT or SPONSORED\_MESSAGE.<br /><br />**Field Name:** `ad.creative_media_type`<br />**Type:** dimension                                      |
| <div>Creative Published At</div>             | Date and time when the promoted post was published.<br /><br />**Field Name:** `ad.creative_published_at`<br />**Type:** dimension                                                                                             |
| <div>Creative Thumbnail URL</div>            | Thumbnail URL of the creative (image, article thumbnail or video cover). Note: LinkedIn media URLs are temporary and expire after a few weeks.<br /><br />**Field Name:** `ad.creative_thumbnail_url`<br />**Type:** dimension |
| <div>Creative Download URL</div>             | Download URL of the creative media (full-size image or video file). Note: LinkedIn media URLs are temporary and expire after a few weeks.<br /><br />**Field Name:** `ad.creative_download_url`<br />**Type:** dimension       |
| <div>Creative Video Duration (Seconds)</div> | Duration of the promoted video in seconds (video ads only).<br /><br />**Field Name:** `ad.creative_video_duration`<br />**Type:** dimension                                                                                   |

### Account

|                     |                                                                         |
| ------------------- | ----------------------------------------------------------------------- |
| <div>Status</div>   | <br /><br />**Field Name:** `account.status`<br />**Type:** dimension   |
| <div>Currency</div> | <br /><br />**Field Name:** `account.currency`<br />**Type:** dimension |

### Campaign Group

|                         |                                                                                                                                                                    |
| ----------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| <div>Total Budget</div> | <br /><br />**Field Name:** `campaign_group.total_budget`<br />**Type:** dimension                                                                                 |
| <div>Status</div>       | Can be one of: ACTIVE, ARCHIVED, CANCELLED, DRAFT, PAUSED, PENDING\_DELETION, REMOVED.<br /><br />**Field Name:** `campaign_group.status`<br />**Type:** dimension |
| <div>Start Time</div>   | <br /><br />**Field Name:** `campaign_group.start_time`<br />**Type:** dimension                                                                                   |
| <div>End Time</div>     | <br /><br />**Field Name:** `campaign_group.end_time`<br />**Type:** dimension                                                                                     |

### Campaign

|                           |                                                                                                                                                                                                                       |
| ------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| <div>Status</div>         | Can be one of: ACTIVE, ARCHIVED, CANCELLED, DRAFT, PAUSED, PENDING\_DELETION, REMOVED.<br /><br />**Field Name:** `campaign.status`<br />**Type:** dimension                                                          |
| <div>Daily Budget</div>   | <br /><br />**Field Name:** `campaign.daily_budget`<br />**Type:** dimension                                                                                                                                          |
| <div>Total Budget</div>   | <br /><br />**Field Name:** `campaign.total_budget`<br />**Type:** dimension                                                                                                                                          |
| <div>Start Time</div>     | <br /><br />**Field Name:** `campaign.start_time`<br />**Type:** dimension                                                                                                                                            |
| <div>End Time</div>       | <br /><br />**Field Name:** `campaign.end_time`<br />**Type:** dimension                                                                                                                                              |
| <div>Campaign Type</div>  | Can be one of: TEXT\_AD, SPONSORED\_UPDATES, SPONSORED\_INMAILS, DYNAMIC.<br /><br />**Field Name:** `campaign.type`<br />**Type:** dimension                                                                         |
| <div>Objective Type</div> | Can be one of: BRAND\_AWARENESS, WEBSITE, ENGAGEMENT, VIDEO\_VIEW, LEAD\_GENERATION, WEBSITE\_CONVERSION, JOB\_APPLICANT, TALENT\_LEAD.<br /><br />**Field Name:** `campaign.objective_type`<br />**Type:** dimension |
| <div>Ad Format</div>      | On Linkedin Ads, the ad format is set at the campaign level.<br /><br />**Field Name:** `campaign.ad_format`<br />**Type:** dimension                                                                                 |

### Conversions

|                                            |                                                                                                                                                 |
| ------------------------------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------- |
| <div>Conversion ID</div>                   | Unique identifier for the conversion.<br /><br />**Field Name:** `conversion.id`<br />**Type:** dimension                                       |
| <div>Conversion Name</div>                 | Name of the conversion.<br /><br />**Field Name:** `conversion.name`<br />**Type:** dimension                                                   |
| <div>Conversion Type</div>                 | Type of the conversion.<br /><br />**Field Name:** `conversion.type`<br />**Type:** dimension                                                   |
| <div>Conversion Enabled</div>              | Indicates if the conversion is enabled.<br /><br />**Field Name:** `conversion.enabled`<br />**Type:** dimension                                |
| <div>Conversion Method</div>               | Method used for conversion tracking.<br /><br />**Field Name:** `conversion.conversionMethod`<br />**Type:** dimension                          |
| <div>Conversion Value Type</div>           | Type of value assigned to the conversion.<br /><br />**Field Name:** `conversion.valueType`<br />**Type:** dimension                            |
| <div>Attribution Type</div>                | Attribution model used for the conversion.<br /><br />**Field Name:** `conversion.attributionType`<br />**Type:** dimension                     |
| <div>Post Click Attribution Window</div>   | Post-click attribution window size in days.<br /><br />**Field Name:** `conversion.postClickAttributionWindowSize`<br />**Type:** dimension     |
| <div>View Through Attribution Window</div> | View-through attribution window size in days.<br /><br />**Field Name:** `conversion.viewThroughAttributionWindowSize`<br />**Type:** dimension |
| <div>Conversion Currency Code</div>        | Currency code for the conversion value.<br /><br />**Field Name:** `conversion.valueCurrencyCode`<br />**Type:** dimension                      |
| <div>Conversion Value Amount</div>         | Monetary value assigned to the conversion.<br /><br />**Field Name:** `conversion.valueAmount`<br />**Type:** dimension                         |
| <div>Conversion Created Date</div>         | Date when the conversion was created.<br /><br />**Field Name:** `conversion.created`<br />**Type:** dimension                                  |
| <div>Conversion Last Modified</div>        | Date when the conversion was last modified.<br /><br />**Field Name:** `conversion.lastModified`<br />**Type:** dimension                       |
| <div>Last Callback Date</div>              | Date of the last callback for the conversion.<br /><br />**Field Name:** `conversion.lastCallbackAt`<br />**Type:** dimension                   |
| <div>Image Pixel Tag</div>                 | Image pixel tag for conversion tracking.<br /><br />**Field Name:** `conversion.imagePixelTag`<br />**Type:** dimension                         |
| <div>Conversion Campaigns</div>            | Campaigns associated with the conversion.<br /><br />**Field Name:** `conversion.campaigns`<br />**Type:** dimension                            |
| <div>Conversion URL Rules</div>            | URL rules defined for the conversion.<br /><br />**Field Name:** `conversion.urlRules`<br />**Type:** dimension                                 |

### Demographics

|                           |                                                                                                                                                                                                                                                                                                                                           |
| ------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| <div>Company Size</div>   | Size of the company based on number of employees.<br /><br />**Field Name:** `demographic.company_size`<br />**Type:** dimension                                                                                                                                                                                                          |
| <div>Industry</div>       | Industry classification of the target audience.<br /><br />**Field Name:** `demographic.industry`<br />**Type:** dimension                                                                                                                                                                                                                |
| <div>Seniority</div>      | Seniority level of the target audience.<br /><br />**Field Name:** `demographic.seniority`<br />**Type:** dimension                                                                                                                                                                                                                       |
| <div>Job Function</div>   | Job function of the target audience.<br /><br />**Field Name:** `demographic.job_function`<br />**Type:** dimension                                                                                                                                                                                                                       |
| <div>Country</div>        | Country of the target audience.<br /><br />**Field Name:** `demographic.country`<br />**Type:** dimension                                                                                                                                                                                                                                 |
| <div>Region</div>         | Geographic region of the target audience.<br /><br />**Field Name:** `demographic.region`<br />**Type:** dimension                                                                                                                                                                                                                        |
| <div>Job Title</div>      | Job title of the audience members who saw or engaged with your ads. LinkedIn reports the top 100 job titles per creative per day; values with fewer than 3 events are omitted. Reach metrics are not available with this breakdown.<br /><br />**Field Name:** `demographic.job_title`<br />**Type:** dimension                           |
| <div>Member Company</div> | Company of the audience members who saw or engaged with your ads (account-based marketing view). LinkedIn reports the top 100 companies per creative per day; values with fewer than 3 events are omitted. Reach metrics are not available with this breakdown.<br /><br />**Field Name:** `demographic.company`<br />**Type:** dimension |

### Delivery

|                             |                                                                                                                                                                                                               |
| --------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| <div>Device Type</div>      | Device type the ad made an impression on (Mobile App, Mobile Web, Desktop Web). Reach metrics are not available with this breakdown.<br /><br />**Field Name:** `demographic.device`<br />**Type:** dimension |
| <div>Serving Location</div> | Where the ad was served: on LinkedIn (on-site) or on the LinkedIn Audience Network (off-site).<br /><br />**Field Name:** `demographic.serving_location`<br />**Type:** dimension                             |
| <div>Placement</div>        | Ad placement: LinkedIn, Offsite (Audience Network) or Offsite In-Stream. Reach metrics are not available with this breakdown.<br /><br />**Field Name:** `demographic.placement`<br />**Type:** dimension     |

## Metrics

Metrics are the numerical values you can measure and analyze from your LinkedIn Ads campaigns.

### Most Used

|                                |                                                                                                                                                                                                                                                                                                                                                                                                               |
| ------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| <div>Cost</div>                | Cost in the account's local currency.<br /><br />**Field Name:** `costInLocalCurrency`<br />**Type:** metric                                                                                                                                                                                                                                                                                                  |
| <div>Cost In USD</div>         | Cost converted to USD.<br /><br />**Field Name:** `costInUsd`<br />**Type:** metric                                                                                                                                                                                                                                                                                                                           |
| <div>Clicks</div>              | The count of chargeable clicks. Despite not charging for clicks for CPM campaigns, this field still represents those clicks for which Linkedin would otherwise charge advertisers based on objective (for example, clicks to view the landing page or company page).<br /><br />**Field Name:** `clicks`<br />**Type:** metric                                                                                |
| <div>Impressions</div>         | This is the count of impressions for Sponsored Content and sends for Sponsored Messaging.<br /><br />**Field Name:** `impressions`<br />**Type:** metric                                                                                                                                                                                                                                                      |
| <div>Unique Impressions</div>  | The estimated number of unique member accounts with at least one impression. Some offsite traffic is excluded from this metric, so it may be underestimated for campaigns running on the LinkedIn Audience Network. This metric is only available when the number of days in the date range is less than or equal to 92 days.<br /><br />**Field Name:** `approximateUniqueImpressions`<br />**Type:** metric |
| <div>Landing Page Clicks</div> | The count of clicks which take the user to the creative landing page.<br /><br />**Field Name:** `landingPageClicks`<br />**Type:** metric                                                                                                                                                                                                                                                                    |
| <div>Company Page Clicks</div> | The count of clicks to view the company page.<br /><br />**Field Name:** `companyPageClicks`<br />**Type:** metric                                                                                                                                                                                                                                                                                            |
| <div>CTR</div>                 | The percentage of impressions that resulted in clicks.<br /><br />**Field Name:** `ctr`<br />**Type:** metric                                                                                                                                                                                                                                                                                                 |
| <div>CPC</div>                 | The average cost per click.<br /><br />**Field Name:** `cpc`<br />**Type:** metric                                                                                                                                                                                                                                                                                                                            |
| <div>CPM</div>                 | The cost per thousand impressions.<br /><br />**Field Name:** `cpm`<br />**Type:** metric                                                                                                                                                                                                                                                                                                                     |

### Conversions

|                                           |                                                                                                                                                                                                                                                                                                       |
| ----------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| <div>Website Conversions</div>            | Total number of times users took a desired action after clicking on or seeing your ad.<br /><br />**Field Name:** `externalWebsiteConversions`<br />**Type:** metric                                                                                                                                  |
| <div>Website Post Click Conversions</div> | Total number of times users took a desired action after clicking on your ad.<br /><br />**Field Name:** `externalWebsitePostClickConversions`<br />**Type:** metric                                                                                                                                   |
| <div>Website Post View Conversions</div>  | Total number of times users took a desired action after seeing your ad.<br /><br />**Field Name:** `externalWebsitePostViewConversions`<br />**Type:** metric                                                                                                                                         |
| <div>Conversion Value</div>               | Value of the conversions in the account's local currency based on rules defined by the advertiser. Conversion value is set by the advertiser at a per conversion level, and aggregated across the query time range.<br /><br />**Field Name:** `conversionValueInLocalCurrency`<br />**Type:** metric |

### Lead Generation

|                                     |                                                                                                                                                                                                  |
| ----------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| <div>Mail Contact Info Shares</div> | The number of times users shared contact info through the One Click Lead Gen for Sponsored Messaging ads.<br /><br />**Field Name:** `leadGenerationMailContactInfoShares`<br />**Type:** metric |
| <div>Mail Interested Clicks</div>   | The count of Sponsored Messaging ad recipients who clicked to demonstrate interest.<br /><br />**Field Name:** `leadGenerationMailInterestedClicks`<br />**Type:** metric                        |
| <div>Form Opens</div>               | The count of times users opened the lead form for a One Click Lead Gen campaign.<br /><br />**Field Name:** `oneClickLeadFormOpens`<br />**Type:** metric                                        |
| <div>One Click Leads</div>          | The count of leads generated through One Click Lead Gen.<br /><br />**Field Name:** `oneClickLeads`<br />**Type:** metric                                                                        |
| <div>Valid Work Email Leads</div>   | The count of leads with a valid work email that does not use an established free or personal email domain.<br /><br />**Field Name:** `validWorkEmailLeads`<br />**Type:** metric                |
| <div>Talent Leads</div>             | Number of leads captured through a talent media campaign.<br /><br />**Field Name:** `talentLeads`<br />**Type:** metric                                                                         |
| <div>Qualified Leads</div>          | The number of leads that meet specific qualification criteria.<br /><br />**Field Name:** `qualifiedLeads`<br />**Type:** metric                                                                 |
| <div>Cost Per Qualified Lead</div>  | The average cost per qualified lead generated.<br /><br />**Field Name:** `costPerQualifiedLead`<br />**Type:** metric                                                                           |

### Sponsored Content

|                          |                                                                                                                           |
| ------------------------ | ------------------------------------------------------------------------------------------------------------------------- |
| <div>Likes</div>         | The count of likes. Sponsored Content only.<br /><br />**Field Name:** `likes`<br />**Type:** metric                      |
| <div>Comment Likes</div> | The count of likes of a comment. Sponsored Content only.<br /><br />**Field Name:** `commentLikes`<br />**Type:** metric  |
| <div>Comments</div>      | The count of comments. Sponsored Content only.<br /><br />**Field Name:** `comments`<br />**Type:** metric                |
| <div>Shares</div>        | The count of shares. Sponsored Content only.<br /><br />**Field Name:** `shares`<br />**Type:** metric                    |
| <div>Follows</div>       | The count of follows. Sponsored Content and Follower Ads only.<br /><br />**Field Name:** `follows`<br />**Type:** metric |

### Sponsored Messaging

|                            |                                                                                                                                                                               |
| -------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| <div>Action Clicks</div>   | The count of clicks on the action button of the Sponsored Messaging ad.<br /><br />**Field Name:** `actionClicks`<br />**Type:** metric                                       |
| <div>Ad Unit Clicks</div>  | The count of clicks on the ad unit displayed alongside the Sponsored Messaging ad.<br /><br />**Field Name:** `adUnitClicks`<br />**Type:** metric                            |
| <div>Opens</div>           | The count of opens of Sponsored Messaging ads.<br /><br />**Field Name:** `opens`<br />**Type:** metric                                                                       |
| <div>Sends</div>           | The count of sends of Sponsored Messaging ads.<br /><br />**Field Name:** `sends`<br />**Type:** metric                                                                       |
| <div>Text Url Clicks</div> | The count of clicks on any links (anchor tags) that were included in the body of the Sponsored Messaging ad.<br /><br />**Field Name:** `textUrlClicks`<br />**Type:** metric |

### Cards

|                             |                                                                                                                                                                                                                                                                                                        |
| --------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| <div>Card Clicks</div>      | The number of clicks for each card of a carousel ad. The first card click of the carousel ad results in an immediate Card Click and Click, whereas scrolling to other cards and clicking will count as additional Card Click.<br /><br />**Field Name:** `cardClicks`<br />**Type:** metric            |
| <div>Card Impressions</div> | The number of impressions shown for each card of a carousel ad. The first card of the carousel ad results in an immediate cardImpression and impression, whereas scrolling to other cards will count as additional Card Impression.<br /><br />**Field Name:** `cardImpressions`<br />**Type:** metric |

### Document Ads

|                                       |                                                                                                                                                                                                                                                                                       |
| ------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| <div>Document Completions</div>       | The number of times users reached 100% of the document’s length, including those that skipped to this point. This metric is only available for document ads and not all dimensions.<br /><br />**Field Name:** `documentCompletions`<br />**Type:** metric                            |
| <div>First Quartile Completions</div> | The number of times users reached the first quartile of the document’s length, including those that skipped to this point. This metric is only available for document ads and not all dimensions.<br /><br />**Field Name:** `documentFirstQuartileCompletions`<br />**Type:** metric |
| <div>Midpoint Completions</div>       | The number of times users reached the second quartile of the document’s length, including those that skipped to this point. This metric is only available for document ads and not all dimensions.<br /><br />**Field Name:** `documentMidpointCompletions`<br />**Type:** metric     |
| <div>Third Quartile Completions</div> | The number of times users reached the third quartile of the document’s length, including those that skipped to this point. This metric is only available for document ads and not all dimensions.<br /><br />**Field Name:** `documentThirdQuartileCompletions`<br />**Type:** metric |

### Engagement

|                                     |                                                                                                                                                                                                                                                                                                                                                                     |
| ----------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| <div>Download Clicks</div>          | The number of times users have indicated the intent to download the media in an ad by clicking the download icon. This may or may not result in an actual download (e.g. if the user rejects a browser download prompt). This metric is only available for ad formats supporting media downloads.<br /><br />**Field Name:** `downloadClicks`<br />**Type:** metric |
| <div>Positive Reactions</div>       | The count of positive reactions on Sponsored Content which can capture, like, interest, praise, and other responses.<br /><br />**Field Name:** `reactions`<br />**Type:** metric                                                                                                                                                                                   |
| <div>Other Engagements</div>        | The count of user interactions with the ad unit that do not fit into any other more specific category.<br /><br />**Field Name:** `otherEngagements`<br />**Type:** metric                                                                                                                                                                                          |
| <div>Registrations</div>            | The number of times a member has registered for an event or seminar after viewing or clicking on an ad which has a LinkedIn event landing page. This includes gross registrations and does not account for a user unregistering.<br /><br />**Field Name:** `registrations`<br />**Type:** metric                                                                   |
| <div>Total Engagements</div>        | The count of all user interactions with the ad unit.<br /><br />**Field Name:** `totalEngagements`<br />**Type:** metric                                                                                                                                                                                                                                            |
| <div>Subscription Clicks</div>      | The number of clicks on subscription related content.<br /><br />**Field Name:** `subscriptionClicks`<br />**Type:** metric                                                                                                                                                                                                                                         |
| <div>Average Dwell Time</div>       | The average time users spend viewing the ad content.<br /><br />**Field Name:** `averageDwellTime`<br />**Type:** metric                                                                                                                                                                                                                                            |
| <div>Post Click Registrations</div> | Registrations that occurred after clicking on the ad.<br /><br />**Field Name:** `postClickRegistrations`<br />**Type:** metric                                                                                                                                                                                                                                     |
| <div>Post View Registrations</div>  | Registrations that occurred after viewing the ad.<br /><br />**Field Name:** `postViewRegistrations`<br />**Type:** metric                                                                                                                                                                                                                                          |

### Conversation Ads

|                                 |                                                                                                                                                 |
| ------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------- |
| <div>Headline Clicks</div>      | The number of times members clicked on the headline of conversation ads.<br /><br />**Field Name:** `headlineClicks`<br />**Type:** metric      |
| <div>Headline Impressions</div> | The number of times members were shown the headline of conversation ads.<br /><br />**Field Name:** `headlineImpressions`<br />**Type:** metric |

### Job Applications

|                                        |                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
| -------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| <div>Job Applications</div>            | The number of times a member completed a job application after viewing or clicking on an ad. Currently, this metric is broken down into postViewJobApplications (if the member applied after viewing the ad) and postClickJobApplications (if the member applied after clicking the ad).<br /><br />**Field Name:** `jobApplications`<br />**Type:** metric                                                                                             |
| <div>Job Apply Clicks</div>            | The number of times a member clicked on the job’s apply button on an LinkedIn jobs page after viewing or clicking on an ad which has a LinkedIn job landing page. Currently, this metric is broken down into postViewJobApplyClicks (if the member performed the action after viewing the ad) and postClickJobApplyClicks (if the member performed the action after clicking the ad).<br /><br />**Field Name:** `jobApplyClicks`<br />**Type:** metric |
| <div>Post Click Job Applications</div> | Job applications that occurred after clicking on the ad.<br /><br />**Field Name:** `postClickJobApplications`<br />**Type:** metric                                                                                                                                                                                                                                                                                                                    |
| <div>Post Click Job Apply Clicks</div> | Job apply clicks that occurred after clicking on the ad.<br /><br />**Field Name:** `postClickJobApplyClicks`<br />**Type:** metric                                                                                                                                                                                                                                                                                                                     |
| <div>Post View Job Applications</div>  | Job applications that occurred after viewing the ad.<br /><br />**Field Name:** `postViewJobApplications`<br />**Type:** metric                                                                                                                                                                                                                                                                                                                         |
| <div>Post View Job Apply Clicks</div>  | Job apply clicks that occurred after viewing the ad.<br /><br />**Field Name:** `postViewJobApplyClicks`<br />**Type:** metric                                                                                                                                                                                                                                                                                                                          |

### Videos

|                                       |                                                                                                                                                                                                                                                                       |
| ------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| <div>Full Screen Plays</div>          | Number of times members click on the full screen button or on the video (mobile only) to go into full screen mode.<br /><br />**Field Name:** `fullScreenPlays`<br />**Type:** metric                                                                                 |
| <div>Video Completions</div>          | The count of video ads that played 97-100% of the video. This includes watches that skipped to this point if the serving location is ON\_SITE.<br /><br />**Field Name:** `videoCompletions`<br />**Type:** metric                                                    |
| <div>First Quartile Completions</div> | The count of video ads that played through the first quartile of the video. This includes watches that skipped to this point if the serving location is ON\_SITE.<br /><br />**Field Name:** `videoFirstQuartileCompletions`<br />**Type:** metric                    |
| <div>Midpoint Completions</div>       | The count of video ads that played through the midpoint of the video. This includes watches that skipped to this point if the serving location is ON\_SITE.<br /><br />**Field Name:** `videoMidpointCompletions`<br />**Type:** metric                               |
| <div>Video Starts</div>               | The count of video ads that were started by users.<br /><br />**Field Name:** `videoStarts`<br />**Type:** metric                                                                                                                                                     |
| <div>Third Quartile Completions</div> | The count of video ads that played through the third quartile of the video. This includes watches that skipped to this point if the serving location is ON\_SITE.<br /><br />**Field Name:** `videoThirdQuartileCompletions`<br />**Type:** metric                    |
| <div>Video Views</div>                | A video ad playing for at least 2 continuous seconds 50% in-view, or a click on the CTA, whichever comes first. An interaction with the video (like going to fullscreen mode) does not count as a view.<br /><br />**Field Name:** `videoViews`<br />**Type:** metric |

### Reach

|                                     |                                                                                                                                             |
| ----------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------- |
| <div>Audience Penetration</div>     | The percentage of the target audience reached by the campaign.<br /><br />**Field Name:** `audiencePenetration`<br />**Type:** metric       |
| <div>Approximate Member Reach</div> | The estimated number of LinkedIn members reached by the campaign.<br /><br />**Field Name:** `approximateMemberReach`<br />**Type:** metric |

### Viral Metrics

|                                                          |                                                                                                                                                                                     |
| -------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| <div>Viral Clicks</div>                                  | Clicks generated through viral sharing of the content.<br /><br />**Field Name:** `viralClicks`<br />**Type:** metric                                                               |
| <div>Viral Impressions</div>                             | Impressions generated through viral sharing of the content.<br /><br />**Field Name:** `viralImpressions`<br />**Type:** metric                                                     |
| <div>Viral Likes</div>                                   | Likes generated through viral sharing of the content.<br /><br />**Field Name:** `viralLikes`<br />**Type:** metric                                                                 |
| <div>Viral Shares</div>                                  | Shares generated through viral sharing of the content.<br /><br />**Field Name:** `viralShares`<br />**Type:** metric                                                               |
| <div>Viral Comments</div>                                | Comments generated through viral sharing of the content.<br /><br />**Field Name:** `viralComments`<br />**Type:** metric                                                           |
| <div>Viral Follows</div>                                 | Follows generated through viral sharing of the content.<br /><br />**Field Name:** `viralFollows`<br />**Type:** metric                                                             |
| <div>Viral Reactions</div>                               | Reactions generated through viral sharing of the content.<br /><br />**Field Name:** `viralReactions`<br />**Type:** metric                                                         |
| <div>Viral Other Engagements</div>                       | Other engagements generated through viral sharing of the content.<br /><br />**Field Name:** `viralOtherEngagements`<br />**Type:** metric                                          |
| <div>Viral Total Engagements</div>                       | Total engagements generated through viral sharing of the content.<br /><br />**Field Name:** `viralTotalEngagements`<br />**Type:** metric                                          |
| <div>Viral Video Views</div>                             | Video views generated through viral sharing of the content.<br /><br />**Field Name:** `viralVideoViews`<br />**Type:** metric                                                      |
| <div>Viral Video Completions</div>                       | Video completions generated through viral sharing of the content.<br /><br />**Field Name:** `viralVideoCompletions`<br />**Type:** metric                                          |
| <div>Viral Video Starts</div>                            | Video starts generated through viral sharing of the content.<br /><br />**Field Name:** `viralVideoStarts`<br />**Type:** metric                                                    |
| <div>Viral Video First Quartile Completions</div>        | Video first quartile completions generated through viral sharing of the content.<br /><br />**Field Name:** `viralVideoFirstQuartileCompletions`<br />**Type:** metric              |
| <div>Viral Video Midpoint Completions</div>              | Video midpoint completions generated through viral sharing of the content.<br /><br />**Field Name:** `viralVideoMidpointCompletions`<br />**Type:** metric                         |
| <div>Viral Video Third Quartile Completions</div>        | Video third quartile completions generated through viral sharing of the content.<br /><br />**Field Name:** `viralVideoThirdQuartileCompletions`<br />**Type:** metric              |
| <div>Viral Full Screen Plays</div>                       | Full screen plays generated through viral sharing of the content.<br /><br />**Field Name:** `viralFullScreenPlays`<br />**Type:** metric                                           |
| <div>Viral Landing Page Clicks</div>                     | Landing page clicks generated through viral sharing of the content.<br /><br />**Field Name:** `viralLandingPageClicks`<br />**Type:** metric                                       |
| <div>Viral Company Page Clicks</div>                     | Company page clicks generated through viral sharing of the content.<br /><br />**Field Name:** `viralCompanyPageClicks`<br />**Type:** metric                                       |
| <div>Viral External Website Conversions</div>            | External website conversions generated through viral sharing of the content.<br /><br />**Field Name:** `viralExternalWebsiteConversions`<br />**Type:** metric                     |
| <div>Viral External Website Post Click Conversions</div> | External website post click conversions generated through viral sharing of the content.<br /><br />**Field Name:** `viralExternalWebsitePostClickConversions`<br />**Type:** metric |
| <div>Viral External Website Post View Conversions</div>  | External website post view conversions generated through viral sharing of the content.<br /><br />**Field Name:** `viralExternalWebsitePostViewConversions`<br />**Type:** metric   |
| <div>Viral One Click Lead Form Opens</div>               | One click lead form opens generated through viral sharing of the content.<br /><br />**Field Name:** `viralOneClickLeadFormOpens`<br />**Type:** metric                             |
| <div>Viral One Click Leads</div>                         | One click leads generated through viral sharing of the content.<br /><br />**Field Name:** `viralOneClickLeads`<br />**Type:** metric                                               |
| <div>Viral Document Completions</div>                    | Document completions generated through viral sharing of the content.<br /><br />**Field Name:** `viralDocumentCompletions`<br />**Type:** metric                                    |
| <div>Viral Document First Quartile Completions</div>     | Document first quartile completions generated through viral sharing of the content.<br /><br />**Field Name:** `viralDocumentFirstQuartileCompletions`<br />**Type:** metric        |
| <div>Viral Document Midpoint Completions</div>           | Document midpoint completions generated through viral sharing of the content.<br /><br />**Field Name:** `viralDocumentMidpointCompletions`<br />**Type:** metric                   |
| <div>Viral Document Third Quartile Completions</div>     | Document third quartile completions generated through viral sharing of the content.<br /><br />**Field Name:** `viralDocumentThirdQuartileCompletions`<br />**Type:** metric        |
| <div>Viral Download Clicks</div>                         | Download clicks generated through viral sharing of the content.<br /><br />**Field Name:** `viralDownloadClicks`<br />**Type:** metric                                              |
| <div>Viral Job Applications</div>                        | Job applications generated through viral sharing of the content.<br /><br />**Field Name:** `viralJobApplications`<br />**Type:** metric                                            |
| <div>Viral Job Apply Clicks</div>                        | Job apply clicks generated through viral sharing of the content.<br /><br />**Field Name:** `viralJobApplyClicks`<br />**Type:** metric                                             |
| <div>Viral Registrations</div>                           | Registrations generated through viral sharing of the content.<br /><br />**Field Name:** `viralRegistrations`<br />**Type:** metric                                                 |
| <div>Viral Post Click Job Applications</div>             | Post click job applications generated through viral sharing of the content.<br /><br />**Field Name:** `viralPostClickJobApplications`<br />**Type:** metric                        |
| <div>Viral Post Click Job Apply Clicks</div>             | Post click job apply clicks generated through viral sharing of the content.<br /><br />**Field Name:** `viralPostClickJobApplyClicks`<br />**Type:** metric                         |
| <div>Viral Post Click Registrations</div>                | Post click registrations generated through viral sharing of the content.<br /><br />**Field Name:** `viralPostClickRegistrations`<br />**Type:** metric                             |
| <div>Viral Post View Job Applications</div>              | Post view job applications generated through viral sharing of the content.<br /><br />**Field Name:** `viralPostViewJobApplications`<br />**Type:** metric                          |
| <div>Viral Post View Job Apply Clicks</div>              | Post view job apply clicks generated through viral sharing of the content.<br /><br />**Field Name:** `viralPostViewJobApplyClicks`<br />**Type:** metric                           |
| <div>Viral Post View Registrations</div>                 | Post view registrations generated through viral sharing of the content.<br /><br />**Field Name:** `viralPostViewRegistrations`<br />**Type:** metric                               |
| <div>Viral Card Clicks</div>                             | Card clicks generated through viral sharing of the content.<br /><br />**Field Name:** `viralCardClicks`<br />**Type:** metric                                                      |
| <div>Viral Card Impressions</div>                        | Card impressions generated through viral sharing of the content.<br /><br />**Field Name:** `viralCardImpressions`<br />**Type:** metric                                            |

***

## Related

<CardGroup>
  <Card title="Fields Catalog" icon="book" href="/fields-catalog">
    Browse all platforms
  </Card>

  <Card title="Meta Ads Fields" icon="chart-bar" href="/data-source/facebook-ads/fields">
    Meta Ads metrics & dimensions
  </Card>

  <Card title="Google Ads Fields" icon="chart-bar" href="/data-source/google-ads/fields">
    Google Ads metrics & dimensions
  </Card>

  <Card title="TikTok Ads Fields" icon="chart-bar" href="/data-source/tiktok-ads/fields">
    TikTok Ads metrics & dimensions
  </Card>
</CardGroup>


# LinkedIn Ads Troubleshooting
Source: https://support.detrics.io/data-source/linkedin-ads/troubleshooting

Complete troubleshooting guide for LinkedIn Ads integration

<Info>
  **Last updated:** July 28, 2025
</Info>

Having trouble connecting your LinkedIn Ads account to Detrics? This comprehensive guide will help you diagnose and resolve the most common connection issues.

## Understanding LinkedIn Access Expiration

Access to LinkedIn Ads can expire for various reasons. These are the most common causes of connection issues:

<CardGroup>
  <Card title="Password Changes" icon="key">
    Changing your LinkedIn password automatically revokes access tokens for
    connected third-party applications.
  </Card>

  <Card title="LinkedIn Security Reviews" icon="shield">
    LinkedIn may revoke access during routine security reviews, especially for
    recently connected applications like Detrics.
  </Card>

  <Card title="Token Expiration" icon="clock">
    Due to LinkedIn's privacy policy, access must be renewed every two months.
    This is beyond our control and unfortunately required by the platform.
  </Card>
</CardGroup>

**Solution:** When access expires, you'll need to **reconnect your LinkedIn Ads account to Detrics** through the connection setup process. This re-establishes the authentication and renews the access tokens.

**Important:** Once you reconnect LinkedIn Ads, all your existing queries and Looker Studio dashboards linked to your LinkedIn accounts will automatically start working again. The reconnection process fixes all connections at once - you don't need to recreate your queries or dashboards.

## Fix Persistent Connection Issues (Full Reset)

If reconnecting doesn't resolve your issues, follow these steps for a complete reset. This will fix all your LinkedIn Ads queries and dashboards at once.

<Steps>
  <Step title="Remove LinkedIn App Connection">
    Go to [LinkedIn Settings & Privacy](https://www.linkedin.com/mypreferences/d/data-sharing-for-permitted-services) and remove Detrics from your permitted services.

    <Frame>
      <img alt="LinkedIn Data Sharing Settings" />
    </Frame>
  </Step>

  <Step title="Open Google Sheets">
    Open a new Google Spreadsheet or [click here](https://sheets.new) to create a new sheet directly.
  </Step>

  <Step title="Launch Detrics">
    Fire up Detrics: Select *Extensions* > *Detrics* > *Launch*

    <Frame>
      <img alt="Google Sheets Extensions Menu - Detrics Launch" />
    </Frame>
  </Step>

  <Step title="Connect Data Source">
    Click on *"Connect Data Source"*

    <Frame>
      <img alt="Detrics Connect Data Source Button" />
    </Frame>
  </Step>

  <Step title="Reconnect LinkedIn Ads">
    Select LinkedIn Ads from the list of available data sources and complete the LinkedIn authentication process to re-establish access to your Campaign Manager account.

    <Frame>
      <img alt="LinkedIn Ads Reconnection" />
    </Frame>
  </Step>
</Steps>

## Shared Connection Between Google Sheets and Looker Studio

Google Sheets and Looker Studio share the same LinkedIn Ads connection. This means:

* **Single reconnection fixes both platforms:** When you reconnect LinkedIn Ads through Google Sheets, your Looker Studio dashboards are automatically fixed too
* **No duplicate setup needed:** You only need to reconnect once, regardless of which platform you primarily use

### Alternative: Reconnect Through Looker Studio

Looker Studio users can also reconnect LinkedIn Ads directly through Looker Studio:

1. Open your Looker Studio dashboard that uses LinkedIn Ads data
2. Click on any chart showing connection errors
3. Select "Reconnect" when prompted
4. Complete the LinkedIn Ads authentication process
5. All your LinkedIn Ads queries in both Looker Studio and Google Sheets will be restored

<Tip>
  **Need help?** If errors persist after following these steps, please reach out to [support@detrics.io](mailto:support@detrics.io)
</Tip>


# Magento Metrics & Dimensions
Source: https://support.detrics.io/data-source/magento-orders/fields

Complete reference for Magento dimensions and metrics

<Info>
  **Last updated:** August 6, 2026
</Info>

<div>
  <div>
    68 dimensions
  </div>

  <div>
    31 metrics
  </div>
</div>

This reference covers all available dimensions and metrics for Magento data through Detrics. Use this guide to understand what data you can extract and how to structure your queries.

<div>
  <span>Supported destinations:</span>

  <div>
    Google Sheets
  </div>

  <div>
    Claude
  </div>

  <div>
    BigQuery
  </div>
</div>

## Dimensions

Dimensions are the attributes you can use to segment and group your Magento data.

### Order

|                                   |                                                                                                                                                       |
| --------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------- |
| <div>Order Increment ID</div>     | Human-readable incrementing identifier for each order<br /><br />**Field Name:** `orderIncrementId`<br />**Type:** dimension                          |
| <div>Order Status</div>           | Current status of the order (e.g., pending, processing, complete, canceled, closed)<br /><br />**Field Name:** `orderStatus`<br />**Type:** dimension |
| <div>Order State</div>            | High-level state of the order (new, processing, complete, canceled, holded, closed)<br /><br />**Field Name:** `orderState`<br />**Type:** dimension  |
| <div>Order Currency</div>         | ISO code of the currency the customer paid in<br /><br />**Field Name:** `orderCurrency`<br />**Type:** dimension                                     |
| <div>Order Base Currency</div>    | ISO code of the store base currency used for base\_\* totals<br /><br />**Field Name:** `orderBaseCurrency`<br />**Type:** dimension                  |
| <div>Order Created Date</div>     | Date the order was created (YYYY-MM-DD, UTC)<br /><br />**Field Name:** `orderCreatedDate`<br />**Type:** dimension                                   |
| <div>Order Created Datetime</div> | Timestamp the order was created (UTC)<br /><br />**Field Name:** `orderCreatedDatetime`<br />**Type:** dimension                                      |
| <div>Order Updated Date</div>     | Date of the last order update (YYYY-MM-DD, UTC)<br /><br />**Field Name:** `orderUpdatedDate`<br />**Type:** dimension                                |
| <div>Order Updated Datetime</div> | Timestamp of the last order update (UTC)<br /><br />**Field Name:** `orderUpdatedDatetime`<br />**Type:** dimension                                   |
| <div>Payment Method</div>         | Identifier of the payment method used for the order<br /><br />**Field Name:** `paymentMethod`<br />**Type:** dimension                               |
| <div>Shipping Method</div>        | Human-readable description of the shipping method<br /><br />**Field Name:** `shippingMethod`<br />**Type:** dimension                                |
| <div>Coupon Code</div>            | Coupon or promo code applied to the order, if any<br /><br />**Field Name:** `couponCode`<br />**Type:** dimension                                    |

### Customer

|                                    |                                                                                                                                |
| ---------------------------------- | ------------------------------------------------------------------------------------------------------------------------------ |
| <div>Customer ID</div>             | Unique identifier of the customer (empty for guest checkouts)<br /><br />**Field Name:** `customerId`<br />**Type:** dimension |
| <div>Customer Group ID</div>       | Identifier of the customer group the customer belongs to<br /><br />**Field Name:** `customerGroupId`<br />**Type:** dimension |
| <div>Customer Prefix</div>         | Prefix for the customer's name (e.g., Mr., Ms.)<br /><br />**Field Name:** `customerPrefix`<br />**Type:** dimension           |
| <div>Customer First Name</div>     | First name of the customer<br /><br />**Field Name:** `customerFirstName`<br />**Type:** dimension                             |
| <div>Customer Middle Name</div>    | Middle name of the customer<br /><br />**Field Name:** `customerMiddleName`<br />**Type:** dimension                           |
| <div>Customer Last Name</div>      | Last name of the customer<br /><br />**Field Name:** `customerLastName`<br />**Type:** dimension                               |
| <div>Customer Name Suffix</div>    | Suffix for the customer's name (e.g., Jr., Sr., III)<br /><br />**Field Name:** `customerNameSuffix`<br />**Type:** dimension  |
| <div>Customer Gender</div>         | Gender of the customer (Male, Female, Not Specified)<br /><br />**Field Name:** `customerGender`<br />**Type:** dimension      |
| <div>Customer Date of Birth</div>  | Date of birth of the customer<br /><br />**Field Name:** `customerDob`<br />**Type:** dimension                                |
| <div>Customer Email</div>          | Email address of the customer<br /><br />**Field Name:** `customerEmail`<br />**Type:** dimension                              |
| <div>Customer Is Guest</div>       | Whether the order was placed as a guest checkout<br /><br />**Field Name:** `customerIsGuest`<br />**Type:** dimension         |
| <div>Customer Tax/VAT Number</div> | Tax or VAT identification number of the customer<br /><br />**Field Name:** `customerTaxVatNumber`<br />**Type:** dimension    |

### Billing Address

|                                 |                                                                                                                                   |
| ------------------------------- | --------------------------------------------------------------------------------------------------------------------------------- |
| <div>Billing First Name</div>   | First name on the billing address<br /><br />**Field Name:** `billingFirstName`<br />**Type:** dimension                          |
| <div>Billing Middle Name</div>  | Middle name on the billing address<br /><br />**Field Name:** `billingMiddleName`<br />**Type:** dimension                        |
| <div>Billing Last Name</div>    | Last name on the billing address<br /><br />**Field Name:** `billingLastName`<br />**Type:** dimension                            |
| <div>Billing Company</div>      | Company on the billing address<br /><br />**Field Name:** `billingCompany`<br />**Type:** dimension                               |
| <div>Billing Address Type</div> | Type of the billing address (usually "billing")<br /><br />**Field Name:** `billingAddressType`<br />**Type:** dimension          |
| <div>Billing Street</div>       | Street address on the billing address (multiple lines joined)<br /><br />**Field Name:** `billingStreet`<br />**Type:** dimension |
| <div>Billing City</div>         | City on the billing address<br /><br />**Field Name:** `billingCity`<br />**Type:** dimension                                     |
| <div>Billing Region</div>       | Region / state on the billing address<br /><br />**Field Name:** `billingRegion`<br />**Type:** dimension                         |
| <div>Billing Region ID</div>    | Magento numeric region identifier for the billing address<br /><br />**Field Name:** `billingRegionId`<br />**Type:** dimension   |
| <div>Billing Region Code</div>  | Region code on the billing address (e.g., CO-BOG)<br /><br />**Field Name:** `billingRegionCode`<br />**Type:** dimension         |
| <div>Billing Postal Code</div>  | Postal code on the billing address<br /><br />**Field Name:** `billingPostalCode`<br />**Type:** dimension                        |
| <div>Billing Country ID</div>   | ISO two-letter country code on the billing address<br /><br />**Field Name:** `billingCountryId`<br />**Type:** dimension         |
| <div>Billing Email</div>        | Email address on the billing address<br /><br />**Field Name:** `billingEmail`<br />**Type:** dimension                           |
| <div>Billing Telephone</div>    | Telephone number on the billing address<br /><br />**Field Name:** `billingTelephone`<br />**Type:** dimension                    |
| <div>Billing Fax</div>          | Fax number on the billing address<br /><br />**Field Name:** `billingFax`<br />**Type:** dimension                                |

### Shipping Address

|                                  |                                                                                                                                     |
| -------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------- |
| <div>Shipping First Name</div>   | First name on the shipping address<br /><br />**Field Name:** `shippingFirstName`<br />**Type:** dimension                          |
| <div>Shipping Middle Name</div>  | Middle name on the shipping address<br /><br />**Field Name:** `shippingMiddleName`<br />**Type:** dimension                        |
| <div>Shipping Last Name</div>    | Last name on the shipping address<br /><br />**Field Name:** `shippingLastName`<br />**Type:** dimension                            |
| <div>Shipping Company</div>      | Company on the shipping address<br /><br />**Field Name:** `shippingCompany`<br />**Type:** dimension                               |
| <div>Shipping Address Type</div> | Type of the shipping address (usually "shipping")<br /><br />**Field Name:** `shippingAddressType`<br />**Type:** dimension         |
| <div>Shipping Street</div>       | Street address on the shipping address (multiple lines joined)<br /><br />**Field Name:** `shippingStreet`<br />**Type:** dimension |
| <div>Shipping City</div>         | City on the shipping address<br /><br />**Field Name:** `shippingCity`<br />**Type:** dimension                                     |
| <div>Shipping Region</div>       | Region / state on the shipping address<br /><br />**Field Name:** `shippingRegion`<br />**Type:** dimension                         |
| <div>Shipping Region ID</div>    | Magento numeric region identifier for the shipping address<br /><br />**Field Name:** `shippingRegionId`<br />**Type:** dimension   |
| <div>Shipping Region Code</div>  | Region code on the shipping address (e.g., CO-BOG)<br /><br />**Field Name:** `shippingRegionCode`<br />**Type:** dimension         |
| <div>Shipping Postal Code</div>  | Postal code on the shipping address<br /><br />**Field Name:** `shippingPostalCode`<br />**Type:** dimension                        |
| <div>Shipping Country ID</div>   | ISO two-letter country code on the shipping address<br /><br />**Field Name:** `shippingCountryId`<br />**Type:** dimension         |
| <div>Shipping Email</div>        | Email address on the shipping address<br /><br />**Field Name:** `shippingEmail`<br />**Type:** dimension                           |
| <div>Shipping Telephone</div>    | Telephone number on the shipping address<br /><br />**Field Name:** `shippingTelephone`<br />**Type:** dimension                    |
| <div>Shipping Fax</div>          | Fax number on the shipping address<br /><br />**Field Name:** `shippingFax`<br />**Type:** dimension                                |

### Store

|                         |                                                                                                                                            |
| ----------------------- | ------------------------------------------------------------------------------------------------------------------------------------------ |
| <div>Store Domain</div> | Hostname of the Magento store the order was placed on<br /><br />**Field Name:** `storeDomain`<br />**Type:** dimension                    |
| <div>Store ID</div>     | Magento numeric identifier of the store view<br /><br />**Field Name:** `storeId`<br />**Type:** dimension                                 |
| <div>Store Name</div>   | Website > Store > Store View hierarchy name as configured in Magento Admin<br /><br />**Field Name:** `storeName`<br />**Type:** dimension |

### Items

|                                  |                                                                                                                                                      |
| -------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------- |
| <div>Item ID</div>               | Unique identifier of the order line item<br /><br />**Field Name:** `itemId`<br />**Type:** dimension                                                |
| <div>Item Order ID</div>         | Identifier of the order the line item belongs to<br /><br />**Field Name:** `itemOrderId`<br />**Type:** dimension                                   |
| <div>Item Quote Item ID</div>    | Identifier of the cart line item that this order item was converted from<br /><br />**Field Name:** `itemQuoteItemId`<br />**Type:** dimension       |
| <div>Item SKU</div>              | SKU of the product on the line item<br /><br />**Field Name:** `itemSku`<br />**Type:** dimension                                                    |
| <div>Product ID</div>            | Magento product ID<br /><br />**Field Name:** `productId`<br />**Type:** dimension                                                                   |
| <div>Product Name</div>          | Display name of the product<br /><br />**Field Name:** `productName`<br />**Type:** dimension                                                        |
| <div>Product Type</div>          | Type of the product (simple, configurable, bundle, grouped, virtual, downloadable)<br /><br />**Field Name:** `productType`<br />**Type:** dimension |
| <div>Item Created Date</div>     | Date the order line item was created<br /><br />**Field Name:** `itemCreatedDate`<br />**Type:** dimension                                           |
| <div>Item Created Datetime</div> | Timestamp the order line item was created<br /><br />**Field Name:** `itemCreatedDatetime`<br />**Type:** dimension                                  |
| <div>Item Updated Date</div>     | Date of the last line item update<br /><br />**Field Name:** `itemUpdatedDate`<br />**Type:** dimension                                              |
| <div>Item Updated Datetime</div> | Timestamp of the last line item update<br /><br />**Field Name:** `itemUpdatedDatetime`<br />**Type:** dimension                                     |

## Metrics

Metrics are the numerical values you can measure and analyze from your Magento campaigns.

### Order

|                                              |                                                                                                                                  |
| -------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------- |
| <div>Orders</div>                            | Total number of orders<br /><br />**Field Name:** `orders`<br />**Type:** metric                                                 |
| <div>Order Quantity</div>                    | Total quantity of items in the orders<br /><br />**Field Name:** `orderQuantity`<br />**Type:** metric                           |
| <div>Order Subtotal</div>                    | Order subtotal before tax and discounts (order currency)<br /><br />**Field Name:** `orderSubtotal`<br />**Type:** metric        |
| <div>Order Subtotal (Incl. Tax)</div>        | Order subtotal including tax (order currency)<br /><br />**Field Name:** `orderSubtotalInclTax`<br />**Type:** metric            |
| <div>Order Discount</div>                    | Total discount amount applied to the order (order currency)<br /><br />**Field Name:** `orderDiscount`<br />**Type:** metric     |
| <div>Order Tax</div>                         | Total tax amount on the order (order currency)<br /><br />**Field Name:** `orderTax`<br />**Type:** metric                       |
| <div>Order Shipping & Handling</div>         | Total shipping and handling charges (order currency)<br /><br />**Field Name:** `orderShippingAndHandling`<br />**Type:** metric |
| <div>Order Grand Total</div>                 | Final order total after adjustments (order currency)<br /><br />**Field Name:** `orderGrandTotal`<br />**Type:** metric          |
| <div>Order Grand Total (Base Currency)</div> | Final order total converted to store base currency<br /><br />**Field Name:** `orderBaseGrandTotal`<br />**Type:** metric        |
| <div>Order Total Paid</div>                  | Total amount paid on the order (order currency)<br /><br />**Field Name:** `orderTotalPaid`<br />**Type:** metric                |
| <div>Order Total Refunded</div>              | Total amount refunded on the order (order currency)<br /><br />**Field Name:** `orderTotalRefunded`<br />**Type:** metric        |
| <div>Order Total Due</div>                   | Amount still due on the order (order currency)<br /><br />**Field Name:** `orderTotalDue`<br />**Type:** metric                  |
| <div>Order Weight</div>                      | Total weight of the order<br /><br />**Field Name:** `orderWeight`<br />**Type:** metric                                         |

### Customer

|                      |                                                                                                    |
| -------------------- | -------------------------------------------------------------------------------------------------- |
| <div>Customers</div> | Count of customers on returned orders<br /><br />**Field Name:** `customers`<br />**Type:** metric |

### Items

|                                                    |                                                                                                                                                                     |
| -------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| <div>Item Original Price</div>                     | Original unit price before discounts (order currency)<br /><br />**Field Name:** `itemOriginalPrice`<br />**Type:** metric                                          |
| <div>Item Price</div>                              | Unit price of the item after discounts (order currency)<br /><br />**Field Name:** `itemPrice`<br />**Type:** metric                                                |
| <div>Item Quantity Ordered</div>                   | Quantity of the item ordered<br /><br />**Field Name:** `itemQuantityOrdered`<br />**Type:** metric                                                                 |
| <div>Item Quantity Invoiced</div>                  | Quantity of the item invoiced<br /><br />**Field Name:** `itemQuantityInvoiced`<br />**Type:** metric                                                               |
| <div>Item Quantity Shipped</div>                   | Quantity of the item shipped<br /><br />**Field Name:** `itemQuantityShipped`<br />**Type:** metric                                                                 |
| <div>Item Quantity Refunded</div>                  | Quantity of the item refunded<br /><br />**Field Name:** `itemQuantityRefunded`<br />**Type:** metric                                                               |
| <div>Item Quantity Returned</div>                  | Quantity of the item physically returned by the customer<br /><br />**Field Name:** `itemQuantityReturned`<br />**Type:** metric                                    |
| <div>Item Quantity Canceled</div>                  | Quantity of the item canceled<br /><br />**Field Name:** `itemQuantityCanceled`<br />**Type:** metric                                                               |
| <div>Item Subtotal</div>                           | Row subtotal for the item before tax and discounts<br /><br />**Field Name:** `itemSubtotal`<br />**Type:** metric                                                  |
| <div>Item Tax Amount</div>                         | Tax amount applied to the item row<br /><br />**Field Name:** `itemTaxAmount`<br />**Type:** metric                                                                 |
| <div>Item Tax Percent</div>                        | Tax percentage applied to the item<br /><br />**Field Name:** `itemTaxPercent`<br />**Type:** metric                                                                |
| <div>Item Tax Canceled</div>                       | Tax amount canceled on the item (when parts of the order are canceled)<br /><br />**Field Name:** `itemTaxCanceled`<br />**Type:** metric                           |
| <div>Item Discount Amount</div>                    | Discount amount applied to the item row<br /><br />**Field Name:** `itemDiscountAmount`<br />**Type:** metric                                                       |
| <div>Item Discount Tax Compensation Canceled</div> | Discount tax compensation amount canceled on the item (Magento tax rollback)<br /><br />**Field Name:** `itemDiscountTaxCompensationCanceled`<br />**Type:** metric |
| <div>Item Total</div>                              | Final total for the item row after tax and discounts<br /><br />**Field Name:** `itemTotal`<br />**Type:** metric                                                   |
| <div>Item Refund Amount</div>                      | Amount refunded on the item row<br /><br />**Field Name:** `itemRefundAmount`<br />**Type:** metric                                                                 |
| <div>Item Weight</div>                             | Weight of a single unit of the item<br /><br />**Field Name:** `itemWeight`<br />**Type:** metric                                                                   |

***

## Related

<CardGroup>
  <Card title="Fields Catalog" icon="book" href="/fields-catalog">
    Browse all platforms
  </Card>

  <Card title="shopify-store Fields" icon="chart-bar" href="/data-source/shopify-store/fields">
    shopify-store metrics & dimensions
  </Card>

  <Card title="WooCommerce Fields" icon="chart-bar" href="/data-source/woocommerce/fields">
    WooCommerce metrics & dimensions
  </Card>

  <Card title="vtex-store Fields" icon="chart-bar" href="/data-source/vtex-store/fields">
    vtex-store metrics & dimensions
  </Card>
</CardGroup>


# Mailchimp Metrics & Dimensions
Source: https://support.detrics.io/data-source/mailchimp/fields

Complete reference for Mailchimp email marketing dimensions and metrics

<Info>
  **Last updated:** August 6, 2026
</Info>

<div>
  <div>
    24 dimensions
  </div>

  <div>
    56 metrics
  </div>
</div>

This reference covers all available dimensions and metrics for Mailchimp data through Detrics. Use this guide to understand what data you can extract and how to structure your queries.

<div>
  <span>Supported destinations:</span>

  <div>
    Google Sheets
  </div>

  <div>
    Claude
  </div>

  <div>
    BigQuery
  </div>
</div>

## Dimensions

Dimensions are the attributes you can use to segment and group your Mailchimp data.

### Campaign

|                                |                                                                                                                             |
| ------------------------------ | --------------------------------------------------------------------------------------------------------------------------- |
| <div>Campaign ID</div>         | The unique identifier for the email campaign<br /><br />**Field Name:** `campaignId`<br />**Type:** dimension               |
| <div>Campaign Name</div>       | The name/title of the email campaign<br /><br />**Field Name:** `campaignName`<br />**Type:** dimension                     |
| <div>Campaign Type</div>       | The type of campaign (e.g., regular, plaintext, absplit)<br /><br />**Field Name:** `campaignType`<br />**Type:** dimension |
| <div>Campaign Status</div>     | The current status of the campaign (e.g., sent, draft)<br /><br />**Field Name:** `campaignStatus`<br />**Type:** dimension |
| <div>Campaign Created</div>    | The date the campaign was created<br /><br />**Field Name:** `campaignCreatedDate`<br />**Type:** dimension                 |
| <div>Campaign Send Date</div>  | The date the campaign was sent<br /><br />**Field Name:** `campaignSendDate`<br />**Type:** dimension                       |
| <div>Campaign Last Open</div>  | The date of the last email open for the campaign<br /><br />**Field Name:** `campaignLastOpen`<br />**Type:** dimension     |
| <div>Campaign Last Click</div> | The date of the last link click for the campaign<br /><br />**Field Name:** `campaignLastClick`<br />**Type:** dimension    |

### Email Content

|                         |                                                                                                                        |
| ----------------------- | ---------------------------------------------------------------------------------------------------------------------- |
| <div>Subject Line</div> | The email subject line<br /><br />**Field Name:** `subjectLine`<br />**Type:** dimension                               |
| <div>Preview Text</div> | The email preview text shown in inbox<br /><br />**Field Name:** `previewText`<br />**Type:** dimension                |
| <div>From Name</div>    | The sender display name<br /><br />**Field Name:** `fromName`<br />**Type:** dimension                                 |
| <div>Reply To</div>     | The reply-to email address<br /><br />**Field Name:** `replyTo`<br />**Type:** dimension                               |
| <div>Content Type</div> | The content type of the email (e.g., template, html)<br /><br />**Field Name:** `contentType`<br />**Type:** dimension |

### List

|                                   |                                                                                                                                               |
| --------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------- |
| <div>List ID</div>                | The unique identifier for the audience/list (shared between campaigns and lists)<br /><br />**Field Name:** `listId`<br />**Type:** dimension |
| <div>List Name</div>              | The name of the audience/list (shared between campaigns and lists)<br /><br />**Field Name:** `listName`<br />**Type:** dimension             |
| <div>List Rating</div>            | The list quality rating from Mailchimp (1-5)<br /><br />**Field Name:** `listRating`<br />**Type:** dimension                                 |
| <div>List Visibility</div>        | The list visibility setting (pub or prv)<br /><br />**Field Name:** `listVisibility`<br />**Type:** dimension                                 |
| <div>List Created</div>           | The date the list was created<br /><br />**Field Name:** `listCreatedDate`<br />**Type:** dimension                                           |
| <div>Last List Subscribed</div>   | The date of the most recent subscription to the list<br /><br />**Field Name:** `listLastSubDate`<br />**Type:** dimension                    |
| <div>Last List Unsubscribed</div> | The date of the most recent unsubscription from the list<br /><br />**Field Name:** `listLastUnsubDate`<br />**Type:** dimension              |

### List Growth

|                      |                                                                                                                         |
| -------------------- | ----------------------------------------------------------------------------------------------------------------------- |
| <div>List ID</div>   | The list ID for the growth history record<br /><br />**Field Name:** `growthListId`<br />**Type:** dimension            |
| <div>List Name</div> | The list name for the growth history record<br /><br />**Field Name:** `growthListName`<br />**Type:** dimension        |
| <div>Month</div>     | The month of the growth history data (YYYY-MM format)<br /><br />**Field Name:** `growthMonth`<br />**Type:** dimension |

### Industry Benchmarks

|                          |                                                                                                                    |
| ------------------------ | ------------------------------------------------------------------------------------------------------------------ |
| <div>Industry Type</div> | The industry type used for benchmark comparison<br /><br />**Field Name:** `industryType`<br />**Type:** dimension |

## Metrics

Metrics are the numerical values you can measure and analyze from your Mailchimp campaigns.

### Delivery

|                             |                                                                                                                                |
| --------------------------- | ------------------------------------------------------------------------------------------------------------------------------ |
| <div>Emails Sent</div>      | Total number of emails sent for the campaign<br /><br />**Field Name:** `emailsSent`<br />**Type:** metric                     |
| <div>Emails Delivered</div> | Number of emails delivered (sent minus bounces)<br /><br />**Field Name:** `emailsDelivered`<br />**Type:** metric             |
| <div>Emails Cancelled</div> | Number of emails cancelled before delivery<br /><br />**Field Name:** `emailsCancelled`<br />**Type:** metric                  |
| <div>Delivery Rate</div>    | Percentage of emails successfully delivered (delivered / sent)<br /><br />**Field Name:** `deliveryRate`<br />**Type:** metric |

### Engagement

|                                     |                                                                                                                                      |
| ----------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------ |
| <div>Unique Opens</div>             | Number of unique recipients who opened the email<br /><br />**Field Name:** `uniqueOpens`<br />**Type:** metric                      |
| <div>Total Opens</div>              | Total number of email opens (includes multiple opens per person)<br /><br />**Field Name:** `opensTotal`<br />**Type:** metric       |
| <div>Open Rate</div>                | Percentage of recipients who opened the email (unique opens / delivered)<br /><br />**Field Name:** `openRate`<br />**Type:** metric |
| <div>Unique Clicks</div>            | Number of unique recipients who clicked a link<br /><br />**Field Name:** `uniqueClicks`<br />**Type:** metric                       |
| <div>Total Clicks</div>             | Total number of clicks on links in the email<br /><br />**Field Name:** `clicksTotal`<br />**Type:** metric                          |
| <div>Unique Subscriber Clicks</div> | Number of unique subscribers who clicked<br /><br />**Field Name:** `uniqueSubscriberClicks`<br />**Type:** metric                   |
| <div>Click Rate</div>               | Percentage of recipients who clicked (unique clicks / delivered)<br /><br />**Field Name:** `clickRate`<br />**Type:** metric        |

### Bounces

|                             |                                                                                                                    |
| --------------------------- | ------------------------------------------------------------------------------------------------------------------ |
| <div>Bounces</div>          | Total number of bounced emails (hard + soft)<br /><br />**Field Name:** `bounces`<br />**Type:** metric            |
| <div>Hard Bounces</div>     | Number of permanent delivery failures<br /><br />**Field Name:** `hardBounces`<br />**Type:** metric               |
| <div>Soft Bounces</div>     | Number of temporary delivery failures<br /><br />**Field Name:** `softBounces`<br />**Type:** metric               |
| <div>Syntax Errors</div>    | Number of emails with address syntax errors<br /><br />**Field Name:** `syntaxErrors`<br />**Type:** metric        |
| <div>Bounce Rate</div>      | Percentage of emails that bounced (bounces / sent)<br /><br />**Field Name:** `bounceRate`<br />**Type:** metric   |
| <div>Hard Bounce Rate</div> | Percentage of hard bounces (hard bounces / sent)<br /><br />**Field Name:** `hardBounceRate`<br />**Type:** metric |
| <div>Soft Bounce Rate</div> | Percentage of soft bounces (soft bounces / sent)<br /><br />**Field Name:** `softBounceRate`<br />**Type:** metric |

### Unsubscribe & Spam

|                                |                                                                                                                                       |
| ------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------- |
| <div>Abuse Reports</div>       | Number of spam/abuse reports received<br /><br />**Field Name:** `abuseReports`<br />**Type:** metric                                 |
| <div>Unsubscribes</div>        | Number of recipients who unsubscribed<br /><br />**Field Name:** `unsubscribes`<br />**Type:** metric                                 |
| <div>Unsubscription Rate</div> | Percentage of recipients who unsubscribed (unsubscribes / sent)<br /><br />**Field Name:** `unsubscriptionRate`<br />**Type:** metric |

### Forwards & Social

|                            |                                                                                                             |
| -------------------------- | ----------------------------------------------------------------------------------------------------------- |
| <div>Forwards</div>        | Number of times the email was forwarded<br /><br />**Field Name:** `forwardsCount`<br />**Type:** metric    |
| <div>Forward Opens</div>   | Number of opens from forwarded emails<br /><br />**Field Name:** `forwardsOpens`<br />**Type:** metric      |
| <div>Facebook Likes</div>  | Number of Facebook likes from the campaign<br /><br />**Field Name:** `facebookLikes`<br />**Type:** metric |
| <div>Unique Likes</div>    | Number of unique Facebook likes<br /><br />**Field Name:** `uniqueLikes`<br />**Type:** metric              |
| <div>Recipient Likes</div> | Number of likes from email recipients<br /><br />**Field Name:** `recipientLikes`<br />**Type:** metric     |

### E-commerce

|                          |                                                                                                                           |
| ------------------------ | ------------------------------------------------------------------------------------------------------------------------- |
| <div>Total Orders</div>  | Total number of orders attributed to the campaign<br /><br />**Field Name:** `ecommerceTotalOrders`<br />**Type:** metric |
| <div>Total Spent</div>   | Total amount spent by customers from the campaign<br /><br />**Field Name:** `ecommerceTotalSpent`<br />**Type:** metric  |
| <div>Total Revenue</div> | Total revenue attributed to the campaign<br /><br />**Field Name:** `ecommerceTotalRevenue`<br />**Type:** metric         |

### Industry Benchmarks

|                                         |                                                                                                                    |
| --------------------------------------- | ------------------------------------------------------------------------------------------------------------------ |
| <div>Industry Open Rate</div>           | Average open rate for this industry<br /><br />**Field Name:** `industryOpenRate`<br />**Type:** metric            |
| <div>Industry Click Rate</div>          | Average click rate for this industry<br /><br />**Field Name:** `industryClickRate`<br />**Type:** metric          |
| <div>Industry Bounce Rate</div>         | Average bounce rate for this industry<br /><br />**Field Name:** `industryBounceRate`<br />**Type:** metric        |
| <div>Industry Unopen Rate</div>         | Average unopen rate for this industry<br /><br />**Field Name:** `industryUnopenRate`<br />**Type:** metric        |
| <div>Industry Unsubscription Rate</div> | Average unsubscription rate for this industry<br /><br />**Field Name:** `industryUnsubRate`<br />**Type:** metric |
| <div>Industry Abuse Report Rate</div>   | Average abuse report rate for this industry<br /><br />**Field Name:** `industryAbuseRate`<br />**Type:** metric   |

### List Stats

|                                              |                                                                                                                                      |
| -------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------ |
| <div>Member Count</div>                      | Total number of active members in the list<br /><br />**Field Name:** `memberCount`<br />**Type:** metric                            |
| <div>Member Count Since Last Send</div>      | Number of new members since the last campaign was sent<br /><br />**Field Name:** `memberCountSinceSend`<br />**Type:** metric       |
| <div>Cleaned Count</div>                     | Total number of cleaned (removed) contacts in the list<br /><br />**Field Name:** `cleanedCount`<br />**Type:** metric               |
| <div>Cleaned Count Since Last Send</div>     | Number of contacts cleaned since the last campaign was sent<br /><br />**Field Name:** `cleanedCountSinceSend`<br />**Type:** metric |
| <div>List Unsubscribe Count</div>            | Total number of unsubscribes from the list<br /><br />**Field Name:** `listUnsubscribeCount`<br />**Type:** metric                   |
| <div>Unsubscribe Count Since Last Send</div> | Number of unsubscribes since the last campaign was sent<br /><br />**Field Name:** `unsubscribeCountSinceSend`<br />**Type:** metric |
| <div>Campaign Count</div>                    | Number of campaigns sent to this list<br /><br />**Field Name:** `campaignCount`<br />**Type:** metric                               |
| <div>List Open Rate</div>                    | Average open rate for campaigns sent to this list<br /><br />**Field Name:** `listOpenRate`<br />**Type:** metric                    |
| <div>List Click Rate</div>                   | Average click rate for campaigns sent to this list<br /><br />**Field Name:** `listClickRate`<br />**Type:** metric                  |
| <div>List Subscription Rate</div>            | Average subscription rate for the list<br /><br />**Field Name:** `listAvgSubRate`<br />**Type:** metric                             |
| <div>List Unsubscription Rate</div>          | Average unsubscription rate for the list<br /><br />**Field Name:** `listAvgUnsubRate`<br />**Type:** metric                         |
| <div>Target Subscription Rate</div>          | Target subscription rate for the list<br /><br />**Field Name:** `listTargetSubRate`<br />**Type:** metric                           |

### List Growth

|                                      |                                                                                                                        |
| ------------------------------------ | ---------------------------------------------------------------------------------------------------------------------- |
| <div>Opt-in Members</div>            | Number of members who opted in during this month<br /><br />**Field Name:** `optins`<br />**Type:** metric             |
| <div>Imported Members</div>          | Number of members imported during this month<br /><br />**Field Name:** `imports`<br />**Type:** metric                |
| <div>Subscribed Members</div>        | Total subscribed members at the end of this month<br /><br />**Field Name:** `subscribed`<br />**Type:** metric        |
| <div>Unsubscribed Members</div>      | Number of members who unsubscribed during this month<br /><br />**Field Name:** `unsubscribed`<br />**Type:** metric   |
| <div>Reconfirmed Members</div>       | Number of members who reconfirmed during this month<br /><br />**Field Name:** `reconfirmed`<br />**Type:** metric     |
| <div>Cleaned Members</div>           | Number of members cleaned (removed) during this month<br /><br />**Field Name:** `cleaned`<br />**Type:** metric       |
| <div>Pending Members</div>           | Number of members pending confirmation during this month<br /><br />**Field Name:** `pending`<br />**Type:** metric    |
| <div>Deleted Members</div>           | Number of members deleted during this month<br /><br />**Field Name:** `deleted`<br />**Type:** metric                 |
| <div>Transactional Subscribers</div> | Number of transactional subscribers during this month<br /><br />**Field Name:** `transactional`<br />**Type:** metric |

***

## Related

<CardGroup>
  <Card title="Fields Catalog" icon="book" href="/fields-catalog">
    Browse all platforms
  </Card>

  <Card title="Klaviyo Fields" icon="chart-bar" href="/data-source/klaviyo/fields">
    Klaviyo metrics & dimensions
  </Card>

  <Card title="HubSpot Fields" icon="chart-bar" href="/data-source/hubspot/fields">
    HubSpot metrics & dimensions
  </Card>

  <Card title="Google Merchant Center Fields" icon="chart-bar" href="/data-source/google-merchant-center/fields">
    Google Merchant Center metrics & dimensions
  </Card>
</CardGroup>


# Mercado Ads Metrics & Dimensions
Source: https://support.detrics.io/data-source/mercado-ads/fields

Complete reference for Mercado Ads dimensions and metrics

<Info>
  **Last updated:** August 6, 2026
</Info>

<div>
  <div>
    64 dimensions
  </div>

  <div>
    60 metrics
  </div>
</div>

This reference covers all available dimensions and metrics for Mercado Ads data through Detrics. Use this guide to understand what data you can extract and how to structure your queries.

<div>
  <span>Supported destinations:</span>

  <div>
    Google Sheets
  </div>

  <div>
    Claude
  </div>

  <div>
    BigQuery
  </div>
</div>

## Dimensions

Dimensions are the attributes you can use to segment and group your Mercado Ads data.

### Most Used

|                            |                                                                                                                                                          |
| -------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------- |
| <div>Advertiser ID</div>   | Unique identifier of the advertiser who invests budget to create and distribute ads.<br /><br />**Field Name:** `advertiser_id`<br />**Type:** dimension |
| <div>Advertiser Name</div> | Name of the advertiser account.<br /><br />**Field Name:** `advertiser_name`<br />**Type:** dimension                                                    |
| <div>Campaign ID</div>     | Unique identifier for the advertising campaign.<br /><br />**Field Name:** `campaign_id`<br />**Type:** dimension                                        |
| <div>Campaign Name</div>   | Name assigned to the advertising campaign.<br /><br />**Field Name:** `campaign_name`<br />**Type:** dimension                                           |
| <div>Ad Type</div>         | Type of advertisement format being used: Brand Ads, Product Ads & Display Ads<br /><br />**Field Name:** `ad_type`<br />**Type:** dimension              |

### Common Dimensions

|                              |                                                                                                                                                                             |
| ---------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| <div>Site ID</div>           | Country identifier (e.g., MLB for Brazil, MLM for Mexico, MLA for Argentina).<br /><br />**Field Name:** `site_id`<br />**Type:** dimension                                 |
| <div>Country Name</div>      | Name of the country where the campaign is running.<br /><br />**Field Name:** `country_name`<br />**Type:** dimension                                                       |
| <div>Campaign Currency</div> | Currency used for the campaign budget and costs.<br /><br />**Field Name:** `campaign_currency`<br />**Type:** dimension                                                    |
| <div>Campaign Status</div>   | Current state of the campaign. Values: active, paused, disabled.<br /><br />**Field Name:** `campaign_status`<br />**Type:** dimension                                      |
| <div>Campaign Budget</div>   | Daily budget allocated for the campaign. Unused budget rolls over to following days within the month.<br /><br />**Field Name:** `campaign_budget`<br />**Type:** dimension |

### Product Ads

|                                            |                                                                                                                                                                                          |
| ------------------------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| <div>Campaign Strategy</div>               | Campaign objective strategy. Values: PROFITABILITY (5-15% ACOS), INCREASE (15-30% ACOS), VISIBILITY (>30% ACOS).<br /><br />**Field Name:** `campaign_strategy`<br />**Type:** dimension |
| <div>Campaign Channel</div>                | Sales channel for the campaign. Values: marketplace (Mercado Libre), mshops (Mercado Shops).<br /><br />**Field Name:** `campaign_channel`<br />**Type:** dimension                      |
| <div>Campaign ACOS Target</div>            | Target Advertising Cost of Sales percentage. Algorithm uses this to optimize bidding and budget allocation.<br /><br />**Field Name:** `campaign_acos_target`<br />**Type:** dimension   |
| <div>Campaign ACOS Top Search Target</div> | Target ACOS specifically for top search positions.<br /><br />**Field Name:** `campaign_acos_top_search_target`<br />**Type:** dimension                                                 |
| <div>Campaign Salesforce Event ID</div>    | <br /><br />**Field Name:** `campaign_salesforce_event_id`<br />**Type:** dimension                                                                                                      |
| <div>Campaign Automatic Budget</div>       | Indicates if the campaign uses automatic budget management.<br /><br />**Field Name:** `campaign_automatic_budget`<br />**Type:** dimension                                              |
| <div>Campaign Last Updated</div>           | Date and time when the campaign was last modified.<br /><br />**Field Name:** `campaign_last_updated`<br />**Type:** dimension                                                           |
| <div>Campaign Date Created</div>           | Date and time when the campaign was created.<br /><br />**Field Name:** `campaign_date_created`<br />**Type:** dimension                                                                 |

### Brand Ads

|                                       |                                                                                                                                                              |
| ------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| <div>Campaign Type</div>              | Type of Brand Ads campaign. Values: custom (user-managed), automatic (platform-managed).<br /><br />**Field Name:** `campaign_type`<br />**Type:** dimension |
| <div>Campaign Headline</div>          | Title or tagline displayed in the Brand Ads advertising space.<br /><br />**Field Name:** `campaign_headline`<br />**Type:** dimension                       |
| <div>Campaign End Date</div>          | Date when the campaign is scheduled to end.<br /><br />**Field Name:** `campaign_end_date`<br />**Type:** dimension                                          |
| <div>Campaign Moderation Status</div> | Review status of the campaign content.<br /><br />**Field Name:** `campaign_moderation_status`<br />**Type:** dimension                                      |

### Display Ads

|                                |                                                                                                                                                   |
| ------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------- |
| <div>Campaign Goal</div>       | Campaign objective. Values: awareness, consideration, conversion, guaranteed.<br /><br />**Field Name:** `campaign_goal`<br />**Type:** dimension |
| <div>Campaign Start Date</div> | Date when the campaign begins running.<br /><br />**Field Name:** `campaign_start_date`<br />**Type:** dimension                                  |

### Product

|                                      |                                                                                                                                                                                 |
| ------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| <div>Product Item ID</div>           | Unique identifier of the product item.<br /><br />**Field Name:** `product_item_id`<br />**Type:** dimension                                                                    |
| <div>Product Title</div>             | Name or title of the advertised product.<br /><br />**Field Name:** `product_title`<br />**Type:** dimension                                                                    |
| <div>Product Price</div>             | Current selling price of the product.<br /><br />**Field Name:** `product_price`<br />**Type:** dimension                                                                       |
| <div>Product Thumbnail</div>         | Image Thumbnail IMAGE sheets formula<br /><br />**Field Name:** `product_thumbnail`<br />**Type:** dimension                                                                    |
| <div>Product Thumbnail URL</div>     | URL of the product thumbnail image.<br /><br />**Field Name:** `product_thumbnail_url`<br />**Type:** dimension                                                                 |
| <div>Product Status</div>            | Current status of the product listing. Values: active, paused, hold, idle, delegated, revoked.<br /><br />**Field Name:** `product_status`<br />**Type:** dimension             |
| <div>Product Permalink</div>         | Permanent URL link to the product listing page.<br /><br />**Field Name:** `product_permalink`<br />**Type:** dimension                                                         |
| <div>Product Brand Value ID</div>    | Unique identifier of the product brand.<br /><br />**Field Name:** `product_brand_value_id`<br />**Type:** dimension                                                            |
| <div>Product Brand Value Name</div>  | Brand name associated with the product.<br /><br />**Field Name:** `product_brand_value_name`<br />**Type:** dimension                                                          |
| <div>Product Condition</div>         | Condition of the product. Values: new, used.<br /><br />**Field Name:** `product_condition`<br />**Type:** dimension                                                            |
| <div>Product Tags</div>              | Tags or labels associated with the product.<br /><br />**Field Name:** `product_tags`<br />**Type:** dimension                                                                  |
| <div>Product Has Discount</div>      | Indicates if the product has an active discount. Based on difference between regular and sale price.<br /><br />**Field Name:** `product_has_discount`<br />**Type:** dimension |
| <div>Product Catalog Listing</div>   | Indicates if the product is part of the catalog listing.<br /><br />**Field Name:** `product_catalog_listing`<br />**Type:** dimension                                          |
| <div>Product Logistic Type</div>     | Type of shipping logistics for the product.<br /><br />**Field Name:** `product_logistic_type`<br />**Type:** dimension                                                         |
| <div>Product Listing Type ID</div>   | Type of product listing (e.g., gold\_pro, gold\_special).<br /><br />**Field Name:** `product_listing_type_id`<br />**Type:** dimension                                         |
| <div>Product Domain ID</div>         | Product category domain identifier.<br /><br />**Field Name:** `product_domain_id`<br />**Type:** dimension                                                                     |
| <div>Product Buy Box Winner</div>    | Indicates if the product wins the catalog buy box. Prioritized in catalog competition.<br /><br />**Field Name:** `product_buy_box_winner`<br />**Type:** dimension             |
| <div>Product Channel</div>           | Sales channel for the product. Values: marketplace, mshops.<br /><br />**Field Name:** `product_channel`<br />**Type:** dimension                                               |
| <div>Product Official Store ID</div> | Identifier of the official store selling the product.<br /><br />**Field Name:** `product_official_store_id`<br />**Type:** dimension                                           |
| <div>Product Current Level</div>     | Seller reputation level for the product.<br /><br />**Field Name:** `product_current_level`<br />**Type:** dimension                                                            |
| <div>Product Deferred Stock</div>    | Indicates if product has manufacturing time. Products with immediate stock are prioritized.<br /><br />**Field Name:** `product_deferred_stock`<br />**Type:** dimension        |
| <div>Product User Product ID</div>   | <br /><br />**Field Name:** `product_user_product_id`<br />**Type:** dimension                                                                                                  |
| <div>Product User Product Name</div> | <br /><br />**Field Name:** `product_user_product_name`<br />**Type:** dimension                                                                                                |
| <div>Product Recommended</div>       | Product Ads recommendation flag. Indicates good performance potential if advertising is activated.<br /><br />**Field Name:** `product_recommended`<br />**Type:** dimension    |
| <div>Product Date Created</div>      | Date when the product listing was created.<br /><br />**Field Name:** `product_date_created`<br />**Type:** dimension                                                           |

### Keyword

|                                 |                                                                                                                                                               |
| ------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| <div>Keyword Term</div>         | Search term or keyword phrase used for campaign targeting.<br /><br />**Field Name:** `keyword_term`<br />**Type:** dimension                                 |
| <div>Keyword Type</div>         | Type of keyword. Values: custom (user-defined), suggested (platform-recommended).<br /><br />**Field Name:** `keyword_type`<br />**Type:** dimension          |
| <div>Keyword Match Type</div>   | How closely the search query must match the keyword. Values: phrase, exact, broad.<br /><br />**Field Name:** `keyword_match_type`<br />**Type:** dimension   |
| <div>Keyword Is Negative</div>  | Indicates if keyword is negative (campaign won't show for this keyword).<br /><br />**Field Name:** `keyword_is_negative`<br />**Type:** dimension            |
| <div>Keyword Goal CPC Max</div> | Maximum cost-per-click bid for the keyword. Falls back to campaign CPC if not set.<br /><br />**Field Name:** `keyword_goal_cpc_max`<br />**Type:** dimension |
| <div>Keyword Is Deleted</div>   | Indicates if the keyword has been deleted from the campaign.<br /><br />**Field Name:** `keyword_is_deleted`<br />**Type:** dimension                         |

### Line Item

|                                 |                                                                                                                                                                   |
| ------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| <div>Line Item ID</div>         | Unique identifier for the line item within a campaign.<br /><br />**Field Name:** `line_item_id`<br />**Type:** dimension                                         |
| <div>Line Item Name</div>       | Name of the line item configuration.<br /><br />**Field Name:** `line_item_name`<br />**Type:** dimension                                                         |
| <div>Line Item Status</div>     | Current status of the line item. Values: active, paused.<br /><br />**Field Name:** `line_item_status`<br />**Type:** dimension                                   |
| <div>Line Item Type</div>       | Type based on creative format. Values: Display, Social (vertical video), Video (horizontal).<br /><br />**Field Name:** `line_item_type`<br />**Type:** dimension |
| <div>Line Item Start Date</div> | Date when the line item begins running.<br /><br />**Field Name:** `line_item_start_date`<br />**Type:** dimension                                                |
| <div>Line Item End Date</div>   | Date when the line item stops running.<br /><br />**Field Name:** `line_item_end_date`<br />**Type:** dimension                                                   |

### Creative

|                            |                                                                                                                                           |
| -------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------- |
| <div>Creative ID</div>     | Unique identifier for the creative asset.<br /><br />**Field Name:** `creative_id`<br />**Type:** dimension                               |
| <div>Creative Name</div>   | Name of the creative element.<br /><br />**Field Name:** `creative_name`<br />**Type:** dimension                                         |
| <div>Creative Status</div> | Review status of the creative. Values: active, in review, rejected.<br /><br />**Field Name:** `creative_status`<br />**Type:** dimension |

## Metrics

Metrics are the numerical values you can measure and analyze from your Mercado Ads campaigns.

### Most Used

|                        |                                                                                                                                                                        |
| ---------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| <div>Cost</div>        | Total amount spent on advertising. Also referred to as consumed budget or investment.<br /><br />**Field Name:** `cost`<br />**Type:** metric                          |
| <div>Clicks</div>      | Number of times users clicked on your ads.<br /><br />**Field Name:** `clicks`<br />**Type:** metric                                                                   |
| <div>Impressions</div> | Number of times your ads were displayed to users.<br /><br />**Field Name:** `impressions`<br />**Type:** metric                                                       |
| <div>CPC</div>         | Cost Per Click - average amount paid for each click. Formula: cost / clicks.<br /><br />**Field Name:** `cpc`<br />**Type:** metric                                    |
| <div>CTR</div>         | Click-Through Rate - percentage of impressions that resulted in clicks. Formula: (clicks / impressions) \* 100.<br /><br />**Field Name:** `ctr`<br />**Type:** metric |
| <div>CVR</div>         | Conversion Rate - percentage of clicks that resulted in conversions. Formula: (conversions / clicks) \* 100.<br /><br />**Field Name:** `cvr`<br />**Type:** metric    |
| <div>ACOS</div>        | Advertising Cost of Sales - advertising spend as percentage of revenue. Formula: (cost / revenue) \* 100.<br /><br />**Field Name:** `acos`<br />**Type:** metric      |

### Product Ads

|                                             |                                                                                                                                                                                                                                                                               |
| ------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| <div>TACoS</div>                            | Total Advertising Cost of Sales - ad spend as a percentage of TOTAL revenue (organic + ad-attributed). Formula: (cost / total revenue) \* 100. Unlike ACoS, which only uses ad-attributed revenue. Product Ads only.<br /><br />**Field Name:** `tacos`<br />**Type:** metric |
| <div>Direct Amount</div>                    | Revenue from direct sales attributed to your Product Ads.<br /><br />**Field Name:** `direct_amount`<br />**Type:** metric                                                                                                                                                    |
| <div>Indirect Amount</div>                  | Revenue from indirect/assisted sales influenced by your ads.<br /><br />**Field Name:** `indirect_amount`<br />**Type:** metric                                                                                                                                               |
| <div>Total Amount</div>                     | Total revenue from all sales attributed to your Product Ads (direct + indirect).<br /><br />**Field Name:** `total_amount`<br />**Type:** metric                                                                                                                              |
| <div>Direct Units Quantity</div>            | Number of units sold in direct sales from advertising.<br /><br />**Field Name:** `direct_units_quantity`<br />**Type:** metric                                                                                                                                               |
| <div>Indirect Units Quantity</div>          | Number of units sold in indirect/assisted sales from advertising.<br /><br />**Field Name:** `indirect_units_quantity`<br />**Type:** metric                                                                                                                                  |
| <div>Units Quantity</div>                   | Total units sold attributed to your ads across all purchases.<br /><br />**Field Name:** `units_quantity`<br />**Type:** metric                                                                                                                                               |
| <div>Direct Items Quantity</div>            | Number of direct sales transactions from advertising.<br /><br />**Field Name:** `direct_items_quantity`<br />**Type:** metric                                                                                                                                                |
| <div>Indirect Items Quantity</div>          | Number of indirect/assisted sales transactions from advertising.<br /><br />**Field Name:** `indirect_items_quantity`<br />**Type:** metric                                                                                                                                   |
| <div>Advertising Items Quantity</div>       | Total number of sales transactions attributed to advertising.<br /><br />**Field Name:** `advertising_items_quantity`<br />**Type:** metric                                                                                                                                   |
| <div>Organic Units Quantity</div>           | Number of units sold without advertising (organic sales).<br /><br />**Field Name:** `organic_units_quantity`<br />**Type:** metric                                                                                                                                           |
| <div>Organic Items Quantity</div>           | Number of sales transactions without advertising (organic sales).<br /><br />**Field Name:** `organic_items_quantity`<br />**Type:** metric                                                                                                                                   |
| <div>Organic Units Amount</div>             | Revenue from sales without advertising (organic revenue).<br /><br />**Field Name:** `organic_units_amount`<br />**Type:** metric                                                                                                                                             |
| <div>ROAS</div>                             | Return on Ad Spend - revenue generated per unit of ad spend. Formula: revenue / cost.<br /><br />**Field Name:** `roas`<br />**Type:** metric                                                                                                                                 |
| <div>SOV</div>                              | Share of Voice - percentage of advertising sales over total sales.<br /><br />**Field Name:** `sov`<br />**Type:** metric                                                                                                                                                     |
| <div>Impression Share</div>                 | Percentage of impressions won out of total eligible impressions. Shows how often your ads appeared.<br /><br />**Field Name:** `impression_share`<br />**Type:** metric                                                                                                       |
| <div>Top Impression Share</div>             | Percentage of auctions won in top search positions out of total eligible auctions.<br /><br />**Field Name:** `top_impression_share`<br />**Type:** metric                                                                                                                    |
| <div>Lost Impression Share By Budget</div>  | Percentage of impressions lost due to insufficient budget. Consider increasing budget.<br /><br />**Field Name:** `lost_impression_share_by_budget`<br />**Type:** metric                                                                                                     |
| <div>Lost Impression Share By Ad Rank</div> | Percentage of impressions lost due to low ad rank. Consider improving CPC or product quality.<br /><br />**Field Name:** `lost_impression_share_by_ad_rank`<br />**Type:** metric                                                                                             |
| <div>ACOS Benchmark</div>                   | Target ACOS used by successful ads with good impressions and sales performance.<br /><br />**Field Name:** `acos_benchmark`<br />**Type:** metric                                                                                                                             |

### Brand Ads

|                                          |                                                                                                                                                       |
| ---------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------- |
| <div>Attribution Order Conversions</div> | Number of purchases made after users clicked on your Brand Ads.<br /><br />**Field Name:** `attribution_order_conversions`<br />**Type:** metric      |
| <div>Attribution Order Amount</div>      | Total revenue from sales attributed to your Brand Ads clicks.<br /><br />**Field Name:** `attribution_order_amount`<br />**Type:** metric             |
| <div>Leads</div>                         | Number of potential buyers who asked questions or contacted via WhatsApp after clicking ads.<br /><br />**Field Name:** `leads`<br />**Type:** metric |
| <div>Won Auctions</div>                  | Percentage of times a keyword won the auction for ad placement.<br /><br />**Field Name:** `won_auctions`<br />**Type:** metric                       |

### Display Ads

|                                                |                                                                                                                                                                |
| ---------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| <div>CPM</div>                                 | Cost Per Thousand Impressions - average cost for 1,000 ad impressions.<br /><br />**Field Name:** `cpm`<br />**Type:** metric                                  |
| <div>Reach</div>                               | Number of unique users who saw your ads.<br /><br />**Field Name:** `reach`<br />**Type:** metric                                                              |
| <div>Active Views</div>                        | Times users viewed the first 6 seconds of Social and Video ads.<br /><br />**Field Name:** `active_views`<br />**Type:** metric                                |
| <div>Completed Views</div>                     | Times users watched your complete Social and Video ads.<br /><br />**Field Name:** `completed_views`<br />**Type:** metric                                     |
| <div>Average Frequency</div>                   | Average number of times a unique user saw your ads.<br /><br />**Field Name:** `average_frequency`<br />**Type:** metric                                       |
| <div>Event Time CPA Order</div>                | Cost per order acquisition based on event date. Formula: cost / orders.<br /><br />**Field Name:** `event_time_cpa_order`<br />**Type:** metric                |
| <div>Event Time CPA PPV</div>                  | Cost per product page view based on event date. Formula: cost / page views.<br /><br />**Field Name:** `event_time_cpa_ppv`<br />**Type:** metric              |
| <div>Event Time ROAS</div>                     | Return on ad spend attributed by event date. Formula: revenue / cost.<br /><br />**Field Name:** `event_time_roas`<br />**Type:** metric                       |
| <div>Event Time Units Quantity</div>           | Units sold attributed to the exact date of the action.<br /><br />**Field Name:** `event_time_units_quantity`<br />**Type:** metric                            |
| <div>Event Time Direct Amount</div>            | Direct revenue attributed to the exact date of purchase.<br /><br />**Field Name:** `event_time_direct_amount`<br />**Type:** metric                           |
| <div>Event Time Direct Item Quantity</div>     | Direct sales count attributed to the exact date of purchase.<br /><br />**Field Name:** `event_time_direct_item_quantity`<br />**Type:** metric                |
| <div>Event Time Attribution PPV</div>          | Product page views after ad interaction, attributed by event date.<br /><br />**Field Name:** `event_time_attribution_ppv`<br />**Type:** metric               |
| <div>Event Time Attribution Add To Cart</div>  | Add to cart actions after ad interaction, attributed by event date.<br /><br />**Field Name:** `event_time_attribution_add_to_cart`<br />**Type:** metric      |
| <div>Event Time Attribution Bookmark</div>     | Product bookmarks/favorites after ad interaction, attributed by event date.<br /><br />**Field Name:** `event_time_attribution_bookmark`<br />**Type:** metric |
| <div>Event Time Attribution Checkout</div>     | Checkout starts after ad interaction, attributed by event date.<br /><br />**Field Name:** `event_time_attribution_checkout`<br />**Type:** metric             |
| <div>Event Time Attribution Leads</div>        | Leads generated after ad interaction, attributed by event date.<br /><br />**Field Name:** `event_time_attribution_leads`<br />**Type:** metric                |
| <div>Event Time CPL</div>                      | Cost per lead based on event date. Formula: cost / leads.<br /><br />**Field Name:** `event_time_cpl`<br />**Type:** metric                                    |
| <div>Touch Point CPA Order</div>               | Cost per order attributed to ad click/impression date. Formula: cost / orders.<br /><br />**Field Name:** `touch_point_cpa_order`<br />**Type:** metric        |
| <div>Touch Point CPA PPV</div>                 | Cost per page view attributed to ad click/impression date. Formula: cost / page views.<br /><br />**Field Name:** `touch_point_cpa_ppv`<br />**Type:** metric  |
| <div>Touch Point ROAS</div>                    | Return on ad spend attributed to ad click/impression date. Formula: revenue / cost.<br /><br />**Field Name:** `touch_point_roas`<br />**Type:** metric        |
| <div>Touch Point Units Quantity</div>          | Units sold attributed to the date of ad click or impression.<br /><br />**Field Name:** `touch_point_units_quantity`<br />**Type:** metric                     |
| <div>Touch Point Direct Amount</div>           | Direct revenue attributed to the date of ad click or impression.<br /><br />**Field Name:** `touch_point_direct_amount`<br />**Type:** metric                  |
| <div>Touch Point Direct Item Quantity</div>    | Direct sales count attributed to the date of ad click or impression.<br /><br />**Field Name:** `touch_point_direct_item_quantity`<br />**Type:** metric       |
| <div>Touch Point Attribution PPV</div>         | Product page views attributed to ad click/impression date.<br /><br />**Field Name:** `touch_point_attribution_ppv`<br />**Type:** metric                      |
| <div>Touch Point Attribution Add To Cart</div> | Add to cart actions attributed to ad click/impression date.<br /><br />**Field Name:** `touch_point_attribution_add_to_cart`<br />**Type:** metric             |
| <div>Touch Point Attribution Bookmark</div>    | Product bookmarks attributed to ad click/impression date.<br /><br />**Field Name:** `touch_point_attribution_bookmark`<br />**Type:** metric                  |
| <div>Touch Point Attribution Checkout</div>    | Checkout starts attributed to ad click/impression date.<br /><br />**Field Name:** `touch_point_attribution_checkout`<br />**Type:** metric                    |
| <div>Touch Point Attribution Leads</div>       | Leads generated attributed to ad click/impression date.<br /><br />**Field Name:** `touch_point_attribution_leads`<br />**Type:** metric                       |
| <div>Touch Point CPL</div>                     | Cost per lead attributed to ad click/impression date. Formula: cost / leads.<br /><br />**Field Name:** `touch_point_cpl`<br />**Type:** metric                |

***

## Related

<CardGroup>
  <Card title="Fields Catalog" icon="book" href="/fields-catalog">
    Browse all platforms
  </Card>

  <Card title="Meta Ads Fields" icon="chart-bar" href="/data-source/facebook-ads/fields">
    Meta Ads metrics & dimensions
  </Card>

  <Card title="Google Ads Fields" icon="chart-bar" href="/data-source/google-ads/fields">
    Google Ads metrics & dimensions
  </Card>

  <Card title="TikTok Ads Fields" icon="chart-bar" href="/data-source/tiktok-ads/fields">
    TikTok Ads metrics & dimensions
  </Card>
</CardGroup>


# Mercado Libre Organic Metrics & Dimensions
Source: https://support.detrics.io/data-source/mercado-organic/fields

Complete reference for Mercado Libre Organic dimensions and metrics

<Info>
  **Last updated:** August 6, 2026
</Info>

<div>
  <div>
    73 dimensions
  </div>

  <div>
    51 metrics
  </div>
</div>

This reference covers all available dimensions and metrics for Mercado Libre Organic data through Detrics. Use this guide to understand what data you can extract and how to structure your queries.

<div>
  <span>Supported destinations:</span>

  <div>
    Google Sheets
  </div>

  <div>
    Claude
  </div>

  <div>
    BigQuery
  </div>
</div>

## Dimensions

Dimensions are the attributes you can use to segment and group your Mercado Libre Organic data.

### Account

|                         |                                                                                                                 |
| ----------------------- | --------------------------------------------------------------------------------------------------------------- |
| <div>Account ID</div>   | Mercado Libre seller ID.<br /><br />**Field Name:** `accountId`<br />**Type:** dimension                        |
| <div>Account Name</div> | Mercado Libre seller display name / nickname.<br /><br />**Field Name:** `accountName`<br />**Type:** dimension |

### Reputation

|                                      |                                                                                                                                                          |
| ------------------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------- |
| <div>Country</div>                   | Seller country (AR, BR, MX, etc.).<br /><br />**Field Name:** `countryId`<br />**Type:** dimension                                                       |
| <div>Site</div>                      | Mercado Libre site identifier (e.g., MLA for Argentina, MLB for Brazil, MLM for Mexico).<br /><br />**Field Name:** `siteId`<br />**Type:** dimension    |
| <div>Seller Experience</div>         | Seller experience level: NEWBIE, INTERMEDIATE, or ADVANCED.<br /><br />**Field Name:** `sellerExperience`<br />**Type:** dimension                       |
| <div>Reputation Level</div>          | Seller reputation level (1\_red, 2\_orange, 3\_yellow, 4\_light\_green, 5\_green).<br /><br />**Field Name:** `reputationLevel`<br />**Type:** dimension |
| <div>Power Seller Status</div>       | MercadoLíder/Líder status: silver, gold, platinum, or null.<br /><br />**Field Name:** `powerSellerStatus`<br />**Type:** dimension                      |
| <div>Registration Date</div>         | Date the seller account was created.<br /><br />**Field Name:** `registrationDate`<br />**Type:** dimension                                              |
| <div>User Type</div>                 | Account type: brand, normal, etc.<br /><br />**Field Name:** `userType`<br />**Type:** dimension                                                         |
| <div>User Tags</div>                 | Comma-separated tags describing the seller (e.g., business, eshop, large\_seller).<br /><br />**Field Name:** `userTags`<br />**Type:** dimension        |
| <div>Seller Profile URL</div>        | Public URL of the seller profile on Mercado Libre.<br /><br />**Field Name:** `sellerProfileUrl`<br />**Type:** dimension                                |
| <div>Credit Level</div>              | Mercado Libre credit level identifier.<br /><br />**Field Name:** `creditLevelId`<br />**Type:** dimension                                               |
| <div>Credit Rank</div>               | Credit rank: newbie, regular, top, etc.<br /><br />**Field Name:** `creditRank`<br />**Type:** dimension                                                 |
| <div>Mercado Envíos Status</div>     | Whether the seller accepts Mercado Envíos shipping (accepted, not\_accepted).<br /><br />**Field Name:** `mercadoEnviosStatus`<br />**Type:** dimension  |
| <div>Mercado Pago Account Type</div> | Mercado Pago account type: personal, business.<br /><br />**Field Name:** `mercadopagoAccountType`<br />**Type:** dimension                              |
| <div>Site Status</div>               | Account status on the site: active, inactive, etc.<br /><br />**Field Name:** `siteStatus`<br />**Type:** dimension                                      |

### Items

|                                   |                                                                                                                                               |
| --------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------- |
| <div>Item ID</div>                | Mercado Libre listing ID (e.g., MLA1234567890).<br /><br />**Field Name:** `itemId`<br />**Type:** dimension                                  |
| <div>Item Title</div>             | Title of the listing.<br /><br />**Field Name:** `itemTitle`<br />**Type:** dimension                                                         |
| <div>Item Subtitle</div>          | Optional subtitle of the listing.<br /><br />**Field Name:** `itemSubtitle`<br />**Type:** dimension                                          |
| <div>Item Category</div>          | Mercado Libre category identifier (e.g., MLA417376).<br /><br />**Field Name:** `itemCategoryId`<br />**Type:** dimension                     |
| <div>Item Domain</div>            | Item domain identifier (e.g., MLA-SPORT\_BRAS).<br /><br />**Field Name:** `itemDomainId`<br />**Type:** dimension                            |
| <div>Official Store ID</div>      | Official store ID if the listing belongs to one.<br /><br />**Field Name:** `itemOfficialStoreId`<br />**Type:** dimension                    |
| <div>Catalog Product ID</div>     | Mercado Libre catalog product identifier if catalog-listed.<br /><br />**Field Name:** `itemCatalogProductId`<br />**Type:** dimension        |
| <div>Item Condition</div>         | Item condition: new, used, refurbished.<br /><br />**Field Name:** `itemCondition`<br />**Type:** dimension                                   |
| <div>Item Status</div>            | Listing status: active, paused, closed.<br /><br />**Field Name:** `itemStatus`<br />**Type:** dimension                                      |
| <div>Item Sub-status</div>        | Sub-status (e.g., out\_of\_stock, under\_review).<br /><br />**Field Name:** `itemSubStatus`<br />**Type:** dimension                         |
| <div>Item Listing Type</div>      | Listing type: gold\_special, gold\_pro, etc.<br /><br />**Field Name:** `itemListingTypeId`<br />**Type:** dimension                          |
| <div>Buying Mode</div>            | Buying mode: buy\_it\_now, auction, classified.<br /><br />**Field Name:** `itemBuyingMode`<br />**Type:** dimension                          |
| <div>Item Currency</div>          | Currency the listing is priced in (e.g., ARS, BRL, MXN).<br /><br />**Field Name:** `itemCurrencyId`<br />**Type:** dimension                 |
| <div>Item URL</div>               | Public URL of the listing on Mercado Libre.<br /><br />**Field Name:** `itemPermalink`<br />**Type:** dimension                               |
| <div>Item Thumbnail</div>         | URL of the listing thumbnail image.<br /><br />**Field Name:** `itemThumbnail`<br />**Type:** dimension                                       |
| <div>Item Date Created</div>      | Date the listing was created.<br /><br />**Field Name:** `itemDateCreated`<br />**Type:** dimension                                           |
| <div>Item Last Updated</div>      | Date the listing was last updated.<br /><br />**Field Name:** `itemLastUpdated`<br />**Type:** dimension                                      |
| <div>Item Start Time</div>        | Date the listing started.<br /><br />**Field Name:** `itemStartTime`<br />**Type:** dimension                                                 |
| <div>Item Stop Time</div>         | Date the listing is scheduled to stop.<br /><br />**Field Name:** `itemStopTime`<br />**Type:** dimension                                     |
| <div>Shipping Mode</div>          | Shipping mode (e.g., me2, custom).<br /><br />**Field Name:** `itemShippingMode`<br />**Type:** dimension                                     |
| <div>Shipping Logistic Type</div> | Shipping logistic type (e.g., xd\_drop\_off, fulfillment).<br /><br />**Field Name:** `itemShippingLogisticType`<br />**Type:** dimension     |
| <div>Item Tags</div>              | Comma-separated listing tags (e.g., good\_quality\_thumbnail, cart\_eligible).<br /><br />**Field Name:** `itemTags`<br />**Type:** dimension |
| <div>Item Warranty</div>          | Warranty terms declared by the seller.<br /><br />**Field Name:** `itemWarranty`<br />**Type:** dimension                                     |
| <div>Parent Item ID</div>         | Parent item ID if this listing is a variation child.<br /><br />**Field Name:** `itemParentItemId`<br />**Type:** dimension                   |

### Orders

|                                       |                                                                                                                                                            |
| ------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------- |
| <div>Order ID</div>                   | Mercado Libre order identifier.<br /><br />**Field Name:** `orderId`<br />**Type:** dimension                                                              |
| <div>Pack ID</div>                    | Pack identifier (groups multiple orders sharing the same buyer + shipment).<br /><br />**Field Name:** `packId`<br />**Type:** dimension                   |
| <div>Order Status</div>               | Order status: paid, confirmed, cancelled, etc.<br /><br />**Field Name:** `orderStatus`<br />**Type:** dimension                                           |
| <div>Order Date Created</div>         | Date the order was created.<br /><br />**Field Name:** `orderDateCreated`<br />**Type:** dimension                                                         |
| <div>Order Date Closed</div>          | Date the order was closed (payment captured).<br /><br />**Field Name:** `orderDateClosed`<br />**Type:** dimension                                        |
| <div>Order Last Updated</div>         | Date the order was last updated.<br /><br />**Field Name:** `orderLastUpdated`<br />**Type:** dimension                                                    |
| <div>Order Expiration Date</div>      | Date the order expires if unpaid.<br /><br />**Field Name:** `orderExpirationDate`<br />**Type:** dimension                                                |
| <div>Order Currency</div>             | Currency used for the order.<br /><br />**Field Name:** `orderCurrencyId`<br />**Type:** dimension                                                         |
| <div>Order Tags</div>                 | Comma-separated order tags (e.g., d2c, pack\_order, paid, delivered).<br /><br />**Field Name:** `orderTags`<br />**Type:** dimension                      |
| <div>Buyer ID</div>                   | Mercado Libre buyer identifier.<br /><br />**Field Name:** `orderBuyerId`<br />**Type:** dimension                                                         |
| <div>Pickup ID</div>                  | Pickup identifier when shipping mode uses store pickup.<br /><br />**Field Name:** `orderPickupId`<br />**Type:** dimension                                |
| <div>Shipping ID</div>                | Shipment identifier (can be joined with Mercado Envíos shipping data).<br /><br />**Field Name:** `orderShippingId`<br />**Type:** dimension               |
| <div>Order Comment</div>              | Optional buyer comment attached to the order.<br /><br />**Field Name:** `orderComment`<br />**Type:** dimension                                           |
| <div>Feedback — Purchase Rating</div> | Buyer-given feedback rating on the purchase (positive/neutral/negative).<br /><br />**Field Name:** `orderFeedbackPurchaseRating`<br />**Type:** dimension |
| <div>Feedback — Sale Rating</div>     | Seller-given feedback rating on the sale.<br /><br />**Field Name:** `orderFeedbackSaleRating`<br />**Type:** dimension                                    |
| <div>Coupon ID</div>                  | Mercado Libre coupon ID applied to the order, if any.<br /><br />**Field Name:** `orderCouponId`<br />**Type:** dimension                                  |
| <div>Payment Method</div>             | First payment's method identifier (e.g., account\_money, visa).<br /><br />**Field Name:** `orderPaymentMethodId`<br />**Type:** dimension                 |
| <div>Payment Type</div>               | First payment's type (e.g., account\_money, credit\_card, ticket).<br /><br />**Field Name:** `orderPaymentType`<br />**Type:** dimension                  |
| <div>Payment Status</div>             | First payment's status (approved, pending, rejected).<br /><br />**Field Name:** `orderPaymentStatus`<br />**Type:** dimension                             |
| <div>Payment Date Approved</div>      | Date the payment was approved.<br /><br />**Field Name:** `orderPaymentDateApproved`<br />**Type:** dimension                                              |
| <div>First Item Title</div>           | Title of the first item in the order.<br /><br />**Field Name:** `orderFirstItemTitle`<br />**Type:** dimension                                            |
| <div>First Item Category</div>        | Category identifier of the first item in the order.<br /><br />**Field Name:** `orderFirstItemCategoryId`<br />**Type:** dimension                         |

### Questions

|                                          |                                                                                                                                                  |
| ---------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------ |
| <div>Question ID</div>                   | Mercado Libre question identifier.<br /><br />**Field Name:** `questionId`<br />**Type:** dimension                                              |
| <div>Question Item ID</div>              | Listing the question was asked about.<br /><br />**Field Name:** `questionItemId`<br />**Type:** dimension                                       |
| <div>Question Status</div>               | Question status: ANSWERED, UNANSWERED, BANNED, DELETED, CLOSED\_UNANSWERED.<br /><br />**Field Name:** `questionStatus`<br />**Type:** dimension |
| <div>Question Text</div>                 | The buyer-written question.<br /><br />**Field Name:** `questionText`<br />**Type:** dimension                                                   |
| <div>Question Date Created</div>         | Date the question was created.<br /><br />**Field Name:** `questionDateCreated`<br />**Type:** dimension                                         |
| <div>Question Answer Text</div>          | The seller-written answer text.<br /><br />**Field Name:** `questionAnswerText`<br />**Type:** dimension                                         |
| <div>Question Answer Date</div>          | Date the answer was posted.<br /><br />**Field Name:** `questionAnswerDate`<br />**Type:** dimension                                             |
| <div>Question From User ID</div>         | ID of the buyer who asked the question.<br /><br />**Field Name:** `questionFromUserId`<br />**Type:** dimension                                 |
| <div>Question Answer Status</div>        | Answer status: ACTIVE, BANNED, DELETED, DISABLED.<br /><br />**Field Name:** `questionAnswerStatus`<br />**Type:** dimension                     |
| <div>Question Tags</div>                 | Comma-separated tags on the question.<br /><br />**Field Name:** `questionTags`<br />**Type:** dimension                                         |
| <div>Question Deleted From Listing</div> | 1 if the question is hidden from the listing page, 0 otherwise.<br /><br />**Field Name:** `questionDeletedFromListing`<br />**Type:** dimension |

## Metrics

Metrics are the numerical values you can measure and analyze from your Mercado Libre Organic campaigns.

### Questions

|                              |                                                                                                                                                                        |
| ---------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| <div>Question Answered</div> | 1 if the question has been answered, 0 otherwise. Sum across rows for count of answered questions.<br /><br />**Field Name:** `questionAnswered`<br />**Type:** metric |

### Reputation

|                                        |                                                                                                                                   |
| -------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------- |
| <div>User Points</div>                 | Seller reputation points.<br /><br />**Field Name:** `userPoints`<br />**Type:** metric                                           |
| <div>Total Transactions</div>          | Total historic transactions (canceled + completed).<br /><br />**Field Name:** `totalTransactions`<br />**Type:** metric          |
| <div>Completed Transactions</div>      | Historic completed transactions count.<br /><br />**Field Name:** `completedTransactions`<br />**Type:** metric                   |
| <div>Canceled Transactions</div>       | Historic canceled transactions count.<br /><br />**Field Name:** `canceledTransactions`<br />**Type:** metric                     |
| <div>Positive Ratings</div>            | Historic positive ratings received.<br /><br />**Field Name:** `positiveRatings`<br />**Type:** metric                            |
| <div>Neutral Ratings</div>             | Historic neutral ratings received.<br /><br />**Field Name:** `neutralRatings`<br />**Type:** metric                              |
| <div>Negative Ratings</div>            | Historic negative ratings received.<br /><br />**Field Name:** `negativeRatings`<br />**Type:** metric                            |
| <div>Sales Completed (Last 365d)</div> | Completed sales in the rolling last 365 days.<br /><br />**Field Name:** `salesCompletedLast365Days`<br />**Type:** metric        |
| <div>Claims Rate</div>                 | Share of orders with buyer claims (last 60 days).<br /><br />**Field Name:** `claimsRate`<br />**Type:** metric                   |
| <div>Claims Value</div>                | Count of orders with claims (last 60 days).<br /><br />**Field Name:** `claimsValue`<br />**Type:** metric                        |
| <div>Delayed Handling Time Rate</div>  | Share of orders with delayed handling (last 60 days).<br /><br />**Field Name:** `delayedHandlingTimeRate`<br />**Type:** metric  |
| <div>Delayed Handling Time Value</div> | Count of orders with delayed handling (last 60 days).<br /><br />**Field Name:** `delayedHandlingTimeValue`<br />**Type:** metric |
| <div>Cancellations Rate</div>          | Share of orders cancelled by the seller (last 60 days).<br /><br />**Field Name:** `cancellationsRate`<br />**Type:** metric      |
| <div>Cancellations Value</div>         | Count of seller-cancelled orders (last 60 days).<br /><br />**Field Name:** `cancellationsValue`<br />**Type:** metric            |
| <div>Confirmed Email</div>             | 1 if the seller email is confirmed, 0 otherwise.<br /><br />**Field Name:** `confirmedEmail`<br />**Type:** metric                |

### Items

|                                 |                                                                                                                                                      |
| ------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------- |
| <div>Item Health</div>          | Mercado Libre listing health score (0-1). Indicates how well-completed the listing is.<br /><br />**Field Name:** `itemHealth`<br />**Type:** metric |
| <div>Item Price</div>           | Current listing price.<br /><br />**Field Name:** `itemPrice`<br />**Type:** metric                                                                  |
| <div>Item Base Price</div>      | Base price before any discounts applied.<br /><br />**Field Name:** `itemBasePrice`<br />**Type:** metric                                            |
| <div>Item Original Price</div>  | Original listing price before promotional discounts.<br /><br />**Field Name:** `itemOriginalPrice`<br />**Type:** metric                            |
| <div>Available Quantity</div>   | Current stock available for the listing.<br /><br />**Field Name:** `itemAvailableQuantity`<br />**Type:** metric                                    |
| <div>Sold Quantity</div>        | Lifetime units sold for the listing.<br /><br />**Field Name:** `itemSoldQuantity`<br />**Type:** metric                                             |
| <div>Initial Quantity</div>     | Initial stock of the listing when first published.<br /><br />**Field Name:** `itemInitialQuantity`<br />**Type:** metric                            |
| <div>Catalog Listing</div>      | 1 if the listing is part of a Mercado Libre catalog, 0 otherwise.<br /><br />**Field Name:** `itemCatalogListing`<br />**Type:** metric              |
| <div>Accepts Mercado Pago</div> | 1 if the listing accepts Mercado Pago, 0 otherwise.<br /><br />**Field Name:** `itemAcceptsMercadoPago`<br />**Type:** metric                        |
| <div>Free Shipping</div>        | 1 if the listing offers free shipping, 0 otherwise.<br /><br />**Field Name:** `itemFreeShipping`<br />**Type:** metric                              |
| <div>Automatic Relist</div>     | 1 if the listing is configured to auto-relist, 0 otherwise.<br /><br />**Field Name:** `itemAutomaticRelist`<br />**Type:** metric                   |
| <div>Item Picture Count</div>   | Number of pictures attached to the listing.<br /><br />**Field Name:** `itemPictureCount`<br />**Type:** metric                                      |
| <div>Item Variation Count</div> | Number of variations (e.g., size/color combinations) on the listing.<br /><br />**Field Name:** `itemVariationCount`<br />**Type:** metric           |
| <div>Item Visits</div>          | Lifetime visits to the listing (last \~150 days, ML API limit).<br /><br />**Field Name:** `itemVisits`<br />**Type:** metric                        |

### Reviews

|                                   |                                                                                                                         |
| --------------------------------- | ----------------------------------------------------------------------------------------------------------------------- |
| <div>Reviews Total</div>          | Total reviews submitted for the listing.<br /><br />**Field Name:** `reviewsTotal`<br />**Type:** metric                |
| <div>Reviews Rating Average</div> | Average rating across all reviews (0-5).<br /><br />**Field Name:** `reviewsRatingAverage`<br />**Type:** metric        |
| <div>Reviews With Comment</div>   | Number of reviews that include a written comment.<br /><br />**Field Name:** `reviewsWithComment`<br />**Type:** metric |
| <div>Reviews — 5 Stars</div>      | Count of 5-star reviews.<br /><br />**Field Name:** `reviewsFiveStars`<br />**Type:** metric                            |
| <div>Reviews — 4 Stars</div>      | Count of 4-star reviews.<br /><br />**Field Name:** `reviewsFourStars`<br />**Type:** metric                            |
| <div>Reviews — 3 Stars</div>      | Count of 3-star reviews.<br /><br />**Field Name:** `reviewsThreeStars`<br />**Type:** metric                           |
| <div>Reviews — 2 Stars</div>      | Count of 2-star reviews.<br /><br />**Field Name:** `reviewsTwoStars`<br />**Type:** metric                             |
| <div>Reviews — 1 Star</div>       | Count of 1-star reviews.<br /><br />**Field Name:** `reviewsOneStar`<br />**Type:** metric                              |

### Orders

|                                    |                                                                                                                                            |
| ---------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------ |
| <div>Order Total Amount</div>      | Total monetary value of the order.<br /><br />**Field Name:** `orderTotalAmount`<br />**Type:** metric                                     |
| <div>Order Paid Amount</div>       | Amount actually paid by the buyer.<br /><br />**Field Name:** `orderPaidAmount`<br />**Type:** metric                                      |
| <div>Order Shipping Cost</div>     | Shipping cost reported on the first payment.<br /><br />**Field Name:** `orderShippingCost`<br />**Type:** metric                          |
| <div>Order Items Count</div>       | Number of distinct items in the order.<br /><br />**Field Name:** `orderItemsCount`<br />**Type:** metric                                  |
| <div>Order Total Quantity</div>    | Sum of unit quantities across all items in the order.<br /><br />**Field Name:** `orderTotalQuantity`<br />**Type:** metric                |
| <div>Coupon Amount</div>           | Coupon discount amount applied to the order.<br /><br />**Field Name:** `orderCouponAmount`<br />**Type:** metric                          |
| <div>Payment Installments</div>    | Number of installments on the first payment.<br /><br />**Field Name:** `orderPaymentInstallments`<br />**Type:** metric                   |
| <div>Payment Marketplace Fee</div> | Mercado Pago marketplace fee on the first payment.<br /><br />**Field Name:** `orderPaymentMarketplaceFee`<br />**Type:** metric           |
| <div>Payment Taxes Amount</div>    | Taxes amount reported on the first payment.<br /><br />**Field Name:** `orderPaymentTaxesAmount`<br />**Type:** metric                     |
| <div>First Item Unit Price</div>   | Unit price of the first item in the order.<br /><br />**Field Name:** `orderFirstItemUnitPrice`<br />**Type:** metric                      |
| <div>First Item Sale Fee</div>     | Mercado Libre commission charged on the first item.<br /><br />**Field Name:** `orderFirstItemSaleFee`<br />**Type:** metric               |
| <div>Order Total Sale Fee</div>    | Total Mercado Libre commission charged across all items in the order.<br /><br />**Field Name:** `orderTotalSaleFee`<br />**Type:** metric |

### Seller Visits

|                                |                                                                                                                                                                                                                                              |
| ------------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| <div>Seller Total Visits</div> | Total visits to the seller's storefront in the selected date range. Mercado Libre only returns the aggregate value, so this metric requires the 'All' time aggregation.<br /><br />**Field Name:** `sellerTotalVisits`<br />**Type:** metric |

***

## Related

<CardGroup>
  <Card title="Fields Catalog" icon="book" href="/fields-catalog">
    Browse all platforms
  </Card>

  <Card title="Mercado Ads Fields" icon="chart-bar" href="/data-source/mercado-ads/fields">
    Mercado Ads metrics & dimensions
  </Card>

  <Card title="TiendaNube Fields" icon="chart-bar" href="/data-source/tiendanube/fields">
    TiendaNube metrics & dimensions
  </Card>

  <Card title="Shopify Fields" icon="chart-bar" href="/data-source/shopify/fields">
    Shopify metrics & dimensions
  </Card>
</CardGroup>


# Perfit Metrics & Dimensions
Source: https://support.detrics.io/data-source/perfit/fields

Complete reference for Perfit email marketing dimensions and metrics

<Info>
  **Last updated:** August 6, 2026
</Info>

<div>
  <div>
    30 dimensions
  </div>

  <div>
    51 metrics
  </div>
</div>

This reference covers all available dimensions and metrics for Perfit data through Detrics. Use this guide to understand what data you can extract and how to structure your queries.

<div>
  <span>Supported destinations:</span>

  <div>
    Google Sheets
  </div>

  <div>
    Claude
  </div>

  <div>
    BigQuery
  </div>
</div>

## Dimensions

Dimensions are the attributes you can use to segment and group your Perfit data.

### Account Details

|                         |                                                                                              |
| ----------------------- | -------------------------------------------------------------------------------------------- |
| <div>Account Name</div> | Perfit account name (slug)<br /><br />**Field Name:** `accountName`<br />**Type:** dimension |

### Campaign Details

|                               |                                                                                                                                           |
| ----------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------- |
| <div>Campaign ID</div>        | Unique identifier for the Perfit campaign<br /><br />**Field Name:** `campaignId`<br />**Type:** dimension                                |
| <div>Campaign Name</div>      | Name of the email campaign<br /><br />**Field Name:** `campaignName`<br />**Type:** dimension                                             |
| <div>Campaign State</div>     | Current state of the campaign (e.g., SENT, DRAFT, SCHEDULED)<br /><br />**Field Name:** `campaignState`<br />**Type:** dimension          |
| <div>Campaign Type</div>      | Type of campaign (e.g., SMART, CLASSIC, AUTOMATION)<br /><br />**Field Name:** `campaignType`<br />**Type:** dimension                    |
| <div>Subject</div>            | Email subject line of the campaign<br /><br />**Field Name:** `campaignSubject`<br />**Type:** dimension                                  |
| <div>Launch Mode</div>        | How the campaign was launched (e.g., NOW, SCHEDULED, AUTOMATION)<br /><br />**Field Name:** `campaignLaunchMode`<br />**Type:** dimension |
| <div>Launch Date</div>        | Date when the campaign was launched<br /><br />**Field Name:** `launchDate`<br />**Type:** dimension                                      |
| <div>Created Date</div>       | Date and time when the campaign was created<br /><br />**Field Name:** `campaignCreated`<br />**Type:** dimension                         |
| <div>Last Modified Date</div> | Date and time when the campaign was last modified<br /><br />**Field Name:** `campaignLastModified`<br />**Type:** dimension              |
| <div>Last Open</div>          | Timestamp of the most recent open on this campaign<br /><br />**Field Name:** `campaignLastOpen`<br />**Type:** dimension                 |
| <div>Last Click</div>         | Timestamp of the most recent click on this campaign<br /><br />**Field Name:** `campaignLastClick`<br />**Type:** dimension               |
| <div>Archived</div>           | Whether the campaign is archived<br /><br />**Field Name:** `campaignArchived`<br />**Type:** dimension                                   |
| <div>Thumbnail URL</div>      | URL of the campaign preview thumbnail image<br /><br />**Field Name:** `campaignThumbnail`<br />**Type:** dimension                       |
| <div>Tags</div>               | Comma-separated list of tags applied to the campaign<br /><br />**Field Name:** `tags`<br />**Type:** dimension                           |

### List Details

|                              |                                                                                                                     |
| ---------------------------- | ------------------------------------------------------------------------------------------------------------------- |
| <div>List ID</div>           | Unique identifier for the list<br /><br />**Field Name:** `listId`<br />**Type:** dimension                         |
| <div>List Name</div>         | Name of the contact list<br /><br />**Field Name:** `listName`<br />**Type:** dimension                             |
| <div>List Description</div>  | Description of the list<br /><br />**Field Name:** `listDescription`<br />**Type:** dimension                       |
| <div>List Tags</div>         | Comma-separated list of tags applied to the list<br /><br />**Field Name:** `listTags`<br />**Type:** dimension     |
| <div>Last Mailed Date</div>  | Date and time when the list was last mailed to<br /><br />**Field Name:** `listLastMailed`<br />**Type:** dimension |
| <div>List Created Date</div> | Date and time when the list was created<br /><br />**Field Name:** `listCreated`<br />**Type:** dimension           |

### Automation Details

|                                          |                                                                                                                                                                   |
| ---------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| <div>Automation ID</div>                 | Unique identifier for the Perfit automation<br /><br />**Field Name:** `automationId`<br />**Type:** dimension                                                    |
| <div>Automation Name</div>               | Name of the automation flow<br /><br />**Field Name:** `automationName`<br />**Type:** dimension                                                                  |
| <div>Automation Description</div>        | Description / comments configured for the automation<br /><br />**Field Name:** `automationComments`<br />**Type:** dimension                                     |
| <div>Automation Trigger</div>            | Event that triggers the automation (e.g., tiendanube.cart.created, optin.confirmed)<br /><br />**Field Name:** `automationTrigger`<br />**Type:** dimension       |
| <div>Automation Tags</div>               | Comma-separated list of tags applied to the automation<br /><br />**Field Name:** `automationTags`<br />**Type:** dimension                                       |
| <div>Automation Types</div>              | Comma-separated list of automation type categories (e.g., abandoned\_cart, welcome, coupon)<br /><br />**Field Name:** `automationTypes`<br />**Type:** dimension |
| <div>Automation Enabled</div>            | Whether the automation is currently active<br /><br />**Field Name:** `automationEnabled`<br />**Type:** dimension                                                |
| <div>Automation Created Date</div>       | Date and time when the automation was created<br /><br />**Field Name:** `automationCreated`<br />**Type:** dimension                                             |
| <div>Automation Last Modified Date</div> | Date and time when the automation was last modified<br /><br />**Field Name:** `automationUpdated`<br />**Type:** dimension                                       |

## Metrics

Metrics are the numerical values you can measure and analyze from your Perfit campaigns.

### Campaign Delivery

|                                  |                                                                                                                        |
| -------------------------------- | ---------------------------------------------------------------------------------------------------------------------- |
| <div>Recipients (Intended)</div> | Total number of recipients the campaign was intended for<br /><br />**Field Name:** `recipients`<br />**Type:** metric |
| <div>Sent</div>                  | Number of emails actually sent<br /><br />**Field Name:** `sent`<br />**Type:** metric                                 |
| <div>Delivered</div>             | Number of emails successfully delivered<br /><br />**Field Name:** `delivered`<br />**Type:** metric                   |
| <div>Bounced</div>               | Total number of bounced emails (hard + soft)<br /><br />**Field Name:** `bounced`<br />**Type:** metric                |
| <div>Hard Bounced</div>          | Number of hard bounces (permanent delivery failures)<br /><br />**Field Name:** `hardBounced`<br />**Type:** metric    |
| <div>Soft Bounced</div>          | Number of soft bounces (temporary delivery failures)<br /><br />**Field Name:** `softBounced`<br />**Type:** metric    |
| <div>Delivered Rate</div>        | Percentage of sent emails that were delivered<br /><br />**Field Name:** `deliveredRate`<br />**Type:** metric         |
| <div>Bounce Rate</div>           | Percentage of sent emails that bounced<br /><br />**Field Name:** `bounceRate`<br />**Type:** metric                   |
| <div>Hard Bounce Rate</div>      | Percentage of sent emails that hard bounced<br /><br />**Field Name:** `hardBounceRate`<br />**Type:** metric          |
| <div>Soft Bounce Rate</div>      | Percentage of sent emails that soft bounced<br /><br />**Field Name:** `softBounceRate`<br />**Type:** metric          |

### Campaign Engagement

|                               |                                                                                                                  |
| ----------------------------- | ---------------------------------------------------------------------------------------------------------------- |
| <div>Opened (Unique)</div>    | Number of unique opens (each recipient counted once)<br /><br />**Field Name:** `opened`<br />**Type:** metric   |
| <div>Opened (Total)</div>     | Total number of opens including repeat opens<br /><br />**Field Name:** `openedTotal`<br />**Type:** metric      |
| <div>Clicked (Unique)</div>   | Number of unique clicks (each recipient counted once)<br /><br />**Field Name:** `clicked`<br />**Type:** metric |
| <div>Clicked (Total)</div>    | Total number of clicks including repeat clicks<br /><br />**Field Name:** `clickedTotal`<br />**Type:** metric   |
| <div>Open Rate</div>          | Percentage of delivered emails that were opened<br /><br />**Field Name:** `openRate`<br />**Type:** metric      |
| <div>Click Rate</div>         | Percentage of delivered emails that were clicked<br /><br />**Field Name:** `clickRate`<br />**Type:** metric    |
| <div>Click-to-Open Rate</div> | Percentage of opens that resulted in a click<br /><br />**Field Name:** `clickToOpenRate`<br />**Type:** metric  |

### Campaign Conversions

|                            |                                                                                                                        |
| -------------------------- | ---------------------------------------------------------------------------------------------------------------------- |
| <div>Conversions</div>     | Number of conversions attributed to the campaign<br /><br />**Field Name:** `conversions`<br />**Type:** metric        |
| <div>Revenue</div>         | Total revenue generated from campaign conversions<br /><br />**Field Name:** `conversionsAmount`<br />**Type:** metric |
| <div>Conversion Rate</div> | Percentage of sent emails that led to a conversion<br /><br />**Field Name:** `conversionRate`<br />**Type:** metric   |

### Campaign Unsubscribes & Spam

|                             |                                                                                                                       |
| --------------------------- | --------------------------------------------------------------------------------------------------------------------- |
| <div>Complained</div>       | Number of spam complaints<br /><br />**Field Name:** `complained`<br />**Type:** metric                               |
| <div>Unsubscribed</div>     | Number of unsubscribes<br /><br />**Field Name:** `unsubscribed`<br />**Type:** metric                                |
| <div>Complaint Rate</div>   | Percentage of sent emails that were reported as spam<br /><br />**Field Name:** `complaintRate`<br />**Type:** metric |
| <div>Unsubscribe Rate</div> | Percentage of sent emails that led to unsubscribes<br /><br />**Field Name:** `unsubscribeRate`<br />**Type:** metric |

### Campaign Sharing

|                           |                                                                                                                      |
| ------------------------- | -------------------------------------------------------------------------------------------------------------------- |
| <div>Views Online</div>   | Number of online views via the "view in browser" link<br /><br />**Field Name:** `viewsOnline`<br />**Type:** metric |
| <div>Shared</div>         | Number of times the campaign was shared<br /><br />**Field Name:** `shared`<br />**Type:** metric                    |
| <div>Shared Opened</div>  | Opens resulting from shared campaign links<br /><br />**Field Name:** `sharedOpened`<br />**Type:** metric           |
| <div>Shared Clicked</div> | Clicks resulting from shared campaign links<br /><br />**Field Name:** `sharedClicked`<br />**Type:** metric         |

### List Contacts

|                                |                                                                                                                                |
| ------------------------------ | ------------------------------------------------------------------------------------------------------------------------------ |
| <div>Active Contacts</div>     | Number of active (engaged) contacts in the list<br /><br />**Field Name:** `activeContacts`<br />**Type:** metric              |
| <div>Total Contacts</div>      | Total number of contacts in the list<br /><br />**Field Name:** `totalContacts`<br />**Type:** metric                          |
| <div>Inactive Contacts</div>   | Number of inactive contacts in the list<br /><br />**Field Name:** `inactiveContacts`<br />**Type:** metric                    |
| <div>Live Contacts</div>       | Number of live (recently engaged) contacts in the list<br /><br />**Field Name:** `liveContacts`<br />**Type:** metric         |
| <div>Active Contacts %</div>   | Percentage of list members who are active<br /><br />**Field Name:** `activeContactsRate`<br />**Type:** metric                |
| <div>Inactive Contacts %</div> | Percentage of list members who are inactive<br /><br />**Field Name:** `inactiveContactsRate`<br />**Type:** metric            |
| <div>Live Contacts %</div>     | Percentage of list members who are live (recently engaged)<br /><br />**Field Name:** `liveContactsRate`<br />**Type:** metric |
| <div>List Quality</div>        | Engagement quality score of the list (0 to 1, higher is better)<br /><br />**Field Name:** `listQuality`<br />**Type:** metric |

### Automation Performance

|                        |                                                                                                                                                             |
| ---------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------- |
| <div>Triggered</div>   | Lifetime count of times the automation was triggered (INICIADOS in the Perfit UI)<br /><br />**Field Name:** `automationTriggered`<br />**Type:** metric    |
| <div>In Progress</div> | Number of executions currently in progress (EN PROCESO in the Perfit UI)<br /><br />**Field Name:** `automationActive`<br />**Type:** metric                |
| <div>Completed</div>   | Lifetime count of executions that completed all steps (FINALIZADOS in the Perfit UI)<br /><br />**Field Name:** `automationCompleted`<br />**Type:** metric |
| <div>Aborted</div>     | Lifetime count of executions aborted (e.g., contact unsubscribed mid-flow)<br /><br />**Field Name:** `automationAborted`<br />**Type:** metric             |
| <div>Failed</div>      | Lifetime count of executions that failed due to errors<br /><br />**Field Name:** `automationFailed`<br />**Type:** metric                                  |
| <div>Exited</div>      | Lifetime count of executions that exited (filtered out by automation conditions)<br /><br />**Field Name:** `automationExited`<br />**Type:** metric        |

### Automation Engagement

|                               |                                                                                                                                            |
| ----------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------ |
| <div>Sent</div>               | Lifetime count of emails sent by the automation<br /><br />**Field Name:** `automationSent`<br />**Type:** metric                          |
| <div>Opened (Unique)</div>    | Lifetime count of unique opens on automation emails<br /><br />**Field Name:** `automationOpened`<br />**Type:** metric                    |
| <div>Clicked (Unique)</div>   | Lifetime count of unique clicks on automation emails<br /><br />**Field Name:** `automationClicked`<br />**Type:** metric                  |
| <div>Open Rate</div>          | Percentage of automation emails sent that were opened<br /><br />**Field Name:** `automationOpenRate`<br />**Type:** metric                |
| <div>Click Rate</div>         | Percentage of automation emails sent that were clicked<br /><br />**Field Name:** `automationClickRate`<br />**Type:** metric              |
| <div>Click-to-Open Rate</div> | Percentage of automation email opens that resulted in a click<br /><br />**Field Name:** `automationClickToOpenRate`<br />**Type:** metric |

### Automation Conversions

|                            |                                                                                                                                                                     |
| -------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| <div>Conversions</div>     | Lifetime count of conversions attributed to the automation (VENTAS count in the Perfit UI)<br /><br />**Field Name:** `automationConversions`<br />**Type:** metric |
| <div>Revenue</div>         | Lifetime revenue generated by the automation (VENTAS \$ in the Perfit UI)<br /><br />**Field Name:** `automationConversionsAmount`<br />**Type:** metric            |
| <div>Conversion Rate</div> | Percentage of automation triggers that resulted in a conversion<br /><br />**Field Name:** `automationConversionRate`<br />**Type:** metric                         |

***

## Related

<CardGroup>
  <Card title="Fields Catalog" icon="book" href="/fields-catalog">
    Browse all platforms
  </Card>

  <Card title="Mailchimp Fields" icon="chart-bar" href="/data-source/mailchimp/fields">
    Mailchimp metrics & dimensions
  </Card>

  <Card title="Klaviyo Fields" icon="chart-bar" href="/data-source/klaviyo/fields">
    Klaviyo metrics & dimensions
  </Card>

  <Card title="HubSpot Fields" icon="chart-bar" href="/data-source/hubspot/fields">
    HubSpot metrics & dimensions
  </Card>
</CardGroup>


# Pinterest Ads Metrics & Dimensions
Source: https://support.detrics.io/data-source/pinterest-ads/fields

Complete reference for Pinterest Ads dimensions and metrics

<Info>
  **Last updated:** August 6, 2026
</Info>

<div>
  <div>
    88 dimensions
  </div>

  <div>
    345 metrics
  </div>
</div>

This reference covers all available dimensions and metrics for Pinterest Ads data through Detrics. Use this guide to understand what data you can extract and how to structure your queries.

<div>
  <span>Supported destinations:</span>

  <div>
    Google Sheets
  </div>

  <div>
    Looker Studio
  </div>

  <div>
    Claude
  </div>

  <div>
    BigQuery
  </div>
</div>

## Dimensions

Dimensions are the attributes you can use to segment and group your Pinterest Ads data.

### Advertiser

|                               |                                                                                                                           |
| ----------------------------- | ------------------------------------------------------------------------------------------------------------------------- |
| <div>Advertiser ID</div>      | The unique identifier for the advertiser<br /><br />**Field Name:** `AD_ACCOUNT_ID`<br />**Type:** dimension              |
| <div>Advertiser Name</div>    | The name of the advertiser<br /><br />**Field Name:** `AD_ACCOUNT_NAME`<br />**Type:** dimension                          |
| <div>Advertiser Country</div> | The country of the advertiser<br /><br />**Field Name:** `AD_ACCOUNT_COUNTRY`<br />**Type:** dimension                    |
| <div>Currency</div>           | The currency the advertiser uses<br /><br />**Field Name:** `AD_ACCOUNT_CURRENCY`<br />**Type:** dimension                |
| <div>Owner User ID</div>      | The user ID of the owner of the advertiser<br /><br />**Field Name:** `ADVERTISER_OWNER_USER_ID`<br />**Type:** dimension |
| <div>Advertiser Roles</div>   | The roles of the advertiser<br /><br />**Field Name:** `ADVERTISER_ROLES`<br />**Type:** dimension                        |

### Campaign

|                                           |                                                                                                                                        |
| ----------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------- |
| <div>Campaign ID</div>                    | The unique identifier of the campaign<br /><br />**Field Name:** `CAMPAIGN_ID`<br />**Type:** dimension                                |
| <div>Campaign Name</div>                  | The name of the campaign<br /><br />**Field Name:** `CAMPAIGN_NAME`<br />**Type:** dimension                                           |
| <div>Campaign Status</div>                | The status of the campaign<br /><br />**Field Name:** `CAMPAIGN_STATUS`<br />**Type:** dimension                                       |
| <div>Campaign Objective Type</div>        | The objective type of the campaign<br /><br />**Field Name:** `CAMPAIGN_OBJECTIVE_TYPE`<br />**Type:** dimension                       |
| <div>Daily Budget</div>                   | The daily spend cap of the campaign<br /><br />**Field Name:** `CAMPAIGN_DAILY_SPEND_CAP`<br />**Type:** dimension                     |
| <div>Lifetime Budget</div>                | The lifetime spend cap of the campaign<br /><br />**Field Name:** `CAMPAIGN_LIFETIME_SPEND_CAP`<br />**Type:** dimension               |
| <div>Order Line ID</div>                  | The order line ID of the campaign<br /><br />**Field Name:** `CAMPAIGN_ORDER_LINE_ID`<br />**Type:** dimension                         |
| <div>Campaign Start Date</div>            | The start date and start time of your campaign in UTC<br /><br />**Field Name:** `CAMPAIGN_START_TIME`<br />**Type:** dimension        |
| <div>Campaign End Date</div>              | The end date and end time of your campaign in UTC<br /><br />**Field Name:** `CAMPAIGN_END_TIME`<br />**Type:** dimension              |
| <div>Campaign Created Date</div>          | The date the campaign was created<br /><br />**Field Name:** `CAMPAIGN_CREATED_TIME`<br />**Type:** dimension                          |
| <div>Campaign Updated Date</div>          | The date the campaign was last updated<br /><br />**Field Name:** `CAMPAIGN_UPDATED_TIME`<br />**Type:** dimension                     |
| <div>Budget Optimization is Enabled</div> | Whether the campaign uses budget optimization<br /><br />**Field Name:** `CAMPAIGN_IS_BUDGET_OPTIMIZATION`<br />**Type:** dimension    |
| <div>Campaign Summary Status</div>        | The overall status of the campaign<br /><br />**Field Name:** `CAMPAIGN_SUMMARY_STATUS`<br />**Type:** dimension                       |
| <div>Performance Plus is Enabled</div>    | Whether the campaign is a Performance Plus campaign<br /><br />**Field Name:** `CAMPAIGN_IS_PERFORMANCE_PLUS`<br />**Type:** dimension |

### Ad Group

|                                                 |                                                                                                                                                                         |
| ----------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| <div>Ad Group ID</div>                          | The unique identifier of the ad group<br /><br />**Field Name:** `AD_GROUP_ID`<br />**Type:** dimension                                                                 |
| <div>Ad Group Name</div>                        | The name of the ad group<br /><br />**Field Name:** `AD_GROUP_NAME`<br />**Type:** dimension                                                                            |
| <div>Ad Group Status</div>                      | The status of the ad group<br /><br />**Field Name:** `AD_GROUP_STATUS`<br />**Type:** dimension                                                                        |
| <div>Ad Group Campaign ID</div>                 | The unique identifier of the campaign of the ad group<br /><br />**Field Name:** `AD_GROUP_CAMPAIGN_ID`<br />**Type:** dimension                                        |
| <div>Ad Group Type</div>                        | The type of the ad group<br /><br />**Field Name:** `AD_GROUP_TYPE`<br />**Type:** dimension                                                                            |
| <div>Auto Targeting Enabled</div>               | Whether auto targeting is enabled or not<br /><br />**Field Name:** `AD_GROUP_AUTO_TARGETING_ENABLED`<br />**Type:** dimension                                          |
| <div>Bid</div>                                  | The bid amount of the ad group in the currency of the advertiser account<br /><br />**Field Name:** `AD_GROUP_BID_VALUE`<br />**Type:** dimension                       |
| <div>Billable Event</div>                       | The billable event of the ad group<br /><br />**Field Name:** `AD_GROUP_BILLABLE_EVENT`<br />**Type:** dimension                                                        |
| <div>Budget</div>                               | The budget of the ad group in the currency of the advertiser account<br /><br />**Field Name:** `AD_GROUP_BUDGET_VALUE`<br />**Type:** dimension                        |
| <div>Budget Type</div>                          | The budget type of the ad group<br /><br />**Field Name:** `AD_GROUP_BUDGET_TYPE`<br />**Type:** dimension                                                              |
| <div>Lifetime Frequency Cap</div>               | Lifetime frequency cap of the ad group<br /><br />**Field Name:** `AD_GROUP_LIFETIME_FREQUENCY_CAP`<br />**Type:** dimension                                            |
| <div>Optimization Goal Conversion Tag ID</div>  | The unique identifier for the conversion tag of the ad group<br /><br />**Field Name:** `AD_GROUP_OPTIMIZATION_GOAL_CONVERSION_TAG_ID`<br />**Type:** dimension         |
| <div>Optimization Goal Conversion Event</div>   | The conversion event of the ad group<br /><br />**Field Name:** `AD_GROUP_OPTIMIZATION_GOAL_CONVERSION_EVENT`<br />**Type:** dimension                                  |
| <div>Optimization Goal Engagement Window</div>  | The engagement attribution window in days<br /><br />**Field Name:** `AD_GROUP_OPTIMIZATION_GOAL_ENGAGEMENT_WINDOW`<br />**Type:** dimension                            |
| <div>Optimization Goal Click Window</div>       | The click attribution window in days<br /><br />**Field Name:** `AD_GROUP_OPTIMIZATION_GOAL_CLICK_WINDOW`<br />**Type:** dimension                                      |
| <div>Optimization Goal View Window</div>        | The view attribution window in days<br /><br />**Field Name:** `AD_GROUP_OPTIMIZATION_GOAL_VIEW_WINDOW`<br />**Type:** dimension                                        |
| <div>Optimization Goal Learning Mode Type</div> | The learning mode type of the ad group<br /><br />**Field Name:** `AD_GROUP_OPTIMIZATION_GOAL_LEARNING_MODE_TYPE`<br />**Type:** dimension                              |
| <div>Optimization Goal CPA Value</div>          | The CPA goal value of the ad group in the currency of the advertiser account<br /><br />**Field Name:** `AD_GROUP_OPTIMIZATION_GOAL_CPA_VALUE`<br />**Type:** dimension |
| <div>Pacing Delivery Type</div>                 | The pacing delivery type of the ad group<br /><br />**Field Name:** `AD_GROUP_PACING_DELIVERY_TYPE`<br />**Type:** dimension                                            |
| <div>Pin Promotion IDs</div>                    | The unique identifiers for the pin promotions of the ad group<br /><br />**Field Name:** `AD_GROUP_PIN_PROMOTION_IDS`<br />**Type:** dimension                          |
| <div>Placement Group</div>                      | List of placements group for the ad group<br /><br />**Field Name:** `AD_GROUP_PLACEMENT_GROUP`<br />**Type:** dimension                                                |
| <div>Targeting App Type</div>                   | List of app types the ad group is targeting<br /><br />**Field Name:** `AD_GROUP_TARGETING_SPEC_APP_TYPE`<br />**Type:** dimension                                      |
| <div>Targeting Gender</div>                     | List of genders the ad group is targeting<br /><br />**Field Name:** `AD_GROUP_TARGETING_SPEC_GENDER`<br />**Type:** dimension                                          |
| <div>Targeting Locale</div>                     | List of locales the ad group is targeting<br /><br />**Field Name:** `AD_GROUP_TARGETING_SPEC_LOCALE`<br />**Type:** dimension                                          |
| <div>Targeting Location</div>                   | List of locations the ad group is targeting<br /><br />**Field Name:** `AD_GROUP_TARGETING_SPEC_LOCATION`<br />**Type:** dimension                                      |
| <div>Targeting Geo</div>                        | List of geolocations the ad group is targeting<br /><br />**Field Name:** `AD_GROUP_TARGETING_SPEC_GEO`<br />**Type:** dimension                                        |
| <div>Tracking URLs</div>                        | The tracking URLs of the ad group<br /><br />**Field Name:** `AD_GROUP_TRACKING_URLS`<br />**Type:** dimension                                                          |
| <div>Ad Group Summary Status</div>              | The overall status of the ad group<br /><br />**Field Name:** `AD_GROUP_SUMMARY_STATUS`<br />**Type:** dimension                                                        |
| <div>Bid Strategy Type</div>                    | The bid strategy type for the ad group<br /><br />**Field Name:** `AD_GROUP_BID_STRATEGY_TYPE`<br />**Type:** dimension                                                 |
| <div>Ad Group Start Date</div>                  | The start date and start time of your ad group in UTC<br /><br />**Field Name:** `AD_GROUP_START_TIME`<br />**Type:** dimension                                         |
| <div>Ad Group End Date</div>                    | The end date and end time of your ad group in UTC<br /><br />**Field Name:** `AD_GROUP_END_TIME`<br />**Type:** dimension                                               |
| <div>Ad Group Created Date</div>                | The date the ad group was created<br /><br />**Field Name:** `AD_GROUP_CREATED_TIME`<br />**Type:** dimension                                                           |
| <div>Ad Group Updated Date</div>                | The date the ad group was last updated<br /><br />**Field Name:** `AD_GROUP_UPDATED_TIME`<br />**Type:** dimension                                                      |

### Ad

|                               |                                                                                                                                                           |
| ----------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------- |
| <div>Ad ID</div>              | The unique ID of the ad/pin promotion<br /><br />**Field Name:** `AD_ID`<br />**Type:** dimension                                                         |
| <div>Ad Name</div>            | Name of promoted pin / ad<br /><br />**Field Name:** `AD_NAME`<br />**Type:** dimension                                                                   |
| <div>Ad Status</div>          | Status of promoted pin / ad<br /><br />**Field Name:** `AD_STATUS`<br />**Type:** dimension                                                               |
| <div>Pin ID</div>             | ID of the pin used in the promoted pin / ad<br /><br />**Field Name:** `PIN_ID`<br />**Type:** dimension                                                  |
| <div>Creative Type</div>      | Creative type used in the promoted pin / ad<br /><br />**Field Name:** `AD_CREATIVE_TYPE`<br />**Type:** dimension                                        |
| <div>Destination URL</div>    | Destination URL used in promoted pin / ad<br /><br />**Field Name:** `DESTINATION_URL`<br />**Type:** dimension                                           |
| <div>Android Deep Link</div>  | Deep link for Android apps used in pin<br /><br />**Field Name:** `PIN_PROMOTION_ANDROID_DEEP_LINK`<br />**Type:** dimension                              |
| <div>iOS Deep Link</div>      | Deep link for iOS apps used in pin<br /><br />**Field Name:** `PIN_PROMOTION_IOS_DEEP_LINK`<br />**Type:** dimension                                      |
| <div>Click Tracking URL</div> | 3rd-party click tracking URL used on promoted pin / ad<br /><br />**Field Name:** `PIN_PROMOTION_CLICK_TRACKING_URL`<br />**Type:** dimension             |
| <div>View Tracking URL</div>  | 3rd-party impression or view tracking URL used on promoted pin / ad<br /><br />**Field Name:** `PIN_PROMOTION_VIEW_TRACKING_URL`<br />**Type:** dimension |
| <div>Review Status</div>      | Review status of promoted pin / ad<br /><br />**Field Name:** `PIN_PROMOTION_REVIEW_STATUS`<br />**Type:** dimension                                      |
| <div>Is Pin Deleted</div>     | TRUE if pin has been deleted, FALSE if pin still exists<br /><br />**Field Name:** `PIN_PROMOTION_IS_PIN_DELETED`<br />**Type:** dimension                |
| <div>Grid Click Type</div>    | The type of click interaction for the ad<br /><br />**Field Name:** `AD_GRID_CLICK_TYPE`<br />**Type:** dimension                                         |
| <div>Ad Summary Status</div>  | The overall status of the ad<br /><br />**Field Name:** `AD_SUMMARY_STATUS`<br />**Type:** dimension                                                      |
| <div>Ad Created Date</div>    | The date the promoted pin was created<br /><br />**Field Name:** `AD_CREATED_TIME`<br />**Type:** dimension                                               |
| <div>Ad Updated Date</div>    | The date the promoted pin was last updated<br /><br />**Field Name:** `AD_UPDATED_TIME`<br />**Type:** dimension                                          |

### UTM Parameters

|                         |                                                                                                                                               |
| ----------------------- | --------------------------------------------------------------------------------------------------------------------------------------------- |
| <div>UTM Source</div>   | Value of the utm\_source parameter extracted from the ad destination URL<br /><br />**Field Name:** `UTM_SOURCE`<br />**Type:** dimension     |
| <div>UTM Medium</div>   | Value of the utm\_medium parameter extracted from the ad destination URL<br /><br />**Field Name:** `UTM_MEDIUM`<br />**Type:** dimension     |
| <div>UTM Campaign</div> | Value of the utm\_campaign parameter extracted from the ad destination URL<br /><br />**Field Name:** `UTM_CAMPAIGN`<br />**Type:** dimension |
| <div>UTM Content</div>  | Value of the utm\_content parameter extracted from the ad destination URL<br /><br />**Field Name:** `UTM_CONTENT`<br />**Type:** dimension   |
| <div>UTM Term</div>     | Value of the utm\_term parameter extracted from the ad destination URL<br /><br />**Field Name:** `UTM_TERM`<br />**Type:** dimension         |

### Targeting Breakdown

|                              |                                                                                                                                            |
| ---------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------ |
| <div>Targeting Type</div>    | The type of targeting applied (e.g., KEYWORD, GENDER, AGE\_BUCKET)<br /><br />**Field Name:** `TARGETING_TYPE`<br />**Type:** dimension    |
| <div>Targeting Value</div>   | The value of the targeting applied<br /><br />**Field Name:** `TARGETING_VALUE`<br />**Type:** dimension                                   |
| <div>Keyword</div>           | Keyword targeting value when targeting type is KEYWORD<br /><br />**Field Name:** `TARGETING_KEYWORD`<br />**Type:** dimension             |
| <div>Gender</div>            | Gender targeting value when targeting type is GENDER<br /><br />**Field Name:** `TARGETING_GENDER`<br />**Type:** dimension                |
| <div>Age Group</div>         | Age group targeting value when targeting type is AGE\_BUCKET<br /><br />**Field Name:** `TARGETING_AGE`<br />**Type:** dimension           |
| <div>Country Code</div>      | Country code targeting value when targeting type is GEO<br /><br />**Field Name:** `TARGETING_COUNTRY`<br />**Type:** dimension            |
| <div>Region Code</div>       | Region code targeting value when targeting type is GEO<br /><br />**Field Name:** `TARGETING_REGION`<br />**Type:** dimension              |
| <div>Location</div>          | Location targeting value when targeting type is LOCATION<br /><br />**Field Name:** `TARGETING_LOCATION`<br />**Type:** dimension          |
| <div>App Type</div>          | App type targeting value when targeting type is APPTYPE<br /><br />**Field Name:** `TARGETING_APP_TYPE`<br />**Type:** dimension           |
| <div>Feed Type</div>         | Feed type targeting value<br /><br />**Field Name:** `TARGETING_FEED_TYPE`<br />**Type:** dimension                                        |
| <div>Placement</div>         | Placement targeting value when targeting type is PLACEMENT<br /><br />**Field Name:** `TARGETING_PLACEMENT`<br />**Type:** dimension       |
| <div>Targeted Interest</div> | Interest targeting value when targeting type is INTEREST<br /><br />**Field Name:** `TARGETING_TARGETED_INTEREST`<br />**Type:** dimension |
| <div>Pinner Interest</div>   | Pinner interest value for interest-based targeting<br /><br />**Field Name:** `TARGETING_PINNER_INTEREST`<br />**Type:** dimension         |
| <div>Audience Include</div>  | Audience include value for audience targeting<br /><br />**Field Name:** `TARGETING_AUDIENCE_INCLUDE`<br />**Type:** dimension             |

## Metrics

Metrics are the numerical values you can measure and analyze from your Pinterest Ads campaigns.

### Core Metrics

|                                          |                                                                                                                                                                                                                                                                                          |
| ---------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| <div>Spend</div>                         | The money you spent for promoted Pins, in the currency of the advertiser<br /><br />**Field Name:** `SPEND_IN_DOLLAR`<br />**Type:** metric                                                                                                                                              |
| <div>Impressions</div>                   | The number of impressions from earned and paid sources<br /><br />**Field Name:** `TOTAL_IMPRESSION`<br />**Type:** metric                                                                                                                                                               |
| <div>Impressions Paid</div>              | The number of impressions from your promoted Pins. This includes both paid impressions and over-delivered impressions<br /><br />**Field Name:** `IMPRESSION_1`<br />**Type:** metric                                                                                                    |
| <div>Impressions Earned</div>            | The number of impressions from Repins of your promoted Pins<br /><br />**Field Name:** `IMPRESSION_2`<br />**Type:** metric                                                                                                                                                              |
| <div>Frequency</div>                     | The average number of times each user saw your ad<br /><br />**Field Name:** `TOTAL_IMPRESSION_FREQUENCY`<br />**Type:** metric                                                                                                                                                          |
| <div>Reach</div>                         | Total number of unique users who saw your ads<br /><br />**Field Name:** `TOTAL_IMPRESSION_USER`<br />**Type:** metric                                                                                                                                                                   |
| <div>Clicks</div>                        | The number of clicks from earned and paid sources<br /><br />**Field Name:** `TOTAL_CLICKTHROUGH`<br />**Type:** metric                                                                                                                                                                  |
| <div>Clicks Paid</div>                   | The number of clicks from your promoted Pins. This includes both paid clicks and over-delivered clicks<br /><br />**Field Name:** `CLICKTHROUGH_1`<br />**Type:** metric                                                                                                                 |
| <div>Clicks Earned</div>                 | The number of clicks from Repins of your promoted Pins<br /><br />**Field Name:** `CLICKTHROUGH_2`<br />**Type:** metric                                                                                                                                                                 |
| <div>CTR</div>                           | Click-through rate<br /><br />**Field Name:** `ECTR`<br />**Type:** metric                                                                                                                                                                                                               |
| <div>CTR Paid</div>                      | The click-through rate of paid sources<br /><br />**Field Name:** `CTR`<br />**Type:** metric                                                                                                                                                                                            |
| <div>CTR Earned</div>                    | The click-through rate of earned sources<br /><br />**Field Name:** `CTR_2`<br />**Type:** metric                                                                                                                                                                                        |
| <div>Outbound Clicks Paid</div>          | The number of paid outbound clicks from your promoted Pins<br /><br />**Field Name:** `OUTBOUND_CLICK_1`<br />**Type:** metric                                                                                                                                                           |
| <div>Outbound Clicks Earned</div>        | The number of earned outbound clicks from your promoted Pins<br /><br />**Field Name:** `OUTBOUND_CLICK_2`<br />**Type:** metric                                                                                                                                                         |
| <div>Conversions</div>                   | This is the sum of all website conversions. For example, if you track sign ups and checkouts on your website, it's the sum of all sign ups and checkouts attributed from clicks, engagements and views on Pinterest<br /><br />**Field Name:** `TOTAL_CONVERSIONS`<br />**Type:** metric |
| <div>Conversions Quantity</div>          | Conversions quantity<br /><br />**Field Name:** `TOTAL_CONVERSIONS_QUANTITY`<br />**Type:** metric                                                                                                                                                                                       |
| <div>Conversions Value</div>             | Conversions value<br /><br />**Field Name:** `TOTAL_CONVERSIONS_VALUE_IN_MICRO_DOLLAR`<br />**Type:** metric                                                                                                                                                                             |
| <div>Saves Paid</div>                    | The number of paid Repins of your promoted Pins<br /><br />**Field Name:** `REPIN_1`<br />**Type:** metric                                                                                                                                                                               |
| <div>Saves Earned</div>                  | The number of unpaid Repins of your promoted Pins<br /><br />**Field Name:** `REPIN_2`<br />**Type:** metric                                                                                                                                                                             |
| <div>Save Rate Paid</div>                | The rate of paid Repins<br /><br />**Field Name:** `REPIN_RATE`<br />**Type:** metric                                                                                                                                                                                                    |
| <div>Save Rate</div>                     | The rate of Repins<br /><br />**Field Name:** `TOTAL_REPIN_RATE`<br />**Type:** metric                                                                                                                                                                                                   |
| <div>Carousel Swipes Paid</div>          | The number of paid swipes from your promoted carousel Pins<br /><br />**Field Name:** `CAROUSEL_SWIPE_1`<br />**Type:** metric                                                                                                                                                           |
| <div>Carousel Swipes Earned</div>        | The number of non-paid swipes from your promoted carousel Pins<br /><br />**Field Name:** `CAROUSEL_SWIPE_2`<br />**Type:** metric                                                                                                                                                       |
| <div>Engagements</div>                   | Total engagements from earned and paid sources<br /><br />**Field Name:** `TOTAL_ENGAGEMENT`<br />**Type:** metric                                                                                                                                                                       |
| <div>Engagements Paid</div>              | Total engagements from paid sources<br /><br />**Field Name:** `ENGAGEMENT_1`<br />**Type:** metric                                                                                                                                                                                      |
| <div>Engagements Earned</div>            | Total engagements from earned sources<br /><br />**Field Name:** `ENGAGEMENT_2`<br />**Type:** metric                                                                                                                                                                                    |
| <div>CPM</div>                           | Cost per mille<br /><br />**Field Name:** `CPM_IN_DOLLAR`<br />**Type:** metric                                                                                                                                                                                                          |
| <div>CPC</div>                           | Cost per click<br /><br />**Field Name:** `ECPC_IN_DOLLAR`<br />**Type:** metric                                                                                                                                                                                                         |
| <div>CPE</div>                           | Cost per engagement<br /><br />**Field Name:** `ECPE_IN_DOLLAR`<br />**Type:** metric                                                                                                                                                                                                    |
| <div>Cost Per Outbound Click</div>       | Average cost per total outbound click (paid and earned)<br /><br />**Field Name:** `COST_PER_OUTBOUND_CLICK_IN_DOLLAR`<br />**Type:** metric                                                                                                                                             |
| <div>Engagement Rate Paid</div>          | Paid engagements divided by paid impressions<br /><br />**Field Name:** `ENGAGEMENT_RATE`<br />**Type:** metric                                                                                                                                                                          |
| <div>Engagement Rate</div>               | Total engagements divided by total impressions<br /><br />**Field Name:** `EENGAGEMENT_RATE`<br />**Type:** metric                                                                                                                                                                       |
| <div>Page Visits</div>                   | Total number of page visit events resulting from interactions with your ad<br /><br />**Field Name:** `TOTAL_PAGE_VISIT`<br />**Type:** metric                                                                                                                                           |
| <div>Page Visit Conversion Rate</div>    | Total conversions divided by total clicks<br /><br />**Field Name:** `TOTAL_PAGE_VISIT_CONVERSION_RATE`<br />**Type:** metric                                                                                                                                                            |
| <div>Add to Cart Conversion Rate</div>   | The number of conversions per the number of total ad impressions that can be tracked to a conversion during the same time period<br /><br />**Field Name:** `TOTAL_ADD_TO_CART_CONVERSION_RATE`<br />**Type:** metric                                                                    |
| <div>Checkout Conversion Rate</div>      | The number of conversions per the number of total ad impressions that can be tracked to a conversion during the same time period<br /><br />**Field Name:** `TOTAL_CHECKOUT_CONVERSION_RATE`<br />**Type:** metric                                                                       |
| <div>Search Conversion Rate</div>        | The number of conversions per the number of total ad impressions that can be tracked to a conversion during the same time period<br /><br />**Field Name:** `TOTAL_SEARCH_CONVERSION_RATE`<br />**Type:** metric                                                                         |
| <div>Category View Conversion Rate</div> | The number of conversions per the number of total ad impressions that can be tracked to a conversion during the same time period<br /><br />**Field Name:** `TOTAL_VIEW_CATEGORY_CONVERSION_RATE`<br />**Type:** metric                                                                  |
| <div>Gross Pin Clicks</div>              | Unfiltered number of times someone clicks your ad (paid)<br /><br />**Field Name:** `CLICKTHROUGH_1_GROSS`<br />**Type:** metric                                                                                                                                                         |
| <div>Gross Impressions</div>             | Unfiltered number of times your ad was on screen (paid)<br /><br />**Field Name:** `IMPRESSION_1_GROSS`<br />**Type:** metric                                                                                                                                                            |
| <div>Leads</div>                         | Total number of leads generated from your ads<br /><br />**Field Name:** `LEADS`<br />**Type:** metric                                                                                                                                                                                   |
| <div>Cost per Lead</div>                 | Average cost per lead generated from your ads<br /><br />**Field Name:** `COST_PER_LEAD`<br />**Type:** metric                                                                                                                                                                           |
| <div>Paid Impressions</div>              | Number of paid impressions from your promoted Pins<br /><br />**Field Name:** `PAID_IMPRESSION`<br />**Type:** metric                                                                                                                                                                    |
| <div>Add to Wishlist</div>               | Total number of add to wishlist events resulting from interactions with your ads<br /><br />**Field Name:** `TOTAL_ADD_TO_WISHLIST`<br />**Type:** metric                                                                                                                                |
| <div>Subscriptions</div>                 | Total number of subscription events resulting from interactions with your ads<br /><br />**Field Name:** `TOTAL_SUBSCRIBE`<br />**Type:** metric                                                                                                                                         |

### Video Engagements

|                                             |                                                                                                                                                                                                                                  |
| ------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| <div>Video Starts</div>                     | Total number of times your video ad started playing (paid and earned)<br /><br />**Field Name:** `TOTAL_VIDEO_P0_COMBINED`<br />**Type:** metric                                                                                 |
| <div>Video Starts Paid</div>                | Number of times your video ad started playing<br /><br />**Field Name:** `VIDEO_P0_COMBINED_1`<br />**Type:** metric                                                                                                             |
| <div>Video Starts Earned</div>              | Number of times your video ad started playing after it was saved to another person's board<br /><br />**Field Name:** `VIDEO_P0_COMBINED_2`<br />**Type:** metric                                                                |
| <div>Video Views</div>                      | Total number of times your video ad played continuously for 2 seconds while 50% in view (paid and earned)<br /><br />**Field Name:** `TOTAL_VIDEO_MRC_VIEWS`<br />**Type:** metric                                               |
| <div>Video Views Paid</div>                 | Number of times your video ad played continuously for 2 seconds while 50% in view<br /><br />**Field Name:** `VIDEO_MRC_VIEWS_1`<br />**Type:** metric                                                                           |
| <div>Video Views Earned</div>               | Number of times your video ad played continuously for 2 seconds while 50% in view after being saved to another person's board<br /><br />**Field Name:** `VIDEO_MRC_VIEWS_2`<br />**Type:** metric                               |
| <div>Three Second Video Views</div>         | Total number of times your video ad played continuously for at least 3 seconds while 50% visible (includes both paid and earned)<br /><br />**Field Name:** `TOTAL_VIDEO_3SEC_VIEWS`<br />**Type:** metric                       |
| <div>Three Second Video Views Earned</div>  | Number of times your video ad played continuously for 3 seconds while 50% in view after being saved to another person's board<br /><br />**Field Name:** `VIDEO_3SEC_VIEWS_2`<br />**Type:** metric                              |
| <div>Video Avg. Watch Time (s)</div>        | Average watch time of all video ads, including seeks and loops<br /><br />**Field Name:** `TOTAL_VIDEO_AVG_WATCHTIME_IN_SECOND`<br />**Type:** metric                                                                            |
| <div>Video Avg. Watch Time (s) Paid</div>   | Average watch time of all video ads, including seeks and loops<br /><br />**Field Name:** `VIDEO_AVG_WATCHTIME_IN_SECOND_1`<br />**Type:** metric                                                                                |
| <div>Video Avg. Watch Time (s) Earned</div> | Average watch time of all video ads, including seeks and loops, after being saved to another person's board<br /><br />**Field Name:** `VIDEO_AVG_WATCHTIME_IN_SECOND_2`<br />**Type:** metric                                   |
| <div>Video Views at 25%</div>               | Total number of times your video ad reached 25% of its length, including views that skipped ahead to this point (paid and earned)<br /><br />**Field Name:** `TOTAL_VIDEO_P25_COMBINED`<br />**Type:** metric                    |
| <div>Video Views at 25% Paid</div>          | Number of times your video ad reached 25% of its length, including views that skipped ahead to this point<br /><br />**Field Name:** `VIDEO_P25_COMBINED_1`<br />**Type:** metric                                                |
| <div>Video Views at 25% Earned</div>        | Number of times your video ad reached 25% of its length after it was saved to another person's board, including views that skipped ahead to this point<br /><br />**Field Name:** `VIDEO_P25_COMBINED_2`<br />**Type:** metric   |
| <div>Video Views at 50%</div>               | Total number of times your video ad reached 50% of its length, including views that skipped ahead to this point (paid and earned)<br /><br />**Field Name:** `TOTAL_VIDEO_P50_COMBINED`<br />**Type:** metric                    |
| <div>Video Views at 50% Paid</div>          | Number of times your video ad reached 50% of its length, including views that skipped ahead to this point<br /><br />**Field Name:** `VIDEO_P50_COMBINED_1`<br />**Type:** metric                                                |
| <div>Video Views at 50% Earned</div>        | Number of times your video ad reached 50% of its length after it was saved to another person's board, including views that skipped ahead to this point<br /><br />**Field Name:** `VIDEO_P50_COMBINED_2`<br />**Type:** metric   |
| <div>Video Views at 75%</div>               | Total number of times your video ad reached 75% of its length, including views that skipped ahead to this point (paid and earned)<br /><br />**Field Name:** `TOTAL_VIDEO_P75_COMBINED`<br />**Type:** metric                    |
| <div>Video Views at 75% Paid</div>          | Number of times your video ad reached 75% of its length, including views that skipped ahead to this point<br /><br />**Field Name:** `VIDEO_P75_COMBINED_1`<br />**Type:** metric                                                |
| <div>Video Views at 75% Earned</div>        | Number of times your video ad reached 75% of its length after it was saved to another person's board, including views that skipped ahead to this point<br /><br />**Field Name:** `VIDEO_P75_COMBINED_2`<br />**Type:** metric   |
| <div>Video Views at 95%</div>               | Total number of times your video ad reached 95% of its length, including views that skipped ahead to this point (paid and earned)<br /><br />**Field Name:** `TOTAL_VIDEO_P95_COMBINED`<br />**Type:** metric                    |
| <div>Video Views at 95% Paid</div>          | Number of times your video ad reached 95% of its length, including views that skipped ahead to this point<br /><br />**Field Name:** `VIDEO_P95_COMBINED_1`<br />**Type:** metric                                                |
| <div>Video Views at 95% Earned</div>        | Number of times your video ad reached 95% of its length after it was saved to another person's board, including views that skipped ahead to this point<br /><br />**Field Name:** `VIDEO_P95_COMBINED_2`<br />**Type:** metric   |
| <div>Video Views at 100%</div>              | Total number of times your video ad reached 100% of its length, including views that skipped ahead to this point (paid and earned)<br /><br />**Field Name:** `TOTAL_VIDEO_P100_COMPLETE`<br />**Type:** metric                  |
| <div>Video Views at 100% Earned</div>       | Number of times your video ad reached 100% of its length after it was saved to another person's board, including views that skipped ahead to this point<br /><br />**Field Name:** `VIDEO_P100_COMPLETE_2`<br />**Type:** metric |
| <div>CPCV (100%)</div>                      | Average cost per video view that was played until completion, including views that skipped ahead to this point<br /><br />**Field Name:** `ECPCV_IN_DOLLAR`<br />**Type:** metric                                                |
| <div>CPCV (95%)</div>                       | Average cost per video that was played until 95% of its length, including views that skipped ahead to this point<br /><br />**Field Name:** `ECPCV_P95_IN_DOLLAR`<br />**Type:** metric                                          |
| <div>CPV</div>                              | Average cost per video view<br /><br />**Field Name:** `ECPV_IN_DOLLAR`<br />**Type:** metric                                                                                                                                    |
| <div>Video 100% (Paid)</div>                | Number of times your paid video ad reached 100% of its length, including views that skipped ahead to this point<br /><br />**Field Name:** `VIDEO_P100_COMPLETE_1`<br />**Type:** metric                                         |
| <div>Video Spend</div>                      | Total spend on video ads<br /><br />**Field Name:** `VIDEO_SPEND_IN_DOLLAR`<br />**Type:** metric                                                                                                                                |
| <div>Paid Video Viewable Rate</div>         | The percentage of paid video impressions that were viewable<br /><br />**Field Name:** `PAID_VIDEO_VIEWABLE_RATE`<br />**Type:** metric                                                                                          |

### Conversions Add to Cart

|                                                               |                                                                                                                                                                                                   |
| ------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| <div>Conversions (Add to Cart)</div>                          | Total number of add to cart events resulting from interactions with your ad<br /><br />**Field Name:** `TOTAL_ADD_TO_CART`<br />**Type:** metric                                                  |
| <div>Conversions Value (Add to Cart)</div>                    | Total value of add to cart events resulting from interactions with your ad<br /><br />**Field Name:** `TOTAL_ADD_TO_CART_VALUE_IN_MICRO_DOLLAR`<br />**Type:** metric                             |
| <div>Click-through Conversions (Add to Cart)</div>            | Total number of add to cart events resulting from clicks on your ads<br /><br />**Field Name:** `TOTAL_CLICK_ADD_TO_CART`<br />**Type:** metric                                                   |
| <div>Conversion Quantity from Add to Cart - Clicks</div>      | Total quantity of add to cart events resulting from clicks on your ads<br /><br />**Field Name:** `TOTAL_CLICK_ADD_TO_CART_QUANTITY`<br />**Type:** metric                                        |
| <div>Click-through Value (Add to Cart)</div>                  | Total value of add to cart events resulting from clicks on your ads<br /><br />**Field Name:** `TOTAL_CLICK_ADD_TO_CART_VALUE_IN_MICRO_DOLLAR`<br />**Type:** metric                              |
| <div>Engagement Conversions (Add to Cart)</div>               | Total number of add to cart events resulting from engagement with your ads<br /><br />**Field Name:** `TOTAL_ENGAGEMENT_ADD_TO_CART`<br />**Type:** metric                                        |
| <div>Conversion Quantity from Add to Cart - Engagements</div> | Total quantity of add to cart events resulting from engagement with your ads<br /><br />**Field Name:** `TOTAL_ENGAGEMENT_ADD_TO_CART_QUANTITY`<br />**Type:** metric                             |
| <div>Engagement Value (Add to Cart)</div>                     | Total value of add to cart events resulting from engagement with your ads<br /><br />**Field Name:** `TOTAL_ENGAGEMENT_ADD_TO_CART_VALUE_IN_MICRO_DOLLAR`<br />**Type:** metric                   |
| <div>View-through Conversions (Add to Cart)</div>             | Total number of add to cart events resulting from views of your ads<br /><br />**Field Name:** `TOTAL_VIEW_ADD_TO_CART`<br />**Type:** metric                                                     |
| <div>Conversion Quantity from Add to Cart - Views</div>       | Total quantity of add to cart events resulting from views of your ads<br /><br />**Field Name:** `TOTAL_VIEW_ADD_TO_CART_QUANTITY`<br />**Type:** metric                                          |
| <div>View-through Value (Add to Cart)</div>                   | Total value of add to cart events resulting from views of your ads<br /><br />**Field Name:** `TOTAL_VIEW_ADD_TO_CART_VALUE_IN_MICRO_DOLLAR`<br />**Type:** metric                                |
| <div>Web Conversions (Add to Cart)</div>                      | Total number of web add to cart events resulting from interactions with your ads<br /><br />**Field Name:** `TOTAL_WEB_ADD_TO_CART`<br />**Type:** metric                                         |
| <div>Web Order Value (Add to Cart)</div>                      | Total value of web add to cart events resulting from interactions with your ads<br /><br />**Field Name:** `TOTAL_WEB_ADD_TO_CART_VALUE_IN_MICRO_DOLLAR`<br />**Type:** metric                    |
| <div>Web Click-through Conversions (Add to Cart)</div>        | Total number of web add to cart events resulting from clicks on your ads<br /><br />**Field Name:** `TOTAL_WEB_CLICK_ADD_TO_CART`<br />**Type:** metric                                           |
| <div>Web Click-through Order Value (Add to Cart)</div>        | Total value of web add to cart events resulting from interactions with your ads<br /><br />**Field Name:** `TOTAL_WEB_CLICK_ADD_TO_CART_VALUE_IN_MICRO_DOLLAR`<br />**Type:** metric              |
| <div>Web Engagement Conversions (Add to Cart)</div>           | Total number of web add to cart events resulting from engagement with your ads<br /><br />**Field Name:** `TOTAL_WEB_ENGAGEMENT_ADD_TO_CART`<br />**Type:** metric                                |
| <div>Web Engagement Order Value (Add to Cart)</div>           | Total value of web add to cart events resulting from engagement with your ads<br /><br />**Field Name:** `TOTAL_WEB_ENGAGEMENT_ADD_TO_CART_VALUE_IN_MICRO_DOLLAR`<br />**Type:** metric           |
| <div>Web View-through Conversions (Add to Cart)</div>         | Total number of web add to cart events resulting from views of your ads<br /><br />**Field Name:** `TOTAL_WEB_VIEW_ADD_TO_CART`<br />**Type:** metric                                             |
| <div>Web View-through Order Value (Add to Cart)</div>         | Total value of web add to cart events resulting from views of your ads<br /><br />**Field Name:** `TOTAL_WEB_VIEW_ADD_TO_CART_VALUE_IN_MICRO_DOLLAR`<br />**Type:** metric                        |
| <div>In-app Conversions (Add to Cart)</div>                   | Total number of in-app add to cart events resulting from interactions with your ads<br /><br />**Field Name:** `TOTAL_INAPP_ADD_TO_CART`<br />**Type:** metric                                    |
| <div>In-app Order Value (Add to Cart)</div>                   | Total value of in-app add to cart events resulting from interactions with your ads<br /><br />**Field Name:** `TOTAL_INAPP_ADD_TO_CART_VALUE_IN_MICRO_DOLLAR`<br />**Type:** metric               |
| <div>In-app Click-through Conversions (Add to Cart)</div>     | Total number of in-app add to cart events resulting from clicks on your ads<br /><br />**Field Name:** `TOTAL_INAPP_CLICK_ADD_TO_CART`<br />**Type:** metric                                      |
| <div>In-app Click-through Order Value (Add to Cart)</div>     | Total value of in-app add to cart events resulting from clicks on your ads<br /><br />**Field Name:** `TOTAL_INAPP_CLICK_ADD_TO_CART_VALUE_IN_MICRO_DOLLAR`<br />**Type:** metric                 |
| <div>In-app Engagement Conversions (Add to Cart)</div>        | Total number of in-app add to cart events resulting from engagement with your ads<br /><br />**Field Name:** `TOTAL_INAPP_ENGAGEMENT_ADD_TO_CART`<br />**Type:** metric                           |
| <div>In-app Engagement Order Value (Add to Cart)</div>        | Total value of in-app add to cart events resulting from engagement with your ads<br /><br />**Field Name:** `TOTAL_INAPP_ENGAGEMENT_ADD_TO_CART_VALUE_IN_MICRO_DOLLAR`<br />**Type:** metric      |
| <div>In-app View-through Conversions (Add to Cart)</div>      | Total number of in-app add to cart events resulting from views of your ads<br /><br />**Field Name:** `TOTAL_INAPP_VIEW_ADD_TO_CART`<br />**Type:** metric                                        |
| <div>In-app View-through Order Value (Add to Cart)</div>      | Total value of in-app add to cart events resulting from views of your ads<br /><br />**Field Name:** `TOTAL_INAPP_VIEW_ADD_TO_CART_VALUE_IN_MICRO_DOLLAR`<br />**Type:** metric                   |
| <div>CPA (Add to Cart)</div>                                  | Average cost per add to cart event<br /><br />**Field Name:** `ADD_TO_CART_COST_PER_ACTION`<br />**Type:** metric                                                                                 |
| <div>ROAS (Add to Cart)</div>                                 | Average return on ad spend for add to cart events<br /><br />**Field Name:** `ADD_TO_CART_ROAS`<br />**Type:** metric                                                                             |
| <div>In-app CPA (Add to Cart)</div>                           | Average cost per in-app add to cart events<br /><br />**Field Name:** `INAPP_ADD_TO_CART_COST_PER_ACTION`<br />**Type:** metric                                                                   |
| <div>In-app ROAS (Add to Cart)</div>                          | Average return on spend for in-app add to cart events<br /><br />**Field Name:** `INAPP_ADD_TO_CART_ROAS`<br />**Type:** metric                                                                   |
| <div>Add to Cart Desktop to Desktop</div>                     | Total number of desktop add to cart actions leading to a desktop add to cart conversion<br /><br />**Field Name:** `TOTAL_ADD_TO_CART_DESKTOP_ACTION_TO_DESKTOP_CONVERSION`<br />**Type:** metric |
| <div>Add to Cart Desktop to Mobile</div>                      | Total number of desktop add to cart actions leading to a mobile add to cart conversion<br /><br />**Field Name:** `TOTAL_ADD_TO_CART_DESKTOP_ACTION_TO_MOBILE_CONVERSION`<br />**Type:** metric   |
| <div>Add to Cart Desktop to Tablet</div>                      | Total number of desktop add to cart actions leading to a tablet add to cart conversion<br /><br />**Field Name:** `TOTAL_ADD_TO_CART_DESKTOP_ACTION_TO_TABLET_CONVERSION`<br />**Type:** metric   |
| <div>Add to Cart Mobile to Desktop</div>                      | Total number of mobile add to cart actions leading to a desktop add to cart conversion<br /><br />**Field Name:** `TOTAL_ADD_TO_CART_MOBILE_ACTION_TO_DESKTOP_CONVERSION`<br />**Type:** metric   |
| <div>Add to Cart Mobile to Mobile</div>                       | Total number of mobile add to cart actions leading to a mobile add to cart conversion<br /><br />**Field Name:** `TOTAL_ADD_TO_CART_MOBILE_ACTION_TO_MOBILE_CONVERSION`<br />**Type:** metric     |
| <div>Add to Cart Mobile to Tablet</div>                       | Total number of desktop add to cart actions leading to a mobile add to cart conversion<br /><br />**Field Name:** `TOTAL_ADD_TO_CART_MOBILE_ACTION_TO_TABLET_CONVERSION`<br />**Type:** metric    |
| <div>Add to Cart Tablet to Desktop</div>                      | Total number of tablet add to cart actions leading to a desktop add to cart conversion<br /><br />**Field Name:** `TOTAL_ADD_TO_CART_TABLET_ACTION_TO_DESKTOP_CONVERSION`<br />**Type:** metric   |
| <div>Add to Cart Tablet to Mobile</div>                       | Total number of tablet add to cart actions leading to a mobile add to cart conversion<br /><br />**Field Name:** `TOTAL_ADD_TO_CART_TABLET_ACTION_TO_MOBILE_CONVERSION`<br />**Type:** metric     |
| <div>Add to Cart Tablet to Tablet</div>                       | Total number of tablet add to cart actions leading to a tablet add to cart conversion<br /><br />**Field Name:** `TOTAL_ADD_TO_CART_TABLET_ACTION_TO_TABLET_CONVERSION`<br />**Type:** metric     |

### Conversions App Install

|                                                           |                                                                                                                                                                                                   |
| --------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| <div>Conversions (App Install)</div>                      | Total number of app install events resulting from interactions with your ads<br /><br />**Field Name:** `TOTAL_APP_INSTALL`<br />**Type:** metric                                                 |
| <div>Order Value (App Install)</div>                      | Total value of app install events resulting from interactions with your ad<br /><br />**Field Name:** `TOTAL_APP_INSTALL_VALUE_IN_MICRO_DOLLAR`<br />**Type:** metric                             |
| <div>Click-through Conversions (App Install)</div>        | Total number of app install events resulting from clicks on your ads<br /><br />**Field Name:** `TOTAL_CLICK_APP_INSTALL`<br />**Type:** metric                                                   |
| <div>Click-through Value (App Install)</div>              | Total value of app install events resulting from clicks on your ads<br /><br />**Field Name:** `TOTAL_CLICK_APP_INSTALL_VALUE_IN_MICRO_DOLLAR`<br />**Type:** metric                              |
| <div>Engagement Conversions (App Install)</div>           | Total number of app install events resulting from engagement with your ads<br /><br />**Field Name:** `TOTAL_ENGAGEMENT_APP_INSTALL`<br />**Type:** metric                                        |
| <div>Engagement Value (App Install)</div>                 | Total value of app install events resulting from engagement with your ads<br /><br />**Field Name:** `TOTAL_ENGAGEMENT_APP_INSTALL_VALUE_IN_MICRO_DOLLAR`<br />**Type:** metric                   |
| <div>View-through Conversions (App Install)</div>         | Total number of app install events resulting from views of your ads<br /><br />**Field Name:** `TOTAL_VIEW_APP_INSTALL`<br />**Type:** metric                                                     |
| <div>View-through Value (App Install)</div>               | Total value of app install events resulting from views of your ads<br /><br />**Field Name:** `TOTAL_VIEW_APP_INSTALL_VALUE_IN_MICRO_DOLLAR`<br />**Type:** metric                                |
| <div>In-app Conversions (App Install)</div>               | Total number of in-app app install events resulting from interactions with your ads<br /><br />**Field Name:** `TOTAL_INAPP_APP_INSTALL`<br />**Type:** metric                                    |
| <div>In-app Order Value (App Install)</div>               | Total value of in-app app install events resulting from interactions with your ad<br /><br />**Field Name:** `TOTAL_INAPP_APP_INSTALL_VALUE_IN_MICRO_DOLLAR`<br />**Type:** metric                |
| <div>In-app Click-through Conversions (App Install)</div> | Total number of in-app app install events resulting from clicks on your ads<br /><br />**Field Name:** `TOTAL_INAPP_CLICK_APP_INSTALL`<br />**Type:** metric                                      |
| <div>In-app Click-through Order Value (App Install)</div> | Total value of in-app app install events resulting from clicks on your ads<br /><br />**Field Name:** `TOTAL_INAPP_CLICK_APP_INSTALL_VALUE_IN_MICRO_DOLLAR`<br />**Type:** metric                 |
| <div>In-app Engagement Conversions (App Install)</div>    | Total number of in-app app install events resulting from engagement with your ads<br /><br />**Field Name:** `TOTAL_INAPP_ENGAGEMENT_APP_INSTALL`<br />**Type:** metric                           |
| <div>In-app Engagement Order Value (App Install)</div>    | Total value of in-app app install events resulting from engagement with your ads<br /><br />**Field Name:** `TOTAL_INAPP_ENGAGEMENT_APP_INSTALL_VALUE_IN_MICRO_DOLLAR`<br />**Type:** metric      |
| <div>In-app View-through Conversions (App Install)</div>  | Total number of in-app app install events resulting from views of your ads<br /><br />**Field Name:** `TOTAL_INAPP_VIEW_APP_INSTALL`<br />**Type:** metric                                        |
| <div>In-app View-through Order Value (App Install)</div>  | Total value of in-app app install events resulting from views of your ads<br /><br />**Field Name:** `TOTAL_INAPP_VIEW_APP_INSTALL_VALUE_IN_MICRO_DOLLAR`<br />**Type:** metric                   |
| <div>CPA (App Install)</div>                              | Average cost per app install events<br /><br />**Field Name:** `APP_INSTALL_COST_PER_ACTION`<br />**Type:** metric                                                                                |
| <div>In-app CPA (App Install)</div>                       | Average cost per in-app app install events<br /><br />**Field Name:** `INAPP_APP_INSTALL_COST_PER_ACTION`<br />**Type:** metric                                                                   |
| <div>In-app ROAS (App Install)</div>                      | Average return on ad spend for in-app app install events<br /><br />**Field Name:** `INAPP_APP_INSTALL_ROAS`<br />**Type:** metric                                                                |
| <div>App Install Desktop to Desktop</div>                 | Total number of desktop app install actions leading to a desktop app install conversion<br /><br />**Field Name:** `TOTAL_APP_INSTALL_DESKTOP_ACTION_TO_DESKTOP_CONVERSION`<br />**Type:** metric |
| <div>App Install Desktop to Mobile</div>                  | Total number of desktop app install actions leading to a mobile app install conversion<br /><br />**Field Name:** `TOTAL_APP_INSTALL_DESKTOP_ACTION_TO_MOBILE_CONVERSION`<br />**Type:** metric   |
| <div>App Install Desktop to Tablet</div>                  | Total number of desktop app install actions leading to a tablet app install conversion<br /><br />**Field Name:** `TOTAL_APP_INSTALL_DESKTOP_ACTION_TO_TABLET_CONVERSION`<br />**Type:** metric   |
| <div>App Install Mobile to Desktop</div>                  | Total number of mobile app install actions leading to a desktop app install conversion<br /><br />**Field Name:** `TOTAL_APP_INSTALL_MOBILE_ACTION_TO_DESKTOP_CONVERSION`<br />**Type:** metric   |
| <div>App Install Mobile to Mobile</div>                   | Total number of mobile app install actions leading to a mobile app install conversion<br /><br />**Field Name:** `TOTAL_APP_INSTALL_MOBILE_ACTION_TO_MOBILE_CONVERSION`<br />**Type:** metric     |
| <div>App Install Mobile to Tablet</div>                   | Total number of mobile app install actions leading to a tablet app install conversion<br /><br />**Field Name:** `TOTAL_APP_INSTALL_MOBILE_ACTION_TO_TABLET_CONVERSION`<br />**Type:** metric     |
| <div>App Install Tablet to Desktop</div>                  | Total number of tablet app install actions leading to a desktop app install conversion<br /><br />**Field Name:** `TOTAL_APP_INSTALL_TABLET_ACTION_TO_DESKTOP_CONVERSION`<br />**Type:** metric   |
| <div>App Install Tablet to Mobile</div>                   | Total number of tablet app install actions leading to a mobile app install conversion<br /><br />**Field Name:** `TOTAL_APP_INSTALL_TABLET_ACTION_TO_MOBILE_CONVERSION`<br />**Type:** metric     |
| <div>App Install Tablet to Tablet</div>                   | Total number of tablet app install actions leading to a tablet app install conversion<br /><br />**Field Name:** `TOTAL_APP_INSTALL_TABLET_ACTION_TO_TABLET_CONVERSION`<br />**Type:** metric     |

### Conversions Checkout

|                                                         |                                                                                                                                                                                                                             |
| ------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| <div>Conversions (Checkout)</div>                       | Total number of checkout events that resulted from interactions with your ad<br /><br />**Field Name:** `TOTAL_CHECKOUT`<br />**Type:** metric                                                                              |
| <div>Conversions Value (Checkout)</div>                 | Total value of checkout events resulting from interactions with your ad<br /><br />**Field Name:** `TOTAL_CHECKOUT_VALUE_IN_MICRO_DOLLAR`<br />**Type:** metric                                                             |
| <div>Click-through Conversions (Checkout)</div>         | Checkouts that can be traced back to when somebody clicked a promoted Pin and continued to your site, leaving Pinterest<br /><br />**Field Name:** `TOTAL_CLICK_CHECKOUT`<br />**Type:** metric                             |
| <div>Click-through Order Quantity (Checkout)</div>      | Clicks checkout quantity<br /><br />**Field Name:** `TOTAL_CLICK_CHECKOUT_QUANTITY`<br />**Type:** metric                                                                                                                   |
| <div>Click-through Order Value (Checkout)</div>         | Clicks checkout value<br /><br />**Field Name:** `TOTAL_CLICK_CHECKOUT_VALUE_IN_MICRO_DOLLAR`<br />**Type:** metric                                                                                                         |
| <div>Engagement Conversions (Checkout)</div>            | Engagements checkout<br /><br />**Field Name:** `TOTAL_ENGAGEMENT_CHECKOUT`<br />**Type:** metric                                                                                                                           |
| <div>Engagement Order Quantity (Checkout)</div>         | Engagements checkout quantity<br /><br />**Field Name:** `TOTAL_ENGAGEMENT_CHECKOUT_QUANTITY`<br />**Type:** metric                                                                                                         |
| <div>Engagement Order Value (Checkout)</div>            | Engagements checkout value<br /><br />**Field Name:** `TOTAL_ENGAGEMENT_CHECKOUT_VALUE_IN_MICRO_DOLLAR`<br />**Type:** metric                                                                                               |
| <div>View-through Conversions (Checkout)</div>          | Checkouts that can be traced back to times when people repinned or clicked your promoted Pin to see it close-up, staying on Pinterest<br /><br />**Field Name:** `TOTAL_VIEW_CHECKOUT`<br />**Type:** metric                |
| <div>View-through Order Quantity (Checkout)</div>       | Views checkout quantity<br /><br />**Field Name:** `TOTAL_VIEW_CHECKOUT_QUANTITY`<br />**Type:** metric                                                                                                                     |
| <div>View-through Order Value (Checkout)</div>          | Views checkout value<br /><br />**Field Name:** `TOTAL_VIEW_CHECKOUT_VALUE_IN_MICRO_DOLLAR`<br />**Type:** metric                                                                                                           |
| <div>Web Conversions (Checkout)</div>                   | Total number of web checkout events resulting from clicks on your ad<br /><br />**Field Name:** `TOTAL_WEB_CHECKOUT`<br />**Type:** metric                                                                                  |
| <div>Web Order Value (Checkout)</div>                   | Total value of web checkout events resulting from interactions with your ad<br /><br />**Field Name:** `TOTAL_WEB_CHECKOUT_VALUE_IN_MICRO_DOLLAR`<br />**Type:** metric                                                     |
| <div>Web Click-through Conversions (Checkout)</div>     | Total number of web checkout events resulting from clicks on your ad<br /><br />**Field Name:** `TOTAL_WEB_CLICK_CHECKOUT`<br />**Type:** metric                                                                            |
| <div>Web Click-through Order Value (Checkout)</div>     | Total value of web checkout events resulting from clicks on your ad<br /><br />**Field Name:** `TOTAL_WEB_CLICK_CHECKOUT_VALUE_IN_MICRO_DOLLAR`<br />**Type:** metric                                                       |
| <div>Web Engagement Conversions (Checkout)</div>        | Total number of web checkout events resulting from engagements with your ad (save, closeup or carousel swipe)<br /><br />**Field Name:** `TOTAL_WEB_ENGAGEMENT_CHECKOUT`<br />**Type:** metric                              |
| <div>Web Engagement Order Value (Checkout)</div>        | Total value of web checkout events resulting from engagements with your ad (save, closeup or carousel swipe)<br /><br />**Field Name:** `TOTAL_WEB_ENGAGEMENT_CHECKOUT_VALUE_IN_MICRO_DOLLAR`<br />**Type:** metric         |
| <div>Web View-through Conversions (Checkout)</div>      | Total number of web checkout events resulting from views of your ad<br /><br />**Field Name:** `TOTAL_WEB_VIEW_CHECKOUT`<br />**Type:** metric                                                                              |
| <div>Web View-through Order Value (Checkout)</div>      | Total value of web checkout events resulting from views of your ad<br /><br />**Field Name:** `TOTAL_WEB_VIEW_CHECKOUT_VALUE_IN_MICRO_DOLLAR`<br />**Type:** metric                                                         |
| <div>In-app Conversions (Checkout)</div>                | Total number of in-app checkout events resulting from clicks on your ad<br /><br />**Field Name:** `TOTAL_INAPP_CHECKOUT`<br />**Type:** metric                                                                             |
| <div>In-app Order Value (Checkout)</div>                | Total value of in-app checkout events resulting from interactions with your ad<br /><br />**Field Name:** `TOTAL_INAPP_CHECKOUT_VALUE_IN_MICRO_DOLLAR`<br />**Type:** metric                                                |
| <div>In-app Click-through Conversions (Checkout)</div>  | Total number of in-app checkout events resulting from clicks on your ad<br /><br />**Field Name:** `TOTAL_INAPP_CLICK_CHECKOUT`<br />**Type:** metric                                                                       |
| <div>In-app Click-through Order Value (Checkout)</div>  | Total value of in-app checkout events resulting from clicks on your ad<br /><br />**Field Name:** `TOTAL_INAPP_CLICK_CHECKOUT_VALUE_IN_MICRO_DOLLAR`<br />**Type:** metric                                                  |
| <div>In-app Engagement Conversions (Checkout)</div>     | Total number of in-app checkout events resulting from engagements with your ad (save, closeup or carousel swipe)<br /><br />**Field Name:** `TOTAL_INAPP_ENGAGEMENT_CHECKOUT`<br />**Type:** metric                         |
| <div>In-app Engagement Order Value (Checkout)</div>     | Total value of in-app checkout events resulting from engagements with your ad (save, closeup or carousel swipe)<br /><br />**Field Name:** `TOTAL_INAPP_ENGAGEMENT_CHECKOUT_VALUE_IN_MICRO_DOLLAR`<br />**Type:** metric    |
| <div>In-app View-through Conversions (Checkout)</div>   | Total number of in-app checkout events resulting from views of your ad<br /><br />**Field Name:** `TOTAL_INAPP_VIEW_CHECKOUT`<br />**Type:** metric                                                                         |
| <div>In-app View-through Order Value (Checkout)</div>   | Total value of in-app checkout events resulting from views of your ad<br /><br />**Field Name:** `TOTAL_INAPP_VIEW_CHECKOUT_VALUE_IN_MICRO_DOLLAR`<br />**Type:** metric                                                    |
| <div>Offline Conversions (Checkout)</div>               | Total number of offline checkout events resulting from clicks on your ad<br /><br />**Field Name:** `TOTAL_OFFLINE_CHECKOUT`<br />**Type:** metric                                                                          |
| <div>Offline Order Value (Checkout)</div>               | Total value of offline checkout events resulting from interactions with your ad<br /><br />**Field Name:** `TOTAL_OFFLINE_CHECKOUT_VALUE_IN_MICRO_DOLLAR`<br />**Type:** metric                                             |
| <div>Offline Click-through Conversions (Checkout)</div> | Total number of offline checkout events resulting from clicks on your ad<br /><br />**Field Name:** `TOTAL_OFFLINE_CLICK_CHECKOUT`<br />**Type:** metric                                                                    |
| <div>Offline Click-through Order Value (Checkout)</div> | Total value of offline checkout events resulting from clicks on your ad<br /><br />**Field Name:** `TOTAL_OFFLINE_CLICK_CHECKOUT_VALUE_IN_MICRO_DOLLAR`<br />**Type:** metric                                               |
| <div>Offline Engagement Conversions (Checkout)</div>    | Total number of offline checkout events resulting from engagements with your ad (save, closeup or carousel swipe)<br /><br />**Field Name:** `TOTAL_OFFLINE_ENGAGEMENT_CHECKOUT`<br />**Type:** metric                      |
| <div>Offline Engagement Order Value (Checkout)</div>    | Total value of offline checkout events resulting from engagements with your ad (save, closeup or carousel swipe)<br /><br />**Field Name:** `TOTAL_OFFLINE_ENGAGEMENT_CHECKOUT_VALUE_IN_MICRO_DOLLAR`<br />**Type:** metric |
| <div>Offline View-through Conversions (Checkout)</div>  | Total number of offline checkout events resulting from views of your ad<br /><br />**Field Name:** `TOTAL_OFFLINE_VIEW_CHECKOUT`<br />**Type:** metric                                                                      |
| <div>Offline View-through Order Value (Checkout)</div>  | Total value of offline checkout events resulting from views of your ad<br /><br />**Field Name:** `TOTAL_OFFLINE_VIEW_CHECKOUT_VALUE_IN_MICRO_DOLLAR`<br />**Type:** metric                                                 |
| <div>ROAS (Checkout)</div>                              | Average return on ad spend for checkout events<br /><br />**Field Name:** `CHECKOUT_ROAS`<br />**Type:** metric                                                                                                             |
| <div>CPA (Checkout)</div>                               | Average cost per checkout event<br /><br />**Field Name:** `CHECKOUT_COST_PER_ACTION`<br />**Type:** metric                                                                                                                 |
| <div>Web CPA (Checkout)</div>                           | Average cost per web checkout event<br /><br />**Field Name:** `WEB_CHECKOUT_COST_PER_ACTION`<br />**Type:** metric                                                                                                         |
| <div>Web ROAS (Checkout)</div>                          | Average return on ad spend for web checkout events<br /><br />**Field Name:** `WEB_CHECKOUT_ROAS`<br />**Type:** metric                                                                                                     |
| <div>In-app CPA (Checkout)</div>                        | Average cost per in-app checkout event<br /><br />**Field Name:** `INAPP_CHECKOUT_COST_PER_ACTION`<br />**Type:** metric                                                                                                    |
| <div>In-app ROAS (Checkout)</div>                       | Average return on ad spend for in-app checkout events<br /><br />**Field Name:** `INAPP_CHECKOUT_ROAS`<br />**Type:** metric                                                                                                |
| <div>Offline CPA (Checkout)</div>                       | Average cost per offline checkout event<br /><br />**Field Name:** `OFFLINE_CHECKOUT_COST_PER_ACTION`<br />**Type:** metric                                                                                                 |
| <div>Offline ROAS (Checkout)</div>                      | Average return on ad spend for offline checkout events<br /><br />**Field Name:** `OFFLINE_CHECKOUT_ROAS`<br />**Type:** metric                                                                                             |
| <div>Checkouts Desktop to Desktop</div>                 | Checkouts desktop action to desktop conversion<br /><br />**Field Name:** `TOTAL_CHECKOUT_DESKTOP_ACTION_TO_DESKTOP_CONVERSION`<br />**Type:** metric                                                                       |
| <div>Checkouts Desktop to Mobile</div>                  | Checkouts desktop action to mobile conversion<br /><br />**Field Name:** `TOTAL_CHECKOUT_DESKTOP_ACTION_TO_MOBILE_CONVERSION`<br />**Type:** metric                                                                         |
| <div>Checkouts Desktop to Tablet</div>                  | Checkouts desktop action to tablet conversion<br /><br />**Field Name:** `TOTAL_CHECKOUT_DESKTOP_ACTION_TO_TABLET_CONVERSION`<br />**Type:** metric                                                                         |
| <div>Checkouts Mobile to Desktop</div>                  | Checkouts mobile action to desktop conversion<br /><br />**Field Name:** `TOTAL_CHECKOUT_MOBILE_ACTION_TO_DESKTOP_CONVERSION`<br />**Type:** metric                                                                         |
| <div>Checkouts Mobile to Mobile</div>                   | Checkouts mobile action to mobile conversion<br /><br />**Field Name:** `TOTAL_CHECKOUT_MOBILE_ACTION_TO_MOBILE_CONVERSION`<br />**Type:** metric                                                                           |
| <div>Checkouts Mobile to Tablet</div>                   | Checkouts mobile action to tablet conversion<br /><br />**Field Name:** `TOTAL_CHECKOUT_MOBILE_ACTION_TO_TABLET_CONVERSION`<br />**Type:** metric                                                                           |
| <div>Checkouts Tablet to Desktop</div>                  | Checkouts tablet action to desktop conversion<br /><br />**Field Name:** `TOTAL_CHECKOUT_TABLET_ACTION_TO_DESKTOP_CONVERSION`<br />**Type:** metric                                                                         |
| <div>Checkouts Tablet to Mobile</div>                   | Checkouts tablet action to mobile conversion<br /><br />**Field Name:** `TOTAL_CHECKOUT_TABLET_ACTION_TO_MOBILE_CONVERSION`<br />**Type:** metric                                                                           |
| <div>Checkouts Tablet to Tablet</div>                   | Checkouts tablet action to tablet conversion<br /><br />**Field Name:** `TOTAL_CHECKOUT_TABLET_ACTION_TO_TABLET_CONVERSION`<br />**Type:** metric                                                                           |

### Conversions Custom

|                                                          |                                                                                                                                                                                                                           |
| -------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| <div>Conversions (Custom)</div>                          | Total number of custom events resulting from interactions with your ad<br /><br />**Field Name:** `TOTAL_CUSTOM`<br />**Type:** metric                                                                                    |
| <div>Conversion Value (Custom)</div>                     | Total value of custom events resulting from interactions with your ad<br /><br />**Field Name:** `TOTAL_CUSTOM_VALUE_IN_MICRO_DOLLAR`<br />**Type:** metric                                                               |
| <div>Click-through Conversions (Custom)</div>            | Custom conversions that can be traced back to when somebody clicked a promoted Pin and continued to your site, leaving Pinterest<br /><br />**Field Name:** `TOTAL_CLICK_CUSTOM`<br />**Type:** metric                    |
| <div>Conversion Quantity from Custom - Clicks</div>      | Clicks custom quantity<br /><br />**Field Name:** `TOTAL_CLICK_CUSTOM_QUANTITY`<br />**Type:** metric                                                                                                                     |
| <div>Click-through Value (Custom)</div>                  | Clicks custom value<br /><br />**Field Name:** `TOTAL_CLICK_CUSTOM_VALUE_IN_MICRO_DOLLAR`<br />**Type:** metric                                                                                                           |
| <div>Engagement Conversions (Custom)</div>               | Custom conversions that can be traced back to times when people repinned or clicked your promoted Pin to see it close-up, staying on Pinterest<br /><br />**Field Name:** `TOTAL_ENGAGEMENT_CUSTOM`<br />**Type:** metric |
| <div>Conversion Quantity from Custom - Engagements</div> | Engagements custom quantity<br /><br />**Field Name:** `TOTAL_ENGAGEMENT_CUSTOM_QUANTITY`<br />**Type:** metric                                                                                                           |
| <div>Engagement Value (Custom)</div>                     | Engagements custom value<br /><br />**Field Name:** `TOTAL_ENGAGEMENT_CUSTOM_VALUE_IN_MICRO_DOLLAR`<br />**Type:** metric                                                                                                 |
| <div>View-through Conversions (Custom)</div>             | Custom conversions that can be traced back to when somebody saw your promoted Pin<br /><br />**Field Name:** `TOTAL_VIEW_CUSTOM`<br />**Type:** metric                                                                    |
| <div>Conversion Quantity from Custom - Views</div>       | Views custom quantity<br /><br />**Field Name:** `TOTAL_VIEW_CUSTOM_QUANTITY`<br />**Type:** metric                                                                                                                       |
| <div>View-through Value (Custom)</div>                   | Views custom value<br /><br />**Field Name:** `TOTAL_VIEW_CUSTOM_VALUE_IN_MICRO_DOLLAR`<br />**Type:** metric                                                                                                             |
| <div>Web Conversions (Custom)</div>                      | Total number of web custom events resulting from clicks on your ad<br /><br />**Field Name:** `TOTAL_WEB_CUSTOM`<br />**Type:** metric                                                                                    |
| <div>Web Order Value (Custom)</div>                      | Total value of web custom events resulting from interactions with your ad<br /><br />**Field Name:** `TOTAL_WEB_CUSTOM_VALUE_IN_MICRO_DOLLAR`<br />**Type:** metric                                                       |
| <div>Offline Conversions (Custom)</div>                  | Total number of offline custom events resulting from clicks on your ad<br /><br />**Field Name:** `TOTAL_OFFLINE_CUSTOM`<br />**Type:** metric                                                                            |
| <div>Offline Order Value (Custom)</div>                  | Total value of offline custom events resulting from interactions with your ad<br /><br />**Field Name:** `TOTAL_OFFLINE_CUSTOM_VALUE_IN_MICRO_DOLLAR`<br />**Type:** metric                                               |
| <div>CPA (Custom)</div>                                  | Average cost per custom event<br /><br />**Field Name:** `CUSTOM_COST_PER_ACTION`<br />**Type:** metric                                                                                                                   |
| <div>ROAS (Custom)</div>                                 | Average return on spend for custom events<br /><br />**Field Name:** `CUSTOM_ROAS`<br />**Type:** metric                                                                                                                  |
| <div>Custom Desktop to Desktop</div>                     | Custom desktop actions to desktop conversion<br /><br />**Field Name:** `TOTAL_CUSTOM_DESKTOP_ACTION_TO_DESKTOP_CONVERSION`<br />**Type:** metric                                                                         |
| <div>Custom Desktop to Mobile</div>                      | Custom desktop actions to mobile conversion<br /><br />**Field Name:** `TOTAL_CUSTOM_DESKTOP_ACTION_TO_MOBILE_CONVERSION`<br />**Type:** metric                                                                           |
| <div>Custom Desktop to Tablet</div>                      | Custom desktop actions to tablet conversion<br /><br />**Field Name:** `TOTAL_CUSTOM_DESKTOP_ACTION_TO_TABLET_CONVERSION`<br />**Type:** metric                                                                           |
| <div>Custom Mobile to Desktop</div>                      | Custom mobile actions to desktop conversion<br /><br />**Field Name:** `TOTAL_CUSTOM_MOBILE_ACTION_TO_DESKTOP_CONVERSION`<br />**Type:** metric                                                                           |
| <div>Custom Mobile to Mobile</div>                       | Custom mobile actions to mobile conversion<br /><br />**Field Name:** `TOTAL_CUSTOM_MOBILE_ACTION_TO_MOBILE_CONVERSION`<br />**Type:** metric                                                                             |
| <div>Custom Mobile to Tablet</div>                       | Custom mobile actions to tablet conversion<br /><br />**Field Name:** `TOTAL_CUSTOM_MOBILE_ACTION_TO_TABLET_CONVERSION`<br />**Type:** metric                                                                             |
| <div>Custom Tablet to Desktop</div>                      | Custom tablet actions to desktop conversion<br /><br />**Field Name:** `TOTAL_CUSTOM_TABLET_ACTION_TO_DESKTOP_CONVERSION`<br />**Type:** metric                                                                           |
| <div>Custom Tablet to Mobile</div>                       | Custom tablet actions to mobile conversion<br /><br />**Field Name:** `TOTAL_CUSTOM_TABLET_ACTION_TO_MOBILE_CONVERSION`<br />**Type:** metric                                                                             |
| <div>Custom Tablet to Tablet</div>                       | Custom tablet actions to tablet conversion<br /><br />**Field Name:** `TOTAL_CUSTOM_TABLET_ACTION_TO_TABLET_CONVERSION`<br />**Type:** metric                                                                             |

### Conversions Lead

|                                                        |                                                                                                                                                                              |
| ------------------------------------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| <div>Conversions (Lead)</div>                          | Total leads from clicks, engagements and views<br /><br />**Field Name:** `TOTAL_LEAD`<br />**Type:** metric                                                                 |
| <div>Conversion Value (Lead)</div>                     | Total value of lead events resulting from interactions with your ad<br /><br />**Field Name:** `TOTAL_LEAD_VALUE_IN_MICRO_DOLLAR`<br />**Type:** metric                      |
| <div>Click-through Conversions (Lead)</div>            | Total number of lead events resulting from clicks on your ads<br /><br />**Field Name:** `TOTAL_CLICK_LEAD`<br />**Type:** metric                                            |
| <div>Conversion Quantity from Lead - Clicks</div>      | Total quantity of lead events resulting from clicks on your ads<br /><br />**Field Name:** `TOTAL_CLICK_LEAD_QUANTITY`<br />**Type:** metric                                 |
| <div>Click-through Value (Lead)</div>                  | Total value of lead events resulting from clicks on your ads<br /><br />**Field Name:** `TOTAL_CLICK_LEAD_VALUE_IN_MICRO_DOLLAR`<br />**Type:** metric                       |
| <div>Engagement Conversions (Lead)</div>               | Total number of lead events resulting from engagement with your ads<br /><br />**Field Name:** `TOTAL_ENGAGEMENT_LEAD`<br />**Type:** metric                                 |
| <div>Conversion Quantity from Lead - Engagements</div> | Total quantity of lead events resulting from engagement with your ads<br /><br />**Field Name:** `TOTAL_ENGAGEMENT_LEAD_QUANTITY`<br />**Type:** metric                      |
| <div>Engagement Value (Lead)</div>                     | Total value of lead events resulting from engagement with your ads<br /><br />**Field Name:** `TOTAL_ENGAGEMENT_LEAD_VALUE_IN_MICRO_DOLLAR`<br />**Type:** metric            |
| <div>View-through Conversions (Lead)</div>             | Total number of lead events resulting from views of your ads<br /><br />**Field Name:** `TOTAL_VIEW_LEAD`<br />**Type:** metric                                              |
| <div>Conversion Quantity from Lead - Views</div>       | Total quantity of lead events resulting from views of your ads<br /><br />**Field Name:** `TOTAL_VIEW_LEAD_QUANTITY`<br />**Type:** metric                                   |
| <div>View-through Value (Lead)</div>                   | Total value of lead events resulting from views of your ads<br /><br />**Field Name:** `TOTAL_VIEW_LEAD_VALUE_IN_MICRO_DOLLAR`<br />**Type:** metric                         |
| <div>Web Conversions (Lead)</div>                      | Total number of web lead events resulting from clicks on your ad<br /><br />**Field Name:** `TOTAL_WEB_LEAD`<br />**Type:** metric                                           |
| <div>Web Order Value (Lead)</div>                      | Total value of web lead events resulting from interactions with your ad<br /><br />**Field Name:** `TOTAL_WEB_LEAD_VALUE_IN_MICRO_DOLLAR`<br />**Type:** metric              |
| <div>Offline Conversions (Lead)</div>                  | Total number of offline lead events resulting from clicks on your ad<br /><br />**Field Name:** `TOTAL_OFFLINE_LEAD`<br />**Type:** metric                                   |
| <div>Offline Order Value (Lead)</div>                  | Total value of offline lead events resulting from interactions with your ad<br /><br />**Field Name:** `TOTAL_OFFLINE_LEAD_VALUE_IN_MICRO_DOLLAR`<br />**Type:** metric      |
| <div>CPA (Lead)</div>                                  | Average cost per lead event<br /><br />**Field Name:** `LEAD_COST_PER_ACTION`<br />**Type:** metric                                                                          |
| <div>ROAS (Lead)</div>                                 | Average return on ad spend for lead events<br /><br />**Field Name:** `LEAD_ROAS`<br />**Type:** metric                                                                      |
| <div>Leads Desktop to Desktop</div>                    | Total number of desktop lead actions leading to a desktop lead conversion<br /><br />**Field Name:** `TOTAL_LEAD_DESKTOP_ACTION_TO_DESKTOP_CONVERSION`<br />**Type:** metric |
| <div>Leads Desktop to Mobile</div>                     | Total number of desktop lead actions leading to a mobile lead conversion<br /><br />**Field Name:** `TOTAL_LEAD_DESKTOP_ACTION_TO_MOBILE_CONVERSION`<br />**Type:** metric   |
| <div>Leads Desktop to Tablet</div>                     | Total number of desktop lead actions leading to a tablet lead conversion<br /><br />**Field Name:** `TOTAL_LEAD_DESKTOP_ACTION_TO_TABLET_CONVERSION`<br />**Type:** metric   |
| <div>Leads Mobile to Desktop</div>                     | Total number of mobile lead actions leading to a desktop lead conversion<br /><br />**Field Name:** `TOTAL_LEAD_MOBILE_ACTION_TO_DESKTOP_CONVERSION`<br />**Type:** metric   |
| <div>Leads Mobile to Mobile</div>                      | Total number of mobile lead actions leading to a mobile lead conversion<br /><br />**Field Name:** `TOTAL_LEAD_MOBILE_ACTION_TO_MOBILE_CONVERSION`<br />**Type:** metric     |
| <div>Leads Mobile to Tablet</div>                      | Total number of mobile lead actions leading to a tablet lead conversion<br /><br />**Field Name:** `TOTAL_LEAD_MOBILE_ACTION_TO_TABLET_CONVERSION`<br />**Type:** metric     |
| <div>Leads Tablet to Desktop</div>                     | Total number of tablet lead actions leading to a desktop lead conversion<br /><br />**Field Name:** `TOTAL_LEAD_TABLET_ACTION_TO_DESKTOP_CONVERSION`<br />**Type:** metric   |
| <div>Leads Tablet to Mobile</div>                      | Total number of tablet lead actions leading to a mobile lead conversion<br /><br />**Field Name:** `TOTAL_LEAD_TABLET_ACTION_TO_MOBILE_CONVERSION`<br />**Type:** metric     |
| <div>Leads Tablet to Tablet</div>                      | Total number of tablet lead actions leading to a tablet lead conversion<br /><br />**Field Name:** `TOTAL_LEAD_TABLET_ACTION_TO_TABLET_CONVERSION`<br />**Type:** metric     |

### Conversions Page Visit

|                                                         |                                                                                                                                                                                                                        |
| ------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| <div>Click-through Conversions (Page Visit)</div>       | Page visits that can be traced back to when somebody clicked a promoted Pin and continued to your site, leaving Pinterest<br /><br />**Field Name:** `TOTAL_CLICK_PAGE_VISIT`<br />**Type:** metric                    |
| <div>Conversion Quantity from Page Visit - Clicks</div> | Clicks page visit quantity<br /><br />**Field Name:** `TOTAL_CLICK_PAGE_VISIT_QUANTITY`<br />**Type:** metric                                                                                                          |
| <div>Click-through Value (Page Visit)</div>             | Clicks page visit value<br /><br />**Field Name:** `TOTAL_CLICK_PAGE_VISIT_VALUE_IN_MICRO_DOLLAR`<br />**Type:** metric                                                                                                |
| <div>Engagement Conversions (Page Visit)</div>          | Page visits that can be traced back to times when people repinned or clicked your promoted Pin to see it close-up, staying on Pinterest<br /><br />**Field Name:** `TOTAL_ENGAGEMENT_PAGE_VISIT`<br />**Type:** metric |
| <div>Conversion Quantity from Page Visits</div>         | Engagements page visit quantity<br /><br />**Field Name:** `TOTAL_ENGAGEMENT_PAGE_VISIT_QUANTITY`<br />**Type:** metric                                                                                                |
| <div>Engagement Value (Page Visit)</div>                | Engagements page visit value<br /><br />**Field Name:** `TOTAL_ENGAGEMENT_PAGE_VISIT_VALUE_IN_MICRO_DOLLAR`<br />**Type:** metric                                                                                      |
| <div>View-through Conversions (Page Visit)</div>        | Page visits that can be traced back to when somebody saw your promoted Pin<br /><br />**Field Name:** `TOTAL_VIEW_PAGE_VISIT`<br />**Type:** metric                                                                    |
| <div>Conversion Quantity from Page Visit - Views</div>  | Views page visit quantity<br /><br />**Field Name:** `TOTAL_VIEW_PAGE_VISIT_QUANTITY`<br />**Type:** metric                                                                                                            |
| <div>View-through Value (Page Visit)</div>              | Views page visit value<br /><br />**Field Name:** `TOTAL_VIEW_PAGE_VISIT_VALUE_IN_MICRO_DOLLAR`<br />**Type:** metric                                                                                                  |
| <div>Web Conversions (Page Visit)</div>                 | Total number of web page visit events resulting from clicks on your ad<br /><br />**Field Name:** `TOTAL_WEB_PAGE_VISIT`<br />**Type:** metric                                                                         |
| <div>Web Order Value (Page Visit)</div>                 | Total value of web page visit events resulting from interactions with your ad<br /><br />**Field Name:** `TOTAL_WEB_PAGE_VISIT_VALUE_IN_MICRO_DOLLAR`<br />**Type:** metric                                            |
| <div>CPA (Page Visit)</div>                             | Average cost per page visit event<br /><br />**Field Name:** `PAGE_VISIT_COST_PER_ACTION`<br />**Type:** metric                                                                                                        |
| <div>ROAS (Page Visit)</div>                            | Average return on ad spend for page visit events<br /><br />**Field Name:** `PAGE_VISIT_ROAS`<br />**Type:** metric                                                                                                    |
| <div>Web CPA (Page Visit)</div>                         | Average cost per web page visit event<br /><br />**Field Name:** `WEB_PAGE_VISIT_COST_PER_ACTION`<br />**Type:** metric                                                                                                |
| <div>Web ROAS (Page Visit)</div>                        | Average return on ad spend for web page visit events<br /><br />**Field Name:** `WEB_PAGE_VISIT_ROAS`<br />**Type:** metric                                                                                            |
| <div>Page Visits Desktop to Desktop</div>               | Page visits desktop action to desktop conversion<br /><br />**Field Name:** `TOTAL_PAGE_VISIT_DESKTOP_ACTION_TO_DESKTOP_CONVERSION`<br />**Type:** metric                                                              |
| <div>Page Visits Desktop to Mobile</div>                | Page visits desktop action to mobile conversion<br /><br />**Field Name:** `TOTAL_PAGE_VISIT_DESKTOP_ACTION_TO_MOBILE_CONVERSION`<br />**Type:** metric                                                                |
| <div>Page Visits Desktop to Tablet</div>                | Page visits desktop action to tablet conversion<br /><br />**Field Name:** `TOTAL_PAGE_VISIT_DESKTOP_ACTION_TO_TABLET_CONVERSION`<br />**Type:** metric                                                                |
| <div>Page Visits Mobile to Desktop</div>                | Page visits mobile action to desktop conversion<br /><br />**Field Name:** `TOTAL_PAGE_VISIT_MOBILE_ACTION_TO_DESKTOP_CONVERSION`<br />**Type:** metric                                                                |
| <div>Page Visits Mobile to Mobile</div>                 | Page visits mobile action to mobile conversion<br /><br />**Field Name:** `TOTAL_PAGE_VISIT_MOBILE_ACTION_TO_MOBILE_CONVERSION`<br />**Type:** metric                                                                  |
| <div>Page Visits Mobile to Tablet</div>                 | Page visits mobile action to tablet conversion<br /><br />**Field Name:** `TOTAL_PAGE_VISIT_MOBILE_ACTION_TO_TABLET_CONVERSION`<br />**Type:** metric                                                                  |
| <div>Page Visits Tablet to Desktop</div>                | Page visits tablet action to desktop conversion<br /><br />**Field Name:** `TOTAL_PAGE_VISIT_TABLET_ACTION_TO_DESKTOP_CONVERSION`<br />**Type:** metric                                                                |
| <div>Page Visits Tablet to Mobile</div>                 | Page visits tablet action to mobile conversion<br /><br />**Field Name:** `TOTAL_PAGE_VISIT_TABLET_ACTION_TO_MOBILE_CONVERSION`<br />**Type:** metric                                                                  |
| <div>Page Visits Tablet to Tablet</div>                 | Page visits tablet action to tablet conversion<br /><br />**Field Name:** `TOTAL_PAGE_VISIT_TABLET_ACTION_TO_TABLET_CONVERSION`<br />**Type:** metric                                                                  |

### Conversions Signup

|                                                          |                                                                                                                                                                                                                 |
| -------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| <div>Conversions (Signup)</div>                          | Total sign-ups from clicks, engagements and views<br /><br />**Field Name:** `TOTAL_SIGNUP`<br />**Type:** metric                                                                                               |
| <div>Conversion Value (Signup)</div>                     | Total value of signup events resulting from interactions with your ad<br /><br />**Field Name:** `TOTAL_SIGNUP_VALUE_IN_MICRO_DOLLAR`<br />**Type:** metric                                                     |
| <div>Click-through Conversions (Signup)</div>            | Sign ups that can be traced back to when somebody clicked a promoted Pin and continued to your site, leaving Pinterest<br /><br />**Field Name:** `TOTAL_CLICK_SIGNUP`<br />**Type:** metric                    |
| <div>Conversion Quantity from Signup - Clicks</div>      | Clicks sign-up quantity<br /><br />**Field Name:** `TOTAL_CLICK_SIGNUP_QUANTITY`<br />**Type:** metric                                                                                                          |
| <div>Click-through Value (Signup)</div>                  | Clicks sign-up value<br /><br />**Field Name:** `TOTAL_CLICK_SIGNUP_VALUE_IN_MICRO_DOLLAR`<br />**Type:** metric                                                                                                |
| <div>Engagement Conversions (Signup)</div>               | Sign ups that can be traced back to times when people repinned or clicked your promoted Pin to see it close-up, staying on Pinterest<br /><br />**Field Name:** `TOTAL_ENGAGEMENT_SIGNUP`<br />**Type:** metric |
| <div>Conversion Quantity from Signup - Engagements</div> | Engagements sign-up quantity<br /><br />**Field Name:** `TOTAL_ENGAGEMENT_SIGNUP_QUANTITY`<br />**Type:** metric                                                                                                |
| <div>Engagement Value (Signup)</div>                     | Engagements sign-up value<br /><br />**Field Name:** `TOTAL_ENGAGEMENT_SIGNUP_VALUE_IN_MICRO_DOLLAR`<br />**Type:** metric                                                                                      |
| <div>View-through Conversions (Signup)</div>             | Sign ups that can be traced back to when somebody saw your promoted Pin<br /><br />**Field Name:** `TOTAL_VIEW_SIGNUP`<br />**Type:** metric                                                                    |
| <div>Conversion Quantity from Signup - Views</div>       | Views sign-up quantity<br /><br />**Field Name:** `TOTAL_VIEW_SIGNUP_QUANTITY`<br />**Type:** metric                                                                                                            |
| <div>View-through Value (Signup)</div>                   | Views sign-up value<br /><br />**Field Name:** `TOTAL_VIEW_SIGNUP_VALUE_IN_MICRO_DOLLAR`<br />**Type:** metric                                                                                                  |
| <div>Web Conversions (Signup)</div>                      | Total number of web signup events resulting from clicks on your ad<br /><br />**Field Name:** `TOTAL_WEB_SIGNUP`<br />**Type:** metric                                                                          |
| <div>Web Order Value (Signup)</div>                      | Total value of web signup events resulting from interactions with your ad<br /><br />**Field Name:** `TOTAL_WEB_SIGNUP_VALUE_IN_MICRO_DOLLAR`<br />**Type:** metric                                             |
| <div>In-app Conversions (Signup)</div>                   | Total number of in-app signup events resulting from clicks on your ad<br /><br />**Field Name:** `TOTAL_INAPP_SIGNUP`<br />**Type:** metric                                                                     |
| <div>In-app Order Value (Signup)</div>                   | Total value of in-app signup events resulting from interactions with your ad<br /><br />**Field Name:** `TOTAL_INAPP_SIGNUP_VALUE_IN_MICRO_DOLLAR`<br />**Type:** metric                                        |
| <div>Offline Conversions (Signup)</div>                  | Total number of offline signup events resulting from clicks on your ad<br /><br />**Field Name:** `TOTAL_OFFLINE_SIGNUP`<br />**Type:** metric                                                                  |
| <div>Offline Order Value (Signup)</div>                  | Total value of offline signup events resulting from interactions with your ad<br /><br />**Field Name:** `TOTAL_OFFLINE_SIGNUP_VALUE_IN_MICRO_DOLLAR`<br />**Type:** metric                                     |
| <div>CPA (Signup)</div>                                  | Average cost per signup event<br /><br />**Field Name:** `SIGNUP_COST_PER_ACTION`<br />**Type:** metric                                                                                                         |
| <div>ROAS (Signup)</div>                                 | Average return on ad spend for signup events<br /><br />**Field Name:** `SIGNUP_ROAS`<br />**Type:** metric                                                                                                     |
| <div>Sign-ups Desktop to Desktop</div>                   | Sign-ups desktop action to desktop conversion<br /><br />**Field Name:** `TOTAL_SIGNUP_DESKTOP_ACTION_TO_DESKTOP_CONVERSION`<br />**Type:** metric                                                              |
| <div>Sign-ups Desktop to Mobile</div>                    | Sign-ups desktop action to mobile conversion<br /><br />**Field Name:** `TOTAL_SIGNUP_DESKTOP_ACTION_TO_MOBILE_CONVERSION`<br />**Type:** metric                                                                |
| <div>Sign-ups Desktop to Tablet</div>                    | Sign-ups desktop action to tablet conversion<br /><br />**Field Name:** `TOTAL_SIGNUP_DESKTOP_ACTION_TO_TABLET_CONVERSION`<br />**Type:** metric                                                                |
| <div>Sign-ups Mobile to Desktop</div>                    | Sign-ups mobile action to desktop conversion<br /><br />**Field Name:** `TOTAL_SIGNUP_MOBILE_ACTION_TO_DESKTOP_CONVERSION`<br />**Type:** metric                                                                |
| <div>Sign-ups Mobile to Mobile</div>                     | Sign-ups mobile action to mobile conversion<br /><br />**Field Name:** `TOTAL_SIGNUP_MOBILE_ACTION_TO_MOBILE_CONVERSION`<br />**Type:** metric                                                                  |
| <div>Sign-ups Mobile to Tablet</div>                     | Sign-ups mobile action to tablet conversion<br /><br />**Field Name:** `TOTAL_SIGNUP_MOBILE_ACTION_TO_TABLET_CONVERSION`<br />**Type:** metric                                                                  |
| <div>Sign-ups Tablet to Desktop</div>                    | Sign-ups tablet action to desktop conversion<br /><br />**Field Name:** `TOTAL_SIGNUP_TABLET_ACTION_TO_DESKTOP_CONVERSION`<br />**Type:** metric                                                                |
| <div>Sign-ups Tablet to Mobile</div>                     | Sign-ups tablet action to mobile conversion<br /><br />**Field Name:** `TOTAL_SIGNUP_TABLET_ACTION_TO_MOBILE_CONVERSION`<br />**Type:** metric                                                                  |
| <div>Sign-ups Tablet to Tablet</div>                     | Sign-ups tablet action to tablet conversion<br /><br />**Field Name:** `TOTAL_SIGNUP_TABLET_ACTION_TO_TABLET_CONVERSION`<br />**Type:** metric                                                                  |

### Conversions Watch Video

|                                                               |                                                                                                                                                                                                   |
| ------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| <div>Click-through Conversions (Watch Video)</div>            | Total number of watch video events resulting from clicks on your ads<br /><br />**Field Name:** `TOTAL_CLICK_WATCH_VIDEO`<br />**Type:** metric                                                   |
| <div>Conversion Quantity from Watch Video - Clicks</div>      | Total quantity of watch video events resulting from clicks on your ads<br /><br />**Field Name:** `TOTAL_CLICK_WATCH_VIDEO_QUANTITY`<br />**Type:** metric                                        |
| <div>Click-through Value (Watch Video)</div>                  | Total value of watch video events resulting from clicks on your ads<br /><br />**Field Name:** `TOTAL_CLICK_WATCH_VIDEO_VALUE_IN_MICRO_DOLLAR`<br />**Type:** metric                              |
| <div>Engagement Conversions (Watch Video)</div>               | Total number of watch video events resulting from engagement with your ads<br /><br />**Field Name:** `TOTAL_ENGAGEMENT_WATCH_VIDEO`<br />**Type:** metric                                        |
| <div>Conversion Quantity from Watch Video - Engagements</div> | Total quantity of watch video events resulting from engagement with your ads<br /><br />**Field Name:** `TOTAL_ENGAGEMENT_WATCH_VIDEO_QUANTITY`<br />**Type:** metric                             |
| <div>Engagement Value (Watch Video)</div>                     | Total value of watch video events resulting from engagement with your ads<br /><br />**Field Name:** `TOTAL_ENGAGEMENT_WATCH_VIDEO_VALUE_IN_MICRO_DOLLAR`<br />**Type:** metric                   |
| <div>View-through Conversions (Watch Video)</div>             | Total number of watch video events resulting from views of your ads<br /><br />**Field Name:** `TOTAL_VIEW_WATCH_VIDEO`<br />**Type:** metric                                                     |
| <div>Conversion Quantity from Watch Video - Views</div>       | Total quantity of watch video events resulting from views of your ads<br /><br />**Field Name:** `TOTAL_VIEW_WATCH_VIDEO_QUANTITY`<br />**Type:** metric                                          |
| <div>View-through Value (Watch Video)</div>                   | Total value of watch video events resulting from views of your ads<br /><br />**Field Name:** `TOTAL_VIEW_WATCH_VIDEO_VALUE_IN_MICRO_DOLLAR`<br />**Type:** metric                                |
| <div>Web Conversions (Watch Video)</div>                      | Total number of web watch video events resulting from interactions with your ads<br /><br />**Field Name:** `TOTAL_WEB_WATCH_VIDEO`<br />**Type:** metric                                         |
| <div>Web Order Value (Watch Video)</div>                      | Total value of web watch video events resulting from interactions with your ads<br /><br />**Field Name:** `TOTAL_WEB_WATCH_VIDEO_VALUE_IN_MICRO_DOLLAR`<br />**Type:** metric                    |
| <div>Web Click-through Conversions (Watch Video)</div>        | Total number of web watch video events resulting from clicks on your ads<br /><br />**Field Name:** `TOTAL_WEB_CLICK_WATCH_VIDEO`<br />**Type:** metric                                           |
| <div>Web Click-through Order Value (Watch Video)</div>        | Total value of web watch video events resulting from clicks on your ads<br /><br />**Field Name:** `TOTAL_WEB_CLICK_WATCH_VIDEO_VALUE_IN_MICRO_DOLLAR`<br />**Type:** metric                      |
| <div>Web Engagement Conversions (Watch Video)</div>           | Total number of web watch video events resulting from engagement with your ads<br /><br />**Field Name:** `TOTAL_WEB_ENGAGEMENT_WATCH_VIDEO`<br />**Type:** metric                                |
| <div>Web Engagement Order Value (Watch Video)</div>           | Total value of web watch video events resulting from engagement with your ads<br /><br />**Field Name:** `TOTAL_WEB_ENGAGEMENT_WATCH_VIDEO_VALUE_IN_MICRO_DOLLAR`<br />**Type:** metric           |
| <div>Web View-through Conversions (Watch Video)</div>         | Total number of web watch video events resulting from views of your ads<br /><br />**Field Name:** `TOTAL_WEB_VIEW_WATCH_VIDEO`<br />**Type:** metric                                             |
| <div>Web View-through Order Value (Watch Video)</div>         | Total value of web watch video events resulting from views of your ads<br /><br />**Field Name:** `TOTAL_WEB_VIEW_WATCH_VIDEO_VALUE_IN_MICRO_DOLLAR`<br />**Type:** metric                        |
| <div>Web CPA (Watch Video)</div>                              | Average cost per web watch video events<br /><br />**Field Name:** `WEB_WATCH_VIDEO_COST_PER_ACTION`<br />**Type:** metric                                                                        |
| <div>Web ROAS (Watch Video)</div>                             | Average return on spend for web watch video events<br /><br />**Field Name:** `WEB_WATCH_VIDEO_ROAS`<br />**Type:** metric                                                                        |
| <div>Watch Video Desktop to Desktop</div>                     | Total number of desktop watch video actions leading to a desktop watch video conversion<br /><br />**Field Name:** `TOTAL_WATCH_VIDEO_DESKTOP_ACTION_TO_DESKTOP_CONVERSION`<br />**Type:** metric |
| <div>Watch Video Desktop to Mobile</div>                      | Total number of desktop watch video actions leading to a MOBILE watch video conversion<br /><br />**Field Name:** `TOTAL_WATCH_VIDEO_DESKTOP_ACTION_TO_MOBILE_CONVERSION`<br />**Type:** metric   |
| <div>Watch Video Desktop to Tablet</div>                      | Total number of desktop watch video actions leading to a tablet watch video conversion<br /><br />**Field Name:** `TOTAL_WATCH_VIDEO_DESKTOP_ACTION_TO_TABLET_CONVERSION`<br />**Type:** metric   |
| <div>Watch Video Mobile to Desktop</div>                      | Total number of mobile watch video actions leading to a desktop watch video conversion<br /><br />**Field Name:** `TOTAL_WATCH_VIDEO_MOBILE_ACTION_TO_DESKTOP_CONVERSION`<br />**Type:** metric   |
| <div>Watch Video Mobile to Mobile</div>                       | Total number of mobile watch video actions leading to a mobile watch video conversion<br /><br />**Field Name:** `TOTAL_WATCH_VIDEO_MOBILE_ACTION_TO_MOBILE_CONVERSION`<br />**Type:** metric     |
| <div>Watch Video Mobile to Tablet</div>                       | Total number of mobile watch video actions leading to a tablet watch video conversion<br /><br />**Field Name:** `TOTAL_WATCH_VIDEO_MOBILE_ACTION_TO_TABLET_CONVERSION`<br />**Type:** metric     |
| <div>Watch Video Tablet to Desktop</div>                      | Total number of tablet watch video actions leading to a desktop watch video conversion<br /><br />**Field Name:** `TOTAL_WATCH_VIDEO_TABLET_ACTION_TO_DESKTOP_CONVERSION`<br />**Type:** metric   |
| <div>Watch Video Tablet to Mobile</div>                       | Total number of tablet watch video actions leading to a mobile watch video conversion<br /><br />**Field Name:** `TOTAL_WATCH_VIDEO_TABLET_ACTION_TO_MOBILE_CONVERSION`<br />**Type:** metric     |
| <div>Watch Video Tablet to Tablet</div>                       | Total number of tablet watch video actions leading to a tablet watch video conversion<br /><br />**Field Name:** `TOTAL_WATCH_VIDEO_TABLET_ACTION_TO_TABLET_CONVERSION`<br />**Type:** metric     |

### Quiz Engagements

|                                 |                                                                                                                                         |
| ------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------- |
| <div>Quiz Completed</div>       | Total number of quiz completions from your quiz pin ads<br /><br />**Field Name:** `QUIZ_COMPLETED`<br />**Type:** metric               |
| <div>Quiz Completion Rate</div> | The percentage of quiz starts that resulted in quiz completions<br /><br />**Field Name:** `QUIZ_COMPLETION_RATE`<br />**Type:** metric |

### Showcase Engagements

|                                          |                                                                                                                                                         |
| ---------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------- |
| <div>Showcase Pin Clicks</div>           | Total number of clicks on your showcase pins<br /><br />**Field Name:** `SHOWCASE_PIN_CLICKTHROUGH`<br />**Type:** metric                               |
| <div>Showcase Subpage Clicks</div>       | Total number of clicks on showcase subpages<br /><br />**Field Name:** `SHOWCASE_SUBPAGE_CLICKTHROUGH`<br />**Type:** metric                            |
| <div>Showcase Subpage Closeups</div>     | Total number of closeup views on showcase subpages<br /><br />**Field Name:** `SHOWCASE_SUBPAGE_CLOSEUP`<br />**Type:** metric                          |
| <div>Showcase Subpage Impressions</div>  | Total number of impressions on showcase subpages<br /><br />**Field Name:** `SHOWCASE_SUBPAGE_IMPRESSION`<br />**Type:** metric                         |
| <div>Showcase Subpage Saves</div>        | Total number of saves (repins) on showcase subpages<br /><br />**Field Name:** `SHOWCASE_SUBPAGE_REPIN`<br />**Type:** metric                           |
| <div>Showcase Subpage Swipe Left</div>   | Total number of left swipes on showcase subpages<br /><br />**Field Name:** `SHOWCASE_SUBPAGE_SWIPE_LEFT`<br />**Type:** metric                         |
| <div>Showcase Subpage Swipe Right</div>  | Total number of right swipes on showcase subpages<br /><br />**Field Name:** `SHOWCASE_SUBPAGE_SWIPE_RIGHT`<br />**Type:** metric                       |
| <div>Showcase Subpin Clicks</div>        | Total number of clicks on showcase subpins<br /><br />**Field Name:** `SHOWCASE_SUBPIN_CLICKTHROUGH`<br />**Type:** metric                              |
| <div>Showcase Subpin Impressions</div>   | Total number of impressions on showcase subpins<br /><br />**Field Name:** `SHOWCASE_SUBPIN_IMPRESSION`<br />**Type:** metric                           |
| <div>Showcase Subpin Saves</div>         | Total number of saves (repins) on showcase subpins<br /><br />**Field Name:** `SHOWCASE_SUBPIN_REPIN`<br />**Type:** metric                             |
| <div>Showcase Subpin Swipe Left</div>    | Total number of left swipes on showcase subpins<br /><br />**Field Name:** `SHOWCASE_SUBPIN_SWIPE_LEFT`<br />**Type:** metric                           |
| <div>Showcase Subpin Swipe Right</div>   | Total number of right swipes on showcase subpins<br /><br />**Field Name:** `SHOWCASE_SUBPIN_SWIPE_RIGHT`<br />**Type:** metric                         |
| <div>Showcase Card Swipe Forward</div>   | Total number of forward swipes on showcase card thumbnails<br /><br />**Field Name:** `SHOWCASE_CARD_THUMBNAIL_SWIPE_FORWARD`<br />**Type:** metric     |
| <div>Showcase Card Swipe Backward</div>  | Total number of backward swipes on showcase card thumbnails<br /><br />**Field Name:** `SHOWCASE_CARD_THUMBNAIL_SWIPE_BACKWARD`<br />**Type:** metric   |
| <div>Showcase Avg Closeups/Session</div> | Average number of showcase subpage closeups per session<br /><br />**Field Name:** `SHOWCASE_AVERAGE_SUBPAGE_CLOSEUP_PER_SESSION`<br />**Type:** metric |

***

## Related

<CardGroup>
  <Card title="Fields Catalog" icon="book" href="/fields-catalog">
    Browse all platforms
  </Card>

  <Card title="Meta Ads Fields" icon="chart-bar" href="/data-source/facebook-ads/fields">
    Meta Ads metrics & dimensions
  </Card>

  <Card title="Google Ads Fields" icon="chart-bar" href="/data-source/google-ads/fields">
    Google Ads metrics & dimensions
  </Card>

  <Card title="TikTok Ads Fields" icon="chart-bar" href="/data-source/tiktok-ads/fields">
    TikTok Ads metrics & dimensions
  </Card>
</CardGroup>


# Salesforce Metrics & Dimensions
Source: https://support.detrics.io/data-source/salesforce/fields

Complete reference for Salesforce dimensions and metrics

<Info>
  **Last updated:** August 6, 2026
</Info>

<div>
  <div>
    329 dimensions
  </div>

  <div>
    48 metrics
  </div>
</div>

This reference covers all available dimensions and metrics for Salesforce data through Detrics. Use this guide to understand what data you can extract and how to structure your queries.

<div>
  <span>Supported destinations:</span>

  <div>
    Google Sheets
  </div>

  <div>
    Claude
  </div>

  <div>
    BigQuery
  </div>
</div>

## Dimensions

Dimensions are the attributes you can use to segment and group your Salesforce data.

### Account

|                                        |                                                                                                                                            |
| -------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------ |
| <div>Account ID</div>                  | Unique 18-character Salesforce ID for the account<br /><br />**Field Name:** `accountId`<br />**Type:** dimension                          |
| <div>Account Name</div>                | Name of the account (company)<br /><br />**Field Name:** `accountName`<br />**Type:** dimension                                            |
| <div>Account Type</div>                | Picklist categorising the account (e.g. Customer, Prospect, Partner)<br /><br />**Field Name:** `accountType`<br />**Type:** dimension     |
| <div>Account Industry</div>            | Industry the account operates in<br /><br />**Field Name:** `accountIndustry`<br />**Type:** dimension                                     |
| <div>Account Rating</div>              | Rating picklist (Hot/Warm/Cold)<br /><br />**Field Name:** `accountRating`<br />**Type:** dimension                                        |
| <div>Account Ownership</div>           | Ownership type (Public/Private/Subsidiary)<br /><br />**Field Name:** `accountOwnership`<br />**Type:** dimension                          |
| <div>Account Website</div>             | Account website URL<br /><br />**Field Name:** `accountWebsite`<br />**Type:** dimension                                                   |
| <div>Account Phone</div>               | Main phone number for the account<br /><br />**Field Name:** `accountPhone`<br />**Type:** dimension                                       |
| <div>Account Fax</div>                 | Fax number for the account<br /><br />**Field Name:** `accountFax`<br />**Type:** dimension                                                |
| <div>Account Number</div>              | External account number (free-text identifier)<br /><br />**Field Name:** `accountAccountNumber`<br />**Type:** dimension                  |
| <div>Account Billing City</div>        | Billing-address city<br /><br />**Field Name:** `accountBillingCity`<br />**Type:** dimension                                              |
| <div>Account Billing State</div>       | Billing-address state or province<br /><br />**Field Name:** `accountBillingState`<br />**Type:** dimension                                |
| <div>Account Billing Country</div>     | Billing-address country<br /><br />**Field Name:** `accountBillingCountry`<br />**Type:** dimension                                        |
| <div>Account Billing Postal Code</div> | Billing-address postal/ZIP code<br /><br />**Field Name:** `accountBillingPostalCode`<br />**Type:** dimension                             |
| <div>Account Billing Street</div>      | Billing-address street<br /><br />**Field Name:** `accountBillingStreet`<br />**Type:** dimension                                          |
| <div>Account Shipping City</div>       | Shipping-address city<br /><br />**Field Name:** `accountShippingCity`<br />**Type:** dimension                                            |
| <div>Account Shipping Country</div>    | Shipping-address country<br /><br />**Field Name:** `accountShippingCountry`<br />**Type:** dimension                                      |
| <div>Account Owner ID</div>            | Salesforce User ID of the account owner<br /><br />**Field Name:** `accountOwnerId`<br />**Type:** dimension                               |
| <div>Account Owner Name</div>          | Full name of the user who owns the account<br /><br />**Field Name:** `accountOwnerName`<br />**Type:** dimension                          |
| <div>Account Parent ID</div>           | Parent account ID (for account hierarchies)<br /><br />**Field Name:** `accountParentId`<br />**Type:** dimension                          |
| <div>Account Parent Name</div>         | Parent account name<br /><br />**Field Name:** `accountParentName`<br />**Type:** dimension                                                |
| <div>Account Created Date</div>        | Date the account was created<br /><br />**Field Name:** `accountCreatedDate`<br />**Type:** dimension                                      |
| <div>Account Last Modified Date</div>  | Date the account was last edited<br /><br />**Field Name:** `accountLastModifiedDate`<br />**Type:** dimension                             |
| <div>Account Last Activity Date</div>  | Date of the most recent activity (task/event) on the account<br /><br />**Field Name:** `accountLastActivityDate`<br />**Type:** dimension |
| <div>Account Description</div>         | Free-text description of the account<br /><br />**Field Name:** `accountDescription`<br />**Type:** dimension                              |

### Contact

|                                        |                                                                                                                                             |
| -------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------- |
| <div>Contact ID</div>                  | Unique 18-character ID for the contact<br /><br />**Field Name:** `contactId`<br />**Type:** dimension                                      |
| <div>Contact Salutation</div>          | Salutation prefix (e.g., Mr., Ms., Dr.)<br /><br />**Field Name:** `contactSalutation`<br />**Type:** dimension                             |
| <div>Contact First Name</div>          | First name of the contact<br /><br />**Field Name:** `contactFirstName`<br />**Type:** dimension                                            |
| <div>Contact Last Name</div>           | Last name of the contact<br /><br />**Field Name:** `contactLastName`<br />**Type:** dimension                                              |
| <div>Contact Full Name</div>           | Salesforce-computed full name (first + last)<br /><br />**Field Name:** `contactFullName`<br />**Type:** dimension                          |
| <div>Contact Email</div>               | Primary email address of the contact<br /><br />**Field Name:** `contactEmail`<br />**Type:** dimension                                     |
| <div>Contact Phone</div>               | Primary phone of the contact<br /><br />**Field Name:** `contactPhone`<br />**Type:** dimension                                             |
| <div>Contact Mobile Phone</div>        | Mobile phone of the contact<br /><br />**Field Name:** `contactMobilePhone`<br />**Type:** dimension                                        |
| <div>Contact Title</div>               | Job title of the contact<br /><br />**Field Name:** `contactTitle`<br />**Type:** dimension                                                 |
| <div>Contact Department</div>          | Department within the company<br /><br />**Field Name:** `contactDepartment`<br />**Type:** dimension                                       |
| <div>Contact Lead Source</div>         | Original source the contact came from (Web/Referral/etc.)<br /><br />**Field Name:** `contactLeadSource`<br />**Type:** dimension           |
| <div>Contact Mailing City</div>        | City of the mailing address<br /><br />**Field Name:** `contactMailingCity`<br />**Type:** dimension                                        |
| <div>Contact Mailing State</div>       | State of the mailing address<br /><br />**Field Name:** `contactMailingState`<br />**Type:** dimension                                      |
| <div>Contact Mailing Country</div>     | Country of the mailing address<br /><br />**Field Name:** `contactMailingCountry`<br />**Type:** dimension                                  |
| <div>Contact Mailing Postal Code</div> | Postal/ZIP code of the mailing address<br /><br />**Field Name:** `contactMailingPostalCode`<br />**Type:** dimension                       |
| <div>Contact Account ID</div>          | ID of the account this contact belongs to<br /><br />**Field Name:** `contactAccountId`<br />**Type:** dimension                            |
| <div>Contact Account Name</div>        | Name of the account this contact belongs to<br /><br />**Field Name:** `contactAccountName`<br />**Type:** dimension                        |
| <div>Contact Owner ID</div>            | User ID of the contact owner<br /><br />**Field Name:** `contactOwnerId`<br />**Type:** dimension                                           |
| <div>Contact Owner Name</div>          | Full name of the contact owner<br /><br />**Field Name:** `contactOwnerName`<br />**Type:** dimension                                       |
| <div>Contact Created Date</div>        | Date the contact was created<br /><br />**Field Name:** `contactCreatedDate`<br />**Type:** dimension                                       |
| <div>Contact Last Modified Date</div>  | Date the contact was last edited<br /><br />**Field Name:** `contactLastModifiedDate`<br />**Type:** dimension                              |
| <div>Contact Last Activity Date</div>  | Date of the most recent activity on the contact<br /><br />**Field Name:** `contactLastActivityDate`<br />**Type:** dimension               |
| <div>Contact Birthdate</div>           | Birthdate of the contact<br /><br />**Field Name:** `contactBirthdate`<br />**Type:** dimension                                             |
| <div>Contact Description</div>         | Free-text description of the contact<br /><br />**Field Name:** `contactDescription`<br />**Type:** dimension                               |
| <div>Contact Fax</div>                 | Fax number of the contact<br /><br />**Field Name:** `contactFax`<br />**Type:** dimension                                                  |
| <div>Contact Home Phone</div>          | Home phone of the contact<br /><br />**Field Name:** `contactHomePhone`<br />**Type:** dimension                                            |
| <div>Contact Other Phone</div>         | Other phone of the contact<br /><br />**Field Name:** `contactOtherPhone`<br />**Type:** dimension                                          |
| <div>Contact Pronouns</div>            | Pronouns of the contact (feature must be enabled in org)<br /><br />**Field Name:** `contactPronouns`<br />**Type:** dimension              |
| <div>Contact Gender Identity</div>     | Gender identity of the contact (feature must be enabled in org)<br /><br />**Field Name:** `contactGenderIdentity`<br />**Type:** dimension |

### Lead

|                                            |                                                                                                                                       |
| ------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------- |
| <div>Lead ID</div>                         | Unique 18-character ID for the lead<br /><br />**Field Name:** `leadId`<br />**Type:** dimension                                      |
| <div>Lead Salutation</div>                 | Salutation prefix (e.g., Mr., Ms., Dr.)<br /><br />**Field Name:** `leadSalutation`<br />**Type:** dimension                          |
| <div>Lead First Name</div>                 | First name of the lead<br /><br />**Field Name:** `leadFirstName`<br />**Type:** dimension                                            |
| <div>Lead Last Name</div>                  | Last name of the lead<br /><br />**Field Name:** `leadLastName`<br />**Type:** dimension                                              |
| <div>Lead Name</div>                       | Salesforce-computed full name of the lead<br /><br />**Field Name:** `leadName`<br />**Type:** dimension                              |
| <div>Lead Email</div>                      | Email address of the lead<br /><br />**Field Name:** `leadEmail`<br />**Type:** dimension                                             |
| <div>Lead Phone</div>                      | Phone number of the lead<br /><br />**Field Name:** `leadPhone`<br />**Type:** dimension                                              |
| <div>Lead Company</div>                    | Company name attached to the lead<br /><br />**Field Name:** `leadCompany`<br />**Type:** dimension                                   |
| <div>Lead Title</div>                      | Job title of the lead<br /><br />**Field Name:** `leadTitle`<br />**Type:** dimension                                                 |
| <div>Lead Status</div>                     | Current status in the lead funnel (Open/Working/Converted/etc.)<br /><br />**Field Name:** `leadStatus`<br />**Type:** dimension      |
| <div>Lead Source</div>                     | Source the lead originated from<br /><br />**Field Name:** `leadSource`<br />**Type:** dimension                                      |
| <div>Lead Industry</div>                   | Industry of the lead<br /><br />**Field Name:** `leadIndustry`<br />**Type:** dimension                                               |
| <div>Lead Rating</div>                     | Rating (Hot/Warm/Cold)<br /><br />**Field Name:** `leadRating`<br />**Type:** dimension                                               |
| <div>Lead Country</div>                    | Country of the lead<br /><br />**Field Name:** `leadCountry`<br />**Type:** dimension                                                 |
| <div>Lead City</div>                       | City of the lead<br /><br />**Field Name:** `leadCity`<br />**Type:** dimension                                                       |
| <div>Lead State</div>                      | State of the lead<br /><br />**Field Name:** `leadState`<br />**Type:** dimension                                                     |
| <div>Lead Owner ID</div>                   | User ID of the lead owner<br /><br />**Field Name:** `leadOwnerId`<br />**Type:** dimension                                           |
| <div>Lead Owner Name</div>                 | Full name of the lead owner<br /><br />**Field Name:** `leadOwnerName`<br />**Type:** dimension                                       |
| <div>Lead Is Converted</div>               | Whether the lead has been converted to a contact/opportunity<br /><br />**Field Name:** `leadIsConverted`<br />**Type:** dimension    |
| <div>Lead Converted Date</div>             | Date the lead was converted<br /><br />**Field Name:** `leadConvertedDate`<br />**Type:** dimension                                   |
| <div>Lead Created Date</div>               | Date the lead was created<br /><br />**Field Name:** `leadCreatedDate`<br />**Type:** dimension                                       |
| <div>Lead Last Modified Date</div>         | Date the lead was last edited<br /><br />**Field Name:** `leadLastModifiedDate`<br />**Type:** dimension                              |
| <div>Lead Converted Account ID</div>       | Account ID created when the lead was converted<br /><br />**Field Name:** `leadConvertedAccountId`<br />**Type:** dimension           |
| <div>Lead Converted Account Name</div>     | Name of the account created on conversion<br /><br />**Field Name:** `leadConvertedAccountName`<br />**Type:** dimension              |
| <div>Lead Converted Contact ID</div>       | Contact ID created when the lead was converted<br /><br />**Field Name:** `leadConvertedContactId`<br />**Type:** dimension           |
| <div>Lead Converted Contact Name</div>     | Name of the contact created on conversion<br /><br />**Field Name:** `leadConvertedContactName`<br />**Type:** dimension              |
| <div>Lead Converted Opportunity ID</div>   | Opportunity ID created when the lead was converted<br /><br />**Field Name:** `leadConvertedOpportunityId`<br />**Type:** dimension   |
| <div>Lead Converted Opportunity Name</div> | Name of the opportunity created on conversion<br /><br />**Field Name:** `leadConvertedOpportunityName`<br />**Type:** dimension      |
| <div>Lead Description</div>                | Free-text description of the lead<br /><br />**Field Name:** `leadDescription`<br />**Type:** dimension                               |
| <div>Lead Has Opted Out Of Email</div>     | True if the lead has opted out of email communications<br /><br />**Field Name:** `leadHasOptedOutOfEmail`<br />**Type:** dimension   |
| <div>Lead Pronouns</div>                   | Pronouns of the lead (feature must be enabled in org)<br /><br />**Field Name:** `leadPronouns`<br />**Type:** dimension              |
| <div>Lead Gender Identity</div>            | Gender identity of the lead (feature must be enabled in org)<br /><br />**Field Name:** `leadGenderIdentity`<br />**Type:** dimension |

### Opportunity

|                                               |                                                                                                                                             |
| --------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------- |
| <div>Opportunity ID</div>                     | Unique 18-character ID for the opportunity<br /><br />**Field Name:** `opportunityId`<br />**Type:** dimension                              |
| <div>Opportunity Name</div>                   | Name of the opportunity (deal)<br /><br />**Field Name:** `opportunityName`<br />**Type:** dimension                                        |
| <div>Opportunity Stage Name</div>             | Current stage in the sales pipeline<br /><br />**Field Name:** `opportunityStageName`<br />**Type:** dimension                              |
| <div>Opportunity Type</div>                   | Type of opportunity (New Business/Existing Customer/etc.)<br /><br />**Field Name:** `opportunityType`<br />**Type:** dimension             |
| <div>Opportunity Lead Source</div>            | Source that generated the opportunity<br /><br />**Field Name:** `opportunityLeadSource`<br />**Type:** dimension                           |
| <div>Opportunity Next Step</div>              | Description of the next planned step<br /><br />**Field Name:** `opportunityNextStep`<br />**Type:** dimension                              |
| <div>Opportunity Description</div>            | Free-text description of the opportunity<br /><br />**Field Name:** `opportunityDescription`<br />**Type:** dimension                       |
| <div>Opportunity Campaign ID</div>            | ID of the primary campaign source for this opportunity<br /><br />**Field Name:** `opportunityCampaignId`<br />**Type:** dimension          |
| <div>Opportunity Campaign Name</div>          | Name of the primary campaign source<br /><br />**Field Name:** `opportunityCampaignName`<br />**Type:** dimension                           |
| <div>Opportunity Account ID</div>             | ID of the account this opportunity belongs to<br /><br />**Field Name:** `opportunityAccountId`<br />**Type:** dimension                    |
| <div>Opportunity Account Name</div>           | Name of the account this opportunity belongs to<br /><br />**Field Name:** `opportunityAccountName`<br />**Type:** dimension                |
| <div>Opportunity Contact ID</div>             | ID of the primary contact on the opportunity<br /><br />**Field Name:** `opportunityContactId`<br />**Type:** dimension                     |
| <div>Opportunity Contact Name</div>           | Name of the primary contact on the opportunity<br /><br />**Field Name:** `opportunityContactName`<br />**Type:** dimension                 |
| <div>Opportunity Pricebook ID</div>           | ID of the pricebook used for line items<br /><br />**Field Name:** `opportunityPricebookId`<br />**Type:** dimension                        |
| <div>Opportunity Owner ID</div>               | User ID of the opportunity owner<br /><br />**Field Name:** `opportunityOwnerId`<br />**Type:** dimension                                   |
| <div>Opportunity Owner Name</div>             | Full name of the opportunity owner<br /><br />**Field Name:** `opportunityOwnerName`<br />**Type:** dimension                               |
| <div>Opportunity Record Type ID</div>         | Record Type ID assigned to this opportunity<br /><br />**Field Name:** `opportunityRecordTypeId`<br />**Type:** dimension                   |
| <div>Opportunity Record Type Name</div>       | Name of the Record Type assigned to this opportunity<br /><br />**Field Name:** `opportunityRecordTypeName`<br />**Type:** dimension        |
| <div>Opportunity Forecast Category Name</div> | Forecast category (Pipeline/Best Case/Commit/Closed)<br /><br />**Field Name:** `opportunityForecastCategoryName`<br />**Type:** dimension  |
| <div>Opportunity Is Closed</div>              | True when the opportunity is in a closed stage (won or lost)<br /><br />**Field Name:** `opportunityIsClosed`<br />**Type:** dimension      |
| <div>Opportunity Is Won</div>                 | True when the opportunity is in a closed-won stage<br /><br />**Field Name:** `opportunityIsWon`<br />**Type:** dimension                   |
| <div>Opportunity Has Open Activity</div>      | True when the opportunity has at least one open task/event<br /><br />**Field Name:** `opportunityHasOpenActivity`<br />**Type:** dimension |
| <div>Opportunity Created Date</div>           | Date the opportunity was created<br /><br />**Field Name:** `opportunityCreatedDate`<br />**Type:** dimension                               |
| <div>Opportunity Close Date</div>             | Expected (or actual) close date<br /><br />**Field Name:** `opportunityCloseDate`<br />**Type:** dimension                                  |
| <div>Opportunity Last Stage Change Date</div> | Timestamp when the opportunity stage last changed<br /><br />**Field Name:** `opportunityLastStageChangeDate`<br />**Type:** dimension      |
| <div>Opportunity Last Modified Date</div>     | Date the opportunity was last edited<br /><br />**Field Name:** `opportunityLastModifiedDate`<br />**Type:** dimension                      |
| <div>Opportunity Last Activity Date</div>     | Date of the most recent activity on the opportunity<br /><br />**Field Name:** `opportunityLastActivityDate`<br />**Type:** dimension       |

### Case

|                                    |                                                                                                                                    |
| ---------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------- |
| <div>Case ID</div>                 | Unique 18-character ID for the case<br /><br />**Field Name:** `caseId`<br />**Type:** dimension                                   |
| <div>Case Number</div>             | Auto-incrementing case number visible to users<br /><br />**Field Name:** `caseNumber`<br />**Type:** dimension                    |
| <div>Case Subject</div>            | Subject line of the case<br /><br />**Field Name:** `caseSubject`<br />**Type:** dimension                                         |
| <div>Case Status</div>             | Current status of the case<br /><br />**Field Name:** `caseStatus`<br />**Type:** dimension                                        |
| <div>Case Priority</div>           | Priority of the case (High/Medium/Low)<br /><br />**Field Name:** `casePriority`<br />**Type:** dimension                          |
| <div>Case Origin</div>             | Channel the case originated from (Web/Email/Phone/etc.)<br /><br />**Field Name:** `caseOrigin`<br />**Type:** dimension           |
| <div>Case Type</div>               | Type categorisation<br /><br />**Field Name:** `caseType`<br />**Type:** dimension                                                 |
| <div>Case Reason</div>             | Reason the case was opened<br /><br />**Field Name:** `caseReason`<br />**Type:** dimension                                        |
| <div>Case Description</div>        | Free-text description of the case<br /><br />**Field Name:** `caseDescription`<br />**Type:** dimension                            |
| <div>Case Account ID</div>         | ID of the account associated with the case<br /><br />**Field Name:** `caseAccountId`<br />**Type:** dimension                     |
| <div>Case Account Name</div>       | Name of the account associated with the case<br /><br />**Field Name:** `caseAccountName`<br />**Type:** dimension                 |
| <div>Case Contact ID</div>         | ID of the primary contact on the case<br /><br />**Field Name:** `caseContactId`<br />**Type:** dimension                          |
| <div>Case Contact Name</div>       | Name of the primary contact on the case<br /><br />**Field Name:** `caseContactName`<br />**Type:** dimension                      |
| <div>Case Owner ID</div>           | User/Queue ID owning the case<br /><br />**Field Name:** `caseOwnerId`<br />**Type:** dimension                                    |
| <div>Case Owner Name</div>         | Name of the user/queue owning the case<br /><br />**Field Name:** `caseOwnerName`<br />**Type:** dimension                         |
| <div>Case Record Type ID</div>     | Record Type ID assigned to this case<br /><br />**Field Name:** `caseRecordTypeId`<br />**Type:** dimension                        |
| <div>Case Record Type Name</div>   | Name of the Record Type assigned to this case<br /><br />**Field Name:** `caseRecordTypeName`<br />**Type:** dimension             |
| <div>Case Supplied Name</div>      | Name supplied by the user via Web-to-Case / Email-to-Case<br /><br />**Field Name:** `caseSuppliedName`<br />**Type:** dimension   |
| <div>Case Supplied Email</div>     | Email supplied by the user via Web-to-Case / Email-to-Case<br /><br />**Field Name:** `caseSuppliedEmail`<br />**Type:** dimension |
| <div>Case Supplied Phone</div>     | Phone supplied by the user via Web-to-Case<br /><br />**Field Name:** `caseSuppliedPhone`<br />**Type:** dimension                 |
| <div>Case Supplied Company</div>   | Company supplied by the user via Web-to-Case<br /><br />**Field Name:** `caseSuppliedCompany`<br />**Type:** dimension             |
| <div>Case Is Closed</div>          | True when the case status is closed<br /><br />**Field Name:** `caseIsClosed`<br />**Type:** dimension                             |
| <div>Case Is Escalated</div>       | True when the case has been escalated<br /><br />**Field Name:** `caseIsEscalated`<br />**Type:** dimension                        |
| <div>Case Created Date</div>       | Date the case was created<br /><br />**Field Name:** `caseCreatedDate`<br />**Type:** dimension                                    |
| <div>Case Closed Date</div>        | Date the case was closed<br /><br />**Field Name:** `caseClosedDate`<br />**Type:** dimension                                      |
| <div>Case Last Modified Date</div> | Date the case was last edited<br /><br />**Field Name:** `caseLastModifiedDate`<br />**Type:** dimension                           |

### Campaign

|                                        |                                                                                                                              |
| -------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------- |
| <div>Campaign ID</div>                 | Unique 18-character ID for the campaign<br /><br />**Field Name:** `campaignId`<br />**Type:** dimension                     |
| <div>Campaign Name</div>               | Name of the campaign<br /><br />**Field Name:** `campaignName`<br />**Type:** dimension                                      |
| <div>Campaign Type</div>               | Campaign type (Email/Event/Webinar/etc.)<br /><br />**Field Name:** `campaignType`<br />**Type:** dimension                  |
| <div>Campaign Status</div>             | Campaign status (Planned/In Progress/Completed/Aborted)<br /><br />**Field Name:** `campaignStatus`<br />**Type:** dimension |
| <div>Campaign Description</div>        | Free-text description of the campaign<br /><br />**Field Name:** `campaignDescription`<br />**Type:** dimension              |
| <div>Campaign Parent ID</div>          | Parent campaign ID (campaign hierarchies)<br /><br />**Field Name:** `campaignParentId`<br />**Type:** dimension             |
| <div>Campaign Parent Name</div>        | Parent campaign name<br /><br />**Field Name:** `campaignParentName`<br />**Type:** dimension                                |
| <div>Campaign Owner ID</div>           | User ID of the campaign owner<br /><br />**Field Name:** `campaignOwnerId`<br />**Type:** dimension                          |
| <div>Campaign Owner Name</div>         | Full name of the campaign owner<br /><br />**Field Name:** `campaignOwnerName`<br />**Type:** dimension                      |
| <div>Campaign Is Active</div>          | Whether the campaign is active<br /><br />**Field Name:** `campaignIsActive`<br />**Type:** dimension                        |
| <div>Campaign Start Date</div>         | Planned start date of the campaign<br /><br />**Field Name:** `campaignStartDate`<br />**Type:** dimension                   |
| <div>Campaign End Date</div>           | Planned end date of the campaign<br /><br />**Field Name:** `campaignEndDate`<br />**Type:** dimension                       |
| <div>Campaign Created Date</div>       | Date the campaign was created<br /><br />**Field Name:** `campaignCreatedDate`<br />**Type:** dimension                      |
| <div>Campaign Last Modified Date</div> | Date the campaign was last edited<br /><br />**Field Name:** `campaignLastModifiedDate`<br />**Type:** dimension             |

### Task

|                                             |                                                                                                                                                 |
| ------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------- |
| <div>Task ID</div>                          | Unique 18-character ID for the task<br /><br />**Field Name:** `taskId`<br />**Type:** dimension                                                |
| <div>Task Subject</div>                     | Subject of the task<br /><br />**Field Name:** `taskSubject`<br />**Type:** dimension                                                           |
| <div>Task Status</div>                      | Current status of the task<br /><br />**Field Name:** `taskStatus`<br />**Type:** dimension                                                     |
| <div>Task Priority</div>                    | Priority of the task<br /><br />**Field Name:** `taskPriority`<br />**Type:** dimension                                                         |
| <div>Task Type</div>                        | Task subtype (Task/Call/Email/etc.)<br /><br />**Field Name:** `taskType`<br />**Type:** dimension                                              |
| <div>Task Description</div>                 | Free-text description of the task<br /><br />**Field Name:** `taskDescription`<br />**Type:** dimension                                         |
| <div>Task Who ID</div>                      | Polymorphic ID — Lead or Contact the task relates to<br /><br />**Field Name:** `taskWhoId`<br />**Type:** dimension                            |
| <div>Task What ID</div>                     | Polymorphic ID — Account/Opportunity/Case/etc. the task relates to<br /><br />**Field Name:** `taskWhatId`<br />**Type:** dimension             |
| <div>Task Account ID</div>                  | Account ID derived from the WhatId or contact relationship<br /><br />**Field Name:** `taskAccountId`<br />**Type:** dimension                  |
| <div>Task Account Name</div>                | Account name derived from the task relationship<br /><br />**Field Name:** `taskAccountName`<br />**Type:** dimension                           |
| <div>Task Owner ID</div>                    | User ID of the task owner<br /><br />**Field Name:** `taskOwnerId`<br />**Type:** dimension                                                     |
| <div>Task Owner Name</div>                  | Full name of the task owner<br /><br />**Field Name:** `taskOwnerName`<br />**Type:** dimension                                                 |
| <div>Task Is Closed</div>                   | True when the task is in a closed status<br /><br />**Field Name:** `taskIsClosed`<br />**Type:** dimension                                     |
| <div>Task Activity Date</div>               | Due date of the task<br /><br />**Field Name:** `taskActivityDate`<br />**Type:** dimension                                                     |
| <div>Task Completed Date Time</div>         | Timestamp the task was completed<br /><br />**Field Name:** `taskCompletedDateTime`<br />**Type:** dimension                                    |
| <div>Task Created Date</div>                | Date the task was created<br /><br />**Field Name:** `taskCreatedDate`<br />**Type:** dimension                                                 |
| <div>Task Is Recurrence</div>               | True when the task is part of a recurring series<br /><br />**Field Name:** `taskIsRecurrence`<br />**Type:** dimension                         |
| <div>Task Recurrence Start Date</div>       | Start date of the recurring series<br /><br />**Field Name:** `taskRecurrenceStartDateOnly`<br />**Type:** dimension                            |
| <div>Task Recurrence End Date</div>         | End date of the recurring series<br /><br />**Field Name:** `taskRecurrenceEndDateOnly`<br />**Type:** dimension                                |
| <div>Task Recurrence Time Zone</div>        | IANA timezone key for the recurring series<br /><br />**Field Name:** `taskRecurrenceTimeZoneSidKey`<br />**Type:** dimension                   |
| <div>Task Recurrence Type</div>             | Recurrence pattern type (Daily/Weekly/Monthly/Yearly)<br /><br />**Field Name:** `taskRecurrenceType`<br />**Type:** dimension                  |
| <div>Task Recurrence Interval</div>         | Interval between recurrences (e.g., every N days/weeks)<br /><br />**Field Name:** `taskRecurrenceInterval`<br />**Type:** dimension            |
| <div>Task Recurrence Day Of Week Mask</div> | Bitmask of selected weekdays for weekly recurrences<br /><br />**Field Name:** `taskRecurrenceDayOfWeekMask`<br />**Type:** dimension           |
| <div>Task Recurrence Day Of Month</div>     | Day of month for monthly recurrences<br /><br />**Field Name:** `taskRecurrenceDayOfMonth`<br />**Type:** dimension                             |
| <div>Task Recurrence Instance</div>         | Which occurrence within the month (First/Second/Third/Fourth/Last)<br /><br />**Field Name:** `taskRecurrenceInstance`<br />**Type:** dimension |
| <div>Task Recurrence Month Of Year</div>    | Month of year for yearly recurrences<br /><br />**Field Name:** `taskRecurrenceMonthOfYear`<br />**Type:** dimension                            |
| <div>Task Recurrence Regenerated Type</div> | Whether the next task is regenerated after completion<br /><br />**Field Name:** `taskRecurrenceRegeneratedType`<br />**Type:** dimension       |

### Event

|                                              |                                                                                                                                                  |
| -------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------ |
| <div>Event ID</div>                          | Unique 18-character ID for the event<br /><br />**Field Name:** `eventId`<br />**Type:** dimension                                               |
| <div>Event Subject</div>                     | Subject of the event (meeting)<br /><br />**Field Name:** `eventSubject`<br />**Type:** dimension                                                |
| <div>Event Description</div>                 | Free-text description of the event<br /><br />**Field Name:** `eventDescription`<br />**Type:** dimension                                        |
| <div>Event Location</div>                    | Location of the event (e.g., Zoom, room name, city)<br /><br />**Field Name:** `eventLocation`<br />**Type:** dimension                          |
| <div>Event Type</div>                        | Event subtype<br /><br />**Field Name:** `eventType`<br />**Type:** dimension                                                                    |
| <div>Event Who ID</div>                      | Polymorphic ID — Lead or Contact the event relates to<br /><br />**Field Name:** `eventWhoId`<br />**Type:** dimension                           |
| <div>Event What ID</div>                     | Polymorphic ID — Account/Opportunity/etc. the event relates to<br /><br />**Field Name:** `eventWhatId`<br />**Type:** dimension                 |
| <div>Event Account ID</div>                  | Account ID derived from the event relationship<br /><br />**Field Name:** `eventAccountId`<br />**Type:** dimension                              |
| <div>Event Account Name</div>                | Account name derived from the event relationship<br /><br />**Field Name:** `eventAccountName`<br />**Type:** dimension                          |
| <div>Event Owner ID</div>                    | User ID of the event owner<br /><br />**Field Name:** `eventOwnerId`<br />**Type:** dimension                                                    |
| <div>Event Owner Name</div>                  | Full name of the event owner<br /><br />**Field Name:** `eventOwnerName`<br />**Type:** dimension                                                |
| <div>Event Is All Day Event</div>            | True for all-day events (no specific start time)<br /><br />**Field Name:** `eventIsAllDayEvent`<br />**Type:** dimension                        |
| <div>Event Start Date Time</div>             | Event start timestamp<br /><br />**Field Name:** `eventStartDateTime`<br />**Type:** dimension                                                   |
| <div>Event End Date Time</div>               | Event end timestamp<br /><br />**Field Name:** `eventEndDateTime`<br />**Type:** dimension                                                       |
| <div>Event Activity Date Time</div>          | Activity timestamp (computed by Salesforce from start time)<br /><br />**Field Name:** `eventActivityDateTime`<br />**Type:** dimension          |
| <div>Event Created Date</div>                | Date the event was created<br /><br />**Field Name:** `eventCreatedDate`<br />**Type:** dimension                                                |
| <div>Event Is Recurrence</div>               | True when the event is part of a recurring series<br /><br />**Field Name:** `eventIsRecurrence`<br />**Type:** dimension                        |
| <div>Event Recurrence Start Date Time</div>  | Start timestamp of the recurring series<br /><br />**Field Name:** `eventRecurrenceStartDateTime`<br />**Type:** dimension                       |
| <div>Event Recurrence End Date</div>         | End date of the recurring series<br /><br />**Field Name:** `eventRecurrenceEndDateOnly`<br />**Type:** dimension                                |
| <div>Event Recurrence Time Zone</div>        | IANA timezone key for the recurring series<br /><br />**Field Name:** `eventRecurrenceTimeZoneSidKey`<br />**Type:** dimension                   |
| <div>Event Recurrence Type</div>             | Recurrence pattern type (Daily/Weekly/Monthly/Yearly)<br /><br />**Field Name:** `eventRecurrenceType`<br />**Type:** dimension                  |
| <div>Event Recurrence Interval</div>         | Interval between recurrences<br /><br />**Field Name:** `eventRecurrenceInterval`<br />**Type:** dimension                                       |
| <div>Event Recurrence Day Of Week Mask</div> | Bitmask of selected weekdays for weekly recurrences<br /><br />**Field Name:** `eventRecurrenceDayOfWeekMask`<br />**Type:** dimension           |
| <div>Event Recurrence Day Of Month</div>     | Day of month for monthly recurrences<br /><br />**Field Name:** `eventRecurrenceDayOfMonth`<br />**Type:** dimension                             |
| <div>Event Recurrence Instance</div>         | Which occurrence within the month (First/Second/Third/Fourth/Last)<br /><br />**Field Name:** `eventRecurrenceInstance`<br />**Type:** dimension |
| <div>Event Recurrence Month Of Year</div>    | Month of year for yearly recurrences<br /><br />**Field Name:** `eventRecurrenceMonthOfYear`<br />**Type:** dimension                            |
| <div>Event Show As</div>                     | Calendar visibility (Busy/Out Of Office/Free)<br /><br />**Field Name:** `eventShowAs`<br />**Type:** dimension                                  |
| <div>Event Is Child</div>                    | True for child events under a group event<br /><br />**Field Name:** `eventIsChild`<br />**Type:** dimension                                     |
| <div>Event Is Group Event</div>              | True when the event is a group/multi-attendee event<br /><br />**Field Name:** `eventIsGroupEvent`<br />**Type:** dimension                      |
| <div>Event Group Event Type</div>            | Group event type (Group Event / Proposed)<br /><br />**Field Name:** `eventGroupEventType`<br />**Type:** dimension                              |

### User

|                                            |                                                                                                                                               |
| ------------------------------------------ | --------------------------------------------------------------------------------------------------------------------------------------------- |
| <div>User ID</div>                         | Unique 18-character User ID<br /><br />**Field Name:** `userId`<br />**Type:** dimension                                                      |
| <div>User Name</div>                       | Display name (first + last)<br /><br />**Field Name:** `userName`<br />**Type:** dimension                                                    |
| <div>User First Name</div>                 | First name<br /><br />**Field Name:** `userFirstName`<br />**Type:** dimension                                                                |
| <div>User Last Name</div>                  | Last name<br /><br />**Field Name:** `userLastName`<br />**Type:** dimension                                                                  |
| <div>Username</div>                        | Login username (email-style)<br /><br />**Field Name:** `userUsername`<br />**Type:** dimension                                               |
| <div>User Alias</div>                      | Short alias for the user (≤8 chars)<br /><br />**Field Name:** `userAlias`<br />**Type:** dimension                                           |
| <div>User Email</div>                      | Email address<br /><br />**Field Name:** `userEmail`<br />**Type:** dimension                                                                 |
| <div>User Title</div>                      | Job title<br /><br />**Field Name:** `userTitle`<br />**Type:** dimension                                                                     |
| <div>User Department</div>                 | Department<br /><br />**Field Name:** `userDepartment`<br />**Type:** dimension                                                               |
| <div>User Company Name</div>               | Company name on the user record<br /><br />**Field Name:** `userCompanyName`<br />**Type:** dimension                                         |
| <div>User Division</div>                   | Division on the user record<br /><br />**Field Name:** `userDivision`<br />**Type:** dimension                                                |
| <div>User Employee Number</div>            | Employee number on the user record<br /><br />**Field Name:** `userEmployeeNumber`<br />**Type:** dimension                                   |
| <div>User Phone</div>                      | Primary phone<br /><br />**Field Name:** `userPhone`<br />**Type:** dimension                                                                 |
| <div>User Mobile Phone</div>               | Mobile phone<br /><br />**Field Name:** `userMobilePhone`<br />**Type:** dimension                                                            |
| <div>User Fax</div>                        | Fax number<br /><br />**Field Name:** `userFax`<br />**Type:** dimension                                                                      |
| <div>User Street</div>                     | Street address<br /><br />**Field Name:** `userStreet`<br />**Type:** dimension                                                               |
| <div>User City</div>                       | City<br /><br />**Field Name:** `userCity`<br />**Type:** dimension                                                                           |
| <div>User State</div>                      | State or province<br /><br />**Field Name:** `userState`<br />**Type:** dimension                                                             |
| <div>User Postal Code</div>                | Postal/ZIP code<br /><br />**Field Name:** `userPostalCode`<br />**Type:** dimension                                                          |
| <div>User Country</div>                    | Country<br /><br />**Field Name:** `userCountry`<br />**Type:** dimension                                                                     |
| <div>User Profile ID</div>                 | ID of the assigned Profile<br /><br />**Field Name:** `userProfileId`<br />**Type:** dimension                                                |
| <div>User Profile Name</div>               | Name of the assigned Profile<br /><br />**Field Name:** `userProfileName`<br />**Type:** dimension                                            |
| <div>User Role ID</div>                    | ID of the assigned Role<br /><br />**Field Name:** `userRoleId`<br />**Type:** dimension                                                      |
| <div>User Manager ID</div>                 | ID of the user's manager<br /><br />**Field Name:** `userManagerId`<br />**Type:** dimension                                                  |
| <div>User Manager Name</div>               | Name of the user's manager<br /><br />**Field Name:** `userManagerName`<br />**Type:** dimension                                              |
| <div>User Type</div>                       | User license type (Standard, CustomerSuccess, etc.)<br /><br />**Field Name:** `userUserType`<br />**Type:** dimension                        |
| <div>User Time Zone</div>                  | IANA timezone key<br /><br />**Field Name:** `userTimeZone`<br />**Type:** dimension                                                          |
| <div>User Locale</div>                     | Locale key (e.g., en\_US) — controls number/date formatting<br /><br />**Field Name:** `userLocaleSidKey`<br />**Type:** dimension            |
| <div>User Language</div>                   | UI language key (e.g., en\_US, es)<br /><br />**Field Name:** `userLanguageLocaleKey`<br />**Type:** dimension                                |
| <div>User Email Encoding</div>             | Character encoding for outbound email (e.g., UTF-8)<br /><br />**Field Name:** `userEmailEncodingKey`<br />**Type:** dimension                |
| <div>User Digest Frequency</div>           | Chatter digest email frequency (D/W/N)<br /><br />**Field Name:** `userDigestFrequency`<br />**Type:** dimension                              |
| <div>User Call Center ID</div>             | ID of the assigned Call Center (CTI)<br /><br />**Field Name:** `userCallCenterId`<br />**Type:** dimension                                   |
| <div>User Receives Admin Info Emails</div> | Whether the user receives admin info emails from Salesforce<br /><br />**Field Name:** `userReceivesAdminInfoEmails`<br />**Type:** dimension |
| <div>User Receives Info Emails</div>       | Whether the user receives marketing/info emails from Salesforce<br /><br />**Field Name:** `userReceivesInfoEmails`<br />**Type:** dimension  |
| <div>User Forecast Enabled</div>           | Whether the user is enabled for forecasting<br /><br />**Field Name:** `userForecastEnabled`<br />**Type:** dimension                         |
| <div>User Is Active</div>                  | Whether the user is currently active<br /><br />**Field Name:** `userIsActive`<br />**Type:** dimension                                       |
| <div>User About Me</div>                   | Free-text about-me field shown on the user profile<br /><br />**Field Name:** `userAboutMe`<br />**Type:** dimension                          |
| <div>User Last Login Date</div>            | Most recent login timestamp<br /><br />**Field Name:** `userLastLoginDate`<br />**Type:** dimension                                           |
| <div>User Created Date</div>               | Date the user was created<br /><br />**Field Name:** `userCreatedDate`<br />**Type:** dimension                                               |

### User Preferences

|                                                          |                                                                                                                                                                |
| -------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| <div>User Activity Reminders Popup</div>                 | Activity reminders popup preference<br /><br />**Field Name:** `userUserPreferencesActivityRemindersPopup`<br />**Type:** dimension                            |
| <div>User Event Reminders Default</div>                  | Default state of the event reminders checkbox<br /><br />**Field Name:** `userUserPreferencesEventRemindersCheckboxDefault`<br />**Type:** dimension           |
| <div>User Task Reminders Default</div>                   | Default state of the task reminders checkbox<br /><br />**Field Name:** `userUserPreferencesTaskRemindersCheckboxDefault`<br />**Type:** dimension             |
| <div>User Reminder Sound Off</div>                       | Disable reminder sounds<br /><br />**Field Name:** `userUserPreferencesReminderSoundOff`<br />**Type:** dimension                                              |
| <div>User Suppress Event SFX Reminders</div>             | Suppress event SFX reminders<br /><br />**Field Name:** `userUserPreferencesSuppressEventSFXReminders`<br />**Type:** dimension                                |
| <div>User Suppress Task SFX Reminders</div>              | Suppress task SFX reminders<br /><br />**Field Name:** `userUserPreferencesSuppressTaskSFXReminders`<br />**Type:** dimension                                  |
| <div>User Reverse Open Activities View</div>             | Reverse the Open Activities list order<br /><br />**Field Name:** `userUserPreferencesReverseOpenActivitiesView`<br />**Type:** dimension                      |
| <div>User Disable All Feeds Email</div>                  | Disable all Chatter feed emails<br /><br />**Field Name:** `userUserPreferencesDisableAllFeedsEmail`<br />**Type:** dimension                                  |
| <div>User Disable Followers Email</div>                  | Disable new-follower email notifications<br /><br />**Field Name:** `userUserPreferencesDisableFollowersEmail`<br />**Type:** dimension                        |
| <div>User Disable Profile Post Email</div>               | Disable profile-post email notifications<br /><br />**Field Name:** `userUserPreferencesDisableProfilePostEmail`<br />**Type:** dimension                      |
| <div>User Disable Change Comment Email</div>             | Disable change-comment email notifications<br /><br />**Field Name:** `userUserPreferencesDisableChangeCommentEmail`<br />**Type:** dimension                  |
| <div>User Disable Later Comment Email</div>              | Disable later-comment email notifications<br /><br />**Field Name:** `userUserPreferencesDisableLaterCommentEmail`<br />**Type:** dimension                    |
| <div>User Disable Like Email</div>                       | Disable like email notifications<br /><br />**Field Name:** `userUserPreferencesDisableLikeEmail`<br />**Type:** dimension                                     |
| <div>User Disable Message Email</div>                    | Disable message email notifications<br /><br />**Field Name:** `userUserPreferencesDisableMessageEmail`<br />**Type:** dimension                               |
| <div>User Disable Endorsement Email</div>                | Disable endorsement email notifications<br /><br />**Field Name:** `userUserPreferencesDisableEndorsementEmail`<br />**Type:** dimension                       |
| <div>User Disable Feedback Email</div>                   | Disable feedback email notifications<br /><br />**Field Name:** `userUserPreferencesDisableFeedbackEmail`<br />**Type:** dimension                             |
| <div>User Disable Mentions Post Email</div>              | Disable mentions-in-post email notifications<br /><br />**Field Name:** `userUserPreferencesDisableMentionsPostEmail`<br />**Type:** dimension                 |
| <div>User Disable Share Post Email</div>                 | Disable share-post email notifications<br /><br />**Field Name:** `userUserPreferencesDisableSharePostEmail`<br />**Type:** dimension                          |
| <div>User Disable Bookmark Email</div>                   | Disable bookmark email notifications<br /><br />**Field Name:** `userUserPreferencesDisableBookmarkEmail`<br />**Type:** dimension                             |
| <div>User Disable Reward Email</div>                     | Disable reward email notifications<br /><br />**Field Name:** `userUserPreferencesDisableRewardEmail`<br />**Type:** dimension                                 |
| <div>User Disable Work Email</div>                       | Disable work email notifications<br /><br />**Field Name:** `userUserPreferencesDisableWorkEmail`<br />**Type:** dimension                                     |
| <div>User Disable File Share Notifications (API)</div>   | Disable file-share notifications via API<br /><br />**Field Name:** `userUserPreferencesDisableFileShareNotificationsForApi`<br />**Type:** dimension          |
| <div>User Disable Profile Post Comment Email</div>       | Disable profile-post comment email notifications<br /><br />**Field Name:** `userUserPreferencesDisProfPostCommentEmail`<br />**Type:** dimension              |
| <div>User Disable Mentions Comment Email</div>           | Disable mentions-in-comment email notifications<br /><br />**Field Name:** `userUserPreferencesDisMentionsCommentEmail`<br />**Type:** dimension               |
| <div>User Disable Comment After Like Email</div>         | Disable comment-after-like email notifications<br /><br />**Field Name:** `userUserPreferencesDisCommentAfterLikeEmail`<br />**Type:** dimension               |
| <div>User Show Email To External Users</div>             | Expose email to external community users<br /><br />**Field Name:** `userUserPreferencesShowEmailToExternalUsers`<br />**Type:** dimension                     |
| <div>User Show Email To Guest Users</div>                | Expose email to guest users<br /><br />**Field Name:** `userUserPreferencesShowEmailToGuestUsers`<br />**Type:** dimension                                     |
| <div>User Show Title To External Users</div>             | Expose title to external community users<br /><br />**Field Name:** `userUserPreferencesShowTitleToExternalUsers`<br />**Type:** dimension                     |
| <div>User Show Title To Guest Users</div>                | Expose title to guest users<br /><br />**Field Name:** `userUserPreferencesShowTitleToGuestUsers`<br />**Type:** dimension                                     |
| <div>User Show Manager To External Users</div>           | Expose manager to external community users<br /><br />**Field Name:** `userUserPreferencesShowManagerToExternalUsers`<br />**Type:** dimension                 |
| <div>User Show Manager To Guest Users</div>              | Expose manager to guest users<br /><br />**Field Name:** `userUserPreferencesShowManagerToGuestUsers`<br />**Type:** dimension                                 |
| <div>User Show Work Phone To External Users</div>        | Expose work phone to external community users<br /><br />**Field Name:** `userUserPreferencesShowWorkPhoneToExternalUsers`<br />**Type:** dimension            |
| <div>User Show Work Phone To Guest Users</div>           | Expose work phone to guest users<br /><br />**Field Name:** `userUserPreferencesShowWorkPhoneToGuestUsers`<br />**Type:** dimension                            |
| <div>User Show Mobile Phone To External Users</div>      | Expose mobile phone to external community users<br /><br />**Field Name:** `userUserPreferencesShowMobilePhoneToExternalUsers`<br />**Type:** dimension        |
| <div>User Show Mobile Phone To Guest Users</div>         | Expose mobile phone to guest users<br /><br />**Field Name:** `userUserPreferencesShowMobilePhoneToGuestUsers`<br />**Type:** dimension                        |
| <div>User Show Fax To External Users</div>               | Expose fax to external community users<br /><br />**Field Name:** `userUserPreferencesShowFaxToExternalUsers`<br />**Type:** dimension                         |
| <div>User Show Fax To Guest Users</div>                  | Expose fax to guest users<br /><br />**Field Name:** `userUserPreferencesShowFaxToGuestUsers`<br />**Type:** dimension                                         |
| <div>User Show Street To External Users</div>            | Expose street address to external community users<br /><br />**Field Name:** `userUserPreferencesShowStreetAddressToExternalUsers`<br />**Type:** dimension    |
| <div>User Show Street To Guest Users</div>               | Expose street address to guest users<br /><br />**Field Name:** `userUserPreferencesShowStreetAddressToGuestUsers`<br />**Type:** dimension                    |
| <div>User Show City To External Users</div>              | Expose city to external community users<br /><br />**Field Name:** `userUserPreferencesShowCityToExternalUsers`<br />**Type:** dimension                       |
| <div>User Show City To Guest Users</div>                 | Expose city to guest users<br /><br />**Field Name:** `userUserPreferencesShowCityToGuestUsers`<br />**Type:** dimension                                       |
| <div>User Show State To External Users</div>             | Expose state to external community users<br /><br />**Field Name:** `userUserPreferencesShowStateToExternalUsers`<br />**Type:** dimension                     |
| <div>User Show State To Guest Users</div>                | Expose state to guest users<br /><br />**Field Name:** `userUserPreferencesShowStateToGuestUsers`<br />**Type:** dimension                                     |
| <div>User Show Postal Code To External Users</div>       | Expose postal code to external community users<br /><br />**Field Name:** `userUserPreferencesShowPostalCodeToExternalUsers`<br />**Type:** dimension          |
| <div>User Show Postal Code To Guest Users</div>          | Expose postal code to guest users<br /><br />**Field Name:** `userUserPreferencesShowPostalCodeToGuestUsers`<br />**Type:** dimension                          |
| <div>User Show Country To External Users</div>           | Expose country to external community users<br /><br />**Field Name:** `userUserPreferencesShowCountryToExternalUsers`<br />**Type:** dimension                 |
| <div>User Show Country To Guest Users</div>              | Expose country to guest users<br /><br />**Field Name:** `userUserPreferencesShowCountryToGuestUsers`<br />**Type:** dimension                                 |
| <div>User Show Profile Pic To Guest Users</div>          | Expose profile picture to guest users<br /><br />**Field Name:** `userUserPreferencesShowProfilePicToGuestUsers`<br />**Type:** dimension                      |
| <div>User Lightning Experience Preferred</div>           | Whether the user prefers Lightning Experience<br /><br />**Field Name:** `userUserPreferencesLightningExperiencePreferred`<br />**Type:** dimension            |
| <div>User Native Email Client</div>                      | Use native email client preference<br /><br />**Field Name:** `userUserPreferencesNativeEmailClient`<br />**Type:** dimension                                  |
| <div>User Enable Auto Subscribe For Feeds</div>          | Auto-subscribe to feeds for objects the user creates<br /><br />**Field Name:** `userUserPreferencesEnableAutoSubForFeeds`<br />**Type:** dimension            |
| <div>User Sort Feed By Comment</div>                     | Sort feed by most-recent comment<br /><br />**Field Name:** `userUserPreferencesSortFeedByComment`<br />**Type:** dimension                                    |
| <div>User Favorites Show Top Favorites</div>             | Show top favorites in the favorites menu<br /><br />**Field Name:** `userUserPreferencesFavoritesShowTopFavorites`<br />**Type:** dimension                    |
| <div>User Receive No Approver Notifications</div>        | Receive no notifications as an approver<br /><br />**Field Name:** `userUserPreferencesReceiveNoNotificationsAsApprover`<br />**Type:** dimension              |
| <div>User Receive Delegated Approver Notifications</div> | Receive notifications as a delegated approver<br /><br />**Field Name:** `userUserPreferencesReceiveNotificationsAsDelegatedApprover`<br />**Type:** dimension |
| <div>User Show Forecasting Change Signals</div>          | Show forecasting change signals<br /><br />**Field Name:** `userUserPreferencesShowForecastingChangeSignals`<br />**Type:** dimension                          |
| <div>User Opt Out Of Touch</div>                         | Opt out of touch UI on mobile<br /><br />**Field Name:** `userUserPreferencesOptOutOfTouch`<br />**Type:** dimension                                           |
| <div>User Path Assistant Collapsed</div>                 | Whether the Path assistant defaults to collapsed<br /><br />**Field Name:** `userUserPreferencesPathAssistantCollapsed`<br />**Type:** dimension               |

### Opportunity Line Item

|                                                     |                                                                                                                                   |
| --------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------- |
| <div>Opportunity Line Item ID</div>                 | Unique 18-character ID for the line item<br /><br />**Field Name:** `opportunityLineItemId`<br />**Type:** dimension              |
| <div>Opportunity Line Item Name</div>               | Auto-computed name of the line item (Opp + Product)<br /><br />**Field Name:** `opportunityLineItemName`<br />**Type:** dimension |
| <div>Opportunity Line Item Description</div>        | Free-text description for the line item<br /><br />**Field Name:** `opportunityLineItemDescription`<br />**Type:** dimension      |
| <div>Opportunity Line Item Opportunity ID</div>     | ID of the parent opportunity<br /><br />**Field Name:** `opportunityLineItemOpportunityId`<br />**Type:** dimension               |
| <div>Opportunity Line Item Opportunity Name</div>   | Name of the parent opportunity<br /><br />**Field Name:** `opportunityLineItemOpportunityName`<br />**Type:** dimension           |
| <div>Opportunity Line Item Product ID</div>         | ID of the referenced Product2<br /><br />**Field Name:** `opportunityLineItemProductId`<br />**Type:** dimension                  |
| <div>Opportunity Line Item Product Name</div>       | Name of the referenced product<br /><br />**Field Name:** `opportunityLineItemProductName`<br />**Type:** dimension               |
| <div>Opportunity Line Item Product Code</div>       | SKU/product code from the referenced product<br /><br />**Field Name:** `opportunityLineItemProductCode`<br />**Type:** dimension |
| <div>Opportunity Line Item Service Date</div>       | Service date for the line item<br /><br />**Field Name:** `opportunityLineItemServiceDate`<br />**Type:** dimension               |
| <div>Opportunity Line Item Pricebook Entry ID</div> | ID of the underlying PricebookEntry<br /><br />**Field Name:** `opportunityLineItemPricebookEntryId`<br />**Type:** dimension     |
| <div>Opportunity Line Item Created Date</div>       | Date the line item was created<br /><br />**Field Name:** `opportunityLineItemCreatedDate`<br />**Type:** dimension               |
| <div>Opportunity Line Item Last Modified Date</div> | Date the line item was last edited<br /><br />**Field Name:** `opportunityLineItemLastModifiedDate`<br />**Type:** dimension      |

### Product

|                                       |                                                                                                                |
| ------------------------------------- | -------------------------------------------------------------------------------------------------------------- |
| <div>Product ID</div>                 | Unique 18-character ID for the product<br /><br />**Field Name:** `productId`<br />**Type:** dimension         |
| <div>Product Name</div>               | Name of the product<br /><br />**Field Name:** `productName`<br />**Type:** dimension                          |
| <div>Product Code</div>               | SKU/code of the product<br /><br />**Field Name:** `productCode`<br />**Type:** dimension                      |
| <div>Product Description</div>        | Free-text description of the product<br /><br />**Field Name:** `productDescription`<br />**Type:** dimension  |
| <div>Product Family</div>             | Product family (categorisation picklist)<br /><br />**Field Name:** `productFamily`<br />**Type:** dimension   |
| <div>Product Is Active</div>          | Whether the product is active<br /><br />**Field Name:** `productIsActive`<br />**Type:** dimension            |
| <div>Product External ID</div>        | External identifier on the product<br /><br />**Field Name:** `productExternalId`<br />**Type:** dimension     |
| <div>Product SKU</div>                | Stock-keeping unit<br /><br />**Field Name:** `productStockKeepingUnit`<br />**Type:** dimension               |
| <div>Product Created Date</div>       | Date the product was created<br /><br />**Field Name:** `productCreatedDate`<br />**Type:** dimension          |
| <div>Product Last Modified Date</div> | Date the product was last edited<br /><br />**Field Name:** `productLastModifiedDate`<br />**Type:** dimension |

## Metrics

Metrics are the numerical values you can measure and analyze from your Salesforce campaigns.

### Account

|                                        |                                                                                                                                             |
| -------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------- |
| <div>Account Count</div>               | Count of accounts (1 per row when joined with dimensions; total when alone)<br /><br />**Field Name:** `accountCount`<br />**Type:** metric |
| <div>Account Annual Revenue</div>      | Annual revenue reported on the account<br /><br />**Field Name:** `accountAnnualRevenue`<br />**Type:** metric                              |
| <div>Account Number Of Employees</div> | Employee count reported on the account<br /><br />**Field Name:** `accountNumberOfEmployees`<br />**Type:** metric                          |

### Contact

|                          |                                                                                   |
| ------------------------ | --------------------------------------------------------------------------------- |
| <div>Contact Count</div> | Count of contacts<br /><br />**Field Name:** `contactCount`<br />**Type:** metric |

### Lead

|                                     |                                                                                                              |
| ----------------------------------- | ------------------------------------------------------------------------------------------------------------ |
| <div>Lead Count</div>               | Count of leads<br /><br />**Field Name:** `leadCount`<br />**Type:** metric                                  |
| <div>Lead Annual Revenue</div>      | Annual revenue reported on the lead<br /><br />**Field Name:** `leadAnnualRevenue`<br />**Type:** metric     |
| <div>Lead Number Of Employees</div> | Employee count reported on the lead<br /><br />**Field Name:** `leadNumberOfEmployees`<br />**Type:** metric |

### Opportunity

|                                                   |                                                                                                                                   |
| ------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------- |
| <div>Opportunity Count</div>                      | Count of opportunities<br /><br />**Field Name:** `opportunityCount`<br />**Type:** metric                                        |
| <div>Opportunity Amount</div>                     | Deal size in currency units<br /><br />**Field Name:** `opportunityAmount`<br />**Type:** metric                                  |
| <div>Opportunity Expected Revenue</div>           | Amount × Probability — Salesforce-weighted forecast<br /><br />**Field Name:** `opportunityExpectedRevenue`<br />**Type:** metric |
| <div>Opportunity Probability</div>                | Stage probability of close (0–100)<br /><br />**Field Name:** `opportunityProbability`<br />**Type:** metric                      |
| <div>Opportunity Total Opportunity Quantity</div> | Total quantity across all line items<br /><br />**Field Name:** `opportunityTotalOpportunityQuantity`<br />**Type:** metric       |

### Case

|                       |                                                                             |
| --------------------- | --------------------------------------------------------------------------- |
| <div>Case Count</div> | Count of cases<br /><br />**Field Name:** `caseCount`<br />**Type:** metric |

### Campaign

|                                                           |                                                                                                                                                        |
| --------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------ |
| <div>Campaign Count</div>                                 | Count of campaigns<br /><br />**Field Name:** `campaignCount`<br />**Type:** metric                                                                    |
| <div>Campaign Budgeted Cost</div>                         | Planned budget for the campaign<br /><br />**Field Name:** `campaignBudgetedCost`<br />**Type:** metric                                                |
| <div>Campaign Actual Cost</div>                           | Actual cost incurred for the campaign<br /><br />**Field Name:** `campaignActualCost`<br />**Type:** metric                                            |
| <div>Campaign Expected Revenue</div>                      | Forecasted revenue from the campaign<br /><br />**Field Name:** `campaignExpectedRevenue`<br />**Type:** metric                                        |
| <div>Campaign Expected Response</div>                     | Expected response count<br /><br />**Field Name:** `campaignExpectedResponse`<br />**Type:** metric                                                    |
| <div>Campaign Number Sent</div>                           | Number of items sent (e.g., emails)<br /><br />**Field Name:** `campaignNumberSent`<br />**Type:** metric                                              |
| <div>Campaign Number Of Leads</div>                       | Rolled-up count of leads associated with the campaign<br /><br />**Field Name:** `campaignNumberOfLeads`<br />**Type:** metric                         |
| <div>Campaign Number Of Contacts</div>                    | Rolled-up count of contacts associated with the campaign<br /><br />**Field Name:** `campaignNumberOfContacts`<br />**Type:** metric                   |
| <div>Campaign Number Of Converted Leads</div>             | Rolled-up count of converted leads<br /><br />**Field Name:** `campaignNumberOfConvertedLeads`<br />**Type:** metric                                   |
| <div>Campaign Number Of Responses</div>                   | Rolled-up count of campaign members who responded<br /><br />**Field Name:** `campaignNumberOfResponses`<br />**Type:** metric                         |
| <div>Campaign Number Of Opportunities</div>               | Rolled-up count of opportunities tied to the campaign<br /><br />**Field Name:** `campaignNumberOfOpportunities`<br />**Type:** metric                 |
| <div>Campaign Number Of Won Opportunities</div>           | Rolled-up count of won opportunities tied to the campaign<br /><br />**Field Name:** `campaignNumberOfWonOpportunities`<br />**Type:** metric          |
| <div>Campaign Amount All Opportunities</div>              | Rolled-up amount of all opportunities tied to the campaign<br /><br />**Field Name:** `campaignAmountAllOpportunities`<br />**Type:** metric           |
| <div>Campaign Amount Won Opportunities</div>              | Rolled-up amount of won opportunities tied to the campaign<br /><br />**Field Name:** `campaignAmountWonOpportunities`<br />**Type:** metric           |
| <div>Campaign Hierarchy Number Sent</div>                 | Sum across the campaign hierarchy of items sent<br /><br />**Field Name:** `campaignHierarchyNumberSent`<br />**Type:** metric                         |
| <div>Campaign Hierarchy Number Of Leads</div>             | Sum across the campaign hierarchy of leads<br /><br />**Field Name:** `campaignHierarchyNumberOfLeads`<br />**Type:** metric                           |
| <div>Campaign Hierarchy Number Of Contacts</div>          | Sum across the campaign hierarchy of contacts<br /><br />**Field Name:** `campaignHierarchyNumberOfContacts`<br />**Type:** metric                     |
| <div>Campaign Hierarchy Number Of Converted Leads</div>   | Sum across the campaign hierarchy of converted leads<br /><br />**Field Name:** `campaignHierarchyNumberOfConvertedLeads`<br />**Type:** metric        |
| <div>Campaign Hierarchy Number Of Responses</div>         | Sum across the campaign hierarchy of responses<br /><br />**Field Name:** `campaignHierarchyNumberOfResponses`<br />**Type:** metric                   |
| <div>Campaign Hierarchy Number Of Opportunities</div>     | Sum across the campaign hierarchy of opportunities<br /><br />**Field Name:** `campaignHierarchyNumberOfOpportunities`<br />**Type:** metric           |
| <div>Campaign Hierarchy Number Of Won Opportunities</div> | Sum across the campaign hierarchy of won opportunities<br /><br />**Field Name:** `campaignHierarchyNumberOfWonOpportunities`<br />**Type:** metric    |
| <div>Campaign Hierarchy Amount All Opportunities</div>    | Sum across the campaign hierarchy of all opportunity amount<br /><br />**Field Name:** `campaignHierarchyAmountAllOpportunities`<br />**Type:** metric |
| <div>Campaign Hierarchy Amount Won Opportunities</div>    | Sum across the campaign hierarchy of won opportunity amount<br /><br />**Field Name:** `campaignHierarchyAmountWonOpportunities`<br />**Type:** metric |

### Task

|                                          |                                                                                                                     |
| ---------------------------------------- | ------------------------------------------------------------------------------------------------------------------- |
| <div>Task Count</div>                    | Count of tasks<br /><br />**Field Name:** `taskCount`<br />**Type:** metric                                         |
| <div>Task Call Duration In Seconds</div> | Call duration on the task (in seconds)<br /><br />**Field Name:** `taskCallDurationInSeconds`<br />**Type:** metric |

### Event

|                                      |                                                                                                            |
| ------------------------------------ | ---------------------------------------------------------------------------------------------------------- |
| <div>Event Count</div>               | Count of events<br /><br />**Field Name:** `eventCount`<br />**Type:** metric                              |
| <div>Event Duration In Minutes</div> | Duration of the event in minutes<br /><br />**Field Name:** `eventDurationInMinutes`<br />**Type:** metric |

### User

|                       |                                                                             |
| --------------------- | --------------------------------------------------------------------------- |
| <div>User Count</div> | Count of users<br /><br />**Field Name:** `userCount`<br />**Type:** metric |

### Opportunity Line Item

|                                              |                                                                                                                                       |
| -------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------- |
| <div>Opportunity Line Item Count</div>       | Count of line items<br /><br />**Field Name:** `opportunityLineItemCount`<br />**Type:** metric                                       |
| <div>Opportunity Line Item Quantity</div>    | Quantity ordered on the line item<br /><br />**Field Name:** `opportunityLineItemQuantity`<br />**Type:** metric                      |
| <div>Opportunity Line Item Unit Price</div>  | Per-unit price on the line item<br /><br />**Field Name:** `opportunityLineItemUnitPrice`<br />**Type:** metric                       |
| <div>Opportunity Line Item List Price</div>  | List price from the pricebook for the line item<br /><br />**Field Name:** `opportunityLineItemListPrice`<br />**Type:** metric       |
| <div>Opportunity Line Item Discount</div>    | Discount applied to the line item (percent)<br /><br />**Field Name:** `opportunityLineItemDiscount`<br />**Type:** metric            |
| <div>Opportunity Line Item Total Price</div> | Total price (Quantity × UnitPrice) for the line item<br /><br />**Field Name:** `opportunityLineItemTotalPrice`<br />**Type:** metric |

### Product

|                          |                                                                                                  |
| ------------------------ | ------------------------------------------------------------------------------------------------ |
| <div>Product Count</div> | Count of products in the catalog<br /><br />**Field Name:** `productCount`<br />**Type:** metric |

***

## Related

<CardGroup>
  <Card title="Fields Catalog" icon="book" href="/fields-catalog">
    Browse all platforms
  </Card>

  <Card title="HubSpot Fields" icon="chart-bar" href="/data-source/hubspot/fields">
    HubSpot metrics & dimensions
  </Card>

  <Card title="Klaviyo Fields" icon="chart-bar" href="/data-source/klaviyo/fields">
    Klaviyo metrics & dimensions
  </Card>

  <Card title="Mailchimp Fields" icon="chart-bar" href="/data-source/mailchimp/fields">
    Mailchimp metrics & dimensions
  </Card>
</CardGroup>


# Shopify Metrics & Dimensions
Source: https://support.detrics.io/data-source/shopify/fields

Complete reference for Shopify store dimensions and metrics

<Info>
  **Last updated:** August 6, 2026
</Info>

<div>
  <div>
    281 dimensions
  </div>

  <div>
    145 metrics
  </div>
</div>

This reference covers all available dimensions and metrics for Shopify data through Detrics. Use this guide to understand what data you can extract and how to structure your queries.

<div>
  <span>Supported destinations:</span>

  <div>
    Google Sheets
  </div>

  <div>
    Looker Studio
  </div>

  <div>
    Claude
  </div>

  <div>
    BigQuery
  </div>
</div>

## Dimensions

Dimensions are the attributes you can use to segment and group your Shopify data.

### Store

|                                                 |                                                                                                                                                                                                 |
| ----------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| <div>Store ID</div>                             | A globally-unique ID for the shop.<br /><br />**Field Name:** `storeId`<br />**Type:** dimension                                                                                                |
| <div>Store Domain</div>                         | The domain name of the shop.<br /><br />**Field Name:** `storeDomain`<br />**Type:** dimension                                                                                                  |
| <div>Store Name</div>                           | The name of the shop.<br /><br />**Field Name:** `storeName`<br />**Type:** dimension                                                                                                           |
| <div>Store Address 1</div>                      | The first line of the address. Typically the street address or PO Box number.<br /><br />**Field Name:** `storeAddress1`<br />**Type:** dimension                                               |
| <div>Store Address 2</div>                      | The second line of the address. Typically the number of the apartment, suite, or unit.<br /><br />**Field Name:** `storeAddress2`<br />**Type:** dimension                                      |
| <div>Store Checkout API Supported</div>         | Specifies whether the shop supports checkouts via Checkout API.<br /><br />**Field Name:** `storeCheckoutApiSupported`<br />**Type:** dimension                                                 |
| <div>Store City</div>                           | The name of the city, district, village, or town.<br /><br />**Field Name:** `storeCity`<br />**Type:** dimension                                                                               |
| <div>Store Country</div>                        | The shop's country.<br /><br />**Field Name:** `storeCountry`<br />**Type:** dimension                                                                                                          |
| <div>Store Country Code</div>                   | The two-letter code for the country of the address.<br /><br />**Field Name:** `storeCountryCode`<br />**Type:** dimension                                                                      |
| <div>Store Created At</div>                     | The date and time when the shop was created.<br /><br />**Field Name:** `storeCreatedAt`<br />**Type:** dimension                                                                               |
| <div>Store Contact Email</div>                  | The public-facing contact email address for the shop. Customers will use this email to communicate with the shop owner.<br /><br />**Field Name:** `storeContactEmail`<br />**Type:** dimension |
| <div>Store Currency Code</div>                  | The three-letter code for the shop's default currency.<br /><br />**Field Name:** `storeCurrencyCode`<br />**Type:** dimension                                                                  |
| <div>Store Enabled Presentment Currencies</div> | The presentment currencies enabled for the shop.<br /><br />**Field Name:** `storeEnabledPresentmentCurrencies`<br />**Type:** dimension                                                        |
| <div>Store Email</div>                          | The shop owner's email address. Shopify will use this email address to communicate with the shop owner.<br /><br />**Field Name:** `storeEmail`<br />**Type:** dimension                        |
| <div>Store IANA Timezone</div>                  | The shop's time zone as defined by the IANA<br /><br />**Field Name:** `storeIanaTimezone`<br />**Type:** dimension                                                                             |
| <div>Store Latitude</div>                       | The latitude coordinate of the address.<br /><br />**Field Name:** `storeLatitude`<br />**Type:** dimension                                                                                     |
| <div>Store Longitude</div>                      | The longitude coordinate of the address.<br /><br />**Field Name:** `storeLongitude`<br />**Type:** dimension                                                                                   |
| <div>Store Money Format</div>                   | A string representing the way currency is formatted when the currency isn't specified.<br /><br />**Field Name:** `storeMoneyFormat`<br />**Type:** dimension                                   |
| <div>Store Money With Currency Format</div>     | How currencies are displayed on your store.<br /><br />**Field Name:** `storeMoneyWithCurrencyFormat`<br />**Type:** dimension                                                                  |
| <div>Store Myshopify Domain</div>               | The shop's .myshopify.com domain.<br /><br />**Field Name:** `storeMyshopifyDomain`<br />**Type:** dimension                                                                                    |
| <div>Store Password Enabled</div>               | Whether the password protection page is enabled on the shop's online store.<br /><br />**Field Name:** `storePasswordEnabled`<br />**Type:** dimension                                          |
| <div>Store Phone</div>                          | A phone number associated with the address.<br /><br />**Field Name:** `storePhone`<br />**Type:** dimension                                                                                    |
| <div>Store Shop Locales</div>                   | The shop's primary locale.<br /><br />**Field Name:** `storeShopLocales`<br />**Type:** dimension                                                                                               |
| <div>Store Province</div>                       | The region of the address, such as the province, state, or district.<br /><br />**Field Name:** `storeProvince`<br />**Type:** dimension                                                        |
| <div>Store Province Code</div>                  | The two- or three-letter code for the shop's province or state.<br /><br />**Field Name:** `storeProvinceCode`<br />**Type:** dimension                                                         |
| <div>Store Setup Required</div>                 | Whether the shop has any outstanding setup steps.<br /><br />**Field Name:** `storeSetupRequired`<br />**Type:** dimension                                                                      |
| <div>Store Shop Owner</div>                     | The name of the shop owner.<br /><br />**Field Name:** `storeShopOwner`<br />**Type:** dimension                                                                                                |
| <div>Store Taxes Included</div>                 | Whether applicable taxes are included in product prices.<br /><br />**Field Name:** `storeTaxesIncluded`<br />**Type:** dimension                                                               |
| <div>Store Tax Shipping</div>                   | Whether taxes are charged for shipping.<br /><br />**Field Name:** `storeTaxShipping`<br />**Type:** dimension                                                                                  |
| <div>Store Timezone</div>                       | The name of the timezone the shop is in.<br /><br />**Field Name:** `storeTimezoneAbbreviation`<br />**Type:** dimension                                                                        |
| <div>Store Transactional SMS Disabled</div>     | Whether transactional SMS sent by Shopify are disabled on the shop's online store.<br /><br />**Field Name:** `storeTransactionalSmsDisabled`<br />**Type:** dimension                          |
| <div>Store Updated At</div>                     | The date and time when the shop was last updated.<br /><br />**Field Name:** `storeUpdatedAt`<br />**Type:** dimension                                                                          |
| <div>Store Weight Unit</div>                    | The default unit of weight measurement for the shop.<br /><br />**Field Name:** `storeWeightUnit`<br />**Type:** dimension                                                                      |
| <div>Store Zip</div>                            | The shop's zip or postal code.<br /><br />**Field Name:** `storeZip`<br />**Type:** dimension                                                                                                   |

### Order

|                                               |                                                                                                                                                                                                                                                                                |
| --------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| <div>Order ID</div>                           | A globally-unique ID<br /><br />**Field Name:** `orderId`<br />**Type:** dimension                                                                                                                                                                                             |
| <div>Order Name</div>                         | The unique identifier for the order that appears on the order page in the Shopify admin and the Order status page. For example, '#1001', 'EN1001', or '1001-A'. This value isn't unique across multiple stores<br /><br />**Field Name:** `orderName`<br />**Type:** dimension |
| <div>Order Note</div>                         | The contents of the note associated with the order<br /><br />**Field Name:** `orderNote`<br />**Type:** dimension                                                                                                                                                             |
| <div>Order Tags</div>                         | A comma separated list of tags associated with the order. Updating tags overwrites any existing tags that were previously added to the order<br /><br />**Field Name:** `orderTags`<br />**Type:** dimension                                                                   |
| <div>Order Created At</div>                   | Date and time when the order was created in Shopify. This field is used to filter Orders based on the timeframe selected in your request.<br /><br />**Field Name:** `orderCreatedAt`<br />**Type:** dimension                                                                 |
| <div>Order Closed At</div>                    | The date and time when the order was closed. Returns null if the order isn't closed.<br /><br />**Field Name:** `orderClosedAt`<br />**Type:** dimension                                                                                                                       |
| <div>Order Cancelled At</div>                 | The date and time when the order was canceled. Returns null if the order wasn't canceled.<br /><br />**Field Name:** `orderCancelledAt`<br />**Type:** dimension                                                                                                               |
| <div>Order Currency Code</div>                | The shop currency when the order was placed<br /><br />**Field Name:** `orderCurrencyCode`<br />**Type:** dimension                                                                                                                                                            |
| <div>Order Email</div>                        | The email address associated with the customer<br /><br />**Field Name:** `orderEmail`<br />**Type:** dimension                                                                                                                                                                |
| <div>Order Fully Paid</div>                   | Whether the order has been paid in full<br /><br />**Field Name:** `orderFullyPaid`<br />**Type:** dimension                                                                                                                                                                   |
| <div>Order Discount Codes</div>               | The discount codes used for the order.<br /><br />**Field Name:** `orderDiscountCodes`<br />**Type:** dimension                                                                                                                                                                |
| <div>Order Fulfillment Status</div>           | <br /><br />**Field Name:** `orderFulfillmentStatus`<br />**Type:** dimension                                                                                                                                                                                                  |
| <div>Order Payment Status</div>               | The display financial status of the order.<br /><br />**Field Name:** `orderDisplayFinancialStatus`<br />**Type:** dimension                                                                                                                                                   |
| <div>Order Fulfillment Date</div>             | <br /><br />**Field Name:** `orderFulfillmentDate`<br />**Type:** dimension                                                                                                                                                                                                    |
| <div>Order Phone</div>                        | The phone number associated with the customer<br /><br />**Field Name:** `orderPhone`<br />**Type:** dimension                                                                                                                                                                 |
| <div>Order Closed</div>                       | Whether the order is closed<br /><br />**Field Name:** `orderClosed`<br />**Type:** dimension                                                                                                                                                                                  |
| <div>Order Cancel Reason</div>                | The reason provided when the order was canceled. Returns null if the order wasn't canceled<br /><br />**Field Name:** `orderCancelReason`<br />**Type:** dimension                                                                                                             |
| <div>Order PO Number</div>                    | The purchase order number associated with the order. Used for B2B orders.<br /><br />**Field Name:** `orderPoNumber`<br />**Type:** dimension                                                                                                                                  |
| <div>Order Source Identifier</div>            | A unique identifier for the order that comes from an external source (e.g., from a third-party checkout).<br /><br />**Field Name:** `orderSourceIdentifier`<br />**Type:** dimension                                                                                          |
| <div>Order Confirmation Number</div>          | The confirmation number displayed to the customer after completing checkout. Starts with a letter.<br /><br />**Field Name:** `orderConfirmationNumber`<br />**Type:** dimension                                                                                               |
| <div>Order Processed At</div>                 | The date and time when the order was processed. This can differ from created\_at for draft orders or pre-orders.<br /><br />**Field Name:** `orderProcessedAt`<br />**Type:** dimension                                                                                        |
| <div>Order Source Name</div>                  | The source of the order, such as "web", "shopify\_draft\_order", "pos", or a third-party app name.<br /><br />**Field Name:** `orderSourceName`<br />**Type:** dimension                                                                                                       |
| <div>Order Is Test</div>                      | Whether the order is a test order. Test orders are created using the Shopify Bogus Gateway.<br /><br />**Field Name:** `orderTest`<br />**Type:** dimension                                                                                                                    |
| <div>Order Risk Level</div>                   | The fraud risk level of the order: HIGH, MEDIUM, LOW, NONE, or PENDING.<br /><br />**Field Name:** `orderRiskLevel`<br />**Type:** dimension                                                                                                                                   |
| <div>Order Fraud Protection Level</div>       | The fraud protection level for the order: FULLY\_PROTECTED, PARTIALLY\_PROTECTED, NOT\_PROTECTED, or PENDING.<br /><br />**Field Name:** `orderFraudProtectionLevel`<br />**Type:** dimension                                                                                  |
| <div>Order Payment Gateway</div>              | The name of the payment gateway used to process the order (e.g., "shopify\_payments", "paypal").<br /><br />**Field Name:** `orderPaymentGateway`<br />**Type:** dimension                                                                                                     |
| <div>Order Location ID</div>                  | The ID of the retail location where the order was placed (for POS orders). Returns empty for online orders.<br /><br />**Field Name:** `orderLocationId`<br />**Type:** dimension                                                                                              |
| <div>Order Location Name</div>                | The name of the retail location where the order was placed (for POS orders). Returns empty for online orders.<br /><br />**Field Name:** `orderLocationName`<br />**Type:** dimension                                                                                          |
| <div>Order Client IP</div>                    | The IP address of the API client that created the order<br /><br />**Field Name:** `orderClientIp`<br />**Type:** dimension                                                                                                                                                    |
| <div>Order Presentment Money Currency</div>   | The presentment money currency for the order<br /><br />**Field Name:** `orderTotalPriceSetPresentmentMoneyCurrency`<br />**Type:** dimension                                                                                                                                  |
| <div>Order Updated At</div>                   | The date and time when the order was modified last.<br /><br />**Field Name:** `orderUpdatedAt`<br />**Type:** dimension                                                                                                                                                       |
| <div>Order Discount Code</div>                | The discount code used for the order.<br /><br />**Field Name:** `orderDiscountCode`<br />**Type:** dimension                                                                                                                                                                  |
| <div>Order Sales Channel</div>                | Name of the channel that this sub-channel belongs to. Identifies the parent sales channel.<br /><br />**Field Name:** `orderSalesChannelName`<br />**Type:** dimension                                                                                                         |
| <div>Order Sales Sub Channel</div>            | Name of the sub-channel (e.g., "Online Store", "Instagram Shopping", "TikTok Live"). More specific than the parent channel.<br /><br />**Field Name:** `orderSubChannelName`<br />**Type:** dimension                                                                          |
| <div>Order Sales Channel Handle</div>         | Unique string identifier used as a public identifier for the channel definition.<br /><br />**Field Name:** `orderChannelHandle`<br />**Type:** dimension                                                                                                                      |
| <div>Order Sales Channel Is Marketplace</div> | Whether this channel definition represents a marketplace (true/false). Marketplaces are third-party platforms like Amazon, eBay, etc.<br /><br />**Field Name:** `orderChannelIsMarketplace`<br />**Type:** dimension                                                          |
| <div>Order Shipping Address 1</div>           | The shipping address line 1 of the customer<br /><br />**Field Name:** `orderShippingAddress1`<br />**Type:** dimension                                                                                                                                                        |
| <div>Order Shipping Address 2</div>           | The shipping address line 2 of the customer<br /><br />**Field Name:** `orderShippingAddress2`<br />**Type:** dimension                                                                                                                                                        |
| <div>Order Shipping Country</div>             | The shipping address country of the customer<br /><br />**Field Name:** `orderShippingCountry`<br />**Type:** dimension                                                                                                                                                        |
| <div>Order Shipping City</div>                | The shipping address city of the customer<br /><br />**Field Name:** `orderShippingCity`<br />**Type:** dimension                                                                                                                                                              |
| <div>Order Shipping Post Code</div>           | The shipping address postal code of the customer<br /><br />**Field Name:** `orderShippingPostCode`<br />**Type:** dimension                                                                                                                                                   |
| <div>Order Shipping Phone</div>               | The shipping address phone number of the customer<br /><br />**Field Name:** `orderShippingPhone`<br />**Type:** dimension                                                                                                                                                     |
| <div>Order Shipping Company</div>             | The shipping address company name of the customer<br /><br />**Field Name:** `orderShippingCompany`<br />**Type:** dimension                                                                                                                                                   |
| <div>Order Shipping Method</div>              | The title of the shipping method selected for the order (e.g., "Standard Shipping", "Express Delivery").<br /><br />**Field Name:** `orderShippingLineTitle`<br />**Type:** dimension                                                                                          |
| <div>Order Shipping Method Code</div>         | A unique identifier code for the shipping rate selected for the order.<br /><br />**Field Name:** `orderShippingLineCode`<br />**Type:** dimension                                                                                                                             |
| <div>Order Billing Address 1</div>            | The billing address line 1 of the customer<br /><br />**Field Name:** `orderBillingAddress1`<br />**Type:** dimension                                                                                                                                                          |
| <div>Order Billing Address 2</div>            | The billing address line 2 of the customer<br /><br />**Field Name:** `orderBillingAddress2`<br />**Type:** dimension                                                                                                                                                          |
| <div>Order Billing Country</div>              | The billing address country<br /><br />**Field Name:** `orderBillingCountry`<br />**Type:** dimension                                                                                                                                                                          |
| <div>Order Billing City</div>                 | The billing address city<br /><br />**Field Name:** `orderBillingCity`<br />**Type:** dimension                                                                                                                                                                                |
| <div>Order Billing Phone</div>                | The billing address phone number<br /><br />**Field Name:** `orderBillingPhone`<br />**Type:** dimension                                                                                                                                                                       |

### Order Customer

|                                                |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
| ---------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| <div>Order Customer ID</div>                   | A globally-unique ID for the customer.<br /><br />**Field Name:** `orderCustomerId`<br />**Type:** dimension                                                                                                                                                                                                                                                                                                                                                                                          |
| <div>Order Customer Name</div>                 | The full name of the customer<br /><br />**Field Name:** `orderCustomerName`<br />**Type:** dimension                                                                                                                                                                                                                                                                                                                                                                                                 |
| <div>Order Customer Email</div>                | The customer's email address.<br /><br />**Field Name:** `orderCustomerEmail`<br />**Type:** dimension                                                                                                                                                                                                                                                                                                                                                                                                |
| <div>Order Customer Phone</div>                | The customer's phone number.<br /><br />**Field Name:** `orderCustomerPhone`<br />**Type:** dimension                                                                                                                                                                                                                                                                                                                                                                                                 |
| <div>Order Customer Image Url</div>            | The image url associated with the customer<br /><br />**Field Name:** `orderCustomerImage`<br />**Type:** dimension                                                                                                                                                                                                                                                                                                                                                                                   |
| <div>Order Customer Locale</div>               | The customer's locale<br /><br />**Field Name:** `orderCustomerLocale`<br />**Type:** dimension                                                                                                                                                                                                                                                                                                                                                                                                       |
| <div>Order Customer Note</div>                 | A note about the customer.<br /><br />**Field Name:** `orderCustomerNote`<br />**Type:** dimension                                                                                                                                                                                                                                                                                                                                                                                                    |
| <div>Order Customer Predicted Spend Tier</div> | The predicted spend tier of a customer with a shop.HIGH:The customer's spending is predicted to be in the top spending range for the shop in the following year. LOW: The customer's spending is predicted to be zero, or in the lowest spending range for the shop in the following year. MEDIUM : The customer's spending is predicted to be in the normal spending range for the shop in the following year.<br /><br />**Field Name:** `orderCustomerPredictedSpendTier`<br />**Type:** dimension |
| <div>Order Customer Tags</div>                 | A comma separated list of tags that have been added to the customer.<br /><br />**Field Name:** `orderCustomerTags`<br />**Type:** dimension                                                                                                                                                                                                                                                                                                                                                          |
| <div>Order Customer Unsubscribe URL</div>      | The URL to unsubscribe the customer from the mailing list.<br /><br />**Field Name:** `orderCustomerUnsubscribeUrl`<br />**Type:** dimension                                                                                                                                                                                                                                                                                                                                                          |
| <div>Order Customer Tax Exempt</div>           | Whether the customer is exempt from being charged taxes on their orders.<br /><br />**Field Name:** `orderCustomerTaxExempt`<br />**Type:** dimension                                                                                                                                                                                                                                                                                                                                                 |
| <div>Order Customer Created At</div>           | Date and time when the customer was created in Shopify.<br /><br />**Field Name:** `orderCustomerCreatedAt`<br />**Type:** dimension                                                                                                                                                                                                                                                                                                                                                                  |
| <div>Order Customer Country</div>              | Country of the customer<br /><br />**Field Name:** `orderCustomerCountry`<br />**Type:** dimension                                                                                                                                                                                                                                                                                                                                                                                                    |
| <div>Order Customer City</div>                 | City of the customer<br /><br />**Field Name:** `orderCustomerCity`<br />**Type:** dimension                                                                                                                                                                                                                                                                                                                                                                                                          |
| <div>Order Customer Country Code</div>         | Country Code of the customer<br /><br />**Field Name:** `orderCustomerCountryCode`<br />**Type:** dimension                                                                                                                                                                                                                                                                                                                                                                                           |
| <div>Order Customer Is Returning</div>         | True if the customer has placed more than one order.<br /><br />**Field Name:** `orderCustomerIsReturning`<br />**Type:** dimension                                                                                                                                                                                                                                                                                                                                                                   |

### Traffic Source First Visit

|                                                     |                                                                                                                                                                     |
| --------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| <div>Customer Journey First Visit Source</div>      | Identifies a search engine, a newsletter name, or other source<br /><br />**Field Name:** `customerJourneyFirstVisitSource`<br />**Type:** dimension                |
| <div>Customer Journey First Visit Page URL</div>    | URL of the first page the customer landed on for their first session<br /><br />**Field Name:** `customerJourneyFirstVisitLandingPageUrl`<br />**Type:** dimension  |
| <div>Customer Journey First Visit Occurred At</div> | The date and time when the customer's first session occurred in the shop.<br /><br />**Field Name:** `customerJourneyFirstVisitOccurredAt`<br />**Type:** dimension |
| <div>First Visit UTM Source</div>                   | The UTM source parameter from the first visit<br /><br />**Field Name:** `firstVisitUTMSource`<br />**Type:** dimension                                             |
| <div>First Visit UTM Medium</div>                   | The UTM medium parameter from the first visit<br /><br />**Field Name:** `firstVisitUTMMedium`<br />**Type:** dimension                                             |
| <div>First Visit UTM Campaign</div>                 | The UTM campaign parameter from the first visit<br /><br />**Field Name:** `firstVisitUTMCampaign`<br />**Type:** dimension                                         |
| <div>First Visit UTM Term</div>                     | The UTM term parameter from the first visit<br /><br />**Field Name:** `firstVisitUTMTerm`<br />**Type:** dimension                                                 |
| <div>First Visit UTM Content</div>                  | The UTM content parameter from the first visit<br /><br />**Field Name:** `firstVisitUTMContent`<br />**Type:** dimension                                           |

### Traffic Source Last Visit

|                                                    |                                                                                                                                                                                          |
| -------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| <div>Customer Journey Last Visit Occurred At</div> | The date and time when the customer's last session occurred before making the order.<br /><br />**Field Name:** `customerJourneyLastVisitOccurredAt`<br />**Type:** dimension            |
| <div>Customer Journey Last Visit Source</div>      | Source from which the customer last visited the store before making the order<br /><br />**Field Name:** `customerJourneyLastVisitSource`<br />**Type:** dimension                       |
| <div>Customer Journey Last Visit Page URL</div>    | URL of the first page the customer landed on for their last session before making the order<br /><br />**Field Name:** `customerJourneyLastVisitLandingPageUrl`<br />**Type:** dimension |
| <div>Last Visit UTM Source</div>                   | The UTM source parameter from the last visit<br /><br />**Field Name:** `lastVisitUTMSource`<br />**Type:** dimension                                                                    |
| <div>Last Visit UTM Medium</div>                   | The UTM medium parameter from the last visit<br /><br />**Field Name:** `lastVisitUTMMedium`<br />**Type:** dimension                                                                    |
| <div>Last Visit UTM Campaign</div>                 | The UTM campain parameter from the last visit<br /><br />**Field Name:** `lastVisitUTMCampaign`<br />**Type:** dimension                                                                 |
| <div>Last Visit UTM Term</div>                     | The UTM term parameter from the last visit<br /><br />**Field Name:** `lastVisitUTMTerm`<br />**Type:** dimension                                                                        |
| <div>Last Visit UTM Content</div>                  | The UTM content parameter from the last visit<br /><br />**Field Name:** `lastVisitUTMContent`<br />**Type:** dimension                                                                  |

### Line Item

|                                                |                                                                                                                                                                            |
| ---------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| <div>Line Item ID</div>                        | A globally-unique ID of the Line Item.<br /><br />**Field Name:** `lineItemId`<br />**Type:** dimension                                                                    |
| <div>Line Item Product ID</div>                | A globally-unique ID of the Product.<br /><br />**Field Name:** `lineItemProductId`<br />**Type:** dimension                                                               |
| <div>Line Item Type</div>                      | The product type that merchants define<br /><br />**Field Name:** `lineItemProductType`<br />**Type:** dimension                                                           |
| <div>Line Item SKU</div>                       | The variant SKU number.<br /><br />**Field Name:** `lineItemSku`<br />**Type:** dimension                                                                                  |
| <div>Line Item Is Gift Card</div>              | Whether the product is a gift card<br /><br />**Field Name:** `lineItemProductIsGiftCard`<br />**Type:** dimension                                                         |
| <div>Line Item Title</div>                     | The title of the product at time of order creation<br /><br />**Field Name:** `lineItemTitle`<br />**Type:** dimension                                                     |
| <div>Line Item Image</div>                     | Image of the Line Item at the time of order creation.<br /><br />**Field Name:** `lineItemImage`<br />**Type:** dimension                                                  |
| <div>Line Item Vendor</div>                    | The name of the vendor who made the variant<br /><br />**Field Name:** `lineItemVendor`<br />**Type:** dimension                                                           |
| <div>Line Item Description</div>               | The description of the product, with HTML tags removed<br /><br />**Field Name:** `lineItemProductDescription`<br />**Type:** dimension                                    |
| <div>Line Item Restockable</div>               | Whether the Line Item can be restocked<br /><br />**Field Name:** `lineItemRestockable`<br />**Type:** dimension                                                           |
| <div>Line Item Product Title</div>             | The name for the product that displays to customers<br /><br />**Field Name:** `lineItemProductTitle`<br />**Type:** dimension                                             |
| <div>Line Item Requires Shipping</div>         | Whether physical shipping is required for the variant<br /><br />**Field Name:** `lineItemRequiresShipping`<br />**Type:** dimension                                       |
| <div>Line Item Taxable</div>                   | Whether the variant is taxable<br /><br />**Field Name:** `lineItemTaxable`<br />**Type:** dimension                                                                       |
| <div>Line Item Collections</div>               | Names of the collections associated with the product<br /><br />**Field Name:** `lineItemProductCollectionsTitle`<br />**Type:** dimension                                 |
| <div>Line Item Tags</div>                      | A comma-separated list of searchable keywords that are associated with the product.<br /><br />**Field Name:** `lineItemProductTags`<br />**Type:** dimension              |
| <div>Line Item Handle</div>                    | A unique, human-readable string of the product's title<br /><br />**Field Name:** `lineItemProductHandle`<br />**Type:** dimension                                         |
| <div>Line Item Online Store URL</div>          | The product's URL on the online store<br /><br />**Field Name:** `lineItemProductOnlineStoreUrl`<br />**Type:** dimension                                                  |
| <div>Line Item Online Store Preview URL</div>  | The preview URL for the online store<br /><br />**Field Name:** `lineItemProductOnlineStorePreviewUrl`<br />**Type:** dimension                                            |
| <div>Line Item Status</div>                    | The product status, which controls visibility across all sales channels<br /><br />**Field Name:** `lineItemProductStatus`<br />**Type:** dimension                        |
| <div>Line Item Has Only Default Variant</div>  | Whether the product has only a single variant with the default option and value<br /><br />**Field Name:** `lineItemProductHasOnlyDefaultVariant`<br />**Type:** dimension |
| <div>Line Item Has Out Of Stock Variants</div> | Whether the product has variants that are out of stock<br /><br />**Field Name:** `lineItemProductHasOutOfStockVariants`<br />**Type:** dimension                          |
| <div>Line Item Requires Selling Plan</div>     | Whether the product can only be purchased with a selling plan<br /><br />**Field Name:** `lineItemProductRequiresSellingPlan`<br />**Type:** dimension                     |
| <div>Line Item Presentment Currency</div>      | The presentment currency code of the Line Item.<br /><br />**Field Name:** `lineItemOriginalUnitPriceSetPresentmentMoneyCurrency`<br />**Type:** dimension                 |
| <div>Line Item Created At</div>                | The date and time when the product was created.<br /><br />**Field Name:** `lineItemProductCreatedAt`<br />**Type:** dimension                                             |

### Line Item Variant

|                                                       |                                                                                                                                                                                     |
| ----------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| <div>Line Item Variant ID</div>                       | A globally-unique ID of the variant<br /><br />**Field Name:** `lineItemVariantId`<br />**Type:** dimension                                                                         |
| <div>Line Item Variant SKU</div>                      | A case-sensitive identifier for the product variant in the shop<br /><br />**Field Name:** `lineItemVariantSku`<br />**Type:** dimension                                            |
| <div>Line Item Variant Name</div>                     | Display name of the variant, based on product's title + variant's title<br /><br />**Field Name:** `lineItemVariantDisplayName`<br />**Type:** dimension                            |
| <div>Line Item Variant Title</div>                    | The title of the variant at time of order creation<br /><br />**Field Name:** `lineItemVariantTitle`<br />**Type:** dimension                                                       |
| <div>Line Item Variant Image</div>                    | The featured image for the variant<br /><br />**Field Name:** `lineItemVariantImage`<br />**Type:** dimension                                                                       |
| <div>Line Item Variant Barcode</div>                  | The value of the barcode associated with the product variant<br /><br />**Field Name:** `lineItemVariantBarcode`<br />**Type:** dimension                                           |
| <div>Line Item Variant Available For Sale</div>       | Whether the product variant is available for sale<br /><br />**Field Name:** `lineItemVariantAvailableForSale`<br />**Type:** dimension                                             |
| <div>Line Item Variant Policy</div>                   | Whether customers are allowed to place an order for the product variant when it's out of stock<br /><br />**Field Name:** `lineItemVariantInventoryPolicy`<br />**Type:** dimension |
| <div>Line Item Variant Legacy Resource ID</div>       | The ID of the corresponding resource in the REST Admin API<br /><br />**Field Name:** `lineItemVariantLegacyResourceId`<br />**Type:** dimension                                    |
| <div>Line Item Variant Position</div>                 | The order of the product variant in the list of product variants<br /><br />**Field Name:** `lineItemVariantPosition`<br />**Type:** dimension                                      |
| <div>Line Item Variant Requires Components</div>      | Whether a product variant requires components<br /><br />**Field Name:** `lineItemVariantRequiresComponents`<br />**Type:** dimension                                               |
| <div>Line Item Variant Sellable Online Quantity</div> | The total sellable quantity of the variant for online channels<br /><br />**Field Name:** `lineItemVariantSellableOnlineQuantity`<br />**Type:** dimension                          |
| <div>Line Item Variant Taxable</div>                  | Whether a tax is charged when the product variant is sold<br /><br />**Field Name:** `lineItemVariantTaxable`<br />**Type:** dimension                                              |
| <div>Line Item Variant Tax Code</div>                 | The tax code for the product variant<br /><br />**Field Name:** `lineItemVariantTaxCode`<br />**Type:** dimension                                                                   |
| <div>Line Item Variant Updated At</div>               | The date and time when the product variant was last modified<br /><br />**Field Name:** `lineItemVariantUpdatedAt`<br />**Type:** dimension                                         |
| <div>Line Item Variant Created At</div>               | The date and time when the variant was created<br /><br />**Field Name:** `lineItemVariantCreatedAt`<br />**Type:** dimension                                                       |

### Product

|                                     |                                                                                                                                                                                                |
| ----------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| <div>Product ID</div>               | A globally-unique ID.<br /><br />**Field Name:** `productId`<br />**Type:** dimension                                                                                                          |
| <div>Product Variant SKU</div>      | The SKU (Stock Keeping Unit) of the product variant<br /><br />**Field Name:** `productVariantSku`<br />**Type:** dimension                                                                    |
| <div>Product Variant ID</div>       | The unique identifier of the product variant<br /><br />**Field Name:** `productVariantId`<br />**Type:** dimension                                                                            |
| <div>Product Title</div>            | The name for the product that displays to customers<br /><br />**Field Name:** `productTitle`<br />**Type:** dimension                                                                         |
| <div>Product Variant Title</div>    | The title of the product variant<br /><br />**Field Name:** `productVariantTitle`<br />**Type:** dimension                                                                                     |
| <div>Product Tags</div>             | A comma-separated list of searchable keywords that are associated with the product.<br /><br />**Field Name:** `productTags`<br />**Type:** dimension                                          |
| <div>Product Description</div>      | A single-line description of the product, with HTML tags removed<br /><br />**Field Name:** `productDescription`<br />**Type:** dimension                                                      |
| <div>Product Vendor</div>           | The name of the product's vendor<br /><br />**Field Name:** `productVendor`<br />**Type:** dimension                                                                                           |
| <div>Product Type</div>             | The product type that merchants define<br /><br />**Field Name:** `productType`<br />**Type:** dimension                                                                                       |
| <div>Product Created At</div>       | The date and time when the product was created.<br /><br />**Field Name:** `productCreatedAt`<br />**Type:** dimension                                                                         |
| <div>Product Category Name</div>    | The category of a product from Shopify's Standard Product Taxonomy<br /><br />**Field Name:** `productCategoryFullName`<br />**Type:** dimension                                               |
| <div>Product Is Gift Card</div>     | Whether the product is a gift card<br /><br />**Field Name:** `productIsGiftCard`<br />**Type:** dimension                                                                                     |
| <div>Product Online Store URL</div> | The product's URL on the online store. If null, then the product isn't published to the online store sales channel<br /><br />**Field Name:** `productOnlineStoreUrl`<br />**Type:** dimension |
| <div>Product Published At</div>     | The date and time when the product was published to the online store.<br /><br />**Field Name:** `productPublishedAt`<br />**Type:** dimension                                                 |
| <div>Product SEO Description</div>  | The SEO description that is associated with the product<br /><br />**Field Name:** `productSeoDescription`<br />**Type:** dimension                                                            |
| <div>Product SEO Title</div>        | The SEO title that is associated with the product<br /><br />**Field Name:** `productSeoTitle`<br />**Type:** dimension                                                                        |
| <div>Product Status</div>           | The product status, which controls visibility across all sales channels<br /><br />**Field Name:** `productStatus`<br />**Type:** dimension                                                    |
| <div>Product Updated At</div>       | The date and time when the product was last modified.<br /><br />**Field Name:** `productUpdatedAt`<br />**Type:** dimension                                                                   |
| <div>Product Collections</div>      | Names of the collections associated with the product<br /><br />**Field Name:** `productCollectionsTitle`<br />**Type:** dimension                                                             |

### Line Item Refund

|                                            |                                                                                                                                  |
| ------------------------------------------ | -------------------------------------------------------------------------------------------------------------------------------- |
| <div>Line Item Refund Restocked</div>      | Whether the refunded Line Item was restocked<br /><br />**Field Name:** `lineItemRefundRestocked`<br />**Type:** dimension       |
| <div>Line Item Refund Location</div>       | The restock location<br /><br />**Field Name:** `lineItemRefundLocation`<br />**Type:** dimension                                |
| <div>Line Item Refund Restocked Type</div> | The type of restock for the refunded Line Item<br /><br />**Field Name:** `lineItemRefundRestockedType`<br />**Type:** dimension |

### Refund

|                                           |                                                                                                                       |
| ----------------------------------------- | --------------------------------------------------------------------------------------------------------------------- |
| <div>Refund ID</div>                      | A globally-unique ID<br /><br />**Field Name:** `refundId`<br />**Type:** dimension                                   |
| <div>Refund Created At</div>              | The date and time when the refund was created.<br /><br />**Field Name:** `refundCreatedAt`<br />**Type:** dimension  |
| <div>Refund Note</div>                    | The optional note associated with the refund<br /><br />**Field Name:** `refundNote`<br />**Type:** dimension         |
| <div>Refund Order Adjustment Reason</div> | The reason for the order adjustment<br /><br />**Field Name:** `refundOrderAdjustmentReason`<br />**Type:** dimension |

### Attribution

|                                          |                                                                                                                                |
| ---------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------ |
| <div>UTM Campaign</div>                  | UTM Campaign parameter from the order<br /><br />**Field Name:** `salesUtmCampaign`<br />**Type:** dimension                   |
| <div>UTM Source</div>                    | UTM Source parameter from the order<br /><br />**Field Name:** `salesUtmSource`<br />**Type:** dimension                       |
| <div>UTM Medium</div>                    | UTM Medium parameter from the order<br /><br />**Field Name:** `salesUtmMedium`<br />**Type:** dimension                       |
| <div>UTM Content</div>                   | UTM Content parameter from the order<br /><br />**Field Name:** `salesUtmContent`<br />**Type:** dimension                     |
| <div>UTM Term</div>                      | UTM Term parameter from the order<br /><br />**Field Name:** `salesUtmTerm`<br />**Type:** dimension                           |
| <div>Order Referrer Domain</div>         | The referring domain for the order<br /><br />**Field Name:** `orderReferrerDomain`<br />**Type:** dimension                   |
| <div>Order Referrer Source</div>         | The referrer source type for the order<br /><br />**Field Name:** `orderReferrerSource`<br />**Type:** dimension               |
| <div>Order Referrer Name</div>           | The referrer name for the order<br /><br />**Field Name:** `orderReferrerName`<br />**Type:** dimension                        |
| <div>Order Landing Page Path</div>       | The landing page path for the order<br /><br />**Field Name:** `orderLandingPagePath`<br />**Type:** dimension                 |
| <div>First Order Referring Channel</div> | The referring channel of the first order<br /><br />**Field Name:** `firstOrderReferringChannel`<br />**Type:** dimension      |
| <div>First Order Sales Channel</div>     | The sales channel of the first order<br /><br />**Field Name:** `firstOrderSalesChannel`<br />**Type:** dimension              |
| <div>First Order Traffic Type</div>      | The traffic type of the first order<br /><br />**Field Name:** `firstOrderTrafficType`<br />**Type:** dimension                |
| <div>Marketing Event Type</div>          | The type of marketing event that drove the order<br /><br />**Field Name:** `orderMarketingEventType`<br />**Type:** dimension |

### Channel

|                                     |                                                                                                                                    |
| ----------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------- |
| <div>Sales Channel</div>            | The sales channel where the sale occurred<br /><br />**Field Name:** `salesChannel`<br />**Type:** dimension                       |
| <div>Order Sales Channel</div>      | The order-level sales channel<br /><br />**Field Name:** `orderSalesChannel`<br />**Type:** dimension                              |
| <div>Discount Code</div>            | The discount code applied to the order<br /><br />**Field Name:** `discountCode`<br />**Type:** dimension                          |
| <div>Discount Name</div>            | The name of the discount applied<br /><br />**Field Name:** `discountName`<br />**Type:** dimension                                |
| <div>Discount Type</div>            | The type of discount (percentage, fixed, etc.)<br /><br />**Field Name:** `discountType`<br />**Type:** dimension                  |
| <div>Discount Class</div>           | The class of discount applied<br /><br />**Field Name:** `discountClass`<br />**Type:** dimension                                  |
| <div>Market</div>                   | The market where the sale occurred<br /><br />**Field Name:** `market`<br />**Type:** dimension                                    |
| <div>Subscription or One-Time</div> | Whether the order is subscription or one-time purchase<br /><br />**Field Name:** `subscriptionOrOneTime`<br />**Type:** dimension |

### Product (Analytics)

|                                      |                                                                                                                              |
| ------------------------------------ | ---------------------------------------------------------------------------------------------------------------------------- |
| <div>Product Title</div>             | The title of the product sold<br /><br />**Field Name:** `salesProductTitle`<br />**Type:** dimension                        |
| <div>Product Type</div>              | The type/category of the product sold<br /><br />**Field Name:** `salesProductType`<br />**Type:** dimension                 |
| <div>Product Vendor</div>            | The vendor of the product sold<br /><br />**Field Name:** `salesProductVendor`<br />**Type:** dimension                      |
| <div>Product Variant Title</div>     | The variant title of the product sold<br /><br />**Field Name:** `salesProductVariantTitle`<br />**Type:** dimension         |
| <div>Product Variant SKU</div>       | The SKU of the product variant sold<br /><br />**Field Name:** `salesProductVariantSku`<br />**Type:** dimension             |
| <div>Product Collection</div>        | The collection the product belongs to<br /><br />**Field Name:** `salesProductCollection`<br />**Type:** dimension           |
| <div>Product Tag</div>               | Tags associated with the product<br /><br />**Field Name:** `salesProductTag`<br />**Type:** dimension                       |
| <div>Product ID</div>                | The unique identifier of the product<br /><br />**Field Name:** `salesProductId`<br />**Type:** dimension                    |
| <div>Product Variant ID</div>        | The unique identifier of the product variant<br /><br />**Field Name:** `salesProductVariantId`<br />**Type:** dimension     |
| <div>Product Variant ABC Grade</div> | ABC inventory grade of the product variant<br /><br />**Field Name:** `salesProductVariantAbcGrade`<br />**Type:** dimension |
| <div>Bundle Title</div>              | The title of the bundle<br /><br />**Field Name:** `salesBundleTitle`<br />**Type:** dimension                               |

### Billing Geography

|                                |                                                                                                                   |
| ------------------------------ | ----------------------------------------------------------------------------------------------------------------- |
| <div>Billing Country</div>     | The billing country of the customer<br /><br />**Field Name:** `salesBillingCountry`<br />**Type:** dimension     |
| <div>Billing Region</div>      | The billing region/state of the customer<br /><br />**Field Name:** `salesBillingRegion`<br />**Type:** dimension |
| <div>Billing City</div>        | The billing city of the customer<br /><br />**Field Name:** `billingCity`<br />**Type:** dimension                |
| <div>Billing Postal Code</div> | The billing postal code of the customer<br /><br />**Field Name:** `billingPostalCode`<br />**Type:** dimension   |

### Shipping Geography

|                             |                                                                                                            |
| --------------------------- | ---------------------------------------------------------------------------------------------------------- |
| <div>Shipping Country</div> | The shipping destination country<br /><br />**Field Name:** `shippingCountry`<br />**Type:** dimension     |
| <div>Shipping Region</div>  | The shipping destination region/state<br /><br />**Field Name:** `shippingRegion`<br />**Type:** dimension |
| <div>Shipping City</div>    | The shipping destination city<br /><br />**Field Name:** `shippingCity`<br />**Type:** dimension           |
| <div>Shipping Carrier</div> | The shipping carrier used<br /><br />**Field Name:** `shippingCarrier`<br />**Type:** dimension            |

### Customer (Analytics)

|                                               |                                                                                                                                            |
| --------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------ |
| <div>Customer Country</div>                   | The country of the customer<br /><br />**Field Name:** `customerCountry`<br />**Type:** dimension                                          |
| <div>Customer Region</div>                    | The region/state of the customer<br /><br />**Field Name:** `customerRegion`<br />**Type:** dimension                                      |
| <div>Customer City</div>                      | The city of the customer<br /><br />**Field Name:** `customerCity`<br />**Type:** dimension                                                |
| <div>Customer Email Domain</div>              | The email domain of the customer (useful for B2B identification)<br /><br />**Field Name:** `customerEmailDomain`<br />**Type:** dimension |
| <div>Customer Cohort Month</div>              | The month when the customer made their first purchase<br /><br />**Field Name:** `customerCohortMonth`<br />**Type:** dimension            |
| <div>Customer Cohort Week</div>               | The week when the customer made their first purchase<br /><br />**Field Name:** `customerCohortWeek`<br />**Type:** dimension              |
| <div>Customer Cohort Quarter</div>            | The quarter when the customer made their first purchase<br /><br />**Field Name:** `customerCohortQuarter`<br />**Type:** dimension        |
| <div>RFM Group</div>                          | RFM (Recency, Frequency, Monetary) segmentation group<br /><br />**Field Name:** `rfmGroup`<br />**Type:** dimension                       |
| <div>Predicted Spend Tier</div>               | Predicted spend tier based on customer behavior<br /><br />**Field Name:** `predictedSpendTier`<br />**Type:** dimension                   |
| <div>Customer Tag</div>                       | Tags associated with the customer<br /><br />**Field Name:** `customerTag`<br />**Type:** dimension                                        |
| <div>Customer Account Status</div>            | The account status of the customer<br /><br />**Field Name:** `customerAccountStatus`<br />**Type:** dimension                             |
| <div>Customer Email Subscription Status</div> | Email subscription status of the customer<br /><br />**Field Name:** `customerEmailSubscriptionStatus`<br />**Type:** dimension            |
| <div>Customer SMS Subscription Status</div>   | SMS subscription status of the customer<br /><br />**Field Name:** `customerSmsSubscriptionStatus`<br />**Type:** dimension                |
| <div>First Order Has Subscription</div>       | Whether the first order included a subscription<br /><br />**Field Name:** `firstOrderHasSubscription`<br />**Type:** dimension            |

### Order Status

|                                     |                                                                                                                       |
| ----------------------------------- | --------------------------------------------------------------------------------------------------------------------- |
| <div>Order Fulfillment Status</div> | The fulfillment status of the order<br /><br />**Field Name:** `salesOrderFulfillmentStatus`<br />**Type:** dimension |
| <div>Order Payment Status</div>     | The payment status of the order<br /><br />**Field Name:** `salesOrderPaymentStatus`<br />**Type:** dimension         |
| <div>Is Canceled Order</div>        | Whether the order was canceled<br /><br />**Field Name:** `salesIsCanceledOrder`<br />**Type:** dimension             |
| <div>Order Tag</div>                | Tags associated with the order<br /><br />**Field Name:** `salesOrderTag`<br />**Type:** dimension                    |
| <div>Order Name</div>               | The name/number of the order<br /><br />**Field Name:** `salesOrderName`<br />**Type:** dimension                     |
| <div>Order Risk Level</div>         | The risk level of the order<br /><br />**Field Name:** `salesOrderRiskLevel`<br />**Type:** dimension                 |
| <div>Return Reason</div>            | The reason for the return<br /><br />**Field Name:** `salesReturnReason`<br />**Type:** dimension                     |
| <div>Order or Return</div>          | Whether this is an order or a return<br /><br />**Field Name:** `salesOrderOrReturn`<br />**Type:** dimension         |

### Payment

|                                        |                                                                                                                                          |
| -------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------- |
| <div>Payment Method</div>              | The payment method used (e.g., Credit Card, Debit Card, PayPal)<br /><br />**Field Name:** `paymentMethod`<br />**Type:** dimension      |
| <div>Digital Wallet</div>              | The digital wallet used (Apple Pay, Google Pay, etc.)<br /><br />**Field Name:** `digitalWallet`<br />**Type:** dimension                |
| <div>Transaction Currency</div>        | The currency of the transaction<br /><br />**Field Name:** `transactionCurrency`<br />**Type:** dimension                                |
| <div>Is Shop Pay Transaction</div>     | Whether Shop Pay was used for the transaction<br /><br />**Field Name:** `isShopPayTransaction`<br />**Type:** dimension                 |
| <div>Is Shop Channel Transaction</div> | Whether the transaction was through the Shop channel<br /><br />**Field Name:** `isShopChannelTransaction`<br />**Type:** dimension      |
| <div>Credit Card Tier</div>            | The tier of the credit card used (e.g., Standard, Premium, Rewards)<br /><br />**Field Name:** `creditCardTier`<br />**Type:** dimension |
| <div>Credit Card Type</div>            | The type of credit card used (e.g., Visa, Mastercard, Amex)<br /><br />**Field Name:** `creditCardType`<br />**Type:** dimension         |
| <div>Transaction Status</div>          | The status of the transaction (e.g., Success, Pending, Failed)<br /><br />**Field Name:** `transactionStatus`<br />**Type:** dimension   |
| <div>Transaction Sale Type</div>       | The type of sale for the transaction (e.g., Sale, Refund)<br /><br />**Field Name:** `transactionSaleType`<br />**Type:** dimension      |
| <div>Payment Card BIN</div>            | The Bank Identification Number (first 6 digits) of the payment card<br /><br />**Field Name:** `paymentCardBin`<br />**Type:** dimension |
| <div>Payment Card Issuer</div>         | The issuing bank or financial institution of the payment card<br /><br />**Field Name:** `paymentCardIssuer`<br />**Type:** dimension    |
| <div>Payment Card Source</div>         | The source of the payment card (e.g., Credit, Debit, Prepaid)<br /><br />**Field Name:** `paymentCardSource`<br />**Type:** dimension    |

### Session

|                                 |                                                                                                                                                                                                                                                                                                                                              |
| ------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| <div>Session Country</div>      | The country where the session originated<br /><br />**Field Name:** `sessionCountry`<br />**Type:** dimension                                                                                                                                                                                                                                |
| <div>Session Region</div>       | The region/state where the session originated<br /><br />**Field Name:** `sessionRegion`<br />**Type:** dimension                                                                                                                                                                                                                            |
| <div>Session City</div>         | The city where the session originated<br /><br />**Field Name:** `sessionCity`<br />**Type:** dimension                                                                                                                                                                                                                                      |
| <div>Referrer Domain</div>      | The referring domain of the session<br /><br />**Field Name:** `referrerDomain`<br />**Type:** dimension                                                                                                                                                                                                                                     |
| <div>Referrer Source</div>      | The referrer source type<br /><br />**Field Name:** `referrerSource`<br />**Type:** dimension                                                                                                                                                                                                                                                |
| <div>Referrer Name</div>        | The name of the referrer<br /><br />**Field Name:** `referrerName`<br />**Type:** dimension                                                                                                                                                                                                                                                  |
| <div>Landing Page Path</div>    | The landing page path of the session<br /><br />**Field Name:** `landingPagePath`<br />**Type:** dimension                                                                                                                                                                                                                                   |
| <div>Landing Page Type</div>    | The type of landing page<br /><br />**Field Name:** `landingPageType`<br />**Type:** dimension                                                                                                                                                                                                                                               |
| <div>Session Bounced</div>      | Whether the session bounced<br /><br />**Field Name:** `sessionBounced`<br />**Type:** dimension                                                                                                                                                                                                                                             |
| <div>Human or Bot Session</div> | Whether Shopify classified the session as coming from a human or a bot. Use it to group sessions by traffic type, or filter to "human" to exclude bot traffic. Note: Shopify only classifies sessions from October 7, 2025 onward; earlier sessions are not labeled.<br /><br />**Field Name:** `sessionHumanOrBot`<br />**Type:** dimension |

### B2B

|                                  |                                                                                                                  |
| -------------------------------- | ---------------------------------------------------------------------------------------------------------------- |
| <div>Is B2B Order</div>          | Whether this is a B2B order<br /><br />**Field Name:** `isB2bOrder`<br />**Type:** dimension                     |
| <div>Company Name</div>          | The name of the company (B2B)<br /><br />**Field Name:** `companyName`<br />**Type:** dimension                  |
| <div>Company Location Name</div> | The location name of the company (B2B)<br /><br />**Field Name:** `companyLocationName`<br />**Type:** dimension |

### POS / Retail

|                              |                                                                                                                                  |
| ---------------------------- | -------------------------------------------------------------------------------------------------------------------------------- |
| <div>POS Location ID</div>   | The unique identifier of the POS location<br /><br />**Field Name:** `posLocationId`<br />**Type:** dimension                    |
| <div>POS Location Name</div> | The name of the POS location<br /><br />**Field Name:** `posLocationName`<br />**Type:** dimension                               |
| <div>POS Register ID</div>   | The unique identifier of the POS register<br /><br />**Field Name:** `posRegisterId`<br />**Type:** dimension                    |
| <div>Staff ID</div>          | The unique identifier of the staff member<br /><br />**Field Name:** `staffId`<br />**Type:** dimension                          |
| <div>Staff Member Name</div> | The name of the staff member who processed the transaction<br /><br />**Field Name:** `staffMemberName`<br />**Type:** dimension |

### Inventory by Location

|                                    |                                                                                                                                                                  |
| ---------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| <div>Inventory Location ID</div>   | The unique identifier of the inventory location (warehouse, store, fulfillment center)<br /><br />**Field Name:** `inventoryLocationId`<br />**Type:** dimension |
| <div>Inventory Location Name</div> | The name of the inventory location (warehouse, store, fulfillment center)<br /><br />**Field Name:** `inventoryLocationName`<br />**Type:** dimension            |
| <div>Inventory Product ID</div>    | The unique identifier of the product<br /><br />**Field Name:** `inventoryProductId`<br />**Type:** dimension                                                    |
| <div>Inventory Product Title</div> | The title of the product<br /><br />**Field Name:** `inventoryProductTitle`<br />**Type:** dimension                                                             |
| <div>Inventory Variant ID</div>    | The unique identifier of the product variant<br /><br />**Field Name:** `inventoryVariantId`<br />**Type:** dimension                                            |
| <div>Inventory Variant Title</div> | The title of the product variant<br /><br />**Field Name:** `inventoryVariantTitle`<br />**Type:** dimension                                                     |
| <div>Inventory Variant SKU</div>   | The SKU (Stock Keeping Unit) of the product variant<br /><br />**Field Name:** `inventoryVariantSku`<br />**Type:** dimension                                    |

## Metrics

Metrics are the numerical values you can measure and analyze from your Shopify campaigns.

### Sales

|                                     |                                                                                                                |
| ----------------------------------- | -------------------------------------------------------------------------------------------------------------- |
| <div>Gross Sales</div>              | Total gross sales before any deductions<br /><br />**Field Name:** `grossSales`<br />**Type:** metric          |
| <div>Net Sales</div>                | Net sales after discounts and returns<br /><br />**Field Name:** `netSales`<br />**Type:** metric              |
| <div>Total Sales</div>              | Total sales including all fees and taxes<br /><br />**Field Name:** `totalSales`<br />**Type:** metric         |
| <div>Total Sales (First Time)</div> | Total sales from first-time customers<br /><br />**Field Name:** `totalSalesFirstTime`<br />**Type:** metric   |
| <div>Total Sales (Returning)</div>  | Total sales from returning customers<br /><br />**Field Name:** `totalSalesReturning`<br />**Type:** metric    |
| <div>Average Order Value</div>      | Average order value<br /><br />**Field Name:** `averageOrderValue`<br />**Type:** metric                       |
| <div>Gross Profit</div>             | Gross profit (revenue minus cost of goods sold)<br /><br />**Field Name:** `grossProfit`<br />**Type:** metric |
| <div>Gross Margin</div>             | Gross margin percentage<br /><br />**Field Name:** `grossMargin`<br />**Type:** metric                         |
| <div>Cost of Goods Sold</div>       | Total cost of goods sold<br /><br />**Field Name:** `costOfGoodsSold`<br />**Type:** metric                    |
| <div>Total Duties</div>             | Total import duties and taxes<br /><br />**Field Name:** `totalDuties`<br />**Type:** metric                   |
| <div>Additional Fees</div>          | Additional fees charged<br /><br />**Field Name:** `additionalFees`<br />**Type:** metric                      |
| <div>Tips</div>                     | Total tips received<br /><br />**Field Name:** `tips`<br />**Type:** metric                                    |
| <div>Gift Card Gross Sales</div>    | Gross sales from gift cards<br /><br />**Field Name:** `giftCardGrossSales`<br />**Type:** metric              |

### Orders (Analytics)

|                                          |                                                                                                                    |
| ---------------------------------------- | ------------------------------------------------------------------------------------------------------------------ |
| <div>Total Orders</div>                  | Total number of orders<br /><br />**Field Name:** `totalOrders`<br />**Type:** metric                              |
| <div>Orders (First Time)</div>           | Orders from first-time customers<br /><br />**Field Name:** `ordersFirstTime`<br />**Type:** metric                |
| <div>Orders (Returning)</div>            | Orders from returning customers<br /><br />**Field Name:** `ordersReturning`<br />**Type:** metric                 |
| <div>Orders Delivered</div>              | Orders that have been delivered<br /><br />**Field Name:** `ordersDelivered`<br />**Type:** metric                 |
| <div>Orders Shipped</div>                | Orders that have been shipped<br /><br />**Field Name:** `ordersShipped`<br />**Type:** metric                     |
| <div>Orders Fulfilled</div>              | Orders that have been fulfilled<br /><br />**Field Name:** `ordersFulfilled`<br />**Type:** metric                 |
| <div>Bundles Ordered</div>               | Bundles ordered<br /><br />**Field Name:** `bundlesOrdered`<br />**Type:** metric                                  |
| <div>Net Items Sold</div>                | Net items sold (after returns)<br /><br />**Field Name:** `netItemsSold`<br />**Type:** metric                     |
| <div>Quantity Ordered</div>              | Total quantity ordered<br /><br />**Field Name:** `quantityOrdered`<br />**Type:** metric                          |
| <div>Quantity Ordered Per Order</div>    | Average quantity ordered per order<br /><br />**Field Name:** `quantityOrderedPerOrder`<br />**Type:** metric      |
| <div>Number of Orders Per Customer</div> | Average number of orders per customer<br /><br />**Field Name:** `numberOfOrdersPerCustomer`<br />**Type:** metric |

### Customers (Analytics)

|                                         |                                                                                                                  |
| --------------------------------------- | ---------------------------------------------------------------------------------------------------------------- |
| <div>Customers</div>                    | Total number of customers<br /><br />**Field Name:** `customers`<br />**Type:** metric                           |
| <div>New Customers</div>                | New customers acquired<br /><br />**Field Name:** `newCustomers`<br />**Type:** metric                           |
| <div>Returning Customers</div>          | Returning customers<br /><br />**Field Name:** `returningCustomers`<br />**Type:** metric                        |
| <div>Returning Customer Rate</div>      | Percentage of returning customers<br /><br />**Field Name:** `returningCustomerRate`<br />**Type:** metric       |
| <div>Amount Spent Per Customer</div>    | Average amount spent per customer<br /><br />**Field Name:** `amountSpentPerCustomer`<br />**Type:** metric      |
| <div>Total Amount Spent</div>           | Total lifetime value spent<br /><br />**Field Name:** `totalAmountSpent`<br />**Type:** metric                   |
| <div>Total Amount Spent Per Order</div> | Average amount spent per order<br /><br />**Field Name:** `totalAmountSpentPerOrder`<br />**Type:** metric       |
| <div>Total Number of Orders</div>       | Total number of orders from all customers<br /><br />**Field Name:** `totalNumberOfOrders`<br />**Type:** metric |
| <div>Days Since Last Order</div>        | Days since customer last ordered<br /><br />**Field Name:** `daysSinceLastOrder`<br />**Type:** metric           |
| <div>Percent of Customers</div>         | Percentage of total customers<br /><br />**Field Name:** `percentOfCustomers`<br />**Type:** metric              |

### Discounts

|                                      |                                                                                                        |
| ------------------------------------ | ------------------------------------------------------------------------------------------------------ |
| <div>Total Discount</div>            | Total discount amount<br /><br />**Field Name:** `totalDiscount`<br />**Type:** metric                 |
| <div>Order Level Discounts</div>     | Order-level discounts applied<br /><br />**Field Name:** `orderLevelDiscounts`<br />**Type:** metric   |
| <div>Line Item Discounts</div>       | Line item-level discounts applied<br /><br />**Field Name:** `lineItemDiscounts`<br />**Type:** metric |
| <div>Gift Card Discounts</div>       | Gift card discounts applied<br /><br />**Field Name:** `giftCardDiscounts`<br />**Type:** metric       |
| <div>Discounts Returned</div>        | Discounts returned with refunds<br /><br />**Field Name:** `discountsReturned`<br />**Type:** metric   |
| <div>Shipping Charge Discounts</div> | Shipping charge discounts<br /><br />**Field Name:** `shippingChargeDiscounts`<br />**Type:** metric   |

### Returns

|                                   |                                                                                                |
| --------------------------------- | ---------------------------------------------------------------------------------------------- |
| <div>Total Refunds</div>          | Total refunds issued<br /><br />**Field Name:** `totalRefunds`<br />**Type:** metric           |
| <div>Gross Returns</div>          | Gross return value<br /><br />**Field Name:** `grossReturns`<br />**Type:** metric             |
| <div>Net Returns</div>            | Net return value<br /><br />**Field Name:** `netReturns`<br />**Type:** metric                 |
| <div>Total Returns</div>          | Total returns value<br /><br />**Field Name:** `totalReturns`<br />**Type:** metric            |
| <div>Quantity Returned</div>      | Quantity of items returned<br /><br />**Field Name:** `quantityReturned`<br />**Type:** metric |
| <div>Returned Quantity Rate</div> | Return rate percentage<br /><br />**Field Name:** `returnedQuantityRate`<br />**Type:** metric |
| <div>Shipping Returned</div>      | Shipping costs returned<br /><br />**Field Name:** `shippingReturned`<br />**Type:** metric    |
| <div>Return Fees</div>            | Return processing fees<br /><br />**Field Name:** `returnFees`<br />**Type:** metric           |

### Fulfillments

|                                               |                                                                                                                            |
| --------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------- |
| <div>Total Shipping</div>                     | Total shipping revenue<br /><br />**Field Name:** `totalShipping`<br />**Type:** metric                                    |
| <div>Total Shipping Charges</div>             | Total shipping charges collected<br /><br />**Field Name:** `totalShippingCharges`<br />**Type:** metric                   |
| <div>Median Days Order to Delivery</div>      | Median days from order to delivery<br /><br />**Field Name:** `medianDaysOrderToDelivery`<br />**Type:** metric            |
| <div>Median Days Order to Shipping</div>      | Median days from order to shipping<br /><br />**Field Name:** `medianDaysOrderToShipping`<br />**Type:** metric            |
| <div>Median Days Order to Fulfillment</div>   | Median days from order to fulfillment<br /><br />**Field Name:** `medianDaysOrderToFulfillment`<br />**Type:** metric      |
| <div>Median Days Shipping to Delivery</div>   | Median days from shipping to delivery<br /><br />**Field Name:** `medianDaysShippingToDelivery`<br />**Type:** metric      |
| <div>Orders Delivered Fast Rate</div>         | Rate of orders delivered quickly<br /><br />**Field Name:** `ordersDeliveredFastRate`<br />**Type:** metric                |
| <div>Orders Shipped Fast Rate</div>           | Rate of orders shipped quickly<br /><br />**Field Name:** `ordersShippedFastRate`<br />**Type:** metric                    |
| <div>Orders With Tracking Included Rate</div> | Rate of orders with tracking information<br /><br />**Field Name:** `ordersWithTrackingIncludedRate`<br />**Type:** metric |

### Taxes

|                                       |                                                                                                                   |
| ------------------------------------- | ----------------------------------------------------------------------------------------------------------------- |
| <div>Total Tax</div>                  | Total taxes collected<br /><br />**Field Name:** `totalTax`<br />**Type:** metric                                 |
| <div>Shipping Charge Taxes</div>      | Taxes on shipping charges<br /><br />**Field Name:** `shippingChargeTaxes`<br />**Type:** metric                  |
| <div>Taxes Returned</div>             | Taxes returned with refunds<br /><br />**Field Name:** `taxesReturned`<br />**Type:** metric                      |
| <div>Taxes Excluding Gift Cards</div> | Taxes excluding gift card transactions<br /><br />**Field Name:** `taxesExcludingGiftCards`<br />**Type:** metric |

### Sessions

|                                             |                                                                                                                   |
| ------------------------------------------- | ----------------------------------------------------------------------------------------------------------------- |
| <div>Sessions</div>                         | Total sessions<br /><br />**Field Name:** `sessions`<br />**Type:** metric                                        |
| <div>Online Store Visitors</div>            | Unique store visitors<br /><br />**Field Name:** `onlineStoreVisitors`<br />**Type:** metric                      |
| <div>Pageviews</div>                        | Total page views<br /><br />**Field Name:** `pageviews`<br />**Type:** metric                                     |
| <div>Bounces</div>                          | Sessions that bounced<br /><br />**Field Name:** `bounces`<br />**Type:** metric                                  |
| <div>Bounce Rate</div>                      | Bounce rate percentage<br /><br />**Field Name:** `bounceRate`<br />**Type:** metric                              |
| <div>Conversion Rate</div>                  | Overall conversion rate<br /><br />**Field Name:** `conversionRate`<br />**Type:** metric                         |
| <div>Checkout Conversion Rate</div>         | Checkout conversion rate<br /><br />**Field Name:** `checkoutConversionRate`<br />**Type:** metric                |
| <div>Added to Cart Rate</div>               | Add to cart rate<br /><br />**Field Name:** `addedToCartRate`<br />**Type:** metric                               |
| <div>Reached Checkout Rate</div>            | Rate of sessions reaching checkout<br /><br />**Field Name:** `reachedCheckoutRate`<br />**Type:** metric         |
| <div>Completed Checkout Rate</div>          | Rate of sessions completing checkout<br /><br />**Field Name:** `completedCheckoutRate`<br />**Type:** metric     |
| <div>Sessions That Completed Checkout</div> | Sessions that completed checkout<br /><br />**Field Name:** `sessionsThatCompletedCheckout`<br />**Type:** metric |
| <div>Sessions That Reached Checkout</div>   | Sessions that reached checkout<br /><br />**Field Name:** `sessionsThatReachedCheckout`<br />**Type:** metric     |
| <div>Sessions With Cart Additions</div>     | Sessions with items added to cart<br /><br />**Field Name:** `sessionsWithCartAdditions`<br />**Type:** metric    |
| <div>Average Session Duration</div>         | Average session duration<br /><br />**Field Name:** `averageSessionDuration`<br />**Type:** metric                |
| <div>Pageviews Per Session</div>            | Average pageviews per session<br /><br />**Field Name:** `pageviewsPerSession`<br />**Type:** metric              |

### Payments

|                                     |                                                                                                               |
| ----------------------------------- | ------------------------------------------------------------------------------------------------------------- |
| <div>Gross Payments</div>           | Gross payments received<br /><br />**Field Name:** `grossPayments`<br />**Type:** metric                      |
| <div>Net Payments</div>             | Net payments after fees<br /><br />**Field Name:** `netPayments`<br />**Type:** metric                        |
| <div>Refunded Payments</div>        | Refunded payments count<br /><br />**Field Name:** `refundedPayments`<br />**Type:** metric                   |
| <div>Transactions</div>             | Total transaction count<br /><br />**Field Name:** `transactions`<br />**Type:** metric                       |
| <div>Transaction Amount</div>       | Total transaction amount<br /><br />**Field Name:** `transactionAmount`<br />**Type:** metric                 |
| <div>Orders With Transactions</div> | Orders with successful transactions<br /><br />**Field Name:** `ordersWithTransactions`<br />**Type:** metric |

### Subscriptions

|                                   |                                                                                                 |
| --------------------------------- | ----------------------------------------------------------------------------------------------- |
| <div>Active Subscriptions</div>   | Active subscriptions<br /><br />**Field Name:** `activeSubscriptions`<br />**Type:** metric     |
| <div>Subscriptions Added</div>    | New subscriptions added<br /><br />**Field Name:** `subscriptionsAdded`<br />**Type:** metric   |
| <div>Subscriptions Canceled</div> | Subscriptions canceled<br /><br />**Field Name:** `subscriptionsCanceled`<br />**Type:** metric |

### Gift Cards

|                                        |                                                                                                      |
| -------------------------------------- | ---------------------------------------------------------------------------------------------------- |
| <div>Gift Card Net Sales</div>         | Net sales from gift cards<br /><br />**Field Name:** `giftCardNetSales`<br />**Type:** metric        |
| <div>Gift Cards Issued</div>           | Gift cards issued<br /><br />**Field Name:** `giftCardsIssued`<br />**Type:** metric                 |
| <div>Ending Gift Card Balance</div>    | Ending gift card balance<br /><br />**Field Name:** `endingGiftCardBalance`<br />**Type:** metric    |
| <div>Credited Store Credit Value</div> | Store credit value added<br /><br />**Field Name:** `creditedStoreCreditValue`<br />**Type:** metric |
| <div>Debited Store Credit Value</div>  | Store credit value used<br /><br />**Field Name:** `debitedStoreCreditValue`<br />**Type:** metric   |

### Order

|                                                      |                                                                                                                                                                                                                                                                                                                                                     |
| ---------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| <div>Order Original Total Price</div>                | The total price of the order at the time of order creation.<br /><br />**Field Name:** `orderOriginalTotalPriceSetShopMoneyAmount`<br />**Type:** metric                                                                                                                                                                                            |
| <div>Order Total Received</div>                      | The total amount received from the customer before returns.<br /><br />**Field Name:** `orderTotalReceivedSetShopMoneyAmount`<br />**Type:** metric                                                                                                                                                                                                 |
| <div>Order Total Price Before Returns</div>          | The total price of the order, before returns. This includes taxes and discounts.<br /><br />**Field Name:** `orderTotalPriceSetShopMoneyAmount`<br />**Type:** metric                                                                                                                                                                               |
| <div>Order Subtotal Price</div>                      | The sum of the prices for all line items after discounts and returns.<br /><br />**Field Name:** `orderCurrentSubtotalPriceSetShopMoneyAmount`<br />**Type:** metric                                                                                                                                                                                |
| <div>Order Total Price After Returns</div>           | The total price of the order, after returns. This includes taxes and discounts.<br /><br />**Field Name:** `orderCurrentTotalPriceSetShopMoneyAmount`<br />**Type:** metric                                                                                                                                                                         |
| <div>Order Total Additional Fees After Returns</div> | The total amount of additional fees after returns.<br /><br />**Field Name:** `orderCurrentTotalAdditionalFeesSetShopMoneyAmount`<br />**Type:** metric                                                                                                                                                                                             |
| <div>Order Original Total Additional Fees</div>      | The total amount of additional fees at the time of order creation.<br /><br />**Field Name:** `orderOriginalTotalAdditionalFeesSetShopMoneyAmount`<br />**Type:** metric                                                                                                                                                                            |
| <div>Order Total Duties After Returns</div>          | The total amount of duties after returns.<br /><br />**Field Name:** `orderCurrentTotalDutiesSetShopMoneyAmount`<br />**Type:** metric                                                                                                                                                                                                              |
| <div>Order Original Total Duties</div>               | The total amount of duties at the time of order creation.<br /><br />**Field Name:** `orderOriginalTotalDutiesSetShopMoneyAmount`<br />**Type:** metric                                                                                                                                                                                             |
| <div>Order Refund Discrepancy</div>                  | The difference between the suggested and actual refund amount of all refunds that have been applied to the order. A positive value indicates a difference in the merchant's favor, and a negative value indicates a difference in the customer's favor.<br /><br />**Field Name:** `orderRefundDiscrepancySetShopMoneyAmount`<br />**Type:** metric |
| <div>Order Total Shipping Price</div>                | The total shipping amount before discounts and returns.<br /><br />**Field Name:** `orderTotalShippingPriceSetShopMoneyAmount`<br />**Type:** metric                                                                                                                                                                                                |
| <div>Order Total Refunded Shipping</div>             | The total amount of shipping that was refunded.<br /><br />**Field Name:** `orderTotalRefundedShippingSetShopMoneyAmount`<br />**Type:** metric                                                                                                                                                                                                     |
| <div>Order Total Tax</div>                           | The total tax amount before returns.<br /><br />**Field Name:** `orderTotalTaxSetShopMoneyAmount`<br />**Type:** metric                                                                                                                                                                                                                             |
| <div>Order Total Tip Received</div>                  | The sum of all tip amounts for the order.<br /><br />**Field Name:** `orderTotalTipReceivedSetShopMoneyAmount`<br />**Type:** metric                                                                                                                                                                                                                |
| <div>Order Total Weight</div>                        | The total weight of the order before returns, in grams.<br /><br />**Field Name:** `orderTotalWeight`<br />**Type:** metric                                                                                                                                                                                                                         |
| <div>Order Cart Discount</div>                       | The total order-level discount amount, before returns.<br /><br />**Field Name:** `orderCartDiscountAmountSetShopMoneyAmount`<br />**Type:** metric                                                                                                                                                                                                 |
| <div>Order Total Discounts After Returns</div>       | The total amount discounted on the order after returns. This includes both order and line level discounts.<br /><br />**Field Name:** `orderCurrentTotalDiscountsSetShopMoneyAmount`<br />**Type:** metric                                                                                                                                          |
| <div>Order Total Discounts</div>                     | The total amount discounted on the order before returns. This includes both order and line level discounts.<br /><br />**Field Name:** `orderTotalDiscountsSetShopMoneyAmount`<br />**Type:** metric                                                                                                                                                |
| <div>Order Total Refunded</div>                      | The total amount that was refunded.<br /><br />**Field Name:** `orderTotalRefundedSetShopMoneyAmount`<br />**Type:** metric                                                                                                                                                                                                                         |
| <div>Order Net Quantity</div>                        | Net quantity of line items ordered. It shows number of sold items minus the number of returned items<br /><br />**Field Name:** `orderNetQuantity`<br />**Type:** metric                                                                                                                                                                            |
| <div>Order Ordered Quantity</div>                    | Total number of items ordered. Calculated by Net quantity + Returned quantity<br /><br />**Field Name:** `orderOrderedQuantity`<br />**Type:** metric                                                                                                                                                                                               |
| <div>Order Refunded Quantity</div>                   | Total number of items returned<br /><br />**Field Name:** `orderRefundedQuantity`<br />**Type:** metric                                                                                                                                                                                                                                             |

### Order Customer

|                                            |                                                                                                                                                                |
| ------------------------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| <div>Order Customer Amount Spent</div>     | The total amount that the customer has spent on orders in their lifetime.<br /><br />**Field Name:** `orderCustomerAmountSpend`<br />**Type:** metric          |
| <div>Order Customer Number Of Orders</div> | The number of orders that the customer has made at the store in their lifetime.<br /><br />**Field Name:** `orderCustomerNumberOfOrders`<br />**Type:** metric |

### Line Item

|                                               |                                                                                                                                                                                                                                                                      |
| --------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| <div>Line Item Price</div>                    | The total price of the Line Item when the order was created in shop currency.<br /><br />**Field Name:** `lineItemOriginalUnitPriceSetShopMoneyAmount`<br />**Type:** metric                                                                                         |
| <div>Line Item Tax</div>                      | The total tax charged on the Line Item (sum of its tax lines) in shop currency.<br /><br />**Field Name:** `lineItemTotalTaxShopMoneyAmount`<br />**Type:** metric                                                                                                   |
| <div>Line Item Price Range (Min)</div>        | The minimum price of the product price range<br /><br />**Field Name:** `lineItemProductPriceRangeMin`<br />**Type:** metric                                                                                                                                         |
| <div>Line Item Price Range (Max)</div>        | The maximum price of the product price range<br /><br />**Field Name:** `lineItemProductPriceRangeMax`<br />**Type:** metric                                                                                                                                         |
| <div>Line Item Variant Cost</div>             | Unit cost associated with the inventory item. This is the cost of goods sold (COGS) for profit margin calculations. Note: Requires "View product costs" permission in Shopify.<br /><br />**Field Name:** `lineItemVariantInventoryCostAmount`<br />**Type:** metric |
| <div>Line Item Discount</div>                 | The discount allocation for the line item<br /><br />**Field Name:** `lineItemDiscountAllocation`<br />**Type:** metric                                                                                                                                              |
| <div>Line Item Quantity</div>                 | The number of units ordered, including refunded and removed units<br /><br />**Field Name:** `lineItemQuantity`<br />**Type:** metric                                                                                                                                |
| <div>Line Item Total Inventory</div>          | The quantity of that's in stock<br /><br />**Field Name:** `lineItemProductTotalInventory`<br />**Type:** metric                                                                                                                                                     |
| <div>Line Item Variant Compare At Price</div> | The compare at price amount of the product variant<br /><br />**Field Name:** `lineItemVariantCompareAtPriceAmount`<br />**Type:** metric                                                                                                                            |
| <div>Line Item Variant Price</div>            | The price of the product variant in the default shop currency<br /><br />**Field Name:** `lineItemVariantPrice`<br />**Type:** metric                                                                                                                                |
| <div>Line Item Variant Compare At Price</div> | The compare-at price of the variant in the default shop currency<br /><br />**Field Name:** `lineItemVariantCompareAtPrice`<br />**Type:** metric                                                                                                                    |
| <div>Line Item Inventory Quantity</div>       | The total sellable quantity of the variant<br /><br />**Field Name:** `lineItemVariantInventoryQuantity`<br />**Type:** metric                                                                                                                                       |

### Line Item Refund

|                                       |                                                                                                                                                          |
| ------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------- |
| <div>Line Item Refund Price</div>     | The price of a refunded Line Item in shop currency.<br /><br />**Field Name:** `lineItemRefundPriceShopMoneyAmount`<br />**Type:** metric                |
| <div>Line Item Refund Total Tax</div> | The total tax charged on a refunded Line Item in shop currency.<br /><br />**Field Name:** `lineItemRefundTotalTaxShopMoneyAmount`<br />**Type:** metric |
| <div>Line Item Refund Subtotal</div>  | The subtotal price of a refunded Line Item in shop currency.<br /><br />**Field Name:** `lineItemRefundSubTotalShopMoneyAmount`<br />**Type:** metric    |
| <div>Line Item Refund Quantity</div>  | The quantity of a refunded Line Item<br /><br />**Field Name:** `lineItemRefundQuantity`<br />**Type:** metric                                           |

### Product

|                                      |                                                                                                                                                                                                                                                                                              |
| ------------------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| <div>Product Total Inventory</div>   | The quantity of that's in stock<br /><br />**Field Name:** `productTotalInventory`<br />**Type:** metric                                                                                                                                                                                     |
| <div>Product On Hand Inventory</div> | The total physical units on hand across all locations (available + committed + other unavailable states). Unlike "Product Total Inventory" (available to sell), this reflects what is physically in the warehouse.<br /><br />**Field Name:** `productOnHandInventory`<br />**Type:** metric |
| <div>Product Variant Unit Cost</div> | The unit cost of the product variant<br /><br />**Field Name:** `productVariantUnitCost`<br />**Type:** metric                                                                                                                                                                               |
| <div>Product Variant Price</div>     | The price of the product variant<br /><br />**Field Name:** `productVariantPrice`<br />**Type:** metric                                                                                                                                                                                      |
| <div>Product Price Range (Min)</div> | The minimum price of the product, expressed in decimal numbers<br /><br />**Field Name:** `productPriceRangeMin`<br />**Type:** metric                                                                                                                                                       |
| <div>Product Price Range (Max)</div> | The maximum price of the product, expressed in decimal numbers<br /><br />**Field Name:** `productPriceRangeMax`<br />**Type:** metric                                                                                                                                                       |

### Refund

|                                        |                                                                                                                                              |
| -------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------- |
| <div>Refund Total Refunded</div>       | The total refunded amount in shop currency.<br /><br />**Field Name:** `refundTotalRefundedShopMoneyAmount`<br />**Type:** metric            |
| <div>Refund Order Adjustment</div>     | The order adjustment amount in shop currency.<br /><br />**Field Name:** `refundOrderAdjustmentShopMoneyAmount`<br />**Type:** metric        |
| <div>Refund Order Adjustment Tax</div> | The order adjustment tax amount in shop currency.<br /><br />**Field Name:** `refundOrderAdjustmentTaxShopMoneyAmount`<br />**Type:** metric |

### Traffic Source

|                                              |                                                                                                                                                |
| -------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------- |
| <div>Traffic Source Days to Conversion</div> | The number of days between first visit and order conversion<br /><br />**Field Name:** `customerJourneyDaysToConversion`<br />**Type:** metric |

### Inventory by Location

|                                |                                                                                                                                                                  |
| ------------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| <div>Inventory Available</div> | Units available to sell at this location (on hand minus committed and unavailable)<br /><br />**Field Name:** `inventoryAvailableQuantity`<br />**Type:** metric |
| <div>Inventory On Hand</div>   | Total physical units at this location, including committed and unavailable stock<br /><br />**Field Name:** `inventoryOnHandQuantity`<br />**Type:** metric      |
| <div>Inventory Committed</div> | Units at this location that belong to placed but unfulfilled orders<br /><br />**Field Name:** `inventoryCommittedQuantity`<br />**Type:** metric                |
| <div>Inventory Incoming</div>  | Units on their way to this location (incoming transfers and purchase orders)<br /><br />**Field Name:** `inventoryIncomingQuantity`<br />**Type:** metric        |
| <div>Inventory Reserved</div>  | Units at this location held temporarily (e.g. draft orders), not available to sell<br /><br />**Field Name:** `inventoryReservedQuantity`<br />**Type:** metric  |

***

## Related

<CardGroup>
  <Card title="Fields Catalog" icon="book" href="/fields-catalog">
    Browse all platforms
  </Card>

  <Card title="WooCommerce Fields" icon="chart-bar" href="/data-source/woocommerce/fields">
    WooCommerce metrics & dimensions
  </Card>

  <Card title="TiendaNube Fields" icon="chart-bar" href="/data-source/tiendanube/fields">
    TiendaNube metrics & dimensions
  </Card>

  <Card title="Stripe Fields" icon="chart-bar" href="/data-source/stripe/fields">
    Stripe metrics & dimensions
  </Card>
</CardGroup>


# Snapchat Ads Metrics & Dimensions
Source: https://support.detrics.io/data-source/snapchat-ads/fields

Complete reference for Snapchat Ads dimensions and metrics

<Info>
  **Last updated:** August 6, 2026
</Info>

<div>
  <div>
    45 dimensions
  </div>

  <div>
    53 metrics
  </div>
</div>

This reference covers all available dimensions and metrics for Snapchat Ads data through Detrics. Use this guide to understand what data you can extract and how to structure your queries.

<div>
  <span>Supported destinations:</span>

  <div>
    Google Sheets
  </div>

  <div>
    Claude
  </div>

  <div>
    BigQuery
  </div>
</div>

## Dimensions

Dimensions are the attributes you can use to segment and group your Snapchat Ads data.

### Account

|                             |                                                                                                                                   |
| --------------------------- | --------------------------------------------------------------------------------------------------------------------------------- |
| <div>Account ID</div>       | Unique identifier for the Snapchat ad account<br /><br />**Field Name:** `accountId`<br />**Type:** dimension                     |
| <div>Account Name</div>     | Name of the Snapchat ad account<br /><br />**Field Name:** `accountName`<br />**Type:** dimension                                 |
| <div>Account Currency</div> | ISO currency code of the ad account (e.g. USD, EUR)<br /><br />**Field Name:** `accountCurrency`<br />**Type:** dimension         |
| <div>Account Timezone</div> | IANA timezone of the ad account (e.g. America/Los\_Angeles)<br /><br />**Field Name:** `accountTimezone`<br />**Type:** dimension |
| <div>Account Status</div>   | Status of the ad account (ACTIVE, PAUSED)<br /><br />**Field Name:** `accountStatus`<br />**Type:** dimension                     |
| <div>Account Type</div>     | Type of the ad account (PARTNER, DIRECT)<br /><br />**Field Name:** `accountType`<br />**Type:** dimension                        |
| <div>Organization ID</div>  | ID of the Snapchat business organization<br /><br />**Field Name:** `organizationId`<br />**Type:** dimension                     |

### Campaign

|                                        |                                                                                                                                                                             |
| -------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| <div>Campaign Name</div>               | Name of the campaign<br /><br />**Field Name:** `campaignName`<br />**Type:** dimension                                                                                     |
| <div>Campaign ID</div>                 | Unique identifier for the campaign<br /><br />**Field Name:** `campaignId`<br />**Type:** dimension                                                                         |
| <div>Campaign Status</div>             | Status of the campaign (ACTIVE, PAUSED, ARCHIVED)<br /><br />**Field Name:** `campaignStatus`<br />**Type:** dimension                                                      |
| <div>Campaign Objective</div>          | Campaign objective (BRAND\_AWARENESS, WEB\_VIEW, APP\_INSTALL, VIDEO\_VIEW, etc.)<br /><br />**Field Name:** `campaignObjective`<br />**Type:** dimension                   |
| <div>Campaign Objective (V2)</div>     | New-format campaign objective (AWARENESS\_AND\_ENGAGEMENT, TRAFFIC, APP\_PROMOTION, LEADS, SALES)<br /><br />**Field Name:** `campaignObjectiveV2`<br />**Type:** dimension |
| <div>Campaign Buy Model</div>          | Buy model of the campaign (AUCTION, RESERVED)<br /><br />**Field Name:** `campaignBuyModel`<br />**Type:** dimension                                                        |
| <div>Campaign Start Time</div>         | Date the campaign was scheduled to start<br /><br />**Field Name:** `campaignStartTime`<br />**Type:** dimension                                                            |
| <div>Campaign End Time</div>           | Date the campaign was scheduled to end<br /><br />**Field Name:** `campaignEndTime`<br />**Type:** dimension                                                                |
| <div>Campaign Daily Budget</div>       | Daily budget amount for the campaign in account currency<br /><br />**Field Name:** `campaignDailyBudget`<br />**Type:** dimension                                          |
| <div>Campaign Lifetime Spend Cap</div> | Total lifetime spend cap for the campaign in account currency<br /><br />**Field Name:** `campaignLifetimeSpendCap`<br />**Type:** dimension                                |

### Ad Squad

|                                         |                                                                                                                                                     |
| --------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------- |
| <div>Ad Squad Name</div>                | Name of the ad squad<br /><br />**Field Name:** `adSquadName`<br />**Type:** dimension                                                              |
| <div>Ad Squad ID</div>                  | Unique identifier for the ad squad<br /><br />**Field Name:** `adSquadId`<br />**Type:** dimension                                                  |
| <div>Ad Squad Status</div>              | Status of the ad squad (ACTIVE, PAUSED)<br /><br />**Field Name:** `adSquadStatus`<br />**Type:** dimension                                         |
| <div>Ad Squad Type</div>                | Type of the ad squad (SNAP\_ADS, STORY)<br /><br />**Field Name:** `adSquadType`<br />**Type:** dimension                                           |
| <div>Ad Squad Billing Event</div>       | Billing event for the ad squad (IMPRESSION, SWIPE)<br /><br />**Field Name:** `adSquadBillingEvent`<br />**Type:** dimension                        |
| <div>Ad Squad Bid Strategy</div>        | Bidding strategy (AUTO\_BID, LOWEST\_COST\_WITH\_MAX\_BID, TARGET\_COST)<br /><br />**Field Name:** `adSquadBidStrategy`<br />**Type:** dimension   |
| <div>Ad Squad Optimization Goal</div>   | Optimization goal (IMPRESSIONS, SWIPES, INSTALLS, VIDEO\_VIEWS, etc.)<br /><br />**Field Name:** `adSquadOptimizationGoal`<br />**Type:** dimension |
| <div>Ad Squad Daily Budget</div>        | Daily budget for the ad squad in account currency<br /><br />**Field Name:** `adSquadDailyBudget`<br />**Type:** dimension                          |
| <div>Ad Squad Lifetime Budget</div>     | Lifetime budget for the ad squad in account currency<br /><br />**Field Name:** `adSquadLifetimeBudget`<br />**Type:** dimension                    |
| <div>Ad Squad Start Time</div>          | Date the ad squad was scheduled to start<br /><br />**Field Name:** `adSquadStartTime`<br />**Type:** dimension                                     |
| <div>Ad Squad End Time</div>            | Date the ad squad was scheduled to end<br /><br />**Field Name:** `adSquadEndTime`<br />**Type:** dimension                                         |
| <div>Ad Squad Pacing Type</div>         | Pacing type for the ad squad (STANDARD, ACCELERATED)<br /><br />**Field Name:** `adSquadPacingType`<br />**Type:** dimension                        |
| <div>Ad Squad Delivery Constraint</div> | Budget delivery constraint (DAILY\_BUDGET, LIFETIME\_BUDGET)<br /><br />**Field Name:** `adSquadDeliveryConstraint`<br />**Type:** dimension        |

### Ad

|                             |                                                                                                                                           |
| --------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------- |
| <div>Ad Name</div>          | Name of the ad<br /><br />**Field Name:** `adName`<br />**Type:** dimension                                                               |
| <div>Ad ID</div>            | Unique identifier for the ad<br /><br />**Field Name:** `adId`<br />**Type:** dimension                                                   |
| <div>Ad Status</div>        | Status of the ad (ACTIVE, PAUSED, ARCHIVED)<br /><br />**Field Name:** `adStatus`<br />**Type:** dimension                                |
| <div>Ad Type</div>          | Type of the ad (REMOTE\_WEBPAGE, APP\_INSTALL, DEEP\_LINK\_ATTACHMENT, etc.)<br /><br />**Field Name:** `adType`<br />**Type:** dimension |
| <div>Ad Render Type</div>   | How the ad is rendered (STATIC, COMPOSITE)<br /><br />**Field Name:** `adRenderType`<br />**Type:** dimension                             |
| <div>Ad Review Status</div> | Review status (APPROVED, PENDING, REJECTED)<br /><br />**Field Name:** `adReviewStatus`<br />**Type:** dimension                          |
| <div>Creative ID</div>      | ID of the creative used by the ad<br /><br />**Field Name:** `adCreativeId`<br />**Type:** dimension                                      |

### Geography

|                    |                                                                                                                                            |
| ------------------ | ------------------------------------------------------------------------------------------------------------------------------------------ |
| <div>Country</div> | ISO 2-letter country code of the user<br /><br />**Field Name:** `country`<br />**Type:** dimension                                        |
| <div>Region</div>  | US-only region (state) breakdown. Cannot be combined with conversion metrics.<br /><br />**Field Name:** `region`<br />**Type:** dimension |
| <div>DMA</div>     | US-only Designated Market Area. Cannot be combined with conversion metrics.<br /><br />**Field Name:** `dma`<br />**Type:** dimension      |

### Demographics

|                       |                                                                                                                                            |
| --------------------- | ------------------------------------------------------------------------------------------------------------------------------------------ |
| <div>Gender</div>     | Gender of the user (male, female, unknown)<br /><br />**Field Name:** `gender`<br />**Type:** dimension                                    |
| <div>Age Bucket</div> | Age range of the user (13-17, 18-20, 21-24, 25-34, 35-44, 45-54, 55+, 35+)<br /><br />**Field Name:** `ageBucket`<br />**Type:** dimension |

### Device

|                             |                                                                                                                                                          |
| --------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------- |
| <div>Operating System</div> | Mobile operating system (ios, android, web)<br /><br />**Field Name:** `operatingSystem`<br />**Type:** dimension                                        |
| <div>Device Make</div>      | Device manufacturer (Apple, Samsung, etc.). Cannot be combined with conversion metrics.<br /><br />**Field Name:** `deviceMake`<br />**Type:** dimension |

### Interests

|                               |                                                                                                              |
| ----------------------------- | ------------------------------------------------------------------------------------------------------------ |
| <div>Lifestyle Category</div> | Snapchat lifestyle interest category<br /><br />**Field Name:** `lifestyleCategory`<br />**Type:** dimension |

## Metrics

Metrics are the numerical values you can measure and analyze from your Snapchat Ads campaigns.

### Delivery

|                               |                                                                                                              |
| ----------------------------- | ------------------------------------------------------------------------------------------------------------ |
| <div>Spend</div>              | Total amount spent in account currency<br /><br />**Field Name:** `spend`<br />**Type:** metric              |
| <div>Impressions</div>        | Total number of times the ad was shown<br /><br />**Field Name:** `impressions`<br />**Type:** metric        |
| <div>Swipes</div>             | Total number of swipe-up actions on the ad<br /><br />**Field Name:** `swipes`<br />**Type:** metric         |
| <div>Unique Reach</div>       | Number of unique users reached<br /><br />**Field Name:** `uniques`<br />**Type:** metric                    |
| <div>Frequency</div>          | Average impressions per unique user<br /><br />**Field Name:** `frequency`<br />**Type:** metric             |
| <div>Landing Page Views</div> | Number of landing page views from the ad<br /><br />**Field Name:** `landingPageViews`<br />**Type:** metric |

### Video

|                                  |                                                                                                                               |
| -------------------------------- | ----------------------------------------------------------------------------------------------------------------------------- |
| <div>Video Views</div>           | Number of times the video was viewed (≥2 seconds)<br /><br />**Field Name:** `videoViews`<br />**Type:** metric               |
| <div>Video Views (5s)</div>      | Number of times the video was viewed for at least 5 seconds<br /><br />**Field Name:** `videoViews5s`<br />**Type:** metric   |
| <div>Video Views (15s)</div>     | Number of times the video was viewed for at least 15 seconds<br /><br />**Field Name:** `videoViews15s`<br />**Type:** metric |
| <div>Screen Time (Seconds)</div> | Total screen time in seconds across all impressions<br /><br />**Field Name:** `screenTimeSeconds`<br />**Type:** metric      |
| <div>Video 25% Views</div>       | Number of users who watched at least 25% of the video<br /><br />**Field Name:** `quartile1`<br />**Type:** metric            |
| <div>Video 50% Views</div>       | Number of users who watched at least 50% of the video<br /><br />**Field Name:** `quartile2`<br />**Type:** metric            |
| <div>Video 75% Views</div>       | Number of users who watched at least 75% of the video<br /><br />**Field Name:** `quartile3`<br />**Type:** metric            |
| <div>Video 100% Views</div>      | Number of users who watched the full video<br /><br />**Field Name:** `viewCompletion`<br />**Type:** metric                  |
| <div>Engaged Views</div>         | Engaged views (15+ seconds or completed video) since Feb 2025<br /><br />**Field Name:** `engagedViews`<br />**Type:** metric |

### Engagement

|                           |                                                                                                        |
| ------------------------- | ------------------------------------------------------------------------------------------------------ |
| <div>Profile Clicks</div> | Number of clicks on the brand profile<br /><br />**Field Name:** `profileClicks`<br />**Type:** metric |
| <div>Shares</div>         | Number of times the ad was shared<br /><br />**Field Name:** `shares`<br />**Type:** metric            |
| <div>Saves</div>          | Number of times the ad was saved<br /><br />**Field Name:** `saves`<br />**Type:** metric              |

### Story

|                            |                                                                                                                   |
| -------------------------- | ----------------------------------------------------------------------------------------------------------------- |
| <div>Story Opens</div>     | Number of opens for Story ads<br /><br />**Field Name:** `storyOpens`<br />**Type:** metric                       |
| <div>Story Completes</div> | Number of users who completed viewing the Story<br /><br />**Field Name:** `storyCompletes`<br />**Type:** metric |

### App Install

|                             |                                                                                                               |
| --------------------------- | ------------------------------------------------------------------------------------------------------------- |
| <div>Android Installs</div> | Number of Android app installs from the ad<br /><br />**Field Name:** `androidInstalls`<br />**Type:** metric |
| <div>iOS Installs</div>     | Number of iOS app installs from the ad<br /><br />**Field Name:** `iosInstalls`<br />**Type:** metric         |
| <div>Total Installs</div>   | Total app installs across all platforms<br /><br />**Field Name:** `totalInstalls`<br />**Type:** metric      |

### Lead

|                         |                                                                                                               |
| ----------------------- | ------------------------------------------------------------------------------------------------------------- |
| <div>Native Leads</div> | Number of leads collected via native lead form<br /><br />**Field Name:** `nativeLeads`<br />**Type:** metric |

### Conversions

|                                  |                                                                                                                                                      |
| -------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------- |
| <div>Purchases</div>             | Number of purchase conversions (7-day swipe + 1-day view default attribution)<br /><br />**Field Name:** `conversionPurchases`<br />**Type:** metric |
| <div>Sign Ups</div>              | Number of sign-up conversions<br /><br />**Field Name:** `conversionSignUps`<br />**Type:** metric                                                   |
| <div>App Opens</div>             | Number of app open conversions<br /><br />**Field Name:** `conversionAppOpens`<br />**Type:** metric                                                 |
| <div>Page Views</div>            | Number of page-view conversions<br /><br />**Field Name:** `conversionPageViews`<br />**Type:** metric                                               |
| <div>Adds To Cart</div>          | Number of add-to-cart conversions<br /><br />**Field Name:** `conversionAddCart`<br />**Type:** metric                                               |
| <div>Checkouts Started</div>     | Number of checkout-started conversions<br /><br />**Field Name:** `conversionStartCheckout`<br />**Type:** metric                                    |
| <div>Searches</div>              | Number of search conversions<br /><br />**Field Name:** `conversionSearches`<br />**Type:** metric                                                   |
| <div>Subscriptions</div>         | Number of subscription conversions<br /><br />**Field Name:** `conversionSubscribe`<br />**Type:** metric                                            |
| <div>Logins</div>                | Number of login conversions<br /><br />**Field Name:** `conversionLogin`<br />**Type:** metric                                                       |
| <div>Conversion Shares</div>     | Number of share conversions<br /><br />**Field Name:** `conversionShare`<br />**Type:** metric                                                       |
| <div>Visits</div>                | Number of visit conversions<br /><br />**Field Name:** `conversionVisit`<br />**Type:** metric                                                       |
| <div>Tutorials Completed</div>   | Number of tutorial-completion conversions<br /><br />**Field Name:** `conversionCompleteTutorial`<br />**Type:** metric                              |
| <div>Invites</div>               | Number of invite conversions<br /><br />**Field Name:** `conversionInvite`<br />**Type:** metric                                                     |
| <div>Levels Completed</div>      | Number of level-completion conversions (game apps)<br /><br />**Field Name:** `conversionLevelCompletes`<br />**Type:** metric                       |
| <div>Achievements Unlocked</div> | Number of achievement-unlocked conversions<br /><br />**Field Name:** `conversionAchievementUnlocked`<br />**Type:** metric                          |
| <div>Adds To Wishlist</div>      | Number of add-to-wishlist conversions<br /><br />**Field Name:** `conversionAddToWishlist`<br />**Type:** metric                                     |
| <div>Trials Started</div>        | Number of trial-started conversions<br /><br />**Field Name:** `conversionStartTrial`<br />**Type:** metric                                          |
| <div>List Views</div>            | Number of list-view conversions<br /><br />**Field Name:** `conversionListView`<br />**Type:** metric                                                |
| <div>Credits Spent</div>         | Number of credits-spent conversions<br /><br />**Field Name:** `conversionSpendCredits`<br />**Type:** metric                                        |
| <div>Ad Clicks</div>             | Number of ad-click conversions<br /><br />**Field Name:** `conversionAdClick`<br />**Type:** metric                                                  |
| <div>Ad Views</div>              | Number of ad-view conversions<br /><br />**Field Name:** `conversionAdView`<br />**Type:** metric                                                    |
| <div>Billing Added</div>         | Number of add-billing conversions<br /><br />**Field Name:** `conversionAddBilling`<br />**Type:** metric                                            |
| <div>Reservations</div>          | Number of reservation conversions<br /><br />**Field Name:** `conversionReserve`<br />**Type:** metric                                               |
| <div>Conversion Saves</div>      | Number of save conversions (distinct from delivery saves)<br /><br />**Field Name:** `conversionSave`<br />**Type:** metric                          |
| <div>Conversion Rate</div>       | Calculated conversion rate (purchases / swipes)<br /><br />**Field Name:** `conversionRate`<br />**Type:** metric                                    |

### Conversion Values

|                                   |                                                                                                                                                          |
| --------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------- |
| <div>Purchase Value</div>         | Total monetary value of purchase conversions in account currency<br /><br />**Field Name:** `conversionPurchasesValue`<br />**Type:** metric             |
| <div>Subscription Value</div>     | Total monetary value of subscription conversions in account currency<br /><br />**Field Name:** `conversionSubscribeValue`<br />**Type:** metric         |
| <div>Add To Cart Value</div>      | Total monetary value of add-to-cart conversions in account currency<br /><br />**Field Name:** `conversionAddCartValue`<br />**Type:** metric            |
| <div>Checkout Started Value</div> | Total monetary value of checkout-started conversions in account currency<br /><br />**Field Name:** `conversionStartCheckoutValue`<br />**Type:** metric |

***

## Related

<CardGroup>
  <Card title="Fields Catalog" icon="book" href="/fields-catalog">
    Browse all platforms
  </Card>

  <Card title="Meta Ads Fields" icon="chart-bar" href="/data-source/facebook-ads/fields">
    Meta Ads metrics & dimensions
  </Card>

  <Card title="TikTok Ads Fields" icon="chart-bar" href="/data-source/tiktok-ads/fields">
    TikTok Ads metrics & dimensions
  </Card>

  <Card title="X Ads Fields" icon="chart-bar" href="/data-source/x-ads/fields">
    X Ads metrics & dimensions
  </Card>
</CardGroup>


# Stripe Metrics & Dimensions
Source: https://support.detrics.io/data-source/stripe/fields

Complete reference for Stripe payment dimensions and metrics

<Info>
  **Last updated:** August 6, 2026
</Info>

<div>
  <div>
    218 dimensions
  </div>

  <div>
    70 metrics
  </div>
</div>

This reference covers all available dimensions and metrics for Stripe data through Detrics. Use this guide to understand what data you can extract and how to structure your queries.

<div>
  <span>Supported destinations:</span>

  <div>
    Google Sheets
  </div>

  <div>
    Claude
  </div>

  <div>
    BigQuery
  </div>
</div>

## Dimensions

Dimensions are the attributes you can use to segment and group your Stripe data.

### Most Used

|                                |                                                                                                                                                                                        |
| ------------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| <div>Report Date</div>         | Detrics internal calculation. Date bucket for the SaaS metrics report (depends on time aggregation: daily or monthly)<br /><br />**Field Name:** `reportDate`<br />**Type:** dimension |
| <div>Subscription Status</div> | Current status: active, canceled, incomplete, incomplete\_expired, past\_due, paused, trialing, or unpaid<br /><br />**Field Name:** `subscriptionStatus`<br />**Type:** dimension     |
| <div>Plan Name</div>           | Name of the subscription plan (from plan nickname or product name)<br /><br />**Field Name:** `subscriptionItemPlanName`<br />**Type:** dimension                                      |
| <div>Plan Interval</div>       | Billing interval of the plan (month, year, week, day)<br /><br />**Field Name:** `subscriptionItemPlanInterval`<br />**Type:** dimension                                               |
| <div>Customer Name</div>       | Name of the customer<br /><br />**Field Name:** `customerName`<br />**Type:** dimension                                                                                                |
| <div>Customer Email</div>      | Email address of the customer<br /><br />**Field Name:** `customerEmail`<br />**Type:** dimension                                                                                      |
| <div>Status</div>              | Current status of the invoice (draft, open, paid, void, uncollectible)<br /><br />**Field Name:** `invoiceStatus`<br />**Type:** dimension                                             |
| <div>Charge Status</div>       | Status of the charge (succeeded, pending, failed)<br /><br />**Field Name:** `chargeStatus`<br />**Type:** dimension                                                                   |
| <div>Payment Method Type</div> | Type of payment method used (card, link, apple\_pay, google\_pay, bank\_transfer, etc.)<br /><br />**Field Name:** `chargePaymentMethodType`<br />**Type:** dimension                  |
| <div>Transaction Type</div>    | Type of transaction (charge, refund, payout, adjustment, transfer, etc.)<br /><br />**Field Name:** `balanceTransactionType`<br />**Type:** dimension                                  |

### SaaS Metrics

|                            |                                                                                                                                                               |
| -------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| <div>Report Currency</div> | Detrics internal calculation. Currency used for all monetary SaaS metrics in this report<br /><br />**Field Name:** `reportCurrency`<br />**Type:** dimension |

### Cohort Retention

|                                |                                                                                                                                                            |
| ------------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------- |
| <div>Cohort Month</div>        | Detrics internal calculation. The month when subscribers in this cohort first subscribed<br /><br />**Field Name:** `cohortMonth`<br />**Type:** dimension |
| <div>Cohort Age (Months)</div> | Detrics internal calculation. Number of months since the cohort started. 0 = signup month<br /><br />**Field Name:** `cohortAge`<br />**Type:** dimension  |

### Subscription

|                                    |                                                                                                                                                                                    |
| ---------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| <div>Subscription ID</div>         | Unique identifier for the subscription<br /><br />**Field Name:** `subscriptionId`<br />**Type:** dimension                                                                        |
| <div>Subscription Created At</div> | When the subscription was created<br /><br />**Field Name:** `subscriptionCreatedAt`<br />**Type:** dimension                                                                      |
| <div>Start Date</div>              | Date the subscription started (may differ from created date)<br /><br />**Field Name:** `subscriptionStartDate`<br />**Type:** dimension                                           |
| <div>Current Period Start</div>    | Start of the current billing period<br /><br />**Field Name:** `subscriptionCurrentPeriodStart`<br />**Type:** dimension                                                           |
| <div>Current Period End</div>      | End of the current billing period<br /><br />**Field Name:** `subscriptionCurrentPeriodEnd`<br />**Type:** dimension                                                               |
| <div>Currency</div>                | Currency of the subscription<br /><br />**Field Name:** `subscriptionCurrency`<br />**Type:** dimension                                                                            |
| <div>Cancelled At</div>            | When the subscription was cancelled<br /><br />**Field Name:** `subscriptionCancelledAt`<br />**Type:** dimension                                                                  |
| <div>Cancel At Period End</div>    | Whether the subscription will cancel at the end of the current period instead of immediately<br /><br />**Field Name:** `subscriptionCancelAtPeriodEnd`<br />**Type:** dimension   |
| <div>Ended At</div>                | When the subscription ended<br /><br />**Field Name:** `subscriptionEndedAt`<br />**Type:** dimension                                                                              |
| <div>Cancellation Reason</div>     | Reason for subscription cancellation<br /><br />**Field Name:** `subscriptionCancelledReason`<br />**Type:** dimension                                                             |
| <div>Cancellation Feedback</div>   | Customer feedback on cancellation (e.g., too\_expensive, missing\_features, switched\_service)<br /><br />**Field Name:** `subscriptionCancelledFeedback`<br />**Type:** dimension |
| <div>Cancellation Comment</div>    | Additional comments about cancellation<br /><br />**Field Name:** `subscriptionCancelledComment`<br />**Type:** dimension                                                          |
| <div>Has Discount</div>            | Whether the subscription has a discount applied<br /><br />**Field Name:** `subscriptionHasDiscount`<br />**Type:** dimension                                                      |
| <div>Collection Method</div>       | Method used to collect subscription payments<br /><br />**Field Name:** `subscriptionCollectionMethod`<br />**Type:** dimension                                                    |
| <div>Description</div>             | Description of the subscription<br /><br />**Field Name:** `subscriptionDescription`<br />**Type:** dimension                                                                      |
| <div>Billing Cycle Anchor</div>    | Date that determines when billing cycles begin<br /><br />**Field Name:** `subscriptionBillingCycleAnchor`<br />**Type:** dimension                                                |
| <div>Latest Invoice</div>          | ID of the most recent invoice for this subscription<br /><br />**Field Name:** `subscriptionLatestInvoice`<br />**Type:** dimension                                                |
| <div>Trial Start</div>             | Start date of the trial period<br /><br />**Field Name:** `subscriptionTrialStart`<br />**Type:** dimension                                                                        |
| <div>Trial End</div>               | End date of the trial period<br /><br />**Field Name:** `subscriptionTrialEnd`<br />**Type:** dimension                                                                            |
| <div>URL</div>                     | URL associated with the subscription<br /><br />**Field Name:** `subscriptionUrl`<br />**Type:** dimension                                                                         |
| <div>Item ID</div>                 | Identifier for subscription item<br /><br />**Field Name:** `subscriptionItemId`<br />**Type:** dimension                                                                          |
| <div>Item Created At</div>         | When the subscription item was created<br /><br />**Field Name:** `subscriptionItemCreated`<br />**Type:** dimension                                                               |
| <div>Plan ID</div>                 | Identifier for the subscription plan<br /><br />**Field Name:** `subscriptionItemPlanId`<br />**Type:** dimension                                                                  |
| <div>Plan Active</div>             | Whether the plan is active<br /><br />**Field Name:** `subscriptionItemPlanActive`<br />**Type:** dimension                                                                        |
| <div>Price ID</div>                | Identifier for the price<br /><br />**Field Name:** `subscriptionItemPriceId`<br />**Type:** dimension                                                                             |

### Customer

|                                |                                                                                                                      |
| ------------------------------ | -------------------------------------------------------------------------------------------------------------------- |
| <div>Customer ID</div>         | Unique identifier for the customer<br /><br />**Field Name:** `customerId`<br />**Type:** dimension                  |
| <div>Customer Phone</div>      | Phone number of the customer<br /><br />**Field Name:** `customerPhone`<br />**Type:** dimension                     |
| <div>Customer Currency</div>   | Preferred currency of the customer<br /><br />**Field Name:** `customerCurrency`<br />**Type:** dimension            |
| <div>Customer Created At</div> | Date customer was created<br /><br />**Field Name:** `customerCreatedAt`<br />**Type:** dimension                    |
| <div>Customer Delinquent</div> | Whether the customer has a past-due invoice<br /><br />**Field Name:** `customerDelinquent`<br />**Type:** dimension |
| <div>Customer City</div>       | City of the customer<br /><br />**Field Name:** `customerCity`<br />**Type:** dimension                              |
| <div>Customer Country</div>    | Country of the customer<br /><br />**Field Name:** `customerCountry`<br />**Type:** dimension                        |
| <div>Customer State</div>      | State or province of the customer<br /><br />**Field Name:** `customerState`<br />**Type:** dimension                |
| <div>Address Line 1</div>      | First line of customer address<br /><br />**Field Name:** `customerLine1`<br />**Type:** dimension                   |
| <div>Address Line 2</div>      | Second line of customer address<br /><br />**Field Name:** `customerLine2`<br />**Type:** dimension                  |
| <div>Postal Code</div>         | Postal code of the customer<br /><br />**Field Name:** `customerPostalCode`<br />**Type:** dimension                 |

### Invoice

|                                    |                                                                                                                                                             |
| ---------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------- |
| <div>Invoice ID</div>              | Unique identifier for the invoice<br /><br />**Field Name:** `invoiceId`<br />**Type:** dimension                                                           |
| <div>Number</div>                  | Invoice number<br /><br />**Field Name:** `invoiceNumber`<br />**Type:** dimension                                                                          |
| <div>Invoice Created At</div>      | When the invoice was created<br /><br />**Field Name:** `invoiceCreatedAt`<br />**Type:** dimension                                                         |
| <div>Currency</div>                | Currency of the invoice<br /><br />**Field Name:** `invoiceCurrency`<br />**Type:** dimension                                                               |
| <div>Billing Reason</div>          | Reason for the billing (subscription\_create, subscription\_cycle, manual, etc.)<br /><br />**Field Name:** `invoiceBillingReason`<br />**Type:** dimension |
| <div>Paid</div>                    | Whether the invoice has been paid<br /><br />**Field Name:** `invoicePaid`<br />**Type:** dimension                                                         |
| <div>Due Date</div>                | Due date for the invoice<br /><br />**Field Name:** `invoiceDueDate`<br />**Type:** dimension                                                               |
| <div>Period Start</div>            | Start of the invoice period<br /><br />**Field Name:** `invoicePeriodStart`<br />**Type:** dimension                                                        |
| <div>Period End</div>              | End of the invoice period<br /><br />**Field Name:** `invoicePeriodEnd`<br />**Type:** dimension                                                            |
| <div>Collection Method</div>       | Method used to collect payment (charge\_automatically or send\_invoice)<br /><br />**Field Name:** `invoiceCollectionMethod`<br />**Type:** dimension       |
| <div>Subscription</div>            | Associated subscription ID<br /><br />**Field Name:** `invoiceSubscription`<br />**Type:** dimension                                                        |
| <div>Invoice Account Country</div> | Country of the account<br /><br />**Field Name:** `invoiceAccountCountry`<br />**Type:** dimension                                                          |
| <div>Invoice Account Name</div>    | Name of the account<br /><br />**Field Name:** `invoiceAccountName`<br />**Type:** dimension                                                                |
| <div>Account Tax IDs</div>         | Tax IDs associated with the account<br /><br />**Field Name:** `invoiceAccountTaxIds`<br />**Type:** dimension                                              |
| <div>Application</div>             | Application associated with the invoice<br /><br />**Field Name:** `invoiceApplication`<br />**Type:** dimension                                            |
| <div>Custom Fields</div>           | Custom fields added to the invoice<br /><br />**Field Name:** `invoiceCustomFields`<br />**Type:** dimension                                                |
| <div>Description</div>             | Description of the invoice<br /><br />**Field Name:** `invoiceDescription`<br />**Type:** dimension                                                         |
| <div>Effective At</div>            | When the invoice becomes effective<br /><br />**Field Name:** `invoiceEffectiveAt`<br />**Type:** dimension                                                 |
| <div>Ending Balance</div>          | Ending balance of the invoice<br /><br />**Field Name:** `invoiceEndingBalance`<br />**Type:** dimension                                                    |
| <div>Footer</div>                  | Footer text of the invoice<br /><br />**Field Name:** `invoiceFooter`<br />**Type:** dimension                                                              |
| <div>Hosted URL</div>              | URL where the invoice can be viewed<br /><br />**Field Name:** `invoiceHostedUrl`<br />**Type:** dimension                                                  |
| <div>PDF</div>                     | URL to download the invoice PDF<br /><br />**Field Name:** `invoicePdf`<br />**Type:** dimension                                                            |
| <div>Receipt Number</div>          | Receipt number for the invoice<br /><br />**Field Name:** `invoiceReceiptNumber`<br />**Type:** dimension                                                   |
| <div>Next Payment Attempt</div>    | When the next payment attempt will be made<br /><br />**Field Name:** `invoiceNextPaymentAttempt`<br />**Type:** dimension                                  |

### Charge

|                                 |                                                                                                                                                             |
| ------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------- |
| <div>Charge ID</div>            | Unique identifier for the charge<br /><br />**Field Name:** `chargeId`<br />**Type:** dimension                                                             |
| <div>Charge Created At</div>    | When the charge was created<br /><br />**Field Name:** `chargeCreatedAt`<br />**Type:** dimension                                                           |
| <div>Charge Currency</div>      | Currency of the charge<br /><br />**Field Name:** `chargeCurrency`<br />**Type:** dimension                                                                 |
| <div>Charge Paid</div>          | Whether the charge was paid<br /><br />**Field Name:** `chargePaid`<br />**Type:** dimension                                                                |
| <div>Charge Refunded</div>      | Whether the charge was fully refunded<br /><br />**Field Name:** `chargeRefunded`<br />**Type:** dimension                                                  |
| <div>Charge Captured</div>      | Whether the charge was captured (authorized charges may not be captured yet)<br /><br />**Field Name:** `chargeCaptured`<br />**Type:** dimension           |
| <div>Charge Disputed</div>      | Whether the charge is disputed<br /><br />**Field Name:** `chargeDisputed`<br />**Type:** dimension                                                         |
| <div>Card Brand</div>           | Card brand (visa, mastercard, amex, etc.)<br /><br />**Field Name:** `chargeCardBrand`<br />**Type:** dimension                                             |
| <div>Card Last 4</div>          | Last 4 digits of the card number<br /><br />**Field Name:** `chargeCardLast4`<br />**Type:** dimension                                                      |
| <div>Card Funding</div>         | Card funding type (credit, debit, prepaid, unknown)<br /><br />**Field Name:** `chargeCardFunding`<br />**Type:** dimension                                 |
| <div>Card Country</div>         | Country where the card was issued<br /><br />**Field Name:** `chargeCardCountry`<br />**Type:** dimension                                                   |
| <div>Failure Code</div>         | Error code for failed charges (e.g., card\_declined, expired\_card)<br /><br />**Field Name:** `chargeFailureCode`<br />**Type:** dimension                 |
| <div>Failure Message</div>      | Human-readable message for charge failure<br /><br />**Field Name:** `chargeFailureMessage`<br />**Type:** dimension                                        |
| <div>Receipt Email</div>        | Email where the receipt was sent<br /><br />**Field Name:** `chargeReceiptEmail`<br />**Type:** dimension                                                   |
| <div>Receipt Number</div>       | Receipt number for the charge<br /><br />**Field Name:** `chargeReceiptNumber`<br />**Type:** dimension                                                     |
| <div>Statement Descriptor</div> | How the charge appears on bank/card statements<br /><br />**Field Name:** `chargeStatementDescriptor`<br />**Type:** dimension                              |
| <div>Payment Method ID</div>    | ID of the payment method used<br /><br />**Field Name:** `chargePaymentMethod`<br />**Type:** dimension                                                     |
| <div>Charge Description</div>   | Description of the charge<br /><br />**Field Name:** `chargeDescription`<br />**Type:** dimension                                                           |
| <div>Outcome Type</div>         | Charge outcome type (authorized, manual\_review, blocked, etc.)<br /><br />**Field Name:** `chargeOutcomeType`<br />**Type:** dimension                     |
| <div>Risk Level</div>           | Risk level assessed by Stripe Radar (normal, elevated, highest, not\_assessed)<br /><br />**Field Name:** `chargeOutcomeRiskLevel`<br />**Type:** dimension |
| <div>Outcome Message</div>      | Stripe Radar message explaining the charge outcome<br /><br />**Field Name:** `chargeOutcomeSellerMessage`<br />**Type:** dimension                         |

### Payment

|                                      |                                                                                                                                                                         |
| ------------------------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| <div>Payment ID</div>                | Unique identifier for the payment intent<br /><br />**Field Name:** `paymentId`<br />**Type:** dimension                                                                |
| <div>Payment Created At</div>        | When the payment intent was created<br /><br />**Field Name:** `paymentCreatedAt`<br />**Type:** dimension                                                              |
| <div>Status</div>                    | Current status (requires\_payment\_method, requires\_confirmation, processing, succeeded, canceled)<br /><br />**Field Name:** `paymentStatus`<br />**Type:** dimension |
| <div>Application</div>               | Application associated with the payment<br /><br />**Field Name:** `paymentApplication`<br />**Type:** dimension                                                        |
| <div>Automatic Payment Methods</div> | Available automatic payment methods<br /><br />**Field Name:** `paymentAutomaticPaymentMethods`<br />**Type:** dimension                                                |
| <div>Cancelled At</div>              | When the payment was cancelled<br /><br />**Field Name:** `paymentCancelledAt`<br />**Type:** dimension                                                                 |
| <div>Cancellation Reason</div>       | Reason for payment cancellation<br /><br />**Field Name:** `paymentCancellationReason`<br />**Type:** dimension                                                         |
| <div>Capture Method</div>            | Method used to capture payment (automatic or manual)<br /><br />**Field Name:** `paymentCaptureMethod`<br />**Type:** dimension                                         |
| <div>Client Secret</div>             | Client secret for payment intent<br /><br />**Field Name:** `paymentClientSecret`<br />**Type:** dimension                                                              |
| <div>Confirmation Method</div>       | Method used to confirm payment (automatic or manual)<br /><br />**Field Name:** `paymentConfirmationMethod`<br />**Type:** dimension                                    |
| <div>Currency</div>                  | Currency of the payment<br /><br />**Field Name:** `paymentCurrency`<br />**Type:** dimension                                                                           |
| <div>Description</div>               | Payment description<br /><br />**Field Name:** `paymentDescription`<br />**Type:** dimension                                                                            |
| <div>Latest Charge</div>             | ID of the latest charge<br /><br />**Field Name:** `paymentLatestCharge`<br />**Type:** dimension                                                                       |
| <div>Live Mode</div>                 | Whether the payment is in live mode<br /><br />**Field Name:** `paymentLivemode`<br />**Type:** dimension                                                               |
| <div>Method Types</div>              | Available payment method types<br /><br />**Field Name:** `paymentMethodTypes`<br />**Type:** dimension                                                                 |
| <div>Receipt Email</div>             | Email where receipt was sent<br /><br />**Field Name:** `paymentReceiptEmail`<br />**Type:** dimension                                                                  |
| <div>Review</div>                    | Payment review status<br /><br />**Field Name:** `paymentReview`<br />**Type:** dimension                                                                               |
| <div>Shipping</div>                  | Shipping details for payment<br /><br />**Field Name:** `paymentShipping`<br />**Type:** dimension                                                                      |
| <div>Source</div>                    | Payment source information<br /><br />**Field Name:** `paymentSource`<br />**Type:** dimension                                                                          |

### Refund

|                                     |                                                                                                                                           |
| ----------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------- |
| <div>Refund ID</div>                | Unique identifier for the refund<br /><br />**Field Name:** `refundId`<br />**Type:** dimension                                           |
| <div>Refund Created At</div>        | When the refund was created<br /><br />**Field Name:** `refundCreatedAt`<br />**Type:** dimension                                         |
| <div>Refund Status</div>            | Status of the refund (succeeded, pending, failed, canceled)<br /><br />**Field Name:** `refundStatus`<br />**Type:** dimension            |
| <div>Refund Currency</div>          | Currency of the refund<br /><br />**Field Name:** `refundCurrency`<br />**Type:** dimension                                               |
| <div>Refund Reason</div>            | Reason for the refund (duplicate, fraudulent, requested\_by\_customer)<br /><br />**Field Name:** `refundReason`<br />**Type:** dimension |
| <div>Refund Charge ID</div>         | ID of the original charge that was refunded<br /><br />**Field Name:** `refundChargeId`<br />**Type:** dimension                          |
| <div>Refund Payment Intent ID</div> | ID of the payment intent associated with the refund<br /><br />**Field Name:** `refundPaymentIntentId`<br />**Type:** dimension           |

### Balance Transaction

|                                    |                                                                                                                                         |
| ---------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------- |
| <div>Transaction ID</div>          | Unique identifier for the balance transaction<br /><br />**Field Name:** `balanceTransactionId`<br />**Type:** dimension                |
| <div>Transaction Created At</div>  | When the balance transaction was created<br /><br />**Field Name:** `balanceTransactionCreated`<br />**Type:** dimension                |
| <div>Reporting Category</div>      | Reporting category for financial reports<br /><br />**Field Name:** `balanceTransactionReportingCategory`<br />**Type:** dimension      |
| <div>Transaction Status</div>      | Status of the balance transaction (available or pending)<br /><br />**Field Name:** `balanceTransactionStatus`<br />**Type:** dimension |
| <div>Transaction Currency</div>    | Currency of the balance transaction<br /><br />**Field Name:** `balanceTransactionCurrency`<br />**Type:** dimension                    |
| <div>Transaction Description</div> | Description of the balance transaction<br /><br />**Field Name:** `balanceTransactionDescription`<br />**Type:** dimension              |

### Payout

|                               |                                                                                                                                        |
| ----------------------------- | -------------------------------------------------------------------------------------------------------------------------------------- |
| <div>Payout ID</div>          | Unique identifier for the payout<br /><br />**Field Name:** `payoutId`<br />**Type:** dimension                                        |
| <div>Payout Created At</div>  | When the payout was created<br /><br />**Field Name:** `payoutCreatedAt`<br />**Type:** dimension                                      |
| <div>Payout Status</div>      | Status of the payout (paid, pending, in\_transit, canceled, failed)<br /><br />**Field Name:** `payoutStatus`<br />**Type:** dimension |
| <div>Payout Currency</div>    | Currency of the payout<br /><br />**Field Name:** `payoutCurrency`<br />**Type:** dimension                                            |
| <div>Payout Method</div>      | Method used (standard or instant)<br /><br />**Field Name:** `payoutMethod`<br />**Type:** dimension                                   |
| <div>Payout Type</div>        | Type of payout (bank\_account or card)<br /><br />**Field Name:** `payoutType`<br />**Type:** dimension                                |
| <div>Payout Description</div> | Description of the payout<br /><br />**Field Name:** `payoutDescription`<br />**Type:** dimension                                      |
| <div>Arrival Date</div>       | Date the payout is expected to arrive in the bank account<br /><br />**Field Name:** `payoutArrivalDate`<br />**Type:** dimension      |
| <div>Automatic</div>          | Whether the payout was created by an automated schedule<br /><br />**Field Name:** `payoutAutomatic`<br />**Type:** dimension          |
| <div>Failure Code</div>       | Error code for failed payouts<br /><br />**Field Name:** `payoutFailureCode`<br />**Type:** dimension                                  |
| <div>Failure Message</div>    | Human-readable message for payout failure<br /><br />**Field Name:** `payoutFailureMessage`<br />**Type:** dimension                   |

### Event

|                                          |                                                                                                                                                         |
| ---------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------- |
| <div>Event ID</div>                      | Unique identifier for the event<br /><br />**Field Name:** `eventId`<br />**Type:** dimension                                                           |
| <div>Event Type</div>                    | Type of event (e.g., customer.subscription.created, charge.succeeded, invoice.paid)<br /><br />**Field Name:** `eventType`<br />**Type:** dimension     |
| <div>Event Created At</div>              | When the event occurred. Note: Stripe retains events for 30 days only<br /><br />**Field Name:** `eventCreatedAt`<br />**Type:** dimension              |
| <div>Event Livemode</div>                | Whether the event occurred in live mode<br /><br />**Field Name:** `eventLivemode`<br />**Type:** dimension                                             |
| <div>Resource Type</div>                 | Type of Stripe object affected (subscription, charge, invoice, customer, etc.)<br /><br />**Field Name:** `eventResourceType`<br />**Type:** dimension  |
| <div>Resource ID</div>                   | ID of the Stripe object affected by this event<br /><br />**Field Name:** `eventResourceId`<br />**Type:** dimension                                    |
| <div>Event Customer ID</div>             | Customer ID associated with the event<br /><br />**Field Name:** `eventCustomerId`<br />**Type:** dimension                                             |
| <div>Event Customer Email</div>          | Customer email associated with the event<br /><br />**Field Name:** `eventCustomerEmail`<br />**Type:** dimension                                       |
| <div>Event Customer Name</div>           | Customer name associated with the event<br /><br />**Field Name:** `eventCustomerName`<br />**Type:** dimension                                         |
| <div>Event Subscription Status</div>     | Subscription status at the time of the event<br /><br />**Field Name:** `eventSubscriptionStatus`<br />**Type:** dimension                              |
| <div>Event Plan Interval</div>           | Plan billing interval at the time of the event<br /><br />**Field Name:** `eventSubscriptionPlanInterval`<br />**Type:** dimension                      |
| <div>Event Charge Status</div>           | Charge status at the time of the event<br /><br />**Field Name:** `eventChargeStatus`<br />**Type:** dimension                                          |
| <div>Event Charge Currency</div>         | Currency of the charge in the event<br /><br />**Field Name:** `eventChargeCurrency`<br />**Type:** dimension                                           |
| <div>Event Invoice Status</div>          | Invoice status at the time of the event<br /><br />**Field Name:** `eventInvoiceStatus`<br />**Type:** dimension                                        |
| <div>Previous Subscription Status</div>  | Subscription status before the change (from previous\_attributes)<br /><br />**Field Name:** `eventPreviousSubscriptionStatus`<br />**Type:** dimension |
| <div>New Subscription Status</div>       | Subscription status after the change<br /><br />**Field Name:** `eventNewSubscriptionStatus`<br />**Type:** dimension                                   |
| <div>Previous Cancel At Period End</div> | Cancel-at-period-end flag before the change<br /><br />**Field Name:** `eventPreviousCancelAtPeriodEnd`<br />**Type:** dimension                        |
| <div>New Cancel At Period End</div>      | Cancel-at-period-end flag after the change<br /><br />**Field Name:** `eventNewCancelAtPeriodEnd`<br />**Type:** dimension                              |
| <div>Previous Plan Interval</div>        | Plan interval before the change (useful for upgrade/downgrade tracking)<br /><br />**Field Name:** `eventPreviousPlanInterval`<br />**Type:** dimension |
| <div>New Plan Interval</div>             | Plan interval after the change<br /><br />**Field Name:** `eventNewPlanInterval`<br />**Type:** dimension                                               |
| <div>Previous Customer Delinquent</div>  | Customer delinquent status before the change<br /><br />**Field Name:** `eventPreviousCustomerDelinquent`<br />**Type:** dimension                      |
| <div>New Customer Delinquent</div>       | Customer delinquent status after the change<br /><br />**Field Name:** `eventNewCustomerDelinquent`<br />**Type:** dimension                            |
| <div>Previous Default Source</div>       | Customer default payment source before the change<br /><br />**Field Name:** `eventPreviousCustomerDefaultSource`<br />**Type:** dimension              |
| <div>New Default Source</div>            | Customer default payment source after the change<br /><br />**Field Name:** `eventNewCustomerDefaultSource`<br />**Type:** dimension                    |
| <div>Previous Invoice Status</div>       | Invoice status before the change<br /><br />**Field Name:** `eventPreviousInvoiceStatus`<br />**Type:** dimension                                       |
| <div>New Invoice Status</div>            | Invoice status after the change<br /><br />**Field Name:** `eventNewInvoiceStatus`<br />**Type:** dimension                                             |

### Product

|                                 |                                                                                                                                           |
| ------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------- |
| <div>Product ID</div>           | Unique identifier for the product<br /><br />**Field Name:** `productId`<br />**Type:** dimension                                         |
| <div>Name</div>                 | Product name<br /><br />**Field Name:** `productName`<br />**Type:** dimension                                                            |
| <div>Active</div>               | Whether the product is active<br /><br />**Field Name:** `productActive`<br />**Type:** dimension                                         |
| <div>Description</div>          | Product description<br /><br />**Field Name:** `productDescription`<br />**Type:** dimension                                              |
| <div>Type</div>                 | Type of product (good or service)<br /><br />**Field Name:** `productType`<br />**Type:** dimension                                       |
| <div>Images</div>               | Product image URLs<br /><br />**Field Name:** `productImages`<br />**Type:** dimension                                                    |
| <div>Attributes</div>           | Product attributes<br /><br />**Field Name:** `productAttributes`<br />**Type:** dimension                                                |
| <div>Marketing Features</div>   | Marketing feature names listed for the product<br /><br />**Field Name:** `productMarketingFeatures`<br />**Type:** dimension             |
| <div>Package Dimensions</div>   | Physical dimensions of the product package (HxWxL, weight)<br /><br />**Field Name:** `productPackageDimensions`<br />**Type:** dimension |
| <div>Shippable</div>            | Whether the product can be shipped<br /><br />**Field Name:** `productShippable`<br />**Type:** dimension                                 |
| <div>Statement Descriptor</div> | How the product appears on statements<br /><br />**Field Name:** `productStatementDescriptor`<br />**Type:** dimension                    |
| <div>Tax Code</div>             | Tax code for the product<br /><br />**Field Name:** `productTaxCode`<br />**Type:** dimension                                             |
| <div>Unit Label</div>           | Label for product units<br /><br />**Field Name:** `productUnitLabel`<br />**Type:** dimension                                            |
| <div>URL</div>                  | URL for the product<br /><br />**Field Name:** `productUrl`<br />**Type:** dimension                                                      |
| <div>Updated</div>              | Timestamp when the product was last updated<br /><br />**Field Name:** `productUpdated`<br />**Type:** dimension                          |
| <div>Product Created At</div>   | When the product was created<br /><br />**Field Name:** `productCreatedAt`<br />**Type:** dimension                                       |

### Coupon

|                               |                                                                                                                                                 |
| ----------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------- |
| <div>Coupon ID</div>          | Unique identifier for the coupon<br /><br />**Field Name:** `couponId`<br />**Type:** dimension                                                 |
| <div>Name</div>               | Name of the coupon<br /><br />**Field Name:** `couponName`<br />**Type:** dimension                                                             |
| <div>Coupon Created At</div>  | When the coupon was created<br /><br />**Field Name:** `couponCreatedAt`<br />**Type:** dimension                                               |
| <div>Duration</div>           | Duration of the coupon (forever, once, repeating)<br /><br />**Field Name:** `couponDuration`<br />**Type:** dimension                          |
| <div>Duration in Months</div> | Number of months the coupon is valid for (when duration=repeating)<br /><br />**Field Name:** `couponDurationInMonths`<br />**Type:** dimension |
| <div>Currency</div>           | Currency of the coupon (for amount-off coupons)<br /><br />**Field Name:** `couponCurrency`<br />**Type:** dimension                            |
| <div>Max Redemptions</div>    | Maximum number of times this coupon can be redeemed<br /><br />**Field Name:** `couponMaxRedemptions`<br />**Type:** dimension                  |
| <div>Live Mode</div>          | Whether the coupon is in live mode<br /><br />**Field Name:** `couponLiveMode`<br />**Type:** dimension                                         |
| <div>Valid</div>              | Whether the coupon is still valid<br /><br />**Field Name:** `couponValid`<br />**Type:** dimension                                             |

### Promotion Code

|                                      |                                                                                                                        |
| ------------------------------------ | ---------------------------------------------------------------------------------------------------------------------- |
| <div>Promotion Code ID</div>         | Unique identifier for the promotion code<br /><br />**Field Name:** `promotionCodeId`<br />**Type:** dimension         |
| <div>Promotion Code</div>            | The code customers enter at checkout<br /><br />**Field Name:** `promotionCode`<br />**Type:** dimension               |
| <div>Active</div>                    | Whether the promotion code is active<br /><br />**Field Name:** `promotionCodeActive`<br />**Type:** dimension         |
| <div>Promotion Code Created At</div> | When the promotion code was created<br /><br />**Field Name:** `promotionCodeCreatedAt`<br />**Type:** dimension       |
| <div>Expires At</div>                | When the promotion code expires<br /><br />**Field Name:** `promotionCodeExpiredAt`<br />**Type:** dimension           |
| <div>Livemode</div>                  | Whether the promotion code is in live mode<br /><br />**Field Name:** `promotionCodeLivemode`<br />**Type:** dimension |

### Account

|                                |                                                                                                                             |
| ------------------------------ | --------------------------------------------------------------------------------------------------------------------------- |
| <div>Account ID</div>          | Unique identifier for the Stripe account<br /><br />**Field Name:** `accountId`<br />**Type:** dimension                    |
| <div>Annual Revenue</div>      | Annual revenue of the account<br /><br />**Field Name:** `accountAnnualRevenue`<br />**Type:** dimension                    |
| <div>Product Description</div> | Description of account products/services<br /><br />**Field Name:** `accountProductDescription`<br />**Type:** dimension    |
| <div>Support Email</div>       | Support email address for the account<br /><br />**Field Name:** `accountSupportEmail`<br />**Type:** dimension             |
| <div>Account Created At</div>  | Date the Stripe account was created<br /><br />**Field Name:** `accountCreatedAt`<br />**Type:** dimension                  |
| <div>Support Phone</div>       | Support phone number for the account<br /><br />**Field Name:** `accountSupportPhone`<br />**Type:** dimension              |
| <div>Support URL</div>         | Support website URL for the account<br /><br />**Field Name:** `accountSupportUrl`<br />**Type:** dimension                 |
| <div>Account URL</div>         | Website URL of the account<br /><br />**Field Name:** `accountUrl`<br />**Type:** dimension                                 |
| <div>Business Type</div>       | Type of business for the account<br /><br />**Field Name:** `accountBusinessType`<br />**Type:** dimension                  |
| <div>City</div>                | City of the account<br /><br />**Field Name:** `accountCity`<br />**Type:** dimension                                       |
| <div>Country</div>             | Country of the account<br /><br />**Field Name:** `accountCountry`<br />**Type:** dimension                                 |
| <div>Address Line 1</div>      | First line of account address<br /><br />**Field Name:** `accountLine1`<br />**Type:** dimension                            |
| <div>Address Line 2</div>      | Second line of account address<br /><br />**Field Name:** `accountLine2`<br />**Type:** dimension                           |
| <div>Postal Code</div>         | Postal code of the account<br /><br />**Field Name:** `accountPostalCode`<br />**Type:** dimension                          |
| <div>State</div>               | State or province of the account<br /><br />**Field Name:** `accountState`<br />**Type:** dimension                         |
| <div>Business Name</div>       | Business name of the account<br /><br />**Field Name:** `accountBusinessName`<br />**Type:** dimension                      |
| <div>Company Name</div>        | Company name of the account<br /><br />**Field Name:** `accountCompanyName`<br />**Type:** dimension                        |
| <div>Owners Provided</div>     | Whether account owners information was provided<br /><br />**Field Name:** `accountOwnersProvided`<br />**Type:** dimension |
| <div>Phone</div>               | Phone number of the account<br /><br />**Field Name:** `accountPhone`<br />**Type:** dimension                              |
| <div>Structure</div>           | Business structure of the account<br /><br />**Field Name:** `accountStructure`<br />**Type:** dimension                    |
| <div>Default Currency</div>    | Default currency used by the account<br /><br />**Field Name:** `accountDefaultCurrency`<br />**Type:** dimension           |
| <div>Details Submitted</div>   | Whether account details were submitted<br /><br />**Field Name:** `accountDetailsSubmitted`<br />**Type:** dimension        |
| <div>Email</div>               | Email address of the account<br /><br />**Field Name:** `accountEmail`<br />**Type:** dimension                             |
| <div>Account Type</div>        | Type of the account<br /><br />**Field Name:** `accountType`<br />**Type:** dimension                                       |

## Metrics

Metrics are the numerical values you can measure and analyze from your Stripe campaigns.

### Most Used

|                                 |                                                                                                                                                                                                                                    |
| ------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| <div>MRR</div>                  | Detrics internal calculation. Monthly Recurring Revenue: sum of all active subscription plan amounts normalized to monthly. May differ slightly from Stripe dashboard<br /><br />**Field Name:** `reportMrr`<br />**Type:** metric |
| <div>ARR</div>                  | Detrics internal calculation. Annual Recurring Revenue (MRR x 12)<br /><br />**Field Name:** `reportArr`<br />**Type:** metric                                                                                                     |
| <div>Active Subscriptions</div> | Detrics internal calculation. Count of subscriptions with status "active" at each time bucket<br /><br />**Field Name:** `reportActiveSubscriptions`<br />**Type:** metric                                                         |
| <div>Churn Rate</div>           | Detrics internal calculation. Percentage of subscriptions lost (churned / previous active)<br /><br />**Field Name:** `reportChurnRate`<br />**Type:** metric                                                                      |
| <div>Gross Revenue</div>        | Detrics internal calculation. Total revenue from successful charges in this period<br /><br />**Field Name:** `reportGrossRevenue`<br />**Type:** metric                                                                           |
| <div>Net Revenue</div>          | Detrics internal calculation. Gross revenue minus refunds<br /><br />**Field Name:** `reportNetRevenue`<br />**Type:** metric                                                                                                      |
| <div>Charge Amount</div>        | Total amount of the charge<br /><br />**Field Name:** `chargeAmount`<br />**Type:** metric                                                                                                                                         |
| <div>Total</div>                | Total amount including tax and discounts<br /><br />**Field Name:** `invoiceTotal`<br />**Type:** metric                                                                                                                           |
| <div>Net Amount</div>           | Net amount after fees (amount minus fee)<br /><br />**Field Name:** `balanceTransactionNet`<br />**Type:** metric                                                                                                                  |
| <div>Plan Amount</div>          | Amount for the subscription plan<br /><br />**Field Name:** `subscriptionItemPlanAmount`<br />**Type:** metric                                                                                                                     |

### SaaS Metrics

|                                     |                                                                                                                                                                                  |
| ----------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| <div>New Subscriptions</div>        | Detrics internal calculation. Count of subscriptions created during this period<br /><br />**Field Name:** `reportNewSubscriptions`<br />**Type:** metric                        |
| <div>New MRR</div>                  | Detrics internal calculation. MRR from subscriptions created during this period<br /><br />**Field Name:** `reportNewMrr`<br />**Type:** metric                                  |
| <div>Net New MRR</div>              | Detrics internal calculation. New MRR minus Churned MRR. Positive = growth<br /><br />**Field Name:** `reportNetNewMrr`<br />**Type:** metric                                    |
| <div>Churned Subscriptions</div>    | Detrics internal calculation. Count of subscriptions that were canceled during this period<br /><br />**Field Name:** `reportChurnedSubscriptions`<br />**Type:** metric         |
| <div>Churned MRR</div>              | Detrics internal calculation. MRR lost from churned subscriptions during this period<br /><br />**Field Name:** `reportChurnedMrr`<br />**Type:** metric                         |
| <div>MRR Before Discounts</div>     | Detrics internal calculation. MRR before applying any coupon discounts<br /><br />**Field Name:** `reportMrrBeforeDiscounts`<br />**Type:** metric                               |
| <div>Discount Amount</div>          | Detrics internal calculation. Total monthly discount amount across all active discounted subscriptions<br /><br />**Field Name:** `reportDiscountAmount`<br />**Type:** metric   |
| <div>Discounted Subscriptions</div> | Detrics internal calculation. Count of active subscriptions with a coupon applied<br /><br />**Field Name:** `reportDiscountedSubscriptions`<br />**Type:** metric               |
| <div>Active Customers</div>         | Detrics internal calculation. Count of unique customers with at least one active subscription<br /><br />**Field Name:** `reportActiveCustomers`<br />**Type:** metric           |
| <div>ARPU</div>                     | Detrics internal calculation. Average Revenue Per User (MRR / active subscribers)<br /><br />**Field Name:** `reportArpu`<br />**Type:** metric                                  |
| <div>Lifetime Value</div>           | Detrics internal calculation. Subscriber Lifetime Value (ARPU / churn rate). Estimates total revenue per subscriber<br /><br />**Field Name:** `reportLtv`<br />**Type:** metric |
| <div>Total Refunds</div>            | Detrics internal calculation. Total refund amount in this period<br /><br />**Field Name:** `reportTotalRefunds`<br />**Type:** metric                                           |
| <div>Refund Count</div>             | Detrics internal calculation. Number of refunds processed in this period<br /><br />**Field Name:** `reportRefundCount`<br />**Type:** metric                                    |
| <div>Payment Success Rate</div>     | Detrics internal calculation. Percentage of successful charges out of total charges<br /><br />**Field Name:** `reportPaymentSuccessRate`<br />**Type:** metric                  |
| <div>Total Payments</div>           | Detrics internal calculation. Total number of charge attempts in this period<br /><br />**Field Name:** `reportTotalPayments`<br />**Type:** metric                              |

### Cohort Retention

|                                     |                                                                                                                                                                               |
| ----------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| <div>Cohort Start Subscribers</div> | Detrics internal calculation. Number of subscribers when the cohort started<br /><br />**Field Name:** `cohortStartCount`<br />**Type:** metric                               |
| <div>Cohort Start MRR</div>         | Detrics internal calculation. MRR from this cohort when they first subscribed<br /><br />**Field Name:** `cohortStartMrr`<br />**Type:** metric                               |
| <div>Subscriber Retention %</div>   | Detrics internal calculation. Percentage of original subscribers still active at each cohort age<br /><br />**Field Name:** `cohortSubscriberRetention`<br />**Type:** metric |
| <div>Revenue Retention %</div>      | Detrics internal calculation. Percentage of original MRR still retained at each cohort age<br /><br />**Field Name:** `cohortRevenueRetention`<br />**Type:** metric          |

### Subscription

|                                 |                                                                                                                                              |
| ------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------- |
| <div>Total Subscriptions</div>  | Total number of subscriptions<br /><br />**Field Name:** `subscriptionTotalCount`<br />**Type:** metric                                      |
| <div>Unit Price</div>           | Price per unit for the subscription<br /><br />**Field Name:** `subscriptionItemPriceUnitAmount`<br />**Type:** metric                       |
| <div>Quantity</div>             | Number of units on the subscription<br /><br />**Field Name:** `subscriptionQuantity`<br />**Type:** metric                                  |
| <div>Discount Percent Off</div> | Percentage discount applied to the subscription via coupon<br /><br />**Field Name:** `subscriptionDiscountPercentOff`<br />**Type:** metric |

### Invoice

|                                      |                                                                                                                            |
| ------------------------------------ | -------------------------------------------------------------------------------------------------------------------------- |
| <div>Amount Due</div>                | Total amount due on the invoice<br /><br />**Field Name:** `invoiceAmountDue`<br />**Type:** metric                        |
| <div>Amount Paid</div>               | Amount already paid on the invoice<br /><br />**Field Name:** `invoiceAmountPaid`<br />**Type:** metric                    |
| <div>Amount Remaining</div>          | Remaining amount to be paid<br /><br />**Field Name:** `invoiceAmountRemaining`<br />**Type:** metric                      |
| <div>Subtotal</div>                  | Subtotal amount before tax and discounts<br /><br />**Field Name:** `invoiceSubtotal`<br />**Type:** metric                |
| <div>Subtotal Excl. Tax</div>        | Subtotal amount excluding tax<br /><br />**Field Name:** `invoiceSubtotalExcludingTax`<br />**Type:** metric               |
| <div>Tax</div>                       | Tax amount on the invoice<br /><br />**Field Name:** `invoiceTax`<br />**Type:** metric                                    |
| <div>Total Discounts</div>           | Total amount of discounts applied<br /><br />**Field Name:** `invoiceTotalDiscountAmounts`<br />**Type:** metric           |
| <div>Total Excl. Tax</div>           | Total amount excluding tax<br /><br />**Field Name:** `invoiceTotalExcludingTax`<br />**Type:** metric                     |
| <div>Total Pretax Credits</div>      | Total amount of pretax credits<br /><br />**Field Name:** `invoiceTotalPretaxCreditAmounts`<br />**Type:** metric          |
| <div>Total Tax Amounts</div>         | Total of all tax amounts<br /><br />**Field Name:** `invoicetotalTaxAmounts`<br />**Type:** metric                         |
| <div>Shipping Amount</div>           | Shipping cost on the invoice<br /><br />**Field Name:** `invoiceAmountShipping`<br />**Type:** metric                      |
| <div>Post-Payment Credit Notes</div> | Amount of post-payment credit notes<br /><br />**Field Name:** `invoicePostPaymentCreditNotesAmount`<br />**Type:** metric |
| <div>Pre-Payment Credit Notes</div>  | Amount of pre-payment credit notes<br /><br />**Field Name:** `invoicePrePaymentCreditNotesAmount`<br />**Type:** metric   |
| <div>Line Item Quantity</div>        | Quantity of items in the invoice line<br /><br />**Field Name:** `invoiceLineQuantity`<br />**Type:** metric               |

### Charge

|                            |                                                                                                                                                        |
| -------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------ |
| <div>Amount Captured</div> | Amount captured from the charge (may be less than total if partially captured)<br /><br />**Field Name:** `chargeAmountCaptured`<br />**Type:** metric |
| <div>Amount Refunded</div> | Amount refunded from the charge<br /><br />**Field Name:** `chargeAmountRefunded`<br />**Type:** metric                                                |

### Payment

|                            |                                                                                                                    |
| -------------------------- | ------------------------------------------------------------------------------------------------------------------ |
| <div>Payment Amount</div>  | Total amount of the payment intent<br /><br />**Field Name:** `paymentAmount`<br />**Type:** metric                |
| <div>Amount Received</div> | Amount actually received from the payment<br /><br />**Field Name:** `paymentAmountReceived`<br />**Type:** metric |
| <div>Application Fee</div> | Amount of the application fee<br /><br />**Field Name:** `paymentApplicationFeeAmount`<br />**Type:** metric       |

### Refund

|                          |                                                                                 |
| ------------------------ | ------------------------------------------------------------------------------- |
| <div>Refund Amount</div> | Amount refunded<br /><br />**Field Name:** `refundAmount`<br />**Type:** metric |

### Balance Transaction

|                               |                                                                                                                     |
| ----------------------------- | ------------------------------------------------------------------------------------------------------------------- |
| <div>Transaction Amount</div> | Gross amount of the balance transaction<br /><br />**Field Name:** `balanceTransactionAmount`<br />**Type:** metric |
| <div>Fee</div>                | Stripe fee for this transaction<br /><br />**Field Name:** `balanceTransactionFee`<br />**Type:** metric            |

### Payout

|                          |                                                                                                           |
| ------------------------ | --------------------------------------------------------------------------------------------------------- |
| <div>Payout Amount</div> | Amount of the payout to your bank account<br /><br />**Field Name:** `payoutAmount`<br />**Type:** metric |

### Event

|                                 |                                                                                                                                                               |
| ------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| <div>Event Count</div>          | Count of events (always 1 per event row, useful for aggregation)<br /><br />**Field Name:** `eventCount`<br />**Type:** metric                                |
| <div>Event Charge Amount</div>  | Charge amount in the event (only populated for charge events)<br /><br />**Field Name:** `eventChargeAmount`<br />**Type:** metric                            |
| <div>Event Invoice Total</div>  | Invoice total in the event (only populated for invoice events)<br /><br />**Field Name:** `eventInvoiceTotal`<br />**Type:** metric                           |
| <div>Event Plan Amount</div>    | Subscription plan amount in the event (only populated for subscription events)<br /><br />**Field Name:** `eventSubscriptionPlanAmount`<br />**Type:** metric |
| <div>Previous Plan Amount</div> | Plan amount before the change (for upgrade/downgrade tracking)<br /><br />**Field Name:** `eventPreviousPlanAmount`<br />**Type:** metric                     |
| <div>New Plan Amount</div>      | Plan amount after the change (for upgrade/downgrade tracking)<br /><br />**Field Name:** `eventNewPlanAmount`<br />**Type:** metric                           |

### Customer

|                             |                                                                                                                          |
| --------------------------- | ------------------------------------------------------------------------------------------------------------------------ |
| <div>Customer Balance</div> | Current balance of the customer (in account currency)<br /><br />**Field Name:** `customerBalance`<br />**Type:** metric |

### Coupon

|                           |                                                                                                                |
| ------------------------- | -------------------------------------------------------------------------------------------------------------- |
| <div>Times Redeemed</div> | Number of times the coupon was redeemed<br /><br />**Field Name:** `couponTimesRedeemed`<br />**Type:** metric |
| <div>Percent Off</div>    | Percentage discount offered by the coupon<br /><br />**Field Name:** `couponPercentOff`<br />**Type:** metric  |
| <div>Amount Off</div>     | Fixed amount discount offered by the coupon<br /><br />**Field Name:** `couponAmountOff`<br />**Type:** metric |

### Promotion Code

|                                |                                                                                                                                                   |
| ------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------- |
| <div>Times Redeemed</div>      | Number of times the promotion code was redeemed<br /><br />**Field Name:** `promotionCodeTimesReedemed`<br />**Type:** metric                     |
| <div>Minimum Amount</div>      | Minimum order amount required to use this promotion code<br /><br />**Field Name:** `promotionCodeMinimumAmountRestriction`<br />**Type:** metric |
| <div>Min Amount Currency</div> | Currency of the minimum amount restriction<br /><br />**Field Name:** `promotionCodeMinimumAmountCurrency`<br />**Type:** metric                  |
| <div>Max Redemptions</div>     | Maximum number of times this promotion code can be redeemed<br /><br />**Field Name:** `promotionCodeMaxRedemption`<br />**Type:** metric         |

***

## Related

<CardGroup>
  <Card title="Fields Catalog" icon="book" href="/fields-catalog">
    Browse all platforms
  </Card>

  <Card title="Shopify Fields" icon="chart-bar" href="/data-source/shopify/fields">
    Shopify metrics & dimensions
  </Card>

  <Card title="WooCommerce Fields" icon="chart-bar" href="/data-source/woocommerce/fields">
    WooCommerce metrics & dimensions
  </Card>

  <Card title="TiendaNube Fields" icon="chart-bar" href="/data-source/tiendanube/fields">
    TiendaNube metrics & dimensions
  </Card>
</CardGroup>


# TiendaNube Metrics & Dimensions
Source: https://support.detrics.io/data-source/tiendanube/fields

Complete reference for TiendaNube store dimensions and metrics

<Info>
  **Last updated:** August 6, 2026
</Info>

<div>
  <div>
    157 dimensions
  </div>

  <div>
    20 metrics
  </div>
</div>

This reference covers all available dimensions and metrics for TiendaNube data through Detrics. Use this guide to understand what data you can extract and how to structure your queries.

<div>
  <span>Supported destinations:</span>

  <div>
    Google Sheets
  </div>

  <div>
    Claude
  </div>

  <div>
    BigQuery
  </div>
</div>

## Dimensions

Dimensions are the attributes you can use to segment and group your TiendaNube data.

### Store

|                                   |                                                                                                                 |
| --------------------------------- | --------------------------------------------------------------------------------------------------------------- |
| <div>Store ID</div>               | Unique identifier for the store<br /><br />**Field Name:** `storeId`<br />**Type:** dimension                   |
| <div>Store Name (ES)</div>        | Name of the store in Spanish<br /><br />**Field Name:** `storeNameEs`<br />**Type:** dimension                  |
| <div>Store Name (EN)</div>        | Name of the store in English<br /><br />**Field Name:** `storeNameEn`<br />**Type:** dimension                  |
| <div>Store Name (PR)</div>        | Name of the store in Portuguese<br /><br />**Field Name:** `storeNamePr`<br />**Type:** dimension               |
| <div>Store Description (ES)</div> | Description of the store in Spanish<br /><br />**Field Name:** `storeDescriptionEs`<br />**Type:** dimension    |
| <div>Store Description (EN)</div> | Description of the store in English<br /><br />**Field Name:** `storeDescriptionEn`<br />**Type:** dimension    |
| <div>Store Description (PR)</div> | Description of the store in Portuguese<br /><br />**Field Name:** `storeDescriptionPr`<br />**Type:** dimension |
| <div>Store Type</div>             | Type of the store<br /><br />**Field Name:** `storeType`<br />**Type:** dimension                               |
| <div>Store Email</div>            | Email address of the store<br /><br />**Field Name:** `storeEmail`<br />**Type:** dimension                     |
| <div>Store Country</div>          | Country of the store<br /><br />**Field Name:** `storeCountry`<br />**Type:** dimension                         |
| <div>Store Main Currency</div>    | Main currency of the store<br /><br />**Field Name:** `storeMainCurrency`<br />**Type:** dimension              |
| <div>Store Main Language</div>    | Main language of the store<br /><br />**Field Name:** `storeMainLanguage`<br />**Type:** dimension              |
| <div>Store Original Domain</div>  | Original domain of the store<br /><br />**Field Name:** `storeOriginalDomain`<br />**Type:** dimension          |
| <div>Store URL</div>              | URL of the store<br /><br />**Field Name:** `storeUrl`<br />**Type:** dimension                                 |
| <div>Store Creation Date</div>    | Creation date of the store<br /><br />**Field Name:** `storeCreatedAt`<br />**Type:** dimension                 |
| <div>Store Facebook</div>         | Facebook URL of the store<br /><br />**Field Name:** `storeFacebook`<br />**Type:** dimension                   |
| <div>Store Twitter</div>          | Twitter URL of the store<br /><br />**Field Name:** `storeTwitter`<br />**Type:** dimension                     |
| <div>Store Instagram</div>        | Instagram URL of the store<br /><br />**Field Name:** `storeInstagram`<br />**Type:** dimension                 |
| <div>Store Pinterest</div>        | Pinterest URL of the store<br /><br />**Field Name:** `storePinterest`<br />**Type:** dimension                 |

### Order

|                                         |                                                                                                                               |
| --------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------- |
| <div>Order ID</div>                     | Unique identifier for the order<br /><br />**Field Name:** `orderId`<br />**Type:** dimension                                 |
| <div>Order Token</div>                  | Order authentication token<br /><br />**Field Name:** `orderToken`<br />**Type:** dimension                                   |
| <div>Order Number</div>                 | Order number for reference<br /><br />**Field Name:** `orderNumber`<br />**Type:** dimension                                  |
| <div>Order Status</div>                 | Status of the order<br /><br />**Field Name:** `orderStatus`<br />**Type:** dimension                                         |
| <div>Order Currency</div>               | Currency of the order<br /><br />**Field Name:** `orderCurrency`<br />**Type:** dimension                                     |
| <div>Order Language</div>               | Language of the order<br /><br />**Field Name:** `orderLanguage`<br />**Type:** dimension                                     |
| <div>Order Origin</div>                 | Origin of the order (e.g., website, marketplace)<br /><br />**Field Name:** `orderOrderOrigin`<br />**Type:** dimension       |
| <div>Order Storefront</div>             | Platform where the order was placed (mobile, web)<br /><br />**Field Name:** `orderStorefront`<br />**Type:** dimension       |
| <div>Order Checkout Enabled</div>       | Whether checkout is enabled for this order<br /><br />**Field Name:** `orderCheckoutEnabled`<br />**Type:** dimension         |
| <div>Order Has Shippable Products</div> | Whether the order contains shippable products<br /><br />**Field Name:** `orderHasShippableProducts`<br />**Type:** dimension |
| <div>Order Created At</div>             | Creation date of the order<br /><br />**Field Name:** `orderCreatedAt`<br />**Type:** dimension                               |
| <div>Order Updated At</div>             | Last updated date of the order<br /><br />**Field Name:** `orderUpdatedAt`<br />**Type:** dimension                           |
| <div>Order Completed At</div>           | Time when the order was completed<br /><br />**Field Name:** `orderCompletedAt`<br />**Type:** dimension                      |
| <div>Order Closed At</div>              | Time when the order was closed<br /><br />**Field Name:** `orderClosedAt`<br />**Type:** dimension                            |
| <div>Order Paid At</div>                | Time when the order was paid<br /><br />**Field Name:** `orderPaidAt`<br />**Type:** dimension                                |
| <div>Order Shipped At</div>             | Time when the order was shipped<br /><br />**Field Name:** `orderShippedAt`<br />**Type:** dimension                          |
| <div>Order Contact Email</div>          | Contact email for the order<br /><br />**Field Name:** `orderContactEmail`<br />**Type:** dimension                           |
| <div>Order Contact Name</div>           | Contact name for the order<br /><br />**Field Name:** `orderContactName`<br />**Type:** dimension                             |
| <div>Order Contact Phone</div>          | Contact phone number for the order<br /><br />**Field Name:** `orderContactPhone`<br />**Type:** dimension                    |
| <div>Order Contact Identification</div> | Contact identification number for the order<br /><br />**Field Name:** `orderContactIdentification`<br />**Type:** dimension  |
| <div>Order Next Action</div>            | Next action required for the order<br /><br />**Field Name:** `orderNextAction`<br />**Type:** dimension                      |
| <div>Order Note</div>                   | Additional notes for the order<br /><br />**Field Name:** `orderNote`<br />**Type:** dimension                                |
| <div>Order Owner Note</div>             | Note for the order owner<br /><br />**Field Name:** `orderOwnerNote`<br />**Type:** dimension                                 |
| <div>Order Cancel Reason</div>          | Reason for order cancellation<br /><br />**Field Name:** `orderCancelReason`<br />**Type:** dimension                         |

### Order Billing

|                                                    |                                                                                                                                                    |
| -------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------- |
| <div>Order Billing Name</div>                      | Name of the billing contact for the order<br /><br />**Field Name:** `orderBillingName`<br />**Type:** dimension                                   |
| <div>Order Billing Phone</div>                     | Phone number of the billing contact for the order<br /><br />**Field Name:** `orderBillingPhone`<br />**Type:** dimension                          |
| <div>Order Billing Address</div>                   | Billing address of the order<br /><br />**Field Name:** `orderBillingAddress`<br />**Type:** dimension                                             |
| <div>Order Billing Number</div>                    | Billing number of the order<br /><br />**Field Name:** `orderBillingNumber`<br />**Type:** dimension                                               |
| <div>Order Billing Floor</div>                     | Floor of the billing address for the order<br /><br />**Field Name:** `orderBillingFloor`<br />**Type:** dimension                                 |
| <div>Order Billing Locality</div>                  | Locality of the billing address for the order<br /><br />**Field Name:** `orderBillingLocality`<br />**Type:** dimension                           |
| <div>Order Billing City</div>                      | City of the billing address for the order<br /><br />**Field Name:** `orderBillingCity`<br />**Type:** dimension                                   |
| <div>Order Billing Province</div>                  | Province of the billing address for the order<br /><br />**Field Name:** `orderBillingProvince`<br />**Type:** dimension                           |
| <div>Order Billing Zip Code</div>                  | Zip code of the billing address for the order<br /><br />**Field Name:** `orderBillingZipCode`<br />**Type:** dimension                            |
| <div>Order Billing Country</div>                   | Country of the billing address for the order<br /><br />**Field Name:** `orderBillingCountry`<br />**Type:** dimension                             |
| <div>Order Same Billing and Shipping Address</div> | Indicates if the billing and shipping addresses are the same<br /><br />**Field Name:** `orderSameBillingShippingAddress`<br />**Type:** dimension |

### Order Shipping

|                                            |                                                                                                                             |
| ------------------------------------------ | --------------------------------------------------------------------------------------------------------------------------- |
| <div>Order Shipping</div>                  | Shipping method for the order<br /><br />**Field Name:** `orderShipping`<br />**Type:** dimension                           |
| <div>Order Shipping Option</div>           | Shipping option selected for the order<br /><br />**Field Name:** `orderShippingOption`<br />**Type:** dimension            |
| <div>Order Shipping Option Code</div>      | Code of the selected shipping option<br /><br />**Field Name:** `orderShippingOptionCode`<br />**Type:** dimension          |
| <div>Order Shipping Option Reference</div> | Reference code for the shipping option<br /><br />**Field Name:** `orderShippingOptionReference`<br />**Type:** dimension   |
| <div>Order Shipping Status</div>           | Status of the shipping for the order<br /><br />**Field Name:** `orderShippingStatus`<br />**Type:** dimension              |
| <div>Order Shipping Min Days</div>         | Minimum shipping days<br /><br />**Field Name:** `orderShippingMinDays`<br />**Type:** dimension                            |
| <div>Order Shipping Max Days</div>         | Maximum shipping days<br /><br />**Field Name:** `orderShippingMaxDays`<br />**Type:** dimension                            |
| <div>Order Shipping Pickup Type</div>      | Type of shipping pickup (ship/pickup)<br /><br />**Field Name:** `orderShippingPickupType`<br />**Type:** dimension         |
| <div>Order Shipping Pickup Details</div>   | Details about pickup location and schedule<br /><br />**Field Name:** `orderShippingPickupDetails`<br />**Type:** dimension |
| <div>Order Shipping Carrier Name</div>     | Name of the shipping carrier<br /><br />**Field Name:** `orderShippingCarrierName`<br />**Type:** dimension                 |
| <div>Order Shipping Tracking Number</div>  | Tracking number of the shipping<br /><br />**Field Name:** `orderShippingTrackingNumber`<br />**Type:** dimension           |
| <div>Order Tracking URL</div>              | Tracking URL for the order shipment<br /><br />**Field Name:** `orderTrackingUrl`<br />**Type:** dimension                  |
| <div>Order Shipping Address</div>          | Shipping address of the order<br /><br />**Field Name:** `orderShippingAddress`<br />**Type:** dimension                    |
| <div>Order Shipping Number</div>           | Number of the shipping address<br /><br />**Field Name:** `orderShippingNumber`<br />**Type:** dimension                    |
| <div>Order Shipping Floor</div>            | Floor of the shipping address<br /><br />**Field Name:** `orderShippingFloor`<br />**Type:** dimension                      |
| <div>Order Shipping Locality</div>         | Locality of the shipping address for the order<br /><br />**Field Name:** `orderShippingLocality`<br />**Type:** dimension  |
| <div>Order Shipping City</div>             | City of the shipping address for the order<br /><br />**Field Name:** `orderShippingCity`<br />**Type:** dimension          |
| <div>Order Shipping Province</div>         | Province of the shipping address for the order<br /><br />**Field Name:** `orderShippingProvince`<br />**Type:** dimension  |
| <div>Order Shipping Zipcode</div>          | Zip code of the shipping address<br /><br />**Field Name:** `orderShippingZipcode`<br />**Type:** dimension                 |
| <div>Order Shipping Country</div>          | Country of the shipping address for the order<br /><br />**Field Name:** `orderShippingCountry`<br />**Type:** dimension    |
| <div>Order Shipping Phone</div>            | Phone number for the shipping address<br /><br />**Field Name:** `orderShippingPhone`<br />**Type:** dimension              |

### Order Payment

|                                              |                                                                                                                                    |
| -------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------- |
| <div>Order Payment Method</div>              | Payment method used for the order<br /><br />**Field Name:** `orderPaymentMethod`<br />**Type:** dimension                         |
| <div>Order Payment Credit Card Company</div> | Credit card company used for the order payment<br /><br />**Field Name:** `orderPaymentCreditCardCompany`<br />**Type:** dimension |
| <div>Order Payment Installments</div>        | Number of payment installments<br /><br />**Field Name:** `orderPaymentInstallments`<br />**Type:** dimension                      |
| <div>Order Payment Status</div>              | Current payment status of the order<br /><br />**Field Name:** `orderPaymentStatus`<br />**Type:** dimension                       |
| <div>Order Gateway</div>                     | Payment gateway used<br /><br />**Field Name:** `orderGateway`<br />**Type:** dimension                                            |
| <div>Order Gateway ID</div>                  | Payment gateway transaction ID<br /><br />**Field Name:** `orderGatewayId`<br />**Type:** dimension                                |
| <div>Order Gateway Name</div>                | Name of the payment gateway<br /><br />**Field Name:** `orderGatewayName`<br />**Type:** dimension                                 |
| <div>Order Gateway Link</div>                | Link to payment gateway transaction<br /><br />**Field Name:** `orderGatewayLink`<br />**Type:** dimension                         |

### Order Customer

|                                    |                                                                                                                         |
| ---------------------------------- | ----------------------------------------------------------------------------------------------------------------------- |
| <div>Customer ID</div>             | Unique identifier for the customer<br /><br />**Field Name:** `orderCustomerId`<br />**Type:** dimension                |
| <div>Customer Name</div>           | Name of the customer<br /><br />**Field Name:** `orderCustomerName`<br />**Type:** dimension                            |
| <div>Customer Email</div>          | Email address of the customer<br /><br />**Field Name:** `orderCustomerEmail`<br />**Type:** dimension                  |
| <div>Customer Phone</div>          | Phone number of the customer<br /><br />**Field Name:** `orderCustomerPhone`<br />**Type:** dimension                   |
| <div>Customer Identification</div> | Identification number of the customer<br /><br />**Field Name:** `orderCustomerIdentification`<br />**Type:** dimension |
| <div>Customer Note</div>           | Note of the customer<br /><br />**Field Name:** `orderCustomerNote`<br />**Type:** dimension                            |

### Traffic Source

|                                        |                                                                                                                            |
| -------------------------------------- | -------------------------------------------------------------------------------------------------------------------------- |
| <div>Customer Visit Created At</div>   | Creation timestamp of the customer visit<br /><br />**Field Name:** `orderCustomerVisitCreatedAt`<br />**Type:** dimension |
| <div>Customer Visit Landing Page</div> | Landing page visited by the customer<br /><br />**Field Name:** `orderCustomerVisitLandingPage`<br />**Type:** dimension   |
| <div>Order Landing URL</div>           | Landing URL where customer came from<br /><br />**Field Name:** `orderLandingUrl`<br />**Type:** dimension                 |
| <div>UTM Source</div>                  | Source of the UTM campaign<br /><br />**Field Name:** `orderUtmSource`<br />**Type:** dimension                            |
| <div>UTM Campaign</div>                | Campaign name in UTM parameters<br /><br />**Field Name:** `orderUtmCampaign`<br />**Type:** dimension                     |
| <div>UTM Medium</div>                  | Medium in UTM parameters<br /><br />**Field Name:** `orderUtmMedium`<br />**Type:** dimension                              |
| <div>UTM Content</div>                 | Content in UTM parameters<br /><br />**Field Name:** `orderUtmContent`<br />**Type:** dimension                            |
| <div>UTM Term</div>                    | Term in UTM parameters<br /><br />**Field Name:** `orderUtmTerm`<br />**Type:** dimension                                  |

### Client Details

|                              |                                                                                                                    |
| ---------------------------- | ------------------------------------------------------------------------------------------------------------------ |
| <div>Client Browser IP</div> | IP address of the client browser<br /><br />**Field Name:** `orderClientBrowserIp`<br />**Type:** dimension        |
| <div>Client User Agent</div> | User agent string of the client browser<br /><br />**Field Name:** `orderClientUserAgent`<br />**Type:** dimension |

### Ordered Product

|                                                  |                                                                                                                                           |
| ------------------------------------------------ | ----------------------------------------------------------------------------------------------------------------------------------------- |
| <div>Ordered Product ID</div>                    | Unique identifier for the product in the order<br /><br />**Field Name:** `productOrderId`<br />**Type:** dimension                       |
| <div>Ordered Product SKU</div>                   | SKU (Stock Keeping Unit) of the product in the order<br /><br />**Field Name:** `productOrderSku`<br />**Type:** dimension                |
| <div>Ordered Product Name</div>                  | Name of the product in the order<br /><br />**Field Name:** `productOrderName`<br />**Type:** dimension                                   |
| <div>Ordered Product Name Without Variants</div> | Name of the product without variants in the order<br /><br />**Field Name:** `productOrderName_without_variants`<br />**Type:** dimension |
| <div>Ordered Product Image URL</div>             | Image URL of the product in the order<br /><br />**Field Name:** `productOrderImageUrl`<br />**Type:** dimension                          |
| <div>Ordered Product Barcode</div>               | Barcode of the product in the order<br /><br />**Field Name:** `productOrderBarcode`<br />**Type:** dimension                             |
| <div>Ordered Product Variant ID</div>            | Variant ID of the product in the order<br /><br />**Field Name:** `productOrderVariantId`<br />**Type:** dimension                        |
| <div>Ordered Product Variant Values</div>        | Variant values of the product (size, color, etc.)<br /><br />**Field Name:** `productOrderVariantValues`<br />**Type:** dimension         |
| <div>Ordered Product Weight</div>                | Weight of the product in the order<br /><br />**Field Name:** `productOrderWeight`<br />**Type:** dimension                               |
| <div>Ordered Product Width</div>                 | Width of the product in the order<br /><br />**Field Name:** `productOrderWidth`<br />**Type:** dimension                                 |
| <div>Ordered Product Height</div>                | Height of the product in the order<br /><br />**Field Name:** `productOrderHeight`<br />**Type:** dimension                               |
| <div>Ordered Product Depth</div>                 | Depth of the product in the order<br /><br />**Field Name:** `productOrderDepth`<br />**Type:** dimension                                 |
| <div>Ordered Product Free Shipping</div>         | Indicates if the product qualifies for free shipping<br /><br />**Field Name:** `productOrderFree_shipping`<br />**Type:** dimension      |
| <div>Ordered Product Has Promotional Price</div> | Whether the product has promotional pricing<br /><br />**Field Name:** `productOrderHasPromotionalPrice`<br />**Type:** dimension         |

### Inventory Product

|                                                   |                                                                                                                                                             |
| ------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------- |
| <div>Inventory Product ID</div>                   | Unique identifier for the product<br /><br />**Field Name:** `productId`<br />**Type:** dimension                                                           |
| <div>Inventory Product Name (ES)</div>            | Name of the product in Spanish<br /><br />**Field Name:** `productNameEs`<br />**Type:** dimension                                                          |
| <div>Inventory Product Name (EN)</div>            | Name of the product in English<br /><br />**Field Name:** `productNameEn`<br />**Type:** dimension                                                          |
| <div>Inventory Product Name (PR)</div>            | Name of the product in Portuguese<br /><br />**Field Name:** `productNamePr`<br />**Type:** dimension                                                       |
| <div>Inventory Product Description (ES)</div>     | Description of the product in Spanish<br /><br />**Field Name:** `productDescriptionEs`<br />**Type:** dimension                                            |
| <div>Inventory Product Description (EN)</div>     | Description of the product in English<br /><br />**Field Name:** `productDescriptionEn`<br />**Type:** dimension                                            |
| <div>Inventory Product Description (PR)</div>     | Description of the product in Portuguese<br /><br />**Field Name:** `productDescriptionPr`<br />**Type:** dimension                                         |
| <div>Inventory Product is Published</div>         | Published status of the product<br /><br />**Field Name:** `productPublished`<br />**Type:** dimension                                                      |
| <div>Inventory Product Free Shipping</div>        | Indicates if the product has free shipping<br /><br />**Field Name:** `productFreeShipping`<br />**Type:** dimension                                        |
| <div>Inventory Product Requires Shipping</div>    | Indicates if the product requires shipping<br /><br />**Field Name:** `productRequiresShipping`<br />**Type:** dimension                                    |
| <div>Inventory Product Video URL</div>            | URL of the product video<br /><br />**Field Name:** `productVideoUrl`<br />**Type:** dimension                                                              |
| <div>Inventory Product Canonical URL</div>        | Canonical URL of the product<br /><br />**Field Name:** `productCanonicalUrl`<br />**Type:** dimension                                                      |
| <div>Inventory Product Created At</div>           | Product creation date<br /><br />**Field Name:** `productCreatedAt`<br />**Type:** dimension                                                                |
| <div>Inventory Product Updated At</div>           | Product last updated date<br /><br />**Field Name:** `productUpdatedAt`<br />**Type:** dimension                                                            |
| <div>Inventory Product Tags</div>                 | Tags associated with the product<br /><br />**Field Name:** `productTags`<br />**Type:** dimension                                                          |
| <div>Inventory Product Images</div>               | Images associated with the product<br /><br />**Field Name:** `productImages`<br />**Type:** dimension                                                      |
| <div>Inventory Product Handle (ES)</div>          | URL-friendly slug for the product in Spanish<br /><br />**Field Name:** `productHandleEs`<br />**Type:** dimension                                          |
| <div>Inventory Product Handle (EN)</div>          | URL-friendly slug for the product in English<br /><br />**Field Name:** `productHandleEn`<br />**Type:** dimension                                          |
| <div>Inventory Product Handle (PR)</div>          | URL-friendly slug for the product in Portuguese<br /><br />**Field Name:** `productHandlePr`<br />**Type:** dimension                                       |
| <div>Inventory Product Brand</div>                | Brand name of the product<br /><br />**Field Name:** `productBrand`<br />**Type:** dimension                                                                |
| <div>Inventory Product SEO Title (ES)</div>       | SEO friendly title for the product in Spanish (up to 70 characters)<br /><br />**Field Name:** `productSeoTitleEs`<br />**Type:** dimension                 |
| <div>Inventory Product SEO Title (EN)</div>       | SEO friendly title for the product in English (up to 70 characters)<br /><br />**Field Name:** `productSeoTitleEn`<br />**Type:** dimension                 |
| <div>Inventory Product SEO Title (PR)</div>       | SEO friendly title for the product in Portuguese (up to 70 characters)<br /><br />**Field Name:** `productSeoTitlePr`<br />**Type:** dimension              |
| <div>Inventory Product SEO Description (ES)</div> | SEO friendly description for the product in Spanish (up to 320 characters)<br /><br />**Field Name:** `productSeoDescriptionEs`<br />**Type:** dimension    |
| <div>Inventory Product SEO Description (EN)</div> | SEO friendly description for the product in English (up to 320 characters)<br /><br />**Field Name:** `productSeoDescriptionEn`<br />**Type:** dimension    |
| <div>Inventory Product SEO Description (PR)</div> | SEO friendly description for the product in Portuguese (up to 320 characters)<br /><br />**Field Name:** `productSeoDescriptionPr`<br />**Type:** dimension |
| <div>Inventory Product Attributes</div>           | Attribute names that define variants (e.g., "Color, Size"). Maximum 3 attributes.<br /><br />**Field Name:** `productAttributes`<br />**Type:** dimension   |

### Inventory Product Variant

|                                                       |                                                                                                                               |
| ----------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------- |
| <div>Inventory Product Variant ID</div>               | Unique identifier for the product variant<br /><br />**Field Name:** `productVariantId`<br />**Type:** dimension              |
| <div>Inventory Product Variant Position</div>         | Position of the product variant<br /><br />**Field Name:** `productVariantPosition`<br />**Type:** dimension                  |
| <div>Inventory Product Variant SKU</div>              | SKU of the product variant<br /><br />**Field Name:** `productVariantSku`<br />**Type:** dimension                            |
| <div>Inventory Product Variant Weight</div>           | Weight of the product variant<br /><br />**Field Name:** `productVariantWeight`<br />**Type:** dimension                      |
| <div>Inventory Product Variant Height</div>           | Height of the product variant<br /><br />**Field Name:** `productVariantHeight`<br />**Type:** dimension                      |
| <div>Inventory Product Variant Width</div>            | Width of the product variant<br /><br />**Field Name:** `productVariantWidth`<br />**Type:** dimension                        |
| <div>Inventory Product Variant Depth</div>            | Depth of the product variant<br /><br />**Field Name:** `productVariantDepth`<br />**Type:** dimension                        |
| <div>Inventory Product Variant Gender</div>           | Gender classification for the product variant<br /><br />**Field Name:** `productVariantGender`<br />**Type:** dimension      |
| <div>Inventory Product Variant Age Group</div>        | Age group classification for the product variant<br /><br />**Field Name:** `productVariantAgeGroup`<br />**Type:** dimension |
| <div>Inventory Product Variant Value (ES)</div>       | Product variant value in Spanish<br /><br />**Field Name:** `productVariantValueEs`<br />**Type:** dimension                  |
| <div>Inventory Product Variant Value (EN)</div>       | Product variant value in English<br /><br />**Field Name:** `productVariantValueEn`<br />**Type:** dimension                  |
| <div>Inventory Product Variant Value (PR)</div>       | Product variant value in Portuguese<br /><br />**Field Name:** `productVariantValuePr`<br />**Type:** dimension               |
| <div>Inventory Product Variant Barcode</div>          | GTIN, EAN, ISBN, or similar barcode identifier<br /><br />**Field Name:** `productVariantBarcode`<br />**Type:** dimension    |
| <div>Inventory Product Variant MPN</div>              | Manufacturer Part Number<br /><br />**Field Name:** `productVariantMpn`<br />**Type:** dimension                              |
| <div>Inventory Product Variant Stock Management</div> | Whether stock is tracked for this variant<br /><br />**Field Name:** `productVariantStockManagement`<br />**Type:** dimension |
| <div>Inventory Product Variant Created At</div>       | Date and time when the variant was created<br /><br />**Field Name:** `productVariantCreatedAt`<br />**Type:** dimension      |
| <div>Inventory Product Variant Updated At</div>       | Date and time when the variant was last updated<br /><br />**Field Name:** `productVariantUpdatedAt`<br />**Type:** dimension |

## Metrics

Metrics are the numerical values you can measure and analyze from your TiendaNube campaigns.

### Store

|                        |                                                                                                                                     |
| ---------------------- | ----------------------------------------------------------------------------------------------------------------------------------- |
| <div>Order Count</div> | Total number of orders for the store in the selected date range.<br /><br />**Field Name:** `storeOrderCount`<br />**Type:** metric |

### Order

|                                   |                                                                                                            |
| --------------------------------- | ---------------------------------------------------------------------------------------------------------- |
| <div>Order Total</div>            | Total price of the order<br /><br />**Field Name:** `orderTotal`<br />**Type:** metric                     |
| <div>Order Total USD</div>        | Total price of the order in USD<br /><br />**Field Name:** `orderTotalUsd`<br />**Type:** metric           |
| <div>Order Total Paid</div>       | Total amount actually paid for the order<br /><br />**Field Name:** `orderTotalPaid`<br />**Type:** metric |
| <div>Order Subtotal</div>         | Subtotal of the order<br /><br />**Field Name:** `orderSubtotal`<br />**Type:** metric                     |
| <div>Order Discount</div>         | Total discount applied to the order<br /><br />**Field Name:** `orderDiscount`<br />**Type:** metric       |
| <div>Order Discount Coupon</div>  | Discount from coupon codes<br /><br />**Field Name:** `orderDiscountCoupon`<br />**Type:** metric          |
| <div>Order Discount Gateway</div> | Discount from payment gateway<br /><br />**Field Name:** `orderDiscountGateway`<br />**Type:** metric      |
| <div>Order Weight</div>           | Total weight of the order<br /><br />**Field Name:** `orderWeight`<br />**Type:** metric                   |
| <div>Order Total Products</div>   | Total number of products in an order<br /><br />**Field Name:** `orderTotalProducts`<br />**Type:** metric |

### Order Shipping

|                                         |                                                                                                             |
| --------------------------------------- | ----------------------------------------------------------------------------------------------------------- |
| <div>Order Shipping Cost Owner</div>    | Shipping cost paid by store owner<br /><br />**Field Name:** `orderShippingCostOwner`<br />**Type:** metric |
| <div>Order Shipping Cost Customer</div> | Shipping cost paid by customer<br /><br />**Field Name:** `orderShippingCostCustomer`<br />**Type:** metric |

### Ordered Product

|                                             |                                                                                                                                |
| ------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------ |
| <div>Ordered Product Price</div>            | Price of the product in the order<br /><br />**Field Name:** `productOrderPrice`<br />**Type:** metric                         |
| <div>Ordered Product Compare At Price</div> | Compare at price (original price) of the product<br /><br />**Field Name:** `productOrderCompareAtPrice`<br />**Type:** metric |
| <div>Ordered Product Cost</div>             | Cost of the product in the order<br /><br />**Field Name:** `productOrderCost`<br />**Type:** metric                           |
| <div>Ordered Product Quantity</div>         | Quantity of the product in the order<br /><br />**Field Name:** `productOrderQuantity`<br />**Type:** metric                   |

### Inventory Product Variant

|                                                        |                                                                                                                                        |
| ------------------------------------------------------ | -------------------------------------------------------------------------------------------------------------------------------------- |
| <div>Inventory Product Variant Price</div>             | Price of the product variant<br /><br />**Field Name:** `productVariantPrice`<br />**Type:** metric                                    |
| <div>Inventory Product Variant Promotional Price</div> | Sale price displayed with original price crossed out<br /><br />**Field Name:** `productVariantPromotionalPrice`<br />**Type:** metric |
| <div>Inventory Product Variant Cost</div>              | Cost of the product variant<br /><br />**Field Name:** `productVariantCost`<br />**Type:** metric                                      |
| <div>Inventory Product Variant Stock</div>             | Stock quantity of the product variant<br /><br />**Field Name:** `productVariantStock`<br />**Type:** metric                           |

***

## Related

<CardGroup>
  <Card title="Fields Catalog" icon="book" href="/fields-catalog">
    Browse all platforms
  </Card>

  <Card title="Shopify Fields" icon="chart-bar" href="/data-source/shopify/fields">
    Shopify metrics & dimensions
  </Card>

  <Card title="WooCommerce Fields" icon="chart-bar" href="/data-source/woocommerce/fields">
    WooCommerce metrics & dimensions
  </Card>

  <Card title="Stripe Fields" icon="chart-bar" href="/data-source/stripe/fields">
    Stripe metrics & dimensions
  </Card>
</CardGroup>


# TikTok Ads Metrics & Dimensions
Source: https://support.detrics.io/data-source/tiktok-ads/fields

Complete reference for TikTok Ads dimensions and metrics

<Info>
  **Last updated:** August 6, 2026
</Info>

<div>
  <div>
    82 dimensions
  </div>

  <div>
    711 metrics
  </div>
</div>

This reference covers all available dimensions and metrics for TikTok Ads data through Detrics. Use this guide to understand what data you can extract and how to structure your queries.

<div>
  <span>Supported destinations:</span>

  <div>
    Google Sheets
  </div>

  <div>
    Looker Studio
  </div>

  <div>
    Claude
  </div>

  <div>
    BigQuery
  </div>
</div>

## Dimensions

Dimensions are the attributes you can use to segment and group your TikTok Ads data.

### Most Used

|                            |                                                                                                             |
| -------------------------- | ----------------------------------------------------------------------------------------------------------- |
| <div>Advertiser ID</div>   | Advertiser Account Unique Identifier.<br /><br />**Field Name:** `advertiser_id`<br />**Type:** dimension   |
| <div>Advertiser Name</div> | Advertiser Account Unique Identifier.<br /><br />**Field Name:** `advertiser_name`<br />**Type:** dimension |
| <div>Currency</div>        | Advertiser's Currency Code.<br /><br />**Field Name:** `currency`<br />**Type:** dimension                  |
| <div>Campaign ID</div>     | Campaign Unique Identifier<br /><br />**Field Name:** `campaign_id`<br />**Type:** dimension                |
| <div>Campaign Name</div>   | Campaign Name<br /><br />**Field Name:** `campaign_name`<br />**Type:** dimension                           |
| <div>Ad group ID</div>     | Ad Group Unique Identifier<br /><br />**Field Name:** `adgroup_id`<br />**Type:** dimension                 |
| <div>Ad group Name</div>   | Ad Group Name<br /><br />**Field Name:** `adgroup_name`<br />**Type:** dimension                            |
| <div>Ad ID</div>           | Ad Unique Identifier<br /><br />**Field Name:** `ad_id`<br />**Type:** dimension                            |
| <div>Ad Name</div>         | Ad Name<br /><br />**Field Name:** `ad_name`<br />**Type:** dimension                                       |

### Campaign

|                                      |                                                                                                                                                                                                                  |
| ------------------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| <div>Campaign Budget Mode</div>      | <br /><br />**Field Name:** `campaign_budget_mode`<br />**Type:** dimension                                                                                                                                      |
| <div>Campaign Objective Type</div>   | <br /><br />**Field Name:** `campaign_objective_type`<br />**Type:** dimension                                                                                                                                   |
| <div>Campaign Budget</div>           | <br /><br />**Field Name:** `campaign_budget`<br />**Type:** dimension                                                                                                                                           |
| <div>Campaign Objective</div>        | <br /><br />**Field Name:** `campaign_objective`<br />**Type:** dimension                                                                                                                                        |
| <div>Campaign Create Time</div>      | <br /><br />**Field Name:** `campaign_create_time`<br />**Type:** dimension                                                                                                                                      |
| <div>Campaign Modify Time</div>      | <br /><br />**Field Name:** `campaign_modify_time`<br />**Type:** dimension                                                                                                                                      |
| <div>Campaign Type</div>             | <br /><br />**Field Name:** `campaign_type`<br />**Type:** dimension                                                                                                                                             |
| <div>Campaign Operation Status</div> | <br /><br />**Field Name:** `campaign_operation_status`<br />**Type:** dimension                                                                                                                                 |
| <div>Campaign Secondary Status</div> | The delivery status of the campaign, e.g. CAMPAIGN\_STATUS\_ENABLE, CAMPAIGN\_STATUS\_DISABLE, CAMPAIGN\_STATUS\_BUDGET\_EXCEED.<br /><br />**Field Name:** `campaign_secondary_status`<br />**Type:** dimension |
| <div>Campaign is New Structure</div> | <br /><br />**Field Name:** `campaign_is_new_structure`<br />**Type:** dimension                                                                                                                                 |
| <div>Campaign Automation Type</div>  | The automation type of the campaign.<br /><br />**Field Name:** `campaign_automation_type`<br />**Type:** dimension                                                                                              |

### Audience

|                             |                                                                                                                                                                                                      |
| --------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| <div>Country Code</div>     | Group Metrics by Country<br /><br />**Field Name:** `country_code`<br />**Type:** dimension                                                                                                          |
| <div>Province</div>         | Group metrics by province/region (sub-country). Must be used on its own — cannot be combined with other audience breakdowns.<br /><br />**Field Name:** `province_name`<br />**Type:** dimension     |
| <div>Province ID</div>      | Group metrics by TikTok's numeric province/region ID. Must be used on its own — cannot be combined with other audience breakdowns.<br /><br />**Field Name:** `province_id`<br />**Type:** dimension |
| <div>Gender</div>           | Group Metrics by Gender<br /><br />**Field Name:** `gender`<br />**Type:** dimension                                                                                                                 |
| <div>Age</div>              | Group Metrics by Age<br /><br />**Field Name:** `age`<br />**Type:** dimension                                                                                                                       |
| <div>Audience network</div> | Group Metrics by Audience Network<br /><br />**Field Name:** `ac`<br />**Type:** dimension                                                                                                           |
| <div>Device</div>           | Group metrics by device platform (Android, iPhone, iPad, Unknown).<br /><br />**Field Name:** `platform`<br />**Type:** dimension                                                                    |

### Ad Group

|                                                   |                                                                                              |
| ------------------------------------------------- | -------------------------------------------------------------------------------------------- |
| <div>Ad Group Schedule Start Time</div>           | <br /><br />**Field Name:** `adgroup_schedule_start_time`<br />**Type:** dimension           |
| <div>Ad Group Schedule End Time</div>             | <br /><br />**Field Name:** `adgroup_schedule_end_time`<br />**Type:** dimension             |
| <div>Ad Group Scheduled Budget</div>              | <br /><br />**Field Name:** `adgroup_scheduled_budget`<br />**Type:** dimension              |
| <div>Ad Group Secondary Status</div>              | <br /><br />**Field Name:** `adgroup_secondary_status`<br />**Type:** dimension              |
| <div>Ad Group Placements</div>                    | <br /><br />**Field Name:** `adgroup_placements`<br />**Type:** dimension                    |
| <div>Ad Group Bid Type</div>                      | <br /><br />**Field Name:** `adgroup_bid_type`<br />**Type:** dimension                      |
| <div>Ad Group Schedule Type</div>                 | <br /><br />**Field Name:** `adgroup_schedule_type`<br />**Type:** dimension                 |
| <div>Ad Group Create Time</div>                   | <br /><br />**Field Name:** `adgroup_create_time`<br />**Type:** dimension                   |
| <div>Ad Group Is Smart Performance Campaign</div> | <br /><br />**Field Name:** `adgroup_is_smart_performance_campaign`<br />**Type:** dimension |
| <div>Ad Group Budget</div>                        | <br /><br />**Field Name:** `adgroup_budget`<br />**Type:** dimension                        |
| <div>Ad Group Operation Status</div>              | <br /><br />**Field Name:** `adgroup_operation_status`<br />**Type:** dimension              |
| <div>Ad Group Optimization Event</div>            | <br /><br />**Field Name:** `adgroup_optimization_event`<br />**Type:** dimension            |
| <div>Ad Group Bid Display Mode</div>              | <br /><br />**Field Name:** `adgroup_bid_display_mode`<br />**Type:** dimension              |
| <div>Ad Group Optimization Goal</div>             | <br /><br />**Field Name:** `adgroup_optimization_goal`<br />**Type:** dimension             |
| <div>Ad Group Billing Event</div>                 | <br /><br />**Field Name:** `adgroup_billing_event`<br />**Type:** dimension                 |
| <div>Ad Group Budget Mode</div>                   | <br /><br />**Field Name:** `adgroup_budget_mode`<br />**Type:** dimension                   |
| <div>Ad Group Promotion Type</div>                | <br /><br />**Field Name:** `adgroup_promotion_type`<br />**Type:** dimension                |
| <div>Ad Group Modify Time</div>                   | <br /><br />**Field Name:** `adgroup_modify_time`<br />**Type:** dimension                   |

### Ad

|                                          |                                                                                                                                                                                                      |
| ---------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| <div>Ad Call To Action</div>             | <br /><br />**Field Name:** `ad_call_to_action`<br />**Type:** dimension                                                                                                                             |
| <div>Ad Landing Page Url</div>           | <br /><br />**Field Name:** `ad_landing_page_url`<br />**Type:** dimension                                                                                                                           |
| <div>Ad Identity Type</div>              | <br /><br />**Field Name:** `ad_identity_type`<br />**Type:** dimension                                                                                                                              |
| <div>Ad App Name</div>                   | <br /><br />**Field Name:** `ad_app_name`<br />**Type:** dimension                                                                                                                                   |
| <div>Ad Modify Time</div>                | <br /><br />**Field Name:** `ad_modify_time`<br />**Type:** dimension                                                                                                                                |
| <div>Ad Promotional Music Disabled</div> | <br /><br />**Field Name:** `ad_promotional_music_disabled`<br />**Type:** dimension                                                                                                                 |
| <div>Ad Viewability Vast Url</div>       | <br /><br />**Field Name:** `ad_viewability_vast_url`<br />**Type:** dimension                                                                                                                       |
| <div>Ad Format</div>                     | <br /><br />**Field Name:** `ad_ad_format`<br />**Type:** dimension                                                                                                                                  |
| <div>Ad Brand Safety Vast Url</div>      | <br /><br />**Field Name:** `ad_brand_safety_vast_url`<br />**Type:** dimension                                                                                                                      |
| <div>Ad Operation Status</div>           | <br /><br />**Field Name:** `ad_operation_status`<br />**Type:** dimension                                                                                                                           |
| <div>Ad Is Aco</div>                     | <br /><br />**Field Name:** `ad_is_aco`<br />**Type:** dimension                                                                                                                                     |
| <div>Ad Is New Structure</div>           | <br /><br />**Field Name:** `ad_is_new_structure`<br />**Type:** dimension                                                                                                                           |
| <div>Ad Display Name</div>               | <br /><br />**Field Name:** `ad_display_name`<br />**Type:** dimension                                                                                                                               |
| <div>Ad Create Time</div>                | <br /><br />**Field Name:** `ad_create_time`<br />**Type:** dimension                                                                                                                                |
| <div>Ad Click Tracking Url</div>         | <br /><br />**Field Name:** `ad_click_tracking_url`<br />**Type:** dimension                                                                                                                         |
| <div>Ad Playable Url</div>               | <br /><br />**Field Name:** `ad_playable_url`<br />**Type:** dimension                                                                                                                               |
| <div>Ad Secondary Status</div>           | <br /><br />**Field Name:** `ad_secondary_status`<br />**Type:** dimension                                                                                                                           |
| <div>Ad Impression Tracking Url</div>    | <br /><br />**Field Name:** `ad_impression_tracking_url`<br />**Type:** dimension                                                                                                                    |
| <div>Ad Deeplink Type</div>              | <br /><br />**Field Name:** `ad_deeplink_type`<br />**Type:** dimension                                                                                                                              |
| <div>Ad Avatar Icon Web Uri</div>        | <br /><br />**Field Name:** `ad_avatar_icon_web_uri`<br />**Type:** dimension                                                                                                                        |
| <div>Ad Fallback Type</div>              | <br /><br />**Field Name:** `ad_fallback_type`<br />**Type:** dimension                                                                                                                              |
| <div>Ad Profile Image Url</div>          | <br /><br />**Field Name:** `ad_profile_image_url`<br />**Type:** dimension                                                                                                                          |
| <div>Ad Deeplink</div>                   | <br /><br />**Field Name:** `ad_deeplink`<br />**Type:** dimension                                                                                                                                   |
| <div>Ad Optimization Event</div>         | <br /><br />**Field Name:** `ad_optimization_event`<br />**Type:** dimension                                                                                                                         |
| <div>Ad Vast Moat Enabled</div>          | <br /><br />**Field Name:** `ad_vast_moat_enabled`<br />**Type:** dimension                                                                                                                          |
| <div>Ad Text</div>                       | The text or caption displayed in the ad.<br /><br />**Field Name:** `ad_text`<br />**Type:** dimension                                                                                               |
| <div>TikTok Item ID</div>                | The TikTok item ID of the organic post used for Spark Ads. Spark Ads allow advertisers to boost organic TikTok posts as ads.<br /><br />**Field Name:** `ad_tiktok_item_id`<br />**Type:** dimension |

### Ad Creative

|                                             |                                                                                                                                      |
| ------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------ |
| <div>Creative Thumbnail URL</div>           | URL of the ad video thumbnail.<br /><br />**Field Name:** `creative_thumbnail_url`<br />**Type:** dimension                          |
| <div>Creative Preview URL</div>             | URL of the ad video preview.<br /><br />**Field Name:** `creative_preview_url`<br />**Type:** dimension                              |
| <div>Creative Format</div>                  | Format of the ad video.<br /><br />**Field Name:** `creative_format`<br />**Type:** dimension                                        |
| <div>Creative Thumbnail</div>               | Ad video thumbnail image.<br /><br />**Field Name:** `creative_thumbnail`<br />**Type:** dimension                                   |
| <div>Creative File Name</div>               | File name of the creative asset.<br /><br />**Field Name:** `creative_file_name`<br />**Type:** dimension                            |
| <div>Creative Preview URL Expire Time</div> | Expiration time for the creative preview URL.<br /><br />**Field Name:** `creative_preview_url_expire_time`<br />**Type:** dimension |
| <div>Creative Duration</div>                | Duration of the creative asset.<br /><br />**Field Name:** `creative_duration`<br />**Type:** dimension                              |

### Ad Detail

|                        |                                                                                                                                                |
| ---------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------- |
| <div>Ad Type</div>     | You can use this dimension to distinguish between Search Ads and non-Search Ads.<br /><br />**Field Name:** `ad_type`<br />**Type:** dimension |
| <div>Search Term</div> | Group Metrics by Search Term<br /><br />**Field Name:** `search_terms`<br />**Type:** dimension                                                |

### Placement

|                      |                                                                  |
| -------------------- | ---------------------------------------------------------------- |
| <div>Placement</div> | <br /><br />**Field Name:** `placement`<br />**Type:** dimension |

## Metrics

Metrics are the numerical values you can measure and analyze from your TikTok Ads campaigns.

### Most Used

|                        |                                                                                                                                                                 |
| ---------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| <div>Cost</div>        | The estimated total amount of money you've spent on your campaign, ad group or ad during its schedule.<br /><br />**Field Name:** `spend`<br />**Type:** metric |
| <div>Impressions</div> | The number of times your ads were on screen.<br /><br />**Field Name:** `impressions`<br />**Type:** metric                                                     |
| <div>Clicks</div>      | The number of clicks on your ads that led to advertiser-specified destinations.<br /><br />**Field Name:** `clicks`<br />**Type:** metric                       |
| <div>Reach</div>       | The number of unique users who saw your ads at least once. This metric is estimated.<br /><br />**Field Name:** `reach`<br />**Type:** metric                   |

### Results

|                                                    |                                                                                                                                                                                                                                                                    |
| -------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| <div>Result</div>                                  | The number of times your ad achieved an outcome, based on the optimization goal you selected. Note: this metric is not available at the campaign level. Use it at the advertiser, ad group, or ad level.<br /><br />**Field Name:** `result`<br />**Type:** metric |
| <div>Conversion</div>                              | The number of times your ad achieved an outcome, based on the secondary goal you selected.<br /><br />**Field Name:** `conversion`<br />**Type:** metric                                                                                                           |
| <div>Cost per conversion</div>                     | <br /><br />**Field Name:** `cost_per_conversion`<br />**Type:** metric                                                                                                                                                                                            |
| <div>Conversion rate (CVR, clicks)</div>           | <br /><br />**Field Name:** `conversion_rate`<br />**Type:** metric                                                                                                                                                                                                |
| <div>Conversion rate (CVR)</div>                   | <br /><br />**Field Name:** `conversion_rate_v2`<br />**Type:** metric                                                                                                                                                                                             |
| <div>Real-time conversions</div>                   | <br /><br />**Field Name:** `real_time_conversion`<br />**Type:** metric                                                                                                                                                                                           |
| <div>Real-time cost per conversion</div>           | <br /><br />**Field Name:** `real_time_cost_per_conversion`<br />**Type:** metric                                                                                                                                                                                  |
| <div>Real-time conversion rate (CVR, clicks)</div> | <br /><br />**Field Name:** `real_time_conversion_rate`<br />**Type:** metric                                                                                                                                                                                      |
| <div>Real-time conversion rate (CVR)</div>         | <br /><br />**Field Name:** `real_time_conversion_rate_v2`<br />**Type:** metric                                                                                                                                                                                   |
| <div>Cost per result</div>                         | The average cost for each result. Not available at the campaign level.<br /><br />**Field Name:** `cost_per_result`<br />**Type:** metric                                                                                                                          |
| <div>Result rate</div>                             | The percentage of results over impressions. Not available at the campaign level.<br /><br />**Field Name:** `result_rate`<br />**Type:** metric                                                                                                                    |
| <div>Real-time results</div>                       | <br /><br />**Field Name:** `real_time_result`<br />**Type:** metric                                                                                                                                                                                               |
| <div>Real-time cost per result</div>               | <br /><br />**Field Name:** `real_time_cost_per_result`<br />**Type:** metric                                                                                                                                                                                      |
| <div>Real-time result rate</div>                   | <br /><br />**Field Name:** `real_time_result_rate`<br />**Type:** metric                                                                                                                                                                                          |
| <div>Secondary goal result</div>                   | <br /><br />**Field Name:** `secondary_goal_result`<br />**Type:** metric                                                                                                                                                                                          |
| <div>Cost per secondary goal result</div>          | <br /><br />**Field Name:** `cost_per_secondary_goal_result`<br />**Type:** metric                                                                                                                                                                                 |
| <div>Secondary goal result rate</div>              | <br /><br />**Field Name:** `secondary_goal_result_rate`<br />**Type:** metric                                                                                                                                                                                     |
| <div>Landing Page View</div>                       | The number of landing page view events from your ads.<br /><br />**Field Name:** `total_landing_page_view`<br />**Type:** metric                                                                                                                                   |

### Performance

|                |                                                                                                                                        |
| -------------- | -------------------------------------------------------------------------------------------------------------------------------------- |
| <div>CPC</div> | The average amount of money you've spent on a click (destination).<br /><br />**Field Name:** `cpc`<br />**Type:** metric              |
| <div>CPM</div> | The average amount of money you've spent per 1,000 impressions.<br /><br />**Field Name:** `cpm`<br />**Type:** metric                 |
| <div>CTR</div> | The percentage of times people saw your ad and performed a click (destination).<br /><br />**Field Name:** `ctr`<br />**Type:** metric |

### Reach

|                                                             |                                                                           |
| ----------------------------------------------------------- | ------------------------------------------------------------------------- |
| <div>Gross Impressions (Includes Invalid Impressions)</div> | <br /><br />**Field Name:** `gross_impressions`<br />**Type:** metric     |
| <div>Cost per 1,000 people reached</div>                    | <br /><br />**Field Name:** `cost_per_1000_reached`<br />**Type:** metric |
| <div>Frequency</div>                                        | <br /><br />**Field Name:** `frequency`<br />**Type:** metric             |

### Video

|                                                        |                                                                                                                                                                                                                                                                                                                   |
| ------------------------------------------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| <div>Video Views</div>                                 | The number of times your video starts to play. Replays will not be counted.<br /><br />**Field Name:** `video_play_actions`<br />**Type:** metric                                                                                                                                                                 |
| <div>Video Views at 25%</div>                          | The number of times your video was played at 25% of its length. Replays will not be counted.<br /><br />**Field Name:** `video_views_p25`<br />**Type:** metric                                                                                                                                                   |
| <div>Video Views at 50%</div>                          | The number of times your video was played at 50% of its length. Replays will not be counted.<br /><br />**Field Name:** `video_views_p50`<br />**Type:** metric                                                                                                                                                   |
| <div>Video Views at 75%</div>                          | The number of times your video was played at 75% of its length. Replays will not be counted.<br /><br />**Field Name:** `video_views_p75`<br />**Type:** metric                                                                                                                                                   |
| <div>Video Views at 100%</div>                         | The number of times your video was played at 100% of its length. Replays will not be counted.<br /><br />**Field Name:** `video_views_p100`<br />**Type:** metric                                                                                                                                                 |
| <div>2-Second Video Views</div>                        | The number of times your video played for at least 2 seconds. Replays will not be counted.<br /><br />**Field Name:** `video_watched_2s`<br />**Type:** metric                                                                                                                                                    |
| <div>6-Second Video Views</div>                        | The number of times your video played for at least 6 seconds, or completely played. Replays will not be counted.<br /><br />**Field Name:** `video_watched_6s`<br />**Type:** metric                                                                                                                              |
| <div>Avg. Watch Time Per View</div>                    | The average time your video was played per single video view, including any time spent replaying the video.<br /><br />**Field Name:** `average_video_play`<br />**Type:** metric                                                                                                                                 |
| <div>Avg. Watch Time Per Person</div>                  | The average time your video was played per person, including any time spent replaying the video. This metric is estimated.<br /><br />**Field Name:** `average_video_play_per_user`<br />**Type:** metric                                                                                                         |
| <div>6-second focused views</div>                      | Number of times your video was played for at least 6 seconds, played in full if it is less than 6 seconds, or received at least 1 engagement within the first 6 seconds.<br /><br />**Field Name:** `engaged_view`<br />**Type:** metric                                                                          |
| <div>6-second focused views (paid views)</div>         | Number of times your video was played for at least 6 seconds, or played in full if it is less than 6 seconds. For each video impression, plays are counted separately and replays are excluded.<br /><br />**Field Name:** `paid_engaged_view`<br />**Type:** metric                                              |
| <div>6-second focused views (paid interactions)</div>  | The number of times your video received at least one positive interaction (likes, shares, follows, or clicks) without being viewed for 6 seconds. This metric is only available for advertisers using focused view products.<br /><br />**Field Name:** `paid_engagement_engaged_view`<br />**Type:** metric      |
| <div>15-second focused views</div>                     | Number of times your video was played for at least 15 seconds, played in full if it is less than 15 seconds, or received at least 1 engagement within the first 15 seconds.<br /><br />**Field Name:** `engaged_view_15s`<br />**Type:** metric                                                                   |
| <div>15-second focused views (paid views)</div>        | The number of times your video was viewed for at least 15 seconds, or viewed in full if it is less than 15 seconds long. For each video impression, plays are counted separately and replays are excluded.<br /><br />**Field Name:** `paid_engaged_view_15s`<br />**Type:** metric                               |
| <div>15-second focused views (paid interactions)</div> | The number of times your video received at least one positive interaction (likes, shares, follows, or clicks) without being viewed for 15 seconds. This metric is only available for advertisers using focused view products.<br /><br />**Field Name:** `paid_engagement_engaged_view_15s`<br />**Type:** metric |

### Engagement

|                                                       |                                                                                                                                                                                                      |
| ----------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| <div>Clicks (All)</div>                               | Number of clicks from your ads. This includes clicks that lead to destination as well as those for social and interaction purposes.<br /><br />**Field Name:** `engagements`<br />**Type:** metric   |
| <div>CTR (all)</div>                                  | Percentage of impressions that resulted in a click out of all impressions.<br /><br />**Field Name:** `engagement_rate`<br />**Type:** metric                                                        |
| <div>Likes</div>                                      | Number of times your ad was liked during the ad impression.<br /><br />**Field Name:** `likes`<br />**Type:** metric                                                                                 |
| <div>Comments</div>                                   | Number of comments sent on your ad during the ad impression.<br /><br />**Field Name:** `comments`<br />**Type:** metric                                                                             |
| <div>Shares</div>                                     | Number of shares of your ad during the ad impression.<br /><br />**Field Name:** `shares`<br />**Type:** metric                                                                                      |
| <div>Followers</div>                                  | Number of follows to the associated profile during the ad impression.<br /><br />**Field Name:** `follows`<br />**Type:** metric                                                                     |
| <div>Paid profile visits</div>                        | Number of visits to the associated profile during the ad impression.<br /><br />**Field Name:** `profile_visits`<br />**Type:** metric                                                               |
| <div>Paid profile visit rate</div>                    | Number of visits to the associated profile during the ad impression.<br /><br />**Field Name:** `profile_visits_rate`<br />**Type:** metric                                                          |
| <div>Sound clicks</div>                               | Number of clicks on the sound associated with your ad during the ad impression.<br /><br />**Field Name:** `clicks_on_music_disc`<br />**Type:** metric                                              |
| <div>Duet button clicks</div>                         | Number of clicks on the "Duet" button.<br /><br />**Field Name:** `duet_clicks`<br />**Type:** metric                                                                                                |
| <div>Stitch button clicks</div>                       | Number of clicks on the "Stitch" button.<br /><br />**Field Name:** `stitch_clicks`<br />**Type:** metric                                                                                            |
| <div>Use sound button clicks</div>                    | Number of clicks on the "Use sound" button.<br /><br />**Field Name:** `sound_usage_clicks`<br />**Type:** metric                                                                                    |
| <div>Anchor clicks</div>                              | Number of clicks on ad anchors.<br /><br />**Field Name:** `anchor_clicks`<br />**Type:** metric                                                                                                     |
| <div>Anchor click rate</div>                          | Percentage of anchor clicks out of all impressions on your ads.<br /><br />**Field Name:** `anchor_click_rate`<br />**Type:** metric                                                                 |
| <div>Hashtag clicks</div>                             | Number of clicks on the hashtag challenge associated with your ad during the ad impression.<br /><br />**Field Name:** `clicks_on_hashtag_challenge`<br />**Type:** metric                           |
| <div>Instant experience average view time</div>       | Average time your Instant Experience was shown.<br /><br />**Field Name:** `ix_page_duration_avg`<br />**Type:** metric                                                                              |
| <div>Instant experience average view percentage</div> | Average percentage of content on your Instant Experience that was viewed.<br /><br />**Field Name:** `ix_page_viewrate_avg`<br />**Type:** metric                                                    |
| <div>Instant experience video views</div>             | Number of times your Instant Experience video was played. Replays are excluded.<br /><br />**Field Name:** `ix_video_views`<br />**Type:** metric                                                    |
| <div>Instant experience video views at 25%</div>      | Number of times your Instant Experience video was played at least 25% of its length. Replays are excluded.<br /><br />**Field Name:** `ix_video_views_p25`<br />**Type:** metric                     |
| <div>Instant experience video views at 50%</div>      | Number of times your Instant Experience video was played at least 50% of its length. Replays are excluded.<br /><br />**Field Name:** `ix_video_views_p50`<br />**Type:** metric                     |
| <div>Instant experience video views at 75%</div>      | Number of times your Instant Experience video was played at least 75% of its length. Replays are excluded.<br /><br />**Field Name:** `ix_video_views_p75`<br />**Type:** metric                     |
| <div>Instant experience video views at 100%</div>     | Number of times your Instant Experience video was played 100% of its length. Replays are excluded.<br /><br />**Field Name:** `ix_video_views_p100`<br />**Type:** metric                            |
| <div>Average Instant experience video view time</div> | Average time your instant experience video was played in a single video view, including any time spent replaying the video.<br /><br />**Field Name:** `ix_average_video_play`<br />**Type:** metric |
| <div>Playlist page visit</div>                        | The number of playlist page visits the paid ad drove during the campaign.<br /><br />**Field Name:** `tt_playlist_visit`<br />**Type:** metric                                                       |
| <div>Playlist page visit rate</div>                   | The rate of playlist page visits per impression the paid ad drove during the campaign.<br /><br />**Field Name:** `tt_playlist_visit_rate`<br />**Type:** metric                                     |

### Page Metrics

|                                                    |                                                                                                                                                                        |
| -------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| <div>Payment Completion ROAS (Page)</div>          | <br /><br />**Field Name:** `complete_payment_roas`<br />**Type:** metric                                                                                              |
| <div>Complete Payment (Page)</div>                 | <br /><br />**Field Name:** `complete_payment`<br />**Type:** metric                                                                                                   |
| <div>Cost per Complete Payment (Page)</div>        | <br /><br />**Field Name:** `cost_per_complete_payment`<br />**Type:** metric                                                                                          |
| <div>Complete Payment Rate (Page)</div>            | <br /><br />**Field Name:** `complete_payment_rate`<br />**Type:** metric                                                                                              |
| <div>Value per Complete Payment (Page)</div>       | <br /><br />**Field Name:** `value_per_complete_payment`<br />**Type:** metric                                                                                         |
| <div>Total Complete Payment Value (Page)</div>     | <br /><br />**Field Name:** `total_complete_payment_rate`<br />**Type:** metric                                                                                        |
| <div>Cost per Landing Page View (Page)</div>       | <br /><br />**Field Name:** `cost_per_landing_page_view`<br />**Type:** metric                                                                                         |
| <div>Landing Page View Rate (Page)</div>           | <br /><br />**Field Name:** `landing_page_view_rate`<br />**Type:** metric                                                                                             |
| <div>Total Page View (Page)</div>                  | <br /><br />**Field Name:** `total_pageview`<br />**Type:** metric                                                                                                     |
| <div>Cost per Page View (Page)</div>               | <br /><br />**Field Name:** `cost_per_pageview`<br />**Type:** metric                                                                                                  |
| <div>Page View Rate (Page)</div>                   | <br /><br />**Field Name:** `pageview_rate`<br />**Type:** metric                                                                                                      |
| <div>Value per Page View (Page)</div>              | <br /><br />**Field Name:** `avg_value_per_pageview`<br />**Type:** metric                                                                                             |
| <div>Total Page View Value (Page)</div>            | <br /><br />**Field Name:** `total_value_per_pageview`<br />**Type:** metric                                                                                           |
| <div>Button Clicks (Page)</div>                    | <br /><br />**Field Name:** `button_click`<br />**Type:** metric                                                                                                       |
| <div>Cost per Button Click (Page)</div>            | <br /><br />**Field Name:** `cost_per_button_click`<br />**Type:** metric                                                                                              |
| <div>Button Click Rate (Page)</div>                | <br /><br />**Field Name:** `button_click_rate`<br />**Type:** metric                                                                                                  |
| <div>Value per Button Click (Page)</div>           | <br /><br />**Field Name:** `value_per_button_click`<br />**Type:** metric                                                                                             |
| <div>Button Click Value (Page)</div>               | <br /><br />**Field Name:** `total_button_click_value`<br />**Type:** metric                                                                                           |
| <div>Add to Cart (Page)</div>                      | <br /><br />**Field Name:** `web_event_add_to_cart`<br />**Type:** metric                                                                                              |
| <div>Cost per Add to Cart (Page)</div>             | <br /><br />**Field Name:** `cost_per_web_event_add_to_cart`<br />**Type:** metric                                                                                     |
| <div>Add to Cart Rate (Page)</div>                 | <br /><br />**Field Name:** `web_event_add_to_cart_rate`<br />**Type:** metric                                                                                         |
| <div>Value per Add to Cart (Page)</div>            | <br /><br />**Field Name:** `value_per_web_event_add_to_cart`<br />**Type:** metric                                                                                    |
| <div>Add to Cart Value (Page)</div>                | <br /><br />**Field Name:** `total_web_event_add_to_cart_value`<br />**Type:** metric                                                                                  |
| <div>Checkout Initiated (Page)</div>               | <br /><br />**Field Name:** `initiate_checkout`<br />**Type:** metric                                                                                                  |
| <div>Cost per Checkout Initiated (Page)</div>      | <br /><br />**Field Name:** `cost_per_initiate_checkout`<br />**Type:** metric                                                                                         |
| <div>Checkout Initiation Rate (Page)</div>         | <br /><br />**Field Name:** `initiate_checkout_rate`<br />**Type:** metric                                                                                             |
| <div>Value per Checkout Initiated (Page)</div>     | <br /><br />**Field Name:** `value_per_initiate_checkout`<br />**Type:** metric                                                                                        |
| <div>Checkout Initiation Value (Page)</div>        | <br /><br />**Field Name:** `total_initiate_checkout_value`<br />**Type:** metric                                                                                      |
| <div>Search (Page)</div>                           | <br /><br />**Field Name:** `page_event_search`<br />**Type:** metric                                                                                                  |
| <div>Cost per Search (Page)</div>                  | <br /><br />**Field Name:** `cost_per_page_event_search`<br />**Type:** metric                                                                                         |
| <div>Search Rate (Page)</div>                      | <br /><br />**Field Name:** `page_event_search_rate`<br />**Type:** metric                                                                                             |
| <div>Value per Search (Page)</div>                 | <br /><br />**Field Name:** `value_per_page_event_search`<br />**Type:** metric                                                                                        |
| <div>Search Value (Page)</div>                     | <br /><br />**Field Name:** `total_page_event_search_value`<br />**Type:** metric                                                                                      |
| <div>Orders Placed (Page)</div>                    | <br /><br />**Field Name:** `on_web_order`<br />**Type:** metric                                                                                                       |
| <div>Cost per Order Placed (Page)</div>            | <br /><br />**Field Name:** `cost_per_on_web_order`<br />**Type:** metric                                                                                              |
| <div>Orders Placed Rate (Page)</div>               | <br /><br />**Field Name:** `on_web_order_rate`<br />**Type:** metric                                                                                                  |
| <div>Value per Order Placed (Page)</div>           | <br /><br />**Field Name:** `value_per_on_web_order`<br />**Type:** metric                                                                                             |
| <div>Order Placed Value (Page)</div>               | <br /><br />**Field Name:** `total_on_web_order_value`<br />**Type:** metric                                                                                           |
| <div>Payment Info Added (Page)</div>               | <br /><br />**Field Name:** `add_billing`<br />**Type:** metric                                                                                                        |
| <div>Cost per Payment Info Add (Page)</div>        | <br /><br />**Field Name:** `cost_per_add_billing`<br />**Type:** metric                                                                                               |
| <div>Payment Info Add Rate (Page)</div>            | <br /><br />**Field Name:** `add_billing_rate`<br />**Type:** metric                                                                                                   |
| <div>Value per Payment Info Add (Page)</div>       | <br /><br />**Field Name:** `value_per_add_billing`<br />**Type:** metric                                                                                              |
| <div>Payment Info Add Value (Page)</div>           | <br /><br />**Field Name:** `total_add_billing_value`<br />**Type:** metric                                                                                            |
| <div>Adds to Wishlist (Page)</div>                 | <br /><br />**Field Name:** `on_web_add_to_wishlist`<br />**Type:** metric                                                                                             |
| <div>Cost per Add to Wishlist (Page)</div>         | <br /><br />**Field Name:** `cost_per_on_web_add_to_wishlist`<br />**Type:** metric                                                                                    |
| <div>Add to Wishlist Rate (Page)</div>             | <br /><br />**Field Name:** `on_web_add_to_wishlist_per_click`<br />**Type:** metric                                                                                   |
| <div>Value per Add to Wishlist (Page)</div>        | <br /><br />**Field Name:** `value_per_on_web_add_to_wishlist`<br />**Type:** metric                                                                                   |
| <div>Add to Wishlist Value (Page)</div>            | <br /><br />**Field Name:** `total_on_web_add_to_wishlist_value`<br />**Type:** metric                                                                                 |
| <div>Subscriptions (Page)</div>                    | <br /><br />**Field Name:** `on_web_subscribe`<br />**Type:** metric                                                                                                   |
| <div>Cost per Subscription (Page)</div>            | <br /><br />**Field Name:** `cost_per_on_web_subscribe`<br />**Type:** metric                                                                                          |
| <div>Subscription Rate (Page)</div>                | <br /><br />**Field Name:** `on_web_subscribe_per_click`<br />**Type:** metric                                                                                         |
| <div>Value per Subscription (Page)</div>           | <br /><br />**Field Name:** `value_per_on_web_subscribe`<br />**Type:** metric                                                                                         |
| <div>Subscription Value (Page)</div>               | <br /><br />**Field Name:** `total_on_web_subscribe_value`<br />**Type:** metric                                                                                       |
| <div>Form Submissions (Page)</div>                 | <br /><br />**Field Name:** `form`<br />**Type:** metric                                                                                                               |
| <div>Cost per Form Submission (Page)</div>         | <br /><br />**Field Name:** `cost_per_form`<br />**Type:** metric                                                                                                      |
| <div>Form Submission Rate (Page)</div>             | <br /><br />**Field Name:** `form_rate`<br />**Type:** metric                                                                                                          |
| <div>Value per Form Submission (Page)</div>        | <br /><br />**Field Name:** `value_per_form`<br />**Type:** metric                                                                                                     |
| <div>Form Submission Value (Page)</div>            | <br /><br />**Field Name:** `total_form_value`<br />**Type:** metric                                                                                                   |
| <div>Downloads (Page)</div>                        | <br /><br />**Field Name:** `download_start`<br />**Type:** metric                                                                                                     |
| <div>Cost per Download (Page)</div>                | <br /><br />**Field Name:** `cost_per_download_start`<br />**Type:** metric                                                                                            |
| <div>Download Rate (Page)</div>                    | <br /><br />**Field Name:** `download_start_rate`<br />**Type:** metric                                                                                                |
| <div>Value per Download (Page)</div>               | <br /><br />**Field Name:** `value_per_download_start`<br />**Type:** metric                                                                                           |
| <div>Download Value (Page)</div>                   | <br /><br />**Field Name:** `total_download_start_value`<br />**Type:** metric                                                                                         |
| <div>Custom Events (Web)</div>                     | <br /><br />**Field Name:** `custom_page_events`<br />**Type:** metric                                                                                                 |
| <div>Cost per Custom Event (Web)</div>             | <br /><br />**Field Name:** `cost_per_custom_page_event`<br />**Type:** metric                                                                                         |
| <div>Custom Event Rate (Web)</div>                 | <br /><br />**Field Name:** `custom_page_event_rate`<br />**Type:** metric                                                                                             |
| <div>Value per Custom Event (Web)</div>            | <br /><br />**Field Name:** `value_per_custom_page_event`<br />**Type:** metric                                                                                        |
| <div>Custom Event Value (Web)</div>                | <br /><br />**Field Name:** `custom_page_events_value`<br />**Type:** metric                                                                                           |
| <div>Page Browse</div>                             | The number of page browse events.<br /><br />**Field Name:** `page_browse_view`<br />**Type:** metric                                                                  |
| <div>Cost per Page Browse</div>                    | The average cost of each page browse event.<br /><br />**Field Name:** `cost_per_page_browse_view`<br />**Type:** metric                                               |
| <div>Page Browse Rate (%)</div>                    | The percentage of page browse events out of all click events.<br /><br />**Field Name:** `page_browse_view_rate`<br />**Type:** metric                                 |
| <div>Value per Page Browse</div>                   | The average value returned from page browse events.<br /><br />**Field Name:** `total_page_browse_view_value`<br />**Type:** metric                                    |
| <div>Total Page Browse Value</div>                 | The total value returned from page browse events.<br /><br />**Field Name:** `value_per_page_browse_view`<br />**Type:** metric                                        |
| <div>Contacts (Page)</div>                         | The number of page contact actions attributed to your ads.<br /><br />**Field Name:** `online_consult`<br />**Type:** metric                                           |
| <div>Cost per Contact (Page)</div>                 | The average cost per page contact action attributed to your ads.<br /><br />**Field Name:** `cost_per_online_consult`<br />**Type:** metric                            |
| <div>Unique Contact Rate (Page)</div>              | The percentage of page contact actions from all clicks attributed to your ads.<br /><br />**Field Name:** `online_consult_rate`<br />**Type:** metric                  |
| <div>Value per Contact (Page)</div>                | The average value per page contact action attributed to your ads.<br /><br />**Field Name:** `value_per_online_consult`<br />**Type:** metric                          |
| <div>Contact Value (Page)</div>                    | The total value of page contact actions attributed to your ads.<br /><br />**Field Name:** `total_online_consult_value`<br />**Type:** metric                          |
| <div>Registrations Completed (Page)</div>          | The number of page complete registration actions attributed to your ads.<br /><br />**Field Name:** `user_registration`<br />**Type:** metric                          |
| <div>Cost per Complete Registration (Page)</div>   | The average cost per page complete registration action attributed to your ads.<br /><br />**Field Name:** `cost_per_user_registration`<br />**Type:** metric           |
| <div>Registration Completion Rate (Page)</div>     | The percentage of page complete registration actions from all clicks attributed to your ads.<br /><br />**Field Name:** `user_registration_rate`<br />**Type:** metric |
| <div>Value per Complete Registration (Page)</div>  | The average value per page complete registration action attributed to your ads.<br /><br />**Field Name:** `value_per_user_registration`<br />**Type:** metric         |
| <div>Registration Completion Value (Page)</div>    | The total value of page complete registration actions attributed to your ads.<br /><br />**Field Name:** `total_user_registration_value`<br />**Type:** metric         |
| <div>Content Views (Page)</div>                    | The number of page view content actions attributed to your ads.<br /><br />**Field Name:** `page_content_view_events`<br />**Type:** metric                            |
| <div>Cost per Content View (Page)</div>            | The average cost per page view content action attributed to your ads.<br /><br />**Field Name:** `cost_per_page_content_view_event`<br />**Type:** metric              |
| <div>Content View Rate (Page)</div>                | The percentage of page view content actions from all clicks attributed to your ads.<br /><br />**Field Name:** `page_content_view_event_rate`<br />**Type:** metric    |
| <div>Value per Content View (Page)</div>           | The average value per page view content action attributed to your ads.<br /><br />**Field Name:** `value_per_page_content_view_event`<br />**Type:** metric            |
| <div>Content View Value (Page)</div>               | The total value of page view content actions attributed to your ads.<br /><br />**Field Name:** `total_page_view_content_events_value`<br />**Type:** metric           |
| <div>Product Details Page Browse</div>             | The number of product details page browse events.<br /><br />**Field Name:** `product_details_page_browse`<br />**Type:** metric                                       |
| <div>Product Details Page Browse Cost</div>        | The average cost of each product details page browse event.<br /><br />**Field Name:** `cost_per_product_details_page_browse`<br />**Type:** metric                    |
| <div>Product Details Page Browse Rate (%)</div>    | The percentage of product details page browse events out of all click events.<br /><br />**Field Name:** `product_details_page_browse_rate`<br />**Type:** metric      |
| <div>Value per Product Details Page Browse</div>   | The average value returned from product details page browse events.<br /><br />**Field Name:** `value_per_product_details_page_browse`<br />**Type:** metric           |
| <div>Total Product Details Page Browse Value</div> | The total value returned from product details page browse events.<br /><br />**Field Name:** `total_product_details_page_browse_value`<br />**Type:** metric           |

### Onsite Metrics

|                                                           |                                                                                        |
| --------------------------------------------------------- | -------------------------------------------------------------------------------------- |
| <div>Adds to wishlist (onsite)</div>                      | <br /><br />**Field Name:** `onsite_add_to_wishlist`<br />**Type:** metric             |
| <div>Cost per add to wishlist (onsite)</div>              | <br /><br />**Field Name:** `cost_per_onsite_add_to_wishlist`<br />**Type:** metric    |
| <div>Unique add to wishlist rate (onsite)</div>           | <br /><br />**Field Name:** `onsite_add_to_wishlist_rate`<br />**Type:** metric        |
| <div>Value per add to wishlist (onsite)</div>             | <br /><br />**Field Name:** `value_per_onsite_add_to_wishlist`<br />**Type:** metric   |
| <div>Add to wishlist value (onsite)</div>                 | <br /><br />**Field Name:** `total_onsite_add_to_wishlist_value`<br />**Type:** metric |
| <div>Total Add Billing (Onsite)</div>                     | <br /><br />**Field Name:** `onsite_add_billing`<br />**Type:** metric                 |
| <div>Cost per Add Billing (Onsite)</div>                  | <br /><br />**Field Name:** `cost_per_onsite_add_billing`<br />**Type:** metric        |
| <div>Add Billing Rate (Onsite) (%)</div>                  | <br /><br />**Field Name:** `onsite_add_billing_rate`<br />**Type:** metric            |
| <div>Value per Add Billing (Onsite)</div>                 | <br /><br />**Field Name:** `value_per_onsite_add_billing`<br />**Type:** metric       |
| <div>Total Add Billing Value (Onsite)</div>               | <br /><br />**Field Name:** `total_onsite_add_billing_value`<br />**Type:** metric     |
| <div>Form submissions (onsite)</div>                      | <br /><br />**Field Name:** `onsite_form`<br />**Type:** metric                        |
| <div>Cost per form submitted (onsite)</div>               | <br /><br />**Field Name:** `cost_per_onsite_form`<br />**Type:** metric               |
| <div>Unique form submission rate (onsite)</div>           | <br /><br />**Field Name:** `onsite_form_rate`<br />**Type:** metric                   |
| <div>Value per form submitted (onsite)</div>              | <br /><br />**Field Name:** `value_per_onsite_form`<br />**Type:** metric              |
| <div>Form submission value (onsite)</div>                 | <br /><br />**Field Name:** `total_onsite_form_value`<br />**Type:** metric            |
| <div>Total App Store Click (Onsite)</div>                 | <br /><br />**Field Name:** `onsite_download_start`<br />**Type:** metric              |
| <div>Cost per App Store Click (Onsite)</div>              | <br /><br />**Field Name:** `cost_per_onsite_download_start`<br />**Type:** metric     |
| <div>App Store Click Rate (Onsite) (%)</div>              | <br /><br />**Field Name:** `onsite_download_start_rate`<br />**Type:** metric         |
| <div>Total Destination Visit (Onsite)</div>               | <br /><br />**Field Name:** `onsite_destination_visits`<br />**Type:** metric          |
| <div>Cost per Destination Visit (Onsite)</div>            | <br /><br />**Field Name:** `cost_per_onsite_destination_visit`<br />**Type:** metric  |
| <div>Destination Visit Rate (Onsite)</div>                | <br /><br />**Field Name:** `onsite_destination_visit_rate`<br />**Type:** metric      |
| <div>Page Views (Onsite)</div>                            | <br /><br />**Field Name:** `ix_page_view_count`<br />**Type:** metric                 |
| <div>Cost per Page Views (Onsite)</div>                   | <br /><br />**Field Name:** `cost_per_ix_page_view_count`<br />**Type:** metric        |
| <div>Page Views Rate (Onsite) (%)</div>                   | <br /><br />**Field Name:** `ix_page_view_count_rate`<br />**Type:** metric            |
| <div>Outbound clicks (Onsite)</div>                       | <br /><br />**Field Name:** `ix_button_click_count`<br />**Type:** metric              |
| <div>Cost per call-to-action button clicks (Onsite)</div> | <br /><br />**Field Name:** `cost_per_ix_button_click_count`<br />**Type:** metric     |
| <div>Call-to-action button clicks rate (Onsite) (%)</div> | <br /><br />**Field Name:** `ix_button_click_count_rate`<br />**Type:** metric         |
| <div>Product Clicks (Instant Experience)</div>            | <br /><br />**Field Name:** `ix_product_click_count`<br />**Type:** metric             |
| <div>Cost per Product Clicks (Onsite)</div>               | <br /><br />**Field Name:** `cost_per_ix_product_click_count`<br />**Type:** metric    |
| <div>Product Clicks Rate (Onsite) (%)</div>               | <br /><br />**Field Name:** `ix_product_click_count_rate`<br />**Type:** metric        |

### Spend

|                                    |                                                                   |
| ---------------------------------- | ----------------------------------------------------------------- |
| <div>Net cost</div>                | <br /><br />**Field Name:** `billed_cost`<br />**Type:** metric   |
| <div>Cost Charged by Cash</div>    | <br /><br />**Field Name:** `cash_spend`<br />**Type:** metric    |
| <div>Cost Charged by Voucher</div> | <br /><br />**Field Name:** `voucher_spend`<br />**Type:** metric |

### In App Metrics

|                                                        |                                                                                                                                                                                 |
| ------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| <div>Real-time App Install</div>                       | <br /><br />**Field Name:** `real_time_app_install`<br />**Type:** metric                                                                                                       |
| <div>Cost per Real-time App Install</div>              | <br /><br />**Field Name:** `real_time_app_install_cost`<br />**Type:** metric                                                                                                  |
| <div>App Install</div>                                 | <br /><br />**Field Name:** `app_install`<br />**Type:** metric                                                                                                                 |
| <div>Cost per App Install</div>                        | <br /><br />**Field Name:** `cost_per_app_install`<br />**Type:** metric                                                                                                        |
| <div>Unique registrations (app)</div>                  | <br /><br />**Field Name:** `registration`<br />**Type:** metric                                                                                                                |
| <div>Unique cost per registration (app)</div>          | <br /><br />**Field Name:** `cost_per_registration`<br />**Type:** metric                                                                                                       |
| <div>Unique registration rate (app)</div>              | <br /><br />**Field Name:** `registration_rate`<br />**Type:** metric                                                                                                           |
| <div>Registrations (app)</div>                         | <br /><br />**Field Name:** `total_registration`<br />**Type:** metric                                                                                                          |
| <div>Cost per registration (app)</div>                 | <br /><br />**Field Name:** `cost_per_total_registration`<br />**Type:** metric                                                                                                 |
| <div>Unique purchases (app)</div>                      | <br /><br />**Field Name:** `purchase`<br />**Type:** metric                                                                                                                    |
| <div>Unique cost per purchase (app)</div>              | <br /><br />**Field Name:** `cost_per_purchase`<br />**Type:** metric                                                                                                           |
| <div>Unique purchase rate (app)</div>                  | <br /><br />**Field Name:** `purchase_rate`<br />**Type:** metric                                                                                                               |
| <div>Purchases (app)</div>                             | <br /><br />**Field Name:** `total_purchase`<br />**Type:** metric                                                                                                              |
| <div>Cost per purchase (app)</div>                     | <br /><br />**Field Name:** `cost_per_total_purchase`<br />**Type:** metric                                                                                                     |
| <div>Value per purchase (app)</div>                    | <br /><br />**Field Name:** `value_per_total_purchase`<br />**Type:** metric                                                                                                    |
| <div>Purchase value (app)</div>                        | <br /><br />**Field Name:** `total_purchase_value`<br />**Type:** metric                                                                                                        |
| <div>Purchase ROAS (app)</div>                         | <br /><br />**Field Name:** `total_active_pay_roas`<br />**Type:** metric                                                                                                       |
| <div>Unique adds to cart (app)</div>                   | <br /><br />**Field Name:** `app_event_add_to_cart`<br />**Type:** metric                                                                                                       |
| <div>Unique cost per add to cart (app)</div>           | <br /><br />**Field Name:** `cost_per_app_event_add_to_cart`<br />**Type:** metric                                                                                              |
| <div>Unique add to cart rate (app)</div>               | <br /><br />**Field Name:** `app_event_add_to_cart_rate`<br />**Type:** metric                                                                                                  |
| <div>Adds to cart (app)</div>                          | <br /><br />**Field Name:** `total_app_event_add_to_cart`<br />**Type:** metric                                                                                                 |
| <div>Cost per add to cart (app)</div>                  | <br /><br />**Field Name:** `cost_per_total_app_event_add_to_cart`<br />**Type:** metric                                                                                        |
| <div>Value per add to cart (app)</div>                 | <br /><br />**Field Name:** `value_per_total_app_event_add_to_cart`<br />**Type:** metric                                                                                       |
| <div>Add to cart value (app)</div>                     | <br /><br />**Field Name:** `total_app_event_add_to_cart_value`<br />**Type:** metric                                                                                           |
| <div>Unique checkouts (app)</div>                      | <br /><br />**Field Name:** `checkout`<br />**Type:** metric                                                                                                                    |
| <div>Unique cost per checkout (app)</div>              | <br /><br />**Field Name:** `cost_per_checkout`<br />**Type:** metric                                                                                                           |
| <div>Unique checkout rate (app)</div>                  | <br /><br />**Field Name:** `checkout_rate`<br />**Type:** metric                                                                                                               |
| <div>Checkouts (app)</div>                             | <br /><br />**Field Name:** `total_checkout`<br />**Type:** metric                                                                                                              |
| <div>Cost per checkout (app)</div>                     | <br /><br />**Field Name:** `cost_per_total_checkout`<br />**Type:** metric                                                                                                     |
| <div>Value per checkout (app)</div>                    | <br /><br />**Field Name:** `value_per_checkout`<br />**Type:** metric                                                                                                          |
| <div>Checkout value (app)</div>                        | <br /><br />**Field Name:** `total_checkout_value`<br />**Type:** metric                                                                                                        |
| <div>Unique content views (app)</div>                  | <br /><br />**Field Name:** `view_content`<br />**Type:** metric                                                                                                                |
| <div>Unique cost per content view (app)</div>          | <br /><br />**Field Name:** `cost_per_view_content`<br />**Type:** metric                                                                                                       |
| <div>Unique content view rate (app)</div>              | <br /><br />**Field Name:** `view_content_rate`<br />**Type:** metric                                                                                                           |
| <div>Content views (app)</div>                         | <br /><br />**Field Name:** `total_view_content`<br />**Type:** metric                                                                                                          |
| <div>Cost per content view (app)</div>                 | <br /><br />**Field Name:** `cost_per_total_view_content`<br />**Type:** metric                                                                                                 |
| <div>Value per content view (app)</div>                | <br /><br />**Field Name:** `value_per_total_view_content`<br />**Type:** metric                                                                                                |
| <div>Content view value (app)</div>                    | <br /><br />**Field Name:** `total_view_content_value`<br />**Type:** metric                                                                                                    |
| <div>Day 1 retention</div>                             | <br /><br />**Field Name:** `next_day_open`<br />**Type:** metric                                                                                                               |
| <div>Cost per unique day 1 retention</div>             | <br /><br />**Field Name:** `cost_per_next_day_open`<br />**Type:** metric                                                                                                      |
| <div>Unique day 1 retention rate (%)</div>             | <br /><br />**Field Name:** `next_day_open_rate`<br />**Type:** metric                                                                                                          |
| <div>Total day 1 retention</div>                       | <br /><br />**Field Name:** `total_next_day_open`<br />**Type:** metric                                                                                                         |
| <div>Cost per day 1 retention</div>                    | <br /><br />**Field Name:** `cost_per_total_next_day_open`<br />**Type:** metric                                                                                                |
| <div>Unique payment info adds (app)</div>              | <br /><br />**Field Name:** `add_payment_info`<br />**Type:** metric                                                                                                            |
| <div>Unique cost per payment info add (app)</div>      | <br /><br />**Field Name:** `cost_per_add_payment_info`<br />**Type:** metric                                                                                                   |
| <div>Unique payment info add rate (app)</div>          | <br /><br />**Field Name:** `add_payment_info_rate`<br />**Type:** metric                                                                                                       |
| <div>Payment info adds (app)</div>                     | <br /><br />**Field Name:** `total_add_payment_info`<br />**Type:** metric                                                                                                      |
| <div>Cost per payment info add (app)</div>             | <br /><br />**Field Name:** `cost_total_add_payment_info`<br />**Type:** metric                                                                                                 |
| <div>Unique adds to wishlist (app)</div>               | <br /><br />**Field Name:** `add_to_wishlist`<br />**Type:** metric                                                                                                             |
| <div>Unique cost per add to wishlist (app)</div>       | <br /><br />**Field Name:** `cost_per_add_to_wishlist`<br />**Type:** metric                                                                                                    |
| <div>Unique add to wishlist rate (app)</div>           | <br /><br />**Field Name:** `add_to_wishlist_rate`<br />**Type:** metric                                                                                                        |
| <div>Adds to wishlist (app)</div>                      | <br /><br />**Field Name:** `total_add_to_wishlist`<br />**Type:** metric                                                                                                       |
| <div>Cost per add to wishlist (app)</div>              | <br /><br />**Field Name:** `cost_per_total_add_to_wishlist`<br />**Type:** metric                                                                                              |
| <div>Value per add to wishlist (app)</div>             | <br /><br />**Field Name:** `value_per_total_add_to_wishlist`<br />**Type:** metric                                                                                             |
| <div>Add to wishlist value (app)</div>                 | <br /><br />**Field Name:** `total_add_to_wishlist_value`<br />**Type:** metric                                                                                                 |
| <div>Unique app launches (app)</div>                   | <br /><br />**Field Name:** `launch_app`<br />**Type:** metric                                                                                                                  |
| <div>Unique cost per app launch (app)</div>            | <br /><br />**Field Name:** `cost_per_launch_app`<br />**Type:** metric                                                                                                         |
| <div>Unique app launch rate (app)</div>                | <br /><br />**Field Name:** `launch_app_rate`<br />**Type:** metric                                                                                                             |
| <div>App launches (app)</div>                          | <br /><br />**Field Name:** `total_launch_app`<br />**Type:** metric                                                                                                            |
| <div>Cost per app launch (app)</div>                   | <br /><br />**Field Name:** `cost_per_total_launch_app`<br />**Type:** metric                                                                                                   |
| <div>Unique tutorials completed (app)</div>            | <br /><br />**Field Name:** `complete_tutorial`<br />**Type:** metric                                                                                                           |
| <div>Unique cost per complete tutorial (app)</div>     | <br /><br />**Field Name:** `cost_per_complete_tutorial`<br />**Type:** metric                                                                                                  |
| <div>Unique tutorial completion rate (app)</div>       | <br /><br />**Field Name:** `complete_tutorial_rate`<br />**Type:** metric                                                                                                      |
| <div>Tutorials completed (app)</div>                   | <br /><br />**Field Name:** `total_complete_tutorial`<br />**Type:** metric                                                                                                     |
| <div>Cost per complete tutorial (app)</div>            | <br /><br />**Field Name:** `cost_per_total_complete_tutorial`<br />**Type:** metric                                                                                            |
| <div>Value per complete tutorial (app)</div>           | <br /><br />**Field Name:** `value_per_total_complete_tutorial`<br />**Type:** metric                                                                                           |
| <div>Tutorial completion value (app)</div>             | <br /><br />**Field Name:** `total_complete_tutorial_value`<br />**Type:** metric                                                                                               |
| <div>Unique groups created (app)</div>                 | <br /><br />**Field Name:** `create_group`<br />**Type:** metric                                                                                                                |
| <div>Unique cost per group created (app)</div>         | <br /><br />**Field Name:** `cost_per_create_group`<br />**Type:** metric                                                                                                       |
| <div>Unique group creation rate (app)</div>            | <br /><br />**Field Name:** `create_group_rate`<br />**Type:** metric                                                                                                           |
| <div>Groups created (app)</div>                        | <br /><br />**Field Name:** `total_create_group`<br />**Type:** metric                                                                                                          |
| <div>Cost per group created (app)</div>                | <br /><br />**Field Name:** `cost_per_total_create_group`<br />**Type:** metric                                                                                                 |
| <div>Value per group created (app)</div>               | <br /><br />**Field Name:** `value_per_total_create_group`<br />**Type:** metric                                                                                                |
| <div>Group creation value (app)</div>                  | <br /><br />**Field Name:** `total_create_group_value`<br />**Type:** metric                                                                                                    |
| <div>Unique group joins (app)</div>                    | <br /><br />**Field Name:** `join_group`<br />**Type:** metric                                                                                                                  |
| <div>Unique cost per group join (app)</div>            | <br /><br />**Field Name:** `cost_per_join_group`<br />**Type:** metric                                                                                                         |
| <div>Unique group joining rate (app)</div>             | <br /><br />**Field Name:** `join_group_rate`<br />**Type:** metric                                                                                                             |
| <div>Group joins (app)</div>                           | <br /><br />**Field Name:** `total_join_group`<br />**Type:** metric                                                                                                            |
| <div>Cost per group join (app)</div>                   | <br /><br />**Field Name:** `cost_per_total_join_group`<br />**Type:** metric                                                                                                   |
| <div>Value per group join (app)</div>                  | <br /><br />**Field Name:** `value_per_total_join_group`<br />**Type:** metric                                                                                                  |
| <div>Group joining value (app)</div>                   | <br /><br />**Field Name:** `total_join_group_value`<br />**Type:** metric                                                                                                      |
| <div>Unique roles created (app)</div>                  | <br /><br />**Field Name:** `create_gamerole`<br />**Type:** metric                                                                                                             |
| <div>Unique cost per role created (app)</div>          | <br /><br />**Field Name:** `cost_per_create_gamerole`<br />**Type:** metric                                                                                                    |
| <div>Unique role creation rate (app)</div>             | <br /><br />**Field Name:** `create_gamerole_rate`<br />**Type:** metric                                                                                                        |
| <div>Roles created (app)</div>                         | <br /><br />**Field Name:** `total_create_gamerole`<br />**Type:** metric                                                                                                       |
| <div>Cost per role created (app)</div>                 | <br /><br />**Field Name:** `cost_per_total_create_gamerole`<br />**Type:** metric                                                                                              |
| <div>Value per role created (app)</div>                | <br /><br />**Field Name:** `value_per_total_create_gamerole`<br />**Type:** metric                                                                                             |
| <div>Role creation value (app)</div>                   | <br /><br />**Field Name:** `total_create_gamerole_value`<br />**Type:** metric                                                                                                 |
| <div>Unique credit spends (app)</div>                  | <br /><br />**Field Name:** `spend_credits`<br />**Type:** metric                                                                                                               |
| <div>Unique cost per credit spend (app)</div>          | <br /><br />**Field Name:** `cost_per_spend_credits`<br />**Type:** metric                                                                                                      |
| <div>Unique credit spend rate (app)</div>              | <br /><br />**Field Name:** `spend_credits_rate`<br />**Type:** metric                                                                                                          |
| <div>Credit spends (app)</div>                         | <br /><br />**Field Name:** `total_spend_credits`<br />**Type:** metric                                                                                                         |
| <div>Cost per credit spend (app)</div>                 | <br /><br />**Field Name:** `cost_per_total_spend_credits`<br />**Type:** metric                                                                                                |
| <div>Value per credit spend (app)</div>                | <br /><br />**Field Name:** `value_per_total_spend_credits`<br />**Type:** metric                                                                                               |
| <div>Credit spend value (app)</div>                    | <br /><br />**Field Name:** `total_spend_credits_value`<br />**Type:** metric                                                                                                   |
| <div>Unique levels achieved (app)</div>                | <br /><br />**Field Name:** `achieve_level`<br />**Type:** metric                                                                                                               |
| <div>Unique cost per unique level achieved (app)</div> | <br /><br />**Field Name:** `cost_per_achieve_level`<br />**Type:** metric                                                                                                      |
| <div>Unique level achievement rate (app)</div>         | <br /><br />**Field Name:** `achieve_level_rate`<br />**Type:** metric                                                                                                          |
| <div>Levels achieved (app)</div>                       | <br /><br />**Field Name:** `total_achieve_level`<br />**Type:** metric                                                                                                         |
| <div>Cost per level achieved (app)</div>               | <br /><br />**Field Name:** `cost_per_total_achieve_level`<br />**Type:** metric                                                                                                |
| <div>Value per level achieved (app)</div>              | <br /><br />**Field Name:** `value_per_total_achieve_level`<br />**Type:** metric                                                                                               |
| <div>Level achievement value (app)</div>               | <br /><br />**Field Name:** `total_achieve_level_value`<br />**Type:** metric                                                                                                   |
| <div>Unique achievements unlocked (app)</div>          | <br /><br />**Field Name:** `unlock_achievement`<br />**Type:** metric                                                                                                          |
| <div>Unique cost per achievement unlocked (app)</div>  | <br /><br />**Field Name:** `cost_per_unlock_achievement`<br />**Type:** metric                                                                                                 |
| <div>Unique unlocked achievement rate (app)</div>      | <br /><br />**Field Name:** `unlock_achievement_rate`<br />**Type:** metric                                                                                                     |
| <div>Achievements unlocked (app)</div>                 | <br /><br />**Field Name:** `total_unlock_achievement`<br />**Type:** metric                                                                                                    |
| <div>Cost per achievement unlocked (app)</div>         | <br /><br />**Field Name:** `cost_per_total_unlock_achievement`<br />**Type:** metric                                                                                           |
| <div>Value per achievement unlocked (app)</div>        | <br /><br />**Field Name:** `value_per_total_unlock_achievement`<br />**Type:** metric                                                                                          |
| <div>Unlocked achievement value (app)</div>            | <br /><br />**Field Name:** `total_unlock_achievement_value`<br />**Type:** metric                                                                                              |
| <div>Unique leads generated (app)</div>                | <br /><br />**Field Name:** `sales_lead`<br />**Type:** metric                                                                                                                  |
| <div>Unique cost per lead generated (app)</div>        | <br /><br />**Field Name:** `cost_per_sales_lead`<br />**Type:** metric                                                                                                         |
| <div>Unique lead generation rate (app)</div>           | <br /><br />**Field Name:** `sales_lead_rate`<br />**Type:** metric                                                                                                             |
| <div>Leads generated (app)</div>                       | <br /><br />**Field Name:** `total_sales_lead`<br />**Type:** metric                                                                                                            |
| <div>Cost per lead generated (app)</div>               | <br /><br />**Field Name:** `cost_per_total_sales_lead`<br />**Type:** metric                                                                                                   |
| <div>Value per lead generated (app)</div>              | <br /><br />**Field Name:** `value_per_total_sales_lead`<br />**Type:** metric                                                                                                  |
| <div>Lead generation value (app)</div>                 | <br /><br />**Field Name:** `total_sales_lead_value`<br />**Type:** metric                                                                                                      |
| <div>Unique in-app ad clicks (app)</div>               | <br /><br />**Field Name:** `in_app_ad_click`<br />**Type:** metric                                                                                                             |
| <div>Unique cost per in-app ad click (app)</div>       | <br /><br />**Field Name:** `cost_per_in_app_ad_click`<br />**Type:** metric                                                                                                    |
| <div>In-app ad click rate (app)</div>                  | <br /><br />**Field Name:** `in_app_ad_click_rate`<br />**Type:** metric                                                                                                        |
| <div>In-app ad clicks (app)</div>                      | <br /><br />**Field Name:** `total_in_app_ad_click`<br />**Type:** metric                                                                                                       |
| <div>Cost per in-app ad click (app)</div>              | <br /><br />**Field Name:** `cost_per_total_in_app_ad_click`<br />**Type:** metric                                                                                              |
| <div>Value per in-app ad click (app)</div>             | <br /><br />**Field Name:** `value_per_total_in_app_ad_click`<br />**Type:** metric                                                                                             |
| <div>In-app ad click value (app)</div>                 | <br /><br />**Field Name:** `total_in_app_ad_click_value`<br />**Type:** metric                                                                                                 |
| <div>Unique in-app ad impressions (app)</div>          | <br /><br />**Field Name:** `in_app_ad_impr`<br />**Type:** metric                                                                                                              |
| <div>Unique cost per in-app ad impression (app)</div>  | <br /><br />**Field Name:** `cost_per_in_app_ad_impr`<br />**Type:** metric                                                                                                     |
| <div>In-app ad impression rate (app)</div>             | <br /><br />**Field Name:** `in_app_ad_impr_rate`<br />**Type:** metric                                                                                                         |
| <div>In-app ad impressions (app)</div>                 | <br /><br />**Field Name:** `total_in_app_ad_impr`<br />**Type:** metric                                                                                                        |
| <div>Cost per in-app ad impression (app)</div>         | <br /><br />**Field Name:** `cost_per_total_in_app_ad_impr`<br />**Type:** metric                                                                                               |
| <div>Value per in-app ad impression (app)</div>        | <br /><br />**Field Name:** `value_per_total_in_app_ad_impr`<br />**Type:** metric                                                                                              |
| <div>In-app ad impression value (app)</div>            | <br /><br />**Field Name:** `total_in_app_ad_impr_value`<br />**Type:** metric                                                                                                  |
| <div>Unique loan applications (app)</div>              | <br /><br />**Field Name:** `loan_apply`<br />**Type:** metric                                                                                                                  |
| <div>Unique cost per loan application (app)</div>      | <br /><br />**Field Name:** `cost_per_loan_apply`<br />**Type:** metric                                                                                                         |
| <div>Unique loan application rate (app)</div>          | <br /><br />**Field Name:** `loan_apply_rate`<br />**Type:** metric                                                                                                             |
| <div>Loan applications (app)</div>                     | <br /><br />**Field Name:** `total_loan_apply`<br />**Type:** metric                                                                                                            |
| <div>Cost per loan application (app)</div>             | <br /><br />**Field Name:** `cost_per_total_loan_apply`<br />**Type:** metric                                                                                                   |
| <div>Unique loan approvals (app)</div>                 | <br /><br />**Field Name:** `loan_credit`<br />**Type:** metric                                                                                                                 |
| <div>Unique cost per loan approval (app)</div>         | <br /><br />**Field Name:** `cost_per_loan_credit`<br />**Type:** metric                                                                                                        |
| <div>Unique loan approval rate (app)</div>             | <br /><br />**Field Name:** `loan_credit_rate`<br />**Type:** metric                                                                                                            |
| <div>Loan approvals (app)</div>                        | <br /><br />**Field Name:** `total_loan_credit`<br />**Type:** metric                                                                                                           |
| <div>Cost per loan approval (app)</div>                | <br /><br />**Field Name:** `cost_per_total_loan_credit`<br />**Type:** metric                                                                                                  |
| <div>Unique loan disbursals (app)</div>                | <br /><br />**Field Name:** `loan_disbursement`<br />**Type:** metric                                                                                                           |
| <div>Unique cost per loan disbursal (app)</div>        | <br /><br />**Field Name:** `cost_per_loan_disbursement`<br />**Type:** metric                                                                                                  |
| <div>Unique loan disbursal rate (app)</div>            | <br /><br />**Field Name:** `loan_disbursement_rate`<br />**Type:** metric                                                                                                      |
| <div>Loan disbursals (app)</div>                       | <br /><br />**Field Name:** `total_loan_disbursement`<br />**Type:** metric                                                                                                     |
| <div>Cost per loan disbursal (app)</div>               | <br /><br />**Field Name:** `cost_per_total_loan_disbursement`<br />**Type:** metric                                                                                            |
| <div>Unique logins (app)</div>                         | <br /><br />**Field Name:** `login`<br />**Type:** metric                                                                                                                       |
| <div>Unique cost per login (app)</div>                 | <br /><br />**Field Name:** `cost_per_login`<br />**Type:** metric                                                                                                              |
| <div>Unique login rate (app)</div>                     | <br /><br />**Field Name:** `login_rate`<br />**Type:** metric                                                                                                                  |
| <div>Logins (app)</div>                                | <br /><br />**Field Name:** `total_login`<br />**Type:** metric                                                                                                                 |
| <div>Cost per login (app)</div>                        | <br /><br />**Field Name:** `cost_per_total_login`<br />**Type:** metric                                                                                                        |
| <div>Unique ratings (app)</div>                        | <br /><br />**Field Name:** `ratings`<br />**Type:** metric                                                                                                                     |
| <div>Unique cost per rating (app)</div>                | <br /><br />**Field Name:** `cost_per_ratings`<br />**Type:** metric                                                                                                            |
| <div>Unique rate rate (%)</div>                        | <br /><br />**Field Name:** `ratings_rate`<br />**Type:** metric                                                                                                                |
| <div>Ratings (app)</div>                               | <br /><br />**Field Name:** `total_ratings`<br />**Type:** metric                                                                                                               |
| <div>Cost per rating (app)</div>                       | <br /><br />**Field Name:** `cost_per_total_ratings`<br />**Type:** metric                                                                                                      |
| <div>Value per rating (app)</div>                      | <br /><br />**Field Name:** `value_per_total_ratings`<br />**Type:** metric                                                                                                     |
| <div>Rating value (app)</div>                          | <br /><br />**Field Name:** `total_ratings_value`<br />**Type:** metric                                                                                                         |
| <div>Unique searches (app)</div>                       | <br /><br />**Field Name:** `search`<br />**Type:** metric                                                                                                                      |
| <div>Unique cost per search (app)</div>                | <br /><br />**Field Name:** `cost_per_search`<br />**Type:** metric                                                                                                             |
| <div>Unique search rate (app)</div>                    | <br /><br />**Field Name:** `search_rate`<br />**Type:** metric                                                                                                                 |
| <div>Searches (app)</div>                              | <br /><br />**Field Name:** `total_search`<br />**Type:** metric                                                                                                                |
| <div>Cost per search (app)</div>                       | <br /><br />**Field Name:** `cost_per_total_search`<br />**Type:** metric                                                                                                       |
| <div>Unique trial started (app)</div>                  | <br /><br />**Field Name:** `start_trial`<br />**Type:** metric                                                                                                                 |
| <div>Unique cost per trial started (app)</div>         | <br /><br />**Field Name:** `cost_per_start_trial`<br />**Type:** metric                                                                                                        |
| <div>Unique trial start rate (app)</div>               | <br /><br />**Field Name:** `start_trial_rate`<br />**Type:** metric                                                                                                            |
| <div>Trials started (app)</div>                        | <br /><br />**Field Name:** `total_start_trial`<br />**Type:** metric                                                                                                           |
| <div>Cost per trial started (app)</div>                | <br /><br />**Field Name:** `cost_per_total_start_trial`<br />**Type:** metric                                                                                                  |
| <div>Unique subscriptions (app)</div>                  | <br /><br />**Field Name:** `subscribe`<br />**Type:** metric                                                                                                                   |
| <div>Unique cost per subscription (app)</div>          | <br /><br />**Field Name:** `cost_per_subscribe`<br />**Type:** metric                                                                                                          |
| <div>Unique subscription rate (app)</div>              | <br /><br />**Field Name:** `subscribe_rate`<br />**Type:** metric                                                                                                              |
| <div>Subscriptions (app)</div>                         | <br /><br />**Field Name:** `total_subscribe`<br />**Type:** metric                                                                                                             |
| <div>Cost per subscription (app)</div>                 | <br /><br />**Field Name:** `cost_per_total_subscribe`<br />**Type:** metric                                                                                                    |
| <div>Value per subscription (app)</div>                | <br /><br />**Field Name:** `value_per_total_subscribe`<br />**Type:** metric                                                                                                   |
| <div>Subscription value (app)</div>                    | <br /><br />**Field Name:** `total_subscribe_value`<br />**Type:** metric                                                                                                       |
| <div>Unique custom events (App)</div>                  | <br /><br />**Field Name:** `unique_custom_app_events`<br />**Type:** metric                                                                                                    |
| <div>Cost per unique custom event (App)</div>          | <br /><br />**Field Name:** `cost_per_unique_custom_app_event`<br />**Type:** metric                                                                                            |
| <div>Custom event rate (App) (%)</div>                 | <br /><br />**Field Name:** `custom_app_event_rate`<br />**Type:** metric                                                                                                       |
| <div>Custom events (App)</div>                         | <br /><br />**Field Name:** `custom_app_events`<br />**Type:** metric                                                                                                           |
| <div>Cost per custom event (App)</div>                 | <br /><br />**Field Name:** `cost_per_custom_app_event`<br />**Type:** metric                                                                                                   |
| <div>Value per custom event (App)</div>                | <br /><br />**Field Name:** `value_per_custom_app_event`<br />**Type:** metric                                                                                                  |
| <div>Custom event value (App)</div>                    | <br /><br />**Field Name:** `custom_app_events_value`<br />**Type:** metric                                                                                                     |
| <div>Unique ads impression event</div>                 | <br /><br />**Field Name:** `unique_ad_impression_events`<br />**Type:** metric                                                                                                 |
| <div>Cost per unique ads impression event</div>        | <br /><br />**Field Name:** `cost_per_unique_ad_impression_event`<br />**Type:** metric                                                                                         |
| <div>Customized ads impression event rate</div>        | <br /><br />**Field Name:** `customized_ad_impression_event_rate`<br />**Type:** metric                                                                                         |
| <div>Total ads impression event</div>                  | <br /><br />**Field Name:** `ads_impression_events`<br />**Type:** metric                                                                                                       |
| <div>Cost per ads impression event</div>               | <br /><br />**Field Name:** `cost_pre_ad_impression_event`<br />**Type:** metric                                                                                                |
| <div>Value per ads impression event</div>              | <br /><br />**Field Name:** `value_per_ad_impression_event`<br />**Type:** metric                                                                                               |
| <div>Total ads impression event value</div>            | <br /><br />**Field Name:** `total_ad_impression_events_value`<br />**Type:** metric                                                                                            |
| <div>Total Ads impression ROAS</div>                   | <br /><br />**Field Name:** `total_ad_impression_roas`<br />**Type:** metric                                                                                                    |
| <div>Day 7 retentions</div>                            | Number of Day 7 retentions from your mobile app counted as app events and attributed to your ads.<br /><br />**Field Name:** `day7_retention`<br />**Type:** metric             |
| <div>Cost per Day 7 retention</div>                    | Average cost per Day 7 retention attributed to your ad.<br /><br />**Field Name:** `cost_per_day7_retention`<br />**Type:** metric                                              |
| <div>Day 7 retention rate (%)</div>                    | Percentage of Day 7 retentions out of all app install events.<br /><br />**Field Name:** `day7_retention_rate`<br />**Type:** metric                                            |
| <div>Day 7 retentions</div>                            | Total number of Day 7 retentions from your mobile app counted as app events and attributed to your ads.<br /><br />**Field Name:** `total_day7_retention`<br />**Type:** metric |
| <div>Cost per Day 7 retention</div>                    | Average cost per Day 7 retention attributed to your ad.<br /><br />**Field Name:** `cost_per_total_day7_retention`<br />**Type:** metric                                        |
| <div>Value per Day 7 retention</div>                   | Average value per Day 7 retention attributed to your ad.<br /><br />**Field Name:** `value_per_total_day7_retention`<br />**Type:** metric                                      |
| <div>Day 7 retention value</div>                       | Total value returned from all Day 7 retentions.<br /><br />**Field Name:** `total_day7_retention_value`<br />**Type:** metric                                                   |
| <div>Day 0 purchase ROAS</div>                         | Total return on ad spend (ROAS) from purchase actions within 24 hours of app install.<br /><br />**Field Name:** `total_purchase_roas_day0`<br />**Type:** metric               |
| <div>Day 2 purchase ROAS</div>                         | Total return on ad spend (ROAS) from purchase actions within 72 hours of app install.<br /><br />**Field Name:** `total_purchase_roas_day2`<br />**Type:** metric               |
| <div>Day 6 purchase ROAS</div>                         | Total return on ad spend (ROAS) from purchase actions within 168 hours of app install.<br /><br />**Field Name:** `total_purchase_roas_day6`<br />**Type:** metric              |
| <div>Day 0 purchase value</div>                        | Total value of all purchase actions within 24 hours of app install.<br /><br />**Field Name:** `total_purchase_value_day0`<br />**Type:** metric                                |
| <div>Day 2 purchase value</div>                        | Total value of all purchase actions within 72 hours of app install.<br /><br />**Field Name:** `total_purchase_value_day2`<br />**Type:** metric                                |
| <div>Day 6 purchase value</div>                        | Total value of all purchase actions within 168 hours of app install.<br /><br />**Field Name:** `total_purchase_value_day6`<br />**Type:** metric                               |
| <div>Day 0 ad revenue ROAS</div>                       | Total return on ad spend (ROAS) from ad revenue within 24 hours of app install.<br /><br />**Field Name:** `ad_impression_ad_revenue_roas_day0`<br />**Type:** metric           |
| <div>Day 2 ad revenue ROAS</div>                       | Total return on ad spend (ROAS) from ad revenue within 72 hours of app install.<br /><br />**Field Name:** `ad_impression_ad_revenue_roas_day2`<br />**Type:** metric           |
| <div>Day 6 ad revenue ROAS</div>                       | Total return on ad spend (ROAS) from ad revenue within 168 hours of app install.<br /><br />**Field Name:** `ad_impression_ad_revenue_roas_day6`<br />**Type:** metric          |
| <div>Day 0 ad revenue</div>                            | Total ad revenue within 24 hours of app install.<br /><br />**Field Name:** `ad_impression_ad_revenue_day0`<br />**Type:** metric                                               |
| <div>Day 2 ad revenue</div>                            | Total ad revenue within 72 hours of app install.<br /><br />**Field Name:** `ad_impression_ad_revenue_day2`<br />**Type:** metric                                               |
| <div>Day 6 ad revenue</div>                            | Total ad revenue within 168 hours of app install.<br /><br />**Field Name:** `ad_impression_ad_revenue_day6`<br />**Type:** metric                                              |

### SKAN Results (IOS)

|                                               |                                                                                         |
| --------------------------------------------- | --------------------------------------------------------------------------------------- |
| <div>Results (SKAN)</div>                     | <br /><br />**Field Name:** `skan_result`<br />**Type:** metric                         |
| <div>Cost per result (SKAN)</div>             | <br /><br />**Field Name:** `skan_cost_per_result`<br />**Type:** metric                |
| <div>Result rate (SKAN)</div>                 | <br /><br />**Field Name:** `skan_result_rate`<br />**Type:** metric                    |
| <div>Conversions (SKAN)</div>                 | <br /><br />**Field Name:** `skan_conversion`<br />**Type:** metric                     |
| <div>Cost per conversion (SKAN)</div>         | <br /><br />**Field Name:** `skan_cost_per_conversion`<br />**Type:** metric            |
| <div>Conversion rate (SKAN, clicks)</div>     | <br /><br />**Field Name:** `skan_conversion_rate`<br />**Type:** metric                |
| <div>Conversion rate (SKAN)</div>             | <br /><br />**Field Name:** `skan_conversion_rate_v2`<br />**Type:** metric             |
| <div>Conversions (SKAN click time)</div>      | <br /><br />**Field Name:** `skan_click_time_conversion`<br />**Type:** metric          |
| <div>CPA (SKAN click time)</div>              | <br /><br />**Field Name:** `skan_click_time_cost_per_conversion`<br />**Type:** metric |
| <div>CVR (SKAN click time, impressions)</div> | <br /><br />**Field Name:** `skan_click_time_conversion_rate_v2`<br />**Type:** metric  |

### Attribution

|                                                      |                                                                                                                                                                                                   |
| ---------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| <div>VTA Conversion</div>                            | The number of conversion events that are attributed to an ad impression.<br /><br />**Field Name:** `vta_conversion`<br />**Type:** metric                                                        |
| <div>Cost per VTA Conversion</div>                   | The average cost for each conversion event that is attributed to an ad impression.<br /><br />**Field Name:** `cost_per_vta_conversion`<br />**Type:** metric                                     |
| <div>VTA App Install</div>                           | The number of app install events attributed to an ad impression.<br /><br />**Field Name:** `vta_app_install`<br />**Type:** metric                                                               |
| <div>Cost per VTA App Install</div>                  | The average cost per each app install event attributed to an ad impression.<br /><br />**Field Name:** `cost_per_vta_app_install`<br />**Type:** metric                                           |
| <div>VTA Registration</div>                          | The number of registration event that attribute to impression, based on information received from your measurement partner.<br /><br />**Field Name:** `vta_registration`<br />**Type:** metric   |
| <div>Cost per VTA Registration</div>                 | The average cost for each registration event that attribute to impression.<br /><br />**Field Name:** `cost_per_vta_registration`<br />**Type:** metric                                           |
| <div>VTA Purchase</div>                              | The number of in-app payment event that attribute to impression, based on information received from your measurement partner.<br /><br />**Field Name:** `vta_purchase`<br />**Type:** metric     |
| <div>Cost per VTA Purchase</div>                     | The average cost for each payment event that attribute to impression.<br /><br />**Field Name:** `cost_per_vta_purchase`<br />**Type:** metric                                                    |
| <div>VTA Complete Payment</div>                      | Complete payment events attributed to someone only viewing your ad.<br /><br />**Field Name:** `vta_complete_payment`<br />**Type:** metric                                                       |
| <div>Cost per VTA Complete Payment</div>             | Average cost of each complete payment event attributed to someone only viewing your ad.<br /><br />**Field Name:** `cost_per_vta_payments_completed`<br />**Type:** metric                        |
| <div>Total VTA Complete Payment Value</div>          | Total value of complete payment events attributed to someone only viewing your ad.<br /><br />**Field Name:** `vta_complete_payment_value`<br />**Type:** metric                                  |
| <div>VTA Complete Payment ROAS</div>                 | Return on ad spend (ROAS) from complete payment events attributed to someone only viewing your ad.<br /><br />**Field Name:** `vta_complete_payment_roas`<br />**Type:** metric                   |
| <div>CTA Conversion</div>                            | The number of conversion events that are attributed to a click on your ad.<br /><br />**Field Name:** `cta_conversion`<br />**Type:** metric                                                      |
| <div>Cost per CTA Conversion</div>                   | The average cost for each conversion event that is attributed to a click on your ad.<br /><br />**Field Name:** `cost_per_cta_conversion`<br />**Type:** metric                                   |
| <div>CTA App Install</div>                           | The number of app install events attributed to a click on your ad.<br /><br />**Field Name:** `cta_app_install`<br />**Type:** metric                                                             |
| <div>Cost per CTA App Install</div>                  | The average cost per each app install event attributed to a click on your ad.<br /><br />**Field Name:** `cost_per_cta_app_install`<br />**Type:** metric                                         |
| <div>CTA Registration</div>                          | The number of in-app registration event that attribute to click, based on information received from your measurement partner.<br /><br />**Field Name:** `cta_registration`<br />**Type:** metric |
| <div>Cost per CTA Registration</div>                 | The average cost for in-app registration event that attribute to clicks.<br /><br />**Field Name:** `cost_per_cta_registration`<br />**Type:** metric                                             |
| <div>CTA Purchase</div>                              | The number of in-app payment event that attribute to click, based on information received from your measurement partner.<br /><br />**Field Name:** `cta_purchase`<br />**Type:** metric          |
| <div>Cost per CTA Purchase</div>                     | The average cost for each payment event that attribute to clicks.<br /><br />**Field Name:** `cost_per_cta_purchase`<br />**Type:** metric                                                        |
| <div>Engaged View-Through Conversions</div>          | The number of conversions attributed to an engaged view.<br /><br />**Field Name:** `engaged_view_through_conversions`<br />**Type:** metric                                                      |
| <div>Cost Per Engaged View-Through Conversions</div> | The average cost of each conversion that is attributed to an engaged view.<br /><br />**Field Name:** `cost_per_engaged_view_through_conversion`<br />**Type:** metric                            |
| <div>EVTA App Installs</div>                         | The number of app install actions attributed to engaged views of your ad.<br /><br />**Field Name:** `evta_app_install`<br />**Type:** metric                                                     |
| <div>Cost per EVTA App Install</div>                 | The average cost per app install action attributed to engaged views of your ad.<br /><br />**Field Name:** `cost_per_evta_app_install`<br />**Type:** metric                                      |
| <div>EVTA Registrations</div>                        | The number of registration actions attributed to engaged views of your ad.<br /><br />**Field Name:** `evta_registration`<br />**Type:** metric                                                   |
| <div>Cost per EVTA Registration</div>                | The average cost per registration action attributed to engaged views of your ad.<br /><br />**Field Name:** `cost_per_evta_registration`<br />**Type:** metric                                    |
| <div>EVTA Purchases</div>                            | The number of purchase actions attributed to engaged views of your ad.<br /><br />**Field Name:** `evta_purchase`<br />**Type:** metric                                                           |
| <div>Cost per EVTA Purchase</div>                    | The average cost per purchase action attributed to engaged views of your ad.<br /><br />**Field Name:** `cost_per_evta_purchase`<br />**Type:** metric                                            |
| <div>EVTA Payments Completed</div>                   | The number of complete payment actions attributed to engaged views of your ad.<br /><br />**Field Name:** `evta_payments_completed`<br />**Type:** metric                                         |
| <div>Cost per EVTA Complete Payment</div>            | The average cost per complete payment action attributed to engaged views of your ad.<br /><br />**Field Name:** `cost_per_evta_payments_completed`<br />**Type:** metric                          |

### SKAN Attribution (IOS)

|                                             |                                                                                    |
| ------------------------------------------- | ---------------------------------------------------------------------------------- |
| <div>VTA Conversion (SKAN)</div>            | <br /><br />**Field Name:** `skan_vta_conversion`<br />**Type:** metric            |
| <div>Cost per VTA Conversion (SKAN)</div>   | <br /><br />**Field Name:** `skan_cost_per_vta_conversion`<br />**Type:** metric   |
| <div>VTA App Install (SKAN)</div>           | <br /><br />**Field Name:** `skan_vta_app_install`<br />**Type:** metric           |
| <div>Cost per VTA App Install (SKAN)</div>  | <br /><br />**Field Name:** `skan_cost_per_vta_app_install`<br />**Type:** metric  |
| <div>VTA Registration (SKAN)</div>          | <br /><br />**Field Name:** `skan_vta_registration`<br />**Type:** metric          |
| <div>Cost per VTA Registration (SKAN)</div> | <br /><br />**Field Name:** `skan_cost_per_vta_registration`<br />**Type:** metric |
| <div>VTA Purchase (SKAN)</div>              | <br /><br />**Field Name:** `skan_vta_purchase`<br />**Type:** metric              |
| <div>Cost per VTA Purchase (SKAN)</div>     | <br /><br />**Field Name:** `skan_cost_per_vta_purchase`<br />**Type:** metric     |
| <div>CTA Conversion (SKAN)</div>            | <br /><br />**Field Name:** `skan_cta_conversion`<br />**Type:** metric            |
| <div>Cost per CTA Conversion (SKAN)</div>   | <br /><br />**Field Name:** `skan_cost_per_cta_conversion`<br />**Type:** metric   |
| <div>CTA App Install (SKAN)</div>           | <br /><br />**Field Name:** `skan_cta_app_install`<br />**Type:** metric           |
| <div>Cost per CTA App Install (SKAN)</div>  | <br /><br />**Field Name:** `skan_cost_per_cta_app_install`<br />**Type:** metric  |
| <div>CTA Registration (SKAN)</div>          | <br /><br />**Field Name:** `skan_cta_registration`<br />**Type:** metric          |
| <div>Cost per CTA Registration (SKAN)</div> | <br /><br />**Field Name:** `skan_cost_per_cta_registration`<br />**Type:** metric |
| <div>CTA Purchase (SKAN)</div>              | <br /><br />**Field Name:** `skan_cta_purchase`<br />**Type:** metric              |
| <div>Cost per CTA Purchase (SKAN)</div>     | <br /><br />**Field Name:** `skan_cost_per_cta_purchase`<br />**Type:** metric     |

### SKAN In App (IOS)

|                                                      |                                                                                            |
| ---------------------------------------------------- | ------------------------------------------------------------------------------------------ |
| <div>App Install (SKAN)</div>                        | <br /><br />**Field Name:** `skan_app_install`<br />**Type:** metric                       |
| <div>Cost per App Install (SKAN)</div>               | <br /><br />**Field Name:** `skan_cost_per_app_install`<br />**Type:** metric              |
| <div>App Installs (SKAN Privacy Withheld)</div>      | <br /><br />**Field Name:** `skan_app_install_withheld`<br />**Type:** metric              |
| <div>Unique Registration (SKAN)</div>                | <br /><br />**Field Name:** `skan_registration`<br />**Type:** metric                      |
| <div>Cost per Unique Registration (SKAN)</div>       | <br /><br />**Field Name:** `skan_cost_per_registration`<br />**Type:** metric             |
| <div>Unique Registration Rate (SKAN)</div>           | <br /><br />**Field Name:** `skan_registration_rate`<br />**Type:** metric                 |
| <div>Total Registration (SKAN)</div>                 | <br /><br />**Field Name:** `skan_total_registration`<br />**Type:** metric                |
| <div>Cost per Registration (SKAN)</div>              | <br /><br />**Field Name:** `skan_cost_per_total_registration`<br />**Type:** metric       |
| <div>Unique Purchase (SKAN)</div>                    | <br /><br />**Field Name:** `skan_purchase`<br />**Type:** metric                          |
| <div>Cost per Unique Purchase (SKAN)</div>           | <br /><br />**Field Name:** `skan_cost_per_purchase`<br />**Type:** metric                 |
| <div>Unique Purchase Rate (%) (SKAN)</div>           | <br /><br />**Field Name:** `skan_purchase_rate`<br />**Type:** metric                     |
| <div>Total Purchase (SKAN)</div>                     | <br /><br />**Field Name:** `skan_total_purchase`<br />**Type:** metric                    |
| <div>Cost per Purchase (SKAN)</div>                  | <br /><br />**Field Name:** `skan_cost_per_total_purchase`<br />**Type:** metric           |
| <div>Total Purchase Value (SKAN)</div>               | <br /><br />**Field Name:** `skan_total_purchase_value`<br />**Type:** metric              |
| <div>Purchase ROAS (SKAN)</div>                      | <br /><br />**Field Name:** `skan_total_repetitive_active_pay_roas`<br />**Type:** metric  |
| <div>Unique Add to Cart (SKAN)</div>                 | <br /><br />**Field Name:** `skan_add_to_cart`<br />**Type:** metric                       |
| <div>Cost per Unique Add to Cart (SKAN)</div>        | <br /><br />**Field Name:** `skan_cost_per_add_to_cart`<br />**Type:** metric              |
| <div>Unique Add to Cart Rate (%) (SKAN)</div>        | <br /><br />**Field Name:** `skan_add_to_cart_rate`<br />**Type:** metric                  |
| <div>Total Add to Cart (SKAN)</div>                  | <br /><br />**Field Name:** `skan_total_add_to_cart`<br />**Type:** metric                 |
| <div>Cost per Add to Cart (SKAN)</div>               | <br /><br />**Field Name:** `skan_cost_per_total_add_to_cart`<br />**Type:** metric        |
| <div>Total Add to Cart Value (SKAN)</div>            | <br /><br />**Field Name:** `skan_total_add_to_cart_value`<br />**Type:** metric           |
| <div>Unique Checkout (SKAN)</div>                    | <br /><br />**Field Name:** `skan_checkout`<br />**Type:** metric                          |
| <div>Cost per Unique Checkout (SKAN)</div>           | <br /><br />**Field Name:** `skan_cost_per_checkout`<br />**Type:** metric                 |
| <div>Unique Checkout Rate (%) (SKAN)</div>           | <br /><br />**Field Name:** `skan_checkout_rate`<br />**Type:** metric                     |
| <div>Total Checkout (SKAN)</div>                     | <br /><br />**Field Name:** `skan_total_checkout`<br />**Type:** metric                    |
| <div>Cost per Checkout (SKAN)</div>                  | <br /><br />**Field Name:** `skan_cost_per_total_checkout`<br />**Type:** metric           |
| <div>Total Checkout Value (SKAN)</div>               | <br /><br />**Field Name:** `skan_total_checkout_value`<br />**Type:** metric              |
| <div>Unique View Content (SKAN)</div>                | <br /><br />**Field Name:** `skan_view_content`<br />**Type:** metric                      |
| <div>Cost per Unique View Content (SKAN)</div>       | <br /><br />**Field Name:** `skan_cost_per_view_content`<br />**Type:** metric             |
| <div>Unique View Content Rate (%) (SKAN)</div>       | <br /><br />**Field Name:** `skan_view_content_rate`<br />**Type:** metric                 |
| <div>Total View Content (SKAN)</div>                 | <br /><br />**Field Name:** `skan_total_view_content`<br />**Type:** metric                |
| <div>Cost per View Content (SKAN)</div>              | <br /><br />**Field Name:** `skan_cost_per_total_view_content`<br />**Type:** metric       |
| <div>Total View Content Value (SKAN)</div>           | <br /><br />**Field Name:** `skan_total_view_content_value`<br />**Type:** metric          |
| <div>Unique Add Payment Info (SKAN)</div>            | <br /><br />**Field Name:** `skan_add_payment_info`<br />**Type:** metric                  |
| <div>Cost per Unique Add Payment Info (SKAN)</div>   | <br /><br />**Field Name:** `skan_cost_per_add_payment_info`<br />**Type:** metric         |
| <div>Unique Add Payment Info Rate (%) (SKAN)</div>   | <br /><br />**Field Name:** `skan_add_payment_info_rate`<br />**Type:** metric             |
| <div>Total Add Payment Info (SKAN)</div>             | <br /><br />**Field Name:** `skan_total_add_payment_info`<br />**Type:** metric            |
| <div>Cost per Add Payment Info (SKAN)</div>          | <br /><br />**Field Name:** `skan_cost_total_add_payment_info`<br />**Type:** metric       |
| <div>Unique Add to Wishlist (SKAN)</div>             | <br /><br />**Field Name:** `skan_add_to_wishlist`<br />**Type:** metric                   |
| <div>Cost per Unique Add to Wishlist (SKAN)</div>    | <br /><br />**Field Name:** `skan_cost_per_add_to_wishlist`<br />**Type:** metric          |
| <div>Unique Add to Wishlist Rate (%) (SKAN)</div>    | <br /><br />**Field Name:** `skan_add_to_wishlist_rate`<br />**Type:** metric              |
| <div>Total Add to Wishlist (SKAN)</div>              | <br /><br />**Field Name:** `skan_total_add_to_wishlist`<br />**Type:** metric             |
| <div>Cost per Add to Wishlist (SKAN)</div>           | <br /><br />**Field Name:** `skan_cost_per_total_add_to_wishlist`<br />**Type:** metric    |
| <div>Total Add to Wishlist Value (SKAN)</div>        | <br /><br />**Field Name:** `skan_total_add_to_wishlist_value`<br />**Type:** metric       |
| <div>Unique Launch App (SKAN)</div>                  | <br /><br />**Field Name:** `skan_launch_app`<br />**Type:** metric                        |
| <div>Cost per Unique Launch App (SKAN)</div>         | <br /><br />**Field Name:** `skan_cost_per_launch_app`<br />**Type:** metric               |
| <div>Unique Launch App Rate (%) (SKAN)</div>         | <br /><br />**Field Name:** `skan_launch_app_rate`<br />**Type:** metric                   |
| <div>Total Launch App (SKAN)</div>                   | <br /><br />**Field Name:** `skan_total_launch_app`<br />**Type:** metric                  |
| <div>Cost per Launch App (SKAN)</div>                | <br /><br />**Field Name:** `skan_cost_per_total_launch_app`<br />**Type:** metric         |
| <div>Total Complete Tutorial (SKAN)</div>            | <br /><br />**Field Name:** `skan_total_complete_tutorial`<br />**Type:** metric           |
| <div>Cost per Complete Tutorial (SKAN)</div>         | <br /><br />**Field Name:** `skan_cost_per_total_complete_tutorial`<br />**Type:** metric  |
| <div>Unique Complete Tutorial (SKAN)</div>           | <br /><br />**Field Name:** `skan_complete_tutorial`<br />**Type:** metric                 |
| <div>Cost per Unique Complete Tutorial (SKAN)</div>  | <br /><br />**Field Name:** `skan_cost_per_complete_tutorial`<br />**Type:** metric        |
| <div>Unique Complete Tutorial Rate (%) (SKAN)</div>  | <br /><br />**Field Name:** `skan_complete_tutorial_rate`<br />**Type:** metric            |
| <div>Total Complete Tutorial Value (SKAN)</div>      | <br /><br />**Field Name:** `skan_total_complete_tutorial_value`<br />**Type:** metric     |
| <div>Unique Create Group (SKAN)</div>                | <br /><br />**Field Name:** `skan_create_group`<br />**Type:** metric                      |
| <div>Cost per Unique Create Group (SKAN)</div>       | <br /><br />**Field Name:** `skan_cost_per_create_group`<br />**Type:** metric             |
| <div>Unique Create Group Rate (%) (SKAN)</div>       | <br /><br />**Field Name:** `skan_create_group_rate`<br />**Type:** metric                 |
| <div>Total Create Group (SKAN)</div>                 | <br /><br />**Field Name:** `skan_total_create_group`<br />**Type:** metric                |
| <div>Cost per Create Group (SKAN)</div>              | <br /><br />**Field Name:** `skan_cost_per_total_create_group`<br />**Type:** metric       |
| <div>Total Create Group Value (SKAN)</div>           | <br /><br />**Field Name:** `skan_total_create_group_value`<br />**Type:** metric          |
| <div>Unique Join Group (SKAN)</div>                  | <br /><br />**Field Name:** `skan_join_group`<br />**Type:** metric                        |
| <div>Cost per Unique Join Group (SKAN)</div>         | <br /><br />**Field Name:** `skan_cost_per_join_group`<br />**Type:** metric               |
| <div>Unique Join Group Rate (%) (SKAN)</div>         | <br /><br />**Field Name:** `skan_join_group_rate`<br />**Type:** metric                   |
| <div>Total Join Group (SKAN)</div>                   | <br /><br />**Field Name:** `skan_total_join_group`<br />**Type:** metric                  |
| <div>Cost per Join Group (SKAN)</div>                | <br /><br />**Field Name:** `skan_cost_per_total_join_group`<br />**Type:** metric         |
| <div>Total Join Group Value (SKAN)</div>             | <br /><br />**Field Name:** `skan_total_join_group_value`<br />**Type:** metric            |
| <div>Unique Create Role (SKAN)</div>                 | <br /><br />**Field Name:** `skan_create_gamerole`<br />**Type:** metric                   |
| <div>Cost per Unique Create Role (SKAN)</div>        | <br /><br />**Field Name:** `skan_cost_per_create_gamerole`<br />**Type:** metric          |
| <div>Unique Create Role Rate (%) (SKAN)</div>        | <br /><br />**Field Name:** `skan_create_gamerole_rate`<br />**Type:** metric              |
| <div>Total Create Role (SKAN)</div>                  | <br /><br />**Field Name:** `skan_total_create_gamerole`<br />**Type:** metric             |
| <div>Cost per Create Role (SKAN)</div>               | <br /><br />**Field Name:** `skan_cost_per_total_create_gamerole`<br />**Type:** metric    |
| <div>Total Create Role Value (SKAN)</div>            | <br /><br />**Field Name:** `skan_total_create_gamerole_value`<br />**Type:** metric       |
| <div>Unique Spend Credit (SKAN)</div>                | <br /><br />**Field Name:** `skan_spend_credits`<br />**Type:** metric                     |
| <div>Cost per Unique Spend Credit (SKAN)</div>       | <br /><br />**Field Name:** `skan_cost_per_spend_credits`<br />**Type:** metric            |
| <div>Spend Credit Rate (%) (SKAN)</div>              | <br /><br />**Field Name:** `skan_spend_credits_rate`<br />**Type:** metric                |
| <div>Total Spend Credit (SKAN)</div>                 | <br /><br />**Field Name:** `skan_total_spend_credits`<br />**Type:** metric               |
| <div>Cost per Spend Credit (SKAN)</div>              | <br /><br />**Field Name:** `skan_cost_per_total_spend_credits`<br />**Type:** metric      |
| <div>Total Spend Credit Value (SKAN)</div>           | <br /><br />**Field Name:** `skan_total_spend_credits_value`<br />**Type:** metric         |
| <div>Unique Achieve Level (SKAN)</div>               | <br /><br />**Field Name:** `skan_achieve_level`<br />**Type:** metric                     |
| <div>Cost per Unique Achieve Level (SKAN)</div>      | <br /><br />**Field Name:** `skan_cost_per_achieve_level`<br />**Type:** metric            |
| <div>Achieve Level Rate (%) (SKAN)</div>             | <br /><br />**Field Name:** `skan_achieve_level_rate`<br />**Type:** metric                |
| <div>Total Achieve Level (SKAN)</div>                | <br /><br />**Field Name:** `skan_total_achieve_level`<br />**Type:** metric               |
| <div>Cost per Achieve Level (SKAN)</div>             | <br /><br />**Field Name:** `skan_cost_per_total_achieve_level`<br />**Type:** metric      |
| <div>Total Achieve Level Value (SKAN)</div>          | <br /><br />**Field Name:** `skan_total_achieve_level_value`<br />**Type:** metric         |
| <div>Unique Unlock Achievement (SKAN)</div>          | <br /><br />**Field Name:** `skan_unlock_achievement`<br />**Type:** metric                |
| <div>Cost per Unique Unlock Achievement (SKAN)</div> | <br /><br />**Field Name:** `skan_cost_per_unlock_achievement`<br />**Type:** metric       |
| <div>Unique Unlock Achievement Rate (%) (SKAN)</div> | <br /><br />**Field Name:** `skan_unlock_achievement_rate`<br />**Type:** metric           |
| <div>Total Unlock Achievement (SKAN)</div>           | <br /><br />**Field Name:** `skan_total_unlock_achievement`<br />**Type:** metric          |
| <div>Cost per Unlock Achievement (SKAN)</div>        | <br /><br />**Field Name:** `skan_cost_per_total_unlock_achievement`<br />**Type:** metric |
| <div>Total Unlock Achievement Value (SKAN)</div>     | <br /><br />**Field Name:** `skan_total_unlock_achievement_value`<br />**Type:** metric    |
| <div>Unique Generate Lead (SKAN)</div>               | <br /><br />**Field Name:** `skan_sales_lead`<br />**Type:** metric                        |
| <div>Cost per Unique Generate Lead (SKAN)</div>      | <br /><br />**Field Name:** `skan_cost_per_sales_lead`<br />**Type:** metric               |
| <div>Unique Generate Lead Rate (%) (SKAN)</div>      | <br /><br />**Field Name:** `skan_sales_lead_rate`<br />**Type:** metric                   |
| <div>Total Generate Lead (SKAN)</div>                | <br /><br />**Field Name:** `skan_total_sales_lead`<br />**Type:** metric                  |
| <div>Cost per Generate Lead (SKAN)</div>             | <br /><br />**Field Name:** `skan_cost_per_total_sales_lead`<br />**Type:** metric         |
| <div>Total Generate Lead Value (SKAN)</div>          | <br /><br />**Field Name:** `skan_total_sales_lead_value`<br />**Type:** metric            |
| <div>Unique In-App Ad Click (SKAN)</div>             | <br /><br />**Field Name:** `skan_in_app_ad_click`<br />**Type:** metric                   |
| <div>Cost per Unique In-App Ad Click (SKAN)</div>    | <br /><br />**Field Name:** `skan_cost_per_in_app_ad_click`<br />**Type:** metric          |
| <div>Unique In-App Ad Click Rate (%) (SKAN)</div>    | <br /><br />**Field Name:** `skan_in_app_ad_click_rate`<br />**Type:** metric              |
| <div>Total In-App Ad Click (SKAN)</div>              | <br /><br />**Field Name:** `skan_total_in_app_ad_click`<br />**Type:** metric             |
| <div>Cost per In-App Ad Click (SKAN)</div>           | <br /><br />**Field Name:** `skan_cost_per_total_in_app_ad_click`<br />**Type:** metric    |
| <div>Total In-App Ad Click Value (SKAN)</div>        | <br /><br />**Field Name:** `skan_total_in_app_ad_click_value`<br />**Type:** metric       |
| <div>Unique In-App Ad Impr (SKAN)</div>              | <br /><br />**Field Name:** `skan_in_app_ad_impr`<br />**Type:** metric                    |
| <div>Cost per Unique In-App Ad Impr (SKAN)</div>     | <br /><br />**Field Name:** `skan_cost_per_in_app_ad_impr`<br />**Type:** metric           |
| <div>Unique In-App Ad Impr Rate (%) (SKAN)</div>     | <br /><br />**Field Name:** `skan_in_app_ad_impr_rate`<br />**Type:** metric               |
| <div>Total In-App Ad Impr (SKAN)</div>               | <br /><br />**Field Name:** `skan_total_in_app_ad_impr`<br />**Type:** metric              |
| <div>Cost per In-App Ad Impr (SKAN)</div>            | <br /><br />**Field Name:** `skan_cost_per_total_in_app_ad_impr`<br />**Type:** metric     |
| <div>Total In-App Ad Impr Value (SKAN)</div>         | <br /><br />**Field Name:** `skan_total_in_app_ad_impr_value`<br />**Type:** metric        |
| <div>Unique Loan Apply (SKAN)</div>                  | <br /><br />**Field Name:** `skan_loan_apply`<br />**Type:** metric                        |
| <div>Cost per Unique Loan Apply (SKAN)</div>         | <br /><br />**Field Name:** `skan_cost_per_loan_apply`<br />**Type:** metric               |
| <div>Unique Loan Apply Rate (%) (SKAN)</div>         | <br /><br />**Field Name:** `skan_loan_apply_rate`<br />**Type:** metric                   |
| <div>Total Loan Apply (SKAN)</div>                   | <br /><br />**Field Name:** `skan_total_loan_apply`<br />**Type:** metric                  |
| <div>Cost per Loan Apply (SKAN)</div>                | <br /><br />**Field Name:** `skan_cost_per_total_loan_apply`<br />**Type:** metric         |
| <div>Unique Loan Approval (SKAN)</div>               | <br /><br />**Field Name:** `skan_loan_credit`<br />**Type:** metric                       |
| <div>Cost per Unique Loan Approval (SKAN)</div>      | <br /><br />**Field Name:** `skan_cost_per_loan_credit`<br />**Type:** metric              |
| <div>Unique Loan Approval Rate (%) (SKAN)</div>      | <br /><br />**Field Name:** `skan_loan_credit_rate`<br />**Type:** metric                  |
| <div>Total Loan Approval (SKAN)</div>                | <br /><br />**Field Name:** `skan_total_loan_credit`<br />**Type:** metric                 |
| <div>Cost per Loan Approval (SKAN)</div>             | <br /><br />**Field Name:** `skan_cost_per_total_loan_credit`<br />**Type:** metric        |
| <div>Unique Loan Disbursement (SKAN)</div>           | <br /><br />**Field Name:** `skan_loan_disbursement`<br />**Type:** metric                 |
| <div>Cost per Unique Loan Disbursement (SKAN)</div>  | <br /><br />**Field Name:** `skan_cost_per_loan_disbursement`<br />**Type:** metric        |
| <div>Unique Loan Disbursement Rate (%) (SKAN)</div>  | <br /><br />**Field Name:** `skan_loan_disbursement_rate`<br />**Type:** metric            |
| <div>Total Loan Disbursement (SKAN)</div>            | <br /><br />**Field Name:** `skan_total_loan_disbursement`<br />**Type:** metric           |
| <div>Cost per Loan Disbursement (SKAN)</div>         | <br /><br />**Field Name:** `skan_cost_per_total_loan_disbursement`<br />**Type:** metric  |
| <div>Unique Login (SKAN)</div>                       | <br /><br />**Field Name:** `skan_login`<br />**Type:** metric                             |
| <div>Cost per Unique Login (SKAN)</div>              | <br /><br />**Field Name:** `skan_cost_per_login`<br />**Type:** metric                    |
| <div>Uni que Login Rate (%) (SKAN)</div>             | <br /><br />**Field Name:** `skan_login_rate`<br />**Type:** metric                        |
| <div>Total Login (SKAN)</div>                        | <br /><br />**Field Name:** `skan_total_login`<br />**Type:** metric                       |
| <div>Cost per Login (SKAN)</div>                     | <br /><br />**Field Name:** `skan_cost_per_total_login`<br />**Type:** metric              |
| <div>Unique Rate (SKAN)</div>                        | <br /><br />**Field Name:** `skan_ratings`<br />**Type:** metric                           |
| <div>Cost per Unique Rate (SKAN)</div>               | <br /><br />**Field Name:** `skan_cost_per_ratings`<br />**Type:** metric                  |
| <div>Unique Rate Rate (%) (SKAN)</div>               | <br /><br />**Field Name:** `skan_ratings_rate`<br />**Type:** metric                      |
| <div>Total Rate (SKAN)</div>                         | <br /><br />**Field Name:** `skan_total_ratings`<br />**Type:** metric                     |
| <div>Cost per Rate (SKAN)</div>                      | <br /><br />**Field Name:** `skan_cost_per_total_ratings`<br />**Type:** metric            |
| <div>Total Rate Value (SKAN)</div>                   | <br /><br />**Field Name:** `skan_total_ratings_value`<br />**Type:** metric               |
| <div>Unique Search (SKAN)</div>                      | <br /><br />**Field Name:** `skan_search`<br />**Type:** metric                            |
| <div>Cost per Unique Search (SKAN)</div>             | <br /><br />**Field Name:** `skan_cost_per_search`<br />**Type:** metric                   |
| <div>Unique Search Rate (%) (SKAN)</div>             | <br /><br />**Field Name:** `skan_search_rate`<br />**Type:** metric                       |
| <div>Total Search (SKAN)</div>                       | <br /><br />**Field Name:** `skan_total_search`<br />**Type:** metric                      |
| <div>Cost per Search (SKAN)</div>                    | <br /><br />**Field Name:** `skan_cost_per_total_search`<br />**Type:** metric             |
| <div>Unique Start Trial (SKAN)</div>                 | <br /><br />**Field Name:** `skan_start_trial`<br />**Type:** metric                       |
| <div>Cost per Unique Start Trial (SKAN)</div>        | <br /><br />**Field Name:** `skan_cost_per_start_trial`<br />**Type:** metric              |
| <div>Unique Start Trial Rate (%) (SKAN)</div>        | <br /><br />**Field Name:** `skan_start_trial_rate`<br />**Type:** metric                  |
| <div>Total Start Trial (SKAN)</div>                  | <br /><br />**Field Name:** `skan_total_start_trial`<br />**Type:** metric                 |
| <div>Cost per Start Trial (SKAN)</div>               | <br /><br />**Field Name:** `skan_cost_per_total_start_trial`<br />**Type:** metric        |
| <div>Unique Subscribe (SKAN)</div>                   | <br /><br />**Field Name:** `skan_subscribe`<br />**Type:** metric                         |
| <div>Cost per Unique Subscribe (SKAN)</div>          | <br /><br />**Field Name:** `skan_cost_per_subscribe`<br />**Type:** metric                |
| <div>Unique Subscribe Rate (%) (SKAN)</div>          | <br /><br />**Field Name:** `skan_subscribe_rate`<br />**Type:** metric                    |
| <div>Total Subscribe (SKAN)</div>                    | <br /><br />**Field Name:** `skan_total_subscribe`<br />**Type:** metric                   |
| <div>Cost per Subscribe (SKAN)</div>                 | <br /><br />**Field Name:** `skan_cost_per_total_subscribe`<br />**Type:** metric          |
| <div>Total Subscribe Value (SKAN)</div>              | <br /><br />**Field Name:** `skan_total_subscribe_value`<br />**Type:** metric             |

### Offline

|                                                          |                                                                                                   |
| -------------------------------------------------------- | ------------------------------------------------------------------------------------------------- |
| <div>Payments completed (offline)</div>                  | <br /><br />**Field Name:** `offline_shopping_events`<br />**Type:** metric                       |
| <div>Cost per complete payment (offline)</div>           | <br /><br />**Field Name:** `cost_per_offline_shopping_event`<br />**Type:** metric               |
| <div>Unique payment completion rate (offline)</div>      | <br /><br />**Field Name:** `offline_shopping_event_rate`<br />**Type:** metric                   |
| <div>Value per complete payment (offline)</div>          | <br /><br />**Field Name:** `value_per_offline_shopping_event`<br />**Type:** metric              |
| <div>Payment completion value (offline)</div>            | <br /><br />**Field Name:** `offline_shopping_events_value`<br />**Type:** metric                 |
| <div>Payment completion ROAS (offline)</div>             | <br /><br />**Field Name:** `offline_shopping_events_roas`<br />**Type:** metric                  |
| <div>Contacts (offline)</div>                            | <br /><br />**Field Name:** `offline_contact_events`<br />**Type:** metric                        |
| <div>Cost per contact (offline)</div>                    | <br /><br />**Field Name:** `cost_per_offline_contact_event`<br />**Type:** metric                |
| <div>Unique contact rate (offline)</div>                 | <br /><br />**Field Name:** `offline_contact_event_rate`<br />**Type:** metric                    |
| <div>Value per contact (offline)</div>                   | <br /><br />**Field Name:** `value_per_offline_contact_event`<br />**Type:** metric               |
| <div>Contact value (offline)</div>                       | <br /><br />**Field Name:** `offline_contact_events_value`<br />**Type:** metric                  |
| <div>Subscriptions (offline)</div>                       | <br /><br />**Field Name:** `offline_subscribe_events`<br />**Type:** metric                      |
| <div>Cost per subscription (offline)</div>               | <br /><br />**Field Name:** `cost_per_offline_subscribe_event`<br />**Type:** metric              |
| <div>Unique subscription rate (offline)</div>            | <br /><br />**Field Name:** `offline_subscribe_event_rate`<br />**Type:** metric                  |
| <div>Value per subscription (offline)</div>              | <br /><br />**Field Name:** `value_per_offline_subscribe_event`<br />**Type:** metric             |
| <div>Subscription value (offline)</div>                  | <br /><br />**Field Name:** `offline_subscribe_events_value`<br />**Type:** metric                |
| <div>Form submissions (offline)</div>                    | <br /><br />**Field Name:** `offline_form_events`<br />**Type:** metric                           |
| <div>Cost per form submitted (offline)</div>             | <br /><br />**Field Name:** `cost_per_offline_form_event`<br />**Type:** metric                   |
| <div>Unique form submission rate (offline)</div>         | <br /><br />**Field Name:** `offline_form_event_rate`<br />**Type:** metric                       |
| <div>Value per form submitted (offline)</div>            | <br /><br />**Field Name:** `value_per_offline_form_event`<br />**Type:** metric                  |
| <div>Form submission value (offline)</div>               | <br /><br />**Field Name:** `offline_form_events_value`<br />**Type:** metric                     |
| <div>Payment info adds (offline)</div>                   | <br /><br />**Field Name:** `offline_add_payment_info_events`<br />**Type:** metric               |
| <div>Cost per payment info add (offline)</div>           | <br /><br />**Field Name:** `cost_per_offline_add_payment_info_event`<br />**Type:** metric       |
| <div>Unique payment info add rate (offline)</div>        | <br /><br />**Field Name:** `offline_add_payment_info_event_rate`<br />**Type:** metric           |
| <div>Value per payment info add (offline)</div>          | <br /><br />**Field Name:** `value_per_offline_add_payment_info_event`<br />**Type:** metric      |
| <div>Payment info add value (offline)</div>              | <br /><br />**Field Name:** `offline_add_payment_info_events_value`<br />**Type:** metric         |
| <div>Adds to cart (offline)</div>                        | <br /><br />**Field Name:** `offline_add_to_cart_events`<br />**Type:** metric                    |
| <div>Cost per add to cart (offline)</div>                | <br /><br />**Field Name:** `cost_per_offline_add_to_cart_event`<br />**Type:** metric            |
| <div>Unique add to cart rate (offline)</div>             | <br /><br />**Field Name:** `offline_add_to_cart_event_rate`<br />**Type:** metric                |
| <div>Value per add to cart (offline)</div>               | <br /><br />**Field Name:** `value_per_offline_add_to_cart_event`<br />**Type:** metric           |
| <div>Add to cart value (offline)</div>                   | <br /><br />**Field Name:** `offline_add_to_cart_events_value`<br />**Type:** metric              |
| <div>Adds to wishlist (offline)</div>                    | <br /><br />**Field Name:** `offline_add_to_wishlist_events`<br />**Type:** metric                |
| <div>Cost per add to wishlist (offline)</div>            | <br /><br />**Field Name:** `cost_per_offline_add_to_wishlist_event`<br />**Type:** metric        |
| <div>Unique add to wishlist rate (offline)</div>         | <br /><br />**Field Name:** `offline_add_to_wishlist_event_rate`<br />**Type:** metric            |
| <div>Value per add to wishlist (offline)</div>           | <br /><br />**Field Name:** `value_per_offline_add_to_wishlist_event`<br />**Type:** metric       |
| <div>Add to wishlist value (offline)</div>               | <br /><br />**Field Name:** `offline_add_to_wishlist_events_value`<br />**Type:** metric          |
| <div>Button clicks (offline)</div>                       | <br /><br />**Field Name:** `offline_click_button_events`<br />**Type:** metric                   |
| <div>Cost per button click (offline)</div>               | <br /><br />**Field Name:** `cost_per_offline_click_button_event`<br />**Type:** metric           |
| <div>Unique button click rate (offline)</div>            | <br /><br />**Field Name:** `offline_click_button_event_rate`<br />**Type:** metric               |
| <div>Value per button click (offline)</div>              | <br /><br />**Field Name:** `value_per_offline_click_button_event`<br />**Type:** metric          |
| <div>Button click value (offline)</div>                  | <br /><br />**Field Name:** `offline_click_button_events_value`<br />**Type:** metric             |
| <div>Registrations completed (offline)</div>             | <br /><br />**Field Name:** `offline_complete_registration_events`<br />**Type:** metric          |
| <div>Cost per complete registration (offline)</div>      | <br /><br />**Field Name:** `cost_per_offline_complete_registration_event`<br />**Type:** metric  |
| <div>Unique registration completion rate (offline)</div> | <br /><br />**Field Name:** `offline_complete_registration_event_rate`<br />**Type:** metric      |
| <div>Value per complete registration (offline)</div>     | <br /><br />**Field Name:** `value_per_offline_complete_registration_event`<br />**Type:** metric |
| <div>Registration completion value (offline)</div>       | <br /><br />**Field Name:** `offline_complete_registration_events_value`<br />**Type:** metric    |
| <div>Downloads (offline)</div>                           | <br /><br />**Field Name:** `offline_download_events`<br />**Type:** metric                       |
| <div>Cost per download (offline)</div>                   | <br /><br />**Field Name:** `cost_per_offline_download_event`<br />**Type:** metric               |
| <div>Unique download rate (offline)</div>                | <br /><br />**Field Name:** `offline_download_event_rate`<br />**Type:** metric                   |
| <div>Value per download (offline)</div>                  | <br /><br />**Field Name:** `value_per_offline_download_event`<br />**Type:** metric              |
| <div>Download value (offline)</div>                      | <br /><br />**Field Name:** `offline_download_events_value`<br />**Type:** metric                 |
| <div>Checkouts initiated (offline)</div>                 | <br /><br />**Field Name:** `offline_initiate_checkout_events`<br />**Type:** metric              |
| <div>Cost per checkout initiated (offline)</div>         | <br /><br />**Field Name:** `cost_per_offline_initiate_checkout_event`<br />**Type:** metric      |
| <div>Unique checkout initiation rate (offline)</div>     | <br /><br />**Field Name:** `offline_initiate_checkout_event_rate`<br />**Type:** metric          |
| <div>Value per checkout initiated (offline)</div>        | <br /><br />**Field Name:** `value_per_offline_initiate_checkout_event`<br />**Type:** metric     |
| <div>Checkout initiation value (offline)</div>           | <br /><br />**Field Name:** `offline_initiate_checkout_events_value`<br />**Type:** metric        |
| <div>Orders placed (offline)</div>                       | <br /><br />**Field Name:** `offline_place_order_events`<br />**Type:** metric                    |
| <div>Cost per order placed (offline)</div>               | <br /><br />**Field Name:** `cost_per_offline_place_order_event`<br />**Type:** metric            |
| <div>Unique orders placed rate (offline)</div>           | <br /><br />**Field Name:** `offline_place_order_event_rate`<br />**Type:** metric                |
| <div>Value per order placed (offline)</div>              | <br /><br />**Field Name:** `value_per_offline_place_order_event`<br />**Type:** metric           |
| <div>Orders placed value (offline)</div>                 | <br /><br />**Field Name:** `offline_place_order_events_value`<br />**Type:** metric              |
| <div>Searches (offline)</div>                            | <br /><br />**Field Name:** `offline_search_events`<br />**Type:** metric                         |
| <div>Cost per search (offline)</div>                     | <br /><br />**Field Name:** `cost_per_offline_search_event`<br />**Type:** metric                 |
| <div>Unique search rate (offline)</div>                  | <br /><br />**Field Name:** `offline_search_event_rate`<br />**Type:** metric                     |
| <div>Value per search (offline)</div>                    | <br /><br />**Field Name:** `value_per_offline_search_event`<br />**Type:** metric                |
| <div>Search value (offline)</div>                        | <br /><br />**Field Name:** `offline_search_events_value`<br />**Type:** metric                   |
| <div>Content views (offline)</div>                       | <br /><br />**Field Name:** `offline_view_content_events`<br />**Type:** metric                   |
| <div>Cost per content view (offline)</div>               | <br /><br />**Field Name:** `cost_per_offline_view_content_event`<br />**Type:** metric           |
| <div>Unique content view rate (offline)</div>            | <br /><br />**Field Name:** `offline_view_content_event_rate`<br />**Type:** metric               |
| <div>Value per content view (offline)</div>              | <br /><br />**Field Name:** `value_per_offline_view_content_event`<br />**Type:** metric          |
| <div>Content view value (offline)</div>                  | <br /><br />**Field Name:** `offline_view_content_events_value`<br />**Type:** metric             |
| <div>ROAS (Shop)</div>                                   | <br /><br />**Field Name:** `onsite_shopping_roas`<br />**Type:** metric                          |
| <div>Purchases (Shop)</div>                              | <br /><br />**Field Name:** `onsite_shopping`<br />**Type:** metric                               |
| <div>Cost per purchase (Shop)</div>                      | <br /><br />**Field Name:** `cost_per_onsite_shopping`<br />**Type:** metric                      |
| <div>Purchase rate (Shop) (%)</div>                      | <br /><br />**Field Name:** `onsite_shopping_rate`<br />**Type:** metric                          |
| <div>Average order value (Shop)</div>                    | <br /><br />**Field Name:** `value_per_onsite_shopping`<br />**Type:** metric                     |
| <div>Gross revenue (Shop)</div>                          | <br /><br />**Field Name:** `total_onsite_shopping_value`<br />**Type:** metric                   |
| <div>Checkouts initiated (Shop)</div>                    | <br /><br />**Field Name:** `onsite_initiate_checkout_count`<br />**Type:** metric                |
| <div>Cost per checkout initiated (Shop)</div>            | <br /><br />**Field Name:** `cost_per_onsite_initiate_checkout_count`<br />**Type:** metric       |
| <div>Checkout initiation rate (Shop) (%)</div>           | <br /><br />**Field Name:** `onsite_initiate_checkout_count_rate`<br />**Type:** metric           |
| <div>Value per checkout initiated (Shop)</div>           | <br /><br />**Field Name:** `value_per_onsite_initiate_checkout_count`<br />**Type:** metric      |
| <div>Checkout initiation value (Shop)</div>              | <br /><br />**Field Name:** `total_onsite_initiate_checkout_count_value`<br />**Type:** metric    |
| <div>Product page views (Shop)</div>                     | <br /><br />**Field Name:** `onsite_on_web_detail`<br />**Type:** metric                          |
| <div>Cost per product page view (Shop)</div>             | <br /><br />**Field Name:** `cost_per_onsite_on_web_detail`<br />**Type:** metric                 |
| <div>Product page view rate (Shop) (%)</div>             | <br /><br />**Field Name:** `onsite_on_web_detail_rate`<br />**Type:** metric                     |
| <div>Value per product page view (Shop)</div>            | <br /><br />**Field Name:** `value_per_onsite_on_web_detail`<br />**Type:** metric                |
| <div>Product page view value (Shop)</div>                | <br /><br />**Field Name:** `total_onsite_on_web_detail_value`<br />**Type:** metric              |
| <div>Add to cart (Shop)</div>                            | <br /><br />**Field Name:** `onsite_on_web_cart`<br />**Type:** metric                            |
| <div>Cost per add to cart (Shop)</div>                   | <br /><br />**Field Name:** `cost_per_onsite_on_web_cart`<br />**Type:** metric                   |
| <div>Add to cart rate (Shop) (%)</div>                   | <br /><br />**Field Name:** `onsite_on_web_cart_rate`<br />**Type:** metric                       |
| <div>Value per add to cart (Shop)</div>                  | <br /><br />**Field Name:** `value_per_onsite_on_web_cart`<br />**Type:** metric                  |
| <div>Add to cart value (Shop)</div>                      | <br /><br />**Field Name:** `total_onsite_on_web_cart_value`<br />**Type:** metric                |

### Interactive Add On

|                                                  |                                                                                           |
| ------------------------------------------------ | ----------------------------------------------------------------------------------------- |
| <div>Interactive Add On Impressions</div>        | <br /><br />**Field Name:** `interactive_add_on_impressions`<br />**Type:** metric        |
| <div>Interactive Add On Destination Clicks</div> | <br /><br />**Field Name:** `interactive_add_on_destination_clicks`<br />**Type:** metric |
| <div>Interactive Add On Activity Clicks</div>    | <br /><br />**Field Name:** `interactive_add_on_activity_clicks`<br />**Type:** metric    |
| <div>Interactive Add On Option A Clicks</div>    | <br /><br />**Field Name:** `interactive_add_on_option_a_clicks`<br />**Type:** metric    |
| <div>Interactive Add On Option B Clicks</div>    | <br /><br />**Field Name:** `interactive_add_on_option_b_clicks`<br />**Type:** metric    |
| <div>Countdown Sticker Recall Clicks</div>       | <br /><br />**Field Name:** `countdown_sticker_recall_clicks`<br />**Type:** metric       |

### Live Metrics

|                                 |                                                                          |
| ------------------------------- | ------------------------------------------------------------------------ |
| <div>Live Views</div>           | <br /><br />**Field Name:** `live_views`<br />**Type:** metric           |
| <div>Live Unique Views</div>    | <br /><br />**Field Name:** `live_unique_views`<br />**Type:** metric    |
| <div>Live Effective Views</div> | <br /><br />**Field Name:** `live_effective_views`<br />**Type:** metric |
| <div>Live Product Clicks</div>  | <br /><br />**Field Name:** `live_product_clicks`<br />**Type:** metric  |

***

## Related

<CardGroup>
  <Card title="Fields Catalog" icon="book" href="/fields-catalog">
    Browse all platforms
  </Card>

  <Card title="Meta Ads Fields" icon="chart-bar" href="/data-source/facebook-ads/fields">
    Meta Ads metrics & dimensions
  </Card>

  <Card title="Google Ads Fields" icon="chart-bar" href="/data-source/google-ads/fields">
    Google Ads metrics & dimensions
  </Card>

  <Card title="LinkedIn Ads Fields" icon="chart-bar" href="/data-source/linkedin-ads/fields">
    LinkedIn Ads metrics & dimensions
  </Card>
</CardGroup>


# TikTok Ads Troubleshooting
Source: https://support.detrics.io/data-source/tiktok-ads/troubleshooting

Complete troubleshooting guide for TikTok Ads integration

<Info>**Last updated:** August 14, 2025</Info>

Having trouble with your TikTok Ads integration? This guide will help you diagnose and resolve the most common issues.

## TikTok Server Instability

### Understanding TikTok's API Limitations

<Warning>
  **Error message:** "⚠️ TikTok servers are experiencing high load"
</Warning>

TikTok's API can become unstable when processing certain types of data requests, particularly:

**Large Data Requests:**

* **Ad-level data** with extensive timeframes
* **Hourly or daily aggregations** over long periods
* **Multiple accounts** with detailed breakdowns

### Quick Solutions

When you encounter this error, try these solutions in order:

<Steps>
  <Step title="Reduce Timeframe">
    **Start with a smaller date range:**

    * Instead of 6 months, try 1 month
    * For hourly data, limit to 7 days
    * For daily data, limit to 30 days
  </Step>

  <Step title="Switch to Campaign Level">
    **Use higher-level aggregations:**

    * Campaign level instead of Ad level
    * Ad Group level instead of Ad level
    * This significantly reduces API load
  </Step>

  <Step title="Change Time Aggregation">
    **Adjust your time grouping:**

    * Switch from "Hourly" to "Daily"
    * Switch from "Daily" to "All Time"
    * Use "Weekly" or "Monthly" for long timeframes
  </Step>

  <Step title="Split Your Query">
    **For large datasets, create multiple queries:**

    * Split by date ranges (e.g., monthly queries)
    * Split by account (one account per query)
    * Combine results afterward in your spreadsheet
  </Step>
</Steps>

<Info>
  **Still having issues?** If none of these solutions work, please try again in a few hours. These server instability issues typically last from a few hours to 24-48 hours in the most extreme cases.
</Info>

### Why This Happens

TikTok's API has several limitations that can trigger this error:

| Factor                        | Impact                                                                                | Solution                                                                     |
| ----------------------------- | ------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------- |
| **Random TikTok instability** | TikTok's servers occasionally fail to process requests regardless of query complexity | Wait and retry in a few hours                                                |
| **Ad-level complexity**       | Each ad requires multiple API calls                                                   | Use Campaign or Ad Group level                                               |
| **Long timeframes**           | Exponentially more data to process                                                    | Limit to 30-90 days                                                          |
| **Granular time aggregation** | Hourly/daily creates more data points                                                 | Use weekly/monthly for long periods                                          |
| **Multiple breakdowns**       | Each dimension multiplies data volume                                                 | Reduce dimensions temporarily (e.g., age, gender, country, platform, device) |

### Best Practices to Avoid This Error

To avoid encountering this instability, we recommend implementing a **Historical + Dynamic sheet strategy**:

#### The 3-Sheet Strategy

Set up three sheets to separate your data:

1. **"TikTok Ads Combined"** - Your main reporting sheet with all data
2. **"TikTok Ads Dynamic"** - Recent data that updates daily
3. **"TikTok Ads Historical"** - Archived data that doesn't change

#### How to Implement This Strategy

<Steps>
  <Step title="Create Your Historical Sheet">
    Export all your historical data (e.g., all 2024 data and 2025 data up to the previous month) to the "TikTok Ads Historical" sheet. This data is "golden" - it won't change because TikTok's attribution windows are typically shorter.
  </Step>

  <Step title="Set Up Your Dynamic Query">
    Create a smaller query in "TikTok Ads Dynamic" that only pulls recent data (from
    the previous month onwards). This smaller timeframe rarely triggers TikTok's
    instability errors.
  </Step>

  <Step title="Combine Both Sheets">
    In your "TikTok Ads Combined" sheet, use this formula to merge both datasets:

    ```
    =QUERY({
      'TikTok Ads Historical'!A2:Z;
      'TikTok Ads Dynamic'!A2:Z
    }, "SELECT * WHERE Col1 is not null", 0)
    ```

    This gives you complete data without the load issues.
  </Step>

  <Step title="Maintain Your Setup">
    Every 6 months, or when you notice instability errors becoming more frequent, move older data from Dynamic to Historical. This keeps your dynamic query small and fast.
  </Step>
</Steps>

<Tip>
  **Example:** If you have a 2-year ad-level daily query that fails:

  * Historical sheet: All data up to June 2025
  * Dynamic sheet: July 2025 onwards
  * Combined sheet: Merges both for complete reporting

  When you encounter issues again in 1-2 years, simply repeat this optimization process.
</Tip>

<Tip>
  **Need help implementing the 3-sheet strategy?** Our support team can guide
  you through the setup process and help optimize your TikTok Ads queries for
  maximum stability. Reach out to [support@detrics.io](mailto:support@detrics.io) with your specific use case
  and we'll provide personalized recommendations.
</Tip>

## Common Issues & Solutions

<AccordionGroup>
  <Accordion title="Connection Issues">
    **Problem**: Can't connect TikTok Ads account
    **Solutions**:

    * Ensure you have admin access to the TikTok Ads account
    * Check if your TikTok Ads account is active and not suspended
    * Try disconnecting and reconnecting your account
  </Accordion>

  <Accordion title="Missing Data">
    **Problem**: Some metrics or dimensions are missing
    **Solutions**:

    * Verify your account has the necessary permissions
    * Check if the data exists in TikTok Ads Manager first
    * Some metrics may not be available for certain time periods
  </Accordion>

  <Accordion title="Rate Limits">
    **Problem**: Getting rate limit errors
    **Solutions**:

    * Reduce the frequency of your scheduled queries
    * Split large queries into smaller ones
    * Wait a few minutes between manual query executions
  </Accordion>

  <Accordion title="Timeframe Limitations">
    **Problem**: Can't pull data for certain date ranges
    **Solutions**:

    * TikTok has a 30-day limit for daily aggregation
    * Hourly data is limited to 1 day
    * Use "All Time" aggregation for longer periods
  </Accordion>
</AccordionGroup>

<Tip>
  **Need help?** If errors persist after following these steps, please reach out
  to [support@detrics.io](mailto:support@detrics.io)
</Tip>


# TikTok Organic Metrics & Dimensions
Source: https://support.detrics.io/data-source/tiktok-organic/fields

Complete reference for TikTok Organic dimensions and metrics

<Info>
  **Last updated:** August 6, 2026
</Info>

<div>
  <div>
    31 dimensions
  </div>

  <div>
    56 metrics
  </div>
</div>

This reference covers all available dimensions and metrics for TikTok Organic data through Detrics. Use this guide to understand what data you can extract and how to structure your queries.

<div>
  <span>Supported destinations:</span>

  <div>
    Google Sheets
  </div>

  <div>
    Claude
  </div>

  <div>
    BigQuery
  </div>
</div>

## Dimensions

Dimensions are the attributes you can use to segment and group your TikTok Organic data.

### Profile

|                              |                                                                                                                             |
| ---------------------------- | --------------------------------------------------------------------------------------------------------------------------- |
| <div>Username</div>          | Username of TikTok account<br /><br />**Field Name:** `username`<br />**Type:** dimension                                   |
| <div>Display name</div>      | Display name for TikTok account<br /><br />**Field Name:** `display_name`<br />**Type:** dimension                          |
| <div>Profile image URL</div> | The URL link to profile image of the TikTok account<br /><br />**Field Name:** `profile_image_url`<br />**Type:** dimension |
| <div>Bio description</div>   | Bio description of the TikTok account<br /><br />**Field Name:** `bio_description`<br />**Type:** dimension                 |
| <div>Profile deep link</div> | Deep link to the TikTok profile<br /><br />**Field Name:** `profile_deep_link`<br />**Type:** dimension                     |
| <div>Is verified</div>       | Whether the TikTok account is verified<br /><br />**Field Name:** `is_verified`<br />**Type:** dimension                    |
| <div>Open ID</div>           | TikTok open ID for the account<br /><br />**Field Name:** `open_id`<br />**Type:** dimension                                |

### Video

|                              |                                                                                                               |
| ---------------------------- | ------------------------------------------------------------------------------------------------------------- |
| <div>Video ID</div>          | Unique identifier for the video<br /><br />**Field Name:** `video_id`<br />**Type:** dimension                |
| <div>Caption</div>           | The title/caption for the video<br /><br />**Field Name:** `video_title`<br />**Type:** dimension             |
| <div>Video description</div> | The description for the video<br /><br />**Field Name:** `video_description`<br />**Type:** dimension         |
| <div>Create date</div>       | Date when the video was posted<br /><br />**Field Name:** `create_date`<br />**Type:** dimension              |
| <div>Create datetime</div>   | Date and time when the video was posted<br /><br />**Field Name:** `create_datetime`<br />**Type:** dimension |
| <div>Thumbnail URL</div>     | Preview thumbnail URL for the video<br /><br />**Field Name:** `thumbnail_url`<br />**Type:** dimension       |
| <div>Share URL</div>         | A shareable URL for the video<br /><br />**Field Name:** `share_url`<br />**Type:** dimension                 |
| <div>Embed URL</div>         | An embeddable URL for the video<br /><br />**Field Name:** `embed_url`<br />**Type:** dimension               |

### Comments

|                                        |                                                                                                                                                                                                        |
| -------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| <div>Comment ID</div>                  | Unique identifier for the comment. Comments are returned for videos posted within the selected date range.<br /><br />**Field Name:** `comment_id`<br />**Type:** dimension                            |
| <div>Comment Text</div>                | Text content of the comment. Comments are returned for videos posted within the selected date range.<br /><br />**Field Name:** `comment_text`<br />**Type:** dimension                                |
| <div>Comment Author Username</div>     | Username of the account that wrote the comment. Comments are returned for videos posted within the selected date range.<br /><br />**Field Name:** `comment_username`<br />**Type:** dimension         |
| <div>Comment Author Display Name</div> | Display name of the account that wrote the comment. Comments are returned for videos posted within the selected date range.<br /><br />**Field Name:** `comment_display_name`<br />**Type:** dimension |
| <div>Comment Create Date</div>         | Date the comment was created. Comments are returned for videos posted within the selected date range.<br /><br />**Field Name:** `comment_create_date`<br />**Type:** dimension                        |
| <div>Comment Create Datetime</div>     | Date and time the comment was created. Comments are returned for videos posted within the selected date range.<br /><br />**Field Name:** `comment_create_datetime`<br />**Type:** dimension           |
| <div>Comment Video ID</div>            | Identifier of the video the comment was posted on. Comments are returned for videos posted within the selected date range.<br /><br />**Field Name:** `comment_video_id`<br />**Type:** dimension      |
| <div>Comment Status</div>              | Visibility status of the comment (PUBLIC or HIDDEN). Comments are returned for videos posted within the selected date range.<br /><br />**Field Name:** `comment_status`<br />**Type:** dimension      |
| <div>Comment Is Reply</div>            | Whether this comment is a reply to another comment. Comments are returned for videos posted within the selected date range.<br /><br />**Field Name:** `comment_is_reply`<br />**Type:** dimension     |
| <div>Comment Is Pinned</div>           | Whether the video owner pinned this comment. Comments are returned for videos posted within the selected date range.<br /><br />**Field Name:** `comment_is_pinned`<br />**Type:** dimension           |
| <div>Comment Liked By Owner</div>      | Whether the video owner liked this comment. Comments are returned for videos posted within the selected date range.<br /><br />**Field Name:** `comment_liked_by_owner`<br />**Type:** dimension       |
| <div>Comment By Owner</div>            | Whether the comment was written by the video owner. Comments are returned for videos posted within the selected date range.<br /><br />**Field Name:** `comment_by_owner`<br />**Type:** dimension     |

### Discovery

|                         |                                                                                                                                                                                       |
| ----------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| <div>Keyword</div>      | A trending or related TikTok search keyword. Use the Country Code and Keyword filters to control the results.<br /><br />**Field Name:** `discovery_keyword`<br />**Type:** dimension |
| <div>Rank</div>         | Position of the keyword in the trending / related ranking (1 = most prominent).<br /><br />**Field Name:** `discovery_rank`<br />**Type:** dimension                                  |
| <div>Country Code</div> | Country the keywords are ranked for. Set it with a Country Code filter (defaults to US).<br /><br />**Field Name:** `discovery_country_code`<br />**Type:** dimension                 |
| <div>Keyword Type</div> | Whether the keyword is "trending" (top searches) or "related" (returned when you add a Keyword filter).<br /><br />**Field Name:** `discovery_type`<br />**Type:** dimension          |

## Metrics

Metrics are the numerical values you can measure and analyze from your TikTok Organic campaigns.

### Profile

|                                 |                                                                                                                           |
| ------------------------------- | ------------------------------------------------------------------------------------------------------------------------- |
| <div>Current followers</div>    | Current total number of accounts following this profile<br /><br />**Field Name:** `follower_count`<br />**Type:** metric |
| <div>Following count</div>      | Total number of accounts this profile is following<br /><br />**Field Name:** `following_count`<br />**Type:** metric     |
| <div>Total likes received</div> | Total number of likes received across all videos<br /><br />**Field Name:** `total_likes_received`<br />**Type:** metric  |
| <div>Total video count</div>    | Total number of videos published by the account<br /><br />**Field Name:** `total_video_count`<br />**Type:** metric      |

### Video

|                                             |                                                                                                                                                                                                             |
| ------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| <div>Video views</div>                      | The total number of times the video has been viewed<br /><br />**Field Name:** `video_views`<br />**Type:** metric                                                                                          |
| <div>Likes</div>                            | The total number of likes the video has received<br /><br />**Field Name:** `video_likes`<br />**Type:** metric                                                                                             |
| <div>Comments</div>                         | The total number of comments the video has received<br /><br />**Field Name:** `video_comments`<br />**Type:** metric                                                                                       |
| <div>Shares</div>                           | The total number of times the video has been shared<br /><br />**Field Name:** `video_shares`<br />**Type:** metric                                                                                         |
| <div>Video duration (s)</div>               | Duration of the video, in seconds<br /><br />**Field Name:** `video_duration_sec`<br />**Type:** metric                                                                                                     |
| <div>Video duration (min)</div>             | Duration of the video, in minutes<br /><br />**Field Name:** `video_duration_min`<br />**Type:** metric                                                                                                     |
| <div>Video Reach</div>                      | Number of unique people who watched the video at least once. Requires a TikTok Business account.<br /><br />**Field Name:** `video_reach`<br />**Type:** metric                                             |
| <div>Video Saves</div>                      | Number of times the video was added to Favorites (saves). Requires a TikTok Business account.<br /><br />**Field Name:** `video_saves`<br />**Type:** metric                                                |
| <div>Video Total Time Watched (sec)</div>   | Total time viewers spent watching the video, in seconds. Requires a TikTok Business account.<br /><br />**Field Name:** `video_total_time_watched`<br />**Type:** metric                                    |
| <div>Video Average Time Watched (sec)</div> | Average time viewers spent watching the video, in seconds. Requires a TikTok Business account.<br /><br />**Field Name:** `video_average_time_watched`<br />**Type:** metric                                |
| <div>Video Full Watch Rate</div>            | Percentage of viewers who watched the video to the end. Requires a TikTok Business account.<br /><br />**Field Name:** `video_full_watch_rate`<br />**Type:** metric                                        |
| <div>Video New Followers</div>              | New followers gained from this video. Requires a TikTok Business account.<br /><br />**Field Name:** `video_new_followers`<br />**Type:** metric                                                            |
| <div>Video Profile Views</div>              | Profile views driven by this video. Requires a TikTok Business account.<br /><br />**Field Name:** `video_profile_views`<br />**Type:** metric                                                              |
| <div>Video Website Clicks</div>             | Website button clicks driven by this video. Requires a TikTok Business account.<br /><br />**Field Name:** `video_website_clicks`<br />**Type:** metric                                                     |
| <div>Video Email Clicks</div>               | Email button clicks driven by this video. Requires a TikTok Business account.<br /><br />**Field Name:** `video_email_clicks`<br />**Type:** metric                                                         |
| <div>Video Phone Number Clicks</div>        | Phone number button clicks driven by this video. Requires a TikTok Business account.<br /><br />**Field Name:** `video_phone_clicks`<br />**Type:** metric                                                  |
| <div>Video Address Clicks</div>             | Address button clicks driven by this video. Requires a TikTok Business account.<br /><br />**Field Name:** `video_address_clicks`<br />**Type:** metric                                                     |
| <div>Video App Download Clicks</div>        | App download button clicks driven by this video. Requires a TikTok Business account.<br /><br />**Field Name:** `video_app_download_clicks`<br />**Type:** metric                                           |
| <div>Video Lead Submissions</div>           | Lead form submissions driven by this video. Requires a TikTok Business account.<br /><br />**Field Name:** `video_lead_submissions`<br />**Type:** metric                                                   |
| <div>Media Type</div>                       | Post type: VIDEO or PHOTO.<br /><br />**Field Name:** `video_media_type`<br />**Type:** metric                                                                                                              |
| <div>Is Ad (Spark)</div>                    | Whether the post was boosted as a Spark Ad.<br /><br />**Field Name:** `video_is_ad`<br />**Type:** metric                                                                                                  |
| <div>Video Impression Sources</div>         | Traffic sources for the video as a percentage breakdown (e.g. "For You: 76%, Follow: 24%"). Requires a TikTok Business account.<br /><br />**Field Name:** `video_impression_sources`<br />**Type:** metric |
| <div>Video Audience Countries</div>         | Viewer country distribution as percentages (e.g. "US: 73%, CA: 5%"). Requires a TikTok Business account.<br /><br />**Field Name:** `video_audience_countries`<br />**Type:** metric                        |
| <div>Video Audience Cities</div>            | Viewer city distribution as percentages. Requires a TikTok Business account.<br /><br />**Field Name:** `video_audience_cities`<br />**Type:** metric                                                       |
| <div>Video Audience Genders</div>           | Viewer gender distribution as percentages (Female/Male/Other). Requires a TikTok Business account.<br /><br />**Field Name:** `video_audience_genders`<br />**Type:** metric                                |
| <div>Video Audience Types</div>             | Viewer type distribution (new vs returning viewers, followers vs non-followers) as percentages. Requires a TikTok Business account.<br /><br />**Field Name:** `video_audience_types`<br />**Type:** metric |
| <div>Video View Retention Curve</div>       | Retention curve: percentage of viewers still watching at each second (e.g. "0s:100%, 1s:82%"). Requires a TikTok Business account.<br /><br />**Field Name:** `video_view_retention`<br />**Type:** metric  |
| <div>Video Like Timeline</div>              | Like timeline: cumulative like percentage at each second of the video. Requires a TikTok Business account.<br /><br />**Field Name:** `video_like_timeline`<br />**Type:** metric                           |

### Account Insights

|                                        |                                                                                                                                                                                                     |
| -------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| <div>Account Followers</div>           | Number of followers on the account for the day. Requires a TikTok Business account; only the last 60 days are available.<br /><br />**Field Name:** `account_followers_count`<br />**Type:** metric |
| <div>Account Profile Views</div>       | Number of profile views for the day. Requires a TikTok Business account; only the last 60 days are available.<br /><br />**Field Name:** `account_profile_views`<br />**Type:** metric              |
| <div>Account Video Views</div>         | Total video views across the account for the day. Requires a TikTok Business account; only the last 60 days are available.<br /><br />**Field Name:** `account_video_views`<br />**Type:** metric   |
| <div>Account Likes</div>               | Total likes across the account for the day. Requires a TikTok Business account; only the last 60 days are available.<br /><br />**Field Name:** `account_likes`<br />**Type:** metric               |
| <div>Account Comments</div>            | Total comments across the account for the day. Requires a TikTok Business account; only the last 60 days are available.<br /><br />**Field Name:** `account_comments`<br />**Type:** metric         |
| <div>Account Shares</div>              | Total shares across the account for the day. Requires a TikTok Business account; only the last 60 days are available.<br /><br />**Field Name:** `account_shares`<br />**Type:** metric             |
| <div>Account Unique Video Views</div>  | Unique viewers of the account’s videos for the day. Requires a TikTok Business account; last 60 days only.<br /><br />**Field Name:** `account_unique_video_views`<br />**Type:** metric            |
| <div>Account New Followers</div>       | Followers gained for the day. Requires a TikTok Business account; last 60 days only.<br /><br />**Field Name:** `account_new_followers`<br />**Type:** metric                                       |
| <div>Account Lost Followers</div>      | Followers lost for the day. Requires a TikTok Business account; last 60 days only.<br /><br />**Field Name:** `account_lost_followers`<br />**Type:** metric                                        |
| <div>Account Net Follower Growth</div> | Net follower growth for the day (gained minus lost). Requires a TikTok Business account; last 60 days only.<br /><br />**Field Name:** `account_net_follower_growth`<br />**Type:** metric          |
| <div>Account Engaged Audience</div>    | Unique accounts that engaged for the day. Requires a TikTok Business account; last 60 days only.<br /><br />**Field Name:** `account_engaged_audience`<br />**Type:** metric                        |
| <div>Account Bio Link Clicks</div>     | Bio link clicks for the day. Requires a TikTok Business account; last 60 days only.<br /><br />**Field Name:** `account_bio_link_clicks`<br />**Type:** metric                                      |
| <div>Account Email Clicks</div>        | Email button clicks for the day. Requires a TikTok Business account; last 60 days only.<br /><br />**Field Name:** `account_email_clicks`<br />**Type:** metric                                     |
| <div>Account Phone Number Clicks</div> | Phone number button clicks for the day. Requires a TikTok Business account; last 60 days only.<br /><br />**Field Name:** `account_phone_clicks`<br />**Type:** metric                              |
| <div>Account Address Clicks</div>      | Address button clicks for the day. Requires a TikTok Business account; last 60 days only.<br /><br />**Field Name:** `account_address_clicks`<br />**Type:** metric                                 |
| <div>Account App Download Clicks</div> | App download button clicks for the day. Requires a TikTok Business account; last 60 days only.<br /><br />**Field Name:** `account_app_download_clicks`<br />**Type:** metric                       |
| <div>Account Lead Submissions</div>    | Lead form submissions for the day. Requires a TikTok Business account; last 60 days only.<br /><br />**Field Name:** `account_lead_submissions`<br />**Type:** metric                               |
| <div>Audience Active Hours</div>       | Active hours of the audience as "HH:00=count" pairs (UTC). Requires a TikTok Business account.<br /><br />**Field Name:** `account_audience_activity`<br />**Type:** metric                         |
| <div>Audience Countries</div>          | Audience country distribution as percentages for the window. Requires a TikTok Business account.<br /><br />**Field Name:** `audience_countries`<br />**Type:** metric                              |
| <div>Audience Cities</div>             | Audience city distribution as percentages for the window. Requires a TikTok Business account.<br /><br />**Field Name:** `audience_cities`<br />**Type:** metric                                    |
| <div>Audience Genders</div>            | Audience gender distribution as percentages for the window. Requires a TikTok Business account.<br /><br />**Field Name:** `audience_genders`<br />**Type:** metric                                 |
| <div>Audience Ages</div>               | Audience age distribution as percentages for the window. Requires a TikTok Business account.<br /><br />**Field Name:** `audience_ages`<br />**Type:** metric                                       |

### Comments

|                            |                                                                                                                                                                                        |
| -------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| <div>Comment Likes</div>   | Number of likes the comment has received. Comments are returned for videos posted within the selected date range.<br /><br />**Field Name:** `comment_likes`<br />**Type:** metric     |
| <div>Comment Replies</div> | Number of replies the comment has received. Comments are returned for videos posted within the selected date range.<br /><br />**Field Name:** `comment_replies`<br />**Type:** metric |

***

## Related

<CardGroup>
  <Card title="Fields Catalog" icon="book" href="/fields-catalog">
    Browse all platforms
  </Card>

  <Card title="Instagram Insights Fields" icon="chart-bar" href="/data-source/instagram-insights/fields">
    Instagram Insights metrics & dimensions
  </Card>

  <Card title="Facebook Insights Fields" icon="chart-bar" href="/data-source/facebook-insights/fields">
    Facebook Insights metrics & dimensions
  </Card>

  <Card title="Facebook Public Data Fields" icon="chart-bar" href="/data-source/facebook-public-data/fields">
    Facebook Public Data metrics & dimensions
  </Card>
</CardGroup>


# VTEX Metrics & Dimensions
Source: https://support.detrics.io/data-source/vtex/fields

Complete reference for VTEX store dimensions and metrics

<Info>
  **Last updated:** August 6, 2026
</Info>

<div>
  <div>
    83 dimensions
  </div>

  <div>
    8 metrics
  </div>
</div>

This reference covers all available dimensions and metrics for VTEX data through Detrics. Use this guide to understand what data you can extract and how to structure your queries.

<div>
  <span>Supported destinations:</span>

  <div>
    Google Sheets
  </div>

  <div>
    Claude
  </div>

  <div>
    BigQuery
  </div>
</div>

## Dimensions

Dimensions are the attributes you can use to segment and group your VTEX data.

### Orders

|                               |                                                                                                                                                                                                                                                                                     |
| ----------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| <div>Order ID</div>           | Unique identifier for the order<br /><br />**Field Name:** `orderId`<br />**Type:** dimension                                                                                                                                                                                       |
| <div>Order Sequence</div>     | Sequential number of the order<br /><br />**Field Name:** `orderSequence`<br />**Type:** dimension                                                                                                                                                                                  |
| <div>Status</div>             | Current status of the order<br /><br />**Field Name:** `status`<br />**Type:** dimension                                                                                                                                                                                            |
| <div>Status Description</div> | Human-readable description of the order status<br /><br />**Field Name:** `statusDescription`<br />**Type:** dimension                                                                                                                                                              |
| <div>Client Name</div>        | Name of the customer who placed the order<br /><br />**Field Name:** `clientName`<br />**Type:** dimension                                                                                                                                                                          |
| <div>Payment Names</div>      | Payment method names used in the order<br /><br />**Field Name:** `paymentNames`<br />**Type:** dimension                                                                                                                                                                           |
| <div>Sales Channel</div>      | Sales channel through which the order was placed<br /><br />**Field Name:** `salesChannel`<br />**Type:** dimension                                                                                                                                                                 |
| <div>Origin</div>             | Origin of the order (e.g., Marketplace, Fulfillment)<br /><br />**Field Name:** `origin`<br />**Type:** dimension                                                                                                                                                                   |
| <div>Affiliate ID</div>       | Identifier of the affiliate associated with the order<br /><br />**Field Name:** `affiliateId`<br />**Type:** dimension                                                                                                                                                             |
| <div>Currency Code</div>      | Currency code used in the order<br /><br />**Field Name:** `currencyCode`<br />**Type:** dimension                                                                                                                                                                                  |
| <div>Hostname</div>           | Store hostname where the order was placed<br /><br />**Field Name:** `hostname`<br />**Type:** dimension                                                                                                                                                                            |
| <div>Order Is Complete</div>  | Whether the order is fully complete<br /><br />**Field Name:** `orderIsComplete`<br />**Type:** dimension                                                                                                                                                                           |
| <div>Rates and Benefits</div> | Promotions and benefits applied to the order (VTEX "Tasas y beneficios"), joined by "; ". Note: this and the other detail fields below are fetched per order and can noticeably slow down large date ranges.<br /><br />**Field Name:** `ratesAndBenefits`<br />**Type:** dimension |
| <div>Order Group</div>        | VTEX order group id (groups orders split from one checkout).<br /><br />**Field Name:** `orderGroup`<br />**Type:** dimension                                                                                                                                                       |
| <div>Items Total</div>        | Gross value of the order items (before discounts).<br /><br />**Field Name:** `orderItemsTotal`<br />**Type:** dimension                                                                                                                                                            |
| <div>Discounts Total</div>    | Total discounts applied to the order (usually negative).<br /><br />**Field Name:** `orderDiscountsTotal`<br />**Type:** dimension                                                                                                                                                  |
| <div>Shipping Total</div>     | Total shipping charge for the order.<br /><br />**Field Name:** `orderShippingTotal`<br />**Type:** dimension                                                                                                                                                                       |
| <div>Tax Total</div>          | Total tax charged on the order.<br /><br />**Field Name:** `orderTaxTotal`<br />**Type:** dimension                                                                                                                                                                                 |

### Order Dates

|                                    |                                                                                                                  |
| ---------------------------------- | ---------------------------------------------------------------------------------------------------------------- |
| <div>Creation Date</div>           | Date the order was created<br /><br />**Field Name:** `creationDate`<br />**Type:** dimension                    |
| <div>Authorized Date</div>         | Date the order payment was authorized<br /><br />**Field Name:** `authorizedDate`<br />**Type:** dimension       |
| <div>Payment Approved Date</div>   | Date the payment was approved<br /><br />**Field Name:** `paymentApprovedDate`<br />**Type:** dimension          |
| <div>Ready For Handling Date</div> | Date the order was ready for handling<br /><br />**Field Name:** `readyForHandlingDate`<br />**Type:** dimension |
| <div>Last Change Date</div>        | Date of the last change to the order<br /><br />**Field Name:** `lastChangeDate`<br />**Type:** dimension        |

### Order Shipping & Delivery

|                                    |                                                                                                                         |
| ---------------------------------- | ----------------------------------------------------------------------------------------------------------------------- |
| <div>Shipping Estimated Date</div> | Estimated shipping delivery date<br /><br />**Field Name:** `shippingEstimatedDate`<br />**Type:** dimension            |
| <div>Is All Delivered</div>        | Whether all items in the order have been delivered<br /><br />**Field Name:** `isAllDelivered`<br />**Type:** dimension |
| <div>Is Any Delivered</div>        | Whether any items in the order have been delivered<br /><br />**Field Name:** `isAnyDelivered`<br />**Type:** dimension |
| <div>Shipping City</div>           | Shipping address city.<br /><br />**Field Name:** `shippingCity`<br />**Type:** dimension                               |
| <div>Shipping State</div>          | Shipping address state/province.<br /><br />**Field Name:** `shippingState`<br />**Type:** dimension                    |
| <div>Shipping Postal Code</div>    | Shipping address postal code.<br /><br />**Field Name:** `shippingPostalCode`<br />**Type:** dimension                  |
| <div>Shipping Country</div>        | Shipping address country.<br /><br />**Field Name:** `shippingCountry`<br />**Type:** dimension                         |
| <div>Shipping Neighborhood</div>   | Shipping address neighborhood.<br /><br />**Field Name:** `shippingNeighborhood`<br />**Type:** dimension               |
| <div>Shipping Receiver Name</div>  | Name of the person receiving the shipment.<br /><br />**Field Name:** `shippingReceiverName`<br />**Type:** dimension   |
| <div>Shipping Method</div>         | Selected shipping method (SLA).<br /><br />**Field Name:** `shippingMethod`<br />**Type:** dimension                    |
| <div>Delivery Company</div>        | Carrier / delivery company for the shipment.<br /><br />**Field Name:** `deliveryCompany`<br />**Type:** dimension      |

### Order Marketing

|                         |                                                                                                                         |
| ----------------------- | ----------------------------------------------------------------------------------------------------------------------- |
| <div>Coupon</div>       | Coupon code applied to the order.<br /><br />**Field Name:** `orderCoupon`<br />**Type:** dimension                     |
| <div>UTM Source</div>   | Marketing attribution UTM source of the order.<br /><br />**Field Name:** `orderUtmSource`<br />**Type:** dimension     |
| <div>UTM Medium</div>   | Marketing attribution UTM medium of the order.<br /><br />**Field Name:** `orderUtmMedium`<br />**Type:** dimension     |
| <div>UTM Campaign</div> | Marketing attribution UTM campaign of the order.<br /><br />**Field Name:** `orderUtmCampaign`<br />**Type:** dimension |
| <div>UTM Partner</div>  | Marketing attribution UTM partner of the order.<br /><br />**Field Name:** `orderUtmPartner`<br />**Type:** dimension   |

### Order Customer

|                                   |                                                                                                                                                                           |
| --------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| <div>Customer Email</div>         | Customer email (may be masked by VTEX with a "…@ct.vtex.com.br" suffix depending on token permissions).<br /><br />**Field Name:** `clientEmail`<br />**Type:** dimension |
| <div>Customer Document</div>      | Customer identity document number (e.g. DNI / CUIT).<br /><br />**Field Name:** `clientDocument`<br />**Type:** dimension                                                 |
| <div>Customer Document Type</div> | Type of the customer identity document.<br /><br />**Field Name:** `clientDocumentType`<br />**Type:** dimension                                                          |
| <div>Customer Phone</div>         | Customer phone number.<br /><br />**Field Name:** `clientPhone`<br />**Type:** dimension                                                                                  |
| <div>Corporate Name</div>         | Corporate/company name (for corporate orders).<br /><br />**Field Name:** `clientCorporateName`<br />**Type:** dimension                                                  |
| <div>Is Corporate</div>           | Whether the order was placed by a corporate customer.<br /><br />**Field Name:** `clientIsCorporate`<br />**Type:** dimension                                             |

### Order Items

|                                  |                                                                                                                                                                                                |
| -------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| <div>Item ID</div>               | VTEX item/SKU id of the order line.<br /><br />**Field Name:** `itemId`<br />**Type:** dimension                                                                                               |
| <div>Item Name</div>             | Product name of the order line.<br /><br />**Field Name:** `itemName`<br />**Type:** dimension                                                                                                 |
| <div>Item Product ID</div>       | VTEX product id of the order line.<br /><br />**Field Name:** `itemProductId`<br />**Type:** dimension                                                                                         |
| <div>Item Reference ID</div>     | Seller reference id (RefId) of the order line.<br /><br />**Field Name:** `itemRefId`<br />**Type:** dimension                                                                                 |
| <div>Item EAN</div>              | EAN/barcode of the order line.<br /><br />**Field Name:** `itemEan`<br />**Type:** dimension                                                                                                   |
| <div>Item Seller</div>           | Seller id fulfilling the order line.<br /><br />**Field Name:** `itemSeller`<br />**Type:** dimension                                                                                          |
| <div>Item Seller SKU</div>       | Seller's SKU code for the order line.<br /><br />**Field Name:** `itemSellerSku`<br />**Type:** dimension                                                                                      |
| <div>Item Brand</div>            | Brand name of the order line product.<br /><br />**Field Name:** `itemBrandName`<br />**Type:** dimension                                                                                      |
| <div>Item Categories</div>       | Category names of the order line product, joined by "; ".<br /><br />**Field Name:** `itemCategories`<br />**Type:** dimension                                                                 |
| <div>Item Measurement Unit</div> | Measurement unit of the order line (e.g. "un").<br /><br />**Field Name:** `itemMeasurementUnit`<br />**Type:** dimension                                                                      |
| <div>Item Quantity</div>         | Quantity ordered for the line.<br /><br />**Field Name:** `itemQuantity`<br />**Type:** dimension                                                                                              |
| <div>Item Price</div>            | Unit price of the order line.<br /><br />**Field Name:** `itemPrice`<br />**Type:** dimension                                                                                                  |
| <div>Item List Price</div>       | List (pre-discount) unit price of the order line.<br /><br />**Field Name:** `itemListPrice`<br />**Type:** dimension                                                                          |
| <div>Item Selling Price</div>    | Actual selling unit price of the order line.<br /><br />**Field Name:** `itemSellingPrice`<br />**Type:** dimension                                                                            |
| <div>Item Cost Price</div>       | Cost price of the order line (enables margin analysis).<br /><br />**Field Name:** `itemCostPrice`<br />**Type:** dimension                                                                    |
| <div>Item Tax</div>              | Tax amount on the order line.<br /><br />**Field Name:** `itemTax`<br />**Type:** dimension                                                                                                    |
| <div>Item Line Total</div>       | Line revenue = selling price × quantity. Use this (not Item Selling Price, which is per-unit) to sum revenue across items.<br /><br />**Field Name:** `itemLineTotal`<br />**Type:** dimension |
| <div>Item Line Cost</div>        | Line cost = cost price × quantity. Item Line Total − Item Line Cost gives line margin, and both sum correctly.<br /><br />**Field Name:** `itemLineCost`<br />**Type:** dimension              |

### Products

|                          |                                                                                                     |
| ------------------------ | --------------------------------------------------------------------------------------------------- |
| <div>Product ID</div>    | Unique identifier for the product<br /><br />**Field Name:** `productId`<br />**Type:** dimension   |
| <div>Product Name</div>  | Name of the product<br /><br />**Field Name:** `productName`<br />**Type:** dimension               |
| <div>Brand ID</div>      | Unique identifier for the brand<br /><br />**Field Name:** `brandId`<br />**Type:** dimension       |
| <div>Brand Name</div>    | Name of the brand<br /><br />**Field Name:** `brandName`<br />**Type:** dimension                   |
| <div>Category ID</div>   | Unique identifier for the category<br /><br />**Field Name:** `categoryId`<br />**Type:** dimension |
| <div>Category Name</div> | Name of the category<br /><br />**Field Name:** `categoryName`<br />**Type:** dimension             |

### Product Details

|                                 |                                                                                                             |
| ------------------------------- | ----------------------------------------------------------------------------------------------------------- |
| <div>Product Reference ID</div> | External reference ID for the product<br /><br />**Field Name:** `productRefId`<br />**Type:** dimension    |
| <div>Product Link ID</div>      | URL-friendly identifier for the product<br /><br />**Field Name:** `productLinkId`<br />**Type:** dimension |
| <div>Product Description</div>  | Description of the product<br /><br />**Field Name:** `productDescription`<br />**Type:** dimension         |
| <div>Release Date</div>         | Product release date<br /><br />**Field Name:** `releaseDate`<br />**Type:** dimension                      |
| <div>Product Title</div>        | Title of the product<br /><br />**Field Name:** `productTitle`<br />**Type:** dimension                     |

### SKUs

|                                 |                                                                                                          |
| ------------------------------- | -------------------------------------------------------------------------------------------------------- |
| <div>SKU ID</div>               | Unique identifier for the SKU<br /><br />**Field Name:** `skuId`<br />**Type:** dimension                |
| <div>SKU Product ID</div>       | Product ID associated with this SKU<br /><br />**Field Name:** `skuProductId`<br />**Type:** dimension   |
| <div>SKU Name</div>             | Name of the SKU<br /><br />**Field Name:** `skuName`<br />**Type:** dimension                            |
| <div>SKU Reference ID</div>     | External reference ID for the SKU<br /><br />**Field Name:** `skuRefId`<br />**Type:** dimension         |
| <div>SKU Measurement Unit</div> | Unit of measurement for the SKU<br /><br />**Field Name:** `skuMeasurementUnit`<br />**Type:** dimension |
| <div>SKU Is Kit</div>           | Whether the SKU is a kit<br /><br />**Field Name:** `skuIsKit`<br />**Type:** dimension                  |

### Inventory

|                             |                                                                                                       |
| --------------------------- | ----------------------------------------------------------------------------------------------------- |
| <div>Inventory SKU ID</div> | SKU ID in the inventory context<br /><br />**Field Name:** `inventorySkuId`<br />**Type:** dimension  |
| <div>Warehouse ID</div>     | Unique identifier for the warehouse<br /><br />**Field Name:** `warehouseId`<br />**Type:** dimension |
| <div>Warehouse Name</div>   | Name of the warehouse<br /><br />**Field Name:** `warehouseName`<br />**Type:** dimension             |

## Metrics

Metrics are the numerical values you can measure and analyze from your VTEX campaigns.

### Orders

|                        |                                                                                                  |
| ---------------------- | ------------------------------------------------------------------------------------------------ |
| <div>Total Value</div> | Total monetary value of the order<br /><br />**Field Name:** `totalValue`<br />**Type:** metric  |
| <div>Total Items</div> | Total number of items in the order<br /><br />**Field Name:** `totalItems`<br />**Type:** metric |

### SKU Pricing

|                                   |                                                                                                                |
| --------------------------------- | -------------------------------------------------------------------------------------------------------------- |
| <div>SKU Price</div>              | Current selling price of the SKU<br /><br />**Field Name:** `skuPrice`<br />**Type:** metric                   |
| <div>SKU List Price</div>         | Original list price of the SKU<br /><br />**Field Name:** `skuListPrice`<br />**Type:** metric                 |
| <div>SKU Available Quantity</div> | Available quantity of the SKU in stock<br /><br />**Field Name:** `skuAvailableQuantity`<br />**Type:** metric |

### Inventory

|                               |                                                                                                                   |
| ----------------------------- | ----------------------------------------------------------------------------------------------------------------- |
| <div>Total Quantity</div>     | Total quantity of inventory<br /><br />**Field Name:** `inventoryTotalQuantity`<br />**Type:** metric             |
| <div>Reserved Quantity</div>  | Quantity reserved for pending orders<br /><br />**Field Name:** `inventoryReservedQuantity`<br />**Type:** metric |
| <div>Available Quantity</div> | Quantity available for sale<br /><br />**Field Name:** `inventoryAvailableQuantity`<br />**Type:** metric         |

***

## Related

<CardGroup>
  <Card title="Fields Catalog" icon="book" href="/fields-catalog">
    Browse all platforms
  </Card>

  <Card title="Shopify Fields" icon="chart-bar" href="/data-source/shopify/fields">
    Shopify metrics & dimensions
  </Card>

  <Card title="TiendaNube Fields" icon="chart-bar" href="/data-source/tiendanube/fields">
    TiendaNube metrics & dimensions
  </Card>

  <Card title="WooCommerce Fields" icon="chart-bar" href="/data-source/woocommerce/fields">
    WooCommerce metrics & dimensions
  </Card>
</CardGroup>


# WooCommerce Metrics & Dimensions
Source: https://support.detrics.io/data-source/woocommerce/fields

Complete reference for WooCommerce store dimensions and metrics

<Info>
  **Last updated:** August 6, 2026
</Info>

<div>
  <div>
    68 dimensions
  </div>

  <div>
    24 metrics
  </div>
</div>

This reference covers all available dimensions and metrics for WooCommerce data through Detrics. Use this guide to understand what data you can extract and how to structure your queries.

<div>
  <span>Supported destinations:</span>

  <div>
    Google Sheets
  </div>

  <div>
    Claude
  </div>

  <div>
    BigQuery
  </div>
</div>

## Dimensions

Dimensions are the attributes you can use to segment and group your WooCommerce data.

### Store

|                      |                                                                  |
| -------------------- | ---------------------------------------------------------------- |
| <div>Store URL</div> | <br /><br />**Field Name:** `store_url`<br />**Type:** dimension |

### Order

|                              |                                                                          |
| ---------------------------- | ------------------------------------------------------------------------ |
| <div>Order Number</div>      | <br /><br />**Field Name:** `order_number`<br />**Type:** dimension      |
| <div>Order ID</div>          | <br /><br />**Field Name:** `order_id`<br />**Type:** dimension          |
| <div>Order Parent ID</div>   | <br /><br />**Field Name:** `order_parent_id`<br />**Type:** dimension   |
| <div>Order Key</div>         | <br /><br />**Field Name:** `order_key`<br />**Type:** dimension         |
| <div>Order Status</div>      | <br /><br />**Field Name:** `order_status`<br />**Type:** dimension      |
| <div>Order Currency</div>    | <br /><br />**Field Name:** `order_currency`<br />**Type:** dimension    |
| <div>Order Created Via</div> | <br /><br />**Field Name:** `order_created_via`<br />**Type:** dimension |

### Order Timestamp

|                                         |                                                                                     |
| --------------------------------------- | ----------------------------------------------------------------------------------- |
| <div>Order Created Date</div>           | <br /><br />**Field Name:** `order_created_date`<br />**Type:** dimension           |
| <div>Order Created Datetime</div>       | <br /><br />**Field Name:** `order_created_datetime`<br />**Type:** dimension       |
| <div>Order Modified Date</div>          | <br /><br />**Field Name:** `order_modified_date`<br />**Type:** dimension          |
| <div>Order Modified Datetime</div>      | <br /><br />**Field Name:** `order_modified_datetime`<br />**Type:** dimension      |
| <div>Order Paid Date</div>              | <br /><br />**Field Name:** `order_paid_date`<br />**Type:** dimension              |
| <div>Order Paid Datetime</div>          | <br /><br />**Field Name:** `order_paid_datetime`<br />**Type:** dimension          |
| <div>Order Completed Date</div>         | <br /><br />**Field Name:** `order_completed_date`<br />**Type:** dimension         |
| <div>Order Completed Datetime</div>     | <br /><br />**Field Name:** `order_completed_datetime`<br />**Type:** dimension     |
| <div>Order Created Date GMT</div>       | <br /><br />**Field Name:** `order_created_date_gmt`<br />**Type:** dimension       |
| <div>Order Created Datetime GMT</div>   | <br /><br />**Field Name:** `order_created_datetime_gmt`<br />**Type:** dimension   |
| <div>Order Modified Date GMT</div>      | <br /><br />**Field Name:** `order_modified_date_gmt`<br />**Type:** dimension      |
| <div>Order Modified Datetime GMT</div>  | <br /><br />**Field Name:** `order_modified_datetime_gmt`<br />**Type:** dimension  |
| <div>Order Paid Date GMT</div>          | <br /><br />**Field Name:** `order_paid_date_gmt`<br />**Type:** dimension          |
| <div>Order Paid Datetime GMT</div>      | <br /><br />**Field Name:** `order_paid_datetime_gmt`<br />**Type:** dimension      |
| <div>Order Completed Date GMT</div>     | <br /><br />**Field Name:** `order_completed_date_gmt`<br />**Type:** dimension     |
| <div>Order Completed Datetime GMT</div> | <br /><br />**Field Name:** `order_completed_datetime_gmt`<br />**Type:** dimension |

### Billing

|                                   |                                                                               |
| --------------------------------- | ----------------------------------------------------------------------------- |
| <div>Billing First Name</div>     | <br /><br />**Field Name:** `billing_first_name`<br />**Type:** dimension     |
| <div>Billing Last Name</div>      | <br /><br />**Field Name:** `billing_last_name`<br />**Type:** dimension      |
| <div>Billing Company Name</div>   | <br /><br />**Field Name:** `billing_company_name`<br />**Type:** dimension   |
| <div>Billing Address Line 1</div> | <br /><br />**Field Name:** `billing_address_line_1`<br />**Type:** dimension |
| <div>Billing Address Line 2</div> | <br /><br />**Field Name:** `billing_address_line_2`<br />**Type:** dimension |
| <div>Billing City</div>           | <br /><br />**Field Name:** `billing_city`<br />**Type:** dimension           |
| <div>Billing State</div>          | <br /><br />**Field Name:** `billing_state`<br />**Type:** dimension          |
| <div>Billing Postcode</div>       | <br /><br />**Field Name:** `billing_postcode`<br />**Type:** dimension       |
| <div>Billing Country Code</div>   | <br /><br />**Field Name:** `billing_country_code`<br />**Type:** dimension   |
| <div>Billing Email</div>          | <br /><br />**Field Name:** `billing_email`<br />**Type:** dimension          |
| <div>Billing Phone</div>          | <br /><br />**Field Name:** `billing_phone`<br />**Type:** dimension          |

### Shipping

|                                    |                                                                                |
| ---------------------------------- | ------------------------------------------------------------------------------ |
| <div>Shipping First Name</div>     | <br /><br />**Field Name:** `shipping_first_name`<br />**Type:** dimension     |
| <div>Shipping Last Name</div>      | <br /><br />**Field Name:** `shipping_last_name`<br />**Type:** dimension      |
| <div>Shipping Company Name</div>   | <br /><br />**Field Name:** `shipping_company_name`<br />**Type:** dimension   |
| <div>Shipping Address Line 1</div> | <br /><br />**Field Name:** `shipping_address_line_1`<br />**Type:** dimension |
| <div>Shipping Address Line 2</div> | <br /><br />**Field Name:** `shipping_address_line_2`<br />**Type:** dimension |
| <div>Shipping City</div>           | <br /><br />**Field Name:** `shipping_city`<br />**Type:** dimension           |
| <div>Shipping State</div>          | <br /><br />**Field Name:** `shipping_state`<br />**Type:** dimension          |
| <div>Shipping Postcode</div>       | <br /><br />**Field Name:** `shipping_postcode`<br />**Type:** dimension       |
| <div>Shipping Country Code</div>   | <br /><br />**Field Name:** `shipping_country_code`<br />**Type:** dimension   |

### Payment

|                                  |                                                                              |
| -------------------------------- | ---------------------------------------------------------------------------- |
| <div>Order is Paid</div>         | <br /><br />**Field Name:** `order_is_paid`<br />**Type:** dimension         |
| <div>Payment Method ID</div>     | <br /><br />**Field Name:** `payment_method_id`<br />**Type:** dimension     |
| <div>Payment Method Title</div>  | <br /><br />**Field Name:** `payment_method_title`<br />**Type:** dimension  |
| <div>Unique Transaction ID</div> | <br /><br />**Field Name:** `unique_transaction_id`<br />**Type:** dimension |
| <div>Prices Include Tax</div>    | <br /><br />**Field Name:** `prices_include_tax`<br />**Type:** dimension    |

### Customer

|                                |                                                                            |
| ------------------------------ | -------------------------------------------------------------------------- |
| <div>Customer ID</div>         | <br /><br />**Field Name:** `customer_id`<br />**Type:** dimension         |
| <div>Customer IP Address</div> | <br /><br />**Field Name:** `customer_ip_address`<br />**Type:** dimension |
| <div>Customer User Agent</div> | <br /><br />**Field Name:** `customer_user_agent`<br />**Type:** dimension |
| <div>Customer Note</div>       | <br /><br />**Field Name:** `customer_note`<br />**Type:** dimension       |

### Order Attribution

|                                    |                                                                                                                                                                                                            |
| ---------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| <div>UTM Source</div>              | UTM source parameter (e.g., google, facebook). Requires WooCommerce 8.5+ with Order Attribution enabled.<br /><br />**Field Name:** `attribution_utm_source`<br />**Type:** dimension                      |
| <div>UTM Medium</div>              | UTM medium parameter (e.g., cpc, email, social). Requires WooCommerce 8.5+ with Order Attribution enabled.<br /><br />**Field Name:** `attribution_utm_medium`<br />**Type:** dimension                    |
| <div>UTM Campaign</div>            | UTM campaign name. Requires WooCommerce 8.5+ with Order Attribution enabled.<br /><br />**Field Name:** `attribution_utm_campaign`<br />**Type:** dimension                                                |
| <div>UTM Content</div>             | UTM content parameter for ad content/variant. Requires WooCommerce 8.5+ with Order Attribution enabled.<br /><br />**Field Name:** `attribution_utm_content`<br />**Type:** dimension                      |
| <div>UTM Term</div>                | UTM term parameter for search keywords. Requires WooCommerce 8.5+ with Order Attribution enabled.<br /><br />**Field Name:** `attribution_utm_term`<br />**Type:** dimension                               |
| <div>Attribution Source Type</div> | How the customer found your store: utm, organic, direct, referral, typein, admin, or mobile\_app. Requires WooCommerce 8.5+.<br /><br />**Field Name:** `attribution_source_type`<br />**Type:** dimension |
| <div>Attribution Referrer</div>    | Full referrer URL of where the customer came from. Requires WooCommerce 8.5+ with Order Attribution enabled.<br /><br />**Field Name:** `attribution_referrer`<br />**Type:** dimension                    |
| <div>Attribution Device Type</div> | Device type: Mobile, Tablet, Desktop, or Unknown. Requires WooCommerce 8.5+ with Order Attribution enabled.<br /><br />**Field Name:** `attribution_device_type`<br />**Type:** dimension                  |
| <div>Session Landing Page</div>    | The first page the customer landed on. Requires WooCommerce 8.5+ with Order Attribution enabled.<br /><br />**Field Name:** `attribution_session_entry`<br />**Type:** dimension                           |
| <div>Session Page Views</div>      | Number of pages viewed before purchase. Requires WooCommerce 8.5+ with Order Attribution enabled.<br /><br />**Field Name:** `attribution_session_pages`<br />**Type:** dimension                          |

### Line Item

|                                 |                                                                                                                                                                                                   |
| ------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| <div>Product ID</div>           | The ID of the product sold in the order line item. Requesting any Line Item field returns one row per product within each order.<br /><br />**Field Name:** `product_id`<br />**Type:** dimension |
| <div>Product Name</div>         | The name of the product sold in the order line item.<br /><br />**Field Name:** `product_name`<br />**Type:** dimension                                                                           |
| <div>Product SKU</div>          | The SKU of the product (or variation) sold in the order line item.<br /><br />**Field Name:** `line_item_sku`<br />**Type:** dimension                                                            |
| <div>Product Variation ID</div> | The variation ID of the product sold, empty for products without variations.<br /><br />**Field Name:** `product_variation_id`<br />**Type:** dimension                                           |
| <div>Product Categories</div>   | The product categories of the sold product, comma-separated. Empty for products deleted from the store.<br /><br />**Field Name:** `product_category`<br />**Type:** dimension                    |

## Metrics

Metrics are the numerical values you can measure and analyze from your WooCommerce campaigns.

### Store Sales Report

|                                    |                                                                             |
| ---------------------------------- | --------------------------------------------------------------------------- |
| <div>Gross Sales</div>             | <br /><br />**Field Name:** `gross_sales`<br />**Type:** metric             |
| <div>Net Sales</div>               | <br /><br />**Field Name:** `net_sales`<br />**Type:** metric               |
| <div>Total Sales</div>             | <br /><br />**Field Name:** `total_sales`<br />**Type:** metric             |
| <div>Taxes</div>                   | <br /><br />**Field Name:** `taxes`<br />**Type:** metric                   |
| <div>Coupons</div>                 | Total Discounts<br /><br />**Field Name:** `coupons`<br />**Type:** metric  |
| <div>Shipping</div>                | <br /><br />**Field Name:** `shipping`<br />**Type:** metric                |
| <div>Items Sold</div>              | <br /><br />**Field Name:** `items_sold`<br />**Type:** metric              |
| <div>Customers</div>               | <br /><br />**Field Name:** `customers`<br />**Type:** metric               |
| <div>Orders</div>                  | <br /><br />**Field Name:** `orders`<br />**Type:** metric                  |
| <div>Average Order Value</div>     | <br /><br />**Field Name:** `average_order_value`<br />**Type:** metric     |
| <div>Average Items Per Order</div> | <br /><br />**Field Name:** `average_items_per_order`<br />**Type:** metric |

### Orders

|                                 |                                                                          |
| ------------------------------- | ------------------------------------------------------------------------ |
| <div>Order Total</div>          | <br /><br />**Field Name:** `order_total`<br />**Type:** metric          |
| <div>Order Shipping Total</div> | <br /><br />**Field Name:** `order_shipping_total`<br />**Type:** metric |
| <div>Order Discount Total</div> | <br /><br />**Field Name:** `order_discount_total`<br />**Type:** metric |
| <div>Order Shipping Tax</div>   | <br /><br />**Field Name:** `order_shipping_tax`<br />**Type:** metric   |
| <div>Order Discount Tax</div>   | <br /><br />**Field Name:** `order_discount_tax`<br />**Type:** metric   |
| <div>Order Cart Tax</div>       | <br /><br />**Field Name:** `order_cart_tax`<br />**Type:** metric       |
| <div>Order Total Tax</div>      | <br /><br />**Field Name:** `order_total_tax`<br />**Type:** metric      |

### Line Item

|                          |                                                                                                                                                        |
| ------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------ |
| <div>Item Quantity</div> | Number of units of the product sold in the order line item.<br /><br />**Field Name:** `item_quantity`<br />**Type:** metric                           |
| <div>Item Price</div>    | Average unit price of the product (line subtotal divided by quantity), before discounts.<br /><br />**Field Name:** `item_price`<br />**Type:** metric |
| <div>Item Total</div>    | Line item revenue after discounts, excluding tax.<br /><br />**Field Name:** `item_total`<br />**Type:** metric                                        |
| <div>Item Subtotal</div> | Line item revenue before discounts, excluding tax.<br /><br />**Field Name:** `item_subtotal`<br />**Type:** metric                                    |
| <div>Item Tax</div>      | Tax charged on the order line item.<br /><br />**Field Name:** `item_tax`<br />**Type:** metric                                                        |
| <div>Item Discount</div> | Discount applied to the order line item (subtotal minus total).<br /><br />**Field Name:** `item_discount`<br />**Type:** metric                       |

***

## Related

<CardGroup>
  <Card title="Fields Catalog" icon="book" href="/fields-catalog">
    Browse all platforms
  </Card>

  <Card title="Shopify Fields" icon="chart-bar" href="/data-source/shopify/fields">
    Shopify metrics & dimensions
  </Card>

  <Card title="TiendaNube Fields" icon="chart-bar" href="/data-source/tiendanube/fields">
    TiendaNube metrics & dimensions
  </Card>

  <Card title="Stripe Fields" icon="chart-bar" href="/data-source/stripe/fields">
    Stripe metrics & dimensions
  </Card>
</CardGroup>


# X Ads Metrics & Dimensions
Source: https://support.detrics.io/data-source/x-ads/fields

Complete reference for X Ads dimensions and metrics

<Info>
  **Last updated:** August 6, 2026
</Info>

<div>
  <div>
    85 dimensions
  </div>

  <div>
    56 metrics
  </div>
</div>

This reference covers all available dimensions and metrics for X Ads data through Detrics. Use this guide to understand what data you can extract and how to structure your queries.

<div>
  <span>Supported destinations:</span>

  <div>
    Google Sheets
  </div>

  <div>
    Looker Studio
  </div>

  <div>
    Claude
  </div>

  <div>
    BigQuery
  </div>
</div>

## Dimensions

Dimensions are the attributes you can use to segment and group your X Ads data.

### Account

|                         |                                                                                                             |
| ----------------------- | ----------------------------------------------------------------------------------------------------------- |
| <div>Account ID</div>   | The identifier for the selected account/s.<br /><br />**Field Name:** `account.id`<br />**Type:** dimension |
| <div>Account Name</div> | The name of the selected account/s.<br /><br />**Field Name:** `account.name`<br />**Type:** dimension      |

### Campaign

|                                  |                                                                                                                                                          |
| -------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------- |
| <div>Campaign ID</div>           | Identifier for the campaign.<br /><br />**Field Name:** `campaign.id`<br />**Type:** dimension                                                           |
| <div>Campaign Name</div>         | Name of the campaign.<br /><br />**Field Name:** `campaign.name`<br />**Type:** dimension                                                                |
| <div>Frequency Cap</div>         | Frequency cap set for the campaign.<br /><br />**Field Name:** `campaign.frequency_cap`<br />**Type:** dimension                                         |
| <div>Funding Instrument ID</div> | Identifier for the funding instrument associated with the campaign.<br /><br />**Field Name:** `campaign.funding_instrument_id`<br />**Type:** dimension |
| <div>Currency</div>              | Currency used for the campaign, associated to it's funding instrument.<br /><br />**Field Name:** `campaign.currency`<br />**Type:** dimension           |
| <div>Created At</div>            | Timestamp when the campaign was created.<br /><br />**Field Name:** `campaign.updated_at`<br />**Type:** dimension                                       |
| <div>Updated At</div>            | Timestamp when the campaign was last updated.<br /><br />**Field Name:** `campaign.created_at`<br />**Type:** dimension                                  |

### Campaign Status

|                                 |                                                                                                                                    |
| ------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------- |
| <div>Servable</div>             | Indicates if the campaign is servable or not.<br /><br />**Field Name:** `campaign.servable`<br />**Type:** dimension              |
| <div>Effective Status</div>     | Effective status of the campaign.<br /><br />**Field Name:** `campaign.effective_status`<br />**Type:** dimension                  |
| <div>Entity Status</div>        | Status of the campaign entity.<br /><br />**Field Name:** `campaign.entity_status`<br />**Type:** dimension                        |
| <div>Reasons Not Servable</div> | Reasons why the campaign is not servable.<br /><br />**Field Name:** `campaign.reasons_not_servable`<br />**Type:** dimension      |
| <div>Duration (days)</div>      | Duration of the campaign in days.<br /><br />**Field Name:** `campaign.duration_in_days`<br />**Type:** dimension                  |
| <div>Standard Delivery</div>    | Indicates if the campaign uses standard delivery.<br /><br />**Field Name:** `campaign.standard_delivery`<br />**Type:** dimension |
| <div>Deleted</div>              | Indicates if the campaign is deleted.<br /><br />**Field Name:** `campaign.deleted`<br />**Type:** dimension                       |

### Campaign Budget

|                                |                                                                                                                                                                   |
| ------------------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| <div>Daily Budget</div>        | Daily budget amount in campaign's currency.<br /><br />**Field Name:** `campaign.daily_budget_amount_local_micro`<br />**Type:** dimension                        |
| <div>Total Budget</div>        | Total budget amount in campaign's currency..<br /><br />**Field Name:** `campaign.total_budget_amount_local_micro`<br />**Type:** dimension                       |
| <div>Budget Optimization</div> | Type of budget optimization configured for the campaign: CAMPAIGN, LINE\_ITEM.<br /><br />**Field Name:** `campaign.budget_optimization`<br />**Type:** dimension |

### Ad Group

|                                   |                                                                                                                                                      |
| --------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------- |
| <div>Ad Group ID</div>            | Unique identifier for the ad group (line item).<br /><br />**Field Name:** `line_item.id`<br />**Type:** dimension                                   |
| <div>Ad Group Name</div>          | Name of the ad group.<br /><br />**Field Name:** `line_item.name`<br />**Type:** dimension                                                           |
| <div>Campaign ID (Ad Group)</div> | The campaign ID this ad group belongs to.<br /><br />**Field Name:** `line_item.campaign_id`<br />**Type:** dimension                                |
| <div>Objective</div>              | The optimization objective for the ad group.<br /><br />**Field Name:** `line_item.objective`<br />**Type:** dimension                               |
| <div>Product Type</div>           | The product type of the ad group (PROMOTED\_TWEETS, etc.).<br /><br />**Field Name:** `line_item.product_type`<br />**Type:** dimension              |
| <div>Placements</div>             | Where ads will be shown (ALL\_ON\_TWITTER, TWITTER\_TIMELINE, etc.).<br /><br />**Field Name:** `line_item.placements`<br />**Type:** dimension      |
| <div>Goal</div>                   | The goal for the ad group optimization.<br /><br />**Field Name:** `line_item.goal`<br />**Type:** dimension                                         |
| <div>Currency</div>               | Currency used for the ad group.<br /><br />**Field Name:** `line_item.currency`<br />**Type:** dimension                                             |
| <div>Frequency Cap</div>          | Maximum impressions per user in the duration period.<br /><br />**Field Name:** `line_item.frequency_cap`<br />**Type:** dimension                   |
| <div>Frequency Cap Duration</div> | Duration in days for the frequency cap.<br /><br />**Field Name:** `line_item.duration_in_days`<br />**Type:** dimension                             |
| <div>Auto Tweet Promotion</div>   | Whether automatic tweet promotion is enabled.<br /><br />**Field Name:** `line_item.automatic_tweet_promotion`<br />**Type:** dimension              |
| <div>Advertiser Domain</div>      | The advertiser domain for the ad group.<br /><br />**Field Name:** `line_item.advertiser_domain`<br />**Type:** dimension                            |
| <div>Advertiser User ID</div>     | The advertiser user ID.<br /><br />**Field Name:** `line_item.advertiser_user_id`<br />**Type:** dimension                                           |
| <div>Ad Group Created At</div>    | When the ad group was created.<br /><br />**Field Name:** `line_item.created_at`<br />**Type:** dimension                                            |
| <div>Ad Group Updated At</div>    | When the ad group was last updated.<br /><br />**Field Name:** `line_item.updated_at`<br />**Type:** dimension                                       |
| <div>Funding Instrument ID</div>  | The funding instrument associated with the ad group.<br /><br />**Field Name:** `line_item.funding_instrument_id`<br />**Type:** dimension           |
| <div>Primary Web Event Tag</div>  | Primary web event tag for conversion tracking.<br /><br />**Field Name:** `line_item.primary_web_event_tag`<br />**Type:** dimension                 |
| <div>Android App Store ID</div>   | Android app store identifier for app install campaigns.<br /><br />**Field Name:** `line_item.android_app_store_identifier`<br />**Type:** dimension |
| <div>iOS App Store ID</div>       | iOS app store identifier for app install campaigns.<br /><br />**Field Name:** `line_item.ios_app_store_identifier`<br />**Type:** dimension         |
| <div>Categories</div>             | IAB categories for the ad group.<br /><br />**Field Name:** `line_item.categories`<br />**Type:** dimension                                          |
| <div>Creative Source</div>        | Source of creatives (MANUAL, AUTO, etc.).<br /><br />**Field Name:** `line_item.creative_source`<br />**Type:** dimension                            |

### Ad Group Status

|                                |                                                                                                                                     |
| ------------------------------ | ----------------------------------------------------------------------------------------------------------------------------------- |
| <div>Ad Group Status</div>     | Status of the ad group entity (ACTIVE, PAUSED, etc.).<br /><br />**Field Name:** `line_item.entity_status`<br />**Type:** dimension |
| <div>Standard Delivery</div>   | Whether standard delivery is enabled.<br /><br />**Field Name:** `line_item.standard_delivery`<br />**Type:** dimension             |
| <div>Ad Group Start Time</div> | When the ad group starts running.<br /><br />**Field Name:** `line_item.start_time`<br />**Type:** dimension                        |
| <div>Ad Group End Time</div>   | When the ad group stops running.<br /><br />**Field Name:** `line_item.end_time`<br />**Type:** dimension                           |
| <div>Ad Group Deleted</div>    | Whether the ad group is deleted.<br /><br />**Field Name:** `line_item.deleted`<br />**Type:** dimension                            |

### Ad Group Bidding

|                         |                                                                                                                                 |
| ----------------------- | ------------------------------------------------------------------------------------------------------------------------------- |
| <div>Bid Strategy</div> | The bidding strategy (AUTO, TARGET, MAX).<br /><br />**Field Name:** `line_item.bid_strategy`<br />**Type:** dimension          |
| <div>Bid Amount</div>   | The bid amount in the ad group currency.<br /><br />**Field Name:** `line_item.bid_amount_local_micro`<br />**Type:** dimension |
| <div>Target CPA</div>   | Target cost per action.<br /><br />**Field Name:** `line_item.target_cpa_local_micro`<br />**Type:** dimension                  |
| <div>Pay By</div>       | What you pay for (IMPRESSION, APP\_CLICK, etc.).<br /><br />**Field Name:** `line_item.pay_by`<br />**Type:** dimension         |

### Ad Group Budget

|                                  |                                                                                                                                       |
| -------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------- |
| <div>Ad Group Daily Budget</div> | Daily budget amount for the ad group.<br /><br />**Field Name:** `line_item.daily_budget_amount_local_micro`<br />**Type:** dimension |
| <div>Ad Group Total Budget</div> | Total budget amount for the ad group.<br /><br />**Field Name:** `line_item.total_budget_amount_local_micro`<br />**Type:** dimension |

### Promoted Tweet

|                                         |                                                                                                                                                  |
| --------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------ |
| <div>Promoted Tweet ID</div>            | Unique identifier for the promoted tweet.<br /><br />**Field Name:** `promoted_tweet.id`<br />**Type:** dimension                                |
| <div>Tweet ID</div>                     | The underlying tweet ID being promoted.<br /><br />**Field Name:** `promoted_tweet.tweet_id`<br />**Type:** dimension                            |
| <div>Ad Group ID (Promoted Tweet)</div> | The ad group this promoted tweet belongs to.<br /><br />**Field Name:** `promoted_tweet.line_item_id`<br />**Type:** dimension                   |
| <div>Promoted Tweet Status</div>        | Status of the promoted tweet (ACTIVE, PAUSED, etc.).<br /><br />**Field Name:** `promoted_tweet.entity_status`<br />**Type:** dimension          |
| <div>Approval Status</div>              | Approval status of the promoted tweet (ACCEPTED, REJECTED).<br /><br />**Field Name:** `promoted_tweet.approval_status`<br />**Type:** dimension |
| <div>Promoted Tweet Created At</div>    | When the promoted tweet was created.<br /><br />**Field Name:** `promoted_tweet.created_at`<br />**Type:** dimension                             |
| <div>Promoted Tweet Updated At</div>    | When the promoted tweet was last updated.<br /><br />**Field Name:** `promoted_tweet.updated_at`<br />**Type:** dimension                        |
| <div>Promoted Tweet Deleted</div>       | Whether the promoted tweet is deleted.<br /><br />**Field Name:** `promoted_tweet.deleted`<br />**Type:** dimension                              |

### Tweet Content

|                    |                                                                                                                                                           |
| ------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------- |
| <div>Ad Name</div> | Name given to the ad/tweet when created (max 80 characters). Useful for identifying ads.<br /><br />**Field Name:** `tweet.name`<br />**Type:** dimension |

### Creative

|                                     |                                                                                                                                  |
| ----------------------------------- | -------------------------------------------------------------------------------------------------------------------------------- |
| <div>Promoted Tweet Card ID</div>   | Unique identifier for the card creative.<br /><br />**Field Name:** `card.id`<br />**Type:** dimension                           |
| <div>Promoted Tweet Card Name</div> | Name of the card creative.<br /><br />**Field Name:** `card.name`<br />**Type:** dimension                                       |
| <div>Promoted Tweet Card URI</div>  | Internal URI reference for the card.<br /><br />**Field Name:** `card.uri`<br />**Type:** dimension                              |
| <div>Promoted Tweet Card Type</div> | Type of card (e.g., IMAGE\_WEBSITE, VIDEO\_WEBSITE, IMAGE\_APP).<br /><br />**Field Name:** `card.type`<br />**Type:** dimension |

### Creative Media

|                                             |                                                                                                                       |
| ------------------------------------------- | --------------------------------------------------------------------------------------------------------------------- |
| <div>Promoted Tweet Card Image URL</div>    | URL of the image or video thumbnail in the card.<br /><br />**Field Name:** `card.media_url`<br />**Type:** dimension |
| <div>Promoted Tweet Card Media Type</div>   | Type of media in the card (image or video).<br /><br />**Field Name:** `card.media_type`<br />**Type:** dimension     |
| <div>Promoted Tweet Card Media Width</div>  | Width of the card media in pixels.<br /><br />**Field Name:** `card.media_width`<br />**Type:** dimension             |
| <div>Promoted Tweet Card Media Height</div> | Height of the card media in pixels.<br /><br />**Field Name:** `card.media_height`<br />**Type:** dimension           |

### Creative Video

|                                                   |                                                                                                                                |
| ------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------ |
| <div>Promoted Tweet Card Video Poster URL</div>   | Poster/thumbnail image URL for video cards.<br /><br />**Field Name:** `card.video_poster_url`<br />**Type:** dimension        |
| <div>Promoted Tweet Card Video Duration</div>     | Duration of the video in milliseconds.<br /><br />**Field Name:** `card.video_duration`<br />**Type:** dimension               |
| <div>Promoted Tweet Card Video Aspect Ratio</div> | Aspect ratio of the video (e.g., "16:9", "1:1").<br /><br />**Field Name:** `card.video_aspect_ratio`<br />**Type:** dimension |

### Creative Carousel

|                                                     |                                                                                                                   |
| --------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------- |
| <div>Promoted Tweet Card Carousel Image 1 URL</div> | URL of the first carousel image.<br /><br />**Field Name:** `card.carousel_image_1_url`<br />**Type:** dimension  |
| <div>Promoted Tweet Card Carousel Image 2 URL</div> | URL of the second carousel image.<br /><br />**Field Name:** `card.carousel_image_2_url`<br />**Type:** dimension |
| <div>Promoted Tweet Card Carousel Image 3 URL</div> | URL of the third carousel image.<br /><br />**Field Name:** `card.carousel_image_3_url`<br />**Type:** dimension  |
| <div>Promoted Tweet Card Carousel Image 4 URL</div> | URL of the fourth carousel image.<br /><br />**Field Name:** `card.carousel_image_4_url`<br />**Type:** dimension |
| <div>Promoted Tweet Card Carousel Image 5 URL</div> | URL of the fifth carousel image.<br /><br />**Field Name:** `card.carousel_image_5_url`<br />**Type:** dimension  |

### Creative Destination

|                                                 |                                                                                                                   |
| ----------------------------------------------- | ----------------------------------------------------------------------------------------------------------------- |
| <div>Promoted Tweet Card Destination Type</div> | Type of destination (WEBSITE or APP).<br /><br />**Field Name:** `card.destination_type`<br />**Type:** dimension |
| <div>Promoted Tweet Card Destination URL</div>  | Full destination URL or app deep link.<br /><br />**Field Name:** `card.destination_url`<br />**Type:** dimension |
| <div>Promoted Tweet Card Display URL</div>      | Shortened display URL (hostname only).<br /><br />**Field Name:** `card.display_url`<br />**Type:** dimension     |

### Creative App

|                                                 |                                                                                                                     |
| ----------------------------------------------- | ------------------------------------------------------------------------------------------------------------------- |
| <div>Promoted Tweet Card App Store ID</div>     | App store identifier for app install cards.<br /><br />**Field Name:** `card.app_store_id`<br />**Type:** dimension |
| <div>Promoted Tweet Card App Country Code</div> | Country code for the app store.<br /><br />**Field Name:** `card.app_country_code`<br />**Type:** dimension         |

### Creative Details

|                                             |                                                                                                                 |
| ------------------------------------------- | --------------------------------------------------------------------------------------------------------------- |
| <div>Promoted Tweet Card Button Label</div> | Call-to-action button text on the card.<br /><br />**Field Name:** `card.button_label`<br />**Type:** dimension |
| <div>Promoted Tweet Card Title</div>        | Title/headline of the card.<br /><br />**Field Name:** `card.title`<br />**Type:** dimension                    |
| <div>Promoted Tweet Card Created At</div>   | When the card was created.<br /><br />**Field Name:** `card.created_at`<br />**Type:** dimension                |
| <div>Promoted Tweet Card Updated At</div>   | When the card was last updated.<br /><br />**Field Name:** `card.updated_at`<br />**Type:** dimension           |

## Metrics

Metrics are the numerical values you can measure and analyze from your X Ads campaigns.

### Most Used

|                                 |                                                                                                                                                                           |
| ------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| <div>Spend</div>                | Total spend in the campaign's currency.<br /><br />**Field Name:** `billed_charge_local_micro`<br />**Type:** metric                                                      |
| <div>Impressions</div>          | Number of times the ad was shown to users (promoted impressions only).<br /><br />**Field Name:** `impressions`<br />**Type:** metric                                     |
| <div>Clicks</div>               | Clicks on the ad, including favorites and other engagements (promoted only).<br /><br />**Field Name:** `clicks`<br />**Type:** metric                                    |
| <div>Url Clicks</div>           | Clicks on the link or Website Card in the ad (promoted only, including earned).<br /><br />**Field Name:** `url_clicks`<br />**Type:** metric                             |
| <div>App Clicks</div>           | App install or app open attempts from the ad (promoted only).<br /><br />**Field Name:** `app_clicks`<br />**Type:** metric                                               |
| <div>Total Audience Reach</div> | Unique users reached by the ad campaign (promoted only). Requires a campaign-level dimension.<br /><br />**Field Name:** `total_audience_reach`<br />**Type:** metric     |
| <div>Average Frequency</div>    | Average times a user saw ads from the campaign (promoted only). Requires a campaign-level dimension.<br /><br />**Field Name:** `average_frequency`<br />**Type:** metric |

### Engagement

|                        |                                                                                                                                                                    |
| ---------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| <div>Likes</div>       | Likes attributed to the ad campaign (promoted only).<br /><br />**Field Name:** `likes`<br />**Type:** metric                                                      |
| <div>Retweets</div>    | Retweets attributed to the ad campaign (promoted only).<br /><br />**Field Name:** `retweets`<br />**Type:** metric                                                |
| <div>Follows</div>     | Follows attributed to the ad campaign (promoted only).<br /><br />**Field Name:** `follows`<br />**Type:** metric                                                  |
| <div>Unfollows</div>   | Unfollows attributed to the ad campaign (promoted only).<br /><br />**Field Name:** `unfollows`<br />**Type:** metric                                              |
| <div>Engagements</div> | Total engagements (likes, retweets, replies, clicks) attributed to the ad campaign (promoted only).<br /><br />**Field Name:** `engagements`<br />**Type:** metric |
| <div>Tweets send</div> | Tweets sent attributed to the ad campaign (promoted only).<br /><br />**Field Name:** `tweets_send`<br />**Type:** metric                                          |
| <div>Replies</div>     | Replies attributed to the ad campaign (promoted only).<br /><br />**Field Name:** `replies`<br />**Type:** metric                                                  |

### Cards and Carousels

|                             |                                                                                                                                              |
| --------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------- |
| <div>Card Engagements</div> | Card engagements attributed to the ad campaign (promoted only).<br /><br />**Field Name:** `card_engagements`<br />**Type:** metric          |
| <div>Poll Card Vote</div>   | Poll Card votes attributed to the ad campaign (promoted only).<br /><br />**Field Name:** `poll_card_vote`<br />**Type:** metric             |
| <div>Carousel Swipes</div>  | Swipes on Carousel images or videos attributed to the ad (promoted only).<br /><br />**Field Name:** `carousel_swipes`<br />**Type:** metric |

### Video

|                                 |                                                                                                                                                     |
| ------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------- |
| <div>Video Views</div>          | Views where at least 3 seconds were played while 100% in view (promoted only).<br /><br />**Field Name:** `video_total_views`<br />**Type:** metric |
| <div>Video Content Starts</div> | Times video content started playing (promoted only).<br /><br />**Field Name:** `video_content_starts`<br />**Type:** metric                        |
| <div>Video Views (25%)</div>    | Views where at least 25% of the video was viewed (promoted only).<br /><br />**Field Name:** `video_views_25`<br />**Type:** metric                 |
| <div>Video Views (50%)</div>    | Views where at least 50% of the video was viewed (promoted only).<br /><br />**Field Name:** `video_views_50`<br />**Type:** metric                 |
| <div>Video Views (75%)</div>    | Views where at least 75% of the video was viewed (promoted only).<br /><br />**Field Name:** `video_views_75`<br />**Type:** metric                 |
| <div>Video Views (100%)</div>   | Views where 100% of the video was viewed (promoted only).<br /><br />**Field Name:** `video_views_100`<br />**Type:** metric                        |
| <div>Video CTA Clicks</div>     | Clicks on the call-to-action button in a video ad (promoted only).<br /><br />**Field Name:** `video_cta_clicks`<br />**Type:** metric              |
| <div>Video 6s Views</div>       | Views where at least 6 seconds of the video was viewed (promoted only).<br /><br />**Field Name:** `video_6s_views`<br />**Type:** metric           |
| <div>Video 15s Views</div>      | Views where at least 15 seconds or 95% of the video was viewed (promoted only).<br /><br />**Field Name:** `video_15s_views`<br />**Type:** metric  |

### Media

|                              |                                                                                                                                |
| ---------------------------- | ------------------------------------------------------------------------------------------------------------------------------ |
| <div>Media Views</div>       | Views on media content from the ad (promoted only).<br /><br />**Field Name:** `media_views`<br />**Type:** metric             |
| <div>Media Engagements</div> | Engagements on media content from the ad (promoted only).<br /><br />**Field Name:** `media_engagements`<br />**Type:** metric |

### Mobile Conversions

|                                                     |                                                                                                                                                           |
| --------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------- |
| <div>Mobile Conversion Purchases</div>              | Total number of mobile app purchase conversions.<br /><br />**Field Name:** `mobile_conversion_purchases`<br />**Type:** metric                           |
| <div>Mobile Conversion Spent Credits</div>          | Total number of mobile app spent credits conversions.<br /><br />**Field Name:** `mobile_conversion_spent_credits`<br />**Type:** metric                  |
| <div>Mobile Conversion Installs</div>               | Total number of mobile app install conversions.<br /><br />**Field Name:** `mobile_conversion_installs`<br />**Type:** metric                             |
| <div>Mobile Conversion Content Views</div>          | Total number of mobile app content view conversions.<br /><br />**Field Name:** `mobile_conversion_content_views`<br />**Type:** metric                   |
| <div>Mobile Conversion Add to Wishlists</div>       | Total number of mobile app add to wishlist conversions.<br /><br />**Field Name:** `mobile_conversion_add_to_wishlists`<br />**Type:** metric             |
| <div>Mobile Conversion Checkouts Initiated</div>    | Total number of mobile app checkout initiated conversions.<br /><br />**Field Name:** `mobile_conversion_checkouts_initiated`<br />**Type:** metric       |
| <div>Mobile Conversion Reservations</div>           | Total number of mobile app reservation conversions.<br /><br />**Field Name:** `mobile_conversion_reservations`<br />**Type:** metric                     |
| <div>Mobile Conversion Tutorials Completed</div>    | Total number of mobile app tutorial completed conversions.<br /><br />**Field Name:** `mobile_conversion_tutorials_completed`<br />**Type:** metric       |
| <div>Mobile Conversion Achievements Unlocked</div>  | Total number of mobile app achievement unlocked conversions.<br /><br />**Field Name:** `mobile_conversion_achievements_unlocked`<br />**Type:** metric   |
| <div>Mobile Conversion Searches</div>               | Total number of mobile app search conversions.<br /><br />**Field Name:** `mobile_conversion_searches`<br />**Type:** metric                              |
| <div>Mobile Conversion Add to Carts</div>           | Total number of mobile app add to cart conversions.<br /><br />**Field Name:** `mobile_conversion_add_to_carts`<br />**Type:** metric                     |
| <div>Mobile Conversion Payment Info Additions</div> | Total number of mobile app payment info addition conversions.<br /><br />**Field Name:** `mobile_conversion_payment_info_additions`<br />**Type:** metric |
| <div>Mobile Conversion Re-engages</div>             | Total number of mobile app re-engagement conversions.<br /><br />**Field Name:** `mobile_conversion_re_engages`<br />**Type:** metric                     |
| <div>Mobile Conversion Shares</div>                 | Total number of mobile app share conversions.<br /><br />**Field Name:** `mobile_conversion_shares`<br />**Type:** metric                                 |
| <div>Mobile Conversion Rates</div>                  | Total number of mobile app rate conversions.<br /><br />**Field Name:** `mobile_conversion_rates`<br />**Type:** metric                                   |
| <div>Mobile Conversion Logins</div>                 | Total number of mobile app login conversions.<br /><br />**Field Name:** `mobile_conversion_logins`<br />**Type:** metric                                 |
| <div>Mobile Conversion Updates</div>                | Total number of mobile app update conversions.<br /><br />**Field Name:** `mobile_conversion_updates`<br />**Type:** metric                               |
| <div>Mobile Conversion Levels Achieved</div>        | Total number of mobile app level achieved conversions.<br /><br />**Field Name:** `mobile_conversion_levels_achieved`<br />**Type:** metric               |
| <div>Mobile Conversion Invites</div>                | Total number of mobile app invite conversions.<br /><br />**Field Name:** `mobile_conversion_invites`<br />**Type:** metric                               |
| <div>Mobile Conversion Key Page Views</div>         | Total number of mobile app key page view conversions.<br /><br />**Field Name:** `mobile_conversion_key_page_views`<br />**Type:** metric                 |
| <div>Mobile Conversion Downloads</div>              | Total number of mobile app download conversions.<br /><br />**Field Name:** `mobile_conversion_downloads`<br />**Type:** metric                           |
| <div>Mobile Conversion Sign Ups</div>               | Total number of mobile app sign up conversions.<br /><br />**Field Name:** `mobile_conversion_sign_ups`<br />**Type:** metric                             |
| <div>Mobile Conversion Site Visits</div>            | Total number of mobile app site visit conversions.<br /><br />**Field Name:** `mobile_conversion_site_visits`<br />**Type:** metric                       |

### Web Conversions

|                                       |                                                                                                                       |
| ------------------------------------- | --------------------------------------------------------------------------------------------------------------------- |
| <div>Web Conversion Purchases</div>   | Total number of web purchase conversions.<br /><br />**Field Name:** `conversion_purchases`<br />**Type:** metric     |
| <div>Web Conversion Sign Ups</div>    | Total number of web sign up conversions.<br /><br />**Field Name:** `conversion_sign_ups`<br />**Type:** metric       |
| <div>Web Conversion Site Visits</div> | Total number of web site visit conversions.<br /><br />**Field Name:** `conversion_site_visits`<br />**Type:** metric |
| <div>Web Conversion Downloads</div>   | Total number of web download conversions.<br /><br />**Field Name:** `conversion_downloads`<br />**Type:** metric     |
| <div>Web Conversion Custom</div>      | Total number of web custom conversions.<br /><br />**Field Name:** `conversion_custom`<br />**Type:** metric          |

***

## Related

<CardGroup>
  <Card title="Fields Catalog" icon="book" href="/fields-catalog">
    Browse all platforms
  </Card>

  <Card title="Meta Ads Fields" icon="chart-bar" href="/data-source/facebook-ads/fields">
    Meta Ads metrics & dimensions
  </Card>

  <Card title="Google Ads Fields" icon="chart-bar" href="/data-source/google-ads/fields">
    Google Ads metrics & dimensions
  </Card>

  <Card title="TikTok Ads Fields" icon="chart-bar" href="/data-source/tiktok-ads/fields">
    TikTok Ads metrics & dimensions
  </Card>
</CardGroup>


# YouTube Analytics Metrics & Dimensions
Source: https://support.detrics.io/data-source/youtube-analytics/fields

Complete reference for YouTube Analytics dimensions and metrics

<Info>
  **Last updated:** August 6, 2026
</Info>

<div>
  <div>
    37 dimensions
  </div>

  <div>
    41 metrics
  </div>
</div>

This reference covers all available dimensions and metrics for YouTube Analytics data through Detrics. Use this guide to understand what data you can extract and how to structure your queries.

<div>
  <span>Supported destinations:</span>

  <div>
    Google Sheets
  </div>

  <div>
    Claude
  </div>

  <div>
    BigQuery
  </div>
</div>

## Dimensions

Dimensions are the attributes you can use to segment and group your YouTube Analytics data.

### Channel

|                                       |                                                                                                                                 |
| ------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------- |
| <div>Channel ID</div>                 | The unique ID of the YouTube channel<br /><br />**Field Name:** `channelId`<br />**Type:** dimension                            |
| <div>Channel Name</div>               | The name of the YouTube channel<br /><br />**Field Name:** `channelTitle`<br />**Type:** dimension                              |
| <div>Channel URL</div>                | The URL of the YouTube channel<br /><br />**Field Name:** `channelUrl`<br />**Type:** dimension                                 |
| <div>Channel Description</div>        | The description of the YouTube channel<br /><br />**Field Name:** `channelDescription`<br />**Type:** dimension                 |
| <div>Channel Custom URL</div>         | The custom URL of the YouTube channel<br /><br />**Field Name:** `channelCustomUrl`<br />**Type:** dimension                    |
| <div>Channel Created Date</div>       | The date the channel was created<br /><br />**Field Name:** `channelPublishedAt`<br />**Type:** dimension                       |
| <div>Channel Thumbnail URL</div>      | The URL of the channel thumbnail<br /><br />**Field Name:** `channelThumbnailUrl`<br />**Type:** dimension                      |
| <div>Channel Country</div>            | The country associated with the channel<br /><br />**Field Name:** `channelCountry`<br />**Type:** dimension                    |
| <div>Channel Hidden Subscribers</div> | Whether the subscriber count is publicly visible<br /><br />**Field Name:** `channelHiddenSubscribers`<br />**Type:** dimension |

### Video

|                                        |                                                                                                                                                |
| -------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------- |
| <div>Video ID</div>                    | The unique ID of the video<br /><br />**Field Name:** `videoId`<br />**Type:** dimension                                                       |
| <div>Video Title</div>                 | The title of the video<br /><br />**Field Name:** `videoTitle`<br />**Type:** dimension                                                        |
| <div>Video URL</div>                   | The URL of the video<br /><br />**Field Name:** `videoUrl`<br />**Type:** dimension                                                            |
| <div>Video Thumbnail URL</div>         | The URL of the video thumbnail<br /><br />**Field Name:** `videoThumbnailUrl`<br />**Type:** dimension                                         |
| <div>Video Visibility Status</div>     | The visibility status of the video (public, private, unlisted)<br /><br />**Field Name:** `videoPrivacyStatus`<br />**Type:** dimension        |
| <div>Video Upload Status</div>         | The upload status of the video<br /><br />**Field Name:** `videoUploadStatus`<br />**Type:** dimension                                         |
| <div>Video Failure Reason</div>        | The reason a video failed to upload<br /><br />**Field Name:** `videoFailureReason`<br />**Type:** dimension                                   |
| <div>Video Rejection Reason</div>      | The reason a video was rejected<br /><br />**Field Name:** `videoRejectionReason`<br />**Type:** dimension                                     |
| <div>Video Length</div>                | The duration of the video<br /><br />**Field Name:** `videoLength`<br />**Type:** dimension                                                    |
| <div>Video Embeddability</div>         | Whether the video can be embedded on other sites<br /><br />**Field Name:** `videoEmbeddable`<br />**Type:** dimension                         |
| <div>Video Public Stats Viewable</div> | Whether extended video statistics are publicly viewable<br /><br />**Field Name:** `videoPublicStatsViewable`<br />**Type:** dimension         |
| <div>Video Made For Kids</div>         | Whether the video is designated as child-directed<br /><br />**Field Name:** `videoMadeForKids`<br />**Type:** dimension                       |
| <div>Published Date</div>              | The date the video was published<br /><br />**Field Name:** `videoPublishedDate`<br />**Type:** dimension                                      |
| <div>Video Description</div>           | The description of the video<br /><br />**Field Name:** `videoDescription`<br />**Type:** dimension                                            |
| <div>Video Tags</div>                  | Keyword tags associated with the video<br /><br />**Field Name:** `videoTags`<br />**Type:** dimension                                         |
| <div>Live Broadcast Content</div>      | Whether the video has live broadcast content (upcoming, live, none)<br /><br />**Field Name:** `liveBroadcastContent`<br />**Type:** dimension |

### Breakdown

|                                 |                                                                                                                                    |
| ------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------- |
| <div>Creator Content Type</div> | The type of content: shorts, videoOnDemand, or liveStream<br /><br />**Field Name:** `creatorContentType`<br />**Type:** dimension |
| <div>Live Or On-Demand</div>    | Whether views are from live broadcast or on-demand playback<br /><br />**Field Name:** `liveOrOnDemand`<br />**Type:** dimension   |

### Demographics

|                      |                                                                                                   |
| -------------------- | ------------------------------------------------------------------------------------------------- |
| <div>Age Group</div> | The age group of logged-in viewers<br /><br />**Field Name:** `ageGroup`<br />**Type:** dimension |
| <div>Gender</div>    | The gender of logged-in viewers<br /><br />**Field Name:** `gender`<br />**Type:** dimension      |

### Device

|                             |                                                                                                                                      |
| --------------------------- | ------------------------------------------------------------------------------------------------------------------------------------ |
| <div>Device Type</div>      | The device type (mobile, desktop, tablet, TV)<br /><br />**Field Name:** `deviceType`<br />**Type:** dimension                       |
| <div>Operating System</div> | The operating system of the viewer device<br /><br />**Field Name:** `operatingSystem`<br />**Type:** dimension                      |
| <div>YouTube Product</div>  | The YouTube service where activity occurred (Core, Music, etc.)<br /><br />**Field Name:** `youtubeProduct`<br />**Type:** dimension |

### Traffic

|                                |                                                                                                                                                  |
| ------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------ |
| <div>Traffic Source Type</div> | How viewers reached the video (search, suggested, external, etc.)<br /><br />**Field Name:** `insightTrafficSourceType`<br />**Type:** dimension |

### Geography

|                     |                                                                                                                   |
| ------------------- | ----------------------------------------------------------------------------------------------------------------- |
| <div>Country</div>  | The country associated with the report metrics<br /><br />**Field Name:** `country`<br />**Type:** dimension      |
| <div>US State</div> | The US state (only available when filtering by US)<br /><br />**Field Name:** `province`<br />**Type:** dimension |

### Monetization

|                    |                                                                                                            |
| ------------------ | ---------------------------------------------------------------------------------------------------------- |
| <div>Ad Type</div> | The type of ad that ran during video playback<br /><br />**Field Name:** `adType`<br />**Type:** dimension |

### Audience Retention

|                                     |                                                                                                                                   |
| ----------------------------------- | --------------------------------------------------------------------------------------------------------------------------------- |
| <div>Elapsed Video Time Ratio</div> | The ratio of elapsed video time to total video length<br /><br />**Field Name:** `elapsedVideoTimeRatio`<br />**Type:** dimension |

## Metrics

Metrics are the numerical values you can measure and analyze from your YouTube Analytics campaigns.

### Engagement

|                                             |                                                                                                                              |
| ------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------- |
| <div>Video Views</div>                      | The number of times videos were viewed<br /><br />**Field Name:** `views`<br />**Type:** metric                              |
| <div>Engaged Views</div>                    | Views of at least 4 seconds<br /><br />**Field Name:** `engagedViews`<br />**Type:** metric                                  |
| <div>Estimated Minutes Watched</div>        | Total minutes users watched videos<br /><br />**Field Name:** `estimatedMinutesWatched`<br />**Type:** metric                |
| <div>Average View Duration (Sec)</div>      | Average video playback length in seconds<br /><br />**Field Name:** `averageViewDurationSeconds`<br />**Type:** metric       |
| <div>Average View Duration (Min)</div>      | Average video playback length in minutes<br /><br />**Field Name:** `averageViewDurationMinutes`<br />**Type:** metric       |
| <div>Average View Duration Percentage</div> | Average percentage of video watched<br /><br />**Field Name:** `averageViewPercentage`<br />**Type:** metric                 |
| <div>Likes</div>                            | Number of likes on videos<br /><br />**Field Name:** `likes`<br />**Type:** metric                                           |
| <div>Dislikes</div>                         | Number of dislikes on videos<br /><br />**Field Name:** `dislikes`<br />**Type:** metric                                     |
| <div>Comments</div>                         | Number of comments on videos<br /><br />**Field Name:** `comments`<br />**Type:** metric                                     |
| <div>Shares</div>                           | Number of times videos were shared<br /><br />**Field Name:** `shares`<br />**Type:** metric                                 |
| <div>Gained Subscribers</div>               | Number of new subscribers gained<br /><br />**Field Name:** `subscribersGained`<br />**Type:** metric                        |
| <div>Lost Subscribers</div>                 | Number of subscribers lost<br /><br />**Field Name:** `subscribersLost`<br />**Type:** metric                                |
| <div>Videos Added To Playlist</div>         | Times videos were added to playlists<br /><br />**Field Name:** `videosAddedToPlaylists`<br />**Type:** metric               |
| <div>Videos Removed From Playlist</div>     | Times videos were removed from playlists<br /><br />**Field Name:** `videosRemovedFromPlaylists`<br />**Type:** metric       |
| <div>Viewer Percentage</div>                | Percentage of logged-in viewers (only with demographics)<br /><br />**Field Name:** `viewerPercentage`<br />**Type:** metric |

### Channel Totals

|                                      |                                                                                                                 |
| ------------------------------------ | --------------------------------------------------------------------------------------------------------------- |
| <div>Channel Total Page Views</div>  | Total channel views (all time)<br /><br />**Field Name:** `channelTotalViews`<br />**Type:** metric             |
| <div>Channel Total Subscribers</div> | Total channel subscribers (all time)<br /><br />**Field Name:** `channelTotalSubscribers`<br />**Type:** metric |
| <div>Channel Total Video Count</div> | Total public videos on the channel<br /><br />**Field Name:** `channelTotalVideos`<br />**Type:** metric        |

### Cards

|                                    |                                                                                                                  |
| ---------------------------------- | ---------------------------------------------------------------------------------------------------------------- |
| <div>Card Impressions</div>        | Number of times cards were displayed<br /><br />**Field Name:** `cardImpressions`<br />**Type:** metric          |
| <div>Card Clicks</div>             | Number of times cards were clicked<br /><br />**Field Name:** `cardClicks`<br />**Type:** metric                 |
| <div>Card Click Rate</div>         | Click-through rate for cards<br /><br />**Field Name:** `cardClickRate`<br />**Type:** metric                    |
| <div>Card Teaser Impressions</div> | Number of times card teasers were shown<br /><br />**Field Name:** `cardTeaserImpressions`<br />**Type:** metric |
| <div>Card Teaser Clicks</div>      | Number of clicks on card teasers<br /><br />**Field Name:** `cardTeaserClicks`<br />**Type:** metric             |
| <div>Card Teaser Click Rate</div>  | Click-through rate for card teasers<br /><br />**Field Name:** `cardTeaserClickRate`<br />**Type:** metric       |

### Annotations

|                                             |                                                                                                                    |
| ------------------------------------------- | ------------------------------------------------------------------------------------------------------------------ |
| <div>Annotation Impressions</div>           | Total annotation impressions<br /><br />**Field Name:** `annotationImpressions`<br />**Type:** metric              |
| <div>Annotation Clickable Impressions</div> | Clickable annotation impressions<br /><br />**Field Name:** `annotationClickableImpressions`<br />**Type:** metric |
| <div>Annotation Closable Impressions</div>  | Closable annotation impressions<br /><br />**Field Name:** `annotationClosableImpressions`<br />**Type:** metric   |
| <div>Annotation Clicks</div>                | Number of annotation clicks<br /><br />**Field Name:** `annotationClicks`<br />**Type:** metric                    |
| <div>Annotation Closes</div>                | Number of annotation closes<br /><br />**Field Name:** `annotationCloses`<br />**Type:** metric                    |
| <div>Annotation Click Through Rate</div>    | Annotation click-through rate<br /><br />**Field Name:** `annotationClickThroughRate`<br />**Type:** metric        |
| <div>Annotation Close Rate</div>            | Annotation close rate<br /><br />**Field Name:** `annotationCloseRate`<br />**Type:** metric                       |

### Monetization

|                                                      |                                                                                                                                        |
| ---------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------- |
| <div>Estimated Revenue</div>                         | Estimated net revenue from advertising and non-advertising sources<br /><br />**Field Name:** `estimatedRevenue`<br />**Type:** metric |
| <div>Gross Revenue (USD)</div>                       | Estimated gross revenue from Google-sold advertising<br /><br />**Field Name:** `grossRevenue`<br />**Type:** metric                   |
| <div>Ad Impressions</div>                            | Number of verified ad impressions served<br /><br />**Field Name:** `adImpressions`<br />**Type:** metric                              |
| <div>CPM</div>                                       | Estimated gross revenue per thousand ad impressions<br /><br />**Field Name:** `cpm`<br />**Type:** metric                             |
| <div>Monetized Playbacks</div>                       | Playbacks where at least one ad impression was shown<br /><br />**Field Name:** `monetizedPlaybacks`<br />**Type:** metric             |
| <div>Playback Based CPM</div>                        | Estimated gross revenue per thousand playbacks<br /><br />**Field Name:** `playbackBasedCpm`<br />**Type:** metric                     |
| <div>Estimated YouTube Premium Minutes Watched</div> | Minutes watched by YouTube Premium members<br /><br />**Field Name:** `estimatedRedMinutesWatched`<br />**Type:** metric               |
| <div>YouTube Premium Views</div>                     | Views by YouTube Premium members<br /><br />**Field Name:** `redViews`<br />**Type:** metric                                           |

### Audience Retention

|                                           |                                                                                                                             |
| ----------------------------------------- | --------------------------------------------------------------------------------------------------------------------------- |
| <div>Audience Watch Ratio</div>           | Absolute ratio of viewers watching at given point<br /><br />**Field Name:** `audienceWatchRatio`<br />**Type:** metric     |
| <div>Relative Retention Performance</div> | Retention compared to similar length videos<br /><br />**Field Name:** `relativeRetentionPerformance`<br />**Type:** metric |

***

## Related

<CardGroup>
  <Card title="Fields Catalog" icon="book" href="/fields-catalog">
    Browse all platforms
  </Card>

  <Card title="Google Analytics 4 Fields" icon="chart-bar" href="/data-source/google-analytics-4/fields">
    Google Analytics 4 metrics & dimensions
  </Card>

  <Card title="Google Ads Fields" icon="chart-bar" href="/data-source/google-ads/fields">
    Google Ads metrics & dimensions
  </Card>

  <Card title="TikTok Organic Fields" icon="chart-bar" href="/data-source/tiktok-organic/fields">
    TikTok Organic metrics & dimensions
  </Card>
</CardGroup>


# Fields Catalog
Source: https://support.detrics.io/fields-catalog/index

Browse all available metrics and dimensions for each platform

<Info>**Last updated:** August 7, 2026</Info>

Every data source in Detrics exposes a set of **fields** you can use in your queries. Fields come in two types:

* **Metrics** are the numbers you measure, impressions, clicks, spend, revenue, conversions, and so on.
* **Dimensions** are the categories you group by, campaign name, date, country, device, ad creative, and so on.

Use this catalog to find the exact fields available for each platform. Every field page lists the field name, type, and a short description so you know what to expect in your data.

These same fields are available across all Detrics destinations: Google Sheets, Looker Studio, BigQuery Data Warehouse, and the MCP integration for AI tools.

***

## Advertising

<CardGroup>
  <Card title="Meta Ads" icon="https://storage.googleapis.com/detrics-static/public/img/facebook-ads-logo.png" href="/data-source/facebook-ads/fields">
    Campaigns, ad sets, ads, and creative performance
  </Card>

  <Card title="Google Ads" icon="https://storage.googleapis.com/detrics-static/public/img/google-ads-logo.png" href="/data-source/google-ads/fields">
    Search, display, video, shopping, and Performance Max campaigns
  </Card>

  <Card title="TikTok Ads" icon="https://storage.googleapis.com/detrics-static/public/img/tiktok-logo.png" href="/data-source/tiktok-ads/fields">
    In-feed ads, spark ads, and auction campaigns
  </Card>

  <Card title="LinkedIn Ads" icon="https://storage.googleapis.com/detrics-static/public/img/linkedin-ads-logo.png" href="/data-source/linkedin-ads/fields">
    Sponsored content, message ads, and lead gen forms
  </Card>

  <Card title="Bing Ads" icon="https://storage.googleapis.com/detrics-static/public/img/bing-logo.png" href="/data-source/bing-ads/fields">
    Microsoft Advertising search and audience campaigns
  </Card>

  <Card title="X Ads" icon="https://storage.googleapis.com/detrics-static/public/img/x-ads-logo.png" href="/data-source/x-ads/fields">
    Promoted tweets, followers, and video campaigns
  </Card>

  <Card title="Pinterest Ads" icon="https://storage.googleapis.com/detrics-static/public/img/pinterest-logo.png" href="/data-source/pinterest-ads/fields">
    Promoted pins, shopping ads, and awareness campaigns
  </Card>

  <Card title="Google DV360" icon="https://storage.googleapis.com/detrics-static/public/img/google-dv-360-logo.png" href="/data-source/google-dv360/fields">
    Display & Video 360 programmatic campaigns
  </Card>

  <Card title="Mercado Ads" icon="https://storage.googleapis.com/detrics-static/public/img/mercado-libre-logo.png" href="/data-source/mercado-ads/fields">
    Product ads and display campaigns on MercadoLibre
  </Card>

  <Card title="Snapchat Ads" icon="https://storage.googleapis.com/detrics-static/public/img/snapchat-ads-logo.svg" href="/data-source/snapchat-ads/fields">
    Campaigns, ad sets, creatives, and conversion metrics
  </Card>

  <Card title="Apple Search Ads" icon="https://storage.googleapis.com/detrics-static/public/img/Apple_logo.svg" href="/data-source/apple-search-ads/fields">
    Campaigns, keywords, installs, and conversion metrics from the App Store
  </Card>

  <Card title="Criteo Ads" icon="https://storage.googleapis.com/detrics-static/public/img/criteo-logo.svg" href="/data-source/criteo-ads/fields">
    Retargeting and display performance, video engagement, and ad set settings
  </Card>
</CardGroup>

***

## Social & Organic

<CardGroup>
  <Card title="Instagram Insights" icon="https://storage.googleapis.com/detrics-static/public/img/instagram-logo.png" href="/data-source/instagram-insights/fields">
    Followers, reach, impressions, and post-level engagement
  </Card>

  <Card title="Facebook Insights" icon="https://storage.googleapis.com/detrics-static/public/img/facebook-ads-logo.png" href="/data-source/facebook-insights/fields">
    Page-level reach, engagement, and audience demographics
  </Card>

  <Card title="Facebook Public Data" icon="https://storage.googleapis.com/detrics-static/public/img/facebook-ads-logo.png" href="/data-source/facebook-public-data/fields">
    Publicly available page and post data
  </Card>

  <Card title="TikTok Organic" icon="https://storage.googleapis.com/detrics-static/public/img/tiktok-logo.png" href="/data-source/tiktok-organic/fields">
    Video views, likes, shares, comments, and profile analytics
  </Card>

  <Card title="YouTube Analytics" icon="https://storage.googleapis.com/detrics-static/public/img/youtube-logo.png" href="/data-source/youtube-analytics/fields">
    Channel performance, video views, watch time, and monetization
  </Card>
</CardGroup>

***

## Analytics

<CardGroup>
  <Card title="Google Analytics 4" icon="https://storage.googleapis.com/detrics-static/public/img/universal-analytics-logo.png" href="/data-source/google-analytics-4/fields">
    Sessions, users, events, conversions, and traffic sources
  </Card>

  <Card title="Google Search Console" icon="https://storage.googleapis.com/detrics-static/public/img/google-search-console-logo.png" href="/data-source/google-search-console/fields">
    Search queries, impressions, clicks, CTR, and position
  </Card>

  <Card title="Google Business Profile" icon="https://storage.googleapis.com/detrics-static/public/img/google-business-profile-logo.svg" href="/data-source/google-business-profile/fields">
    Local search keywords, profile views, calls, direction requests, and reviews
  </Card>

  <Card title="Bing Webmaster Tools" icon="https://storage.googleapis.com/detrics-static/public/img/bing-webmaster-tools-logo.svg" href="/data-source/bing-webmaster-tools/fields">
    Bing search queries, pages, clicks, position, and SEO crawl health
  </Card>

  <Card title="AppsFlyer" icon="https://storage.googleapis.com/detrics-static/public/img/AppsFlyer-logo.svg" href="/data-source/appsflyer/fields">
    Mobile installs, in-app events, attribution, and cost per acquisition
  </Card>

  <Card title="Adobe Analytics" icon="https://storage.googleapis.com/detrics-static/public/img/adobe-logo.svg" href="/data-source/adobe-analytics/fields">
    Page views, visits, visitors, revenue, and marketing channel breakdowns
  </Card>
</CardGroup>

***

## E-commerce

<CardGroup>
  <Card title="Shopify" icon="https://storage.googleapis.com/detrics-static/public/img/shopify-logo.png" href="/data-source/shopify/fields">
    Orders, products, customers, inventory, and sales
  </Card>

  <Card title="WooCommerce" icon="https://storage.googleapis.com/detrics-static/public/img/woocommerce-logo.png" href="/data-source/woocommerce/fields">
    Orders, products, customers, and coupons
  </Card>

  <Card title="TiendaNube" icon="https://storage.googleapis.com/detrics-static/public/img/tienda-nube-logo.png" href="/data-source/tiendanube/fields">
    Orders, products, and customers for LATAM e-commerce
  </Card>

  <Card title="Stripe" icon="https://storage.googleapis.com/detrics-static/public/img/stripe-logo.png" href="/data-source/stripe/fields">
    Charges, subscriptions, customers, invoices, and payouts
  </Card>

  <Card title="VTEX" icon="https://storage.googleapis.com/detrics-static/public/img/VTEX-logo.png" href="/data-source/vtex/fields">
    Orders, products, SKUs, inventory, and shipping
  </Card>

  <Card title="Magento" icon="https://storage.googleapis.com/detrics-static/public/img/magento-logo.svg" href="/data-source/magento-orders/fields">
    Orders, revenue, products, and customer data
  </Card>

  <Card title="Mercado Libre Organic" icon="https://storage.googleapis.com/detrics-static/public/img/mercado-libre-logo.png" href="/data-source/mercado-organic/fields">
    Seller reputation, sales, items, and marketplace performance
  </Card>
</CardGroup>

***

## CRM & Email Marketing

<CardGroup>
  <Card title="Klaviyo" icon="https://storage.googleapis.com/detrics-static/public/img/klaviyo-logo.png" href="/data-source/klaviyo/fields">
    Email campaigns, flows, lists, and subscriber metrics
  </Card>

  <Card title="HubSpot" icon="https://storage.googleapis.com/detrics-static/public/img/hubpost-round-logo.png" href="/data-source/hubspot/fields">
    Contacts, deals, companies, and marketing emails
  </Card>

  <Card title="Salesforce" icon="https://storage.googleapis.com/detrics-static/public/img/Salesforce-logo.png" href="/data-source/salesforce/fields">
    Accounts, opportunities, leads, cases, and campaigns
  </Card>

  <Card title="Mailchimp" icon="https://storage.googleapis.com/detrics-static/public/img/mailchimp-logo.png" href="/data-source/mailchimp/fields">
    Campaigns, audiences, open rates, and click performance
  </Card>

  <Card title="Perfit" icon="https://storage.googleapis.com/detrics-static/public/img/perfit-icon.svg" href="/data-source/perfit/fields">
    Email campaigns, automations, subscribers, and engagement metrics
  </Card>

  <Card title="Instantly" icon="https://storage.googleapis.com/detrics-static/public/img/instantly-logo.svg" href="/data-source/instantly/fields">
    Cold email campaigns, leads, replies, and sender account health
  </Card>

  <Card title="Google Merchant Center" icon="https://storage.googleapis.com/detrics-static/public/img/google-merchant-center-logo.svg" href="/data-source/google-merchant-center/fields">
    Product listings, approval status, clicks, and impressions
  </Card>
</CardGroup>

***

## Next steps

<CardGroup>
  <Card title="Create a report in Google Sheets" icon="table" href="/data-destination/google-sheets/how-to-create-a-report">
    Use these fields to build your first report
  </Card>

  <Card title="Workspace Overview" icon="building" href="/workspace/quickstart">
    Manage your team and data source connections
  </Card>
</CardGroup>

<Tip>
  **Can't find a field?** If the metric or dimension you need isn't listed, reach out at [support@detrics.io](mailto:support@detrics.io), we regularly add new fields based on user requests.
</Tip>


# Choose Your Path
Source: https://support.detrics.io/getting-started/choose-your-path

Pick the right Detrics integration for your workflow

Every team works differently. Choose the integration that fits how you already work, and you will be up and running in minutes.

<CardGroup>
  <Card title="Google Sheets" icon="table" href="/google-sheets/quickstart">
    Pull marketing data directly into your spreadsheets. Best for analysts who build custom reports, need flexible data manipulation, or share results with non-technical stakeholders.
  </Card>

  <Card title="Looker Studio" icon="chart-line" href="/looker-studio/quickstart">
    Power your Looker Studio dashboards with live marketing data. Best for teams that need auto-refreshing visual dashboards and client-facing reports.
  </Card>

  <Card title="Claude" icon="robot" href="/claude/overview">
    Query your marketing data using natural language through Claude. Best for quick ad-hoc analysis and teams already using AI tools.
  </Card>

  <Card title="Data Warehouse (BigQuery)" icon="database" href="/bigquery/quickstart">
    Sync marketing data into BigQuery on a schedule. Best for data engineers and teams that need raw data for custom SQL analysis, dbt models, or BI tools.
  </Card>
</CardGroup>

<Tip>
  Not sure which to pick? Most teams start with **Google Sheets** for quick reporting, then add a **Data Warehouse** as they scale. You can use multiple integrations at the same time.
</Tip>


# How Detrics Saves You Time
Source: https://support.detrics.io/getting-started/how-we-save-you-time

Whether you're an agency, a developer, or a founder, Detrics gets you out of the plumbing and into the work that matters.

Detrics moves marketing data from 30+ platforms into the tools you already use: Google Sheets, Looker Studio, Claude, and BigQuery. Here's what that means for you, depending on what you do.

## If you're a marketing agency

You manage clients across Meta, Google Ads, TikTok, GA4, and a long tail of other platforms. Every Monday someone is logging into each one, exporting CSVs, and pasting numbers into a spreadsheet. Detrics replaces all of that with a connection you set up once and a query that refreshes on its own, so your team stops being a data-entry team and goes back to running campaigns. [Start with the Google Sheets add-on](/google-sheets/quickstart).

## If you're a developer

You don't have to write a single API integration. Use our [Claude MCP](/claude/overview) to pull live marketing data into your AI workflows with natural language. We take care of authentication, token refreshment, rate limiting, data normalization and cleaning, and API updates and maintenance. If you need raw data in a warehouse for SQL, dbt, or custom pipelines, point Detrics at [BigQuery](/bigquery/quickstart) and we'll keep it synced for you.

## If you're a founder

Don't vibe-code an integration you'll have to maintain forever. OAuth flows break, marketing APIs change every few months, and the weekends you spend debugging a token refresh are weekends you're not shipping product. Our cheapest paid plan is [\$24.99/month](/pricing), which is roughly one hour of your time, and it gives you the [Claude MCP](/claude/overview) plus the Google Sheets connector. Buy your way out of the plumbing.

<Card href="https://detrics.io/get-started?utm_source=detrics-support&utm_medium=how-we-save-you-time">
  **Get Started Free.** Connect your first platform in under 2 minutes, then add billing when you're ready.
</Card>


# Google Sheets Quickstart
Source: https://support.detrics.io/google-sheets/quickstart

Launch Detrics and run your first query in under 2 minutes

Follow these 8 steps to go from a blank spreadsheet to live marketing data using a preset template.

<Info>
  **Prerequisites:** You need a [Detrics account](https://detrics.io/get-started?utm_source=detrics-support\&utm_medium=sheets-quickstart) and the Detrics add-on installed. If you haven't done this yet, follow the [installation guide](/quickstart/google-sheets) first.
</Info>

<Steps>
  <Step title="Open a Google Sheet">
    Go to [sheets.new](https://sheets.new) to create a new blank spreadsheet, or open any existing sheet where you want to pull data.
  </Step>

  <Step title="Open the Extensions menu">
    Click **Extensions** in the top menu bar.
  </Step>

  <Step title="Launch Detrics">
    Hover over **Detrics - PPC, Marketing Analytics & Ecommerce**, then click **Launch Detrics** from the submenu.

    <Tip>
      Don't see Detrics in the list? You need to [install the add-on](/quickstart/google-sheets) first from Google Workspace Marketplace.
    </Tip>
  </Step>

  <Step title="Select a data source">
    After a few seconds, the sidebar finishes loading and shows the **Start from Preset** screen with all available data sources. Click the platform you want to pull data from (e.g., **Google Analytics 4**).
  </Step>

  <Step title="Choose a preset template">
    Each template includes a name and short description. Click the one that matches the data you need.
  </Step>

  <Step title="Select your account">
    Choose which account to pull data from. Use the search box to filter by name, then check the box next to your account.
  </Step>

  <Step title="Execute the template">
    Click the **Execute Template** button to run the query. You can also click **Customize Template** to adjust metrics, dimensions, or date range before running.
  </Step>

  <Step title="See your results">
    Detrics fetches the data from the platform API and writes it directly into your spreadsheet. The sidebar shows a success message and an option to enable automatic daily refresh.

    <Tip>
      Enable **Refresh daily at 9 AM** to keep your data updated every morning automatically.
    </Tip>
  </Step>
</Steps>

## What's next?

<CardGroup>
  <Card title="Create custom queries" icon="sliders" href="/data-destination/google-sheets/how-to-create-a-report">
    Build queries from scratch with your own metrics, dimensions, and filters.
  </Card>

  <Card title="Automate your reports" icon="clock" href="/data-destination/google-sheets/how-to-automate-a-query">
    Set up scheduled refreshes to keep your data always up to date.
  </Card>

  <Card title="Use query templates" icon="grid-2" href="/data-destination/google-sheets/how-to-use-query-templates">
    Customize preset templates or create your own reusable queries.
  </Card>

  <Card title="Import and export queries" icon="arrow-right-arrow-left" href="/data-destination/google-sheets/how-to-import-export-queries">
    Copy queries between spreadsheets in a few clicks.
  </Card>
</CardGroup>


# What is Detrics?
Source: https://support.detrics.io/index

Detrics connects your marketing platforms to Google Sheets, Looker Studio, Claude, and BigQuery, so your data is always where you need it.

Detrics is a marketing data connector. It pulls metrics and dimensions from 30+ platforms (Meta Ads, Google Ads, Shopify, GA4, and more) into the tools you already use: Google Sheets, Looker Studio, Claude, and BigQuery.

You connect a platform once, and Detrics keeps your data fresh and ready to use on a schedule you define.

## How It Works

1. **Connect** your marketing platforms through OAuth (read-only, secure)
2. **Query** the metrics and dimensions you need, from the tool you prefer
3. **Automate** with scheduled refreshes so your reports stay current

## Choose Where to Start

<CardGroup>
  <Card title="Google Sheets" icon="table" href="/google-sheets/quickstart">
    Pull data directly into spreadsheets. Build custom reports, share with your team, schedule automatic updates.
  </Card>

  <Card title="Looker Studio" icon="chart-line" href="/looker-studio/quickstart">
    Power your Looker dashboards with live marketing data. Auto-refreshing, client-ready visualizations.
  </Card>

  <Card title="Claude" icon="robot" href="/claude/overview">
    Query marketing data with natural language in Claude via MCP.
  </Card>

  <Card title="Data Warehouse" icon="database" href="/bigquery/quickstart">
    Sync marketing data to BigQuery on a schedule. SQL access, dbt-ready, built for data teams.
  </Card>
</CardGroup>

## What Makes Detrics Different

* **30+ platforms** in one tool, advertising, analytics, e-commerce, CRM
* **Multiple destinations**: Sheets, Looker, AI, and BigQuery from a single connection
* **Team workspaces**: share connections and queries across your organization
* **Affordable**: built for agencies and growing teams, not enterprise budgets

## Supported Platforms

Detrics connects to 30+ advertising, analytics, e-commerce, and CRM platforms. The [Fields Catalog](/fields-catalog/index) is the always-current source of truth for every supported platform, with the metrics and dimensions available for each.

<Card title="Browse the Fields Catalog" icon="book" href="/fields-catalog/index">
  See every supported platform and all of its available fields.
</Card>

<Card href="https://detrics.io/get-started?utm_source=detrics-support&utm_medium=getting-started-introduction">
  **Get Started Free**: No credit card required. Connect your first platform in under 2 minutes.
</Card>


# Add the Detrics Connector
Source: https://support.detrics.io/looker-studio/add-connector

Step-by-step guide to adding Detrics as a data source in Looker Studio

<Info>**Last updated:** March 21, 2026</Info>

This guide walks through every step of adding a Detrics connector to Looker Studio, from finding the connector to seeing your data in a live report.

## Two ways to add the connector

You can add Detrics to Looker Studio in two ways:

1. **From the Detrics website** (recommended for first-time users)
2. **From within Looker Studio** (if you already have a report open)

***

## Option 1: From the Detrics website

<Steps>
  <Step title="Visit the Detrics connector gallery">
    Go to [detrics.io/looker-studio/integrations](https://www.detrics.io/looker-studio/integrations?utm_source=detrics-support\&utm_medium=looker-add-connector) and browse the available connectors.

    You will see connectors for Meta Ads, Google Ads, TikTok Ads, LinkedIn Ads, Google Analytics 4, Shopify, and more.
  </Step>

  <Step title="Click your desired connector">
    Click on the platform you want to connect. For example, click **Meta Ads** to add Facebook/Instagram advertising data.

    This will redirect you to Looker Studio's connector authorization page.
  </Step>

  <Step title="Authorize your Detrics account">
    You will see two authorization steps:

    1. Click the **Authorize** button on the left side to sign in with your Google account
    2. Click the **Authorize** button on the right side to connect your ad platform

    <Frame>
      <img alt="Authorize Detrics access button on the left side" />
    </Frame>

    <Frame>
      <img alt="Authorize Meta connection button on the right side" />
    </Frame>
  </Step>

  <Step title="Select your ad account">
    Choose the specific account you want to pull data from. For Meta Ads, you will see a dropdown listing all your ad accounts.

    <Frame>
      <img alt="Dropdown showing available Meta ad accounts to connect" />
    </Frame>
  </Step>

  <Step title="Choose a template (optional)">
    Some connectors offer pre-built templates with common charts and layouts already configured. Keep the checkbox checked to start with a template, or uncheck it to start from a blank report.

    <Frame>
      <img alt="Checkbox to opt in to a pre-built Looker Studio template" />
    </Frame>

    <Tip>
      Templates are a great starting point. You can always customize or remove any element after the report is created.
    </Tip>
  </Step>

  <Step title="Connect the data source">
    Click the **Connect** button in the top-right corner of the screen to finalize the connection.

    <Frame>
      <img alt="Connect button in the top-right corner" />
    </Frame>
  </Step>

  <Step title="Review and format fields">
    Before creating the report, you can review the available fields. A common adjustment is changing the "Ad Image" field type from **Text** to **Image URL** so your report can display ad creative previews.

    <Frame>
      <img alt="Dimension view showing field names and data types that can be adjusted" />
    </Frame>
  </Step>

  <Step title="Create the report">
    Click **Create Report** (or **Add to Report** if adding to an existing report). Your data source is now connected and ready to use.

    <Frame>
      <img alt="Create Report button in the top-right corner" />
    </Frame>
  </Step>
</Steps>

***

## Option 2: From within Looker Studio

If you already have a report open in edit mode, you can add Detrics as an additional data source.

<Steps>
  <Step title="Click 'Add Data' in the toolbar or panel">
    In edit mode, click **Add data** in the toolbar at the top of the screen, or click the **Add Data** link at the bottom of the Data panel on the right side.

    <Frame>
      <img alt="Add Data button highlighted at the bottom-right of the Data panel" />
    </Frame>
  </Step>

  <Step title="Search for Detrics">
    In the connector search dialog, type **Detrics**. You will see all available Detrics connectors listed. Select the one matching your platform.
  </Step>

  <Step title="Authorize and select account">
    Follow the same authorization flow as Option 1 above (Steps 3-4). You will authorize your Google account, then your platform account, and select the specific ad account.
  </Step>

  <Step title="Confirm the connection">
    Once connected, you will see the data source appear in the Data panel on the right, showing the platform name (e.g., "Meta Ads") and all available field categories.

    <Frame>
      <img alt="Data panel showing Meta Ads as the connected data source with field categories listed below" />
    </Frame>
  </Step>
</Steps>

***

## What you see after connecting

Once your connector is set up and you have added charts, your report will display live data from your ad platform. Here is an example report with two data tables pulling campaign performance data from Meta Ads:

## Switching accounts on an existing connector

If you need to change which ad account a connector uses:

1. Go to **Resource > Manage added data sources**
2. Find the Detrics connector and click **Edit**
3. Change the account selection
4. Click **Reconnect** in the top-right corner

## Available connectors

Detrics currently supports the following platforms as Looker Studio connectors:

* **Meta (Facebook) Ads**
* **Google Ads**
* **TikTok Ads**
* **LinkedIn Ads**
* **X (Twitter) Ads**
* **Bing (Microsoft) Ads**
* **Google Display & Video 360**
* **Google Analytics 4**
* **Instagram Insights**
* **Shopify**

For the full list with field details, see [Supported Data Sources](/data-destination/looker-studio/supported-data-sources).

## Troubleshooting connection issues

<AccordionGroup>
  <Accordion title="I don't see Detrics in the connector list">
    Make sure you are searching for **Detrics** (not "Dataplug"). If it still does not appear, try using the [direct link from the Detrics website](https://www.detrics.io/looker-studio/integrations?utm_source=detrics-support\&utm_medium=looker-add-connector-troubleshooting) instead.
  </Accordion>

  <Accordion title="Authorization fails or loops">
    Clear your browser cookies for `lookerstudio.google.com` and try again. Make sure you are using the same Google account that has your Detrics workspace. If the issue persists, try in an incognito window.
  </Accordion>

  <Accordion title="I don't see any ad accounts in the dropdown">
    Verify that your platform connection is active in your [Detrics workspace](https://app.detrics.io). If the connection has expired, re-authorize it in the Detrics web app first, then retry in Looker Studio.
  </Accordion>

  <Accordion title="Data is not loading after connecting">
    Check the [6-minute timeout guide](/data-destination/looker-studio/6-minutes-limit). Looker Studio has a strict execution time limit. Try reducing your date range or the number of fields in your query.
  </Accordion>
</AccordionGroup>

<Warning>
  Each Looker Studio connector instance is tied to a single ad account. To pull data from multiple accounts, add the connector once per account using **Add data**.
</Warning>

## Next steps

<CardGroup>
  <Card title="Looker Studio Quickstart" icon="play" href="/looker-studio/quickstart">
    Full walkthrough of building your first report
  </Card>

  <Card title="Work Faster in Looker Studio" icon="rocket" href="/data-destination/looker-studio/how-to-work-faster">
    Tips to speed up your dashboard workflow
  </Card>

  <Card title="6-Minute Limit" icon="clock" href="/data-destination/looker-studio/6-minutes-limit">
    Understand Looker Studio's query timeout and how to work around it
  </Card>

  <Card title="Troubleshooting" icon="wrench" href="/data-destination/looker-studio/troubleshooting">
    Solutions for common issues
  </Card>
</CardGroup>

<Tip>
  **Need help?** Reach out to [support@detrics.io](mailto:support@detrics.io) for assistance with connection issues or missing platforms.
</Tip>


# Looker Studio Quickstart
Source: https://support.detrics.io/looker-studio/quickstart

Connect Detrics to Looker Studio and create your first report

<Info>**Last updated:** March 21, 2026</Info>

This visual walkthrough shows you how to connect Detrics to Looker Studio and build your first dashboard, step by step. By the end, you will have a working report pulling live marketing data.

## Prerequisites

Before you begin, make sure you have:

* A [Detrics account](https://detrics.io/get-started?utm_source=detrics-support\&utm_medium=looker-quickstart) with at least one connected platform
* Access to [Looker Studio](https://lookerstudio.google.com) (free with any Google account)

## Connect and build your first report

<Steps>
  <Step title="Open Looker Studio and create a report">
    Go to [lookerstudio.google.com](https://lookerstudio.google.com) and click **Blank Report** to start a new report, or open an existing one.

    You will land in Edit mode with the toolbar across the top.

    <Frame>
      <img alt="Looker Studio edit mode with the main toolbar" />
    </Frame>
  </Step>

  <Step title="Add Detrics as a data source">
    Click **Add data** in the toolbar. In the connector search dialog, type **Detrics** and select the connector for your platform (e.g., "Detrics Meta Ads Connector").

    Authorize the connection when prompted, then select the ad account you want to pull data from.

    <Frame>
      <img alt="Add data button highlighted in the Looker Studio toolbar" />
    </Frame>

    <Tip>
      First time connecting? See the detailed [Add the Detrics Connector](/looker-studio/add-connector) guide for the full authorization flow with screenshots.
    </Tip>
  </Step>

  <Step title="Browse available fields in the Data panel">
    Once connected, the **Data panel** on the right shows all available fields organized into categories. For Meta Ads, you will see groups like Account, Ad, Ad Set, Ad Creative, Videos, Clicks, Total Metrics, and many more.

    Expand any category to see individual fields. In Looker Studio, **dimensions** are attributes you group by (like Campaign Name or Date) and **metrics** are numeric values you measure (like Cost or Impressions).

    <Frame>
      <img alt="Data panel showing Meta Ads field categories like Account, Ad, Ad Set, Total Metrics, and more" />
    </Frame>
  </Step>

  <Step title="Add a chart to your report">
    Click **Add a chart** in the toolbar and choose a chart type (Table, Time series, Bar chart, Scorecard, etc.). The chart will appear on the canvas.

    You can also drag a field directly from the Data panel onto the canvas to auto-create a chart.

    <Frame>
      <img alt="Add a chart button highlighted in the toolbar" />
    </Frame>
  </Step>

  <Step title="View your data in a table">
    After adding a table chart, click it to select it. In the properties panel, drag fields from the Data panel into the **Dimension** and **Metric** slots (or use the "Add dimension" / "Add metric" buttons). Your table will populate with live data.

    Here you can see campaign names, dates, and cost data pulled directly from Meta Ads.
  </Step>

  <Step title="Configure chart properties">
    Click any chart to open its **Table properties** panel. Here you can:

    * Change the **Data source** (e.g., Meta Ads)
    * Add or remove **Dimensions** (like Campaign Name, Date, Result Name)
    * Add or remove **Metrics** (like Cost, Results, Cost per Result)
    * Set **Filters** and **Default date range**

    <Frame>
      <img alt="Table properties panel with dimensions, metrics, and filter configuration" />
    </Frame>
  </Step>

  <Step title="Add a date range control">
    Click **Add a control** in the toolbar and select **Date range control**. Place it on your report canvas. This lets viewers filter all charts by a custom date range.

    <Frame>
      <img alt="Add a control button highlighted in the Looker Studio toolbar" />
    </Frame>

    Once placed, you will see a date range dropdown on your report canvas where users can select their desired date range.
  </Step>

  <Step title="Switch to View mode">
    Click the **View** button (blue button in the top-right corner) to exit edit mode and see your finished report as viewers will see it. Your dashboard is now pulling live data from Detrics.

    <Frame>
      <img alt="View button highlighted in the top-right corner of Looker Studio" />
    </Frame>
  </Step>
</Steps>

<Note>
  Your 14-day free trial starts once your first table loads data in Looker Studio.
</Note>

<Warning>
  Looker Studio has a **6-minute execution limit** per data source query. If your report times out, reduce the date range or number of fields. See the [6-minute limit guide](/data-destination/looker-studio/6-minutes-limit) for details.
</Warning>

## Next steps

<CardGroup>
  <Card title="Add the Detrics Connector" icon="plug" href="/looker-studio/add-connector">
    Detailed walkthrough of the connector authorization and account selection flow
  </Card>

  <Card title="Build Dashboards 10x Faster" icon="rocket" href="/data-destination/looker-studio/how-to-work-faster">
    Performance tips to speed up your dashboard creation workflow
  </Card>

  <Card title="Supported Data Sources" icon="database" href="/data-destination/looker-studio/supported-data-sources">
    See which platforms are available as Looker Studio connectors
  </Card>

  <Card title="Troubleshooting" icon="wrench" href="/data-destination/looker-studio/troubleshooting">
    Solutions for common connection and performance issues
  </Card>
</CardGroup>

<Tip>
  **Need help?** Reach out to [support@detrics.io](mailto:support@detrics.io) for assistance with connectors or available metrics.
</Tip>


# Pricing & Plans
Source: https://support.detrics.io/pricing

Choose the plan that fits your business needs

<Info>**Last updated:** May 18, 2026</Info>

# Pricing & Plans

Detrics offers flexible pricing plans designed to scale with your business. Choose between our Google Sheets Addon, Looker Studio Connectors, and the BigQuery Data Warehouse based on your needs.

## Google Sheets Addon Plans

| Feature                 | Free        | Starter       | Growth        | Pro (Most Popular)      | Business                |
| ----------------------- | ----------- | ------------- | ------------- | ----------------------- | ----------------------- |
| **Price**               | \$0/month   | \$24.99/month | \$49.99/month | \$99.99/month           | \$149.99/month          |
| **Data updates/month**  | 35          | 250           | 1,250         | 5,000                   | Unlimited               |
| **Rows per update**     | 1,000       | Unlimited     | Unlimited     | Unlimited               | Unlimited               |
| **Accounts per source** | Unlimited   | Unlimited     | Unlimited     | Unlimited               | Unlimited               |
| **Users**               | Single user | Single user   | Single user   | Shared subscription     | Shared subscription     |
| **Refreshes**           | Hourly      | Hourly        | Hourly        | Hourly                  | Hourly                  |
| **Support**             | Live Chat   | Live Chat     | Live Chat     | Dedicated Slack channel | Dedicated Slack channel |
| **Migration**           | -           | -             | -             | Supermetrics migration  | Supermetrics migration  |
| **Additional users**    | -           | -             | -             | \$19.99 per month       | \$19.99 per month       |

### Annual Pricing

| Plan     | Monthly        | Annual Rate    | Annual Total | Savings % | You Save |
| -------- | -------------- | -------------- | ------------ | --------- | -------- |
| Starter  | \$24.99/month  | \$19.99/month  | \$239/year   | 20%       | \$60     |
| Growth   | \$49.99/month  | \$39.99/month  | \$479/year   | 20%       | \$120    |
| Pro      | \$99.99/month  | \$79.99/month  | \$959/year   | 20%       | \$240    |
| Business | \$149.99/month | \$114.99/month | \$1,379/year | 23%       | \$420    |

<Note>
  **Save up to 23% annually!** All paid plans include a significant discount
  when billed yearly.
</Note>

### Premium Features

#### Pro & Business Plan Benefits

<CardGroup>
  <Card title="Unlimited Usage (Business)" icon="infinity">
    Don't worry about data update limits with unlimited updates. Scale without extra costs as your business grows.
  </Card>

  <Card title="Team Collaboration" icon="users">
    Shared subscriptions with Pro and Business plans. Add additional users and
    manage multi-account teams efficiently with centralized data access.
  </Card>

  <Card title="Free Migration" icon="arrows-rotate">
    Pro and Business plans include free Supermetrics migration assistance to help
    you transition seamlessly.
  </Card>

  <Card title="Dedicated Support" icon="headset">
    Get direct access to our team through a dedicated Slack channel for immediate assistance.
  </Card>
</CardGroup>

### Understanding Data Updates

<Accordion title="What counts as a Data Update?">
  A data update is counted each time you:

  * Execute a data pull from any connected platform
  * Refresh existing data in your spreadsheet
  * Run scheduled automatic updates

  Multiple accounts or date ranges in a single execution still count as one data update.
</Accordion>

## Looker Studio Connectors

| Feature            | Lite           | Unlimited      |
| ------------------ | -------------- | -------------- |
| **Monthly Price**  | \$14.99/month  | \$19.99/month  |
| **Free Trial**     | 14 days        | 14 days        |
| **Connectors**     | 1 connector    | 10+ connectors |
| **Reports**        | Unlimited      | Unlimited      |
| **Accounts**       | 1 account      | Unlimited      |
| **Setup Time**     | 2 minutes      | 2 minutes      |
| **Data Security**  | 256-bit SSL    | 256-bit SSL    |
| **Authentication** | OAuth 2.0      | OAuth 2.0      |
| **Compliance**     | GDPR compliant | GDPR compliant |

### Annual Pricing

| Plan      | Monthly       | Annual Rate   | Annual Total | Savings % | You Save |
| --------- | ------------- | ------------- | ------------ | --------- | -------- |
| Lite      | \$14.99/month | \$10.99/month | \$131/year   | 25%       | \$48     |
| Unlimited | \$19.99/month | \$14.99/month | \$179/year   | 25%       | \$60     |

<Note>
  **Save 25% annually!** Both Looker Studio plans include a significant discount
  when billed yearly. No credit card required to start your free 14-day trial.
</Note>

## BigQuery / Data Warehouse Plans

The **Data Warehouse** syncs marketing data from every Detrics-supported platform directly into your own Google BigQuery project. Pricing is **quote-based**, scaled to the number of connectors and ad accounts you need, book a demo for a personalized quote.

|                    | Data Warehouse                                                                                      |
| ------------------ | --------------------------------------------------------------------------------------------------- |
| **Pricing model**  | Custom quote, based on connectors & accounts                                                        |
| **Billing**        | Monthly or annual, no forced annual contract                                                        |
| **Connectors**     | Core connectors included; premium connectors as add-ons                                             |
| **BigQuery usage** | No data-volume fees from Detrics, you pay Google directly for your own BigQuery storage and compute |
| **Support**        | Dedicated support & custom SLA                                                                      |

### What's included

<CardGroup>
  <Card title="Every data source" icon="plug">
    Sync any Detrics-supported platform. Flexible bundling, you only pay for the connectors and accounts you actually use.
  </Card>

  <Card title="3 sync modes" icon="arrows-rotate">
    Incremental, Full Refresh, and Full Append, with per-table configuration and scheduling.
  </Card>

  <Card title="You own your data" icon="lock">
    Data lands in your own GCP project. No data-volume fees from Detrics, you only pay Google for your BigQuery usage.
  </Card>

  <Card title="AI-powered query layer" icon="sparkles">
    Query your warehouse with Claude, plus dedicated support and a custom SLA.
  </Card>
</CardGroup>

<Note>
  BigQuery pricing isn't a fixed tier, it's tailored to your setup. [Book a demo](https://detrics.io/demo/book) for a personalized quote.
</Note>

## Support Levels

| Plan         | Support Type            | Response Time | Features                              |
| ------------ | ----------------------- | ------------- | ------------------------------------- |
| **Free**     | Live Chat               | Standard      | Basic support                         |
| **Starter**  | Live Chat               | Standard      | Standard support                      |
| **Growth**   | Live Chat               | Standard      | Standard support                      |
| **Pro**      | Dedicated Slack Channel | Immediate     | Direct team access, migration support |
| **Business** | Dedicated Slack Channel | Immediate     | Direct team access, migration support |

## Choosing the Right Destination

When selecting between Google Sheets and Looker Studio, consider your data volume and refresh needs:

<Tabs>
  <Tab title="Google Sheets Recommended">
    <ul>
      <li>Timeframes longer than 7 days for Ads platforms</li>
      <li>30+ days of data with multiple accounts</li>
      <li>Heavy data platforms: TikTok Ads, Meta Ads, Tiendanube, Shopify</li>
      <li>Need for custom calculations and data manipulation</li>
      <li>Requirement for data caching and improved performance</li>
    </ul>
  </Tab>

  <Tab title="Looker Studio Recommended">
    <ul>
      <li>Real-time or near real-time dashboards</li>
      <li>Executive presentations and client reporting</li>
      <li>Interactive visualizations and filters</li>
      <li>Smaller data volumes or shorter timeframes</li>
    </ul>
  </Tab>
</Tabs>

<Tip>
  **Performance Tip**: For optimal performance with data-heavy platforms (TikTok
  Ads, Meta Ads, Tiendanube, Shopify), consider using Google Sheets as an
  intermediate layer. This provides:

  <ul>
    <li>Integrated cache between you and platforms</li>
    <li>Uniform experience across different platform latencies</li>
    <li>Improved dashboard creation performance</li>
    <li>Easy visualization creation with cached data</li>
  </ul>
</Tip>

## Billing Information

### Payment Methods

<ul>
  <li>Credit/Debit cards (Visa, Mastercard, American Express, Diners)</li>
  <li>Google Pay</li>
  <li>Bank transfers and ACH (Business+ only)</li>
  <li>Annual invoicing available</li>
</ul>

### Billing Cycles

<ul>
  <li>Monthly billing with no long-term commitments</li>
  <li>Annual billing with 25% discount</li>
  <li>Custom enterprise agreements available</li>
  <li>Free 14-day trial for Looker Studio (no credit card required)</li>
</ul>

### How to change tax information

Follow these three simple steps to update your tax information:

<Steps>
  <Step title="Access Your Account">
    Navigate to [app.detrics.io/account](https://app.detrics.io/account) and
    click the "Manage subscription" button next to your current plan.

    <Frame>
      <img alt="Manage subscription button in Detrics account page" />
    </Frame>
  </Step>

  <Step title="Update Billing Information">
    In the Stripe billing portal, click "Update information" under the Billing
    Information section to modify your name, email, or billing address.

    <Frame>
      <img alt="Update billing information in Stripe portal" />
    </Frame>
  </Step>

  <Step title="Add Tax ID">
    Scroll down to the Tax ID section, select your ID type from the dropdown,
    enter your tax identification number, and click "Save" to apply the changes.

    <Frame>
      <img alt="Add tax ID in Stripe billing portal" />
    </Frame>
  </Step>
</Steps>

## Upgrading Your Plan

Ready to unlock more features? You can upgrade your plan at any time:

1. Visit [detrics.io/pricing](https://detrics.io/pricing?utm_source=detrics-support\&utm_medium=upgrading-your-plan)
2. Select your plan
3. Changes take effect immediately

## Questions?

Have questions about pricing or need a custom plan? Contact our support team:

<ul>
  <li>Email: [support@detrics.io](mailto:support@detrics.io)</li>
  <li>Live Chat available in Argentina GMT-3 timezone from 9 AM to 6 PM</li>
</ul>


# Workspace Overview
Source: https://support.detrics.io/workspace/quickstart

Manage your team, connections, and account settings

<Info>**Last updated:** March 21, 2026</Info>

Your workspace is where your entire team collaborates on data. It holds your team members, data source connections, scheduled queries, and account settings, all in one place.

***

## How the workspace is organized

A Detrics workspace contains:

* **Team Members**: the people who can log in and use Detrics
* **Connections**: authenticated links to your ad platforms, analytics tools, and e-commerce stores
* **Account settings**: your plan, billing, and workspace preferences

Every team member shares the same workspace. Once someone connects Meta Ads as a shared connection, everyone on the team can build reports from it.

***

## Team Members

The Team Members page shows everyone in your workspace, their email, and their role (Owner or Member).

<Frame>
  <img alt="Team Members page showing a list of workspace members with roles and action buttons" />
</Frame>

From this page you can:

* **Search** for a member by name or email
* **Invite new members** using the green "Invite Team Member" button
* **View roles & permissions** to understand what each role can do
* **Change a member's role** or remove them via the actions menu

<Info>
  Every workspace must have at least one Owner. Members can connect data sources and run queries, but only Owners can manage billing, invite users, and control team connections.
</Info>

***

## Data Sources

The Data Sources page is your central hub for all platform connections. Each platform row shows the number of active connections your team has established.

<Frame>
  <img alt="Data Sources page showing all connected platforms like Meta Ads, Google Ads, TikTok Ads with connection counts" />
</Frame>

Click any platform row to expand it and see individual connections with details like the login email, account count, scheduled queries, who added the connection, and last activity.

<Frame>
  <img alt="Expanded X Ads platform showing individual connections with accounts, scheduled queries, and added-by information" />
</Frame>

***

## Common tasks

<Steps>
  <Step title="Invite a team member">
    In the left sidebar, under **Workspace**, click **Team Members**. Then click the green **Invite Team Member** button in the top right. Enter their email address and they will receive an invitation to join.
  </Step>

  <Step title="View your connections">
    In the left sidebar, click **Data Sources** (under the **Platform** section). You will see all connected platforms. Click a platform to expand it and view individual connections, the accounts they can access, and any scheduled queries using them.
  </Step>

  <Step title="Set connection sharing">
    New connections are **public by default**, all workspace members can use them. To restrict access, expand a platform, click the three-dot menu on a connection, and select **Manage sharing**. You can make it restricted (specific members only) or keep it public (everyone on the team can use it).
  </Step>
</Steps>

***

## Key concepts

| Concept                   | What it means                                                           |
| ------------------------- | ----------------------------------------------------------------------- |
| **Owner**                 | Full access to billing, team management, and all connections            |
| **Member**                | Can connect data sources, run queries, and manage their own connections |
| **Public connection**     | Any team member can use this connection in their queries (default)      |
| **Restricted connection** | Limited to specific team members chosen by the connection owner         |

***

## Next steps

<CardGroup>
  <Card title="Roles & Permissions" icon="user-shield" href="/workspace/roles-permissions">
    Understand what Owners and Members can do
  </Card>

  <Card title="View & Manage Connections" icon="link" href="/workspace/view-manage-connections">
    Reconnect, replace, archive, and share connections
  </Card>

  <Card title="Connection Sharing & Permissions" icon="lock" href="/workspace/shared-private-connections">
    Control who can access each connection
  </Card>

  <Card title="Fields Catalog" icon="book" href="/fields-catalog">
    Browse all available metrics and dimensions
  </Card>
</CardGroup>

<Tip>
  **Need help?** Use the chat widget in the bottom-right corner or email [support@detrics.io](mailto:support@detrics.io).
</Tip>


# Workspace Roles and Permissions
Source: https://support.detrics.io/workspace/roles-permissions

Understand workspace roles, what each role can do, and how permissions work in Detrics

<Info>**Last updated:** December 5, 2025</Info>

Every workspace member is assigned a role that determines what they can access and manage. This guide explains the two workspace roles and their permissions.

## Workspace Roles Overview

<CardGroup>
  <Card title="Owner" icon="crown">
    Full access to billing, team management, and all workspace settings. Can manage all connections and team members.
  </Card>

  <Card title="Member" icon="user">
    **Default role.** Can connect data sources and use all reporting features in Google Sheets and Looker Studio.
  </Card>
</CardGroup>

<Note>
  When you invite someone to your workspace, they automatically become a **Member**. Only existing Owners can promote Members to Owner status.
</Note>

***

## Permissions by Category

### Team Management

| Permission         |    Owner    |   Member  |
| ------------------ | :---------: | :-------: |
| User management    | Full access | View only |
| License management | Full access | View only |

<Info>
  **User management** includes inviting new members, removing members, and changing member roles.
</Info>

### Billing

| Permission         |    Owner    |   Member  |
| ------------------ | :---------: | :-------: |
| Billing management | Full access | No access |

<Warning>
  Only Owners can access billing settings, update payment methods, change plans, and view invoices.
</Warning>

### Data Source Connections

| Permission                      |    Owner    |    Member   |
| ------------------------------- | :---------: | :---------: |
| Manage own connections          | Full access | Full access |
| View and use shared connections | Full access | Full access |
| Manage team connections         | Full access |  No access  |

<Info>
  **Manage team connections** means the ability to reconnect, replace, archive, or modify sharing settings on connections created by other team members.
</Info>

Both Owners and Members can:

* Connect new data sources
* Manage connections they created (reconnect, replace, archive)
* Use any shared connection in their queries
* Share their own connections with the team

Only Owners can:

* Manage connections created by other team members
* Override sharing restrictions on any connection

### Destinations

| Destination            |    Owner    |    Member   |
| ---------------------- | :---------: | :---------: |
| Looker Studio          | Full access | Full access |
| Google Sheets          | Full access | Full access |
| BigQuery (coming soon) | Full access | Full access |

<Note>
  Destinations like Looker Studio, Google Sheets, and BigQuery have no restrictions at the workspace level. Access must be managed within each destination itself (e.g., sharing settings in Google Sheets or Looker Studio).
</Note>

***

## Role Comparison

| Capability                      | Owner | Member |
| ------------------------------- | :---: | :----: |
| Create queries in Google Sheets |  Yes  |   Yes  |
| Build Looker Studio dashboards  |  Yes  |   Yes  |
| Connect new data sources        |  Yes  |   Yes  |
| Manage own connections          |  Yes  |   Yes  |
| Use shared connections          |  Yes  |   Yes  |
| Invite team members             |  Yes  |   No   |
| Remove team members             |  Yes  |   No   |
| Change member roles             |  Yes  |   No   |
| Access billing settings         |  Yes  |   No   |
| Manage team connections         |  Yes  |   No   |

***

## When to Use Each Role

### Assign Owner Role When:

* The person needs to manage billing and subscriptions
* They should be able to invite or remove team members
* They need to manage connections created by others (e.g., when the original creator is unavailable)
* They're responsible for overall workspace administration

### Keep as Member When:

* They only need to create reports and dashboards
* They'll manage their own data source connections
* They don't need access to billing or team management
* They're a regular team member or client with access to specific data

***

## Managing Roles

### Promoting a Member to Owner

<Steps>
  <Step title="Go to Team Settings">
    Navigate to your workspace settings and select the Team section.
  </Step>

  <Step title="Find the Member">
    Locate the team member you want to promote in the members list.
  </Step>

  <Step title="Change Role">
    Click on their current role and select "Owner" from the dropdown.
  </Step>

  <Step title="Confirm">
    The change takes effect immediately. The new Owner now has full workspace access.
  </Step>
</Steps>

### Demoting an Owner to Member

<Steps>
  <Step title="Go to Team Settings">
    Navigate to your workspace settings and select the Team section.
  </Step>

  <Step title="Find the Owner">
    Locate the Owner you want to change.
  </Step>

  <Step title="Change Role">
    Click on their current role and select "Member" from the dropdown.
  </Step>

  <Step title="Confirm">
    The user immediately loses access to billing and team management features.
  </Step>
</Steps>

<Warning>
  **Cannot remove last Owner:** Every workspace must have at least one Owner. You cannot demote the last remaining Owner.
</Warning>

***

## Workspace Roles vs Connection Roles

It's important to understand the difference between workspace roles and connection roles:

| Type                 | Roles         | Scope                                                   |
| -------------------- | ------------- | ------------------------------------------------------- |
| **Workspace roles**  | Owner, Member | Apply to the entire workspace (billing, team, settings) |
| **Connection roles** | Owner, Editor | Apply to individual data source connections             |

<Info>
  A workspace Member can still be a connection Owner for connections they create. These are separate permission systems.
</Info>

Learn more about connection-level permissions in [Connection Sharing and Permissions](/workspace/shared-private-connections).

***

## Frequently Asked Questions

<AccordionGroup>
  <Accordion title="Can a Member invite other users?">
    No. Only Owners can invite new team members to the workspace.
  </Accordion>

  <Accordion title="Can I have multiple Owners?">
    Yes. You can have as many Owners as needed. This is recommended for business continuity.
  </Accordion>

  <Accordion title="What happens when an Owner leaves?">
    If the Owner is removed from the workspace, their connections remain but need a new owner. Another Owner should take over management of those connections. Make sure you always have at least one other Owner before removing someone.
  </Accordion>

  <Accordion title="Can Members see billing information?">
    No. Billing information is only visible to Owners.
  </Accordion>

  <Accordion title="Do Members count toward my license?">
    Yes. Both Owners and Members count toward your workspace's licensed user count.
  </Accordion>
</AccordionGroup>

***

## Next Steps

<CardGroup>
  <Card title="Connection Permissions" icon="link" href="/workspace/shared-private-connections">
    Learn how connection-level sharing and permissions work
  </Card>

  <Card title="Manage Connections" icon="gear" href="/workspace/view-manage-connections">
    View and manage all your data source connections
  </Card>
</CardGroup>

<Tip>
  **Need help?** If you have questions about roles or permissions, contact [support@detrics.io](mailto:support@detrics.io)
</Tip>


# Connection Sharing and Permissions
Source: https://support.detrics.io/workspace/shared-private-connections

Understand connection ownership, sharing permissions, and team collaboration in Detrics

<Info>**Last updated:** November 21, 2025</Info>

Detrics provides flexible connection sharing and permission controls to help your team collaborate effectively while maintaining security and data access control. This guide explains the different types of connection access, user roles, and what each role can do.

## Connection Types Overview

Every connection in Detrics is **public by default**, meaning all workspace members can use it in their queries. You can also restrict access to specific team members when needed.

<CardGroup>
  <Card title="Public" icon="users">
    Available to all members of your workspace by default. Everyone can use it
    in their queries. Only connection owners and workspace owners can manage the
    connection.
  </Card>

  <Card title="Restricted Access" icon="user-lock">
    Limited to specific team members only. The connection owner selects exactly
    who can access it. Perfect for client-specific or sensitive data.
  </Card>
</CardGroup>

***

## User Roles and Permissions

Detrics has a role-based permission system that determines what actions each user can perform on connections.

### Role Hierarchy

<Steps>
  <Step title="Connection Owner">
    The team member who originally created/connected the data source. Has full control over their own connections.
  </Step>

  <Step title="Connection Editor">
    Users who have been granted specific permissions to manage a connection. Can reconnect and modify settings but cannot delete.
  </Step>
</Steps>

<Note>
  **Workspace owners** can always access and manage all connections in the
  workspace, regardless of sharing settings.
</Note>

***

## Connection Owner Permissions

When you connect a data source, you become the connection owner with full control over that specific connection.

### What Connection Owners Can Do

<AccordionGroup>
  <Accordion title="Full Connection Management" icon="gear">
    Complete control over your own connections:

    * **Reconnect** when credentials expire
    * **Replace** the connection with a different account
    * **Archive** or unarchive the connection
    * **View** all account details and usage
    * **Restrict** access to specific users
    * **Generate** authentication links for external stakeholders

    <Tip>
      You maintain ownership even if you restrict the connection to specific users.
    </Tip>
  </Accordion>

  <Accordion title="Sharing Control" icon="share-nodes">
    Decide how your connection is shared:

    **Option 1: Keep it public (default)**

    * All workspace members can create queries with it
    * Only you and workspace owners can manage this connection (reconnect, replace, archive, manage sharing)

    **Option 2: Restrict to specific users**

    * Choose exactly which team members can create queries with it
    * Perfect for client-specific or department-specific connections
    * You can assign connection editors who can help manage the connection

    <Info>
      **Changing your mind:** You can change sharing settings at any time. Restrictions take effect immediately.
    </Info>
  </Accordion>

  <Accordion title="Permission Delegation" icon="user-tag">
    Grant management permissions to other team members:

    * **Add connection owners** who can help manage the connection
    * **Remove access** from specific users at any time

    <Note>
      Even when you delegate editing permissions, you remain the owner and retain full control.
    </Note>
  </Accordion>

  <Accordion title="Usage Visibility" icon="chart-line">
    Track how your connection is being used:

    * See which scheduled queries use your connection
    * View who has access (in the sharing menu)
    * Monitor last activity timestamp
    * Check account usage statistics

    <Tip>
      Click the number in the "Scheduled Queries" column to see exactly which queries are using your connection.
    </Tip>
  </Accordion>
</AccordionGroup>

### What Connection Owners Cannot Do

<Warning>
  **Limitations:** - Cannot access other users' restricted connections (unless
  you're also the workspace owner) - Cannot modify workspace-level settings -
  Cannot remove team members from the workspace
</Warning>

***

## Connection Editor Permissions

Connection editors are team members granted elevated permissions by the connection owner to help manage a connection.

### What Connection Editors Can Do

<AccordionGroup>
  <Accordion title="Reconnect Expired Connections" icon="rotate">
    When credentials expire, editors can:

    * Reconnect the data source with fresh credentials
    * Authenticate using their own platform credentials
    * Resume paused queries after reconnection

    <Info>
      **Why this matters:** If the connection owner is unavailable and credentials expire, editors can maintain uptime without waiting for the owner to reconnect.
    </Info>
  </Accordion>

  <Accordion title="View Connection Details" icon="circle-info">
    Full visibility into connection information:

    * View associated accounts
    * See which queries use the connection
    * Check connection status and last activity
    * Access account details and IDs

    This helps editors troubleshoot issues and understand connection dependencies.
  </Accordion>

  <Accordion title="Modify Account Selection" icon="list-check">
    For platforms with multiple accounts (Google Ads, Facebook Ads, etc.), editors can:

    * Add new accounts to the connection
    * Remove accounts no longer needed
    * Update account selections for queries

    <Note>
      **Limitation:** Editors cannot replace the entire connection, only modify which accounts within the connection are available.
    </Note>
  </Accordion>

  <Accordion title="Use in Queries" icon="table">
    All standard query operations:

    * Create new queries using the connection
    * Schedule automatic updates
    * Run manual query executions
    * View and export data
  </Accordion>
</AccordionGroup>

### What Connection Editors Cannot Do

<Warning>
  **Restrictions:** - **Cannot change sharing settings** - Only the owner can
  modify who has access - **Cannot archive the connection** - Only owners can
  archive or unarchive - **Cannot delete the connection** - Permanent actions
  require owner permission - **Cannot replace the connection** - Only owners can
  migrate queries to a different connection - **Cannot transfer ownership** -
  The original creator remains the owner
</Warning>

### How to Grant Editor Access

If you're a connection owner and want to add editors:

<Steps>
  <Step title="Open the connection menu">
    Click the three-dot menu (⋮) next to your connection.
  </Step>

  <Step title="Select 'Manage sharing'">
    Open the sharing and permissions dialog.
  </Step>

  <Step title="Add team members">
    * Choose "Restrict access" if you want to limit who can use this connection -
      Select the team members you want to give access to - Set their permission
      level to "Can edit" for those who should help manage the connection
  </Step>

  <Step title="Save changes">
    Click "Save" and the selected users immediately receive their assigned permissions.
  </Step>
</Steps>

***

## Permission Scenarios

Understanding how permissions work in real-world situations:

### Scenario 1: New Team Member Onboarding

<Steps>
  <Step title="Workspace owner invites user">
    The workspace owner sends an invitation to join the workspace.
  </Step>

  <Step title="New member accepts">
    The new team member accepts and joins the workspace.
  </Step>

  <Step title="Automatic access to public connections">
    They immediately see all public connections and can use them in their queries.
  </Step>

  <Step title="Request access to restricted connections">
    For restricted connections, they need to ask the connection owner to be added.
  </Step>

  <Step title="Create their own connections">
    The new member can connect their own data sources, which are public by default.
  </Step>
</Steps>

### Scenario 2: Connection Owner Goes on Vacation

<Steps>
  <Step title="Before leaving">
    The connection owner grants owner permissions to one or more trusted team members so they can manage the connection while away.
  </Step>

  <Step title="Credentials expire during vacation">
    If the connection needs reconnection while the owner is away.
  </Step>

  <Step title="Temporary owner reconnects">
    The team member with owner permissions can reconnect using the same credentials (the owner's account) to maintain service and keep queries running.
  </Step>

  <Step title="Queries resume automatically">
    Any paused queries resume running after successful reconnection.
  </Step>

  <Step title="Owner returns with full control">
    When the owner returns, they still have complete control and can revoke temporary owner permissions if needed.
  </Step>
</Steps>

### Scenario 3: Client-Specific Access

<Steps>
  <Step title="Agency creates client connection">
    An agency team member connects a client's ad account.
  </Step>

  <Step title="Restrict to client team">
    The owner restricts access to only team members working on that client.
  </Step>

  <Step title="Other clients remain separate">
    Team members on different client accounts cannot see or access this
    connection.
  </Step>

  <Step title="Workspace owner maintains oversight">
    The workspace owner can still access all connections for administrative purposes.
  </Step>
</Steps>

### Scenario 4: Team Member Leaves Company

<Steps>
  <Step title="Workspace owner identifies impact">
    Review all connections created by the leaving team member and identify which queries depend on them.
  </Step>

  <Step title="Replace connections with personal credentials">
    If the leaving member used personal credentials, the workspace owner must replace those connections with compatible connections (same accounts) from current team members. This ensures queries continue running without interruption.

    <Note>
      **Important:** Reconnections must use the same credentials. Since the leaving member's credentials won't be available, connection replacement is the only option to maintain active queries.
    </Note>
  </Step>

  <Step title="Archive unnecessary connections">
    Archive any connections no longer needed.
  </Step>

  <Step title="Remove user from workspace">
    Finally, remove the team member's access to the workspace.
  </Step>
</Steps>

***

## Permission Matrix

Quick reference for what each role can do:

<div>
  | Permission                                        | Owner<br /><sub>Can use the connection and manage all its settings</sub> | Editor<br /><sub>Can only use the connection in queries</sub> |
  | ------------------------------------------------- | ------------------------------------------------------------------------ | ------------------------------------------------------------- |
  | Use connection to create queries in Google Sheets | ✅                                                                        | ✅                                                             |
  | Use connection to build Looker Studio dashboards  | ✅                                                                        | ✅                                                             |
  | Share connection with other members               | ✅                                                                        | ❌                                                             |
  | Replace connection                                | ✅                                                                        | ❌                                                             |
  | Archive connection                                | ✅                                                                        | ❌                                                             |
  | Re-connect connection                             | ✅                                                                        | ❌                                                             |

  **Note:** Connection owners are determined when the connection is created. A workspace owner can grant you owner permissions for a specific connection.
</div>

***

## Changing Connection Sharing Settings

### Making a Connection Public

By default, all connections are public. If you've restricted a connection and want to make it public again:

<Steps>
  <Step title="Open connection menu">
    Click the three-dot menu (⋮) on your connection.
  </Step>

  <Step title="Select 'Manage sharing'">Open the sharing settings dialog.</Step>

  <Step title="Remove restrictions">
    Remove all user restrictions to make it available to all workspace members.
  </Step>

  <Step title="Confirm changes">
    Click "Save" and the connection immediately becomes visible to everyone.
  </Step>
</Steps>

### Restricting a Public Connection

<Steps>
  <Step title="Open sharing settings">
    Access the connection's sharing menu.
  </Step>

  <Step title="Select 'Restrict access'">
    Choose the option to limit access to specific users.
  </Step>

  <Step title="Choose users">
    Select which team members should have access. Unselected users will lose
    access.
  </Step>

  <Step title="Save changes">
    Restrictions take effect immediately. Users without access will no longer see the connection.
  </Step>
</Steps>

<Warning>
  **Impact on existing queries:** If someone has queries using a connection and
  you remove their access, those queries will fail. Consider the impact before
  restricting access.
</Warning>

***

## Understanding Connection Indicators

Visual cues help you quickly identify connection permissions:

<AccordionGroup>
  <Accordion title="No Sharing Icon" icon="users">
    **Meaning:** Public connection

    All workspace members can see and use this connection. This is the default state for all connections.
  </Accordion>

  <Accordion title="Lock Icon" icon="user-lock">
    **Meaning:** Restricted access

    Only specific team members can access this connection. Click "Manage sharing" to see who has access.
  </Accordion>

  <Accordion title="Crown Icon" icon="crown">
    **Meaning:** You are the connection owner

    Appears in the sharing menu to indicate you created this connection and have full control.
  </Accordion>

  <Accordion title="Edit Icon" icon="pencil">
    **Meaning:** You have editor permissions

    Shown in the sharing menu when someone has granted you editor access to their connection.
  </Accordion>
</AccordionGroup>

***

## Troubleshooting Permissions

<AccordionGroup>
  <Accordion title="Can't see a connection I need">
    **Possible reasons:**

    * The connection is restricted and you don't have access
    * The connection was archived
    * The connection was deleted

    **Solution:**

    1. Ask the connection owner to grant you access
    2. Contact your workspace owner for access
    3. Create your own connection to the same data source
  </Accordion>

  <Accordion title="Connection shows 'No Access'">
    **Meaning:** The connection is restricted and you don't have permission to use it.

    **Solution:**

    * Contact the connection owner shown in the "Added by" column
    * Ask your workspace owner to grant you access
  </Accordion>

  <Accordion title="Can't reconnect expired connection">
    **Reason:** You need to be the connection owner or have editor permissions.

    **Solution:**

    1. Contact the connection owner (shown in "Added by")
    2. Ask them to reconnect or grant you editor permissions
    3. If owner unavailable, contact workspace owner for help
  </Accordion>

  <Accordion title="User left and their connections are orphaned">
    **Solution (for workspace owners):** 1. Go to the Data Sources page 2. Find
    connections created by the former team member 3. Reconnect with company
    credentials to maintain access 4. Update sharing settings as needed 5.
    Consider replacing connections in queries if necessary
  </Accordion>

  <Accordion title="Cannot modify sharing on a connection">
    **Reason:** Only connection owners and workspace owners can change sharing settings.

    **Solution:**

    * If it's not your connection, ask the owner to adjust sharing
    * Workspace owners can override and modify any connection's settings
  </Accordion>
</AccordionGroup>

***

## Security Considerations

<Warning>
  **Protect sensitive data:** Be mindful of who can access connections,
  especially for connections containing: - Customer personal information -
  Financial data - Client confidential data - Sensitive business information
</Warning>

### Security Best Practices

<AccordionGroup>
  <Accordion title="Principle of Least Privilege">
    Use restricted access for sensitive client data rather than keeping connections public. Only grant access to team members who actually need it.
  </Accordion>

  <Accordion title="Audit Connection Access">
    Regularly review who has access to your connections: - Click "Manage sharing"
    on important connections - Remove users who no longer need access - Verify
    editor permissions are still appropriate
  </Accordion>

  <Accordion title="Use Company Credentials When Possible">
    For shared connections, use company email accounts rather than personal emails
    to ensure continuity if team members leave.
  </Accordion>

  <Accordion title="Monitor Workspace Members">
    Workspace owners should regularly review workspace membership and remove users who should no longer have access.
  </Accordion>
</AccordionGroup>

***

## Next Steps

Now that you understand connection permissions and sharing:

* **[View and manage connections](/workspace/view-manage-connections)** - Learn how to perform connection management tasks
* **[How to automate a query](/data-destination/google-sheets/how-to-automate-a-query)** - Start using your connections in scheduled queries
* **[Google Sheets Quickstart](/quickstart/google-sheets)** - Get started with Detrics if you're new

<Tip>
  **Need help?** If you have questions about permissions or connection
  management, contact [support@detrics.io](mailto:support@detrics.io) or use the chat widget in the
  bottom-right corner.
</Tip>


# View and Manage Connections
Source: https://support.detrics.io/workspace/view-manage-connections

Learn how to view, manage, and control access to your data source connections in Detrics

<Info>**Last updated:** November 21, 2025</Info>

The Data Sources page is your central hub for managing all connections between Detrics and your data sources. Here you can view connection details, manage access permissions, reconnect expired credentials, and control how your team collaborates on data connections.

## Quick Navigation

Jump to the section you need:

* [Understanding Connection Details](#understanding-connection-details)
* [Managing Connection Access](#managing-connection-access)
* [Reconnecting Data Sources](#reconnecting-data-sources)
* [Replacing Connections](#replacing-connections)
* [Sharing Authentication Links](#sharing-authentication-links)
* [Archiving Connections](#archiving-connections)
* [Viewing Associated Accounts](#viewing-associated-accounts)
* [Connecting New Data Sources](#connecting-new-data-sources)

***

## Understanding Connection Details

When you expand a data source, you'll see a detailed table with all connections for that platform.

### Connection Information Displayed

Each connection row shows:

#### Data Source Login

The email, username, or account identifier used to authenticate with the platform. This helps you identify which account was connected.

<Info>
  **What you'll see:** For most platforms, this is the email address or account
  name. For e-commerce platforms like Shopify, it's the store name.
</Info>

#### Accounts

The number of accounts or ad accounts associated with this connection. Click the account badge to view detailed information about each account.

<Note>
  **Not all platforms show accounts:** Single-account platforms like Stripe and
  Shopify don't display the accounts column since each connection represents a
  single account.
</Note>

#### Scheduled Queries

Shows how many scheduled queries are using this connection. Click the badge to navigate directly to the Scheduled Queries page filtered by this connection.

#### Added By

The team member who originally connected this data source to your workspace. This helps track connection ownership and accountability.

#### Last Activity

Timestamp showing when the connection was last used or modified. This updates when:

* A query executes using this connection
* The connection is reconnected
* Account selections are modified
* Permissions are changed

#### Sharing Status

Icons indicating access permissions:

* **No icon** - Private connection (only you can access)
* **Users icon** - Shared with entire team
* **Lock icon** - Restricted access (shared with specific users only)

***

## Managing Connection Access

Control who can access and use your connections through the sharing and permissions system.

### Opening the Sharing Menu

1. Expand the data source to view its connections
2. Click the three-dot menu (⋮) on the connection row
3. Select **"Manage sharing"**

### Sharing Options

<AccordionGroup>
  <Accordion title="Public Connection">
    Everyone in the workspace can use the connection to create queries. Only connection owners and workspace owners can replace, re-connect, archive and manage sharing.
  </Accordion>

  <Accordion title="Restricted Access">
    Share with specific team members only.

    **How to set up:**

    1. Open the actions menu
    2. Select "Manage sharing"
    3. Choose specific users from your workspace
    4. Click "Save"

    **Use case:** Client-specific accounts or sensitive data sources that only certain team members should access.
  </Accordion>
</AccordionGroup>

<Info>
  Learn more about connection permissions and roles in [Learn about shared and
  private connections](/workspace/shared-private-connections).
</Info>

***

## Reconnecting Data Sources

When a connection's credentials expire, you'll need to reconnect to restore access.

### When to Reconnect

You'll see a **"Reconnect Required"** status when:

* OAuth tokens have expired (on Meta's case after 60 days)
* Passwords were changed on the source platform
* Platform security settings were updated
* Access was revoked and needs to be re-granted

### How to Reconnect

<Steps>
  <Step title="Open the connection menu">
    Click the three-dot menu (⋮) next to the connection that needs reconnection.
  </Step>

  <Step title="Select 'Reconnect'">
    Click **"Reconnect"** from the dropdown menu.
  </Step>

  <Step title="Authenticate">
    You'll be redirected to the platform's login page. Sign in with **the same credentials** used for the original connection.

    <Warning>
      **Important:** You must use the same account credentials.
    </Warning>
  </Step>

  <Step title="Grant permissions">
    Approve the authorization request to allow Detrics to access your data.
  </Step>

  <Step title="Confirm success">
    You'll see a success message. Any paused queries using this connection will automatically resume.
  </Step>
</Steps>

<Tip>
  **Automatic resume:** When you reconnect a data source, any scheduled queries
  that were automatically paused due to the expired connection will resume and
  run on their next scheduled time.
</Tip>

***

## Replacing Connections

Replace an existing connection with a new one while automatically migrating all associated queries.

### When to Replace

Use connection replacement when you need to:

* Switch to a different account permanently
* Consolidate queries from multiple connections
* Update to a connection with different account access
* Transfer queries from an old connection to a new one

### How to Replace a Connection

<Steps>
  <Step title="Open connection menu">
    Click the three-dot menu (⋮) on the connection you want to replace.
  </Step>

  <Step title="Select 'Replace connection'">
    Choose **"Replace connection"** from the menu.

    <Note>
      **Not available for all platforms:** Single-account platforms (Stripe, Shopify, TiendaNube, WooCommerce) don't support connection replacement since each connection represents one account.
    </Note>
  </Step>

  <Step title="Choose replacement connection">
    A dialog will show all available connections for that platform. Select the
    connection you want to use as the replacement.
  </Step>

  <Step title="Confirm replacement">
    Review the changes and click "Replace". All queries using the old connection
    will be automatically updated to use the new connection and account selection.
  </Step>
</Steps>

<Warning>
  **This action cannot be undone:** Once you replace a connection, all
  associated queries are immediately updated. Make sure you've selected the
  correct replacement connection and accounts.
</Warning>

***

## Sharing Authentication Links

Generate temporary authentication links to help clients and external stakeholders connect their own data sources without sharing credentials.

### How It Works

Authentication links allow external actors to:

* Connect their own account for the same platform
* Authenticate without sharing passwords
* Add their connection to your company's workspace

### Generating a Share Link

<Steps>
  <Step title="Expand the data source">
    Click on the platform card to expand and view connections.
  </Step>

  <Step title="Click 'Share authentication link'">
    You'll find this button in the top-right of the connections table.
  </Step>

  <Step title="Link generated and copied">
    A unique link is automatically generated and copied to your clipboard. You'll
    see a success message confirming this.
  </Step>

  <Step title="Share with external">
    Send the link via email, Slack, or your preferred communication channel.
  </Step>

  <Step title="External authenticates">
    When they click the link, they'll be guided through the authentication flow to connect their own account. You'll receive an email with confirmation.
  </Step>
</Steps>

<Info>
  **Link expiration:** Authentication links are valid for 7 days. After that,
  you'll need to generate a new link.
</Info>

<Tip>
  **Use case:** Perfect for sending over to your clients, avoiding requests for
  admin priviliges on datasources.
</Tip>

***

## Archiving Connections

Archive connections you're no longer actively using to keep your workspace organized.

### When to Archive

Consider archiving when:

* A client project has ended
* You've replaced the connection with a new one
* The account is no longer accessible
* You want to declutter without permanently deleting

### How to Archive

<Steps>
  <Step title="Open connection menu">
    Click the three-dot menu (⋮) on the connection you want to archive.
  </Step>

  <Step title="Select 'Archive connection'">
    Click **"Archive connection"** from the dropdown menu.
  </Step>

  <Step title="Confirm archive">
    The connection will be moved to archived status and hidden from the main view.
  </Step>
</Steps>

### Viewing Archived Connections

<Steps>
  <Step title="Expand the data source">
    Click on the platform card that contains archived connections.
  </Step>

  <Step title="Show archived toggle">
    If you have more than 5 connections for that platform and some are archived,
    you'll see a checkbox at the top of the table: "Show archived connections".
  </Step>

  <Step title="Enable the toggle">
    Check the box to reveal archived connections alongside active ones.
  </Step>
</Steps>

### Unarchiving a Connection

1. Show archived connections using the toggle
2. Find the archived connection
3. Click the three-dot menu (⋮)
4. Select **"Unarchive connection"**
5. The connection returns to active status

<Warning>
  **Queries remain linked:** Archiving a connection doesn't remove it from
  scheduled queries. If a query is still using an archived connection, it will
  continue to work but you might want to update it to use an active connection.
</Warning>

***

## Viewing Associated Accounts

For platforms that support multiple accounts (like Facebook Ads or Google Ads), view detailed information about all accounts associated with a connection.

### Accessing Account Details

<Steps>
  <Step title="Expand the data source">
    Click the platform card to view its connections.
  </Step>

  <Step title="Click the accounts badge">
    In the "Accounts" column, click the badge showing the number of accounts
    (e.g., "5 accounts").
  </Step>

  <Step title="View account information">
    A dialog opens displaying:

    * Account names
    * Account IDs
    * Account status (active, missing, etc.)
    * Which accounts are being used in active queries
  </Step>
</Steps>

### Understanding Account Status

<AccordionGroup>
  <Accordion title="Active Accounts">
    Accounts currently available and accessible through the connection. These can be used in queries.
  </Accordion>

  <Accordion title="Missing Accounts">
    Accounts that were previously available but are no longer accessible. This happens when:

    * Access was revoked on the platform
    * The account was deleted
    * Permissions changed

    <Info>
      **What to do:** Reconnect the data source or contact the account owner to restore access.
    </Info>
  </Accordion>

  <Accordion title="Active in Queries">
    The modal highlights which accounts are actively being used in your scheduled queries, helping you understand dependencies before making changes.
  </Accordion>
</AccordionGroup>

<Tip>
  **No accounts showing?** If you've just connected, it can take a few minutes
  for the platform to sync and load accounts. Refresh the page after a short
  wait.
</Tip>

***

## Connecting New Data Sources

Connect additional platforms that you haven't used yet in your workspace.

### Available Data Sources

Scroll down past your connected data sources to see the **"Connect to new data source"** section. This displays all Detrics connectors you haven't connected yet.

### Connecting a New Source

<Steps>
  <Step title="Find the platform">
    Browse or search for the data source you want to connect.
  </Step>

  <Step title="Click the platform card">
    Click anywhere on the card for the platform you want to connect.
  </Step>

  <Step title="Authenticate">
    You'll be redirected to the platform's login page. Sign in with your
    credentials.
  </Step>

  <Step title="Grant permissions">
    Approve Detrics' access request to allow data retrieval.
  </Step>

  <Step title="Connection created">
    Your new connection appears in the "Connected data sources" section and is ready to use in queries.
  </Step>
</Steps>

<Note>
  **Supported platforms:** Detrics supports 30+ data sources including Google
  Ads, Facebook Ads, LinkedIn Ads, TikTok Ads, Instagram Insights, Google
  Analytics 4, Shopify, Stripe, and more.
</Note>

***

## Troubleshooting

<AccordionGroup>
  <Accordion title="Connection shows 'No Access'">
    This means the connection is restricted and hasn't been shared with you. Contact the connection owner (shown in "Added by") or your workspace administrator to request access.
  </Accordion>

  <Accordion title="Accounts not loading">
    If you see "No accounts" after connecting: 1. Wait a few minutes for the
    platform to sync 2. Refresh the page 3. If still no accounts appear, try
    reconnecting 4. Contact support if the issue persists
  </Accordion>

  <Accordion title="Can't find a connection">
    * Use the search bar to search by name, email, or ID - Check if the connection
      is archived (enable "Show archived connections") - Verify you're looking at
      the correct data source platform - Confirm the connection wasn't deleted by
      another team member
  </Accordion>

  <Accordion title="Reconnection fails">
    If reconnection doesn't work: - Ensure you're using the same credentials as
    the original connection - Clear your browser cache and cookies - Check if you
    have the necessary permissions on the source platform - Contact
    [support@detrics.io](mailto:support@detrics.io) if problems continue
  </Accordion>

  <Accordion title="Connection replacement not available">
    Connection replacement is not available for single-account platforms:

    * Stripe
    * Shopify
    * TiendaNube
    * WooCommerce

    For these platforms, you'll need to create a new connection and manually update your queries.
  </Accordion>
</AccordionGroup>

***

## Next Steps

Now that you understand how to manage connections, learn about:

* **[Shared and private connections](/workspace/shared-private-connections)** - Understand roles, permissions, and collaboration features
* **[How to automate a query](/data-destination/google-sheets/how-to-automate-a-query)** - Use your connections in scheduled queries

<Tip>
  **Need help?** If you have questions about connection management, reach out to
  [support@detrics.io](mailto:support@detrics.io) or use the chat widget in the bottom-right corner.
</Tip>