The Google Analytics 4 (GA4) integration connects your web analytics data to Butterflai using a service account. Setup follows a 4-step wizard that guides you through the process.
What you need
Access to your GA4 property in Google Analytics
Admin or Editor permissions on the GA4 property (to grant access to the service account)
How to connect
Step 1: Find your Property ID
Sign in to Google Analytics.
Select the correct Account and Property.
Click the Admin icon (bottom left).
In the Property column, select Property Settings.
Copy the Property ID (a numeric code, e.g., 345678901).
Paste it into the Butterflai setup form.
Step 2: Copy the Service Account email
After submitting the Property ID, Butterflai automatically creates a Service Account and displays its email address (e.g., [email protected]). Copy this email.
Step 3: Grant access in GA4
In Google Analytics, go to Admin > Property > Property Access Management.
Click Add users.
Paste the Service Account email.
Select the Viewer role.
Click Add.
Note: Access is granted at the Property level, not at the Account level.
Step 4: Authorize in Butterflai
Return to Butterflai.
Click Check Authority to verify the service account has access.
Once verified, synchronization starts automatically.
What data syncs
Traffic data - sessions, users, pageviews, traffic sources
User behavior - engagement metrics, bounce rate, session duration
Conversions - goal completions, conversion rates, event tracking
When to use
Connect GA4 if you want the AI to analyze your website traffic patterns, user behavior, and conversion performance.