Who This Is For / When to Use
This setup is for marketers and operators who want to:
Track workflow-driven events in Google Analytics 4
Measure form submissions, bookings, and conversions
Send server-side GA4 events from Kyrios
Improve campaign attribution and performance analysis
Use this when actions inside Kyrios workflows should appear as events in Google Analytics 4.
What the Google Analytics Workflow Action Does
The Google Analytics workflow action in Kyrios supports both Google Analytics 4 and Universal Analytics.
This allows you to fire GA4 events directly from workflows when contacts complete specific actions, such as submitting forms or booking appointments.
Step 1: Access Your Kyrios Account
Log in to your Kyrios account and confirm you have permission to create or edit workflows.
Step 2: Navigate to Workflows
From the main dashboard, go to Automations > Workflows.
Step 3: Create or Select a Workflow
Choose an existing workflow or click Create Workflow > Start from Scratch.
Step 4: Add a Google Analytics Action
Inside the workflow builder, click Select Action or the + icon to add a new action.
Step 5: Choose Google Analytics 4 as the Action Type
In the action panel, select Add to Google Analytics and set the Action Type to Google Analytics 4.
Step 6: Retrieve Your Measurement ID
Open Google Analytics and go to Admin > Data Streams.
Select the correct web data stream and copy the Measurement ID.
Step 7: Paste the Measurement ID into Kyrios
Return to the workflow action and paste the Measurement ID into the Measurement ID field.
Step 8: Create an API Secret in Google Analytics
In Google Analytics, go to Admin > Data Streams > Measurement Protocol API Secrets.
Click Create to generate a new API secret.
Privacy Acknowledgement Requirement
Before creating an API secret, Google requires confirmation that you have completed required privacy disclosures and obtained user consent.
Click Review terms, then I acknowledge to proceed.
Step 9: Copy and Paste the API Secret
After creation, copy the Secret Value and paste it into the API Secret field in the Kyrios workflow action.
Ensure there are no spaces before or after the value.
Step 10: Configure the Event Name and Value
Enter the Event Name you want to track in GA4.
Examples include:
lead_submitted
booking_confirmed
appointment_completed
Optional event values can be added for revenue or scoring.
Step 11: Save and Test the Workflow
Save the action and the workflow.
Use Test Workflow or manually trigger the workflow to verify event firing.
Step 12: Monitor Events in Google Analytics
Open Google Analytics and check the Realtime report to confirm events are received.
Standard reports may take 24–48 hours to update.
Creating Custom Google Analytics Events
You can define custom event names directly in the workflow action.
Use descriptive, goal-oriented names to improve reporting clarity and analysis.
Custom parameters can be added to capture campaign or workflow-specific data.
Enhanced Measurement Settings
In your GA4 Data Stream settings, ensure Enhanced Measurement is enabled.
This automatically tracks interactions such as:
Scroll depth
Outbound link clicks
File downloads
Video engagement
Enhanced Measurement provides deeper behavioral insights without extra setup.
Troubleshooting Common Issues
If events do not appear in Google Analytics:
Confirm Measurement ID and API Secret are correct
Ensure no spaces were included when pasting values
Verify the event name matches the workflow configuration
Check that GA4 filters are not blocking data
Testing Events Before Publishing
Before publishing, manually trigger the workflow or use a test contact.
Confirm event activity in the Realtime tab in Google Analytics.
If it appears in Realtime, the integration is working correctly.
Data Retention Settings
To maximize analysis history, go to Admin > Data Settings > Data Retention in Google Analytics.
Set retention to 14 months and enable Reset on new activity.
Pro Tips for GA4 Setup
Double-check Measurement ID and API Secret formatting to prevent silent failures.
Use specific, meaningful event names aligned with business goals.
Enable Enhanced Measurement for automatic interaction tracking.
Always test events before publishing workflows.
FAQ
How do I set up Google Analytics 4 in a workflow?
Add a Google Analytics action to your workflow, select Google Analytics 4, enter the Measurement ID, configure the event name, and paste the API Secret.
What should I do if events are not appearing?
Verify the Measurement ID and API Secret are entered correctly with no spaces, confirm the event name, and check GA4 filters.
How can I test events before publishing?
Trigger the workflow manually and check the Realtime report in Google Analytics.
What are Enhanced Measurement settings?
Enhanced Measurement automatically tracks user interactions such as scrolls and outbound clicks, providing deeper behavioral insights.
How should I manage API Secret security?
Review API Secrets periodically and regenerate them if needed to maintain secure data transmission.
Why don’t events appear immediately in reports?
GA4 processes data with a delay. Events appear instantly in Realtime but may take 24–48 hours in standard reports.
Can I send multiple GA events from one workflow?
Yes. You can add multiple Google Analytics actions at different stages of the same workflow to track multiple events.