Google Analytics 4 (iOS/Android) Event Streaming

Amplitude Data's Google Analytics 4 (iOS/Android) integration enables you to stream your Amplitude event data straight to Google Analytics with just a few clicks.

Considerations¶

• Amplitude sets non_personalized_ads to true for all sent events.
• Google Analytics 4 property names are composed of alphanumeric characters and underscores. Amplitude replaces white spaces in property names with a single underscore and strips all other non-alphanumeric characters from the names.
• Amplitude sends custom events using Amplitude event_type as event name.

Setup¶

Prerequisites¶

To set up event streaming to GA4, you need the following:

• A Firebase App ID
• A Measurement Protocol API secret
• A custom user property in Amplitude containing the Firebase app instance ID for each user

To find these values:

1. Open the Google Analytics home page.
2. Click the gear icon to open Admin, then select Data Streams.
3. Pick the data stream to stream the Amplitude events to.
4. Measurement Protocol API secret is available under the Additional Settings section, by opening Measurement Protocol API secrets. You can create a new API secret that's specific to this use case, that you can manage and remove independently the others. Copy the value in the Secret value column of the appropriate row.
5. Navigate to your Firebase console.
6. Your Firebase App ID is under Projects Settings > General > Your Apps > App ID.

Amplitude setup¶

1. In Amplitude, navigate to Data.
2. On the sidebar, under Connections, select Catalog.
3. Select the Destinations tab.
4. Select Event Streaming.
5. Click Google Analytics 4 (Web).
6. Enter a sync name, then click Create Sync.

After you create the destination, you must configure the settings.

Configure settings¶

1. On the Settings tab, click Edit.
2. Enter your Measurement Protocol API secret.
3. Enter your Firebase App ID.
4. Create & Update Users creates users in Google Analytics 4 and update the properties of existing users when an Amplitude Identify API call is made. You can select up to 25 user properties to send. Google Analytics 4 doesn't accept more than 25 user properties.
   1. To create and update users, toggle Create & Update Users to Enabled.
   2. To select user properties to send, expand the Specify user properties to send panel, and select up to 25 properties. If you don't select any properties here, Amplitude doesn't include any.
5. Send Events sends events ingested by Amplitude to Google Analytics 4. You can select up to 25 event properties to send. Google Analytics 4 doesn't accept more than 25 event properties.
   1. To send events, toggle Send Events to Enabled.
   2. Expand the Select and filter events panel, and select which events to send. Amplitude recommends that you send only the events you need in Google Analytics 4, rather than selecting All Events.
   3. To select event properties to send, expand the Specify event properties to send panel, and select up to 25 properties. If you don't select any properties here, Amplitude doesn't include any.
6. Save when finished.

After you configure your settings, you can configure your mappings.

Configure mappings (optional)¶

For newer versions of the Google Analytics 4 (iOS/Android) destination, you can map Amplitude properties to fields in Google Analytics 4. If you don't configure mappings, or are using an older version that doesn't support mapping, the default values described below are used instead.

1. Click the Mappings tab, then click Edit.
2. Select a User ID. This is a unique identifier for users in Google Analytics 4. Defaults to Amplitude User ID (user_id).
3. Select a Firebase Instance ID. This is a unique identifier for a user's instance of your mobile application. Defaults to the custom user property firebase_instance_id.
4. Save when finished.

After you configure mappings, enable the destination.

Enable integration¶

The final step is enabling the destination. You must enable the destination to start streaming events.

1. Navigate back to the Settings tab and click Edit.
2. Toggle Status from Disabled to Enabled.
3. Save when finished.

Still have questions? Ask them in the Community.