Google Merchant Center Integration

Connect your Google Merchant Center account to enable feed submission, performance monitoring, and account management.

Overview

The Google Merchant Center integration provides:

OAuth Connection: Secure Google account linking
Multi-Account Support: Manage multiple Merchant Center accounts
Performance Metrics: Real-time impressions, clicks, CTR, conversions
Account Status: Monitor GMC account health
Feed Management: Create and manage feeds directly

OAuth Connection

Connection Flow

Click "Connect to Google" in Setup Guide or Settings

Select your Google account in the popup

Grant permissions for Merchant Center access

Tokens stored securely, connection established

Required OAuth Scopes

Scope	Purpose
`https://www.googleapis.com/auth/content`	Merchant Center API access
`https://www.googleapis.com/auth/userinfo.email`	User email
`https://www.googleapis.com/auth/userinfo.profile`	User profile

Token Management

Access Token: Short-lived (1 hour), used for API calls
Refresh Token: Long-lived, used to obtain new access tokens
Auto-Refresh: Tokens automatically refreshed when expired

Multi-Account Support

MCA (Multi-Client Account)

If your Google account has access to multiple Merchant Center accounts:

The app automatically detects all sub-accounts
Select the target account from the dropdown
Each account shows its status independently

Account Selection

On the dashboard:

Use the account selector to switch between accounts
View metrics for the selected account
Create feeds for any connected account

Performance Metrics

Available Metrics

Metric	Description
Impressions	Number of times products appeared
Clicks	Number of clicks on products
Click-Through Rate	Clicks / Impressions
Conversions	Number of conversions attributed
Conversion Value	Total value of conversions
Conversion Rate	Conversions / Clicks

Filtering Options

Date Range: Last 7 days, Last 28 days, Custom
Channel: All traffic, Shopping Ads, Free Listings

Trend Comparison

Metrics show comparison with the previous period:

Green arrow: Improvement
Red arrow: Decline
Percentage change displayed

Account Status

Status Types

Status	Description	Action
Active	Account healthy	None required
Warning	Issues detected	Review and fix
Suspended	Account suspended	Immediate action required

Common Issues

Missing Tax Settings: Configure tax in Merchant Center
Missing Shipping: Set up shipping rates
Website Claim: Verify website ownership
Product Disapprovals: Fix product data issues

Feed Types in GMC

Primary Feed

Main data source for products
Contains all required attributes
Can be fetched automatically or uploaded

Supplemental Feed

Updates specific attributes
Must link to Primary Feed
Useful for price/inventory updates

Local Inventory Feed

Reports local store inventory
Enables local product ads
Requires location mapping

API Integration

Merchant API v1beta

The app uses Google's Merchant API for:

Data Sources: List and manage feeds
Products: View product status
Reports: Fetch performance metrics
Accounts: Check account status

Rate Limiting

Automatic retry with exponential backoff
Respects Retry-After headers
Maximum 3 retries per request

Troubleshooting

Connection Issues

Issue	Solution
OAuth failed	Check Google Cloud Console configuration
Token expired	Reconnect Google account
Permission denied	Verify Merchant Center access
Account not found	Ensure account exists and is accessible

API Errors

Error	Solution
403 Forbidden	Check API permissions
404 Not Found	Verify account ID
429 Rate Limited	Wait and retry
500 Server Error	Retry later

Metrics Not Loading

Issue	Solution
No data	Wait for data collection (24-48 hours)
Wrong dates	Check date range format
Empty results	Verify products are approved

Disconnecting

To disconnect your Google account:

Go to Settings > General
Click "Disconnect Google Account"
Confirm the disconnection

Disconnecting will:

Remove stored OAuth tokens
Stop automatic feed sync
Preserve existing feed files

Google Merchant Center Integration

On this page