Choose an existing project or create a new one, then click Continue.
Select + Create Service Account at the top.
Provide a name and (optionally) a description, then click Create and Continue.
Assign a role, preferably Viewer (which grants read-only access), and proceed.
From the list of service accounts, open the Keys tab and click Add Key → Create New Key.
Choose the JSON format. This will automatically download the credentials file you’ll use for authentication.
Step 2: Enable Required APIs
To access GA4 data, you must activate specific APIs:
Enable the Google Analytics Reporting API for your selected project.
Activate the Google Analytics API in the same project.
Also enable the Google Analytics Data API.
You can manage these APIs via the respective dashboards in the Google Cloud Console.
Connecting GA4 as a Source
Locate and select Google Analytics 4 (GA4) in your data integration platform under available source connectors.
Choose Service Account Key Authentication, then upload or paste the contents of your JSON key from Step 1.
Enter your Property ID – a numeric identifier like 123456789 representing your GA4 property. Refer to Google’s documentation for guidance on where to find it.
⚠️ If your property uses a tracking ID like UA-XXXXXX, it is a Universal Analytics property and is incompatible with GA4’s Data API. You must create a GA4 property instead.
Optional Configuration Parameters
Start Date: Use the calendar widget or manually input a start date in YYYY-MM-DD format. This defines the earliest date from which data will be collected. The default is two years prior to the current date.
⏳ To ensure accuracy, data is pulled with a two-day delay due to GA4’s latency in processing. Refer to Google’s documentation for more insights.
Include Empty Rows: Toggle this option if you want rows with zero values for all metrics to be included in the data.
Custom Reports: Specify any custom GA4 reports to be fetched. Refer to the Custom Reports section for formatting details.
Data Request Interval (Days): Set the span of each data pull, between 1 and 364 days. A higher value speeds up sync but may result in data sampling, which reduces precision. Default is 1 for optimal accuracy.
🔍 GA4’s sampling behavior can cause inconsistencies when using shorter ranges with grouped dimensions like month. To reduce duplication, consider increasing this interval to 364 days.
Lookback Window (Days): Define how many days of historical data should be re-fetched on each sync run. This is useful for maintaining data consistency when attribution changes or new data is processed after initial events.
Final Steps
Once all required and optional fields are configured:
Click Set up source to begin the connection process.
Wait as the system verifies access and credentials.
Supported Data Sync Modes
The GA4 connector supports these synchronization options: