How to set up the integration
The integration is as simple as checking a box. If you have a Google tag installed on your site, all you need to do is open your project settings, click Google Analytics, and then switch the toggle to "on." Keep in mind, this setting is on a per-project basis, so if you have multiple projects you will need to turn the integration on for each of them.
How it works
If you have the integration turned on, every time we send a beacon to our kinesis stream, we also send that same data to the gtag script installed on the site. We forward all our Compose conversion events to the gtag function.
In your Google Analytics dashboard, Compose events will display under custom events. They come in as compose-conversion.
compose-conversionwill show all Compose conversion events
Organization Information
- org_id: Unique identifier for the organization
- org_name: Name of the organization
Project Information
- project_id: Unique identifier for the project
- project_name: Name of the project
Experiment Information
- experiment_id: Unique identifier for the experiment
- experiment_name: Name of the experiment
- variant_id: Unique identifier for the assigned variant
- variant_name: Name of the assigned variant
Conversion Metrics
- conversion_goal: Type of conversion being tracked
- Possible values: "revenue", "engagement", "bounceRate"
Analytics Metrics
- analytic_goal: Specific analytics metric being measured
- Example: "totalRevenue"
- analytic_value: Numerical value of the analytic measurement
- analytic_unit: Unit of measurement for the analytic value
You can click on the conversion and see a counter containing all the details of each conversion received under compose_event. Clicking further will reveal details of each event parameter. To create a representative way to transform the compose events, you will want to create a custom Dimension.
Custom Dimension and Reports
In Google Analytics, navigate to Admin => Data Display => Custom definitions
Now you can select Create custom dimension
Create Report Comparison
In the GA4 Dashboard, select Add Comparisonthen Create Newon the top right
This will allow you to use your custom dimensions
Additional Notes:
When creating an experiment and using the Preview feature, these events will not be sent.