Common Issues

Connection issues

My channel isn't showing in the channel selector

This happens when your Google account doesn't have the right access to the YouTube channel. Check the following:

1. Sign in with the correct account — Make sure you're signing in with a Google account that has owner or manager access to the YouTube channel. If you manage channels for clients, use their account (or have them grant you access through YouTube's sharing settings).

2. Check YouTube access roles — In YouTube Studio, go to Settings > Permissions to verify your account has editing rights.

3. Reconnect the source — Disconnect and reconnect the YouTube source in Coupler.io to refresh the channel list.

4. Secondary channels — If the channel is a secondary channel on your account, ensure it's linked properly in YouTube. Go to YouTube Studio > Settings > Basic info and verify the channel appears in your account.

If the channel still doesn't appear after these steps, YouTube may have a sync delay. Wait a few minutes and try reconnecting.

"Access denied" or permission error when connecting

YouTube requires specific permissions to share analytics data with Coupler.io. When you click "Sign in with Google," make sure to:

1. Grant all requested permissions — Don't skip or deny any permission prompts. Coupler.io needs access to YouTube Analytics data.

2. Use the right account — Ensure you're signed in to the Google account associated with your YouTube channel.

3. Clear browser cache — If you've previously denied permissions, clear your browser cookies and cache, then try connecting again.

If you're still seeing an error, your account may have restricted API access. Check YouTube's API access settings in your Google account's security dashboard.

I see "Failed to fetch channels" error

This typically indicates a temporary issue with YouTube's API. Try these steps:

1. Wait and retry — YouTube API can have brief outages. Wait 5-10 minutes and try connecting again.

2. Reconnect the source — Disconnect the YouTube source in Coupler.io and create a new connection.

3. Check YouTube status — Visit the Google Workspace Status Dashboard to confirm YouTube Analytics API is operational.

4. Verify API quota — If you have many YouTube accounts connected to Coupler.io, you may have exceeded API quota. Contact Coupler.io support if you suspect quota limits.

Missing data

Recent data (last 2-3 days) is missing from my report

YouTube Analytics has a processing delay. Data is typically available within 48 hours of when it's generated. This is a YouTube limitation, not a Coupler.io issue.

If you need near-real-time data:

• Consider using YouTube's real-time reporting in YouTube Studio for immediate insights

• Schedule Coupler.io reports to run 2+ days after the report end date to ensure data is available

• Use a date picker and manually set an end date that's 2+ days in the past if you need accurate same-day data

I'm seeing zeros for a metric I expect to have data

Some metrics only have data when certain conditions are met:

1. Card and annotation metrics — These only populate if you've added cards or annotations to your videos. If you haven't used these features, metrics like "Card clicks" and "Annotation click-through rate" will show zero.

2. Premium metrics — YouTube Premium metrics only appear if your channel is part of the YouTube Partner Program and has Premium member views.

3. Subscriber data — The "Subscribers gained" metric requires viewers to be logged in; unlogged viewers won't be counted.

4. Age and gender — These show "not specified" for a large portion of traffic if viewers aren't logged in.

5. Traffic source detail — Some traffic sources (e.g., "YouTube Search") only appear if traffic from that source exists in the report period.

This is expected behavior and not a data issue.

Data in Coupler.io doesn't match YouTube Studio

Small discrepancies (1-5%) are normal due to rounding and report timing. Larger differences can occur for these reasons:

1. Report period and data processing — YouTube Studio shows real-time estimates, while Coupler.io pulls finalized historical data. Give it 48 hours for full data availability.

2. Dimension filtering — If you've added dimensions (age, country, device), YouTube excludes rows with low traffic volumes (to protect viewer privacy). Coupler.io will show only the data YouTube provides.

3. Content type classification — Videos may be recategorized by YouTube over time. Ensure you're comparing the same date range in both places.

4. Metric compatibility — Some metrics are only available with certain dimension combinations. Verify your custom report isn't requesting an incompatible combination.

For large unexplained discrepancies (>10%), contact Coupler.io support with the specific metric and date range.

My video published date or video ID is missing

YouTube Analytics doesn't include video metadata like publish date, title, or duration. The Video dimension only includes the video title and ID, which you can use to look up additional details in YouTube Studio.

To enrich your data with publish dates:

• Use Coupler.io's Join transformation to combine YouTube Analytics with a custom data source containing video metadata

• Manually add a "Publish date" column in your destination and populate it with dates from YouTube Studio

Permission errors

"You don't have permission to access this resource"

This error means your YouTube account doesn't have the required access level. Here's how to fix it:

1. Verify ownership or manager role — In YouTube Studio, go to Settings > Permissions. You need "Owner" or "Manager" role to share data with Coupler.io.

2. Request access — If you manage the channel for someone else, ask the channel owner to grant you Manager access through YouTube's sharing feature.

3. Use the channel owner's account — If you can't get manager access, have the channel owner sign in to Coupler.io and create the data flow themselves.

YouTube doesn't allow read-only roles (like "Moderator") to access Analytics. You must have editing rights.

Data discrepancies

Views or watch time is higher/lower than expected in a specific report

Before investigating, confirm:

1. Check the date range — Make sure the report is using the correct start and end dates. Use the date picker or verify macro values (e.g., {{30daysago}}).

2. Confirm dimension compatibility — Some metric-dimension combinations may exclude low-traffic data. For example, if you're segmenting by age and gender, YouTube filters out rows with very small audience sizes.

3. Verify split setting — If you've enabled "Split data by period" (day or month), each row represents a smaller time slice. Total views will look lower in individual daily rows than in a monthly aggregate.

4. Check additional dimensions — If you've added extra dimensions for breakdown, traffic may be spread across many rows, making individual row values small.

If numbers still don't match YouTube Studio after confirming the above, wait 48 hours for full data processing and re-run the report.

I'm getting data type mismatch errors when writing to my destination

This happens when YouTube returns an unexpected data type that doesn't fit your destination's column. Common causes:

1. Numeric metrics in text columns — Metrics like views and watch time are numbers, but if your destination column is formatted as text, it may reject the data. Ensure destination columns are set to Number format.

2. NULL or "0" values — YouTube sometimes returns empty values for zero metrics. Ensure your destination columns allow NULL or 0 values.

3. Large numbers exceeding limits — If a metric exceeds your destination's column size limit, try widening the column or using a bigger numeric type (e.g., BigInt).

Fix this by:

• Checking the destination column format (should match the metric type)

• Clearing old data and re-running the flow

• Using Coupler.io's field mapping to cast columns to the correct type

Rate limits

I'm hitting YouTube API quota limits

YouTube Analytics API has quota limits per project. If you're running many data flows from multiple channels or accounts, you may exceed your quota.

Signs of quota exhaustion:

• Errors like "quota exceeded" or "rate limit exceeded"

• Flows work intermittently but fail during peak times

• Multiple data flows failing simultaneously

To resolve:

1. Space out scheduled runs — If you have 5+ YouTube data flows, stagger their schedules so they don't all run at the same time. For example, run Channel A at 9 AM, Channel B at 10 AM, etc.

2. Reduce data flow frequency — Consider running reports daily instead of hourly, or only during low-traffic periods.

3. Consolidate channels — If possible, use custom reports to pull data from multiple channels in a single flow instead of creating separate flows per channel.

4. Contact support — If you have a legitimate business need for high-frequency reports, Coupler.io support may be able to help optimize your setup or request additional quota from Google.

YouTube API quota resets daily at midnight UTC.

Data flow fails with "Request was denied" error

This can indicate a quota or permission issue on YouTube's side. Try these steps:

1. Verify connection is still valid — Your YouTube auth token may have expired. Disconnect and reconnect the YouTube source in Coupler.io.

2. Check YouTube's system status — Visit the Google Workspace Status Dashboard to confirm YouTube Analytics API is operational.

3. Test in YouTube Studio — Try accessing YouTube Analytics directly in YouTube Studio to confirm the data is available and your account has access.

4. Wait and retry — Sometimes this is a temporary API issue. Wait 15 minutes and re-run the flow.

If the error persists, contact Coupler.io support with the exact error message and flow name.