Google Analytics Measurement Protocol Predefined Events Sync

  • Apr 13, 2025
Google Analytics Measurement Protocol Predefined Events Sync

Paytics provides an easy way to sync selected Stripe events to Google Analytics 4 (GA4) using preset GA4 Measurement Protocol events. This streamlined approach ensures you can track important e-commerce activities—like new user sign-ups, purchases, and refunds—directly in your Google Analytics dashboards.

How It Works

When certain events occur in Stripe, Paytics automatically sends the matching predefined events to GA4 using the Measurement Protocol. This lets you view user actions and revenue data in your dashboards without needing to create custom event definitions. The current event mapping is as follows:

Stripe Event Google Analytics 4 Event
customer.created sign_up
payment_intent.succeeded purchase
refund.created refund

These events are automatically recognized by GA4, allowing you to use standard e-commerce reports to easily track user sign-ups, completed transactions, and refunds.

Events and Parameters

1. sign_up

Triggered when customer.created occurs in Stripe, indicating a new user registration. This event allows you to track how many users convert into Stripe customers and helps segment user types (e.g., guest vs. logged-in).

Parameter Description
customer_id The unique identifier for the customer in Stripe.
user_id The user identifier, typically the same as customer_id in Stripe.

For more information, check the official Google documentation.

2. purchase

Triggered when payment_intent.succeeded fires in Stripe, indicating a successful payment. This event is key for revenue tracking and populating e-commerce reports in GA4.

Parameter Description
currency The currency used for the transaction, in uppercase (e.g., USD, CAD).
user_id The identifier for the user making the payment, typically the same as customer_id.
transaction_id The unique identifier for the payment intent in Stripe.
value The total value of the transaction, formatted as a monetary value (critical for revenue tracking).
shipping The shipping cost, if applicable.
tax The tax amount applied, if applicable.
coupon A list of any discount IDs applied to the invoice.
items An array describing the purchased items. Each item object can include:
  • id: Unique identifier for the item.
  • product_id: The product’s unique identifier, if available.
  • name: The product or service name.
  • amount: The item’s price as a monetary value.
  • currency: The currency for the item price (e.g., USD).
  • quantity: Number of units purchased for this item.
  • discount: (Optional) Any discount applied to the item.

For more information, check the official Google documentation.

3. refund

Triggered when refund.created occurs in Stripe, indicating that one or more items have been refunded. This event helps track how much revenue is returned to users.

Parameter Description
currency The currency for the transaction, in uppercase (e.g., USD, CAD).
user_id The identifier for the user making the payment, typically the same as customer_id.
transaction_id The unique identifier for the payment intent in Stripe that is being refunded.
value The total value of the refunded amount, formatted as a monetary value (important for revenue adjustments).

For more information, check the official Google documentation.

Why Use Predefined GA4 Events?

Using predefined events like sign_up, purchase, and refund simplifies integrating Stripe data into your existing Google Analytics workflows. Since these are standard events recognized by GA4, your transactions, sign-ups, and refunds will automatically appear in relevant built-in reports, no extra configuration needed.

  • Minimal Setup: No need for custom definitions to get started.
  • Standardized Analysis: GA4’s e-commerce dashboards instantly recognize these events.
  • Actionable Insights: Easily track new user sign ups, purchase frequency, and refund activity—all in one place.

Note: These predefined events cover basic e-commerce tracking. If you need more detailed insights (e.g., custom subscription events or advanced user segmentation), Paytics can send additional custom events to Google Analytics 4 based on Stripe activity.