Firebase App Conversions

Learn how to create Conversion Syncs for Firebase app events

Sync mobile app conversion events from your data warehouse into Firebase / GA4 so Google Ads can attribute conversions from app users.

GrowthLoop sends server-side events through the GA4 Measurement Protocol for Firebase app data streams. Each event includes an app_instance_id, which Google uses for app conversion reporting and downstream import into Google Ads.

How it works

  • Server-side app events. GrowthLoop posts conversion rows from your warehouse to GA4's Measurement Protocol (/mp/collect).
  • One connection per platform. Create separate destination connections when your iOS and Android Firebase App IDs differ.
  • Insert-only syncs. GrowthLoop adds new events. Syncs do not update or remove events already sent to GA4.
  • Batched uploads. Events are grouped by app_instance_id and user_id, then sent in batches of up to 25 events per request.

Prerequisites

  • A GA4 property with an iOS or Android app data stream configured.
  • The Firebase App ID for that stream (from GA4 Admin → Data streams).
  • A Measurement Protocol API secret created for the same app stream.
  • A warehouse table with app conversion events, including valid Firebase app_instance_id values (not web client_id values).

Supported objects

GrowthLoop enables syncing to the following Firebase App Conversions object:

ObjectDescriptionSync modesField mappings (required)Field mappings (optional)
App ConversionSync mobile app conversion events to GA4 via the Measurement Protocol for Google Ads attributionInsert (adds new events)App Instance ID, Event Name, Event Time (Unix timestamp in seconds)User ID, Currency, Value, Transaction ID, Engagement Time (ms) (defaults to 100 when not mapped), Non-Personalized Ads. See the GA4 Measurement Protocol reference.

Set up the destination

  1. In GrowthLoop, go to Destinations and click New Destination.
  2. Search for Firebase App Conversions and click Add Firebase App Conversions.
  3. Enter the Firebase App ID and Measurement Protocol API secret from GA4 Admin for the correct iOS or Android app data stream.
  4. Click Create. GrowthLoop validates the credentials against GA4's debug Measurement Protocol endpoint.

To find these values in GA4:

  1. Open Admin → Data streams and select your app stream.
  2. Copy the Firebase App ID.
  3. Under Measurement Protocol API secrets, create a secret and copy it into GrowthLoop.

Create a Conversion Sync

  1. Open Conversion Syncs and click New Conversion Sync.
  2. Select your warehouse table containing app conversion events.
  3. Choose the Firebase App Conversions destination you created.
  4. Map App Instance ID, Event Name, and Event Time.
  5. Add optional revenue and engagement fields for purchase events.
  6. Save and run the sync.

You've successfully created a conversion sync to Firebase App Conversions! You should see it in your Syncs table.

Google Ads attribution

After events arrive in GA4, import or link the conversions in Google Ads according to your Google setup. GrowthLoop delivers events to GA4; Google Ads attribution is configured in Google tooling outside GrowthLoop.

Use GA4 → Reports → Realtime to confirm events are arriving after a sync run. Firebase DebugView only shows events sent to the debug endpoint (used during credential validation), not production sync traffic.

Troubleshooting

  • Invalid credentials: Confirm the Firebase App ID and API secret belong to the same app data stream.
  • Missing events in GA4: Verify app_instance_id values are real Firebase Analytics IDs, not web client_id values.
  • iOS and Android: Create separate destination connections when each platform has its own Firebase App ID.
  • Purchase events rejected or incomplete: Map Currency, Value, and Transaction ID for revenue events.

If you experience issues connecting to Firebase App Conversions, reach out to [email protected].


Did this page help you?