Measure Google Analytics Events - Google Developers

Note: This article focuses on a subset of gtag.js events called Google Analytics Events, events that appear in the Google Analytics Event reports. Google Analytics Measurement UniversalAnalytics(gtag.js) Language English BahasaIndonesia Deutsch Español Français Português–Brasil Русский 中文–简体 日本語 한국어 Signin Google Analytics Measurement UniversalAnalytics(gtag.js) Guides Getstarted Addgtag.jstoyoursiteSenddatatoGoogleAnalyticsSetpersistentvalues Measurecommonuserinteractions PageviewsEventsPhoneanalyticsApp/screenviewsUsertimingsExceptions Advanced CookiesanduseridentificationCross-domainmeasurementCustomdimensionsandmetricsDisableadvertisingfeaturesEnhancedecommerceEnhancedlinkattributionIPanonymizationRenametheglobalobjectDisableAnalyticsforopted-outusers Solutions CheckexceptionsandcustomdimensionsandmetricsSinglepageapplications Resources CookieusageLimitsandquotas Home Products GoogleAnalytics Measurement UniversalAnalytics(gtag.js) MeasureGoogleAnalyticsEvents Thispageexplainshowtousegtag.jstosendGoogleAnalyticsEvents. Note:Thisarticlefocusesonasubsetofgtag.jseventscalledGoogleAnalytics Events,eventsthatappearintheGoogleAnalyticsEventreports.Learnmore aboutthegtag.jseventcommand. Sendevents TosendGoogleAnalyticsEventsonawebpagewheretheglobalsitetaghas beenadded,usethegtag.jseventcommandwiththefollowingsyntax: gtag('event',,{ 'event_category':, 'event_label':, 'value': }); Name Type DefaultValue Description string ThevaluethatwillappearastheeventactioninGoogleAnalyticsEvent reports. string "general" Thecategoryoftheevent. string Thelabeloftheevent. number Anon-negativeintegerthatwillappearastheeventvalue. Thefollowingsendsaneventwithanactionof'aaa',acategoryof'bbb', andalabelof'ccc': gtag('event','aaa',{ 'event_category':'bbb', 'event_label':'ccc' }); Iforareomitted,theywillbesettothedefaultvalues of"(notset)". SeetheanatomyofGoogleAnalyticsEventparametersformoreinformationon howthestructureofeventsisinterpretedbyGoogleAnalytics. DefaultGoogleAnalyticsEvents YoushouldusethedefaultGoogleAnalyticsEvents,whichhavepre-set categoriesandlabels.Usingtheseeventsfacilitatesconsistentreportingand interoperabilitywithfuturefunctionality. Note:Thebuilt-ineventsdon'tuse,,and.Take caretousethecorrectkeyswhensendingtheseevents. ThefollowingtableliststhedefaultGoogleAnalyticsEvents,theirdefault categories,anddefaultlabeltypes(ifavailable).Foreventnamesnotlisted inthistable(e.g.arbitraryeventnamesthatyoucreate),thedefaultcategory is"engagement"andthedefaultlabelis"(notset)". Eventname Defaultcategory Defaultlabeltype add_payment_info ecommerce   add_to_cart ecommerce   add_to_wishlist ecommerce   begin_checkout ecommerce   checkout_progress ecommerce   generate_lead engagement   login engagement method purchase ecommerce   refund ecommerce   remove_from_cart ecommerce   search engagement search_term select_content engagement content_type set_checkout_option ecommerce   share engagement method sign_up engagement method view_item engagement   view_item_list engagement   view_promotion engagement   view_search_results engagement search_term Sendnon-interactionevents Tosendanon-interactionevent,setthenon_interactionparameterto true: gtag('event','video_auto_play_start',{ 'event_label':'Mypromotionalvideo', 'event_category':'video_auto_play', 'non_interaction':true }); Exceptasotherwisenoted,thecontentofthispageislicensedundertheCreativeCommonsAttribution4.0License,andcodesamplesarelicensedundertheApache2.0License.Fordetails,seetheGoogleDevelopersSitePolicies.JavaisaregisteredtrademarkofOracleand/oritsaffiliates. Lastupdated2022-01-04UTC. [{ "type":"thumb-down", "id":"missingTheInformationINeed", "label":"MissingtheinformationIneed" },{ "type":"thumb-down", "id":"tooComplicatedTooManySteps", "label":"Toocomplicated/toomanysteps" },{ "type":"thumb-down", "id":"outOfDate", "label":"Outofdate" },{ "type":"thumb-down", "id":"samplesCodeIssue", "label":"Samples/codeissue" },{ "type":"thumb-down", "id":"otherDown", "label":"Other" }] [{ "type":"thumb-up", "id":"easyToUnderstand", "label":"Easytounderstand" },{ "type":"thumb-up", "id":"solvedMyProblem", "label":"Solvedmyproblem" },{ "type":"thumb-up", "id":"otherUp", "label":"Other" }] GitHub TryGoogleAnalyticssamples StackOverflow Askquestionsusingthegoogle-analyticstag Twitter Follow@googleanalyticsonTwitter Videos ViewGoogleAnalyticsvideosonYouTube Connect Community&Updates GettingHelp ReportinganIssue ProductInfo Protocol/SDKPolicy BrandingPolicy Developerconsoles GoogleAPIConsole GoogleCloudPlatformConsole GooglePlayConsole FirebaseConsole ActionsonGoogleConsole CastSDKDeveloperConsole ChromeWebStoreDashboard Android Chrome Firebase GoogleCloudPlatform Allproducts Terms Privacy SignupfortheGoogleDevelopersnewsletter Subscribe Language English BahasaIndonesia Deutsch Español Français Português–Brasil Русский 中文–简体 日本語 한국어