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

# Get PMax Channel Split Report

> Generates Performance Max campaign reports split by advertising channels

Generates Performance Max campaign reports split by advertising channels

|                     |                                      |
| ------------------- | ------------------------------------ |
| **App**             | Google Ads                           |
| **Operation ID**    | `gads_get_pmax_channel_split_report` |
| **Type**            | Action                               |
| **Connection**      | `gads` (required)                    |
| **Credits per run** | 1                                    |

## Inputs

| Field        | Type                                          | Required | Default | Description                        |
| ------------ | --------------------------------------------- | -------- | ------- | ---------------------------------- |
| `account`    | array (also accepts a comma-separated string) | Yes      | -       |                                    |
| `date_range` | DateRange                                     | Yes      | -       |                                    |
| `metrics`    | array of string or SelectableOption           | Yes      | -       |                                    |
| `dimensions` | array of string or SelectableOption           | No       | -       |                                    |
| `filters`    | array of FilterItem                           | No       | -       |                                    |
| `orders`     | array of OrderItem                            | No       | -       |                                    |
| `limit`      | integer                                       | No       | `1000`  |                                    |
| `options`    | ReportOptions                                 | No       | -       | Additional options for the report. |

### DateRange

| Field     | Type           | Required | Default | Description                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
| --------- | -------------- | -------- | ------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `start`   | string         | No       | -       | The start date of the date range to query, format: YYYY-MM-DD or dynamic node reference like \{\{nodeId\_\_data.start\_date}}. Required when preset is 'FIXED' or 'CUSTOM'.                                                                                                                                                                                                                                                                                                   |
| `end`     | string         | No       | -       | The end date of the date range to query, format: YYYY-MM-DD or dynamic node reference like \{\{nodeId\_\_data.end\_date}}. Required when preset is 'FIXED' or 'CUSTOM'.                                                                                                                                                                                                                                                                                                       |
| `preset`  | string         | No       | -       | Predefined date ranges or input modes: - Use 'FIXED' or leave empty when you want to specify exact dates (YYYY-MM-DD format) in start/end fields - Use 'CUSTOM' when you want to use dynamic values from other nodes (\{\{nodeId\_\_data.start\_date}} format) in start/end fields - Use other presets (TODAY, YESTERDAY, LAST\_7\_DAYS, etc.) for predefined date ranges (start/end will be ignored) When using 'FIXED' or 'CUSTOM', both start and end fields are required. |
| `compare` | CompareOptions | No       | -       | Optional comparison date range settings. ALWAYS use this field for comparisons; DO NOT create additional requests or nodes, as the backend returns current, comparison, and delta metrics in a single call.                                                                                                                                                                                                                                                                   |

### FilterItem

| Field      | Type                       | Required | Default | Description                                                                                                                                                   |
| ---------- | -------------------------- | -------- | ------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `field`    | string or SelectableOption | Yes      | -       | The field to filter on, must be one of the current selected metrics or dimensions.                                                                            |
| `operator` | string                     | Yes      | -       | The operator to use for filtering. Must be one of the supported values. Use REGEXP\_MATCH to search/filter by multiple OR values like '.*(summer\|holiday).*' |
| `value`    | string                     | Yes      | -       | The value to filter by. Can be a string, number, regex, or a list of strings.                                                                                 |

### OrderItem

| Field       | Type                       | Required | Default | Description                                                                      |
| ----------- | -------------------------- | -------- | ------- | -------------------------------------------------------------------------------- |
| `field`     | string or SelectableOption | Yes      | -       | The field to sort by. must be one of the current selected metrics or dimensions. |
| `direction` | string                     | Yes      | -       | The order to sort by, must be one of 'ASC', 'DESC'                               |

### ReportOptions

| Field                      | Type            | Required | Default | Description                                                                                                                      |
| -------------------------- | --------------- | -------- | ------- | -------------------------------------------------------------------------------------------------------------------------------- |
| `pretty_column_names`      | boolean         | No       | -       | whether to use pretty column names in the report (e.g., 'Clicks' instead of 'clicks').                                           |
| `show_percent_sign`        | boolean         | No       | -       | whether to show percent sign for percentage metrics (e.g., '58%' instead of '0.58').                                             |
| `currency_symbol`          | string          | No       | -       | the currency symbol to use for monetary values (e.g., '\$').                                                                     |
| `compact_numbers`          | boolean         | No       | -       | whether to use compact number format (e.g., '1K') and round decimals. Takes priority over thousand\_separators.                  |
| `thousand_separators`      | boolean         | No       | -       | whether to format numbers with thousand separators (e.g., '105,878') and round decimals. Ignored if compact\_numbers is enabled. |
| `pivot_dimensions`         | array of string | No       | -       | the dimensions to pivot the report on. Must be one of the current selected dimensions.                                           |
| `include_zero_impressions` | boolean         | No       | -       | whether to include zero impressions in the report.                                                                               |

### SelectableOption

| Field   | Type   | Required | Default | Description |
| ------- | ------ | -------- | ------- | ----------- |
| `value` | string | Yes      | -       |             |
| `label` | string | Yes      | -       |             |

### CompareOptions

| Field                   | Type   | Required | Default      | Description                                                                                                                                                                                                                                               |
| ----------------------- | ------ | -------- | ------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `start`                 | string | No       | -            | The start date of the comparison range, format: YYYY-MM-DD. Optional if preset is provided.                                                                                                                                                               |
| `end`                   | string | No       | -            | The end date of the comparison range, format: YYYY-MM-DD. Optional if preset is provided.                                                                                                                                                                 |
| `preset`                | string | No       | -            | Predefined comparison ranges. When provided, start and end will be ignored.                                                                                                                                                                               |
| `comparison_format`     | string | No       | `rows`       | Comparison output layout: 'rows' returns separate rows for current, comparison, and delta along with date ranges; 'columns' returns a single row with delta values only as additional \*\_pct or \*\_change columns depending on comparison\_value\_type. |
| `comparison_value_type` | string | No       | `percentage` | Value type: 'percentage' or 'absolute'                                                                                                                                                                                                                    |

## Output

**Type**: `List[Dict]`

Returns channel-split performance data.

**Fields**: dynamic (depend on the inputs)
