List Report Fields

The List Report Fields node retrieves the complete schema of available metrics and dimensions for Google Merchant Center reporting. Essential for discovering reportable fields and building custom reports. This is an AI-powered node that can understand natural language instructions.

When to Use It

Discover available reporting metrics and dimensions
Build custom report configurations
Understand field definitions and data types
Find specific fields for targeted analysis
Validate field names before creating reports
Explore new reporting capabilities
Document available reporting schema

Inputs

Field	Type	Required	Description
Field Type Filter	Multi-select	No	Filter by field type (metric/dimension)
Search Terms	Text	No	Keywords to search field names or descriptions
Category Filter	Multi-select	No	Filter by field category

Field Type Options

Type	Description	Use Case
Metrics	Measurable values (clicks, revenue)	Performance analysis
Dimensions	Descriptive attributes (product, date)	Data segmentation
Both	All available fields	Complete schema discovery

Field Categories

Category	Description	Example Fields
Performance	Traffic and engagement metrics	Clicks, Impressions, CTR
Financial	Revenue and cost metrics	Revenue, Cost, ROAS
Product	Product-specific attributes	Product ID, Brand, Category
Geographic	Location-based dimensions	Country, Region, City
Temporal	Time-based dimensions	Date, Week, Month
Campaign	Shopping campaign data	Campaign, Ad Group

Output

Returns comprehensive field schema information:

{
  "report_fields": [
    {
      "field_id": "clicks",
      "field_name": "Clicks",
      "field_type": "metric",
      "data_type": "integer",
      "category": "performance",
      "description": "Number of clicks on your products in Shopping ads",
      "is_filterable": true,
      "is_sortable": true,
      "compatibility": ["all_reports"],
      "example_values": ["1234", "5678", "9012"]
    },
    {
      "field_id": "impressions",
      "field_name": "Impressions", 
      "field_type": "metric",
      "data_type": "integer",
      "category": "performance",
      "description": "Number of times your products were shown in Shopping ads",
      "is_filterable": true,
      "is_sortable": true,
      "compatibility": ["all_reports"],
      "example_values": ["12340", "56780", "90120"]
    },
    {
      "field_id": "product_title",
      "field_name": "Product Title",
      "field_type": "dimension",
      "data_type": "string",
      "category": "product",
      "description": "The title of the product as it appears in your product feed",
      "is_filterable": true,
      "is_sortable": true,
      "compatibility": ["product_performance", "shopping_performance"],
      "example_values": ["iPhone 15 Pro", "Samsung Galaxy S24", "Nike Air Max"]
    },
    {
      "field_id": "conversion_value",
      "field_name": "Conversion Value",
      "field_type": "metric",
      "data_type": "currency",
      "category": "financial",
      "description": "Total value of conversions attributed to your products",
      "is_filterable": true,
      "is_sortable": true,
      "compatibility": ["all_reports"],
      "example_values": ["1999.99", "599.50", "299.00"]
    },
    {
      "field_id": "date",
      "field_name": "Date",
      "field_type": "dimension",
      "data_type": "date",
      "category": "temporal",
      "description": "The date for which the data is reported",
      "is_filterable": true,
      "is_sortable": true,
      "compatibility": ["all_reports"],
      "example_values": ["2024-03-15", "2024-03-14", "2024-03-13"]
    }
  ],
  "summary": {
    "total_fields": 5,
    "total_metrics": 3,
    "total_dimensions": 2,
    "categories": {
      "performance": 2,
      "financial": 1,
      "product": 1,
      "temporal": 1
    }
  },
  "field_compatibility": {
    "all_reports": ["clicks", "impressions", "conversion_value", "date"],
    "product_performance": ["product_title"],
    "shopping_performance": ["product_title"]
  }
}

Field Properties:

Property	Description
field_id	Unique identifier for API usage
field_name	Human-readable field name
field_type	Metric or dimension classification
data_type	Data format (integer, string, currency, date)
category	Functional grouping
description	Detailed field explanation
is_filterable	Can be used in report filters
is_sortable	Can be used for report sorting
compatibility	Which reports support this field
example_values	Sample data for understanding

Credit Cost

Cost per run: 0 credits (Free)

Common Workflows

Report Planning:

[List Report Fields] → [Select Relevant Fields] → [Plan Report Structure] → [Build Custom Report]

Field Discovery:

[List Report Fields] → [Search by Keywords] → [Review Field Definitions] → [Document Schema]

Report Validation:

[List Report Fields] → [Validate Field Names] → [Check Compatibility] → [Fix Report Configuration]

Schema Documentation:

[List Report Fields] → [Export Field List] → [Generate Documentation] → [Share with Team]

Field Categories

Performance Metrics

Traffic and engagement measurements:

Clicks: Product clicks in Shopping ads
Impressions: Times products were shown
CTR: Click-through rate percentage
Position: Average ad position
View-through Conversions: Indirect conversions

Financial Metrics

Revenue and cost measurements:

Conversion Value: Total conversion revenue
Cost: Total advertising cost
CPC: Cost per click
ROAS: Return on ad spend
Revenue: Total sales revenue

Product Dimensions

Product-specific attributes:

Product ID: Unique product identifier
Product Title: Product name
Brand: Product brand/manufacturer
Category: Product category
Product Type: Your product classification

Geographic Dimensions

Location-based segmentation:

Country: Country where ad was shown
Region: Geographic region
City: City location
Metro Area: Metropolitan area

Temporal Dimensions

Time-based analysis:

Date: Daily breakdown
Week: Weekly aggregation
Month: Monthly view
Quarter: Quarterly analysis
Year: Annual comparison

Use Cases

Custom Report Building

Design targeted analysis reports:

- Search for performance metrics
- Find relevant product dimensions
- Check field compatibility
- Build optimized report structure

Data Exploration

Discover available data points:

- Browse all available fields
- Understand data types and formats
- Explore new reporting capabilities
- Plan advanced analysis workflows

Report Troubleshooting

Fix report configuration issues:

- Validate field names and IDs
- Check field compatibility
- Understand filtering limitations
- Resolve data type conflicts

Team Training

Educate team on available data:

- Generate field documentation
- Share field definitions and examples
- Explain reporting capabilities
- Standardize field usage across team

Field Selection Guide

For Performance Analysis:

Essential metrics:

clicks - Traffic measurement
impressions - Visibility tracking
ctr - Efficiency metric
conversions - Success measurement
conversion_rate - Performance indicator

For Financial Analysis:

Revenue-focused metrics:

conversion_value - Total revenue
cost - Advertising spend
roas - Return on investment
cpc - Cost efficiency
revenue_per_click - Value metric

For Product Analysis:

Product-specific dimensions:

product_title - Product identification
brand - Brand performance
category - Category analysis
product_type - Classification
condition - Product condition

For Trend Analysis:

Time-based dimensions:

date - Daily trends
week - Weekly patterns
month - Monthly comparison
quarter - Seasonal analysis
year - Annual trends

Search and Filter Tips

Effective Search Strategies:

Use specific keywords related to your analysis needs
Search by category to find related fields
Look for field descriptions to understand data meaning
Check compatibility before using fields in reports

Common Search Terms:

“conversion” - Find all conversion-related metrics
“product” - Discover product attribute dimensions
“cost” - Locate financial metrics
“date” - Find temporal dimensions
“brand” - Identify brand-related fields

Documentation Index

​When to Use It

​Inputs

​Field Type Options

​Field Categories

​Output

​Field Properties:

​Credit Cost

​Common Workflows

​Field Categories

​Performance Metrics

​Financial Metrics

​Product Dimensions

​Geographic Dimensions

​Temporal Dimensions

​Use Cases

​Custom Report Building

​Data Exploration

​Report Troubleshooting

​Team Training

​Field Selection Guide

​For Performance Analysis:

​For Financial Analysis:

​For Product Analysis:

​For Trend Analysis:

​Search and Filter Tips

​Effective Search Strategies:

​Common Search Terms:

​Filter Applications:

​Tips

When to Use It

Inputs

Field Type Options

Field Categories

Output

Field Properties:

Credit Cost

Common Workflows

Field Categories

Performance Metrics

Financial Metrics

Product Dimensions

Geographic Dimensions

Temporal Dimensions

Use Cases

Custom Report Building

Data Exploration

Report Troubleshooting

Team Training

Field Selection Guide

For Performance Analysis:

For Financial Analysis:

For Product Analysis:

For Trend Analysis:

Search and Filter Tips

Effective Search Strategies:

Common Search Terms:

Filter Applications:

Tips