When choosing a name for a new event, follow these rules:
- Event names are case sensitive. For example,
my_eventandMy_Eventare distinct events. - Event names can include English and non-English words and letters.
- Do not use reserved prefixes and event names.
- Event names must start with a letter. Use only letters, numbers, and underscores. Don't use spaces.
Reserved prefixes and event names
The following 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
Reserved event names
The following event names are reserved and cannot be used:
app_removeapp_store_refundapp_store_subscription_cancelapp_store_subscription_renewclickerrorfile_downloadfirst_openfirst_visitform_startform_submitin_app_purchasepage_viewscrollsession_startuser_engagementview_completevideo_progressvideo_startview_search_results
Reserved event parameter names
The following event parameter names are reserved and cannot be used when creating custom dimensions and metrics:
cidcurrencycustomer_idcustomeriddclidgclidsession_idsessionidsfmc_idsidsrsltiduiduser_iduserid
Additionally, parameter names cannot begin with:
_(underscore)firebase_ga_google_gtag.
Reserved user property names
The following user property names are reserved and cannot be used when creating custom dimensions:
cidcustomer_idcustomeridfirst_open_after_installfirst_open_timefirst_visit_timegoogle_allow_ad_personalization_signalslast_advertising_id_resetlast_deep_link_referrerlast_gclidlifetime_user_engagementnon_personalized_adssession_idsession_numbersessionidsfmc_idsiduiduser_iduserid
Additionally, user property names cannot begin with:
_(underscore)firebase_ga_google_
Reserved item parameter names
The following item parameter names are reserved and cannot be used when creating custom dimensions:
affiliationcidcreative_namecurrencycustomer_idcustomeriditem_branditem_categoryitem_category2item_category3item_category4item_category5item_iditem_list_iditem_list_nameitem_nameitem_variantpromotion_idpromotion_namesession_idsessionidsiduiduser_iduserid
Mobile (Android and iOS)
Reserved event names
The following event names are reserved and cannot be used:
ad_activeviewad_clickad_exposuread_impressionad_queryad_rewardadunit_exposureapp_clear_dataapp_exceptionapp_installapp_removeapp_store_refundapp_updateapp_upgradedynamic_link_app_opendynamic_link_app_updatedynamic_link_first_openerrorfirebase_campaignfirebase_in_app_message_actionfirebase_in_app_message_dismissfirebase_in_app_message_impressionfirst_openfirst_visitin_app_purchasenotification_dismissnotification_foregroundnotification_opennotification_receivenotification_sendos_updatescreen_viewsession_startuser_engagement
Reserved event parameter names
The following event parameter names are reserved and cannot be used when creating custom dimensions and metrics:
cidcurrencycustomer_idcustomeriddclidgclidsession_idsessionidsfmc_idsidsrsltiduiduser_iduserid
Additionally, parameter names cannot begin with:
_(underscore)firebase_ga_google_gtag.
Reserved user property names
The following user property names are reserved and cannot be used when creating custom dimensions:
cidcustomer_idcustomeridfirst_open_after_installfirst_open_timefirst_visit_timegoogle_allow_ad_personalization_signalslast_advertising_id_resetlast_deep_link_referrerlast_gclidlifetime_user_engagementnon_personalized_adssession_idsession_numbersessionidsfmc_idsiduiduser_iduserid
Additionally, user property names cannot begin with:
_(underscore)firebase_ga_google_
Reserved item parameter names
The following item parameter names are reserved and cannot be used when creating custom dimensions:
affiliationcidcreative_namecurrencycustomer_idcustomeriditem_branditem_categoryitem_category2item_category3item_category4item_category5item_iditem_list_iditem_list_nameitem_nameitem_variantpromotion_idpromotion_namesession_idsessionidsiduiduser_iduserid