Modify and create events

About

You need Edit permission to modify and create events.

Event modification and creation lets you:

  • Make modifications to existing events. For example, if you collect the same event from the Android and iOS versions of your app but under different names, you can edit those events to use the same name and thereby simplify your reporting. You can also fix typos in event or parameter names, and you can modify event names and parameters to conform to the schema Analytics uses for suggested events(e.g., Retail, Jobs, Travel, Games).
  • Make modifications that create new events in response to the occurrence of other events. For example, you can trigger a new purchase event in response to the following:

    Event: page_view
    AND
    Parameter: page_title = checkout

    When someone triggers the page_view event for the checkout page, then Analytics creates the new purchase event.

    You can mark the new purchase event as a conversion.

Modifications are executed client side before data is sent to Analytics for processing.

Modifications execute in the order they appear in the Event modification rules list. Learn more

Editing an event does not affect historical data associated with that event.

You can create up to 50 modifications to existing events and 50 modifications that create new events, for a total of 100 modifications.

Modify events

If you rename an event that is already marked as a conversion, that event will no longer be a conversion. If you modify event parameters but do not change the name, the event remains a conversion.

To create a rule to modify an event:

  1. Sign in to Analytics.
  2. Select the relevant property.
  3. In the left pane, click All events.
  4. Click Modify Event.
  5. Click Create, and click in the Configuration panel to activate the fields.
  6. Modification name: Enter a name for the modification.
  7. Identify the event you want to modify.
    Under Modify event(s) that match ALL of the following conditions:
    • Parameter: Choose the event parameter (e.g., page_title).
    • Operator: Choose the operator (e.g., equals).
    • Value: Enter the value (e.g., thank_you)
    • If you want to add another condition, click Add condition.
  8. (Optional) Specify the parameter modification you want to make.
    Under Modify parameters:
    • Parameter: Choose the event parameter you want to modify (e.g., page_title).
    • New value: Enter the new value you want to use for the modified parameter (e.g., checkout).
      OR
      If you want to use the value of another parameter as the new value, enter the other parameter name in double brackets (e.g., [[other_parameter]].
    • To add another parameter modification, click Add modification.
    Note: If you want to rename a parameter, enter the new name in the Parameter field, and enter either the old value or old parameter name (e.g., [[old_parameter_name]]) in the Value field.
  9. Click Create.

Create events

There are prefixes and event names that are reserved for use by Analytics that you cannot use when you're creating new events. See the list below.

To create an event:

  1. Sign in to Analytics.
  2. Select the relevant property.
  3. In the left pane, click All events.
  4. Click Create Event.
  5. Click Create, and click in the Configuration panel to activate the fields
  6. Custom event name: Enter a name for the event (e.g. purchase).
  7. Identify the existing event you want as the trigger for your new event.
    Under Matching conditions:
    • Parameter: Choose the parameter of the triggering event (e.g., page_title).
    • Operator: Choose the operator (e.g., equals).
    • Value: Choose the value (e.g., check_out).
    • If you want to add another condition, click Add condition.
  8. If you want to copy parameters from the triggering event to the new event, select Copy parameters from the source event.
  9. If you want to modify the copied parameters or add new ones, click Add modification.
    • Parameter: Start typing to choose the event parameter you want to modify (e.g., page_title).
    • Value: Enter the new value you want to use for the modified parameter (e.g., checkout).
      OR
      If you want to use the value of another parameter as the new value, enter the other parameter name in double brackets (e.g., [[other_parameter]].
    • To add another parameter modification, click Add modification.
  10. Click Create.
In addition to accessing these options from the All events page, you can also access them from Admin > Property column > Data Streams > Web > web stream > Tagging Settings.
Reserved prefixes and event names
This list is not exhaustive and may be updated periodically. If you try to use a reserved prefix or name, Analytics will display an error message.

Web

Prefixes

  • _ (underscore)
  • firebase_
  • ga_
  • google_
  • gtag.

Event names

  • app_remove
  • app_store_refund
  • app_store_subscription_cancel
  • app_store_subscription_convert
  • app_store_subscription_renew
  • first_open
  • first_visit
  • in_app_purchase
  • session_start
  • user_engagement

Mobile (Android and iOS)

Prefixes

  • _ (underscore)
  • firebase_
  • ga_
  • google_
  • gtag.

Event names

  • ad_activeview
  • ad_click
  • ad_exposure
  • ad_query
  • ad_reward
  • adunit_exposure
  • app_background
  • app_clear_data
  • app_exception
  • app_remove
  • app_store_refund
  • app_store_subscription_cancel
  • app_store_subscription_convert
  • app_store_subscription_renew
  • app_update
  • app_upgrade
  • dynamic_link_app_open
  • dynamic_link_app_update
  • dynamic_link_first_open
  • error
  • firebase_in_app_message_action
  • firebase_in_app_message_dismiss
  • firebase_in_app_message_impression
  • first_open
  • first_visit
  • in_app_purchase
  • notification_dismiss
  • notification_foreground
  • notification_open
  • notification_receive
  • notification_send
  • os_update
  • session_start
  • session_start_with_rollout
  • user_engagement

Mark new events as conversions

To mark a new event that you created as a conversion:

  1. Sign in to Analytics.
  2. In the left pane, click Conversions.
  3. Click New conversion event.
  4. Under New event name, enter the name of the new event you created (be sure to enter the name exactly as configured during the creation process).
  5. Click Save.

Learn more about conversions

Reorder the list of event modifications

You may need your event modifications to execute in a specific order. For example, if you modify the name of an event (Modification 1) and use that modified name as the basis for creating another event (Modification 2), then you would need the modifications to execute in the order of Modification 1 > Modification 2.

To reorder event modifications:

  1. Sign in to Analytics.
  2. Select the relevant property.
  3. In the left pane, click All events.
  4. Click Modify Event.
  5. In the list of Event modifications, click Reorder.
  6. Drag a modification from one position in the list to another as needed.
  7. Click Apply.
Was this helpful?
How can we improve it?

Need more help?

Sign in for additional support options to quickly solve your issue