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.
The Get Report node retrieves comprehensive performance data from Google Merchant Center with customizable metrics, dimensions, filters, and date ranges. Perfect for product performance analysis, conversion tracking, and revenue optimization. This is an AI-powered node that can understand natural language instructions.
When to Use It
- Analyze product performance and shopping campaigns
- Track clicks, impressions, conversions, and revenue
- Monitor product search performance
- Generate custom performance reports
- Analyze trends over time periods
- Compare product performance across dimensions
- Create automated reporting dashboards
| Field | Type | Required | Description |
|---|
| Account | Dropdown | Yes | Google Merchant Center account to query |
| Metrics | Multi-select | Yes | Performance metrics to retrieve |
| Dimensions | Multi-select | No | Data breakdown dimensions |
| Date Range | Date Picker | Yes | Time period for the report |
| Filters | Filter Builder | No | Conditions to filter the data |
| Sort | Dropdown | No | How to sort the results |
| Limit | Number | No | Maximum number of rows to return |
Available Metrics
| Metric | Description | Use Case |
|---|
| Clicks | Number of product clicks | Traffic analysis |
| Impressions | Product impression count | Visibility tracking |
| CTR | Click-through rate | Performance efficiency |
| Conversions | Conversion events | Sales tracking |
| Conversion Value | Revenue from conversions | Revenue analysis |
| Cost | Advertising cost | Budget tracking |
| CPC | Cost per click | Bid optimization |
| ROAS | Return on ad spend | ROI analysis |
Available Dimensions
| Dimension | Description | Use Case |
|---|
| Product | Individual products | Product-level analysis |
| Brand | Product brands | Brand performance |
| Category | Product categories | Category analysis |
| Country | Geographic location | Regional performance |
| Device | Device type | Device targeting |
| Date | Time periods | Trend analysis |
| Channel | Shopping channel | Channel comparison |
| Campaign | Campaign names | Campaign performance |
Date Range Options
| Option | Description | Use Case |
|---|
| Last 7 days | Recent week | Short-term trends |
| Last 30 days | Recent month | Monthly analysis |
| Last 90 days | Quarterly view | Seasonal trends |
| Last 12 months | Annual view | Year-over-year comparison |
| Custom Range | Specific dates | Targeted analysis |
| Compare Periods | Period comparison | Performance changes |
Output
Returns detailed performance data:
{
"report_data": [
{
"product_title": "Apple iPhone 15 Pro 128GB",
"product_id": "online:en:US:12345",
"brand": "Apple",
"category": "Electronics > Mobile Phones",
"country": "US",
"date": "2024-03-15",
"clicks": 2847,
"impressions": 45230,
"ctr": 6.29,
"conversions": 127,
"conversion_value": 126873.00,
"cost": 8945.23,
"cpc": 3.14,
"roas": 14.18,
"currency": "USD"
},
{
"product_title": "Samsung Galaxy S24 256GB",
"product_id": "online:en:US:67890",
"brand": "Samsung",
"category": "Electronics > Mobile Phones",
"country": "US",
"date": "2024-03-15",
"clicks": 1923,
"impressions": 38476,
"ctr": 5.00,
"conversions": 89,
"conversion_value": 78452.00,
"cost": 6234.56,
"cpc": 3.24,
"roas": 12.59,
"currency": "USD"
}
],
"summary": {
"total_rows": 2,
"total_clicks": 4770,
"total_impressions": 83706,
"average_ctr": 5.70,
"total_conversions": 216,
"total_conversion_value": 205325.00,
"total_cost": 15179.79,
"average_cpc": 3.18,
"average_roas": 13.52
},
"date_range": {
"start_date": "2024-03-15",
"end_date": "2024-03-15"
},
"account_info": {
"account_id": "123456789",
"account_name": "Main Store GMC"
}
}
Report Fields:
| Field | Description |
|---|
| Product Info | Product title, ID, brand, category |
| Performance Metrics | Clicks, impressions, CTR, conversions |
| Financial Metrics | Revenue, cost, CPC, ROAS |
| Dimensions | Geographic, temporal, device breakdowns |
| Summary Stats | Aggregated totals and averages |
Credit Cost
Common Workflows
Performance Dashboard:
[Select Accounts] → [Get Report] → [Calculate KPIs] → [Generate Dashboard] → [Schedule Updates]
[Get Report] → [Identify Low Performers] → [Get Price Suggestions] → [Optimize Listings]
[Get Report - Period 1] → [Get Report - Period 2] → [Compare Performance] → [Identify Trends]
[Get Report] → [Calculate ROAS] → [Filter Profitable Products] → [Scale Campaigns]
Report Types
Track individual product metrics:
Dimensions: Product, Brand, Category
Metrics: Clicks, Conversions, Revenue, ROAS
Use Case: Product-level optimization
Dimensions: Country, Region, City
Metrics: Impressions, Clicks, Conversion Value
Use Case: Geographic targeting optimization
Trend Analysis Report
Monitor performance over time:
Dimensions: Date, Week, Month
Metrics: All key performance indicators
Use Case: Seasonal analysis and forecasting
Brand Comparison Report
Compare brand performance:
Dimensions: Brand, Product Category
Metrics: Market Share, Revenue, Profitability
Use Case: Brand strategy and positioning
Dimensions: Campaign, Ad Group, Product
Metrics: Cost, Conversions, ROAS, CPC
Use Case: Campaign optimization and budget allocation
Analysis Examples
Metrics: Conversions, Conversion Value, ROAS
Dimensions: Product, Brand
Sort: Conversion Value (Descending)
Limit: 50
Filter: ROAS > 3.0
Metrics: CTR, Conversion Rate, ROAS
Dimensions: Category, Brand
Sort: ROAS (Ascending)
Filter: Impressions > 1000 AND ROAS < 2.0
Seasonal Trends
Metrics: Clicks, Conversions, Revenue
Dimensions: Date, Product Category
Date Range: Last 12 months
Filter: Category contains "Holiday"
Metrics: Clicks, Conversions, Revenue
Dimensions: Device, Product Category
Date Range: Last 30 days
Compare: Mobile vs Desktop performance
Tips
Report Configuration:
- Start with key metrics (clicks, conversions, revenue) then add specific metrics
- Use dimensions strategically - too many can make data hard to analyze
- Apply date ranges that match your business cycles
- Filter data to focus on relevant segments
Performance Analysis:
- Look for trends rather than single-day fluctuations
- Compare periods to identify changes and opportunities
- Segment by dimensions to find specific insights
- Monitor ROAS closely for profitability tracking
Data Interpretation:
- High impressions + low clicks = visibility issues or poor product appeal
- High clicks + low conversions = landing page or pricing issues
- Good ROAS = successful products worth scaling
- Low CTR = need better product titles/images
Optimization Strategy:
- Identify top performers and increase their visibility
- Find underperformers and optimize or pause them
- Analyze seasonality for better inventory planning
- Track competitor impacts through performance changes
Workflow Integration:
- Combine with product data for comprehensive analysis
- Use with price benchmarks for competitive insights
- Feed into automated optimization workflows
- Schedule regular reports for ongoing monitoring
