Set up GA4 for Checkout

What is GA4?

GA4 (Google Analytics 4) is the latest version of Google Analytics, designed to track and analyse user behaviour across websites and apps in a more flexible and privacy-friendly way.

How it works?

GA4 functions on the following principles:

  • Tracks users across devices and platforms
  • Focuses on Events for more accurate analytics
  • Supports future privacy regulations (GDPR, CCPA)

Connect GA4 to Checkout

Create Google Analytics account & Property

  1. Go to https://analytics.google.com
  2. Click Start measuring.
  3. Enter an Account name.
  4. Apply the Data sharing settings and click Next to add the first property to the account.
  5. Add the Property name. Then, select the reporting Time zone and Currency. Click Next.
  6. Select your industry Category and Business size. Click Next.
  7. Select how you plan to use Google Analytics. Click Create.

Add a Data stream

  1. In the Admin tab, click Data streams under the Data collection and modification block.
  2. Then, click Add stream.
  3. Select Web option in the selection.
  4. Enter the URL of your primary website.
  5. Click Create stream.

*To learn more, visit the official GA Documentation.

Add GA4 to Checkout on our platform

  1. Go to Merchants.
  2. Switch to the Checkouts tab.
  3. Select the Checkout you want to proceed with and click it.
  4. Navigate to the Integration tab.
  5. Switch on the Enable GA tracking toggle.
  6. Enter GA4 Measurement ID into the respective field.

Supported events and event parameters

Events overview

Event Description
checkout_view Triggered when the Checkout page is displayed to the user.
checkout_method_selected Triggered when the user selects a Payment method at Checkout.
checkout_form_valid Triggered when the Checkout form becomes valid and is ready for submission.
checkout_submit Triggered when the user clicks the Pay or Continue button to submit the Checkout form.
checkout_pending Triggered when the payment processing starts and the Checkout enters a pending/loading state.
purchase Triggered when the payment is successfully completed and the purchase is confirmed.
checkout_failed Triggered when the Checkout process fails and the payment is not completed.
checkout_error Triggered when an unexpected or unknown error occurs during the Checkout process.
checkout_view_expired Triggered when the user opens the checkout page and the payment session has already expired.
checkout_abandoned Triggered when the user leaves or abandons the Checkout page before completing the payment.

Parameters overview

Parameters for all events

  • checkout_id
  • merchant_account_id
  • payment_request_id
  • currency
  • amount
  • reference_id
  • origin_reference_id

Parameters for purchase/error/failed/expired

  • payment_commit_id
  • payment_commit status
  • payment_commit_resolution