> ## 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. # List Report Fields > Browse all available Google Merchant Center reporting schema: metrics and dimensions 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: ```json theme={"dark"} { "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 ### Filter Applications: * **Filter by metric type** for performance analysis * **Filter by dimension type** for segmentation * **Filter by category** for focused discovery * **Filter by compatibility** for specific report types *** ## Tips **Field Discovery:** * **Explore regularly** - new fields are added periodically * **Use search function** to quickly find relevant fields * **Read descriptions carefully** to understand data meaning * **Note compatibility requirements** for report building **Report Planning:** * **Start with key metrics** then add supporting dimensions * **Check field compatibility** before finalizing report structure * **Consider data types** when planning filters and calculations * **Document field choices** for team consistency **Best Practices:** * **Use field IDs** in API calls for consistency * **Validate field availability** before building automated reports * **Keep field lists updated** as new fields become available * **Share field knowledge** across your team **Integration Strategy:** * **Reference field schema** when building reports * **Use for report validation** and troubleshooting * **Combine with actual reporting** for complete workflows * **Document field usage** for future reference